headroom/docs/spec
chopratejas 0414cb70e4 feat(rust): scaffold workspace + parity harness (phase-0)
Bootstrap the Rust port of Headroom. Additive only — no existing Python
code modified. Ships the workshop, not the widgets.

Layout
  Cargo.toml (workspace) + rust-toolchain.toml
  crates/headroom-core    — transform library, stub only
  crates/headroom-proxy   — axum binary, /healthz only
  crates/headroom-py      — PyO3 cdylib, exposes headroom._core.hello()
  crates/headroom-parity  — Rust-vs-Python oracle harness + parity-run CLI

Tooling
  Makefile: test, test-parity, bench, build-proxy, build-wheel, fmt, lint
  .github/workflows/rust.yml: test, wheels (linux/mac), audit, parity-nightly
  deny.toml for cargo-deny

Parity corpus
  tests/parity/recorder.py + scripts/record_fixtures.py
  125 recorded fixtures across 5 leaf transforms (ccr, tokenizer,
  log_compressor, diff_compressor, cache_aligner)

Docs
  RUST_DEV.md — developer setup and workspace reference
  docs/spec/022-rust-migration.md — migration plan and stage breakdown

.gitignore: whitelist scripts/record_fixtures.py; ignore target/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-24 13:39:48 -07:00
..
001-vision.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
002-architecture.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
003-adrs.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
004-domain-model.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
005-integrations.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
006-actors.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
007-behavior.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
008-capabilities.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
009-compliance.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
010-data.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
011-deployment.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
012-diagrams.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
013-disaster-recovery.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
014-governance.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
015-interfaces.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
016-observability.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
017-operations.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
018-policies.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
019-quality.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
020-security.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
021-testing.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00
022-rust-migration.md feat(rust): scaffold workspace + parity harness (phase-0) 2026-04-24 13:39:48 -07:00
SPEC.md docs: move spec from specify/ to docs/spec/ 2026-04-16 21:15:04 -05:00