feat(cli): compact colour-coded inspect by default, add --verbosity

[pbWise]

Uniforms the CLI with the sibling orpc-agent CLI (Wiseair-srl/orpc-agent#15) and releases @agent-surface/cli 0.21.0 (changeset included; merge publishes).

What changed

• Compact default inspect: headline (counts, gates, snapshot integrity) + one flat colour-coded table + 2-line caveat. No banner, no provenance block, no declaration grouping; drift sections print only when there is drift (an explicit --base always gets its answer).
• --verbosity min|normal|detail on every command; --detail kept as shorthand. min stops at the headline (for check: verdict + per-section counts); detail restores the grouped-by-declaration inventory with descriptions, tags, provenance fields and the full caveat.
• Colours in both renderers (Ink and plain ANSI): effects cool when reading, warm when writing (read/server-query cyan, local-state gray, navigation blue, server-mutation yellow, external magenta, destructive red); reach green/yellow/red; required green; — dim. Same scale as orpc-agent. Painted only at a TTY (!CI && !NO_COLOR && TERM!=dumb); piped output stays byte-stable.
• --format accepts md as a spelling of markdown.
• check on failing integrity prints Update the snapshot in this change: agent-surface snapshot on stderr, where it survives a piped report.
• Docs (docs/20-cli.md, READMEs incl. stale root-README sample) updated.

Canonical --json output unchanged. AS-CLI-001 holds (every capability rendered at normal/detail); AS-CLI-003 byte-stability covered by a new colour test.

Test plan

• pnpm vitest run — 403/403 workspace-wide, incl. new verbosity/colour tests
• pnpm -r typecheck clean
• Smoke on examples/devices-app: all three levels, Ink + coloured-plain via pty, --detail diff-identical to --verbosity detail, piped output ANSI-free, failing check prints stderr hint

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
agent-surface-docs	Ready	Preview	Aug 2, 2026 9:49pm