@deksden-com/dd-flow-cli 0.7.0 → 0.8.0

package/dist/domain/stage-catalog.js

@@ -0,0 +1,22 @@
+import { AppError } from "../shared/errors.js";
+export const vnextStages = [
+    { id: "specify", directory: "01-specify", result: "specify.json", schema: "dd-flow/vnext-specify-result@4", next: ["protocolize"] },
+    { id: "protocolize", directory: "02-protocolize", result: "protocolize-result.json", schema: "dd-flow/vnext-protocolize-result@3", next: ["plan"] },
+    { id: "plan", directory: "03-plan", result: "stage-report.json", schema: "dd-flow/stage-report@2", next: ["plan-review", "code"] },
+    { id: "plan-review", directory: "04-plan-review", result: "decision.json", schema: "dd-flow/plan-review-decision@3", next: ["code"] },
+    { id: "code", directory: "05-code", result: "code-verification.json", schema: "dd-flow/code-verification@2", next: ["code-review", "merge"] },
+    { id: "code-review", directory: "06-code-review", result: "decision.json", schema: "dd-flow/code-review-decision@2", next: ["merge"] },
+    { id: "merge", directory: "07-merge", result: "merge-result.json", schema: "dd-flow/merge-result@1", next: [] }
+];
+export function vnextStage(id) {
+    const stage = vnextStages.find((candidate) => candidate.id === id);
+    if (!stage)
+        throw new AppError("validation", `Unknown vNext stage: ${id}`, 2, { stage: id });
+    return stage;
+}
+export function vnextStageDirectory(id) {
+    return vnextStage(id).directory;
+}
+export function isLegalVnextTransition(from, to) {
+    return vnextStage(from).next.includes(to);
+}

package/dist/domain/validation.js

@@ -113,7 +113,7 @@ function validateExecutionContext(input, itemId) {
         prompt_profile: requireString(context.prompt_profile, `Plan item ${itemId} execution_context.prompt_profile`),
         required_read: requireStringArray(context.required_read, `Plan item ${itemId} execution_context.required_read`),
         discovery_boundary: requireStringArray(context.discovery_boundary, `Plan item ${itemId} execution_context.discovery_boundary`),
-        write_scope: requireStringArray(context.write_scope, `Plan item ${itemId} execution_context.write_scope`),
+        planned_write_areas: requireStringArray(context.planned_write_areas, `Plan item ${itemId} execution_context.planned_write_areas`),
         checks: requireStringArray(context.checks, `Plan item ${itemId} execution_context.checks`)
     };
 }

package/dist/schemas/code-review-decision.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/code-review-decision@2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "summary", "findings"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-review-decision@2"},
+    "summary": {"type": "string", "minLength": 1},
+    "findings": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["finding_ref", "disposition", "reason"],
+        "properties": {
+          "finding_ref": {"type": "string", "pattern": "^WRK-[^/]+/FIND-[0-9]{3}$"},
+          "disposition": {"enum": ["fix", "defer", "reject", "duplicate"]},
+          "reason": {"type": "string", "minLength": 1},
+          "def_id": {"type": "string", "minLength": 1},
+          "duplicate_of": {"type": "string", "minLength": 1}
+        }
+      }
+    }
+  }
+}

package/dist/schemas/code-review-result.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/code-review-result@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "verdict", "summary", "aspects", "findings"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-review-result@1"},
+    "verdict": {"enum": ["pass", "findings", "blocked"]},
+    "summary": {"type": "string", "minLength": 1},
+    "aspects": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["aspect_id", "verdict", "summary", "evidence_refs"], "properties": {"aspect_id": {"type": "string", "minLength": 1}, "verdict": {"enum": ["pass", "findings", "blocked"]}, "summary": {"type": "string", "minLength": 1}, "evidence_refs": {"type": "array", "items": {"type": "string"}}}}},
+    "findings": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["finding_id", "aspect_id", "priority", "problem", "impact", "evidence_refs", "obligation_refs"], "properties": {"finding_id": {"type": "string", "pattern": "^FIND-[0-9]{3}$"}, "aspect_id": {"type": "string", "minLength": 1}, "priority": {"enum": ["p0", "p1", "p2", "p3"]}, "problem": {"type": "string", "minLength": 1}, "impact": {"type": "string", "minLength": 1}, "evidence_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "obligation_refs": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}}}}
+  }
+}

package/dist/schemas/code-verification.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/code-verification@2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "verdict", "summary", "unresolved", "deviations"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-verification@2"},
+    "verdict": {"enum": ["passed", "needs_repair", "blocked"]},
+    "summary": {"type": "string", "minLength": 1},
+    "unresolved": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "deviations": {"type": "array", "items": {"type": "string", "minLength": 1}}
+  }
+}

package/dist/schemas/code-work-batch.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/code-work-batch@5",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "sources", "works"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-work-batch@5"},
+    "sources": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["plan_id", "protocol_id", "revision", "sha256"], "properties": {"plan_id": {"type": "string", "minLength": 1}, "protocol_id": {"type": "string", "minLength": 1}, "revision": {"type": "integer", "minimum": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}}},
+    "works": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/work"}}
+  },
+  "$defs": {
+    "strings": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "stringList": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "source": {"type": "object", "additionalProperties": false, "required": ["plan_id", "protocol_id", "plan_item_id", "revision", "sha256"], "properties": {"plan_id": {"type": "string", "minLength": 1}, "protocol_id": {"type": "string", "minLength": 1}, "plan_item_id": {"type": "string", "minLength": 1}, "revision": {"type": "integer", "minimum": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}},
+    "spine": {"type": "object", "additionalProperties": false, "required": ["user_outcome", "component_responsibility", "must_preserve", "non_goals", "acceptance_contribution"], "properties": {"user_outcome": {"type": "string", "minLength": 1}, "component_responsibility": {"type": "string", "minLength": 1}, "must_preserve": {"$ref": "#/$defs/strings"}, "non_goals": {"$ref": "#/$defs/stringList"}, "acceptance_contribution": {"type": "string", "minLength": 1}}},
+    "obligation": {"type": "object", "additionalProperties": false, "required": ["id", "statement"], "properties": {"id": {"type": "string", "minLength": 1}, "statement": {"type": "string", "minLength": 1}}},
+    "acceptance": {"type": "object", "additionalProperties": false, "required": ["criterion_id", "path", "environment", "fixtures", "cleanup", "check_refs", "expected_evidence", "proof_limits", "gate"], "properties": {"criterion_id": {"type": "string", "pattern": "^AC-[0-9]+$"}, "path": {"type": "string", "minLength": 1}, "environment": {"type": "string", "minLength": 1}, "fixtures": {"$ref": "#/$defs/stringList"}, "cleanup": {"type": "string", "minLength": 1}, "check_refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}, "expected_evidence": {"$ref": "#/$defs/strings"}, "proof_limits": {"$ref": "#/$defs/strings"}, "gate": {"type": "string", "minLength": 1}}},
+    "check": {"type": "object", "additionalProperties": false, "required": ["id", "command", "purpose", "run_at", "availability"], "properties": {"id": {"type": "string", "pattern": "^CHK-[A-Za-z0-9-]+$"}, "command": {"type": "string", "minLength": 1}, "purpose": {"type": "string", "minLength": 1}, "run_at": {"enum": ["work", "code", "readiness", "merge", "release", "external"]}, "availability": {"enum": ["available", "planned"]}, "provided_by": {"type": "string", "minLength": 1}, "definition": {"type": "string", "minLength": 1}, "required_artifacts": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}, "allOf": [{"if": {"properties": {"availability": {"const": "planned"}}, "required": ["availability"]}, "then": {"required": ["provided_by", "definition"], "properties": {"command": {"pattern": "^@check/"}}}}]},
+    "documentUpdate": {"type": "object", "additionalProperties": false, "required": ["path", "action", "owner", "reason", "baseline_sha256"], "properties": {"path": {"type": "string", "minLength": 1}, "action": {"enum": ["create", "update"]}, "owner": {"type": "string", "minLength": 1}, "reason": {"type": "string", "minLength": 1}, "baseline_sha256": {"type": ["string", "null"], "pattern": "^[a-f0-9]{64}$"}}},
+    "repair": {"type": "object", "additionalProperties": false, "required": ["origin_work_ids"], "anyOf": [{"required": ["check_receipt_id", "failure_receipt_path"]}, {"required": ["review_finding_ids", "review_evidence_refs"]}], "properties": {"origin_work_ids": {"$ref": "#/$defs/strings"}, "check_receipt_id": {"type": "string", "minLength": 1}, "failure_receipt_path": {"type": "string", "minLength": 1}, "review_finding_ids": {"$ref": "#/$defs/strings"}, "review_evidence_refs": {"$ref": "#/$defs/strings"}}},
+    "work": {"type": "object", "additionalProperties": false, "required": ["schema_id", "key", "launch_policy", "source", "task", "semantic_spine", "requirements", "acceptance", "document_updates", "required_read", "discovery_boundary", "planned_write_areas", "checks", "provides_checks", "stop_conditions", "depends_on", "result_schema"], "properties": {"schema_id": {"const": "dd-flow/code-work-packet@5"}, "key": {"type": "string", "minLength": 1}, "launch_policy": {"const": "fresh_agent_required"}, "source": {"$ref": "#/$defs/source"}, "repair": {"$ref": "#/$defs/repair"}, "task": {"type": "string", "minLength": 1}, "semantic_spine": {"$ref": "#/$defs/spine"}, "requirements": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/obligation"}}, "acceptance": {"type": "array", "items": {"$ref": "#/$defs/acceptance"}}, "document_updates": {"type": "array", "items": {"$ref": "#/$defs/documentUpdate"}}, "required_read": {"$ref": "#/$defs/strings", "description": "Mandatory starting sources, not a read allowlist."}, "discovery_boundary": {"$ref": "#/$defs/strings", "description": "Likely discovery areas; additional project-local reads are allowed."}, "planned_write_areas": {"type": "array", "items": {"type": "string", "minLength": 1}, "description": "Soft coordination hints only. A worker may change any necessary project file inside the RUN workspace."}, "checks": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/check"}}, "provides_checks": {"type": "array", "items": {"$ref": "#/$defs/check"}}, "stop_conditions": {"$ref": "#/$defs/strings", "description": "Hard semantic or external stop conditions; path prediction drift is not a stop condition."}, "depends_on": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}, "result_schema": {"const": "dd-flow/code-work-result@2"}}}
+  }
+}

package/dist/schemas/code-work-result.schema.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/code-work-result@2",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "summary", "changed_paths", "evidence", "deviations", "blockers"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-work-result@2"},
+    "summary": {"type": "string", "minLength": 1},
+    "changed_paths": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+    "evidence": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["criterion_id", "refs"], "properties": {"criterion_id": {"type": "string", "minLength": 1}, "refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}}},
+    "deviations": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "blockers": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "resolved_finding_refs": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+  }
+}

package/dist/schemas/compatibility.schema.json

@@ -51,6 +51,38 @@
         "status": { "type": "string", "minLength": 1 }
       }
     },
