AirPlan V2 initial release — unified scheduler with 12 sub-modes

Merges 8 V1 plugins into 1 unified plugin, adds 4 new components (dep, tst, sec, rvr).
12 sub-modes: arc, eng, do, dbg, xdb, sdb, ndb, ctx, dep, tst, sec, rvr.
L1 code-level guarantees: atomic writes, file locks, evidence gating, forced debug routing,
3-phase arc gate, evidence-first debug gate, Chinese language lock, scheduler boundary.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

lib/air_runtime/modes/do_mode.py

@@ -0,0 +1,165 @@
+"""
+AirDo mode — V2 任务执行器。
+V2 改进：强制 AirDbg 路由（L1 代码级），task_id 注入防护。
+"""
+
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+from air_runtime.io import atomic_json_write, safe_json_load
+from air_runtime.paths import airplan_root, event_log_path
+from air_runtime.events import EventLog, TASK_COMPLETED, TASK_BLOCKED
+from air_runtime.contracts import WorkerResult, now_iso
+from air_runtime.utils import sanitize_task_id, session_stamp
+
+
+def _paths(project_root: Path, task_id: str) -> dict[str, Path]:
+    root = airplan_root(project_root) / "state" / "airdo"
+    task_dir = root / "tasks" / task_id
+    return {
+        "root": root,
+        "state": root / "state.json",
+        "task_dir": task_dir,
+        "brief": task_dir / "brief.md",
+        "handoff": task_dir / "subagent-handoff.md",
+        "result": task_dir / "result.json",
+        "worker_state": task_dir / "worker-state.json",
+    }
+
+
+def _ensure_dirs(paths: dict[str, Path]) -> None:
+    paths["task_dir"].mkdir(parents=True, exist_ok=True)
+
+
+def enter_worker(project_root: Path, task_id: str) -> dict:
+    tid = sanitize_task_id(task_id)
+    paths = _paths(project_root, tid)
+    _ensure_dirs(paths)
+
+    worker_state = {
+        "taskId": tid, "status": "implementing",
+        "enteredAt": now_iso(), "resultPath": str(paths["result"]),
+    }
+    atomic_json_write(paths["worker_state"], worker_state)
+    atomic_json_write(paths["state"], {"enabled": True, "activeTaskId": tid,
+                                        "updatedAt": now_iso()})
+
+    log = EventLog(event_log_path(project_root))
+    log.emit("task.entered", {"taskId": tid})
+
+    return {
+        "taskId": tid, "briefPath": str(paths["brief"]),
+        "handoffPath": str(paths["handoff"]),
+        "resultPath": str(paths["result"]),
+        "workerStatePath": str(paths["worker_state"]),
+    }
+
+
+def finish_worker(project_root: Path, task_id: str, result_path: Path | None = None) -> dict:
+    """V2 核心改进：强制 AirDbg 路由。"""
+    tid = sanitize_task_id(task_id)
+    paths = _paths(project_root, tid)
+
+    # 加载 result
+    if result_path and result_path.exists():
+        result_data = safe_json_load(result_path)
+    elif paths["result"].exists():
+        result_data = safe_json_load(paths["result"])
+    else:
+        result_data = {"taskId": tid, "status": "blocked", "summary": "no result found"}
+
+    if not isinstance(result_data, dict):
+        result_data = {"taskId": tid, "status": "blocked"}
+
+    result = WorkerResult.from_dict(result_data)
+    status = result.status
+
+    # V2 L1 代码级：done 但无证据 → 强制 AirDbg
+    if status == "done":
+        if not result.validations and not result.files_changed:
+            routing_decision = {
+                "target": "airdbg",
+                "reason": "done without evidence — mandatory debug review",
+                "forced": True,
+            }
+        else:
+            routing_decision = {"target": "merge", "forced": False}
+
+    # V2 L1 代码级：blocked/failed → 强制 AirDbg
+    elif status in ("blocked", "failed"):
+        routing_decision = {
+            "target": "airdbg",
+            "reason": f"status={status} — AirDbg mandatory before return",
+            "forced": True,
+        }
+    else:
+        routing_decision = {"target": "merge", "forced": False}
+
+    # 持久化
+    finalized = result.to_dict()
+    finalized["routingDecision"] = routing_decision
+    finalized["finalizedAt"] = now_iso()
+    atomic_json_write(paths["result"], finalized)
+    atomic_json_write(paths["worker_state"], {"taskId": tid, "status": "finished",
+                                                "resultPath": str(paths["result"]),
+                                                "routingDecision": routing_decision})
+
+    log = EventLog(event_log_path(project_root))
+    log.emit("task.finished", {"taskId": tid, "status": status,
+                                "routingTarget": routing_decision["target"]})
+
+    # emit task.completed / task.blocked based on final status
+    if status == "done":
+        log.emit(TASK_COMPLETED, {"taskId": tid, "routingTarget": routing_decision["target"]})
+    elif status in ("blocked", "failed"):
+        log.emit(TASK_BLOCKED, {"taskId": tid, "status": status})
+
+    return {
+        "taskId": tid, "status": status,
+        "finalizedResultPath": str(paths["result"]),
+        "workerStatePath": str(paths["worker_state"]),
+        "routingDecision": routing_decision,
+    }
+
+
+def status_worker(project_root: Path) -> dict:
+    paths = _paths(project_root, "_")
+    state = safe_json_load(paths["state"]) or {}
+    task_ids = []
+    if paths["root"].joinpath("tasks").exists():
+        task_ids = [d.name for d in paths["root"].joinpath("tasks").iterdir() if d.is_dir()]
+    return {
+        "enabled": state.get("enabled", False),
+        "activeTaskId": state.get("activeTaskId", ""),
+        "taskIds": task_ids,
+    }
+
+
+def main(args) -> None:
+    project_root = Path(args.project).expanduser().resolve()
+    sub = args.sub or "status"
+    tid = args.task_id
+
+    if sub == "status":
+        s = status_worker(project_root)
+        print("airplan_mode=do")
+        print(f"enabled={s['enabled']}")
+        print(f"active_task_id={s['activeTaskId']}")
+        print(f"known_tasks={','.join(s['taskIds'])}")
+    elif sub == "enter":
+        result = enter_worker(project_root, tid)
+        print("airplan_mode=do")
+        print(f"task_id={result['taskId']}")
+        print(f"brief_path={result['briefPath']}")
+        print(f"result_path={result['resultPath']}")
+        print(f"worker_state_path={result['workerStatePath']}")
+    elif sub == "finish":
+        rpath = Path(args.result).expanduser().resolve() if args.result else None
+        finalized = finish_worker(project_root, tid, rpath)
+        print("airplan_mode=do")
+        print(f"task_id={finalized['taskId']}")
+        print(f"status={finalized['status']}")
+        print(f"routing_target={finalized['routingDecision']['target']}")
+        print(f"routing_forced={finalized['routingDecision']['forced']}")