Add raw output-shape template control pack (sprint 262)

tools/mcp/run_sprint_taskitem_pipeline.sh

@@ -62,6 +62,8 @@ NATIVE_RAW_TOP_GAP_REQUIREMENTS="${WSTONE_NATIVE_RAW_TOP_GAP_REQUIREMENTS:-0}"
 NATIVE_RAW_TOP_GAP_MAX_SIGNALS="${WSTONE_NATIVE_RAW_TOP_GAP_MAX_SIGNALS:-5}"
 NATIVE_RAW_INTRINSIC_PROMPT_PACK="${WSTONE_NATIVE_RAW_INTRINSIC_PROMPT_PACK:-0}"
 NATIVE_RAW_INTRINSIC_PROMPT_MAX_SIGNALS="${WSTONE_NATIVE_RAW_INTRINSIC_PROMPT_MAX_SIGNALS:-8}"
+NATIVE_RAW_TEMPLATE_CONTROL_PACK="${WSTONE_NATIVE_RAW_TEMPLATE_CONTROL_PACK:-0}"
+NATIVE_RAW_TEMPLATE_CONTROL_MAX_SIGNALS="${WSTONE_NATIVE_RAW_TEMPLATE_CONTROL_MAX_SIGNALS:-8}"
 NATIVE_RAW_TOP_GAP_ADAPTIVE_RETRY="${WSTONE_NATIVE_RAW_TOP_GAP_ADAPTIVE_RETRY:-0}"
 NATIVE_RAW_TOP_GAP_RETRY_SIGNALS="${WSTONE_NATIVE_RAW_TOP_GAP_RETRY_SIGNALS:-10}"
 EXTRA_NORMALIZED_REQUIREMENTS_FILE="${WSTONE_EXTRA_NORMALIZED_REQUIREMENTS_FILE:-}"
@@ -130,6 +132,7 @@ NATIVE_RAW_HARDENING_JSON='{}'
 NATIVE_RAW_SIGNAL_TARGETED_VARIANTS_JSON='{}'
 NATIVE_RAW_TOP_GAP_REQUIREMENTS_JSON='{}'
 NATIVE_RAW_INTRINSIC_PROMPT_PACK_JSON='{}'
+NATIVE_RAW_TEMPLATE_CONTROL_PACK_JSON='{}'
 NATIVE_RAW_ADAPTIVE_RETRY_JSON='{}'
 INTRINSIC_REQS_JSON='[]'
 EXTRA_NORMALIZED_REQUIREMENTS_JSON='[]'
