daemon

type AgentCleaner interface {
	DeleteAgent(ctx context.Context, name string) error
	// DecommissionAgent removes the agent from the list immediately and
	// returns the container ID for background teardown. This makes
	// "human agent list" responsive while the slow container stop happens
	// asynchronously.
	DecommissionAgent(name string) (containerID string, err error)
	// StopContainer stops and removes a container by ID.
	StopContainer(ctx context.Context, containerID string) error
}

type AgentInfo struct {
	Name        string
	ContainerID string
	CreatedAt   time.Time
}

type AgentLauncher interface {
	Launch(ctx context.Context, name, prompt, workspace, configDir string) error
}

type AgentZombieSweeper interface {
	RunningAgents() ([]AgentInfo, error)
	IsProcessRunning(ctx context.Context, containerID string, process string) (bool, error)
	DeleteAgent(ctx context.Context, name string) error
}

type BoardCard struct {
	Stage          BoardStage `json:"stage"`
	State          BoardState `json:"state"`
	EngineeringKey string     `json:"engineering_key,omitempty"`
	Branch         string     `json:"branch,omitempty"`
	PRURL          string     `json:"pr_url,omitempty"`
	Error          string     `json:"error,omitempty"`
}

type BoardStage string

type BoardState string

type BoardTransitionDeps struct {
	Commenter    tracker.Commenter
	Launcher     AgentLauncher
	Publisher    PRPublisher
	WorkspaceDir string
	ConfigDir    string
}

type BoardTransitionRequest struct {
	PMKey   string     `json:"pm_key"`
	PMTitle string     `json:"pm_title"`
	From    BoardStage `json:"from"`
	To      BoardStage `json:"to"`
}

type BrowserOpener interface {
	Open(url string) error
}

type ConnectedTracker struct {
	// contains filtered or unexported fields
}

type DaemonInfo struct {
	Addr       string `json:"addr"`
	ChromeAddr string `json:"chrome_addr,omitempty"`
	ProxyAddr  string `json:"proxy_addr,omitempty"`
	Token      string `json:"token,omitempty"`
	PID        int    `json:"pid,omitempty"`
	// Version carries the daemon binary's build version so clients can warn
	// about skew between the running daemon and the CLI binary.
	// omitempty preserves backward-compatibility with daemon.json files
	// written by older builds that do not emit this field.
	Version  string        `json:"version,omitempty"`
	Projects []ProjectInfo `json:"projects,omitempty"`
}

type HookEventStore struct {
	// contains filtered or unexported fields
}

type NetworkEvent struct {
	Source   string    `json:"source"` // "proxy" | "oauth" | "fail"
	Status   string    `json:"status"` // "forward" | "intercept" | "block" | "no-sni" | "parse-fail" | "dial-fail" | "callback"
	Host     string    `json:"host"`   // may be empty for pre-SNI failures
	Count    int       `json:"count"`  // >=1
	LastSeen time.Time `json:"last_seen"`
}

type NetworkEventStore struct {
	// contains filtered or unexported fields
}

type PRPublisher interface {
	PushAndCreatePR(ctx context.Context, req PRRequest) (prURL string, err error)
}

type PRRequest struct {
	WorkspaceDir string
	Branch       string
	Title        string
	Body         string
}

type PendingConfirm struct {
	ID        string `json:"id"`
	Operation string `json:"operation"` // "DeleteIssue", "EditIssue"
	Tracker   string `json:"tracker"`   // tracker kind, e.g. "jira", "linear"
	Key       string `json:"key"`       // issue key, e.g. "KAN-1"
	Prompt    string `json:"prompt"`
	CreatedAt string `json:"created_at"`
	ClientPID int    `json:"client_pid"` // PID of the Claude instance that triggered the operation
}

type PendingConfirmStore struct {
	// contains filtered or unexported fields
}

type PendingConfirmation struct {
	ID        string
	Operation string // "DeleteIssue", "EditIssue"
	Tracker   string // tracker kind, e.g. "jira"
	Key       string // issue key, e.g. "KAN-1"
	Prompt    string // human-readable, e.g. "Delete KAN-1?"
	ClientPID int    // PID of the Claude instance that triggered the operation
	CreatedAt time.Time
	Decision  chan bool // the blocked goroutine waits on this; true = approved
}

