@deksden-com/dd-flow-cli 0.1.0 → 0.3.0

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

@@ -11,7 +11,12 @@
     "project",
     "subject",
     "overall",
+    "invocation_mode",
     "breadcrumbs",
+    "worker",
+    "queue_context",
+    "lane_lock",
+    "integration",
     "merge_job",
     "git",
     "checks",
@@ -29,6 +34,61 @@
       "type": "array",
       "items": { "$ref": "#/definitions/breadcrumb" }
     },
+    "invocation_mode": {
+      "type": "string",
+      "enum": ["one_shot", "long_lived_worker"]
+    },
+    "worker": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "session_kind", "status_before", "status_after"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "session_kind": { "type": "string", "enum": ["merge_job", "merge_worker"] },
+        "status_before": { "type": "string", "minLength": 1 },
+        "status_after": { "type": "string", "minLength": 1 },
+        "stop_flag": { "type": "string" }
+      }
+    },
+    "queue_context": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["before", "claimed_job", "after", "final_reason"],
+      "properties": {
+        "before": { "type": "string", "minLength": 1 },
+        "claimed_job": { "type": "string", "minLength": 1 },
+        "position_before": { "type": ["number", "null"] },
+        "pending_after": { "type": ["number", "null"] },
+        "after": { "type": "string", "minLength": 1 },
+        "final_reason": { "type": "string", "minLength": 1 }
+      }
+    },
+    "lane_lock": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["owner", "status_before", "status_after"],
+      "properties": {
+        "owner": { "type": "string", "minLength": 1 },
+        "lease_token": { "type": "string" },
+        "status_before": { "type": "string", "minLength": 1 },
+        "status_after": { "type": "string", "minLength": 1 },
+        "acquired_at": { "type": "string" },
+        "released_at": { "type": "string" }
+      }
+    },
+    "integration": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["source_branch", "target_branch", "result"],
+      "properties": {
+        "source_branch": { "type": "string", "minLength": 1 },
+        "source_commit": { "type": "string" },
+        "target_branch": { "type": "string", "minLength": 1 },
+        "result": { "type": "string", "enum": ["merged", "failed", "requeued", "blocked"] },
+        "result_commit": { "type": "string" },
+        "conflicts": { "type": "string" }
+      }
+    },
     "merge_job": {
       "type": "object",
       "additionalProperties": true,
@@ -96,7 +156,7 @@
       "additionalProperties": true,
       "required": ["verdict", "summary", "next_action"],
       "properties": {
-        "verdict": { "type": "string", "minLength": 1 },
+        "verdict": { "type": "string", "enum": ["merged", "failed", "requeued", "blocked"] },
         "summary": { "type": "string", "minLength": 1 },
         "next_action": { "type": "string", "minLength": 1 }
       }

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

@@ -0,0 +1,255 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/plan-stage-report@1",
+  "title": "dd-flow plan stage report data",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "generated_at",
+    "protocol",
+    "overall",
+    "route",
+    "graph",
+    "aspects",
+    "plan_items",
+    "handoff"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "dd-flow/plan-stage-report@1"
+    },
+    "generated_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "title", "project", "branch", "stage"],
+      "properties": {
+        "id": {"type": "string", "minLength": 1},
+        "title": {"type": "string", "minLength": 1},
+        "project": {"type": "string", "minLength": 1},
+        "branch": {"type": "string", "minLength": 1},
+        "stage": {"type": "string", "minLength": 1}
+      }
+    },
+    "overall": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["verdict", "verdict_label", "score", "score_max", "next_action", "summary"],
+      "properties": {
+        "verdict": {
+          "type": "string",
+          "enum": ["plan_ready", "ready_for_code", "needs_user_decision", "plan_blocked", "degraded"]
+        },
+        "verdict_label": {"type": "string", "minLength": 1},
+        "score": {"type": "number", "minimum": 0},
+        "score_max": {"type": "number", "exclusiveMinimum": 0},
+        "next_action": {"type": "string", "minLength": 1},
+        "summary": {"type": "string", "minLength": 1}
+      }
+    },
+    "route": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["label", "value", "note"],
+        "properties": {
+          "label": {"type": "string", "minLength": 1},
+          "value": {"type": "string", "minLength": 1},
+          "note": {"type": "string", "minLength": 1}
+        }
+      }
+    },
+    "task_profile": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "size": {"type": "string"},
+        "risk": {"type": "string"},
+        "planning_route_hint": {"type": "string"},
+        "execution_mode_hint": {"type": "string"},
+        "verification_mode": {"type": "string"}
+      }
+    },
+    "route_decision": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "selected_planning_route": {"type": "string"},
+        "selected_execution_mode": {"type": "string"},
+        "selected_git_route": {"type": "string"},
+        "selected_verification_depth": {"type": "string"},
+        "selected_evidence_level": {"type": "string"},
+        "reason": {"type": "string"}
+      }
+    },
+    "graph": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["nodes", "edges"],
+      "properties": {
+        "nodes": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "label", "x", "y", "status", "note"],
+            "properties": {
+              "id": {"type": "string", "minLength": 1},
+              "label": {"type": "string", "minLength": 1},
+              "x": {"type": "number"},
+              "y": {"type": "number"},
+              "status": {"type": "string", "enum": ["done", "ready", "watch", "next", "blocked", "skipped"]},
+              "note": {"type": "string", "minLength": 1}
+            }
+          }
+        },
+        "edges": {
+          "type": "array",
+          "items": {
+            "type": "array",
+            "items": [
+              {"type": "string", "minLength": 1},
+              {"type": "string", "minLength": 1}
+            ],
+            "additionalItems": false,
+            "minItems": 2,
+            "maxItems": 2
+          }
+        }
+      }
+    },
+    "aspects": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "label", "score", "status", "summary", "note", "findings"],
+        "properties": {
+          "id": {"type": "string", "minLength": 1},
+          "label": {"type": "string", "minLength": 1},
+          "radar_label": {"type": "string"},
+          "relevance": {"type": "string", "enum": ["not_applicable", "light", "deep", "unknown"]},
+          "coverage_mode": {"type": "string", "enum": ["orchestrator", "subagent", "grouped_subagent", "degraded"]},
+          "subagent_id": {"type": "string"},
+          "group_id": {"type": "string"},
+          "report_path": {"type": "string"},
+          "not_applicable_reason": {"type": "string"},
+          "score": {"type": "number", "minimum": 0, "maximum": 5},
+          "status": {"type": "string", "enum": ["reviewed", "watch", "blocked", "not_applicable", "degraded"]},
+          "summary": {"type": "string", "minLength": 1},
+          "note": {"type": "string", "minLength": 1},
+          "findings": {
+            "type": "array",
+            "items": {"type": "string", "minLength": 1}
+          }
+        }
+      }
+    },
+    "sdlc_contours": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "summary": {"type": "string"},
+        "contours": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "required": ["name", "applicability_status", "gate_status", "summary"],
+            "properties": {
+              "name": {"type": "string", "minLength": 1},
+              "applicability_status": {"type": "string", "minLength": 1},
+              "verification_state": {"type": "string"},
+              "closure_state": {"type": "string"},
+              "gate_status": {"type": "string", "minLength": 1},
+              "target_stage": {"type": "string"},
+              "delivery_target": {"type": "string"},
+              "summary": {"type": "string", "minLength": 1},
+              "reason": {"type": "string"},
+              "evidence": {"type": "string"},
+              "next_action": {"type": "string"}
+            }
+          }
+        },
+        "policy_migration": {"type": "string"},
+        "next_delivery_action": {"type": "string"}
+      }
+    },
+    "links": {
+      "type": "object",
+      "additionalProperties": { "$ref": "#/definitions/link" },
+      "properties": {
+        "global_dashboard": { "$ref": "#/definitions/link" },
+        "project_dashboard": { "$ref": "#/definitions/link" },
+        "protocol_page": { "$ref": "#/definitions/link" },
+        "run_index": { "$ref": "#/definitions/link" },
+        "run_summary": { "$ref": "#/definitions/link" },
+        "protocol_source": { "$ref": "#/definitions/link" },
+        "protocol_summary": { "$ref": "#/definitions/link" },
+        "previous_stage_report": { "$ref": "#/definitions/link" },
+        "next_stage_report": { "$ref": "#/definitions/link" }
+      }
+    },
+    "plan_items": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "title", "owner", "status", "depends_on", "verification", "note", "details"],
+        "properties": {
+          "id": {"type": "string", "minLength": 1},
+          "title": {"type": "string", "minLength": 1},
+          "owner": {"type": "string", "minLength": 1},
+          "status": {"type": "string", "enum": ["ready", "watch", "blocked", "done", "skipped"]},
+          "depends_on": {
+            "type": "array",
+            "items": {"type": "string", "minLength": 1}
+          },
+          "verification": {"type": "string", "minLength": 1},
+          "note": {"type": "string", "minLength": 1},
+          "details": {
+            "type": "array",
+            "items": {"type": "string", "minLength": 1}
+          }
+        }
+      }
+    },
+    "handoff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code_prompt", "must_read", "next_gate"],
+      "properties": {
+        "code_prompt": {"type": "string", "minLength": 1},
+        "must_read": {
+          "type": "array",
+          "items": {"type": "string", "minLength": 1}
+        },
+        "next_gate": {"type": "string", "minLength": 1}
+      }
+    }
+  },
+  "definitions": {
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["href", "label", "path_kind", "status"],
+      "properties": {
+        "href": { "type": "string" },
+        "label": { "type": "string", "minLength": 1 },
+        "path_kind": { "type": "string", "enum": ["relative", "absolute"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" },
+        "source": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/schemas/project-dashboard-data.schema.json

@@ -0,0 +1,98 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/project-dashboard-data@1",
+  "title": "dd-flow project dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "metrics", "protocol_cards", "warnings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/project-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "project": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "root", "status", "updated_at"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "root": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "updated_at": { "type": "string", "minLength": 1 }
+      }
+    },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "protocol_cards": { "type": "array", "items": { "$ref": "#/definitions/protocolCard" } },
+    "review_runs": { "type": "array", "items": { "$ref": "#/definitions/reviewRun" } },
+    "merge_queue": { "type": "array" },
+    "sessions": { "type": "array" },
+    "locks": { "type": "array" },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "project" },
+        "screen_id": { "const": "SCR-DD-FLOW-PROJECT-DASHBOARD" },
+        "title": { "type": "string", "minLength": 1 },
+        "html_path": { "type": "string", "minLength": 1 },
+        "json_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "label", "value", "status", "source"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "value": { "type": ["number", "null"] },
+        "status": { "type": "string", "enum": ["known", "unknown", "degraded", "not_applicable"] },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["label", "href", "path_kind", "status"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "href": { "type": "string" },
+        "path_kind": { "type": "string", "enum": ["absolute", "relative"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" }
+      }
+    },
+    "protocolCard": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "display_status", "action_level", "current_stage", "href"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "current_stage": { "type": "string", "minLength": 1 },
+        "href": { "type": "string", "minLength": 1 }
+      }
+    },
+    "reviewRun": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "flow_kind", "status", "display_status"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "subject_id": { "type": "string" }
+      }
+    }
+  }
+}

