Files
claw/docs/superpowers/specs/2026-04-19-g3-real-sample-runtime-contract-correction-design.md

54 lines
2.2 KiB
Markdown

# G3 Real Sample Runtime Contract Correction Design
> Date: 2026-04-19
> Upstream Closure: [2026-04-19-g3-real-sample-archetype-correction-closure-report.md](D:/data/ideaSpace/rust/sgClaw/claw-new/docs/superpowers/reports/2026-04-19-g3-real-sample-archetype-correction-closure-report.md)
## 1. Intent
The previous bounded plan corrected the real-sample routing boundary for `95598工单明细表`.
The sample now stays in `G3 / paginated_enrichment`, but it still leaves a mainline gap:
`g3_runtime_scope_compatible = false`
This design defines the next bounded scope:
`G3 real-sample runtime / contract correction`
## 2. Observed Remaining Gap
The corrected real-sample rerun shows:
1. archetype is now `paginated_enrichment`
2. main request, pagination, enrichment, join keys, and export path are all present
3. the remaining blocker is the current runtime-scope rule, which treats the volume of localhost evidence as incompatible
The current gate is too coarse for this real sample because the localhost evidence is subordinate to the restored business chain, not the controlling workflow backbone.
## 3. Scope Guardrails
1. do not reopen `G3` family expansion
2. do not broaden this work into `G8` runtime implementation
3. do not change `G6 / G7 / G8` behavior except where a shared generic gate must remain consistent
4. do not weaken fail-closed behavior for scenes that still do not satisfy the `G3` minimum contract
5. do not treat asset-only updates as progress unless they follow a real rerun result
## 4. Correction Target
The bounded target is:
1. keep the real sample in `paginated_enrichment`
2. narrow `g3_runtime_scope_compatible` so it distinguishes:
- subordinate host-runtime dependencies inside a valid `G3` business chain
- dominant host-runtime dependencies that still justify fail-closed
3. preserve explicit visibility of remaining output or data-verification gaps
## 5. Expected Outcome
After correction:
1. the real sample should still resolve as `paginated_enrichment`
2. `g3_runtime_scope_compatible` should pass when localhost evidence is present but subordinate
3. any remaining mismatch should move from `runtime_scope_gap` to a narrower contract or output-verification gap
4. `G8` representative behavior must not regress