From a7b80e34e93f28046f1db15548c71277e66081ca Mon Sep 17 00:00:00 2001 From: constbogdan Date: Mon, 21 Sep 2026 14:04:49 +0300 Subject: [PATCH] docs: t0 3 d4 history navigation --- .gitignore | 4 ++ docs/CODEX_HANDOFF.md | 2 +- docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md | 4 ++ docs/I07_PUBLISHED_RELEASE_REMEDIATION.md | 4 ++ docs/ITEM_6_CONSOLIDATION_CHECKLIST.md | 4 ++ docs/ITEM_6_I05_PRESENTATION.md | 2 + docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md | 2 + docs/README.md | 27 ++------ docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md | 5 ++ docs/T0_1_CP7_PERFORMANCE_AUDIT.md | 4 ++ docs/T0_1_OPERATOR_UX_INVENTORY.md | 5 ++ docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md | 40 +++++++++-- docs/T0_3_R2_MOSAIC_IDENTITY.md | 5 ++ docs/history/README.md | 67 +++++++++++++++++++ 14 files changed, 149 insertions(+), 26 deletions(-) create mode 100644 docs/history/README.md diff --git a/.gitignore b/.gitignore index b338b7cd2..df36aa4cc 100644 --- a/.gitignore +++ b/.gitignore @@ -71,6 +71,10 @@ docs/* !docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md !docs/README.md !docs/VALIDATION.md +!docs/history/ +!docs/history/README.md +!docs/history/ +!docs/history/README.md !docs/AGENTS.md !docs/CODEX_HANDOFF.md !docs/OBSERVED_MINOR_ISSUES.md diff --git a/docs/CODEX_HANDOFF.md b/docs/CODEX_HANDOFF.md index 8c7f53f62..75db30a23 100644 --- a/docs/CODEX_HANDOFF.md +++ b/docs/CODEX_HANDOFF.md @@ -1612,7 +1612,7 @@ change. Live stable promotion and selector/device acceptance remain pending. User-supplied acceptance establishes operational downstream delivery and Mosaic-driven 1.0.3 -> 1.0.5 updating. Full evidence, hash, recovery boundaries and timing observations -are in [the delivery acceptance record](MOSAIC_DEVELOPMENT_RELEASE.md#historical-development-delivery-and-in-place-updater-acceptance---complete-live-validated). +are in [the delivery acceptance record](MOSAIC_DEVELOPMENT_RELEASE.md#historical-development-delivery-and-in-place-updater-acceptance---complete--live-validated). The initial normal run built source `41f9f83c36b8866211c9680d3b416d5ebede4888`, version 1.0.5/code 5, unsigned artifact `10099950969`; signing-secret availability failed and diff --git a/docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md b/docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md index 15d565311..bf62df0ad 100644 --- a/docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md +++ b/docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md @@ -1,5 +1,9 @@ # I06 native upstream-integration migration plan +> **Historical migration decision and acceptance record.** Current upstream operation is owned by +> [UPSTREAM_SYNC.md](UPSTREAM_SYNC.md). This file preserves the migration rationale and proof; it is +> not a current runbook. See the [history index](history/README.md). + ## Purpose and status This tracks the remaining migration from synthetic I06 integration state to truthful native Git diff --git a/docs/I07_PUBLISHED_RELEASE_REMEDIATION.md b/docs/I07_PUBLISHED_RELEASE_REMEDIATION.md index 42afa6673..13f989520 100644 --- a/docs/I07_PUBLISHED_RELEASE_REMEDIATION.md +++ b/docs/I07_PUBLISHED_RELEASE_REMEDIATION.md @@ -1,5 +1,9 @@ # I07 — Published Release Remediation +> **Historical decision rationale and acceptance record.** Current Hold and forward-fix operation +> is owned by [MOSAIC_STABLE.md](MOSAIC_STABLE.md). This record explains why that policy exists; it +> is not a second operating runbook. See the [history index](history/README.md). + ## Status **COMPLETE / LIVE VALIDATED.** diff --git a/docs/ITEM_6_CONSOLIDATION_CHECKLIST.md b/docs/ITEM_6_CONSOLIDATION_CHECKLIST.md index c56d9f504..0cff3ef8e 100644 --- a/docs/ITEM_6_CONSOLIDATION_CHECKLIST.md +++ b/docs/ITEM_6_CONSOLIDATION_CHECKLIST.md @@ -1,5 +1,9 @@ # Item 6 — Mosaic delivery and tooling consolidation +> **Historical program ledger.** This is point-in-time decision and acceptance evidence, not a +> current operating runbook. Use the [documentation index](README.md) for current authorities and +> the [history index](history/README.md) for historical context. + This document is the durable, multi-PR checklist for the 143 numbered requirements in the Item 6 specification. The source specification remains external planning input; this checklist records repository evidence, dependencies, readiness, and completion. Status terms used below: diff --git a/docs/ITEM_6_I05_PRESENTATION.md b/docs/ITEM_6_I05_PRESENTATION.md index abbb47501..7eb5a2b7a 100644 --- a/docs/ITEM_6_I05_PRESENTATION.md +++ b/docs/ITEM_6_I05_PRESENTATION.md @@ -5,6 +5,8 @@ > are migration evidence, not current operator capabilities. > T0-1 CP2 also removed the inherited `Development build` and `Create release` workflows. Their > inventory rows remain historical evidence; both paths are now downstream-owned absences. +> Current authorities are linked from the [documentation index](README.md); related evidence is +> grouped in the [history index](history/README.md). Baseline: `27f264ee` before I05 edits. Inventory captured before implementation. diff --git a/docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md b/docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md index b63f3d01c..c55945725 100644 --- a/docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md +++ b/docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md @@ -5,6 +5,8 @@ > T0-1 CP2 subsequently removed the guarded inherited `main.yml` and `release.yml` workflows as > explicit downstream-owned absences. Baseline T0 does not support their historical store/AAB > distribution capability. The pinned inventory below remains evidence, not current workflow state. +> Current upstream operation is owned by [UPSTREAM_SYNC.md](UPSTREAM_SYNC.md); related evidence is +> grouped in the [history index](history/README.md). Analysis checkpoint, 2026-09-10. Governing tracker: [Item 6 consolidation checklist](ITEM_6_CONSOLIDATION_CHECKLIST.md). This inventory began read-only. I05 presentation and I06 ownership-aware Sync were subsequently diff --git a/docs/README.md b/docs/README.md index b8de93bb2..62b56b6c3 100644 --- a/docs/README.md +++ b/docs/README.md @@ -86,27 +86,12 @@ Current lifecycle boundaries are: [PR preparation](PREPARE_PR.md) → ## Historical decisions and acceptance -The following files are point-in-time engineering evidence, not current operating runbooks. D4 may -add historical navigation or move records only after preserving their links and meaning. - -- **Historical acceptance/evidence** — [T0-1 operator UX inventory](T0_1_OPERATOR_UX_INVENTORY.md): - completed CP1–CP8 implementation and hosted acceptance ledger. -- **Historical decision and evidence** — [T0-1 performance audit](T0_1_CP7_PERFORMANCE_AUDIT.md): - measured performance corpus and accepted optimization decisions. -- **Historical acceptance/evidence** — [Item 6 consolidation checklist](ITEM_6_CONSOLIDATION_CHECKLIST.md): - delivery/tooling consolidation program ledger. -- **Historical design and acceptance** — [I05 presentation ledger](ITEM_6_I05_PRESENTATION.md): - delivery presentation and compatibility decisions. -- **Historical design/audit** — [Upstream automation audit](ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md): - pinned workflow inventory and ownership analysis. -- **Historical decision** — [Release pipeline simplification plan](RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md): - rationale for the surviving validation and release topology. -- **Historical decision and acceptance** — [I06 native upstream migration](I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md): - migration from the superseded synchronization lifecycle. -- **Historical decision** — [I07 published Release remediation](I07_PUBLISHED_RELEASE_REMEDIATION.md): - accepted containment and forward-recovery policy. -- **Current architecture with historical acceptance** — [R2 Mosaic identity record](T0_3_R2_MOSAIC_IDENTITY.md): - canonical identity plus R2–R4 evidence retained in its current location until later consolidation. +- **Historical evidence index** — [Historical engineering records](history/README.md): grouped Item 6, + T0-1, performance, upstream-migration, release-remediation, and Mosaic-identity evidence. These + records explain decisions and acceptance; they are not current operating runbooks. +- **Historical decision still referenced by current operation** — + [Published Release remediation](I07_PUBLISHED_RELEASE_REMEDIATION.md): rationale for the current + Stable Hold plus forward-fix policy owned by `MOSAIC_STABLE.md`. ## Component references diff --git a/docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md b/docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md index 03c694cca..0ff61edd3 100644 --- a/docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md +++ b/docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md @@ -1,5 +1,10 @@ # Release Pipeline Simplification Plan +> **Historical architecture decision record.** Current operation is owned by +> [VALIDATION.md](VALIDATION.md), [MOSAIC_DEVELOPMENT_RELEASE.md](MOSAIC_DEVELOPMENT_RELEASE.md), +> [MOSAIC_SIGNING.md](MOSAIC_SIGNING.md), and [MOSAIC_STABLE.md](MOSAIC_STABLE.md). This file +> preserves the decisions that produced those boundaries. See the [history index](history/README.md). + This document is the authoritative migration tracker for simplifying Mosaic's release pipeline. It records durable decisions and acceptance evidence without treating earlier architecture-review output as a fixed implementation checklist. ## Standing invariants diff --git a/docs/T0_1_CP7_PERFORMANCE_AUDIT.md b/docs/T0_1_CP7_PERFORMANCE_AUDIT.md index f921053fa..93c7bb6d9 100644 --- a/docs/T0_1_CP7_PERFORMANCE_AUDIT.md +++ b/docs/T0_1_CP7_PERFORMANCE_AUDIT.md @@ -1,5 +1,9 @@ # T0-1 CP7 performance, latency, and efficiency audit +> **Historical performance evidence.** Measurements and acceptance decisions are point-in-time, +> not current timing guarantees or operating instructions. Current validation authority is +> [VALIDATION.md](VALIDATION.md); related history is indexed in [history](history/README.md). + Status: **CP7 COMPLETE / HOSTED VALIDATED** Measured: **2026-09-15 through 2026-09-16** Closure: **CP8 COMPLETE; T0-1 COMPLETE**. Next roadmap phase: **T0-2**. diff --git a/docs/T0_1_OPERATOR_UX_INVENTORY.md b/docs/T0_1_OPERATOR_UX_INVENTORY.md index c1aac90aa..68654c08b 100644 --- a/docs/T0_1_OPERATOR_UX_INVENTORY.md +++ b/docs/T0_1_OPERATOR_UX_INVENTORY.md @@ -1,5 +1,10 @@ # Baseline T0-1 operator UX, workflow, and presentation inventory +> **Historical program ledger.** This completed T0-1 record preserves decisions and hosted +> acceptance evidence. Current PR and validation operation is owned by +> [PREPARE_PR.md](PREPARE_PR.md) and [VALIDATION.md](VALIDATION.md); use the +> [history index](history/README.md) for context. + Status: **T0-1 COMPLETE. CP4B.3 COMPLETE / HOSTED VALIDATED; P04 COMPLETE / HOSTED VALIDATED; Validation-plan visibility COMPLETE / HOSTED VALIDATED; prepare-pr terminal UX COMPLETE / HOSTED VALIDATED; Operator UX batch COMPLETE / HOSTED VALIDATED** diff --git a/docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md b/docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md index f8ab56928..7a22eb49f 100644 --- a/docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md +++ b/docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md @@ -1,6 +1,6 @@ # T0-3 documentation consolidation audit and plan -Status: **D1 and D2 COMPLETE; D3 implemented pending review. D4 has not begun.** +Status: **D1-D3 COMPLETE; D4 implemented pending review. D5 has not begun.** This audit describes the documentation set at `main` commit `44564901cbdb7ffce4b1c0704aa2d53f93c40fa9`. It does not move, delete, rename, or broadly rewrite @@ -316,6 +316,38 @@ manuals current-first through concise ownership, boundary, and recovery summarie cross-links. Existing acceptance and incident material remains in place and is explicitly secondary where it was prominent. No operating behavior changed. -D4 remains next and has not begun: no historical files or large evidence blocks have moved, no -history index exists, and existing anchors remain preserved. Later D5 work still owns roadmap, -handoff, architecture, identity-document, and agent-guide reduction or renaming. +D3 changed no operating behavior and retained existing anchors. + +## D4 implementation decisions + +D4 created `docs/history/README.md` as the single historical-evidence boundary and replaced the +temporary flat history list in `docs/README.md` with that grouped index. Historical records now +state near their top that they are point-in-time evidence, name the current canonical owner, and +link to the history index where useful. + +No existing record moved. Repository inventory found many normal Markdown consumers, including +heading-level links from the roadmap, handoff, validation and delivery manuals, plus likely external +GitHub links to these established paths and anchors. No workflow, script, test, or configuration +consumer required their paths, but relocating the files would create unnecessary anchor and inbound +link risk for no authority benefit. The flat files therefore remain deliberately stable and are +classified through navigation rather than duplicated behind pointer stubs. + +The in-place decision applies to `ITEM_6_CONSOLIDATION_CHECKLIST.md`, +`ITEM_6_I05_PRESENTATION.md`, `ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md`, +`T0_1_OPERATOR_UX_INVENTORY.md`, `T0_1_CP7_PERFORMANCE_AUDIT.md`, +`I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md`, `I07_PUBLISHED_RELEASE_REMEDIATION.md`, and +`RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md`. Each is now indexed and has an explicit historical +boundary near its top; the two Item 6 records that already had accurate historical banners received +only navigation links. + +No long acceptance block was extracted from a current manual. D3 already placed concise current +contracts first and labelled embedded acceptance sections historical. Those headings have inbound +links from the roadmap/handoff and may have external references, so D4 preserved them in place and +used the history index to make their role unambiguous. `T0_3_R2_MOSAIC_IDENTITY.md` likewise remains +the current identity owner until D5; its acceptance sections are explicitly historical without +renaming or splitting the file. + +D4 is complete pending review: evidence and historical names remain unchanged, established paths +and anchors are preserved, and current ownership remains with the D3 manuals. D5 has not begun; +roadmap/handoff reduction, `ARCHITECTURE.md`, roadmap or identity renaming, and agent-guide +consolidation remain later work. diff --git a/docs/T0_3_R2_MOSAIC_IDENTITY.md b/docs/T0_3_R2_MOSAIC_IDENTITY.md index ee7940f67..9eb25fc07 100644 --- a/docs/T0_3_R2_MOSAIC_IDENTITY.md +++ b/docs/T0_3_R2_MOSAIC_IDENTITY.md @@ -3,6 +3,11 @@ Status: **R2 canonical Mosaic identity — HOSTED VALIDATED. R3 — COMPLETE / HOSTED AND REAL-DEVICE VALIDATED. R4 — COMPLETE / HOSTED VALIDATED. T0-3.0 Mosaic identity establishment — COMPLETE.** +The **Current identity contract** below remains authoritative until D5 decides its permanent form. +Later R2/R3/R4 implementation, incident, and acceptance sections are historical evidence and do +not define alternate current identities. They remain in place to preserve established paths and +anchors; see the [history index](history/README.md). + ## Current identity contract New downstream state uses one canonical product identity: diff --git a/docs/history/README.md b/docs/history/README.md new file mode 100644 index 000000000..d875e7f79 --- /dev/null +++ b/docs/history/README.md @@ -0,0 +1,67 @@ +# Historical engineering records + +This index groups Mosaic's point-in-time engineering evidence. These records preserve the names, +repository identities, SHAs, run and PR numbers, workflow and artifact identities, failures, +measurements, rejected approaches, and decisions that were true when recorded. They are not current +operating runbooks. + +For current behavior, start with the [documentation index](../README.md). It links the canonical +owners for PR preparation, validation, Development publication, signing, Stable/Hold, upstream +integration, identity, roadmap, and continuity. When a historical statement differs from a current +manual, the current canonical owner governs operation and the historical statement remains evidence +of the earlier state. + +The records remain in their established locations. D4 found extensive heading-level links from the +roadmap, handoff, and current manuals, plus likely external references to these long-lived paths and +anchors. No machine consumer requires the paths, but moving them would add needless link and anchor +risk without changing their authority. This index provides the historical boundary without a deep +archive tree or duplicate copies. + +## Item 6 and earlier consolidation + +- [Item 6 delivery and tooling consolidation](../ITEM_6_CONSOLIDATION_CHECKLIST.md) — completed + multi-checkpoint program ledger and acceptance evidence. +- [I05 delivery presentation and compatibility](../ITEM_6_I05_PRESENTATION.md) — historical + presentation inventory, compatibility classification, and migration evidence. +- [Upstream automation audit](../ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md) — pinned workflow inventory + and ownership analysis preceding the current upstream model. +- [Release pipeline simplification plan](../RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md) — decisions and + evidence that produced the surviving validation, build, signing, and publication boundaries. + +## T0-1 validation and operator experience + +- [T0-1 operator UX inventory](../T0_1_OPERATOR_UX_INVENTORY.md) — completed CP1–CP8 implementation + and hosted-acceptance ledger. +- [CP7 performance audit](../T0_1_CP7_PERFORMANCE_AUDIT.md) — dated performance measurements, + accepted optimization, and KEEP decisions. + +Current validation authority belongs to [Validation architecture](../VALIDATION.md), and current PR +operation belongs to [Safe pull-request preparation](../PREPARE_PR.md). + +## Upstream migration + +- [I06 native upstream migration](../I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md) — completed design, + migration, and native-ancestry acceptance evidence. + +Current ownership, Observe/Publish, waiting, resolver, credential, and failure behavior belongs to +[Upstream synchronization](../UPSTREAM_SYNC.md). + +## Release remediation and delivery decisions + +- [I07 published Release remediation](../I07_PUBLISHED_RELEASE_REMEDIATION.md) — decision rationale + and acceptance evidence for Hold plus higher-version forward recovery. +- [Release pipeline simplification plan](../RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md) — retained + architectural rationale for the current pipeline topology. + +Current operation belongs to [Development publication](../MOSAIC_DEVELOPMENT_RELEASE.md), +[Release signing](../MOSAIC_SIGNING.md), and [Stable/Hold](../MOSAIC_STABLE.md). + +## Mosaic identity migration and T0-3 evidence + +- [R2–R4 Mosaic identity record](../T0_3_R2_MOSAIC_IDENTITY.md) — the current identity contract plus + retained repository rename, canonicalization, presentation, and old-name retirement acceptance. +- [Documentation consolidation plan](../T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md) — D1 inventory, + reviewed ownership model, and D1–D7 implementation decisions. + +The identity record remains in place because it still owns current identity until D5 decides its +permanent form. Its historical sections are evidence, not alternate current identities.