show

type CrossBranchView struct {
	// Ref is the ref content was read from. Empty when Collision is
	// true — no single ref was chosen.
	Ref string `json:"ref,omitempty"`
	// Collision is true when the candidate refs carry divergent
	// content (M-0259/AC-3). Title/Status/Body/ACs are left empty on
	// the ShowView in that case — aiwf show declines to pick a side
	// (M-0260/AC-3) rather than render one ref's content as canonical.
	Collision bool     `json:"collision"`
	Refs      []string `json:"refs"`
}

type ScopeView struct {
	AuthSHA    string `json:"auth_sha"`
	Entity     string `json:"entity"`
	Agent      string `json:"agent"`
	Principal  string `json:"principal"`
	State      string `json:"state"`
	Opened     string `json:"opened,omitempty"`
	EndedAt    string `json:"ended_at,omitempty"`
	EventCount int    `json:"event_count"`
}

type ShowAC struct {
	ID          string `json:"id"`
	Title       string `json:"title"`
	Status      string `json:"status"`
	TDDPhase    string `json:"tdd_phase,omitempty"`
	Description string `json:"description,omitempty"`
}

type ShowView struct {
	ID     string `json:"id"`
	Kind   string `json:"kind"`
	Title  string `json:"title"`
	Status string `json:"status"`
	Path   string `json:"path,omitempty"`
	Parent string `json:"parent,omitempty"`
	TDD    string `json:"tdd,omitempty"`
	// Priority carries the entity's own `priority` frontmatter
	// (G-0078, E-0066, M-0263) — empty for a kind that never carries
	// one (entity.CarriesOwnPriority) or an unprioritized gap/decision.
	Priority     string                 `json:"priority,omitempty"`
	ACs          []ShowAC               `json:"acs,omitempty"`
	Body         map[string]string      `json:"body,omitempty"`
	History      []history.HistoryEvent `json:"history,omitempty"`
	Findings     []check.Finding        `json:"findings,omitempty"`
	ReferencedBy []string               `json:"referenced_by"`
	Scopes       []ScopeView            `json:"scopes,omitempty"`

	// Archived is true when the resolved entity's path lives under a
	// per-kind `archive/` subdirectory per ADR-0004. JSON shape uses
	// `omitempty` so active envelopes don't carry the field at all —
	// downstream tooling treats presence as the indicator. Text
	// rendering appends ` · archived` to the header line (see
	// renderShowText). M-0087/AC-5.
	Archived bool `json:"archived,omitempty"`

	// Composite-id-only fields (when querying M-NNN/AC-N): the AC's
	// own state, populated instead of (not in addition to) the
	// milestone's full ACs slice.
	AC       *ShowAC `json:"ac,omitempty"`
	ParentID string  `json:"parent_id,omitempty"`

	// CrossBranch is non-nil when id missed the local working tree but
	// resolved live from another local or remote-tracking ref (M-0260,
	// ADR-0030's read-side extension point). Nil for a locally-resolved
	// entity — the JSON envelope omits the field entirely so a
	// downstream consumer can treat its absence as "this is ordinary
	// local state."
	CrossBranch *CrossBranchView `json:"cross_branch,omitempty"`

	// Area carries the resolving ref's real `area:` for a cross-branch
	// hit so the `aiwf show --area` predicate can evaluate against the
	// entity's actual area instead of the local-only tr.ResolvedAreaByID
	// lookup, which reports any cross-branch id untagged (E-0067/M-0266,
	// G-0419). In-memory only (json:"-") — the JSON envelope's shape is
	// unchanged. Empty for a locally-resolved entity (the predicate uses
	// the local lookup there); for a cross-branch collision (the content,
	// including the area, is in dispute); and for a cross-branch
	// milestone, whose own `area:` is never stored — a milestone's area
	// rolls up from its parent epic, a resolution this own-field read
	// deliberately does not follow across refs.
	Area string `json:"-"`
}