intent

type CapacityClass struct {
	ID    string
	Units wire.Count
}

type ExecutionCutover struct {
	EnabledBy    string
	DecisionRef  string
	GateEvidence []wire.Digest
}

type File struct {
	Path   string // e.g. "tickets/AT-07.json"
	Sha256 wire.Digest
	Bytes  int
	Raw    []byte
}

type GateDefinition struct {
	GateID         string
	Kind           string
	Argv           []string
	Cwd            string
	Env            []string
	TimeoutSeconds wire.Count
	ExpectedExit   *wire.Count
	Reducer        *string
	Evidence       []string
	Inputs         []string
	SharedResource *struct{ Class, Key string }
	Reusable       bool
	Required       bool
}

type ImportEntry struct {
	SourceQueueID        string
	SourceItemID         string
	TicketID             wire.TicketID
	SourceRevisionSha256 *wire.Digest
	AppliedSeq           wire.Size
}

type ImportMap struct {
	QueueID wire.QueueID
	Entries []ImportEntry
}

type LaneBudget struct {
	InputTokens         wire.Size
	CacheCreationTokens wire.Size
	CacheReadTokens     wire.Size
	OutputTokens        wire.Size
	Turns               wire.Count
	WallClockMinutes    wire.Count
}

type Policy struct {
	PolicyVersion              wire.Size
	Roles                      map[string][]string
	MaxActiveAttempts          wire.Count
	MaxWorkersTotal            wire.Count
	Classes                    []CapacityClass
	Lane                       LaneBudget
	TicketMultiplier           wire.Count
	RequireEnforcedFields      []string
	AdmissionsPerRevision      wire.Count
	RepairRounds               wire.Count
	MalformedReviewRetry       wire.Count
	GateRerunOnStale           wire.Count
	ReconcileAttempts          wire.Count
	EvidenceDays               wire.Count
	Gates                      []GateDefinition
	SerialFallback             string
	IntegrationRequiredKinds   []string
	AllowEmptyObligationsKinds []string
	ReviewLaneRequired         bool
	DocsLaneRequired           bool
	CemRequired                bool
	OcmRequired                bool
	Runtimes                   []RuntimeEntry
	AllowedEnvKeys             []string
	Raw                        []byte
}

type Queue struct {
	QueueID               wire.QueueID
	RepositoryAuthorityID string
	Prefix                string
	NextSerial            wire.Count
	SchemaVersion         string
	CanonicalWriter       string
	ForeignAdapterID      *string
	IntentBranch          string
	Fixture               bool
	ExecutionCutover      *ExecutionCutover
	ImportMapSha256       *wire.Digest
	WriteBarrier          WriteBarrier
}

type Repository struct {
	// CommonDir is the Git common directory (`<primary>/.git`).
	CommonDir string
	// PrimaryWorktree is the worktree whose `.git` is the common directory
	// itself (§3.1). Linked worktrees are never the primary.
	PrimaryWorktree string
	// StateDir is `<git-common-dir>/taskman` (§3.4); it may not exist.
	StateDir string
	// LockPath is `<git-common-dir>/taskman.lock`; reads never open it.
	LockPath string
	// FromLinkedWorktree is true when cwd was inside a linked worktree.
	FromLinkedWorktree bool
}

type RuntimeEntry struct {
	RuntimeID               string
	PathSha256              wire.Digest
	FileSha256              wire.Digest
	Mode                    string
	ArgvPrefix              []string
	CapabilityProfileSha256 wire.Digest
	ObservedBudgetFields    []string
	Roles                   []string
	MaxWorkers              wire.Count
	Enabled                 bool
}

type Store struct {
	Root      string // <primary>/.taskman
	Queue     *Queue
	Policy    *Policy
	ImportMap *ImportMap // nil when absent
	Tickets   []*ticket.Record
	Releases  []*release.Record
	Inventory *ticket.Inventory
	Tree      Tree
	// Digests of the individual files, keyed by store-relative path.
	Digests map[string]wire.Digest
}

type Tree struct {
	Files      []File // sorted by path
	TotalBytes int
	Sha256     wire.Digest
}

type WriteBarrier struct {
	Reason string
	Since  *wire.Timestamp
}