Docs hygiene: anchor version, alkahest email, populate ROADMAP

Closes three of the small drift findings from CRG-AUDIT-2026-04-18:

  * `.machine_readable/anchors/ANCHOR.a2ml` — version bumped from the
    Sonnet-era "1.0.0" relic to the actual "0.9.0" matching STATE.a2ml.
    The anchor is the canonical-authority file; carrying the inflated
    version was the same drift the 2026-02-12 Opus audit cleaned in
    README/main.rs but missed here.

  * `alkahest-shell-transmuter/README.adoc` — author email
    `hyperpolymath@example.com` placeholder replaced with
    `j.d.a.jewell@open.ac.uk` (canonical attribution per the project
    author rules: noreply for git metadata, real email for docs).

  * `ROADMAP.adoc` — replaces the 22-line rsr-template stub with a
    substantive roadmap ported from CLAUDE.md. Sections: v0.9.x
    Stabilisation (D→C closure list against the 2026-04-18 audit),
    v0.10.x POSIX coverage, v1.0.0 production gate, v2.0 Idris2
    extraction path. All milestone items grep-verifiable against
    on-disk artefacts. References the audit, PROOF_HOLES_AUDIT,
    POSIX_COMPLIANCE.md, and the audit-2026-04-04 residuals list.

Two related items deliberately not bundled here:

  * `lust/` rename: already done in commits a48a1dc + 8b0a56a (the
    audit was stale on this point — neither root `contractiles/` nor
    `.machine_readable/contractiles/` carries `lust/` any more).
    Completing the six-verb layout (creating `intend/`, `adjust/`,
    relocating k9 to svc/) is a separate larger restructure.

  * `.expect("TODO: handle error")` sweep: tracked in batches 1-3
    (commits 712e3a1, 962da88, f045ced); 136/~530 cleared. Continues
    in subsequent commits.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: hyperpolymath

.machine_readable/anchors/ANCHOR.a2ml

@@ -2,7 +2,7 @@
 # This is the canonical authority for the valence-shell repository.
 
 id: "org.hyperpolymath.valence-shell"
-version: "1.0.0"
+version: "0.9.0"
 clade: "unknown"
 status: "active"
 

ROADMAP.adoc

@@ -1,22 +1,100 @@
 // SPDX-License-Identifier: PMPL-1.0-or-later
 = Valence Shell Roadmap
+:toc:
 
 == Current Status
 
-Initial development phase.
+v0.9.0 (advanced research prototype, ~74% complete per
+`.machine_readable/6a2/STATE.a2ml`).
 
-== Milestones
+The Rust CLI in `impl/rust-cli/` is a functional interactive shell with
+reversible filesystem operations, transaction grouping, and
+proof-annotated dry runs. It is NOT production-ready and NOT a drop-in
+replacement for bash/zsh.
 
-=== v0.1.0 - Foundation
-* [ ] Core functionality
-* [ ] Basic documentation
-* [ ] CI/CD pipeline
+For the full honest status see `CLAUDE.md`; for caveats per claim see
+`EXPLAINME.adoc`; for proof-debt see `docs/PROOF_HOLES_AUDIT.md`.
 
-=== v1.0.0 - Stable Release
-* [ ] Full feature set
-* [ ] Comprehensive tests
-* [ ] Production ready
+== v0.9.x — Stabilisation (D → C per CRG v2.0)
 
-== Future Directions
+Tracked against `docs/governance/CRG-AUDIT-2026-04-18.adoc`. Goal: green
+CI on `rust-cli.yml`, dogfood evidence, structural compliance.
 
