From ced9e6638270c98065c1af8383d8434a37b1ad25 Mon Sep 17 00:00:00 2001 From: Eric Rakestraw Date: Mon, 28 Sep 2026 14:55:53 +0000 Subject: [PATCH] Record Narratio upgrade validation --- docs/roadmap/application-upgrade-sequence.md | 6 +++--- .../features/0021-narratio-v3-adoption.md | 16 +++++++++++++++- docs/roadmap/implementation.md | 10 +++++++++- docs/status.md | 12 +++++------- 4 files changed, 32 insertions(+), 12 deletions(-) diff --git a/docs/roadmap/application-upgrade-sequence.md b/docs/roadmap/application-upgrade-sequence.md index 36c3905..da3a6bb 100644 --- a/docs/roadmap/application-upgrade-sequence.md +++ b/docs/roadmap/application-upgrade-sequence.md @@ -32,14 +32,14 @@ Seriatim is unchanged by this sequence. Release-summary and migration-guidance triage is complete. Standalone Scriptorium, Audita, and Notarius adoption are complete after independent review; -Narratio is next. Add the numbered feature -link beside each item when its roadmap is created; check it off after +Narratio standalone implementation awaits independent review. Add the numbered +feature link beside each item when its roadmap is created; check it off after independent review and closeout. - [x] [Feature 0018: Scriptorium adoption](features/0018-scriptorium-v0-15-adoption.md) — complete through role `b174c8c`; independent review found no remediation issues. - [x] [Feature 0019: Audita adoption](features/0019-audita-v2-adoption.md) — complete through role `c3dd59f`; independent review found no remediation issues. - [x] [Feature 0020: Notarius adoption](features/0020-notarius-v0-8-adoption.md) — complete through role `6aef48b`; independent review found no remediation issues; suite unchanged. -- [ ] [Feature 0021: Narratio adoption](features/0021-narratio-v3-adoption.md) — roadmap and staged plan approved; ready for implementation. +- [ ] [Feature 0021: Narratio adoption](features/0021-narratio-v3-adoption.md) — standalone role implemented through `3c0700b`; independent review pending, suite unchanged. - [ ] Suite integration — feature roadmap not yet created. ## Adoption Boundaries diff --git a/docs/roadmap/features/0021-narratio-v3-adoption.md b/docs/roadmap/features/0021-narratio-v3-adoption.md index 49bc7bd..6a3f71a 100644 --- a/docs/roadmap/features/0021-narratio-v3-adoption.md +++ b/docs/roadmap/features/0021-narratio-v3-adoption.md @@ -1,6 +1,6 @@ # Feature 0021: Adopt Narratio v3.0.0 in the Standalone Role -Status: ready +Status: in_progress — implementation complete; independent review pending ## Summary @@ -205,6 +205,20 @@ review retry/timeout budgets rather than copying retired tuning mechanically. None identified for this standalone scope. +## Implementation Evidence + +- Standalone role commits: `a28f22c` (v3 interface and migrated fixtures), + `45f6836` (selector and credential-list coverage), and `3c0700b` (upgrade + guidance). Production tasks, suite dependencies, collection, and consumer + remain unchanged. +- `bash -n` and the local integration harness passed. The harness includes + syntax check and production-profile lint and exercised native offline + baseline, named, and explicit-empty validation, selected v2.1.0 behavior, + supplied-Go recovery, synthetic credential loading, and clean immediate + repeats. Role and workspace whitespace checks passed. +- The implemented role awaits independent review. Coordinated suite migration + remains separate follow-up work. + ## Upstream References - [Narratio v3.0.0 release](https://gitea.maximumdirect.net/eric/narratio/src/tag/v3.0.0/docs/releases/v3.0.0.md) diff --git a/docs/roadmap/implementation.md b/docs/roadmap/implementation.md index 0d25918..098c2a9 100644 --- a/docs/roadmap/implementation.md +++ b/docs/roadmap/implementation.md @@ -1,6 +1,6 @@ # Implementation Plan 0021: Adopt Narratio v3.0.0 -Status: in_progress +Status: implemented — independent review pending Target executor: GPT-5.6-Terra @@ -192,6 +192,8 @@ Commit as `Test Narratio selectors and credential lists`. ## Stage 3: Document Upgrade Ownership and Hand Off for Review +Completion: complete (2026-09-28). + ### Required Policy Review Read workspace `AGENTS.md`, `docs/orientation.md`, `docs/conventions.md`, @@ -271,6 +273,12 @@ Plan approved. explicit empty lists/selectors without synthetic values, and clean immediate repeats passed. The older selected-version and supplied-Go cases remained valid. Role `git diff --check` passed. +- Stage 3: role commits `a28f22c`, `45f6836`, and `3c0700b` provide the + implementation and upgrade guidance. The README was checked against tagged + v3.0.0 release, configuration, integration, and operations contracts. + Documentation-only changes reuse Stage 2 behavior evidence; role/workspace + `git diff --check` and `scripts/status` passed. F0021 remains open for + independent review. ## Open Questions diff --git a/docs/status.md b/docs/status.md index 7f13cfc..a736a21 100644 --- a/docs/status.md +++ b/docs/status.md @@ -4,12 +4,10 @@ Last updated: 2026-09-28 Current milestone: Operational D&D pipeline deployment -Current focus: Implement Feature 0021's standalone Narratio v3.0.0 adoption. -The feature roadmap and staged implementation plan are approved; work is in -progress. -The suite remains unchanged. -Features 0018 through 0020 are complete after independent review with no remediation -findings. Follow the agreed +Current focus: Independently review Feature 0021's completed standalone +Narratio v3.0.0 implementation. The suite remains unchanged. +Features 0018 through 0020 are complete after independent review with no +remediation findings. Follow the agreed [application upgrade sequence](roadmap/application-upgrade-sequence.md): Scriptorium → Audita → Notarius → Narratio → suite integration. Retain the existing suite and consumer pins until coordinated integration. Feature 0017 @@ -46,7 +44,7 @@ is complete. | F0018 | Adopt Scriptorium v0.15.0 | Scriptorium role and workspace | done | Role commits `61dcafe`, `2fce529`, and `b174c8c` passed independent review with no findings; feature roadmap records validation; suite pins unchanged | | F0019 | Adopt Audita v2.0.1 | Audita role and workspace | done | Role `c3dd59f`, following `6137ff2` and `52f67fe`, passed independent review with no findings; [roadmap](roadmap/features/0019-audita-v2-adoption.md) records validation; suite pins unchanged | | F0020 | Adopt Notarius v0.8.1 | Notarius role and workspace | done | Role `6aef48b`, following `b1b922c` and `380b6a3`, passed independent review with no findings; [feature roadmap](roadmap/features/0020-notarius-v0-8-adoption.md) records evidence; suite pins unchanged | -| F0021 | Adopt Narratio v3.0.0 | Narratio role and workspace | in_progress | [Feature roadmap](roadmap/features/0021-narratio-v3-adoption.md) and [staged plan](roadmap/implementation.md) approved; standalone role implementation underway, suite integration deferred | +| F0021 | Adopt Narratio v3.0.0 | Narratio role and workspace | in_progress | Role `a28f22c`, `45f6836`, and `3c0700b` implemented and validated; [feature roadmap](roadmap/features/0021-narratio-v3-adoption.md) records evidence; independent review pending, suite integration deferred | | A0001 | Audit completed standalone-role test suites | workspace and standalone roles | done | Findings recorded in `docs/roadmap/test-suite-audit-findings.md` | | R0001 | Simplify completed standalone-role test suites | workspace and standalone roles | done | Role commits `e08c63c`, `d2d0b9d`, and `cfecf37` passed implementation and independent review |