docs(consumer-upgrade-path): R-phase design verdict + prior-art SSOT #124/#125 (#551 residual) - #607
Merged
Merged
Conversation
…124/#125 (#551 residual) Design-first R-phase for an idempotent consumer refresh path that updates framework-owned shipped artefacts without clobbering consumer-owned files. Output (doc only, no implementation code — T2/T5): - research-patch 2026-06-17-consumer-upgrade-path.md: WebSearch prior-art sweep (copier/cruft = Python, no Node-consumable analog), recommended BFR verdict ADAPT-no-dependency, framework-owned-vs-consumer-owned boundary derived from SHIPPED_DOCS + three-layer model + .override.md, conditioned implementation plan. - prior-art-evaluations.md: SSOT #124 (cruft, ADAPT) + #125 (Copier update for refresh, ADAPT) — both cross-reference #22, append-only. Two genuine forks PARKED for the maintainer per kickoff §9 + reviewer-discipline §2: (1) ADOPT-dep vs ADAPT-no-dep vs BUILD; (2) stateless refresh vs shipped-version stamp. DeepWiki MCP unreachable in env (per #121/#123 precedent) → WebSearch + SSOT substituted; recorded as a §0 methodology caveat. No code shipped. Prior-art: skipped — docs only (R-phase research-patch + SSOT register rows), no new capability commit (no dep, no code under packages/). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
artyhoo
enabled auto-merge (squash)
June 17, 2026 08:59
artyhoo
added a commit
that referenced
this pull request
Jun 17, 2026
…24-128→126-130 (collision with #607 cruft/Copier 124/125) Append-only register collision from parallel work: #607 took SSOT 124 (cruft) + 125 (Copier) while aif's branch also used 124-128. Renumbered aif's rows to 126-130 and updated self-refs in passport.ts + principle 23 (#124→#126 CC/init, #126→#128 Repomix). Bridge-patch #127/#128 refs untouched (upstream PR numbers, different namespace).
This was referenced Jun 17, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
consumer-upgrade-path — design R-phase output (GH #551 residual, under #550)
Autonomous aif-handoff R-phase (task
7c0e5871) for an idempotent consumer refresh path that updates framework-owned shipped artefacts without clobbering consumer-owned files. Docs only — no implementation code (R-phase deliverable is a decided design, per T2/T5).Lands:
docs/meta-factory/research-patches/2026-06-17-consumer-upgrade-path.md— prior-art sweep + recommended BFR verdict ADAPT-no-dependency + framework-owned-vs-consumer-owned boundary derivation + conditioned implementation plan.docs/meta-factory/prior-art-evaluations.md— SSOT docs(meta-factory): automerge to staging plan + maintainer settings recipe #124 (cruft, ADAPT) + feat(ci): real ci-success aggregate job (single required-check gate) #125 (Copierupdatefor refresh, ADAPT), both cross-referencing Wave 2 / §13.21: extend principle 09 to shipped artefacts + SSOT #11-#15 #22, append-only.Two genuine forks are PARKED for the maintainer (NOT decided here, per reviewer-discipline §2):
Methodology caveat (honest, T11/T12): DeepWiki MCP was unreachable in the aif container → sweep ran via WebSearch ×3 + SSOT #22; verdict is recommended/provisional on the dependency fork.
§1.7 Forward-check applied
Checked this R-phase design against the active disciplines before shipping; all comply.
build-first-reuse-default.md §3— prior-art sweep run before any proposal; verdict ADAPT (reusecopy_safe/merge_prettierignore), BUILD rejected as#parallel-evolution-creep. file:line evidence:docs/meta-factory/research-patches/2026-06-17-consumer-upgrade-path.md:73reviewer-discipline.md §2— the ADOPT-vs-ADAPT strategy call is surfaced as DECISION-NEEDED with both consequences, not picked. file:line evidence:docs/meta-factory/research-patches/2026-06-17-consumer-upgrade-path.md:101no-paid-llm-in-ci.md— R-phase is session-bound; zero API-billed CI calls; this PR is docs-only.doc-authority-hierarchy.md §2-§3— the patch carries an Authoritative-for / NOT-authoritative-for header. file:line evidence:docs/meta-factory/research-patches/2026-06-17-consumer-upgrade-path.md:45§1.7 Backward-check applied
Swept the existing artefacts under this design's scope; it extends, supersedes nothing.
install.sh:187— verifiedcopy_safeskip-if-exists +--forcewholesale; the refresh path is a third mode reusing this plumbing. file:line evidence:install.sh:187INSTALL-FOR-AI.mdthree-layer authority model +.override.md— the framework-vs-consumer boundary source; refresh extends it, does not redefine. file:line evidence:docs/meta-factory/research-patches/2026-06-17-consumer-upgrade-path.md:114docs/meta-factory/prior-art-evaluations.md:197