-_To be determined based on community feedback._
+* [ ] Revert the remaining `.expect("TODO: handle error")` sites in
+  `impl/rust-cli/src/`. Batches 1-3 cleared 136 of ~530 (commits
+  `712e3a1`, `962da88`, `f045ced`). Remaining concentrated in
+  `parser.rs` (116), `commands.rs` (66), `arith.rs` (55), `state.rs`
+  (35) — each warrants its own session.
+* [ ] Close the Coq `admit.` in `proofs/coq/filesystem_composition.v:199`
+  (`single_op_reversible` `OpRmdir` branch) or update
+  `[coq-proof-status] admitted = 1` with full justification.
+* [ ] Turn `rust-cli.yml` green after the `.expect` sweep completes.
+* [ ] Enable `validation.yml verify-proofs` job (currently `if: false`);
+  start with Lean 4 via `lake build`, then phase in Coq/Agda/Isabelle/Z3.
+* [ ] Per-directory README coverage 23% → ~90% (17 subtrees missing,
+  enumerated in the audit).
+* [ ] Add `[dogfooding-status]` to STATE.a2ml with concrete daily-use
+  entries.
+* [ ] Add 3+ ADRs to META.a2ml (six-system proof stack, Rust as primary
+  implementation, property-testing as correspondence-gap mitigation) and
+  populate `[development-practices]`.
+* [ ] Resolve `impl/rust-ffi/` ↔ `ffi/rust/` duplicate tree (~50
+  `.expect("TODO")` sites in each); decide which is canonical.
+* [ ] Complete contractile six-verb layout: create `intend/` (absorbs
+  former `lust/`, already removed in commit `a48a1dc`), `adjust/`;
+  relocate `k9` out of `contractiles/` per ADR-001 (k9 is svc, not a
+  contractile).
+* [ ] Close `docs/reports/audit/audit-2026-04-04.md` residuals: re-author
+  47 spoofed git commits, wire Echidna CI, remove dead code
+  (`lean_ffi.rs`, `daemon_client.rs`).
+
+== v0.10.x — POSIX Coverage
+
+Most critical missing POSIX features, ranked by impact (per CLAUDE.md
+and `docs/POSIX_COMPLIANCE.md`):
+
+. Shell functions (`func() { ... }` syntax) — blocks modular scripts.
+. Shell script execution (`.sh` files, shebang handling).
+. Word splitting (`$IFS`) — unquoted variable expansions are not split.
+. Tilde expansion beyond `~/` in `cd`.
+. `trap` — cannot handle signals in scripts.
+. `alias` — no command aliases.
+. SIGCHLD / Ctrl+Z — job control incomplete.
+
+`docs/POSIX_COMPLIANCE.md` carries the full M1-M11 milestone tracker;
+M1-M9 complete, M10-M11 partial.
+
+== v1.0.0 — Production Readiness Gate
+
+Hard requirements before any v1.0 claim:
+
+* [ ] Mechanized Lean → Rust correspondence (currently property testing
+  only, ~85% confidence).
+* [ ] Close all real gaps in `docs/PROOF_HOLES_AUDIT.md` (post-2026-04
+  sweep: 1 real gap, 1 justified axiom, 1 structural).
+* [ ] CRG v2.0 grade B: 6+ diverse external targets, issues fed back.
+  See audit `=== External validation` section for the proposed diverse-6
+  shape.
+* [ ] Complete RMO (Remove-Match-Obliterate) implementation for GDPR
+  compliance — currently stubs only.
+* [ ] Echidna integration for automated property-based verification.
+
+== v2.0 — Idris2 Extraction Path
+
+Begin the Idris2 extraction path (per CLAUDE.md "This Month" plan).
+
+* [ ] Populate `src/abi/` Idris2 ABI definitions beyond the current
+  3-file stubs (`Types.idr`, `Layout.idr`, `Foreign.idr`).
+* [ ] Wire Zig FFI: `ffi/zig/` builds but is not integrated with the
+  Rust CLI; `impl/zig/` targets ~5ms cold start.
+* [ ] BEAM daemon implementation (planned, not built; Elixir NIF build
+  currently broken, low priority).
+
+== Operating Notes
+
+* This roadmap supersedes the prior rsr-template stub. Authoritative
+  next-step detail lives here; CLAUDE.md retains the honest-status
+  narrative.
+* All milestone items are grep-verifiable against on-disk artefacts.
+* Cadence: edit ends with an Agda/Coq/Lean compile or `cargo build` +
+  `cargo test`; outcomes captured in commit messages.

alkahest-shell-transmuter/README.adoc

@@ -5,7 +5,7 @@ image:https://img.shields.io/badge/License-PMPL--1.0-blue.svg[License: PMPL-1.0,
 
 
 
-Jonathan D.A. Jewell <hyperpolymath@example.com>
+Jonathan D.A. Jewell <j.d.a.jewell@open.ac.uk>
 v0.1.0-alpha, 2025-12-19
 :toc: left
 :sectnums: