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

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

@@ -18,6 +18,23 @@
       "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": {

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

@@ -4,7 +4,18 @@
   "title": "dd-flow global dashboard data",
   "type": "object",
   "additionalProperties": true,
-  "required": ["schema_id", "generated_at", "target_language", "page", "metrics", "project_cards", "warnings"],
+  "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" },
@@ -12,6 +23,9 @@
     "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" }
   },
@@ -55,14 +69,58 @@
     "card": {
       "type": "object",
       "additionalProperties": true,
-      "required": ["id", "title", "display_status", "action_level", "metrics"],
+      "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"] }
+      }
     }
   }
 }

package/dist/schemas/mb-upgrade-migration-report.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/mb-upgrade-migration-report@1",
+  "title": "mb-upgrade runtime/home migration report",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "ok",
+    "schema_id",
+    "generated_at",
+    "project",
+    "migration",
+    "backup",
+    "active_state",
+    "primary_data",
+    "derived_artifacts",
+    "verification"
+  ],
+  "properties": {
+    "ok": { "const": true },
+    "schema_id": { "const": "dd-flow/mb-upgrade-migration-report@1" },
+    "generated_at": { "type": "string", "minLength": 1 },
+    "project": {
+      "type": "object",
+      "required": ["id", "root", "memory_bank_version"],
+      "additionalProperties": true,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "root": { "type": "string", "minLength": 1 },
+        "memory_bank_version": { "type": ["string", "null"] }
+      }
+    },
+    "migration": {
+      "type": "object",
+      "required": [
+        "mode",
+        "status",
+        "source_memory_bank_version",
+        "target_memory_bank_version",
+        "adjacent_only",
+        "chain",
+        "blocked_reasons"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "mode": { "const": "mb-upgrade-only" },
+        "status": { "enum": ["ready", "blocked", "noop", "completed", "failed", "degraded"] },
+        "source_memory_bank_version": { "type": "string", "minLength": 1 },
+        "target_memory_bank_version": { "type": "string", "minLength": 1 },
+        "adjacent_only": { "const": true },
+        "chain": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "from", "to", "status"],
+            "additionalProperties": true,
+            "properties": {
+              "id": { "type": "string", "minLength": 1 },
+              "from": { "type": "string", "minLength": 1 },
+              "to": { "type": "string", "minLength": 1 },
+              "status": { "enum": ["planned", "applied", "skipped", "failed", "blocked"] }
+            }
+          }
+        },
+        "blocked_reasons": {
+          "type": "array",
+          "items": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    "backup": {
+      "type": "object",
+      "required": ["status", "path", "created_at", "rollback_route"],
+      "additionalProperties": true,
+      "properties": {
+        "status": { "enum": ["present", "planned", "missing"] },
+        "path": { "type": ["string", "null"] },
+        "created_at": { "type": ["string", "null"] },
+        "rollback_route": { "type": "string", "minLength": 1 }
+      }
+    },
+    "active_state": { "type": "object", "additionalProperties": true },
+    "primary_data": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "derived_artifacts": {
+      "type": "array",
+      "items": { "type": "string", "minLength": 1 }
+    },
+    "verification": { "type": "object", "additionalProperties": true }
+  }
+}

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

@@ -4,7 +4,7 @@
   "title": "dd-flow project dashboard data",
   "type": "object",
   "additionalProperties": true,
-  "required": ["schema_id", "generated_at", "target_language", "page", "project", "metrics", "protocol_cards", "warnings"],
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "metrics", "lifecycle_summary", "resource_summary", "protocol_cards", "warnings"],
   "properties": {
     "schema_id": { "const": "dd-flow/project-dashboard-data@1" },
     "generated_at": { "type": "string", "format": "date-time" },
@@ -24,8 +24,11 @@
     },
     "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
     "metrics": { "type": "array", "items": { "$ref": "#/definitions/metric" } },
+    "lifecycle_summary": { "type": "object", "additionalProperties": true },
+    "resource_summary": { "type": "object", "additionalProperties": true },
     "protocol_cards": { "type": "array", "items": { "$ref": "#/definitions/protocolCard" } },
     "review_runs": { "type": "array", "items": { "$ref": "#/definitions/reviewRun" } },
+    "queued_protocols": { "type": "array" },
     "merge_queue": { "type": "array" },
     "sessions": { "type": "array" },
     "locks": { "type": "array" },
@@ -71,16 +74,37 @@
     "protocolCard": {
       "type": "object",
       "additionalProperties": true,
-      "required": ["id", "short_id", "display_status", "action_level", "current_stage", "href"],
+      "required": ["id", "short_id", "display_status", "action_level", "lifecycle", "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"] },
+        "lifecycle": { "$ref": "#/definitions/lifecycle" },
+        "lifecycle_stage": { "type": "string" },
+        "lifecycle_status": { "type": "string" },
+        "resource": { "type": "object", "additionalProperties": true },
         "current_stage": { "type": "string", "minLength": 1 },
         "href": { "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"] }
