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>

packages/contracts/src/task.ts

@@ -187,6 +187,24 @@ export interface SchedulerRunResult {
   summary: string
 }
 
+/**
+ * PlanDelta — incremental task-graph update from ArchitectureDesigner replanning.
+ * Per V2 §3.2.11: Arc produces this instead of full todo.md overwrite.
+ * The Scheduler applies it via TaskGraph.apply_delta, preserving running/completed tasks.
+ */
+export interface PlanDelta {
+  /** Task IDs to remove (only pending tasks are actually dropped). */
+  removed_tasks: TaskID[]
+  /** New tasks to add to the graph. */
+  added_tasks: Array<{ id: TaskID; type: string; title: string; description?: string; dependencies?: TaskDependencySpec[] }>
+  /** Existing tasks to update (title/description/dependencies only, status not touched). */
+  modified_tasks: Array<{ id: TaskID; title?: string; description?: string; dependencies?: TaskDependencySpec[] }>
+  /** Edge changes — add or remove individual dependencies. */
+  edge_changes: Array<{ task_id: TaskID; depends_on_task_id: TaskID; dependency_type: TaskDependencyType; action: 'add' | 'remove' }>
+  /** Human-readable reason for this delta (e.g. "需求变更: 新增认证模块"). */
+  reason: string
+}
+
 /**
  * Scheduler interface - the orchestration service for task execution.
  * Per DD §7.1, the Scheduler is an orchestration service, not a coding agent.

packages/contracts/tsconfig.json

@@ -1,8 +1,10 @@
 {
   "extends": "../../tsconfig.base.json",
   "compilerOptions": {
+    "composite": true,
+    "declaration": true,
     "outDir": "./dist",
     "rootDir": "./src"
   },
   "include": ["src"]
-}
+}