type ProjectEntry struct {
	Name string // from .humanconfig project: field, or directory basename
	Dir  string // absolute path to project directory
}

type ProjectInfo struct {
	Name string `json:"name"`
	Dir  string `json:"dir"`
}

type ProjectRegistry struct {
	// contains filtered or unexported fields
}

type Request struct {
	Version   string            `json:"version"`
	Token     string            `json:"token"`
	Args      []string          `json:"args"`
	Env       map[string]string `json:"env,omitempty"`
	ClientPID int               `json:"client_pid,omitempty"` // parent PID (Claude process) for connection tracking
	Cwd       string            `json:"cwd,omitempty"`        // client working directory for project routing
}

type Response struct {
	Stdout        string `json:"stdout"`
	Stderr        string `json:"stderr"`
	ExitCode      int    `json:"exit_code"`
	AwaitCallback bool   `json:"await_callback,omitempty"`
	Callback      string `json:"callback,omitempty"`
	AwaitConfirm  bool   `json:"await_confirm,omitempty"`  // line 1: daemon paused, awaiting TUI confirmation
	ConfirmID     string `json:"confirm_id,omitempty"`     // unique identifier for the pending operation
	ConfirmPrompt string `json:"confirm_prompt,omitempty"` // human-readable prompt, e.g. "Delete JIRA-123?"
}

type Server struct {
	Addr             string
	Token            string
	SafeMode         bool
	CmdFactory       func() *cobra.Command
	Opener           BrowserOpener // used for OAuth relay; defaults to browser.DefaultOpener
	Logger           zerolog.Logger
	ConnectedPIDs    *ConnectedTracker                        // tracks client PIDs that have pinged; nil disables tracking
	HookEvents       *HookEventStore                          // in-memory hook event buffer; nil disables hook event tracking
	NetworkEvents    *NetworkEventStore                       // in-memory ambient network activity buffer; nil disables
	IssueFetcher     func() ([]TrackerIssuesResult, error)    // injected; fetches issues from configured trackers
	TrackerDiagnoser func(dir string) []tracker.TrackerStatus // injected; diagnoses tracker status with vault resolution
	Projects         *ProjectRegistry                         // multi-project routing; nil means single-project mode
	PendingConfirms  *PendingConfirmStore                     // pending destructive operation confirmations; nil disables
	StatsWriter      *stats.Writer                            // async SQLite writer for tool event persistence; nil disables
	StatsStore       *stats.StatsStore                        // for query-time aggregation; nil disables tool-stats route
	AuditSink        *audit.Writer                            // records mutating tracker actions for the audit trail; nil disables
	AuditStore       *audit.Store                             // serves audit-query reads; nil disables audit-query route
	AgentCleaner     AgentCleaner                             // async agent cleanup; nil disables agent-stop-async route
	VaultResolver    *vault.Resolver                          // session-scoped vault resolver; reused across requests to avoid repeated op.exe calls
	// BoardTransitioner applies a board-transition request (advancing a card
	// one pipeline stage). nil disables the board-transition route.
	BoardTransitioner func(req BoardTransitionRequest) error
	// contains filtered or unexported fields
}

type SubscribeEvent struct {
	Type      string `json:"type"`            // "change", "agent-stopped"
	AgentName string `json:"agent,omitempty"` // set for agent lifecycle events
}

type TrackerIssuesResult struct {
	TrackerName    string          `json:"tracker_name"`
	TrackerKind    string          `json:"tracker_kind"`
	TrackerRole    string          `json:"tracker_role,omitempty"`
	Project        string          `json:"project"`
	Issues         []tracker.Issue `json:"issues"`
	ReadyForReview []string        `json:"ready_for_review,omitempty"`
	// ReadyForReviewPRs maps an engineering ticket key to the pull-request URL
	// carried on its handoff comment's optional `pr:` line, when present.
	ReadyForReviewPRs map[string]string `json:"ready_for_review_prs,omitempty"`
	// BoardCards is the derived pipeline placement per PM issue key, for the
	// drag-board GUI. It is PM-role-only (maps a PM issue key → its derived
	// BoardCard) and is left nil on engineering-tracker results.
	BoardCards map[string]BoardCard `json:"board_cards,omitempty"`
	Err        string               `json:"error,omitempty"`
}