@deksden-com/dd-flow-cli 0.6.0 → 0.8.0-beta.135

package/dist/domain/flow-contract.js

@@ -64,6 +64,17 @@ export function loadProjectFlowContract(projectRoot) {
     if (!contractPath) {
         return defaultFlowContract;
     }
+    return loadFlowContractFile(contractPath);
+}
+/**
+ * Canonical-only flows execute against the pinned canonical contract before
+ * the target project flow pack is synchronized. Keep this path explicit so a
+ * stale project-local contract cannot become the upgrade RUN authority.
+ */
+export function loadCanonicalFlowContract(flowRoot) {
+    return loadFlowContractFile(path.join(flowRoot, "flow-contract.json"));
+}
+function loadFlowContractFile(contractPath) {
     try {
         const value = readFlowContractObject(contractPath);
         validateFlowContractStructure(value);

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/runtime/context.js

@@ -1,10 +1,16 @@
 import { getDatabase } from "../storage/database.js";
 import { resolveDdFlowHome } from "../storage/paths.js";
-export function createContext(env) {
+export function createRouterContext(env) {
+    return {
+        ddFlowHome: resolveDdFlowHome(env),
+        now: () => new Date().toISOString()
+    };
+}
+export function createContext(env, mode = "initialize") {
     const ddFlowHome = resolveDdFlowHome(env);
     return {
         ddFlowHome,
-        db: getDatabase(ddFlowHome),
+        db: getDatabase(ddFlowHome, mode),
         env,
         now: () => new Date().toISOString()
     };

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-stage-report.schema.json

@@ -124,10 +124,15 @@
     "run": {
       "type": "object",
       "additionalProperties": true,
-      "required": ["run_id", "run_state"],
+      "required": ["run_id"],
+      "anyOf": [
+        {"required": ["run_state"]},
+        {"required": ["run_index"]}
+      ],
       "properties": {
         "run_id": { "type": "string", "pattern": "^RUN-[0-9]{3}-[a-z0-9]+(?:-[a-z0-9]+)*$" },
-        "run_state": { "type": "string", "minLength": 1 }
+        "run_state": { "type": "string", "minLength": 1 },
+        "run_index": { "type": "string", "minLength": 1 }
       }
     },
     "stage": {

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@4",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "sources", "works"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/code-work-batch@4"},
+    "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", "write_scope", "checks", "provides_checks", "stop_conditions", "depends_on", "result_schema"], "properties": {"schema_id": {"const": "dd-flow/code-work-packet@4"}, "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"}, "discovery_boundary": {"$ref": "#/$defs/strings"}, "write_scope": {"$ref": "#/$defs/strings"}, "checks": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/check"}}, "provides_checks": {"type": "array", "items": {"$ref": "#/$defs/check"}}, "stop_conditions": {"$ref": "#/$defs/strings"}, "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/engine-manifest.schema.json

@@ -44,6 +44,28 @@
         "items": { "type": "string", "minLength": 1 }
       }
     },
+    "schema_registry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["schema_id", "entries"],
+      "properties": {
+        "schema_id": { "const": "dd-flow/engine-schema-registry@1" },
+        "entries": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "id", "path", "checksum"],
+            "properties": {
+              "name": { "type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$" },
+              "id": { "type": "string", "minLength": 1 },
+              "path": { "type": "string", "pattern": "^dist/schemas/[a-z0-9][a-z0-9-]*\\.schema\\.json$" },
+              "checksum": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+            }
+          }
+        }
+      }
+    },
     "integrity": {
       "type": "object",
       "additionalProperties": false,

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

@@ -80,7 +80,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 +114,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 +131,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"}
       }
     },

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

@@ -1,142 +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"}},
-        "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/mb-upgrade-migration-report.schema.json

@@ -70,12 +70,14 @@
     },
     "backup": {
       "type": "object",
-      "required": ["status", "path", "created_at", "rollback_route"],
+      "required": ["status", "path", "created_at", "rollback_route", "size_bytes", "sha256"],
       "additionalProperties": true,
       "properties": {
         "status": { "enum": ["present", "planned", "missing"] },
         "path": { "type": ["string", "null"] },
         "created_at": { "type": ["string", "null"] },
+        "size_bytes": { "type": ["integer", "null"], "minimum": 1 },
+        "sha256": { "type": ["string", "null"], "pattern": "^[a-f0-9]{64}$" },
         "rollback_route": { "type": "string", "minLength": 1 }
       }
     },

package/dist/schemas/merge-stage-report-legacy-0.4.2.schema.json

@@ -0,0 +1,24 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/merge-stage-report@2/engine-0.4.2",
+  "title": "Merge stage report emitted by dd-flow engine 0.4.2",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "run", "stage", "project", "subject", "overall", "breadcrumbs", "implemented_goals", "acceptance_scenarios", "changed_files", "checks", "review", "review_gates", "defs"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/merge-stage-report@2" },
+    "run": { "type": "object", "required": ["run_id", "run_index"], "properties": { "run_id": { "type": "string", "pattern": "^RUN-[0-9]{3}-[a-z0-9]+(?:-[a-z0-9]+)*$" }, "run_index": { "type": "string", "minLength": 1 } } },
+    "stage": { "type": "object", "required": ["name", "dir", "status"] },
+    "project": { "type": "object", "required": ["id", "title"] },
+    "subject": { "type": "object", "required": ["id", "title"] },
+    "overall": { "type": "object", "required": ["verdict", "summary", "next_action"], "properties": { "verdict": { "enum": ["accepted", "blocked", "failed"] }, "summary": { "type": "string", "minLength": 1 }, "next_action": { "type": "string", "minLength": 1 } } },
+    "breadcrumbs": { "type": "array" },
+    "implemented_goals": { "type": "array" },
+    "acceptance_scenarios": { "type": "array" },
+    "changed_files": { "type": "array" },
+    "checks": { "type": "array" },
+    "review": { "type": "object" },
+    "review_gates": { "type": "array" },
+    "defs": { "type": "array" }
+  }
+}

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}}
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}