+    "upgrade_contract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["model", "authorization", "storage_mutation", "run_creation", "post_sync_routing", "contexts", "order"],
+      "properties": {
+        "model": { "const": "dual_context_target_routing" },
+        "authorization": { "const": "command_allowlist" },
+        "storage_mutation": { "const": "explicit_migration_apply_only" },
+        "run_creation": { "const": "after_storage_readiness" },
+        "post_sync_routing": { "const": "marker_free_project_current" },
+        "contexts": {
+          "type": "array",
+          "const": ["project_current", "upgrade_target", "effective_execution"]
+        },
+        "order": {
+          "type": "array",
+          "const": [
+            "pin_target_canon",
+            "verify_target_router",
+            "resolve_contexts",
+            "read_only_diagnostics",
+            "check_shared_home_activity",
+            "verify_backup",
+            "plan_adjacent_migration",
+            "apply_migration_explicitly",
+            "create_upgrade_run",
+            "sync_canonical_layer",
+            "verify_marker_free_normal_route"
+          ]
+        }
+      }
+    },
     "contracts": {
       "type": "object",
       "additionalProperties": false,

package/dist/schemas/flow-contract.schema.json

@@ -34,12 +34,13 @@
     "specifications": {
       "type": "array",
       "minItems": 3,
+      "uniqueItems": true,
       "items": {
         "type": "object",
         "additionalProperties": false,
         "required": ["id", "version", "sha256"],
         "properties": {
-          "id": {"enum": ["SPC-004", "SPC-005", "SPC-006"]},
+          "id": {"enum": ["SPC-004", "SPC-005", "SPC-006", "SPC-009", "SPC-010", "SPC-011"]},
           "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
           "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
         }
@@ -80,7 +81,7 @@
         },
         "start_command": {"const": "dd-flow stage start <RUN> --stage <stage> --json"},
         "bootstrap_command": {"const": "dd-flow stage start --bootstrap --stage specify --project-root <root> --subject <label> --intake-file <path> --json"},
-        "finish_command": {"const": "dd-flow stage finish <RUN> --stage <stage> --outcome <outcome> --json"},
+        "finish_command": {"const": "dd-flow stage finish <RUN> --stage <stage> --json"},
         "prompt_sections": {
           "const": [
             "stage_identity",
@@ -114,7 +115,7 @@
       "required": ["finish_outputs", "model_input", "mechanical_facts"],
       "properties": {
         "finish_outputs": {"const": ["stage-report.json", "stage-report.md", "stage-report.html", "summary.md"]},
-        "model_input": {"const": "semantic-only; outcome flag"},
+        "model_input": {"const": "semantic-only; status in stage-input.json; mechanical facts are CLI-owned"},
         "mechanical_facts": {"const": "cli-owned"}
       }
     },
@@ -131,11 +132,14 @@
     "workspaceContract": {
       "type": "object",
       "additionalProperties": false,
-      "required": ["manager", "command", "project_hooks", "fallbacks"],
+      "required": ["manager", "command", "project_hooks", "feature_route_stage", "service_checkout_root", "feature_branch_template", "fallbacks"],
       "properties": {
         "manager": {"const": "official-worktrunk"},
         "command": {"const": "wt switch --create <branch> --base <base> --format json"},
         "project_hooks": {"const": [".worktreeinclude", ".config/wt.toml"]},
+        "feature_route_stage": {"const": "protocolize_start"},
+        "service_checkout_root": {"const": "$DD_FLOW_HOME/projects/<PRJ-ID>/checkouts/worktrees/<RUN>/<repo>"},
+        "feature_branch_template": {"const": "feature/run-<RUN>-<slug>"},
         "fallbacks": {"const": "forbidden"}
       }
     },
@@ -177,7 +181,7 @@
         "source_of_truth": {"const": "canonical prompts and schemas"},
         "runtime_owner": {"const": "dd-flow-cli"},
         "lint_owner": {"const": "mb-lint"},
-        "integrated_gate": {"const": "compatible releases plus clean specify-to-plan eval"}
+        "integrated_gate": {"type": "string", "minLength": 1}
       }
     }
   }

