ops

type Block struct {
	Status   string     `json:"status"`
	Searched []Searched `json:"searched"`
	Returned int        `json:"returned"`
	Omitted  Omitted    `json:"omitted"`
	Window   *Window    `json:"window,omitempty"`
	Errors   []string   `json:"errors"`
	// Notes is what the text answer would have said beside the result — the
	// review queue's count, a sweep that saved a missing checkpoint. Kept,
	// because a feature that announces itself in text and goes quiet in JSON
	// is a feature the agents reading JSON never hear about.
	Notes []string `json:"notes,omitempty"`
}

type CorrectRequest struct {
	ID     int64
	Memory memory.Memory // the text that is true now; kind and project come from ID
	Embed  *provider.Provider
	Model  string
	// DirFor names the repository a project lives in, or "". The correction
	// is anchored where the project of the memory it replaces stands — not
	// where the caller does, which may be a different project's checkout.
	DirFor func(project string) string
}

type CorrectResult struct {
	Correction memory.Correction `json:"correction"`
	Outcome    Outcome           `json:"outcome"`
}

type Ledger struct {
	Path        string // vault-relative, slash-separated
	Checkpoints int    // how many it was derived from
	InForce     int    // decisions no later one reversed
	Superseded  int    // decisions a later one reversed, struck through
	RuledOut    int    // dead ends still standing
	MayNotHold  int    // of those, the ones whose named files changed since
	Retired     int    // dead ends a person retired with `logos review --stale`
	Questions   int    // open questions
	Worktrees   int    // linked worktree scopes read alongside the project's own
	// Measured is whether the dead ends were measured against a repository.
	// Without one "may no longer hold" was not asked, which is not the same
	// answer as "none changed".
	Measured bool
}

type Note struct {
	Text   string `json:"text"`
	Failed bool   `json:"failed,omitempty"`
}

type Omitted struct {
	Budget        int `json:"budget"`
	Scope         int `json:"scope"`
	Quarantined   int `json:"quarantined"`
	Stale         int `json:"stale"`
	AnchorUnknown int `json:"anchor_unknown"`
}

type Outcome struct {
	Notes []Note `json:"notes,omitempty"`
}

type Promotion struct {
	Proposed   int // decisions put in the review queue as project memory
	Superseded int // promoted decisions a later accepted one reversed
}

type RecallQuery struct {
	Query   string
	Limit   int
	Project string
	Embed   *provider.Provider // nil ranks by keyword alone
	Model   string
	Shell   string
	// Dir is the repository the asker stands in, or "". A memory recorded at
	// one of its commits is measured against it, and marked when a file it
	// names has changed since.
	Dir string
	// Compact returns an id and one line per memory instead of the whole
	// text, so an agent surveying what is known pays only for the memories it
	// then asks for by id (RecallIDs).
	Compact bool
}

type RecallResult struct {
	Memories []Recalled `json:"memories"`
	Project  string     `json:"project,omitempty"`
	Outcome  Outcome    `json:"outcome"`
	Compact  bool       `json:"compact,omitempty"`
}

type Recalled struct {
	memory.Memory
	// NotDurable marks a memory the cache holds and the vault does not. It is
	// still usable and still true — it is just one `rm -rf .logos` from gone,
	// and the README tells people that command is safe. The write reported the
	// failure once, to a caller that has since exited; every reader after
	// that saw a row indistinguishable from a durable one. See
	// memory.UnflushedIDs.
	NotDurable bool `json:"not_durable,omitempty"`
}

type RememberRequest struct {
	Memory memory.Memory
	Embed  *provider.Provider // nil dedups by exact text
	Model  string
	// Dir is the repository the memory's project lives in, or "". Its HEAD is
	// recorded with the memory so recall can later say when a file the memory
	// names has changed since. "" records nothing, which is never flagged.
	Dir string
}

type RememberResult struct {
	Receipt memory.Receipt `json:"receipt"`
	Outcome Outcome        `json:"outcome"`
}

type Searched struct {
	Project     string `json:"project,omitempty"`
	AllProjects bool   `json:"all_projects,omitempty"`
}

type Window struct {
	From     string `json:"from"`
	To       string `json:"to"`
	SetAside int    `json:"set_aside"`
}