package/dist/schemas/project-flow-pack-manifest.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/project-flow-pack-manifest@2",
+  "title": "Project flow pack manifest",
+  "description": "Manifest for the curated project-local dd-flow pack installed under .memory-bank/dd-flow/.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "pack_version",
+    "flow_origin_policy",
+    "canon_root",
+    "canon_flow_root",
+    "source_commit",
+    "installed_at",
+    "included_files",
+    "excluded_canonical_only_flows"
+  ],
+  "properties": {
+    "schema_id": {
+      "type": "string",
+      "enum": ["dd-flow/project-flow-pack-manifest@1", "dd-flow/project-flow-pack-manifest@2"]
+    },
+    "pack_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "flow_origin_policy": {
+      "const": "project_local_pack"
+    },
+    "canon_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "canon_memory_bank_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "canon_flow_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source_commit": {
+      "type": "string",
+      "minLength": 7
+    },
+    "canon_version_at_source_commit": {
+      "type": "string",
+      "minLength": 1
+    },
+    "canon_version": {
+      "type": "string",
+      "minLength": 1
+    },
+    "flow_contract": {
+      "type": "string",
+      "minLength": 1
+    },
+    "installed_at": {
+      "type": "string",
+      "minLength": 1
+    },
+    "included_files": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "$ref": "#/definitions/projectLocalFile"
+      }
+    },
+    "file_hashes": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "excluded_canonical_only_flows": {
+      "type": "array",
+      "minItems": 4,
+      "uniqueItems": true,
+      "items": {
+        "type": "string",
+        "enum": ["mb-init.md", "mb-upgrade.md", "mb-upgrade-review.md", "mb-distill.md"]
+      }
+    },
+    "generated_allow_patterns": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "notes": {
+      "type": "string"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "schema_id": {
+            "const": "dd-flow/project-flow-pack-manifest@2"
+          }
+        }
+      },
+      "then": {
+        "required": ["canon_memory_bank_root", "canon_flow_root", "canon_version_at_source_commit", "flow_contract"]
+      }
+    }
+  ],
+  "definitions": {
+    "projectLocalFile": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))(?!.*//)(?!manifest\\.json$)[A-Za-z0-9._-]+(?:/[A-Za-z0-9._-]+)*$",
+      "not": {
+        "anyOf": [
+          { "pattern": "^(mb-init|mb-upgrade|mb-upgrade-review|mb-distill)\\.md$" },
+          { "pattern": "^(mb-init|mb-upgrade|mb-upgrade-review|mb-distill)/" },
+          { "pattern": "^experiments/" },
+          { "pattern": "^evals/" }
+        ]
+      }
+    }
+  }
+}