package/dist/schemas/flow-run.schema.json

@@ -1,143 +1,36 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "dd-flow/flow-run@2",
-  "title": "dd-flow canonical RUN state",
-  "description": "The sole current machine-readable state for one RUN. Event history belongs to timeline.jsonl.",
+  "$id": "dd-flow/flow-run@3",
+  "title": "dd-flow portable RUN projection",
+  "description": "Compact current projection. SQLite owns runtime state and timeline.jsonl owns history.",
   "type": "object",
   "additionalProperties": true,
-  "required": ["schema_id", "run_id", "project", "subject", "status", "started_at", "workspace", "current_stage", "attempts", "session_coverage", "usage_coverage", "artifacts"],
+  "required": ["schema_id", "run_id", "project", "subject", "status", "started_at", "workspace"],
   "properties": {
-    "schema_id": {"const": "dd-flow/flow-run@2"},
+    "schema_id": {"const": "dd-flow/flow-run@3"},
     "run_id": {"type": "string", "pattern": "^RUN-[0-9]+-[a-z0-9][a-z0-9-]*$"},
     "project": {"$ref": "#/definitions/identity"},
     "subject": {"$ref": "#/definitions/identity"},
-    "protocol_id": {"type": "string"},
     "flow_kind": {"type": "string", "minLength": 1},
-    "status": {"enum": ["created", "running", "done", "failed", "blocked", "discarded"]},
+    "status": {"enum": ["created", "running", "paused", "waiting_for_user", "done", "failed", "blocked", "cancelled", "discarded"]},
     "verdict": {"type": ["string", "null"]},
     "started_at": {"type": "string", "format": "date-time"},
     "finished_at": {"type": ["string", "null"], "format": "date-time"},
     "wall_clock_ms": {"type": ["integer", "null"], "minimum": 0},
     "timing_status": {"enum": ["measured", "partial", "unavailable"]},
     "workspace": {"$ref": "#/definitions/workspace"},
-    "current_stage": {"type": ["string", "null"]},
-    "plan_ref": {"$ref": "#/definitions/planRef"},
-    "plan_progress": {"$ref": "#/definitions/planProgress"},
-    "workers": {"$ref": "#/definitions/workers"},
-    "attempts": {"type": "array", "items": {"$ref": "#/definitions/attempt"}},
-    "session_coverage": {"$ref": "#/definitions/coverage"},
-    "usage_coverage": {"$ref": "#/definitions/coverage"},
-    "artifacts": {"$ref": "#/definitions/artifacts"},
+    "root_work_id": {"type": ["string", "null"]},
+    "active_stages": {"type": "array", "items": {"type": "string", "minLength": 1}, "uniqueItems": true},
+    "next_actions": {"type": "array", "items": {"type": "string", "minLength": 1}, "uniqueItems": true},
+    "works": {"type": "array", "items": {"$ref": "#/definitions/work"}},
+    "sessions": {"type": "array", "items": {"$ref": "#/definitions/session"}},
+    "variables": {"type": "object"},
     "timeline_path": {"const": "timeline.jsonl"}
   },
   "definitions": {
-    "planRef": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["path", "plan_id", "revision", "sha256"],
-      "properties": {
-        "path": {"type": "string", "pattern": "^\\.memory-bank/protocol/[^/]+/plan\\.json$"},
-        "plan_id": {"type": "string", "minLength": 1},
-        "revision": {"type": "integer", "minimum": 1},
-        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
-      }
-    },
-    "planProgress": {
-      "type": "object",
-      "additionalProperties": false,
-      "patternProperties": {
-        "^P[0-9]+$": {"$ref": "#/definitions/progressItem"}
-      }
-    },
-    "progressItem": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["status"],
-      "properties": {
-        "status": {"enum": ["pending", "in_progress", "done", "blocked", "skipped"]},
-        "started_at": {"type": "string", "format": "date-time"},
-        "completed_at": {"type": "string", "format": "date-time"},
-        "summary": {"type": "string", "minLength": 1},
-        "evidence": {"type": "array", "items": {"type": "string", "minLength": 1}}
-      }
-    },
-    "workers": {
-      "type": "object",
-      "additionalProperties": false,
-      "patternProperties": {
-        "^JOB-[A-Za-z0-9._-]+$": {"$ref": "#/definitions/worker"}
-      }
-    },
-    "worker": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["units", "status"],
-      "properties": {
-        "units": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "session_id": {"type": "string", "minLength": 1},
-        "status": {"enum": ["registered", "running", "completed", "failed", "blocked"]},
-        "task_ref": {"type": "string", "minLength": 1},
-        "prompt_ref": {"type": "string", "minLength": 1},
-        "report_ref": {"type": "string", "minLength": 1}
-      }
-    },
-    "identity": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["id", "title"],
-      "properties": {"id": {"type": "string", "minLength": 1}, "title": {"type": "string", "minLength": 1}}
-    },
-    "workspace": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["project_root", "workspace_path", "branch", "base"],
-      "properties": {
-        "project_root": {"type": "string", "minLength": 1},
-        "workspace_path": {"type": "string", "minLength": 1},
-        "branch": {"type": "string", "minLength": 1},
-        "base": {"type": "string", "minLength": 1},
-        "manager": {"const": "official-worktrunk"},
-        "bootstrap_status": {"type": "string", "minLength": 1}
-      }
-    },
-    "attempt": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["stage", "attempt_number", "root", "status"],
-      "properties": {
-        "stage": {"type": "string", "minLength": 1},
-        "attempt_number": {"type": "integer", "minimum": 1},
-        "root": {"type": "string", "minLength": 1},
-        "archive": {"type": ["string", "null"]},
-        "status": {"type": "string", "minLength": 1},
-        "started_at": {"type": "string", "format": "date-time"},
-        "finished_at": {"type": ["string", "null"], "format": "date-time"}
-      }
-    },
-    "coverage": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["status", "expected", "observed", "missing"],
-      "properties": {
-        "status": {"enum": ["complete", "partial", "unavailable"]},
-        "expected": {"type": "array", "items": {"type": "string"}},
-        "observed": {"type": "array", "items": {"type": "string"}},
-        "missing": {"type": "array", "items": {"type": "string"}},
-        "diagnostics": {"type": "array", "items": {"type": "string"}},
-        "reason": {"type": "string"}
-      }
-    },
-    "artifacts": {
-      "type": "object",
-      "additionalProperties": false,
-      "required": ["stage_prompt", "stage_report_json", "stage_report_md", "stage_report_html", "summary"],
-      "properties": {
-        "stage_prompt": {"type": "string", "minLength": 1},
-        "stage_report_json": {"type": "string", "minLength": 1},
-        "stage_report_md": {"type": "string", "minLength": 1},
-        "stage_report_html": {"type": "string", "minLength": 1},
-        "summary": {"type": "string", "minLength": 1}
-      }
-    }
+    "identity": {"type": "object", "additionalProperties": false, "required": ["id", "title"], "properties": {"id": {"type": "string", "minLength": 1}, "title": {"type": "string", "minLength": 1}}},
+    "workspace": {"type": "object", "additionalProperties": true, "required": ["project_root", "workspace_path", "branch", "base"], "properties": {"project_root": {"type": "string", "minLength": 1}, "workspace_path": {"type": "string", "minLength": 1}, "branch": {"type": "string", "minLength": 1}, "base": {"type": "string", "minLength": 1}}},
+    "work": {"type": "object", "additionalProperties": false, "required": ["work_id", "status", "depends_on"], "properties": {"work_id": {"type": "string"}, "parent_work_id": {"type": ["string", "null"]}, "status": {"enum": ["created", "running", "completed", "failed", "cancelled"]}, "depends_on": {"type": "array", "items": {"type": "string"}}, "launch_policy": {"enum": ["reuse_allowed", "fresh_agent_required"]}, "started_at": {"type": ["string", "null"]}, "completed_at": {"type": ["string", "null"]}}},
+    "session": {"type": "object", "additionalProperties": true, "required": ["session_id", "status"], "properties": {"session_id": {"type": "string", "minLength": 1}, "parent_session_id": {"type": ["string", "null"]}, "work_id": {"type": "string"}, "agent_id": {"type": ["string", "null"]}, "status": {"type": "string"}}}
   }
 }

