@deksden-com/dd-flow-cli 0.2.0 → 0.3.1

package/dist/schemas/compatibility.schema.json

@@ -0,0 +1,105 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/compatibility@1",
+  "title": "dd-flow compatibility manifest",
+  "description": "Canonical compatibility map between a Memory Bank release, tool packages, routed CLI engine expectations and machine data contracts required or recommended by that release.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "memory_bank_version", "dd_flow_cli", "router", "engine", "contracts", "migrations", "mb_lint"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/compatibility@1" },
+    "memory_bank_version": { "type": "string", "minLength": 1 },
+    "dd_flow_cli": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_name", "min_version", "recommended_version", "status_contract", "version_contract", "flow_contract"],
+      "properties": {
+        "package_name": { "type": "string", "minLength": 1 },
+        "min_version": { "type": "string", "minLength": 1 },
+        "recommended_version": { "type": "string", "minLength": 1 },
+        "status_contract": { "type": "string", "minLength": 1 },
+        "version_contract": { "type": "string", "minLength": 1 },
+        "flow_contract": { "type": "string", "minLength": 1 }
+      }
+    },
+    "router": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_name", "min_version", "recommended_version", "routing_model", "engine_store"],
+      "properties": {
+        "package_name": { "type": "string", "minLength": 1 },
+        "min_version": { "type": "string", "minLength": 1 },
+        "recommended_version": { "type": "string", "minLength": 1 },
+        "routing_model": { "type": "string", "minLength": 1 },
+        "engine_store": { "type": "string", "minLength": 1 },
+        "notes": { "type": "string" }
+      }
+    },
+    "engine": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_name", "version_range", "recommended_version", "install_hint", "old_engine_install_hint", "first_engine_installable_version", "legacy_direct_cli_before", "manifest_contract", "status"],
+      "properties": {
+        "package_name": { "type": "string", "minLength": 1 },
+        "version_range": { "type": "string", "minLength": 1 },
+        "recommended_version": { "type": "string", "minLength": 1 },
+        "install_hint": { "type": "string", "minLength": 1 },
+        "old_engine_install_hint": { "type": "string", "minLength": 1 },
+        "first_engine_installable_version": { "type": "string", "minLength": 1 },
+        "legacy_direct_cli_before": { "type": "string", "minLength": 1 },
+        "manifest_contract": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 }
+      }
+    },
+    "contracts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["storage_contract_set", "project_summary_contract", "project_dashboard_contract", "global_dashboard_contract", "status_contract", "version_contract"],
+      "properties": {
+        "storage_contract_set": { "type": "string", "minLength": 1 },
+        "project_summary_contract": { "type": "string", "minLength": 1 },
+        "project_dashboard_contract": { "type": "string", "minLength": 1 },
+        "global_dashboard_contract": { "type": "string", "minLength": 1 },
+        "status_contract": { "type": "string", "minLength": 1 },
+        "version_contract": { "type": "string", "minLength": 1 }
+      }
+    },
+    "global_dashboard": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["supported_project_summary_contracts", "unsupported_project_visibility", "summary_version_groups"],
+      "properties": {
+        "supported_project_summary_contracts": {
+          "type": "array",
+          "minItems": 1,
+          "items": { "type": "string", "minLength": 1 }
+        },
+        "unsupported_project_visibility": { "type": "boolean" },
+        "summary_version_groups": { "type": "boolean" }
+      }
+    },
+    "migrations": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "from_previous", "to_this", "adjacent_only", "normal_commands_may_migrate"],
+      "properties": {
+        "mode": { "const": "mb-upgrade-only" },
+        "from_previous": { "type": ["string", "null"] },
+        "to_this": { "type": "string", "minLength": 1 },
+        "adjacent_only": { "type": "boolean" },
+        "normal_commands_may_migrate": { "const": false }
+      }
+    },
+    "mb_lint": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_name", "min_version", "recommended_version", "command_contract"],
+      "properties": {
+        "package_name": { "type": "string", "minLength": 1 },
+        "min_version": { "type": "string", "minLength": 1 },
+        "recommended_version": { "type": "string", "minLength": 1 },
+        "command_contract": { "type": "string", "minLength": 1 }
+      }
+    }
+  }
+}

