Skip to content

ADR-0016: Implement cornerstone status command

  • Status: Accepted
  • Date: 2026-03-26
  • Deciders: DeAcero Agentic Team (Technical Committee)
  • Supersedes: None

Context

The architecture diagram in docs/general_architecture.md declares a cornerstone CLI with a status command, but it currently lacks implementation. This creates a discoverability gap where users and agents cannot easily verify the health of the agentic infrastructure. A status command is required to check observability reachability, telemetry freshness, skill sync status, GitHub authentication, and .env completeness.

Decision

We will implement the cornerstone status command to perform real-time health checks of the project's agentic infrastructure. The command will return a 0 exit code if all checks pass, and 1 otherwise, making it scriptable. Checks to be included: - Observability Service reachability (GET /healthz on $AGENTIC_TELEMETRY_URL) - Last telemetry event sent (GET /v1/summary?project=<slug>&limit=1) - Skills sync freshness (.agents/.last_sync timestamp) - gh auth status - .env completeness (e.g. SQUIT_API_KEY, AGENTIC_TELEMETRY_URL) - ADR gate status validation in CI pipelines

The command must support a --json output flag for machine-readable integrations.

Consequences

Positive

  • Standardized onboarding and environment diagnosis.
  • Improved reliability by quickly identifying broken configurations before pipelines fail.

Negative

  • Requires maintaining another CLI internal tool and keeping its dependencies updated.
  • Some checks (like gh auth) might be slow or require internet access, slightly delaying the command execution.