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

package/dist/schemas/protocol-plan.schema.json

@@ -7,191 +7,24 @@
   "additionalProperties": false,
   "required": ["$schema", "schema_id", "plan_id", "protocol_id", "revision", "title", "summary", "specifications", "protocol_reference", "goal", "task_assessment", "route_decision", "policy_context", "sdlc_contours", "items", "verification", "code_handoff"],
   "properties": {
-    "$schema": {"type": "string", "minLength": 1},
-    "schema_id": {"const": "dd-flow/protocol-plan@1"},
-    "plan_id": {"type": "string", "pattern": "^PLAN-[A-Za-z0-9][A-Za-z0-9._-]*$"},
-    "protocol_id": {"type": "string", "pattern": "^PRT-[A-Za-z0-9][A-Za-z0-9._-]*$"},
-    "revision": {"type": "integer", "minimum": 1},
-    "title": {"type": "string", "minLength": 1},
-    "summary": {"type": "string", "minLength": 1},
-    "specifications": {
-      "type": "array", "minItems": 1, "uniqueItems": true,
-      "items": {
-        "type": "object", "additionalProperties": false,
-        "required": ["id", "version", "path", "sha256", "requirements"],
-        "properties": {
-          "id": {"type": "string", "pattern": "^SPC-[0-9]{3}$"},
-          "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
-          "path": {"type": "string", "pattern": "^\\.memory-bank/"},
-          "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
-          "requirements": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^R-[0-9]+$"}}
-        }
-      }
-    },
-    "protocol_reference": {
-      "type": "object", "additionalProperties": false, "required": ["path", "sha256"],
-      "properties": {
-        "path": {"type": "string", "pattern": "^\\.memory-bank/protocol/"},
-        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
-      }
-    },
-    "goal": {
-      "type": "object", "additionalProperties": false, "required": ["outcome", "constraints", "non_goals"],
-      "properties": {
-        "outcome": {"type": "string", "minLength": 1},
-        "constraints": {"type": "array", "items": {"type": "string", "minLength": 1}},
-        "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}}
-      }
-    },
+    "$schema": {"type": "string", "minLength": 1}, "schema_id": {"const": "dd-flow/protocol-plan@1"}, "plan_id": {"type": "string", "pattern": "^PLAN-[A-Za-z0-9][A-Za-z0-9._-]*$"}, "protocol_id": {"type": "string", "pattern": "^PRT-[A-Za-z0-9][A-Za-z0-9._-]*$"}, "revision": {"type": "integer", "minimum": 1}, "title": {"type": "string", "minLength": 1}, "summary": {"type": "string", "minLength": 1},
+    "specifications": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "object", "additionalProperties": false, "required": ["id", "version", "path", "sha256", "requirements"], "properties": {"id": {"type": "string", "pattern": "^SPC-[0-9]{3}$"}, "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"}, "path": {"type": "string", "pattern": "^\\.memory-bank/"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}, "requirements": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^R-[0-9]+$"}}}}},
+    "protocol_reference": {"type": "object", "additionalProperties": false, "required": ["path", "sha256"], "properties": {"path": {"type": "string", "pattern": "^\\.memory-bank/protocol/"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}},
+    "goal": {"type": "object", "additionalProperties": false, "required": ["outcome", "constraints", "non_goals"], "properties": {"outcome": {"type": "string", "minLength": 1}, "constraints": {"type": "array", "items": {"type": "string", "minLength": 1}}, "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}}}},
     "task_assessment": {"$ref": "#/definitions/taskAssessment"},
-    "route_decision": {
-      "type": "object", "additionalProperties": false,
-      "required": ["initial_state", "selected_route", "selected_execution_mode", "reason", "capacity_probe", "packing"],
-      "properties": {
-        "initial_state": {"const": "orchestrator_local"},
-        "selected_route": {"enum": ["local_compact", "single_wave_grouped", "multi_wave_grouped", "external_handoff"]},
-        "selected_execution_mode": {"type": "string", "minLength": 1},
-        "reason": {"type": "string", "minLength": 1},
-        "capacity_probe": {"type": "string", "minLength": 1},
-        "packing": {"type": "string", "minLength": 1}
-      }
-    },
-    "policy_context": {
-      "type": "object", "additionalProperties": false,
-      "required": ["target_language", "source_authority", "current_truth_boundary", "validation", "lint"],
-      "properties": {
-        "target_language": {"type": "string", "minLength": 1},
-        "source_authority": {"type": "string", "minLength": 1},
-        "current_truth_boundary": {"type": "string", "minLength": 1},
-        "validation": {"type": "string", "minLength": 1},
-        "lint": {"type": "string", "minLength": 1}
-      }
-    },
-    "sdlc_contours": {
-      "type": "object", "additionalProperties": false, "required": ["summary", "contours"],
-      "properties": {
-        "summary": {"type": "string", "minLength": 1},
-        "contours": {
-          "type": "array", "minItems": 1,
-          "items": {
-            "type": "object", "additionalProperties": false,
-            "required": ["name", "applicability_status", "gate_status", "target_stage", "summary"],
-            "properties": {
-              "name": {"type": "string", "minLength": 1},
-              "applicability_status": {"enum": ["applicable", "external", "not_applicable"]},
-              "gate_status": {"enum": ["required", "deferred", "not_applicable"]},
-              "target_stage": {"enum": ["specify", "plan", "code", "readiness", "merge", "release"]},
-              "summary": {"type": "string", "minLength": 1}
-            }
-          }
-        }
-      }
-    },
+    "route_decision": {"type": "object", "additionalProperties": false, "required": ["initial_state", "selected_route", "selected_execution_mode", "reason", "capacity_probe", "packing"], "properties": {"initial_state": {"const": "orchestrator_local"}, "selected_route": {"enum": ["local_compact", "single_wave_grouped", "multi_wave_grouped", "external_handoff"]}, "selected_execution_mode": {"type": "string", "minLength": 1}, "reason": {"type": "string", "minLength": 1}, "capacity_probe": {"type": "string", "minLength": 1}, "packing": {"type": "string", "minLength": 1}}},
+    "policy_context": {"type": "object", "additionalProperties": false, "required": ["target_language", "source_authority", "current_truth_boundary", "validation", "lint"], "properties": {"target_language": {"type": "string", "minLength": 1}, "source_authority": {"type": "string", "minLength": 1}, "current_truth_boundary": {"type": "string", "minLength": 1}, "validation": {"type": "string", "minLength": 1}, "lint": {"type": "string", "minLength": 1}}},
+    "sdlc_contours": {"type": "object", "additionalProperties": false, "required": ["summary", "contours"], "properties": {"summary": {"type": "string", "minLength": 1}, "contours": {"type": "array", "minItems": 1, "items": {"type": "object", "additionalProperties": false, "required": ["name", "applicability_status", "gate_status", "target_stage", "summary"], "properties": {"name": {"type": "string", "minLength": 1}, "applicability_status": {"enum": ["applicable", "external", "not_applicable"]}, "gate_status": {"enum": ["required", "deferred", "not_applicable"]}, "target_stage": {"enum": ["specify", "plan", "code", "readiness", "merge", "release"]}, "summary": {"type": "string", "minLength": 1}}}}}},
     "items": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/definitions/planItem"}},
-    "verification": {
-      "type": "object", "additionalProperties": false, "required": ["scenario_seeds", "commands", "acceptance"],
-      "properties": {
-        "scenario_seeds": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "commands": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "acceptance": {"type": "string", "minLength": 1}
-      }
-    },
-    "code_handoff": {
-      "type": "object", "additionalProperties": false,
-      "required": ["must_read", "accepted_plan_ref", "companion_handoffs", "next_stage", "known_external_gate"],
-      "properties": {
-        "must_read": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "accepted_plan_ref": {
-          "type": "object", "additionalProperties": false, "required": ["path", "revision", "sha256"],
-          "properties": {
-            "path": {"type": "string", "pattern": "^\\.memory-bank/protocol/[^/]+/plan\\.json$"},
-            "revision": {"type": "integer", "minimum": 1},
-            "sha256": {"enum": ["computed_by_stage_finish"]}
-          }
-        },
-        "companion_handoffs": {
-          "type": "array",
-          "items": {
-            "type": "object", "additionalProperties": false, "required": ["protocol_id", "repository", "scope"],
-            "properties": {
-              "protocol_id": {"type": "string", "pattern": "^PRT-[A-Za-z0-9][A-Za-z0-9._-]*$"},
-              "repository": {"type": "string", "minLength": 1},
-              "scope": {"type": "string", "minLength": 1}
-            }
-          }
-        },
-        "next_stage": {"enum": ["code", "readiness", "merge", "release"]},
-        "known_external_gate": {"type": "string", "minLength": 1}
-      }
-    }
+    "verification": {"type": "object", "additionalProperties": false, "required": ["scenario_seeds", "commands", "acceptance"], "properties": {"scenario_seeds": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "commands": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "acceptance": {"type": "string", "minLength": 1}}},
+    "code_handoff": {"type": "object", "additionalProperties": false, "required": ["must_read", "accepted_plan_ref", "companion_handoffs", "next_stage", "known_external_gate"], "properties": {"must_read": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "accepted_plan_ref": {"type": "object", "additionalProperties": false, "required": ["path", "revision", "sha256"], "properties": {"path": {"type": "string", "pattern": "^\\.memory-bank/protocol/[^/]+/plan\\.json$"}, "revision": {"type": "integer", "minimum": 1}, "sha256": {"enum": ["computed_by_stage_finish"]}}}, "companion_handoffs": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["protocol_id", "repository", "scope"], "properties": {"protocol_id": {"type": "string", "pattern": "^PRT-[A-Za-z0-9][A-Za-z0-9._-]*$"}, "repository": {"type": "string", "minLength": 1}, "scope": {"type": "string", "minLength": 1}}}}, "next_stage": {"enum": ["code", "readiness", "merge", "release"]}, "known_external_gate": {"type": "string", "minLength": 1}}}
   },
   "definitions": {
-    "semanticSpine": {
-      "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": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}},
-        "acceptance_contribution": {"type": "string", "minLength": 1}
-      }
-    },
-    "executionContext": {
-      "type": "object", "additionalProperties": false,
-      "required": ["prompt_profile", "required_read", "discovery_boundary", "write_scope", "checks"],
-      "properties": {
-        "prompt_profile": {"enum": ["documentation_contract", "code_implementation", "verification"]},
-        "required_read": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "discovery_boundary": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "write_scope": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "checks": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
-      }
-    },
-    "verificationContract": {
-      "type": "object", "additionalProperties": false, "required": ["checks", "evidence"],
-      "properties": {
-        "checks": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
-        "evidence": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}
-      }
-    },
-    "planItem": {
-      "type": "object", "additionalProperties": false,
-      "required": ["id", "kind", "title", "summary", "depends_on", "owner", "target_stage", "required", "requirements", "semantic_spine", "execution_context", "verification_contract"],
-      "properties": {
-        "id": {"type": "string", "pattern": "^P[0-9]+$"},
-        "kind": {"type": "string", "minLength": 1},
-        "title": {"type": "string", "minLength": 1},
-        "summary": {"type": "string", "minLength": 1},
-        "details": {"type": "string", "minLength": 1},
-        "depends_on": {"type": "array", "uniqueItems": true, "items": {"type": "string", "pattern": "^P[0-9]+$"}},
-        "owner": {"type": "string", "minLength": 1},
-        "target_stage": {"enum": ["specify", "plan", "code", "readiness", "merge", "release"]},
-        "required": {"type": "boolean"},
-        "requirements": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^SPC-[0-9]{3}@[0-9]+\\.[0-9]+\\.[0-9]+/R-[0-9]+$"}},
-        "semantic_spine": {"$ref": "#/definitions/semanticSpine"},
-        "execution_context": {"$ref": "#/definitions/executionContext"},
-        "verification_contract": {"$ref": "#/definitions/verificationContract"}
-      }
-    },
-    "taskAssessment": {
-      "type": "object", "additionalProperties": false,
-      "required": ["scope_breadth", "solution_novelty", "solution_uncertainty", "failure_impact", "plan_floor"],
-      "properties": {
-        "scope_breadth": {"$ref": "#/definitions/assessmentAxis"},
-        "solution_novelty": {"$ref": "#/definitions/assessmentAxis"},
-        "solution_uncertainty": {"$ref": "#/definitions/assessmentAxis"},
-        "failure_impact": {"$ref": "#/definitions/assessmentAxis"},
-        "plan_floor": {"$ref": "#/definitions/assessmentAxis"}
-      }
-    },
-    "assessmentAxis": {
-      "type": "object", "additionalProperties": false, "required": ["level", "surfaces", "reason"],
-      "properties": {
-        "level": {"type": "string", "minLength": 1},
-        "surfaces": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
-        "reason": {"type": "string", "minLength": 1}
-      }
-    }
+    "semanticSpine": {"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": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}}, "acceptance_contribution": {"type": "string", "minLength": 1}}},
+    "executionContext": {"type": "object", "additionalProperties": false, "required": ["prompt_profile", "required_read", "discovery_boundary", "planned_write_areas", "checks"], "properties": {"prompt_profile": {"enum": ["documentation_contract", "code_implementation", "verification"]}, "required_read": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "discovery_boundary": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "planned_write_areas": {"type": "array", "items": {"type": "string", "minLength": 1}, "description": "Soft concurrent-work coordination hints, never a write allowlist."}, "checks": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}}},
+    "verificationContract": {"type": "object", "additionalProperties": false, "required": ["checks", "evidence"], "properties": {"checks": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}, "evidence": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}}}},
+    "planItem": {"type": "object", "additionalProperties": false, "required": ["id", "kind", "title", "summary", "depends_on", "owner", "target_stage", "required", "requirements", "semantic_spine", "execution_context", "verification_contract"], "properties": {"id": {"type": "string", "pattern": "^P[0-9]+$"}, "kind": {"type": "string", "minLength": 1}, "title": {"type": "string", "minLength": 1}, "summary": {"type": "string", "minLength": 1}, "details": {"type": "string", "minLength": 1}, "depends_on": {"type": "array", "uniqueItems": true, "items": {"type": "string", "pattern": "^P[0-9]+$"}}, "owner": {"type": "string", "minLength": 1}, "target_stage": {"enum": ["specify", "plan", "code", "readiness", "merge", "release"]}, "required": {"type": "boolean"}, "requirements": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^SPC-[0-9]{3}@[0-9]+\\.[0-9]+\\.[0-9]+/R-[0-9]+$"}}, "semantic_spine": {"$ref": "#/definitions/semanticSpine"}, "execution_context": {"$ref": "#/definitions/executionContext"}, "verification_contract": {"$ref": "#/definitions/verificationContract"}}},
+    "taskAssessment": {"type": "object", "additionalProperties": false, "required": ["scope_breadth", "solution_novelty", "solution_uncertainty", "failure_impact", "plan_floor"], "properties": {"scope_breadth": {"$ref": "#/definitions/assessmentAxis"}, "solution_novelty": {"$ref": "#/definitions/assessmentAxis"}, "solution_uncertainty": {"$ref": "#/definitions/assessmentAxis"}, "failure_impact": {"$ref": "#/definitions/assessmentAxis"}, "plan_floor": {"$ref": "#/definitions/assessmentAxis"}}},
+    "assessmentAxis": {"type": "object", "additionalProperties": false, "required": ["level", "surfaces", "reason"], "properties": {"level": {"type": "string", "minLength": 1}, "surfaces": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}, "reason": {"type": "string", "minLength": 1}}}
   }
 }

