Files
claw/docs/superpowers/specs/2026-04-19-structured-fail-closed-residual-13-closure-design.md

87 lines
4.1 KiB
Markdown

# Structured Fail-Closed Residual 13 Closure Design
> Date: 2026-04-19
> Status: Draft
> Parent Framework: `docs/superpowers/plans/2026-04-19-scene-skill-102-full-coverage-framework-plan.md`
> Parent Layer: `Layer C` and `Layer D`
> Upstream Asset: `tests/fixtures/generated_scene/full_coverage_reconciliation_candidates_2026-04-19.json`
## Intent
Close or explicitly defer the remaining `13` `framework-structured-fail-closed` scenes after the 102 full-coverage follow-up sweep.
This design does not update the official execution board. It defines how the remaining residual bucket must be split before any implementation work starts.
## Current Residual Bucket
The current residual bucket contains `13` scenes:
| Archetype | Count | Direction |
| --- | ---: | --- |
| `paginated_enrichment` | 4 | mainline residual closure |
| `multi_mode_request` | 2 | mainline residual closure |
| `local_doc_pipeline` | 5 | boundary hold or future G8 runtime roadmap |
| `host_bridge_workflow` | 1 | boundary hold or future G6 runtime roadmap |
| `page_state_eval` | 1 | bootstrap target isolation |
## Fixed Residual Scenes
| Scene ID | Scene | Archetype | Reason |
| --- | --- | --- | --- |
| `sweep-007-scene` | `95598供电服务月报` | `paginated_enrichment` | workflow evidence incomplete |
| `sweep-018-scene` | `白银线损周报` | `multi_mode_request` | readiness not A/B |
| `sweep-033-scene` | `供电可靠率指标统计表` | `local_doc_pipeline` | workflow evidence incomplete |
| `sweep-034-scene` | `供电可靠性数据质量自查报告月报` | `local_doc_pipeline` | workflow evidence incomplete |
| `sweep-039-scene` | `故障报修工单信息统计表` | `paginated_enrichment` | workflow evidence incomplete |
| `sweep-042-scene` | `国网金昌供电公司营商环境周例会报告` | `local_doc_pipeline` | workflow evidence incomplete |
| `sweep-051-scene` | `嘉峪关可靠性分析报告` | `local_doc_pipeline` | workflow evidence incomplete |
| `sweep-068-scene` | `输变电设备运行分析报告` | `paginated_enrichment` | workflow evidence incomplete |
| `sweep-071-scene` | `台区线损大数据-月_周累计线损率统计分析` | `multi_mode_request` | readiness not A/B |
| `sweep-074-scene` | `同兴智能安全督查日报` | `local_doc_pipeline` | workflow evidence incomplete |
| `sweep-084-scene` | `巡视计划完成情况自动检索` | `paginated_enrichment` | workflow evidence incomplete |
| `sweep-085-scene` | `业扩报装管理制度` | `host_bridge_workflow` | workflow evidence incomplete |
| `sweep-091-scene` | `用户停电频次分析监测` | `page_state_eval` | readiness not A/B |
## Route Mapping
This residual bucket must be split into bounded child work:
1. `Residual Route A`: `G3 / paginated_enrichment` residual closure for 4 scenes.
2. `Residual Route B`: `G2 / multi_mode_request` residual closure for 2 scenes.
3. `Residual Route C`: boundary hold decision for local-doc and host-bridge residuals.
4. `Residual Route D`: bootstrap target isolation for the page-state residual.
5. `Residual Route E`: follow-up mini sweep and reconciliation candidate refresh.
## Guardrails
1. Do not update `tests/fixtures/generated_scene/scene_execution_board_2026-04-18.json`.
2. Do not add new families.
3. Do not start `G4/G5`.
4. Do not relax readiness gates.
5. Do not merge boundary runtime work with mainline contract closure.
6. Do not classify local-doc residuals as mainline pass without a separate G8 runtime roadmap.
7. Do not classify host-bridge residuals as mainline pass without a separate G6 runtime roadmap.
## Implementation Boundaries
Allowed implementation routes:
1. `G3` residual workflow evidence recovery.
2. `G2` residual request/response/mode readiness correction.
Decision-only routes:
1. `local_doc_pipeline` residuals.
2. `host_bridge_workflow` residual.
3. `page_state_eval/bootstrap_target` residual.
## Completion Criteria
This residual design is complete when:
1. all 13 scenes are assigned to one residual route;
2. the mainline residual routes have bounded implementation plans;
3. boundary and bootstrap residuals have explicit hold/isolate decisions;
4. a follow-up mini sweep plan exists to measure the residual closure delta.