status

---
name: status
description: Report observable AgentOps evidence without selecting work. Triggers: "status", "show AgentOps status".
license: Apache-2.0
---

# Status

A status snapshot is trustworthy exactly when every line traces to an artifact
that exists on disk right now; the first inferred line turns the report into a
guess wearing a report's clothes.

Report only observable local facts: available intent and verdict artifacts and
their counts; deterministic check results; evidence recency; and unavailable or
corrupt sources. The canonical durable stores are `.agents/ao/intents/sha256`
and `.agents/ao/verdicts/sha256`. Subject manifests are caller-supplied: report
them only when the caller names their location, otherwise disclose them as
`not_checked`. When `.agents/ao` evidence exists, report which stored artifact
kind is newest and label that conclusion as evidence recency, not runtime phase
or process activity. The `ao status` snapshot emits the two counts plus that
newest-artifact recency conclusion, not a per-artifact digest or timestamp
listing; report a specific artifact's digest or timestamp only when the caller
asks about a named artifact.

Always disclose `checked` and `not_checked`. Runtime phase, execution elapsed
time, tool-call activity, and remaining work are `not_checked` unless a caller
provides a separate authoritative source for them.

`ao status` is the evidence-store view. It validates content-addressed artifact
names and content before counting them, reports corrupt and unavailable entries,
and shows only intent/verdict counts plus evidence recency. Retired legacy
surfaces (session indexes, provenance summaries, knowledge-health signals) are
not aggregated into this command.

Distinct state classes stay distinct in every status report: tracker state
belongs to the tracker, Git state to Git, factory or runtime state to the
selected factory's own doors, deterministic-check results to the executable
that produced them, and semantic validation to a fresh verdict. Report each
from its own authority, never merged into one blended "health" claim —
factory-complete, checks-green, and AgentOps-PASS are three different facts.

Status does not inspect work queues, assign priority, claim work, infer a next
action, repair records, govern retries, or change any state. Optional Git or
tracker metadata may be displayed only when the caller supplies it; absence
cannot change the report interpretation.

Named failure mode — **recency-as-activity**: reading "newest artifact is a
verdict" as "validation is running", which invents a runtime phase from a
timestamp.

Anti-pattern: filling `not_checked` gaps with plausible narrative so the
snapshot feels complete. Corrective: report the gap as a gap; an honest hole
outranks a smooth story.

Return the snapshot and stop.