package/dist/schemas/stage-finish-input.schema.json

@@ -4,10 +4,10 @@
   "title": "Semantic stage finish input",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_id", "status", "result", "acceptance", "changed_files", "checks", "evidence", "next_action"],
+  "required": ["schema_id", "status", "result", "acceptance", "checks", "evidence", "next_action"],
   "properties": {
     "schema_id": {"const": "dd-flow/stage-finish-input@1"},
-    "status": {"enum": ["done", "blocked", "failed"]},
+    "status": {"enum": ["done", "waiting_for_user", "blocked", "failed"]},
     "result": {"type": "string", "minLength": 1},
     "acceptance": {"type": "array", "items": {"type": "string", "minLength": 1}},
     "changed_files": {"type": "array", "items": {"type": "string", "minLength": 1}},
@@ -15,6 +15,20 @@
     "evidence": {"type": "array", "items": {"type": "string", "minLength": 1}},
     "reviewer_findings": {"type": "array", "items": {"type": "string"}},
     "def_outcomes": {"type": "array", "items": {"type": "string"}},
+    "questions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "question", "impact"],
+        "properties": {
+          "id": {"type": "string", "minLength": 1},
+          "question": {"type": "string", "minLength": 1},
+          "impact": {"type": "string", "minLength": 1},
+          "recommendation": {"type": "string", "minLength": 1}
+        }
+      }
+    },
     "next_action": {"type": "string", "minLength": 1}
   }
 }