+      }
+    },
     "reviewRun": {
       "type": "object",
       "additionalProperties": true,

package/dist/schemas/project-summary.schema.json

@@ -0,0 +1,73 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/project-summary@1",
+  "title": "dd-flow project summary",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_id",
+    "schema_version",
+    "generated_at",
+    "project_id",
+    "name",
+    "root",
+    "root_exists",
+    "status",
+    "memorybank_version",
+    "cli_version",
+    "engine_version",
+    "summary_path",
+    "protocol_counts",
+    "active_protocols",
+    "waiting_items",
+    "resource_summary",
+    "warnings",
+    "last_activity_at"
+  ],
+  "properties": {
+    "schema_id": { "const": "dd-flow/project-summary@1" },
+    "schema_version": { "const": "1.0.0" },
+    "generated_at": { "type": "string", "minLength": 1 },
+    "project_id": { "type": "string", "minLength": 1 },
+    "name": { "type": "string", "minLength": 1 },
+    "root": { "type": "string", "minLength": 1 },
+    "root_exists": { "type": "boolean" },
+    "status": { "type": "string", "minLength": 1 },
+    "memorybank_version": { "type": ["string", "null"] },
+    "memorybank_status": { "type": "string" },
+    "flow_pack_status": { "type": "string" },
+    "required_engine_range": { "type": ["string", "null"] },
+    "cli_version": { "type": "string", "minLength": 1 },
+    "engine_version": { "type": ["string", "null"] },
+    "engine_status": { "type": "string" },
+    "summary_path": { "type": "string", "minLength": 1 },
+    "dashboard_path": { "type": "string" },
+    "protocol_counts": {
+      "type": "object",
+      "required": ["active", "waiting", "done", "total"],
+      "additionalProperties": true,
+      "properties": {
+        "active": { "type": "integer", "minimum": 0 },
+        "waiting": { "type": "integer", "minimum": 0 },
+        "done": { "type": "integer", "minimum": 0 },
+        "total": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "active_protocols": { "type": "array" },
+    "waiting_items": { "type": "array" },
+    "resource_summary": {
+      "type": "object",
+      "required": ["queue", "locks", "waiters", "sessions", "open_defs"],
+      "additionalProperties": true,
+      "properties": {
+        "queue": { "type": "integer", "minimum": 0 },
+        "locks": { "type": "integer", "minimum": 0 },
+        "waiters": { "type": "integer", "minimum": 0 },
+        "sessions": { "type": "integer", "minimum": 0 },
+        "open_defs": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "warnings": { "type": "array" },
+    "last_activity_at": { "type": "string", "minLength": 1 }
+  }
+}

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

@@ -4,7 +4,7 @@
   "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"],
+  "required": ["schema_id", "generated_at", "target_language", "page", "project", "protocol", "resource", "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" },
@@ -14,17 +14,23 @@
     "protocol": {
       "type": "object",
       "additionalProperties": true,
-      "required": ["id", "short_id", "raw_status", "raw_stage", "display_status", "action_level", "updated_at"],
+      "required": ["id", "short_id", "lifecycle", "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 },
+        "lifecycle": { "$ref": "#/definitions/lifecycle" },
+        "lifecycle_stage": { "type": "string" },
+        "lifecycle_status": { "type": "string" },
         "display_status": { "type": "string", "minLength": 1 },
         "action_level": { "type": "string", "enum": ["none", "watch", "actionable", "blocked"] },
         "updated_at": { "type": "string", "minLength": 1 }
       }
     },
+    "resource": { "type": "object", "additionalProperties": true },
+    "queue_item": { "type": ["object", "null"], "additionalProperties": true },
+    "claim": { "type": ["object", "null"], "additionalProperties": true },
     "links": { "type": "object", "additionalProperties": { "$ref": "#/definitions/link" } },
     "primary_run_id": { "type": ["string", "null"] },
     "primary_run_reason": { "type": "string" },
@@ -84,6 +90,23 @@
         "display_status": { "type": "string", "minLength": 1 },
         "stages": { "type": "array" }
       }
+    },
+    "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"] }
+      }
     }
   }
 }

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

@@ -135,13 +135,14 @@
     "flowPack": {
       "type": ["object", "null"],
       "additionalProperties": true,
-      "required": ["manifest_path", "schema_id", "pack_version", "source_commit", "canon_version_at_source_commit", "status", "canonical_only_files"],
+      "required": ["manifest_path", "schema_id", "pack_version", "source_commit", "canon_version_at_source_commit", "flow_contract", "status", "canonical_only_files"],
       "properties": {
         "manifest_path": { "type": ["string", "null"] },
         "schema_id": { "type": ["string", "null"] },
         "pack_version": { "type": ["string", "null"] },
         "source_commit": { "type": ["string", "null"] },
         "canon_version_at_source_commit": { "type": ["string", "null"] },
+        "flow_contract": { "type": ["string", "null"] },
         "status": { "type": "string", "enum": ["present", "missing", "invalid", "degraded"] },
         "reason": { "type": "string" },
         "canonical_only_files": {
@@ -153,10 +154,11 @@
     "drift": {
       "type": ["object", "null"],
       "additionalProperties": true,
-      "required": ["memory_bank_version", "flow_pack_commit", "overall", "next_action"],
+      "required": ["memory_bank_version", "flow_pack_commit", "flow_contract", "overall", "next_action"],
       "properties": {
         "memory_bank_version": { "$ref": "#/definitions/comparison" },
         "flow_pack_commit": { "$ref": "#/definitions/comparison" },
+        "flow_contract": { "$ref": "#/definitions/comparison" },
         "overall": {
           "type": "string",
           "enum": ["same", "behind", "ahead", "diverged", "missing", "invalid", "unknown", "not_applicable"]