cmd

type ActivityCounts struct {
	Pending    int `json:"pending"`
	InProgress int `json:"inProgress"`
	Completed  int `json:"completed"`
	Failed     int `json:"failed"`
	Blocked    int `json:"blocked"`
}

type ApproveOptions struct {
	Approver, Reason string
	// Input and Output carry the confirmation prompt. Both default to the
	// process's own streams; they exist so tests need no pseudo-terminal.
	// Interactivity is derived from Input, never supplied by the caller.
	Input  io.Reader
	Output io.Writer
}

type ArchiveOptions struct {
	Actor string
	Now   time.Time
}

type CompleteOptions struct {
	Actor string
}

type FrictionResult struct {
	Change      string                     `json:"change"`
	TaskID      string                     `json:"task"`
	Domain      string                     `json:"domain"`
	Operation   string                     `json:"operation"`
	Blocker     string                     `json:"blocker"`
	Consequence string                     `json:"consequence"`
	Actor       string                     `json:"actor"`
	Revision    uint64                     `json:"revision"`
	StateHash   string                     `json:"state_hash"`
	EvidenceSet string                     `json:"evidence_set"`
	Eligibility []core.FrictionEligibility `json:"eligibility"`
}

type InitResult struct {
	Root Root `json:"root"`
	// Guidance is the generated agent surface installed into the project root.
	// A fresh agent resumes from it, so adoption installs it rather than
	// leaving the file to a route only a Go caller can reach.
	Guidance string `json:"guidance"`
}

type NewResult struct {
	Root Root `json:"root"`
	state.Projection
}

type NextRefusal struct {
	*failure.Refusal
	Owner  string
	TaskID string
}

type NextResult struct {
	Root           Root                   `json:"root"`
	Change         string                 `json:"change"`
	Revision       uint64                 `json:"revision"`
	Frontier       []string               `json:"frontier"`
	Selected       *core.TaskReadiness    `json:"selected,omitempty"`
	Classification string                 `json:"classification"`
	Blocker        *core.ReadinessBlocker `json:"blocker,omitempty"`
	Action         string                 `json:"action"`
}

type Outcome struct {
	Operation string
	Root      string
	Change    string
	Task      string
	Value     any
	Err       error
	Exit      int
}

type ReportFact struct {
	Field string `json:"field"`
	Value string `json:"value"`
}

type ReportResult struct {
	Root   Root         `json:"root"`
	Change string       `json:"change"`
	Kind   string       `json:"kind"`
	Facts  []ReportFact `json:"facts"`
}

type Request struct {
	Args  []string
	Root  string
	Actor string
	Route Route
}

type Result struct {
	Operation string
	Value     any
	Exit      int
}

type ReviewOptions struct {
	// Actor is the harness identity recording the verdict. It is provenance,
	// never the verdict itself: the reviewer must be someone else.
	Actor    string
	Reviewer string
	Verdict  string
	Findings string
	Now      time.Time
}

type ReviewResult struct {
	Change            string                  `json:"change"`
	TaskID            string                  `json:"task"`
	AttemptID         string                  `json:"attempt"`
	PolicyDigest      string                  `json:"policy_digest"`
	PacketHash        string                  `json:"packet_hash"`
	EvidenceSet       string                  `json:"evidence_set"`
	Approvable        bool                    `json:"approvable"`
	Blockers          []core.ReadinessBlocker `json:"blockers"`
	Verdict           evidence.ReviewVerdict  `json:"verdict"`
	RecordID          string                  `json:"record,omitempty"`
	Findings          string                  `json:"findings,omitempty"`
	FindingsTruncated bool                    `json:"findings_truncated,omitempty"`
}

type Root struct {
	Path string `json:"path"`
}

type Route string

type StartOptions struct {
	Actor string
}

type StartResult struct {
	Change         string   `json:"change"`
	TaskID         string   `json:"task"`
	AttemptID      string   `json:"attempt"`
	BaselineHEAD   string   `json:"baselineHead"`
	RevisionBefore uint64   `json:"revisionBefore"`
	RevisionAfter  uint64   `json:"revisionAfter"`
	DeclaredFiles  []string `json:"declaredFiles"`
	Assurance      string   `json:"assurance"`
}

type StatusNextAction struct {
	Kind      string `json:"kind"`
	Operation string `json:"operation,omitempty"`
	Owner     string `json:"owner,omitempty"`
	Action    string `json:"action"`
}

type StatusProduction struct {
	Profile             string                     `json:"profile"`
	PolicyDigest        string                     `json:"policyDigest"`
	Assurance           string                     `json:"assurance"`
	ReviewApprovable    bool                       `json:"reviewApprovable"`
	ReviewBlockers      []core.ReadinessBlocker    `json:"reviewBlockers"`
	FrictionEligibility []core.FrictionEligibility `json:"frictionEligibility"`
}

type StatusResult struct {
	Root             Root                  `json:"root"`
	Approval         *core.ApprovalHandoff `json:"approval,omitempty"`
	ApprovalStatus   core.ApprovalStatus   `json:"approvalStatus"`
	Counts           ActivityCounts        `json:"counts"`
	Tasks            []core.TaskReadiness  `json:"tasks"`
	Frontier         []string              `json:"frontier"`
	Next             StatusNextAction      `json:"next"`
	AllTasksComplete bool                  `json:"allTasksComplete"`
	Production       StatusProduction      `json:"production"`
	state.Projection
}

type SyncOptions struct {
	Approver, Reason string
	Input            io.Reader
	Output           io.Writer
	Now              time.Time
}

type UsageRefusal struct{ *failure.Refusal }

type VerifyOptions struct {
	Actor       string
	Timeout     time.Duration
	OutputLimit int
	// Production options. An empty class keeps the default test-run loop, which
	// runs exactly the approved task verification command.
	Profile      string
	Class        string
	CheckID      string
	Command      string
	Reviewer     string
	ReviewPassed bool
}

type VerifyResult struct {
	Evidence evidence.TestRun `json:"evidence"`
	// Production carries build, lint, and review observations. It is absent for
	// the default profile, whose result shape is unchanged.
	Production *evidence.Production `json:"production,omitempty"`
	RecordID   string               `json:"recordId"`
	Complete   bool                 `json:"complete"`
}