package/dist/schemas/protocol-dashboard-data.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/protocol-dashboard-data@1",
+  "title": "dd-flow protocol dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "protocol", "primary_run_id", "run_history", "stage_pipeline", "metrics", "warnings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/protocol-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "project": { "type": "object", "additionalProperties": true, "required": ["id", "title", "root"] },
+    "protocol": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "raw_status", "raw_stage", "display_status", "action_level", "updated_at"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "raw_status": { "type": "string", "minLength": 1 },
+        "raw_stage": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "updated_at": { "type": "string", "minLength": 1 }
+      }
+    },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "primary_run_id": { "type": ["string", "null"] },
+    "primary_run_reason": { "type": "string" },
+    "run_history": { "type": "array", "items": { "$ref": "#/definitions/run" } },
+    "review_runs": { "type": "array", "items": { "$ref": "#/definitions/run" } },
+    "stage_pipeline": { "type": "array" },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "protocol" },
+        "screen_id": { "const": "SCR-DD-FLOW-PROTOCOL-PAGE" },
+        "title": { "type": "string", "minLength": 1 },
+        "html_path": { "type": "string", "minLength": 1 },
+        "json_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "label", "value", "status", "source"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "label": { "type": "string", "minLength": 1 },
+        "value": { "type": ["number", "null"] },
+        "status": { "type": "string", "enum": ["known", "unknown", "degraded", "not_applicable"] },
+        "source": { "type": "string", "minLength": 1 }
+      }
+    },
+    "link": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["label", "href", "path_kind", "status"],
+      "properties": {
+        "label": { "type": "string", "minLength": 1 },
+        "href": { "type": "string" },
+        "path_kind": { "type": "string", "enum": ["absolute", "relative"] },
+        "status": { "type": "string", "enum": ["available", "pending", "missing", "not_applicable"] },
+        "degraded_reason": { "type": "string" }
+      }
+    },
+    "run": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "short_id", "flow_kind", "display_flow_kind", "status", "display_status", "stages"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "short_id": { "type": "string", "minLength": 1 },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "display_flow_kind": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "stages": { "type": "array" }
+      }
+    }
+  }
+}