Read-only standards control plane for the local ~/dev repo forest.
devctl inventories repos, audits a small set of high-value engineering laws,
and groups findings into repair tranches. V0 is report-only: it does not edit
target repos.
devctl inventory ~/dev --json
devctl standards audit ~/dev --pilot three-tier
devctl standards adjudication-template ~/dev --pilot three-tier --risk P0,P1
devctl standards audit ~/dev --all --json
devctl standards contracts ~/dev --pilot three-tier
devctl standards plan ~/dev --all --risk P0,P1
devctl standards packet ~/dev --pilot three-tier --risk P0,P1 --out /path/to/reports
devctl standards propose-contract ~/dev/sample-desktop-edge
devctl standards propose-contract ~/dev/sample-desktop-edge --json
devctl standards report ~/dev --pilot three-tier --out /path/to/reports
devctl repo explain ~/dev/sample-desktop-edgeCatalog checks are advisory interpretations of mlnavigator-ai/standards, not
independent rule authority. Each law names stable standard IDs and a selected
standards revision. Local equivalents and adopted repository guidance retain
their meaning. See standards alignment.
V0.1 adds the review loop around the original read-only audit:
catalog/archetypes.tomldefines the repo shapes that make standards sensible.catalog/contracts/contains operator-owned repo contracts with typed command, Cloudflare, release, token, and artifact records. Target repos are still read-only.catalog/local/contracts/is ignored and may contain private operator contracts. Local contracts load after public contracts and override matching repo names without being published.catalog/laws.tomldeclares the active laws and their maturity.catalog/adjudications.tomlrecords explicit review decisions by finding fingerprint.standards contractscompares typed repo contracts to observed repo reality.standards adjudication-templateprints review stubs for unreviewed findings.standards propose-contractprints a catalog-shaped TOML draft to stdout only, with local proposal metadata such as absolute paths stripped. Add--jsonwhen you need the full evidence/proposal payload.standards planexcludes findings adjudicated asaccepted-exception,false-positive, orlaw-needs-work, then groups remaining work by repo/law/requirement so tranches are PR-sized.standards packetwrites the pilot operating packet: contract proposals, adjudication stubs, risk-scoped tranches, and ordered next actions.standards reportwrites JSON and Markdown snapshots.
Both commands write only under the required --out directory. There is no
default, so output never lands in an audited repository implicitly. Choose a
location outside the audited repositories, or this checkout's reports/, which
git ignores. Reports are evidence artifacts, not source policy.
The repo development flow is the center of the system. Contracts and archetypes
define intent; devctl is the read-only instrument panel that observes drift,
proposes contracts, and packages repair work.
Catalogs are relocatable: put public catalog/ beside a distributed executable,
or select devctl --catalog-root /path/to/catalog inventory /path/to/forest --json.
A symlinked launcher resolves to the real executable, so the catalog belongs
beside the link target. Source development uses
cargo run -- --catalog-root ./catalog .... Runtime lookup never uses the build
machine's source directory; missing inputs fail.
Direct CLI use retains the selected catalog's local/contracts overlay when
present. --no-private-contracts disables it; --contracts-overlay /private/path
selects a separate existing directory. These are read-only inputs. devctl has no
export or packaging command; whoever packages it decides which files ship.
TOML parse errors in catalog, contract and adjudication files omit source values.
Semantic validation errors and findings can still name a loaded contract's repo,
archetype, posture, command ids, surface keys and file path, including from an
overlay; pass --no-private-contracts when those must not appear.
Version 0.4.0 is a compatibility boundary. Source runs need --catalog-root,
law catalogs need schema 0.2.0, and report/packet need --out.
doctrine-quartet findings are no longer emitted, and the P1
active-repo-contract-present requirement is replaced by the non-actionable P3
catalog-enrollment-unverified observation.
cargo fmt --check
cargo clippy --workspace --all-targets -- -D warnings
cargo test --workspace