status

type Coverage struct {
	// Known is false for indexes written before coverage was persisted;
	// the renderer must say "unknown", never imply full coverage.
	Known        bool `json:"known"`
	FilesSeen    int  `json:"files_seen,omitempty"`
	FilesParsed  int  `json:"files_parsed,omitempty"`
	FilesSkipped int  `json:"files_skipped,omitempty"`
	ParseErrors  int  `json:"parse_errors"`
}

type Status struct {
	SchemaVersion string   `json:"schema_version"`
	IndexedAt     int64    `json:"indexed_at,omitempty"`
	Freshness     string   `json:"freshness"`
	Coverage      Coverage `json:"coverage"`

	Symbols     int            `json:"symbols"`
	Edges       int            `json:"edges"`
	EdgeOrigins map[string]int `json:"edge_origins,omitempty"`

	EffectsDirect     int `json:"effects_direct_symbols"`
	EffectsPropagated int `json:"effects_propagated_symbols"`

	History store.HistoryWindow `json:"history"`

	Lessons        int            `json:"lessons"`
	Findings       map[string]int `json:"findings,omitempty"`
	ReviewsMinedAt int64          `json:"reviews_mined_at,omitempty"`

	// DistillAgent is the resolved agent command line ("" when the
	// config is invalid); external data processing is implied whenever
	// it is set — the CLI is assumed to reach a remote model. The value
	// is sanitized and secret-scrubbed: it comes from repository-
	// controlled config and flows to terminals and MCP clients.
	DistillAgent string `json:"distill_agent,omitempty"`

	// GatePolicyMode is policy.yaml's mode; GateHookMode is what the
	// installed Claude hook does ("" = no operational hook). They can
	// differ, and the difference is exactly what a reader needs to see.
	GatePolicyMode string `json:"gate_policy_mode"`
	GateHookMode   string `json:"gate_hook_mode,omitempty"`
	// GateHookError reports a hook configuration that cannot be read —
	// which is not the same finding as "no hook installed".
	GateHookError string `json:"gate_hook_error,omitempty"`
	// GatePolicyError carries a policy file that fails to load — a state
	// that changes every hook decision.
	GatePolicyError string `json:"gate_policy_error,omitempty"`

	// Skills is the agent-skills state per client directory. A stale copy
	// after an upgrade must be visible here, beside the hook and MCP
	// state, because a client would load text that no longer matches the
	// binary's tool surface.
	Skills []skills.ClientState `json:"skills,omitempty"`

	// Approvals is the tool-approval configuration per client: whether
	// the seamark MCP tools can run without prompts. Project
	// configuration only; user or managed policy can still prompt.
	Approvals []approve.ClientApproval `json:"approvals,omitempty"`
}