diff --git a/docs/milestones/M11/M11_plan.md b/docs/milestones/M11/M11_plan.md new file mode 100644 index 000000000..358115af7 --- /dev/null +++ b/docs/milestones/M11/M11_plan.md @@ -0,0 +1,63 @@ +# M11 — Runner Lifecycle Surface + +Phase: **Phase III — Runner & Service Boundary** +Status: Planned + +--- + +# 1. Intent / Target + +Introduce lifecycle structure on ProcessingRunner: + +``` +runner.prepare() +runner.execute() +runner.finalize() +``` + +This enables: +* cancellation +* instrumentation +* progress reporting +* distributed execution (later milestones) + +Behavior-preserving. No runtime changes yet. + +--- + +# 2. Scope Boundaries + +### In scope + +* Add prepare / execute / finalize structure to ProcessingRunner +* Route existing run() logic through execute() +* Maintain identical behavior +* Add minimal contract tests + +### Out of scope + +* No cancellation implementation yet +* No async +* No instrumentation hooks (M12) +* No txt2img path through runner (M13) + +--- + +# 3. Invariants + +| Surface | Invariant | Verification | +|---------|-----------|--------------| +| CLI behavior | Identical | smoke tests | +| API responses | Unchanged | tests | +| Processing results | Byte-identical | quality tests | +| CI coverage | ≥ 40% | CI gate | + +--- + +# 4. Deliverables + +Code: `modules/runtime/runner.py` (lifecycle methods) +Tests: `test/quality/test_processing_runner.py` (lifecycle contract) +Docs: M11_plan.md, M11_toolcalls.md, M11_run1.md, M11_summary.md, M11_audit.md +Ledger: Update `docs/serena.md` +Tag: `v0.0.11-m11` diff --git a/docs/milestones/M11/M11_toolcalls.md b/docs/milestones/M11/M11_toolcalls.md new file mode 100644 index 000000000..12f0ffcb9 --- /dev/null +++ b/docs/milestones/M11/M11_toolcalls.md @@ -0,0 +1,6 @@ +# M11 Toolcalls — Runner Lifecycle Surface + +Implementation toolcalls for Cursor execution. + +| Timestamp | Tool | Purpose | Files/Target | Status | +|-----------|------|---------|--------------|--------|