cordance 0.1.0

Cordance — deterministic-first context-pack compiler for AI coding agents. Umbrella package: installs the `cordance` binary, identical to `cargo install cordance-cli`.
cordance-0.1.0 is not a library.

cordance

Deterministic-first context-pack compiler for AI coding agents. Doctrine-shaped. Source-traced. Cortex-aware. Axiom-harness compatible.

crates.io docs.rs license

Install

cargo install cordance

This is the canonical install path. It pulls in cordance-cli and produces the cordance binary. cargo install cordance-cli is the equivalent direct path — both install the same binary.

Golden path

cd my-project          # any git repo
cordance init          # write a default cordance.toml
cordance pack          # compile the pack, emit every target
cordance advise        # deterministic doctrine checks (no LLM)
cordance check         # drift detection vs .cordance/sources.lock

The first cordance pack writes the initial outputs. The second cordance pack against an unchanged tree produces a byte-identical .cordance/pack.json — every output's SHA-256 is pinned in sources.lock, and cordance check will exit non-zero if anything drifts.

What it does

Run cordance pack against any repo and you get:

  • AGENTS.md + CLAUDE.md with fenced editable regions — hand edits outside the <!-- cordance:begin … --> / <!-- cordance:end … --> markers survive regeneration.
  • .cursor/rules/*.mdc derived from your project doctrine.
  • .codex/AGENTS.md + agents/codex/AGENTS.md for Codex CLI.
  • A pai-axiom-project-harness-target.v1 JSON the axiom validators accept verbatim.
  • A cordance-cortex-receipt-v1-candidate JSON that Cortex's cortex_memory_accept flow can ingest.
  • A .cordance/sources.lock so drift is auditable.

Workspace

Crate Purpose
cordance-core Types, schemas, ports. No I/O.
cordance-scan Deterministic repo scanner.
cordance-doctrine engineering-doctrine consumer.
cordance-emit Target emitters.
cordance-cortex Cortex candidate-receipt builder.
cordance-advise Deterministic doctrine checks.
cordance-llm Bounded candidate-prose adapters.
cordance-cli CLI library + binary.
cordance This umbrella package — installs the binary.

Run cordance --help for the full subcommand surface, or visit the project README for the design documents.

License

Dual-licensed under MIT OR Apache-2.0.