package/dist/schemas/engine-manifest.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/engine-manifest@1",
+  "title": "dd-flow engine manifest",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "package_name",
+    "package_version",
+    "engine_id",
+    "engine_version",
+    "installed_at",
+    "install_source",
+    "package_root",
+    "snapshot_root",
+    "entrypoint",
+    "supports_memorybank",
+    "supports_contracts",
+    "integrity"
+  ],
+  "properties": {
+    "schema_id": { "const": "dd-flow/engine-manifest@1" },
+    "package_name": { "type": "string", "minLength": 1 },
+    "package_version": { "type": "string", "minLength": 1 },
+    "engine_id": { "const": "dd-flow-engine" },
+    "engine_version": { "type": "string", "minLength": 1 },
+    "installed_at": { "type": "string", "format": "date-time" },
+    "install_source": {
+      "type": "string",
+      "enum": ["bundled_package", "npx_package", "local_development"]
+    },
+    "package_root": { "type": "string", "minLength": 1 },
+    "snapshot_root": { "type": "string", "minLength": 1 },
+    "entrypoint": { "type": "string", "minLength": 1 },
+    "supports_memorybank": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "supports_contracts": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "array",
+        "items": { "type": "string", "minLength": 1 }
+      }
+    },
+    "integrity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "checksum", "mode"],
+      "properties": {
+        "source": { "const": "package_snapshot" },
+        "checksum": { "type": ["string", "null"] },
+        "mode": {
+          "type": "string",
+          "enum": ["file_list", "full_content", "package_manifest", "degraded_local_development"]
+        }
+      }
+    }
+  }
+}

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

@@ -0,0 +1,90 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/flow-guidance@1",
+  "title": "dd-flow CLI flow guidance block",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "current_stage",
+    "allowed_next_stages",
+    "recommended_next_action",
+    "recommended_prompt",
+    "required_predecessor_evidence",
+    "guards",
+    "blocked_if_missing"
+  ],
+  "properties": {
+    "current_stage": {
+      "type": "string",
+      "minLength": 1
+    },
+    "lifecycle": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["flow", "stage", "status", "terminal", "raw_stage", "raw_status"],
+      "properties": {
+        "flow": { "type": "string", "minLength": 1 },
+        "stage": { "type": "string", "minLength": 1 },
+        "substage": { "type": ["string", "null"] },
+        "status": { "type": "string", "minLength": 1 },
+        "terminal": { "type": "boolean" },
+        "legacy_stage": { "type": ["string", "null"] },
+        "legacy_status": { "type": ["string", "null"] },
+        "raw_stage": { "type": "string", "minLength": 1 },
+        "raw_status": { "type": "string", "minLength": 1 },
+        "queue_status": { "type": ["string", "null"] }
+      }
+    },
+    "allowed_next_stages": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "recommended_next_action": {
+      "type": "string",
+      "minLength": 1
+    },
+    "recommended_prompt": {
+      "type": "string",
+      "minLength": 1
+    },
+    "required_predecessor_evidence": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "guards": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "summary"],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "status": {
+            "type": "string",
+            "enum": ["pass", "fail", "unknown", "not_applicable", "degraded"]
+          },
+          "summary": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    },
+    "blocked_if_missing": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  }
+}

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

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "dd-flow/flow-run-index@1",
+  "$id": "dd-flow/flow-run-index@2",
   "title": "dd-flow run index",
   "description": "Navigation and artifact discovery contract for one concrete dd-flow execution.",
   "type": "object",