package/dist/schemas/stage-report.schema.json

@@ -1,20 +1,21 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "dd-flow/stage-report@1",
+  "$id": "dd-flow/stage-report@2",
   "title": "Generated stage report",
   "type": "object",
   "additionalProperties": false,
-  "required": ["schema_id", "run_id", "stage", "generated_at", "verdict", "semantic", "mechanical", "artifacts", "validation"],
+  "required": ["schema_id", "run_id", "stage", "generated_at", "verdict", "summary", "semantic", "mechanical", "artifacts", "validation"],
   "properties": {
-    "schema_id": {"const": "dd-flow/stage-report@1"},
+    "schema_id": {"const": "dd-flow/stage-report@2"},
     "run_id": {"type": "string", "minLength": 1},
     "stage": {"type": "string", "minLength": 1},
     "generated_at": {"type": "string", "format": "date-time"},
-    "verdict": {"enum": ["done", "blocked", "failed", "degraded"]},
+    "verdict": {"enum": ["done", "waiting_for_user", "blocked", "failed", "degraded"]},
+    "summary": {"type": "string", "minLength": 1},
     "semantic": {"type": "object", "required": ["result", "acceptance", "changed_files", "checks", "evidence", "next_action"], "additionalProperties": true, "properties": {"result": {"type": "string"}, "acceptance": {"type": "array"}, "changed_files": {"type": "array"}, "checks": {"type": "array"}, "evidence": {"type": "array"}, "next_action": {"type": "string"}}},
-    "mechanical": {"type": "object", "required": ["started_at", "finished_at", "wall_clock_ms", "git", "session_coverage", "usage_coverage"], "additionalProperties": true, "properties": {"started_at": {"type": "string", "format": "date-time"}, "finished_at": {"type": "string", "format": "date-time"}, "wall_clock_ms": {"type": "integer", "minimum": 0}, "git": {"type": "object"}, "session_coverage": {"type": "object"}, "usage_coverage": {"type": "object"}}},
-    "artifacts": {"type": "object", "required": ["json", "markdown", "html", "summary"], "additionalProperties": false, "properties": {"json": {"type": "string"}, "markdown": {"type": "string"}, "html": {"type": "string"}, "summary": {"type": "string"}}},
-    "validation": {"type": "object", "required": ["permission_scope", "memory_bank_scope", "status"], "additionalProperties": true, "properties": {"permission_scope": {"const": "known_targets_only"}, "memory_bank_scope": {"const": "changed_files_and_links_only"}, "status": {"type": "string"}}},
+    "mechanical": {"type": "object", "required": ["started_at", "finished_at", "wall_clock_ms", "git"], "additionalProperties": true, "properties": {"started_at": {"type": "string", "format": "date-time"}, "finished_at": {"type": "string", "format": "date-time"}, "wall_clock_ms": {"type": ["integer", "null"], "minimum": 0}, "git": {"type": "object"}}},
+    "artifacts": {"type": "object", "required": ["json", "markdown", "html"], "additionalProperties": false, "properties": {"json": {"type": "string"}, "markdown": {"type": "string"}, "html": {"type": "string"}}},
+    "validation": {"type": "object", "required": ["status"], "additionalProperties": true, "properties": {"permission_scope": {"type": "string"}, "memory_bank_scope": {"type": "string"}, "status": {"type": "string"}}},
     "breadcrumbs": {"type": "array", "items": {"type": "object"}}
   }
 }

