diff --git a/0-AI-MANIFEST.a2ml b/0-AI-MANIFEST.a2ml index 54e9bdb..62b1cbe 100644 --- a/0-AI-MANIFEST.a2ml +++ b/0-AI-MANIFEST.a2ml @@ -5,18 +5,18 @@ # [metadata] version = "0.1.0" -last-updated = "2026-07-27" +last-updated = "2026-11-16" [project] -name = "[YOUR-REPO-NAME]" -purpose = "Full-featured repository designer for the RSR estate: composes spine × variant pack × features × profile into new repos and retrofits existing ones. Design phase — consumes VARIANT.a2ml contracts; top of the scaffolding stack (standards → rsr-template-repo → scaffoldia)." +name = "scaffoldia" +purpose = "Design-stage RSR repository composer: deterministic mint and retrofit from pinned metadatastician/standards canon and rsr-template-repo spine, consuming deed-era *_chora.deed clauses and archetype *_praxis.deed contracts. No operational composer, apply, or linked ABI is yet implemented." [ai-allocation] agents = [ { name = "CLAUDE", role = "proofs, compilers, repo-local implementation, CI/CD, formal verification, Rust/Idris2/Zig" }, { name = "CHATGPT", role = "prose, papers, publication review, standards docs, outreach drafts, letters" }, { name = "GEMINI", role = "estate audits, cross-repo sweeps, long-context triage, pattern detection" }, - { name = "VIBE", role = "UI/frontend, PanLL panels, ReScript components, theming, rapid prototyping" }, + { name = "VIBE", role = "UI/frontend, accessibility, PanLL panels, theming and prototypes using the project-approved implementation stack" }, ] [policy] @@ -30,5 +30,5 @@ items = [ { agent = "CLAUDE", task = "proofs, compilers, repo-local implementation, CI/CD, formal verification, Rust/Idris2/Zig" }, { agent = "CHATGPT", task = "prose, papers, publication review, standards docs, outreach drafts, letters" }, { agent = "GEMINI", task = "estate audits, cross-repo sweeps, long-context triage, pattern detection" }, - { agent = "VIBE", task = "UI/frontend, PanLL panels, ReScript components, theming, rapid prototyping" }, + { agent = "VIBE", task = "UI/frontend, accessibility, PanLL panels, theming and prototypes using the project-approved implementation stack" }, ] diff --git a/docs/architecture/TOPOLOGY.adoc b/docs/architecture/TOPOLOGY.adoc index b6fd919..062e489 100644 --- a/docs/architecture/TOPOLOGY.adoc +++ b/docs/architecture/TOPOLOGY.adoc @@ -69,8 +69,24 @@ Identity + capability request -' | * Ingest: pinned canon/spine snapshots, exact deed contracts and overlays; reject unknown capability, unpinned inputs and invalid paths. -* Plan: deterministic ordering; detect duplicate and overlapping path claims; - emit explicit conflicts; never silent last-writer-wins. +* Plan: deterministic ordering and declared path ownership. An archetype or + feature overlay may *replace* a spine-owned path only when an applicable + pinned deed contract explicitly authorises replacement of that canonical + relative path. Record the authorising deed, source and target layers, the + expected old content/hash and replacement operation in the plan and receipt. + A change of base hash, unrecognised deed authorisation, undeclared overlap, + competing overlay claims, path traversal, alias collision or forbidden + capability must fail closed. No silent last-writer-wins. +* Overlay precedence: first pin the spine/base snapshot, then apply + contract-authorised archetype and feature overlays in the explicit order + defined by the pinned deed contract. Where the upstream contract provides + no order for competing overlays, fail with a conflict rather than inventing + precedence. A later authorised replacement has scope only for its declared + path; it is not permission to supersede an entire layer. +* The preceding rules describe the intended planner semantics, not a newly + implemented deed schema or a current runtime capability. Use the upstream + deed's normative replacement representation when implementing the planner; + do not invent an alternate public overlay contract. * Apply: sandboxed file staging, no remote mutation by default; authorisation required for real repository modification and all forge configuration. * Reconcile: compare pinned base, current child, and desired child; preserve diff --git a/docs/status/ROADMAP.adoc b/docs/status/ROADMAP.adoc index 9b6c73f..bcfcd2f 100644 --- a/docs/status/ROADMAP.adoc +++ b/docs/status/ROADMAP.adoc @@ -32,8 +32,18 @@ Zig tests or passing isolated workflows. path-traversal, license-policy and capability checks. * [ ] Implement dry-run mint with actual Julia-library archetype (first vertical slice) and an independently demonstrated Rust-CLI archetype. +* [ ] Implement an operator-approved *local staging apply* for mint. Materialise + a reviewed plan in an isolated target directory with declared input hashes, + path bounds and no forge or network mutation. Execute the minted repository's + real build/tests there; capture what was actually run. Repeat the same plan + against the same base and demonstrate deterministic, idempotent output. * [ ] Implement dry-run three-way retrofit against pinned parent; preserve unrelated changes and stop on conflicts. +* [ ] Implement an operator-approved *local staging apply* for retrofit. + Materialise the approved three-way plan in a disposable local copy, preserving + unrelated files and refusing changed-base hashes, unapproved replacements and + conflicts. Test both a successful authorised overlay replacement and an + intentionally conflicting undeclared replacement; verify idempotent replay. * [ ] Emit native deed clauses (profile, variant, provenance, mint-answers) and verify replayable mint drift via the existing spine mechanisms. * [ ] Make the forge/configure step explicitly operator-approved; no hidden