package/dist/schemas/plan-aspect-map.schema.json

@@ -0,0 +1,22 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/plan-aspect-map@3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["$schema", "schema_id", "protocol_id", "plan_id", "plan_revision", "catalog_ref", "routing", "review_groups", "aspects"],
+  "properties": {
+    "$schema": {"type": "string", "minLength": 1},
+    "schema_id": {"const": "dd-flow/plan-aspect-map@3"},
+    "protocol_id": {"type": "string", "pattern": "^PRT-"},
+    "plan_id": {"type": "string", "minLength": 1},
+    "plan_revision": {"type": "integer", "minimum": 1},
+    "catalog_ref": {"type": "object", "additionalProperties": false, "required": ["path"], "properties": {"path": {"type": "string", "minLength": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}},
+    "routing": {"type": "object", "additionalProperties": false, "required": ["initial_state", "selected_route", "reason", "groups"], "properties": {"initial_state": {"const": "orchestrator_local"}, "selected_route": {"enum": ["local_compact", "single_wave_grouped", "multi_wave_grouped", "external_handoff"]}, "reason": {"type": "string", "minLength": 1}, "groups": {"type": "array", "items": {"$ref": "#/$defs/group"}}}},
+    "review_groups": {"type": "array", "description": "Every applicable aspect exactly once. Prefer one semantically safe wave within measured capacity.", "items": {"$ref": "#/$defs/group"}},
+    "review_tail_reason": {"type": "string", "minLength": 1},
+    "aspects": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["aspect_id", "applicability", "reason", "planned_artifact_refs"], "properties": {"aspect_id": {"type": "string", "minLength": 1}, "applicability": {"enum": ["applicable", "not_applicable"]}, "reason": {"type": "string", "minLength": 1}, "planned_artifact_refs": {"type": "array", "items": {"type": "string", "minLength": 1}}}}}
+  },
+  "$defs": {
+    "group": {"type": "object", "additionalProperties": false, "required": ["id", "aspect_ids"], "properties": {"id": {"type": "string", "minLength": 1}, "aspect_ids": {"type": "array", "minItems": 1, "maxItems": 3, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}}
+  }
+}