package/dist/schemas/stage-start-response.schema.json

@@ -10,7 +10,7 @@
       "then": {"required": ["plan_ref", "aspect_map_ref"]}
     }
   ],
-  "required": ["schema_id", "run_id", "stage", "attempt_number", "stage_root", "prompt_path", "aliases", "next_command", "worker_prompt_markdown"],
+  "required": ["schema_id", "run_id", "stage", "attempt_number", "stage_root", "prompt_path", "aliases", "resolved_context", "preflight", "worker_prompt_markdown", "next_command"],
   "properties": {
     "schema_id": {"const": "dd-flow/stage-start-response@2"},
     "run_id": {"type": "string", "minLength": 1},
@@ -24,7 +24,9 @@
     "plan_ref": {"type": "string", "pattern": "^\\.memory-bank/protocol/[^/]+/plan\\.json$"},
     "aspect_map_ref": {"type": "string", "minLength": 1},
     "next_command": {"type": "string", "pattern": "^dd-flow stage finish "},
+    "preflight": {"type": "object", "required": ["git", "compatibility", "permissions", "session_binding"], "additionalProperties": true},
+    "worker_prompt_markdown": {"type": "string", "minLength": 1},
     "permission_probe": {"type": "object", "additionalProperties": true},
-    "worker_prompt_markdown": {"type": "string", "minLength": 1}
+    "bootstrap": {"type": "boolean"}
   }
 }

