Repository navigation
docs(architecture): reconcile Scaffoldia with deed-era contracts and M0 acceptance gates - #68
Conversation
Record the observed design-phase baseline, current ownership boundaries, composer/retrofit acceptance gates, and proposed engine ADR without claiming implementation or CI success.
|
Caution Review failedThe pull request is closed. Summary
Merge Risk:
|
|
Codex Review Summary: ✅ CompletedThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b4934249ee
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| `(mint-answers)` clauses of a repository `*_chora.deed`. Earlier standalone | ||
| `VARIANT.a2ml`/`ARCHETYPE.a2ml` descriptions were superseded in part by | ||
| rsr-template-repo ADR-0002/0003 on 2026-10-06. Both the template mint and | ||
| Scaffoldia must use the same upstream contract semantics, with replayable | ||
| mint answers and drift checks; no parallel schema. |
There was a problem hiding this comment.
Update the canonical AI manifest for deed contracts
When an agent follows the repository's root entry point, 0-AI-MANIFEST.a2ml:12 still says that Scaffoldia consumes VARIANT.a2ml contracts. That directly conflicts with this new statement that those standalone contracts are superseded and no parallel schema is permitted, so automated implementation work can continue targeting the obsolete input format; update the root manifest as part of this reconciliation.
Useful? React with 👍 / 👎.
| * [ ] Implement dry-run mint with actual Julia-library archetype (first | ||
| vertical slice) and an independently demonstrated Rust-CLI archetype. | ||
| * [ ] Implement dry-run three-way retrofit against pinned parent; preserve | ||
| unrelated changes and stop on conflicts. |
There was a problem hiding this comment.
If M0 is implemented literally, both adapters stop at dry-run, but the ADR's M0 acceptance requires a minted repository to build, replay without drift, and exercise application idempotence. Those checks require materializing and applying a plan, so the milestone can currently be marked complete without satisfying its own acceptance evidence; include approved local staging/application for mint and retrofit in M0.
Useful? React with 👍 / 👎.
| * 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. |
There was a problem hiding this comment.
Permit contract-declared overlay replacements
When an archetype or feature overlay intentionally replaces a path supplied by the spine, this rule classifies that expected overlap as a conflict, even though overlays are listed as required inputs to composition. Without an explicit precedence or replacement-authorization rule, the planner cannot apply ordinary overlays without violating the architecture; reserve conflicts for undeclared competing claims and define how deed-authorized overlay replacements are represented.
Useful? React with 👍 / 👎.



Scope
Read-only architectural reconciliation; no composer implementation, licensing changes, or merge claim.
*_chora.deedclauses and archetype*_praxis.deedcontracts from the spine (legacy standaloneVARIANT.a2ml/ARCHETYPE.a2mlwere superseded in part on 2026-10-06).Baseline
Main
84e13a6e8b41e12026f2a5cbbd97fb91fc3fa849inspected on 2026-11-15.The repo's own
STATE.a2mlstill reports design phase and 5% completion. No core composer, mint planner or retrofit engine exists on this PR.Known issues / separate corrective work
validate-rsrreferences obsoletelicensing/paths,validate-stateprints invalid without failing, and the AI-install check expects absent template material.www/.well-known/security.txt.actions.lockstructure.Review requirements
metadatastician/standardsand the livehyperpolymath/rsr-template-repo.