@@ -378,6 +381,22 @@ if [[ "$NATIVE_RAW_INTRINSIC_PROMPT_PACK" == "1" && -n "$NATIVE_RAW_TOP_GAP_BACK
 else
   NATIVE_RAW_INTRINSIC_PROMPT_PACK_JSON='{"enabled":false}'
 fi
+if [[ "$NATIVE_RAW_TEMPLATE_CONTROL_PACK" == "1" && -n "$NATIVE_RAW_TOP_GAP_BACKLOG_FILE" && -f "$NATIVE_RAW_TOP_GAP_BACKLOG_FILE" ]]; then
+  python3 "$ROOT_DIR/tools/mcp/synthesize_raw_template_control_pack.py" \
+    --top-gaps "$NATIVE_RAW_TOP_GAP_BACKLOG_FILE" \
+    --max-signals "$NATIVE_RAW_TEMPLATE_CONTROL_MAX_SIGNALS" \
+    --out "$OUT_DIR/01g_raw_template_control_pack_requirements.json" \
+    --out-report "$OUT_DIR/01g_raw_template_control_pack_report.json" >/dev/null
+  RAW_TEMPLATE_CONTROL_REQS_JSON="$(cat "$OUT_DIR/01g_raw_template_control_pack_requirements.json")"
+  NORMALIZED_REQS="$(jq -nc --argjson base "$NORMALIZED_REQS" --argjson extra "$RAW_TEMPLATE_CONTROL_REQS_JSON" '$base + $extra')"
+  NATIVE_RAW_TEMPLATE_CONTROL_PACK_JSON="$(jq -nc \
+    --argjson enabled true \
+    --arg backlog_file "$NATIVE_RAW_TOP_GAP_BACKLOG_FILE" \
+    --argjson report "$(cat "$OUT_DIR/01g_raw_template_control_pack_report.json")" \
+    '{enabled:$enabled, backlog_file:$backlog_file, report:$report}')"
+else
+  NATIVE_RAW_TEMPLATE_CONTROL_PACK_JSON='{"enabled":false}'
+fi
 CONFLICTS="$(printf '%s' "$INTAKE_JSON" | jq '.conflicts // []')"
 GEN_ARGS="$(jq -nc --argjson nr "$NORMALIZED_REQS" --argjson cf "$CONFLICTS" --arg strict "$STRICT_EXECUTION_CONTRACT" \
   '{normalizedRequirements:$nr,conflicts:$cf,strictExecutionContract:($strict == "1")}')"
@@ -976,6 +995,7 @@ SUMMARY_JSON="$(jq -nc \
   --argjson native_intrinsic_boost "$NATIVE_INTRINSIC_BOOST_JSON" \
   --argjson native_raw_top_gap_requirements "$NATIVE_RAW_TOP_GAP_REQUIREMENTS_JSON" \
   --argjson native_raw_intrinsic_prompt_pack "$NATIVE_RAW_INTRINSIC_PROMPT_PACK_JSON" \
+  --argjson native_raw_template_control_pack "$NATIVE_RAW_TEMPLATE_CONTROL_PACK_JSON" \
   --argjson native_raw_signal_targeted_variants "$NATIVE_RAW_SIGNAL_TARGETED_VARIANTS_JSON" \
   --argjson native_raw_candidate_search "$NATIVE_RAW_CANDIDATE_SEARCH_JSON" \
   --argjson native_raw_adaptive_retry "$NATIVE_RAW_ADAPTIVE_RETRY_JSON" \
@@ -1009,6 +1029,7 @@ SUMMARY_JSON="$(jq -nc \
     native_intrinsic_boost: $native_intrinsic_boost,
     native_raw_top_gap_requirements: $native_raw_top_gap_requirements,
     native_raw_intrinsic_prompt_pack: $native_raw_intrinsic_prompt_pack,
+    native_raw_template_control_pack: $native_raw_template_control_pack,
     native_raw_signal_targeted_variants: $native_raw_signal_targeted_variants,
     native_raw_candidate_search: $native_raw_candidate_search,
     native_raw_adaptive_retry: $native_raw_adaptive_retry,

tools/mcp/synthesize_raw_template_control_pack.py

@@ -0,0 +1,93 @@
+#!/usr/bin/env python3
+import argparse
+import json
+from pathlib import Path
+from typing import List
+
+
+def load_json(path: Path):
+    with path.open("r", encoding="utf-8") as f:
+        return json.load(f)
+
+
+def write_json(path: Path, obj) -> None:
+    with path.open("w", encoding="utf-8") as f:
+        json.dump(obj, f, indent=2, sort_keys=True)
+        f.write("\n")
+
+
+def main() -> int:
+    p = argparse.ArgumentParser(description="Synthesize raw task template control requirements from top-gap signals.")
+    p.add_argument("--top-gaps", required=True)
+    p.add_argument("--max-signals", type=int, default=8)
+    p.add_argument("--out", required=True)
+    p.add_argument("--out-report", required=True)
+    args = p.parse_args()
+
+    backlog = load_json(Path(args.top_gaps))
+    prioritized = list(backlog.get("prioritized_missing") or [])[: max(0, args.max_signals)]
+
+    signals: List[str] = [str(r.get("missing", "")) for r in prioritized if str(r.get("missing", ""))]
+    template_example = {
+        "taskId": "task-example-1",
+        "title": "Concrete scoped operation",
+        "prerequisiteOps": ["whetstone_generate_taskitems", "whetstone_queue_ready", "whetstone_validate_taskitem"],
+        "reasons": ["risk", "contract", "replay"],
+        "dependencyTaskIds": [],
+        "executionContract": {
+            "deterministic": True,
+            "rollbackRequired": True,
+            "replayValidationRequired": True,
+        },
+    }
+    schema_text = (
+        "output-shape control: every task must include non-empty taskId/title/prerequisiteOps/reasons/executionContract; "
+        "executionContract must explicitly set deterministic, rollbackRequired, replayValidationRequired to true; "
+        "task must include at least one concrete prerequisite op and no umbrella placeholder wording."
+    )
+    example_text = f"required template example: {json.dumps(template_example, sort_keys=True)}"
+    signal_text = (
+        "missing-signal alignment: " + (", ".join(signals) if signals else "no signals") +
+        "; generated tasks must explicitly close these classes where applicable."
+    )
+
+    reqs = [
+        {
+            "requirementId": "raw-template-control-schema",
+            "kind": "constraint",
+            "normalizedText": schema_text,
+            "anchor": "raw_template_control",
+            "sourceLine": 0,
+            "ambiguous": False,
+        },
+        {
+            "requirementId": "raw-template-control-example",
+            "kind": "constraint",
+            "normalizedText": example_text,
+            "anchor": "raw_template_control",
+            "sourceLine": 0,
+            "ambiguous": False,
+        },
+        {
+            "requirementId": "raw-template-control-signals",
+            "kind": "constraint",
+            "normalizedText": signal_text,
+            "anchor": "raw_template_control",
+            "sourceLine": 0,
+            "ambiguous": False,
+        },
+    ]
+    report = {
+        "status": "ok",
+        "selected_signal_count": len(signals),
+        "signals": signals,
+        "requirement_count": len(reqs),
+    }
+    write_json(Path(args.out), reqs)
+    write_json(Path(args.out_report), report)
+    print(json.dumps({"status": "ok", "selected_signal_count": len(signals), "requirement_count": len(reqs), "out": args.out}, sort_keys=True))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())