package/dist/schemas/status-report.schema.json

@@ -84,9 +84,85 @@
           }
         }
       }
+    },
+    "engine": {
+      "type": ["object", "null"],
+      "additionalProperties": true,
+      "properties": {
+        "contexts": { "$ref": "#/definitions/compatibilityContexts" }
+      }
     }
   },
   "definitions": {
+    "compatibilityContexts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_current", "upgrade_target", "effective_execution"],
+      "properties": {
+        "project_current": { "$ref": "#/definitions/projectCurrentContext" },
+        "upgrade_target": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "#/definitions/upgradeTargetContext" }
+          ]
+        },
+        "effective_execution": { "$ref": "#/definitions/effectiveExecutionContext" }
+      }
+    },
+    "projectCurrentContext": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name", "canon", "memory_bank_version", "package_name", "required_engine_range", "resolution", "engine_version", "diagnostics"],
+      "properties": {
+        "name": { "const": "project_current" },
+        "canon": { "type": "object", "additionalProperties": true },
+        "memory_bank_version": { "type": ["string", "null"] },
+        "package_name": { "type": "string", "minLength": 1 },
+        "required_engine_range": { "type": ["string", "null"] },
+        "recommended_engine_version": { "type": ["string", "null"] },
+        "resolution": { "type": "string", "minLength": 1 },
+        "engine_version": { "type": ["string", "null"] },
+        "diagnostics": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "upgradeTargetContext": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["name", "canon", "memory_bank_version", "package_name", "required_engine_range", "resolution", "engine_version", "diagnostics"],
+      "properties": {
+        "name": { "const": "upgrade_target" },
+        "canon": {
+          "type": "object",
+          "additionalProperties": true,
+          "required": ["root", "version", "commit", "compatibility_sha256"],
+          "properties": {
+            "root": { "type": "string", "minLength": 1 },
+            "version": { "type": "string", "minLength": 1 },
+            "commit": { "type": "string", "minLength": 1 },
+            "compatibility_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" }
+          }
+        },
+        "memory_bank_version": { "type": ["string", "null"] },
+        "package_name": { "type": "string", "minLength": 1 },
+        "required_engine_range": { "type": ["string", "null"] },
+        "recommended_engine_version": { "type": ["string", "null"] },
+        "resolution": { "type": "string", "minLength": 1 },
+        "engine_version": { "type": ["string", "null"] },
+        "diagnostics": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "effectiveExecutionContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["operation", "mode", "package_name", "engine_version", "reason"],
+      "properties": {
+        "operation": { "type": "string", "minLength": 1 },
+        "mode": { "type": "string", "minLength": 1 },
+        "package_name": { "type": "string", "minLength": 1 },
+        "engine_version": { "type": ["string", "null"] },
+        "reason": { "type": "string", "minLength": 1 }
+      }
+    },
     "cliCompatibility": {
       "type": "object",
       "additionalProperties": true,

package/dist/schemas/vnext-protocol-plan.schema.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/protocol-plan@6",
+  "title": "Semantic protocol implementation plan",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "plan_id", "protocol_id", "revision", "title", "summary", "source_refs", "goal", "assessment", "decisions", "document_updates", "checks", "items", "acceptance"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/protocol-plan@6"},
+    "plan_id": {"type": "string", "pattern": "^PLAN-[A-Za-z0-9][A-Za-z0-9._-]*$"},
+    "protocol_id": {"type": "string", "pattern": "^PRT-[A-Za-z0-9][A-Za-z0-9._-]*$"},
+    "revision": {"type": "integer", "minimum": 1},
+    "title": {"type": "string", "minLength": 1},
+    "summary": {"type": "string", "minLength": 1},
+    "source_refs": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/sourceRef"}},
+    "goal": {"type": "object", "additionalProperties": false, "required": ["outcome", "constraints", "non_goals"], "properties": {"outcome": {"type": "string", "minLength": 1}, "constraints": {"$ref": "#/$defs/strings"}, "non_goals": {"type": "array", "items": {"type": "string", "minLength": 1}}}},
+    "assessment": {"type": "object", "additionalProperties": false, "required": ["scope_breadth", "solution_novelty", "solution_uncertainty", "failure_impact", "selected_depth", "depth_trigger"], "properties": {"scope_breadth": {"$ref": "#/$defs/axis"}, "solution_novelty": {"$ref": "#/$defs/axis"}, "solution_uncertainty": {"$ref": "#/$defs/axis"}, "failure_impact": {"$ref": "#/$defs/axis"}, "selected_depth": {"enum": ["compact_plan", "full_plan"]}, "depth_trigger": {"type": "string", "minLength": 1}}},
+    "decisions": {"type": "array", "items": {"$ref": "#/$defs/decision"}},
+    "document_updates": {"type": "array", "items": {"$ref": "#/$defs/documentUpdate"}},
+    "checks": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/check"}},
+    "items": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/item"}},
+    "acceptance": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/acceptance"}}
+  },
+  "$defs": {
+    "strings": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+    "sourceRef": {"type": "object", "additionalProperties": false, "required": ["kind", "id", "path", "requirement_ids"], "properties": {"kind": {"type": "string", "minLength": 1}, "id": {"type": "string", "minLength": 1}, "path": {"type": "string", "minLength": 1}, "requirement_ids": {"$ref": "#/$defs/strings"}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}},
+    "axis": {"type": "object", "additionalProperties": false, "required": ["level", "surfaces", "reason"], "properties": {"level": {"type": "string", "minLength": 1}, "surfaces": {"$ref": "#/$defs/strings"}, "reason": {"type": "string", "minLength": 1}}},
+    "decision": {"type": "object", "additionalProperties": false, "required": ["id", "decision", "rationale", "affected_surfaces"], "properties": {"id": {"type": "string", "minLength": 1}, "decision": {"type": "string", "minLength": 1}, "rationale": {"type": "string", "minLength": 1}, "affected_surfaces": {"$ref": "#/$defs/strings"}, "durable_ref": {"type": "string", "minLength": 1}}},
+    "documentUpdate": {"type": "object", "additionalProperties": false, "required": ["path", "action", "owner", "reason"], "properties": {"path": {"type": "string", "minLength": 1}, "action": {"enum": ["create", "update"]}, "owner": {"type": "string", "minLength": 1}, "reason": {"type": "string", "minLength": 1}}},
+    "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": {"type": "array", "items": {"type": "string", "minLength": 1}}, "acceptance_contribution": {"type": "string", "minLength": 1}}},
+    "execution": {"type": "object", "additionalProperties": false, "required": ["required_read", "discovery_boundary", "planned_write_areas", "stop_conditions"], "properties": {"required_read": {"$ref": "#/$defs/strings", "description": "Mandatory starting sources. This is not a read allowlist."}, "discovery_boundary": {"$ref": "#/$defs/strings", "description": "Likely discovery areas. A worker may inspect other project-local sources when necessary."}, "planned_write_areas": {"type": "array", "items": {"type": "string", "minLength": 1}, "description": "Optional file or directory hints used only to coordinate concurrent Works. They never grant or deny write permission."}, "stop_conditions": {"$ref": "#/$defs/strings", "description": "Semantic contradictions or external blockers that require the worker to stop."}}},
+    "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", "pattern": "^P[0-9]+$"}, "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/"}}}}]},
+    "verification": {"type": "object", "additionalProperties": false, "required": ["check_refs"], "properties": {"check_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^CHK-[A-Za-z0-9-]+$"}}}},
+    "item": {"type": "object", "additionalProperties": false, "required": ["id", "title", "summary", "details", "depends_on", "requirement_refs", "semantic_spine", "execution_context", "verification"], "properties": {"id": {"type": "string", "pattern": "^P[0-9]+$"}, "title": {"type": "string", "minLength": 1}, "summary": {"type": "string", "minLength": 1}, "details": {"type": "string", "minLength": 1}, "depends_on": {"type": "array", "uniqueItems": true, "items": {"type": "string", "pattern": "^P[0-9]+$"}}, "requirement_refs": {"$ref": "#/$defs/strings"}, "semantic_spine": {"$ref": "#/$defs/spine"}, "execution_context": {"$ref": "#/$defs/execution"}, "verification": {"$ref": "#/$defs/verification"}}},
+    "acceptance": {"type": "object", "additionalProperties": false, "required": ["criterion_id", "plan_item_ids", "changed_surfaces", "path", "environment", "fixtures", "cleanup", "check_refs", "expected_evidence", "proof_limits", "gate"], "properties": {"criterion_id": {"type": "string", "pattern": "^AC-[0-9]+$"}, "plan_item_ids": {"type": "array", "minItems": 1, "items": {"type": "string", "pattern": "^P[0-9]+$"}}, "changed_surfaces": {"$ref": "#/$defs/strings"}, "path": {"type": "string", "minLength": 1}, "environment": {"type": "string", "minLength": 1}, "fixtures": {"type": "array", "items": {"type": "string", "minLength": 1}}, "cleanup": {"type": "string", "minLength": 1}, "check_refs": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "pattern": "^CHK-[A-Za-z0-9-]+$"}}, "expected_evidence": {"$ref": "#/$defs/strings"}, "proof_limits": {"$ref": "#/$defs/strings"}, "gate": {"enum": ["work", "code", "readiness", "merge", "release", "external"]}}}
+  }
+}

