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

G3 Real Sample Runtime Contract Correction Design

Date: 2026-04-19 Upstream Closure: 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