Files
claw/docs/superpowers/specs/2026-04-19-local-doc-official-board-reconciliation-refresh-design.md

71 lines
2.3 KiB
Markdown

# Local-Doc Official Board Reconciliation Refresh Design
> Date: 2026-04-19
> Parent Framework: `2026-04-19-scene-skill-102-full-coverage-framework-plan.md`
> Parent Roadmap: `2026-04-19-local-doc-runtime-roadmap-plan.md`
> Layer: `Layer E / official board reconciliation`
## Intent
Consume the five local-doc reconciliation candidates produced by the local-doc runtime roadmap and refresh only their framework status in the official execution board.
This design exists because the local-doc roadmap intentionally stopped before official board update. The board update needs a bounded reconciliation refresh that applies the promotion policy without modifying generation logic.
## Fixed Inputs
1. `tests/fixtures/generated_scene/local_doc_runtime_reconciliation_candidates_2026-04-19.json`
2. `tests/fixtures/generated_scene/promotion_board_reconciliation_policy_2026-04-19.json`
3. `tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json`
## Scope
Only these five scene ids are in scope:
1. `sweep-033-scene`
2. `sweep-034-scene`
3. `sweep-042-scene`
4. `sweep-051-scene`
5. `sweep-074-scene`
## Refresh Rule
If a fixed-scope scene is present in the local-doc candidate asset as `framework-auto-pass-candidate`, update only framework-layer board fields:
- `currentFrameworkStatus`
- `currentFrameworkCandidateStatus`
- `currentFrameworkArchetype`
- `currentFrameworkReadiness`
- `currentFrameworkSource`
- `currentFrameworkDecisionOverlay`
- `currentFrameworkNextAction`
- `currentFrameworkCanAutoUpdateBoard`
Workbook snapshot fields, `currentGroup`, `currentStatus`, real-sample fields, and scene names are preserved.
## Forbidden Scope
1. Do not modify `src/generated_scene/analyzer.rs`.
2. Do not modify `src/generated_scene/generator.rs`.
3. Do not rerun the 102 sweep.
4. Do not update host-bridge residuals.
5. Do not update bootstrap residuals.
6. Do not rename official-board scenes.
7. Do not promote non-framework business status.
## Expected Result
The official board framework summary moves from:
- `framework-auto-pass = 95`
- `framework-structured-fail-closed = 7`
to:
- `framework-auto-pass = 100`
- `framework-structured-fail-closed = 2`
The remaining two structured fail-closed records should be:
- one host-bridge runtime residual;
- one bootstrap target normalization residual.