Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions 0-AI-MANIFEST.a2ml
Original file line number Diff line number Diff line change
Expand Up @@ -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" },
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved
]

[policy]
Expand All @@ -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" },
]
20 changes: 18 additions & 2 deletions docs/architecture/TOPOLOGY.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved
* 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
Expand Down
10 changes: 10 additions & 0 deletions docs/status/ROADMAP.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Comment thread
hyperpolymath marked this conversation as resolved.
Resolved
* [ ] 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
Expand Down
Loading