Skip to content
Merged
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
4 changes: 4 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/CODEX_HANDOFF.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 4 additions & 0 deletions docs/I06_NATIVE_UPSTREAM_MIGRATION_PLAN.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 4 additions & 0 deletions docs/I07_PUBLISHED_RELEASE_REMEDIATION.md
Original file line number Diff line number Diff line change
@@ -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.**
Expand Down
4 changes: 4 additions & 0 deletions docs/ITEM_6_CONSOLIDATION_CHECKLIST.md
Original file line number Diff line number Diff line change
@@ -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:
Expand Down
2 changes: 2 additions & 0 deletions docs/ITEM_6_I05_PRESENTATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
2 changes: 2 additions & 0 deletions docs/ITEM_6_UPSTREAM_AUTOMATION_AUDIT.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
27 changes: 6 additions & 21 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
5 changes: 5 additions & 0 deletions docs/RELEASE_PIPELINE_SIMPLIFICATION_PLAN.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
4 changes: 4 additions & 0 deletions docs/T0_1_CP7_PERFORMANCE_AUDIT.md
Original file line number Diff line number Diff line change
@@ -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**.
Expand Down
5 changes: 5 additions & 0 deletions docs/T0_1_OPERATOR_UX_INVENTORY.md
Original file line number Diff line number Diff line change
@@ -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**
Expand Down
40 changes: 36 additions & 4 deletions docs/T0_3_DOCUMENTATION_CONSOLIDATION_PLAN.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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.
5 changes: 5 additions & 0 deletions docs/T0_3_R2_MOSAIC_IDENTITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
67 changes: 67 additions & 0 deletions docs/history/README.md
Original file line number Diff line number Diff line change
@@ -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.
Loading