package/dist/schemas/vnext-protocolize-result.schema.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/vnext-protocolize-result@3",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "outcome", "scope_sizing_verdict", "delivery", "obligation_ownership", "durable_links", "feature"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/vnext-protocolize-result@3"},
+    "outcome": {"const": "protocolized"},
+    "scope_sizing_verdict": {"enum": ["single_executable_protocol", "single_compact_protocol", "specification_with_slices_required"]},
+    "delivery": {"$ref": "#/$defs/delivery"},
+    "obligation_ownership": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/ownership"}},
+    "obligation_amendments": {"type": "array", "uniqueItems": true, "items": {"$ref": "#/$defs/amendment"}},
+    "durable_links": {"$ref": "#/$defs/durableLinks"},
+    "feature": {"$ref": "#/$defs/feature"}
+  },
+  "$defs": {
+    "strings": {"type": "array", "items": {"type": "string", "minLength": 1}},
+    "ownership": {"type": "object", "additionalProperties": false, "required": ["obligation_id", "member_keys"], "properties": {"obligation_id": {"type": "string", "pattern": "^(R|AC)-[0-9]{3,}$"}, "member_keys": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}},
+    "amendment": {"type": "object", "additionalProperties": false, "required": ["target_id", "replacement", "reason", "hitl_ref"], "properties": {"target_id": {"type": "string", "pattern": "^(R|AC)-[0-9]{3,}$"}, "replacement": {"type": "string", "minLength": 1}, "reason": {"type": "string", "minLength": 1}, "hitl_ref": {"type": "string", "pattern": "^HITL-[A-Za-z0-9._-]+$"}}},
+    "primaryAcceptance": {"type": "object", "additionalProperties": false, "required": ["actor", "initial_state", "action", "expected_result", "verification", "proof_limits"], "properties": {"actor": {"type": "string", "minLength": 1}, "initial_state": {"type": "string"}, "action": {"type": "string", "minLength": 1}, "expected_result": {"type": "string", "minLength": 1}, "verification": {"type": "string", "minLength": 1}, "proof_limits": {"type": "string"}}},
+    "member": {"type": "object", "additionalProperties": false, "required": ["key", "title", "slug", "goal", "role", "in_scope", "out_of_scope", "primary_acceptance", "blocked_by"], "properties": {"key": {"type": "string", "minLength": 1}, "title": {"type": "string", "minLength": 1}, "slug": {"type": "string", "minLength": 1}, "goal": {"type": "string", "minLength": 1}, "role": {"type": "string", "minLength": 1}, "in_scope": {"$ref": "#/$defs/strings"}, "out_of_scope": {"type": "array", "items": {"type": "string", "minLength": 1}}, "primary_acceptance": {"$ref": "#/$defs/primaryAcceptance"}, "blocked_by": {"type": "array", "uniqueItems": true, "items": {"type": "string", "minLength": 1}}}},
+    "mode": {"type": "object", "additionalProperties": false, "required": ["mode", "graph", "relative_duration", "reason"], "properties": {"mode": {"enum": ["shared_serial_bundle", "isolated_parallel", "isolated_dependency_waves"]}, "graph": {"type": "string", "minLength": 1}, "relative_duration": {"type": "string", "minLength": 1}, "reason": {"type": "string", "minLength": 1}}},
+    "pset": {"type": "object", "additionalProperties": false, "required": ["selected", "workspace_owner", "confirmation_gate", "dependency_graph", "feasible_modes", "excluded_modes"], "properties": {"selected": {"enum": ["shared_serial_bundle", "isolated_parallel", "isolated_dependency_waves"]}, "workspace_owner": {"type": "string", "minLength": 1}, "confirmation_gate": {"const": "before_first_code"}, "dependency_graph": {"$ref": "#/$defs/strings"}, "feasible_modes": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/mode"}}, "excluded_modes": {"type": "array", "items": {"type": "object", "additionalProperties": false, "required": ["mode", "reason"], "properties": {"mode": {"enum": ["shared_serial_bundle", "isolated_parallel", "isolated_dependency_waves"]}, "reason": {"type": "string", "minLength": 1}}}}}},
+    "delivery": {"type": "object", "additionalProperties": false, "required": ["kind", "title", "slug", "members"], "properties": {"kind": {"enum": ["single_protocol", "protocol_set"]}, "title": {"type": "string", "minLength": 1}, "slug": {"type": "string", "minLength": 1}, "decomposition_rationale": {"type": "string", "minLength": 1}, "pset": {"$ref": "#/$defs/pset"}, "members": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/member"}}}},
+    "durableLinks": {"type": "object", "additionalProperties": false, "required": ["preserve_raw_intake", "related_epics", "related_features", "related_specs", "related_adrs", "related_scenarios"], "properties": {"preserve_raw_intake": {"type": "boolean"}, "related_epics": {"$ref": "#/$defs/strings"}, "related_features": {"$ref": "#/$defs/strings"}, "related_specs": {"$ref": "#/$defs/strings"}, "related_adrs": {"$ref": "#/$defs/strings"}, "related_scenarios": {"$ref": "#/$defs/strings"}}},
+    "feature": {"type": "object", "additionalProperties": false, "required": ["action"], "properties": {"action": {"enum": ["create", "link", "update", "not_applicable"]}, "epic_path": {"type": "string"}, "title": {"type": "string"}, "slug": {"type": "string"}, "summary": {"type": "string"}, "reason": {"type": "string"}}}
+  }
+}

package/dist/schemas/vnext-specify.schema.json

@@ -0,0 +1,45 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/specify@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "summary", "requirements", "acceptance_criteria", "sections"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/specify@1"},
+    "summary": {"type": "string", "minLength": 1},
+    "requirements": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/requirement"}},
+    "acceptance_criteria": {"type": "array", "minItems": 1, "items": {"$ref": "#/$defs/acceptance"}},
+    "sections": {"$ref": "#/$defs/sections"}
+  },
+  "$defs": {
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "statement"],
+      "properties": {
+        "id": {"type": "string", "pattern": "^R-[0-9]{3,}$"},
+        "statement": {"type": "string", "minLength": 1}
+      }
+    },
+    "acceptance": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "statement"],
+      "properties": {
+        "id": {"type": "string", "pattern": "^AC-[0-9]{3,}$"},
+        "statement": {"type": "string", "minLength": 1}
+      }
+    },
+    "sections": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["problem_and_scope", "acceptance_and_verification", "gaps_defaults_and_project_facts", "assessment_and_protocolize_handoff"],
+      "properties": {
+        "problem_and_scope": {"type": "string", "minLength": 1},
+        "acceptance_and_verification": {"type": "string", "minLength": 1},
+        "gaps_defaults_and_project_facts": {"type": "string", "minLength": 1},
+        "assessment_and_protocolize_handoff": {"type": "string", "minLength": 1}
+      }
+    }
+  }
+}

package/dist/services/branch-context.js

@@ -22,7 +22,7 @@ export function getProtocolBranchContext(context, input) {
          WHERE project_id = ?`, [resolved.project.id])
         .map((row) => [row.protocol_id, row]));
     const sessions = context.db.all(`SELECT protocol_id, worker_id, flow_kind, status, current_stage, next_action
-     FROM flow_sessions
+     FROM sessions
      WHERE project_id = ? AND status IN ('pending', 'active', 'waiting_user', 'blocked', 'stopping')`, [resolved.project.id]);
     const sessionsByProtocol = new Map();
     for (const session of sessions) {