CLAUDE.md@crates/orbit-cmd ยท diff
git:20260929.88de6f6 to git:20261012.2c9dd80
1 added, 1 removed. Audit A to A.
# orbit-cmd
Command groups that need both a Core runtime and Registry state (`orbit-registry` sits above `orbit-core`, so Core can't see the workspace catalog). Consumed by `orbit-cli` and `orbit-web`.
- Flat layout: one file per command group, each closing exactly one composition seam named in its module doc. No grouping directories mirroring `--help` sections.
- Runtime behavior is exposed as per-module `*Commands` extension traits re-exported from the crate root; add new groups the same way.
- Pure consumer of `orbit_core::OrbitRuntime`'s public API. If a seam is missing, add it in Core deliberately, then consume it here. Never re-implement a Core rule.
- No `clap`, no `axum`. Return plain result structs both surfaces can render. Logic needed by Core's own runtime internals belongs in `orbit-core::adapter::command`.
- [`assets/agent-rules.md`](assets/agent-rules.md) is the `--inject-agent-rules` block; its markers live in the asset, so edit the asset, not marker handling.
- - No crate-root `tests/`; end-to-end coverage lives in the CLI's integration tests.
+ - No crate-root `tests/`; end-to-end coverage, and tests of this crate's exported entry points, live in the CLI's integration tests.