@@ -24,7 +24,7 @@
   ],
   "properties": {
     "schema_id": {
-      "const": "dd-flow/flow-run-index@1"
+      "enum": ["dd-flow/flow-run-index@1", "dd-flow/flow-run-index@2"]
     },
     "run_id": {
       "type": "string",
@@ -36,7 +36,7 @@
     },
     "flow_kind": {
       "type": "string",
-      "enum": ["coding", "experiment", "mb-init", "mb-upgrade", "mb-audit", "mb-distill", "mb-upgrade-review", "custom"]
+      "enum": ["mb_sdlc", "coding", "experiment", "mb-init", "mb-upgrade", "mb-audit", "mb-distill", "mb-upgrade-review", "mb-sdlc-review", "review", "custom"]
     },
     "subject": {
       "type": "object",
@@ -62,7 +62,33 @@
       "required": ["root", "run_dir"],
       "properties": {
         "root": { "type": "string", "minLength": 1 },
-        "run_dir": { "type": "string", "pattern": "^\\.tasks/dd-flow-runs/RUN-[0-9]{3}-[a-z0-9]+(?:-[a-z0-9]+)*$" }
+        "run_dir": { "type": "string", "minLength": 1 }
+      }
+    },
+    "run_home": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["storage", "path"],
+      "properties": {
+        "storage": { "type": "string", "enum": ["dd_flow_home", "workspace_tasks_legacy", "project_projection"] },
+        "path": { "type": "string", "minLength": 1 },
+        "relative_path": { "type": "string", "minLength": 1 }
+      }
+    },
+    "execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_root", "workspace_root"],
+      "properties": {
+        "project_root": { "type": "string", "minLength": 1 },
+        "workspace_root": { "type": "string", "minLength": 1 }
+      }
+    },
+    "legacy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "project_tasks_run_dir": { "type": ["string", "null"] }
       }
     },
     "stage_runs": {

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

@@ -0,0 +1,126 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/global-dashboard-data@1",
+  "title": "dd-flow global dashboard data",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_id",
+    "generated_at",
+    "target_language",
+    "page",
+    "metrics",
+    "supported_summary_versions",
+    "summary_version_groups",
+    "unsupported_projects",
+    "project_cards",
+    "warnings"
+  ],
+  "properties": {
+    "schema_id": { "const": "dd-flow/global-dashboard-data@1" },
+    "generated_at": { "type": "string", "format": "date-time" },
+    "target_language": { "type": "string", "minLength": 2 },
+    "page": { "$ref": "#/definitions/page" },
+    "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
+    "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "supported_summary_versions": { "type": "array", "items": { "$ref": "#/definitions/summaryVersion" } },
+    "summary_version_groups": { "type": "array", "items": { "$ref": "#/definitions/summaryVersionGroup" } },
+    "unsupported_projects": { "type": "array", "items": { "$ref": "#/definitions/unsupportedProject" } },
+    "project_cards": { "type": "array", "items": { "$ref": "#/definitions/card" } },
+    "warnings": { "type": "array" }
+  },
+  "definitions": {
+    "page": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["kind", "screen_id", "title", "html_path", "json_path"],
+      "properties": {
+        "kind": { "const": "global" },
+        "screen_id": { "const": "SCR-DD-FLOW-GLOBAL-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" }
+      }
+    },
+    "card": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "display_status", "action_level", "lifecycle_summary", "resource_summary", "metrics"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "display_status": { "type": "string", "minLength": 1 },
+        "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
+        "lifecycle_summary": { "type": "object", "additionalProperties": true },
+        "resource_summary": { "type": "object", "additionalProperties": true },
+        "metrics": { "type": "object" }
+      }
+    },
+    "summaryVersion": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schema_id", "schema_version", "label", "status"],
+      "properties": {
+        "schema_id": { "type": "string", "minLength": 1 },
+        "schema_version": { "type": ["string", "null"] },
+        "label": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 }
+      }
+    },
+    "summaryVersionGroup": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schema_id", "schema_version", "compatible", "count", "project_ids", "project_names"],
+      "properties": {
+        "schema_id": { "type": "string", "minLength": 1 },
+        "schema_version": { "type": "string", "minLength": 1 },
+        "compatible": { "type": "boolean" },
+        "count": { "type": "integer", "minimum": 0 },
+        "project_ids": { "type": "array", "items": { "type": "string" } },
+        "project_names": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "unsupportedProject": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["id", "title", "root", "status", "display_status", "reason", "summary_path"],
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "title": { "type": "string", "minLength": 1 },
+        "root": { "type": "string", "minLength": 1 },
+        "status": { "type": "string", "minLength": 1 },
+        "display_status": { "const": "unsupported" },
+        "reason": { "type": "string", "minLength": 1 },
+        "detail": { "type": "string" },
+        "summary_schema_id": { "type": ["string", "null"] },
+        "summary_schema_version": { "type": ["string", "null"] },
+        "summary_path": { "type": "string", "minLength": 1 },
+        "install_hint": { "type": ["string", "null"] }
+      }
+    }
+  }
+}