package/dist/schemas/plan-review-decision.schema.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/plan-review-decision@3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "outcome", "summary", "finding_decisions", "correction"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/plan-review-decision@3"},
+    "outcome": {"enum": ["accepted", "blocked", "failed", "cancelled"]},
+    "summary": {"type": "string", "minLength": 1},
+    "finding_decisions": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["finding_ref", "decision", "reason"], "properties": {"finding_ref": {"type": "string", "pattern": "^WRK-[^/]+/FIND-[0-9]{3}$"}, "decision": {"enum": ["accepted_fix", "rejected", "deferred_as_DEF", "requires_user", "duplicate"]}, "reason": {"type": "string", "minLength": 1}}}},
+    "correction": {"type": "object", "additionalProperties": false, "required": ["status", "previous_plan_revision", "changed_paths", "summary"], "properties": {"status": {"enum": ["applied", "not_required"]}, "previous_plan_revision": {"type": "integer", "minimum": 1}, "changed_paths": {"type": "array", "items": {"type": "string", "minLength": 1}}, "summary": {"type": "string", "minLength": 1}}}
+  }
+}

package/dist/schemas/plan-review-result.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/plan-review-result@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "plan_revision", "overall_verdict", "summary", "aspects"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/plan-review-result@1"},
+    "plan_revision": {"type": "integer", "minimum": 1},
+    "overall_verdict": {"enum": ["pass", "watch", "needs_changes", "blocked"]},
+    "summary": {"type": "string", "minLength": 1},
+    "aspects": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["aspect_id", "verdict", "summary", "evidence_refs", "findings"],
+        "properties": {
+          "aspect_id": {"type": "string", "minLength": 1},
+          "verdict": {"enum": ["pass", "watch", "needs_changes", "blocked"]},
+          "summary": {"type": "string", "minLength": 1},
+          "evidence_refs": {"type": "array", "items": {"type": "string", "minLength": 1}},
+          "findings": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["finding_id", "severity", "summary", "evidence_refs"],
+              "properties": {
+                "finding_id": {"type": "string", "pattern": "^FIND-[0-9]{3}$"},
+                "severity": {"enum": ["blocker", "high", "medium", "low", "info"]},
+                "summary": {"type": "string", "minLength": 1},
+                "evidence_refs": {"type": "array", "items": {"type": "string", "minLength": 1}}
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}