chore: push all design docs, V2 plan specs, and current working state

Includes AirPlan design documents, AircOding-alpha1-plan, AirPlanV2,
AirPlan-ParaV2, AirPlan-Para V1 reference docs, and all working code
changes across packages.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

AirPlan/docs/spec/AirPlanV2/lib/air_runtime/paths.py

@@ -0,0 +1,99 @@
+"""
+路径约定 — V2 统一所有子模块的 AirPlan 目录结构。
+"""
+
+from __future__ import annotations
+
+from pathlib import Path
+
+
+def airplan_root(project_root: Path) -> Path:
+    return project_root / "AirPlan"
+
+
+def state_root(project_root: Path) -> Path:
+    return airplan_root(project_root) / "state"
+
+
+def todo_path(project_root: Path) -> Path:
+    return airplan_root(project_root) / "todo.md"
+
+
+def plan_path(project_root: Path) -> Path:
+    return airplan_root(project_root) / "plan.md"
+
+
+def agents_path(project_root: Path) -> Path:
+    return airplan_root(project_root) / "AGENTS.md"
+
+
+def docs_root(project_root: Path) -> Path:
+    return airplan_root(project_root) / "docs"
+
+
+# --- 子模块状态路径 ---
+
+def engine_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "aireng" / "state.json"
+
+
+def worker_state_path(project_root: Path, task_id: str) -> Path:
+    return state_root(project_root) / "airdo" / "tasks" / task_id / "worker-state.json"
+
+
+def arc_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airarc" / "state.json"
+
+
+def dbg_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airdbg" / "state.json"
+
+
+def xdb_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airxdb" / "state.json"
+
+
+def sdb_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airsdb" / "state.json"
+
+
+def ndb_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airndb" / "state.json"
+
+
+def ctx_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "aircontext" / "state.json"
+
+
+def dep_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airdep" / "state.json"
+
+
+def tst_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airtst" / "state.json"
+
+
+def sec_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airsec" / "state.json"
+
+
+def rvr_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "airrvr" / "state.json"
+
+
+def event_log_path(project_root: Path) -> Path:
+    return state_root(project_root) / "events.jsonl"
+
+
+def task_graph_state_path(project_root: Path) -> Path:
+    return state_root(project_root) / "task-graph.json"
+
+
+def required_project_artifacts() -> list[str]:
+    return [
+        "AirPlan/AGENTS.md",
+        "AirPlan/plan.md",
+        "AirPlan/todo.md",
+        "AirPlan/docs/architecture/adr/",
+        "AirPlan/docs/architecture/c4/module.md",
+    ]