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

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

@@ -0,0 +1,203 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/flow-run-index@3",
+  "title": "dd-flow run index v3",
+  "description": "Compact, privacy-safe navigation projection for one flow RUN.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "run_id",
+    "short_id",
+    "flow_kind",
+    "subject",
+    "project",
+    "workspace",
+    "stage_runs",
+    "sessions",
+    "artifacts",
+    "status",
+    "verdict",
+    "next_action",
+    "created_at",
+    "updated_at",
+    "started_at",
+    "timing_status",
+    "runtime_revision",
+    "snapshot_revision",
+    "snapshot_checksum",
+    "reconciliation_status",
+    "flow_flags"
+  ],
+  "properties": {
+    "schema_id": { "const": "dd-flow/flow-run-index@3" },
+    "run_id": { "type": "string", "pattern": "^RUN-[0-9]{3}-[a-z0-9]+(?:-[a-z0-9]+)*$" },
+    "short_id": { "type": "string", "pattern": "^RUN-[0-9]{3}$" },
+    "flow_kind": { "type": "string", "minLength": 1 },
+    "subject": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "id"],
+      "properties": { "type": { "type": "string", "minLength": 1 }, "id": { "type": "string", "minLength": 1 } }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "root"],
+      "properties": { "id": { "type": "string", "minLength": 1 }, "root": { "type": "string", "minLength": 1 } }
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["root", "run_dir"],
+      "properties": { "root": { "type": "string", "minLength": 1 }, "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 },
+        "git": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["branch", "head"],
+          "properties": { "branch": { "type": ["string", "null"] }, "head": { "type": ["string", "null"] } }
+        }
+      }
+    },
+    "legacy": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": { "project_tasks_run_dir": { "type": ["string", "null"] } }
+    },
+    "stage_runs": { "type": "array", "items": { "$ref": "#/definitions/stageRun" } },
+    "sessions": { "type": "array", "items": { "$ref": "#/definitions/session" } },
+    "artifacts": { "type": "array", "items": { "type": "object" } },
+    "status": { "type": "string", "enum": ["running", "done", "blocked", "cancelled", "failed"] },
+    "verdict": { "type": "string", "minLength": 1 },
+    "next_action": { "type": ["string", "null"] },
+    "created_at": { "type": "string", "format": "date-time" },
+    "updated_at": { "type": "string", "format": "date-time" },
+    "started_at": { "type": "string", "format": "date-time" },
+    "completed_at": { "type": "string", "format": "date-time" },
+    "timing_status": { "enum": ["measured", "legacy_incomplete"] },
+    "runtime_revision": { "type": "integer", "minimum": 1 },
+    "snapshot_revision": { "type": "integer", "minimum": 1 },
+    "snapshot_checksum": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "reconciliation_status": { "enum": ["reconciled", "reconciliation_required", "legacy_incomplete"] },
+    "flow_flags": { "$ref": "#/definitions/flowFlags" }
+  },
+  "definitions": {
+    "stageRun": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["order", "stage", "dir", "status", "updated_at"],
+      "properties": {
+        "order": { "type": "integer", "minimum": 1 },
+        "stage": { "type": "string", "minLength": 1 },
+        "dir": { "type": "string", "pattern": "^[0-9]{2}-[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "status": { "enum": ["pending", "running", "done", "blocked", "skipped", "failed"] },
+        "stage_report": { "type": "string", "minLength": 1 },
+        "dashboard": { "type": "string", "minLength": 1 },
+        "data": { "type": "string", "minLength": 1 },
+        "data_schema_id": { "type": "string", "minLength": 1 },
+        "report": { "type": "string", "minLength": 1 },
+        "artifact_aliases": { "type": "array", "items": { "type": "string", "minLength": 1 } },
+        "updated_at": { "type": "string", "format": "date-time" },
+        "started_at": { "type": "string", "format": "date-time" },
+        "completed_at": { "type": "string", "format": "date-time" },
+        "attempt": { "type": "string", "pattern": "^try-[0-9]{3}$" }
+      }
+    },
+    "session": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["session_id", "status", "created_at", "updated_at", "coverage_units"],
+      "properties": {
+        "session_id": { "type": "string", "minLength": 1 },
+        "parent_session_id": { "type": ["string", "null"] },
+        "role": { "type": ["string", "null"] },
+        "session_kind": { "type": ["string", "null"] },
+        "worker_id": { "type": ["string", "null"] },
+        "current_stage": { "type": ["string", "null"] },
+        "status": { "type": "string", "minLength": 1 },
+        "created_at": { "type": "string", "format": "date-time" },
+        "updated_at": { "type": "string", "format": "date-time" },
+        "stopped_at": { "type": ["string", "null"], "format": "date-time" },
+        "coverage_units": { "type": "array", "items": { "$ref": "#/definitions/coverageUnit" } }
+      }
+    },
+    "coverageUnit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["unit_id"],
+      "properties": {
+        "unit_id": { "type": "string", "minLength": 1 },
+        "group_id": { "type": ["string", "null"] },
+        "job_id": { "type": ["string", "null"] },
+        "kind": { "type": ["string", "null"] }
+      }
+    },
+    "flowFlags": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["contract", "flow_kind", "snapshot_revision", "resolution_status", "values", "snapshot_checksum"],
+      "properties": {
+        "contract": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "version"],
+          "properties": { "id": { "type": "string" }, "version": { "type": "integer", "minimum": 1 }, "capabilities": { "type": "array", "items": { "type": "string" } } }
+        },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "preset": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["requested", "applied", "source_ref"],
+          "properties": {
+            "requested": { "type": ["string", "null"] },
+            "applied": { "type": "string", "minLength": 1 },
+            "source_ref": { "type": "string", "minLength": 1 }
+          }
+        },
+        "snapshot_revision": { "type": "integer", "minimum": 1 },
+        "resolution_status": { "enum": ["valid", "legacy_incomplete", "reconciliation_required"] },
+        "values": { "type": "object", "additionalProperties": { "$ref": "#/definitions/flagValue" } },
+        "snapshot_checksum": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "compatibility_projection": { "type": "object" },
+        "resolved_at": { "type": "string", "format": "date-time" },
+        "floors_applied": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "flagValue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["value", "value_type", "owner", "source", "rationale", "resolved_at"],
+      "properties": {
+        "value": {},
+        "value_type": { "type": "string" },
+        "owner": { "type": "string" },
+        "source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "ref"],
+          "properties": { "kind": { "type": "string" }, "ref": { "type": "string" }, "revision": { "type": ["integer", "null"] } }
+        },
+        "rationale": { "type": "string" },
+        "resolved_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

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

@@ -81,7 +81,16 @@
       "required": ["project_root", "workspace_root"],
       "properties": {
         "project_root": { "type": "string", "minLength": 1 },
-        "workspace_root": { "type": "string", "minLength": 1 }
+        "workspace_root": { "type": "string", "minLength": 1 },
+        "git": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["branch", "head"],
+          "properties": {
+            "branch": { "type": ["string", "null"] },
+            "head": { "type": ["string", "null"] }
+          }
+        }
       }
     },
     "legacy": {
@@ -123,6 +132,14 @@
     "completed_at": {
       "type": "string",
       "minLength": 1
+    },
+    "started_at": {
+      "type": "string",
+      "minLength": 1
+    },
+    "timing_status": {
+      "type": "string",
+      "enum": ["measured", "legacy_incomplete"]
     }
   },
   "definitions": {
@@ -148,7 +165,10 @@
           "type": "array",
           "items": { "type": "string", "minLength": 1 }
         },
-        "updated_at": { "type": "string", "minLength": 1 }
+        "updated_at": { "type": "string", "minLength": 1 },
+        "started_at": { "type": "string", "minLength": 1 },
+        "completed_at": { "type": "string", "minLength": 1 },
+        "attempt": { "type": "string", "pattern": "^try-[0-9]{3}$" }
       }
     }
   }

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

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "dd-flow/flow-run@1",
+  "title": "dd-flow runtime snapshot",
+  "description": "Continuation/runtime authority for one RUN; navigation is projected separately to flow-run-index@3.",
+  "type": "object",
+  "additionalProperties": true,
+  "required": ["schema_id", "run_index_schema_id", "run_id", "runtime_revision", "snapshot_revision", "snapshot_checksum", "flow_flags"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/flow-run@1" },
+    "run_index_schema_id": { "type": "string" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "runtime_revision": { "type": "integer", "minimum": 1 },
+    "snapshot_revision": { "type": "integer", "minimum": 1 },
+    "snapshot_checksum": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "flow_flags": { "$ref": "#/definitions/flowFlags" },
+    "flag_revision_history": { "type": "array", "maxItems": 32, "items": { "type": "object" } }
+  },
+  "definitions": {
+    "flowFlags": {
+      "type": "object",
+      "required": ["contract", "flow_kind", "snapshot_revision", "resolution_status", "values", "snapshot_checksum"],
+      "properties": {
+        "contract": { "type": "object" },
+        "flow_kind": { "type": "string" },
+        "preset": { "type": "object" },
+        "snapshot_revision": { "type": "integer", "minimum": 1 },
+        "resolution_status": { "type": "string" },
+        "values": { "type": "object" },
+        "snapshot_checksum": { "type": "string" },
+        "compatibility_projection": { "type": "object" },
+        "floors_applied": { "type": "array", "items": { "type": "string" } }
+      }
+    }
+  }
+}

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

@@ -1,9 +1,49 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "dd-flow/merge-stage-report@1",
+  "$id": "dd-flow/merge-stage-report@2",
   "title": "Merge stage report data",
   "type": "object",
   "additionalProperties": true,
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "schema_id": { "const": "dd-flow/merge-stage-report@2" },
+          "overall": {
+            "properties": {
+              "verdict": { "const": "merged" }
+            },
+            "required": ["verdict"]
+          }
+        },
+        "required": ["schema_id", "overall"]
+      },
+      "then": {
+        "required": ["operational_access"],
+        "properties": {
+          "operational_access": { "properties": { "outcome": { "enum": ["authorized", "not_required"] } } },
+          "git": {
+            "properties": {
+              "result_commit": { "$ref": "#/definitions/realCommitEvidence" }
+            }
+          },
+          "integration": {
+            "required": ["result_commit"],
+            "properties": {
+              "result_commit": { "$ref": "#/definitions/realCommitEvidence" }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": { "schema_id": { "const": "dd-flow/merge-stage-report@2" } },
+        "required": ["schema_id"]
+      },
+      "then": { "required": ["flow_flags"] }
+    }
+  ],
   "required": [
     "schema_id",
     "run",
@@ -24,12 +64,14 @@
     "defs"
   ],
   "properties": {
-    "schema_id": { "const": "dd-flow/merge-stage-report@1" },
+    "schema_id": { "enum": ["dd-flow/merge-stage-report@1", "dd-flow/merge-stage-report@2"] },
     "run": { "$ref": "#/definitions/run" },
     "stage": { "$ref": "#/definitions/stage" },
     "project": { "$ref": "#/definitions/namedEntity" },
     "subject": { "$ref": "#/definitions/namedEntity" },
+    "flow_flags": { "$ref": "#/definitions/flowFlags" },
     "overall": { "$ref": "#/definitions/overall" },
+    "operational_access": { "$ref": "#/definitions/operationalAccess" },
     "breadcrumbs": {
       "type": "array",
       "items": { "$ref": "#/definitions/breadcrumb" }
@@ -113,6 +155,8 @@
       "type": "array",
       "items": { "$ref": "#/definitions/check" }
     },
+    "policy_context": { "$ref": "#/definitions/policyContext" },
+    "sdlc_contours": { "$ref": "#/definitions/sdlcContours" },
     "cleanup": {
       "type": "array",
       "items": { "$ref": "#/definitions/check" }
@@ -120,9 +164,74 @@
     "defs": {
       "type": "array",
       "items": { "$ref": "#/definitions/deferral" }
+    },
+    "knowledge_promotion": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": [
+        "status",
+        "summary",
+        "source_candidates",
+        "candidate_results",
+        "code_derived",
+        "durable_writes",
+        "deferred_defs",
+        "blocked_promotions"
+      ],
+      "properties": {
+        "status": {
+          "type": "string",
+          "enum": ["passed", "not_applicable", "degraded", "blocked"]
+        },
+        "summary": { "type": "string", "minLength": 1 },
+        "report_path": { "type": "string" },
+        "source_candidates": { "type": "string" },
+        "candidate_results": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 0 }
+        },
+        "code_derived": {
+          "type": "object",
+          "additionalProperties": { "type": "integer", "minimum": 0 }
+        },
+        "durable_writes": { "type": "integer", "minimum": 0 },
+        "deferred_defs": { "type": "integer", "minimum": 0 },
+        "blocked_promotions": { "type": "integer", "minimum": 0 }
+      }
     }
   },
   "definitions": {
+    "operationalAccess": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["schema_id", "applicability", "outcome", "verdicts", "next_action"],
+      "properties": {
+        "schema_id": { "const": "dd-flow/operational-access-preflight@1" },
+        "applicability": { "type": "string", "enum": ["required", "not_required"] },
+        "outcome": { "type": "string", "enum": ["authorized", "authorization_required", "identity_mismatch", "target_mismatch", "insufficient_authority", "approval_required", "blocked", "failed", "not_required"] },
+        "verdicts": {
+          "type": "object",
+          "required": ["identity", "authority", "target", "approval"],
+          "properties": {
+            "identity": { "type": "string", "enum": ["verified", "mismatch", "not_observable", "not_required"] },
+            "authority": { "type": "string", "enum": ["verified", "mismatch", "not_observable", "not_required"] },
+            "target": { "type": "string", "enum": ["verified", "mismatch", "not_observable", "not_required"] },
+            "approval": { "type": "string", "enum": ["verified", "missing", "stale", "revoked", "scope_mismatch", "not_observable", "not_required"] }
+          }
+        },
+        "next_action": { "type": "string", "minLength": 1 }
+      },
+      "allOf": [
+        {
+          "if": { "properties": { "outcome": { "const": "authorized" } }, "required": ["outcome"] },
+          "then": { "properties": { "applicability": { "const": "required" }, "verdicts": { "properties": { "identity": { "const": "verified" }, "authority": { "enum": ["verified", "not_required"] }, "target": { "const": "verified" }, "approval": { "enum": ["verified", "not_required"] } } } } }
+        },
+        {
+          "if": { "properties": { "outcome": { "const": "not_required" } }, "required": ["outcome"] },
+          "then": { "properties": { "applicability": { "const": "not_required" }, "verdicts": { "properties": { "identity": { "const": "not_required" }, "authority": { "const": "not_required" }, "target": { "const": "not_required" }, "approval": { "const": "not_required" } } } } }
+        }
+      ]
+    },
     "run": {
       "type": "object",
       "additionalProperties": true,
@@ -190,6 +299,108 @@
         "status": { "type": "string", "minLength": 1 },
         "summary": { "type": "string", "minLength": 1 }
       }
+    },
+    "sdlcContours": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "summary": { "type": "string" },
+        "contours": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/sdlcContour" }
+        },
+        "policy_migration": { "type": "string" },
+        "next_delivery_action": { "type": "string" }
+      }
+    },
+    "sdlcContour": {
+      "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" }
+      }
+    },
+    "realCommitEvidence": {
+      "type": "string",
+      "minLength": 1,
+      "not": {
+        "pattern": "^(pending.*|todo|not_yet|none|n/a|N/A)$"
+      }
+    },
+    "policyContext": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["sources", "git", "checks", "delivery", "gaps"],
+      "properties": {
+        "sources": { "type": "object", "additionalProperties": true },
+        "git": {
+          "type": "object",
+          "additionalProperties": true,
+          "properties": {
+            "workspace_route": { "type": "string" },
+            "delivery_strategy": {
+              "type": "string",
+              "enum": ["direct_commit", "direct_commit_push", "feature_merge", "pull_request", "merge_queue", "squash_merge", "rebase_ff", "release_branch", "external_handoff", "local_only", "no_git"]
+            },
+            "fixation_required": { "type": "boolean" },
+            "result_evidence_required": { "type": "array", "items": { "type": "string" } },
+            "actual_result_evidence": { "type": "array", "items": { "type": "string" } },
+            "evidence_verdict": { "type": "string" }
+          }
+        },
+        "checks": { "type": "object", "additionalProperties": true },
+        "delivery": { "type": "object", "additionalProperties": true },
+        "gaps": { "type": "object", "additionalProperties": true }
+      }
+    },
+    "flowFlags": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["flow_kind", "snapshot_revision", "resolution_status", "values", "snapshot_checksum"],
+      "properties": {
+        "contract": { "type": "object", "additionalProperties": true },
+        "flow_kind": { "type": "string", "minLength": 1 },
+        "preset": { "type": "object", "additionalProperties": true },
+        "snapshot_revision": { "type": "integer", "minimum": 1 },
+        "resolution_status": { "type": "string", "enum": ["valid", "legacy_incomplete", "reconciliation_required"] },
+        "values": { "type": "object", "additionalProperties": { "$ref": "#/definitions/flagValue" } },
+        "snapshot_checksum": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "floors_applied": { "type": "array", "items": { "type": "string" } },
+        "resolved_at": { "type": "string", "format": "date-time" }
+      }
+    },
+    "flagValue": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["value", "value_type", "owner", "source", "rationale", "resolved_at"],
+      "properties": {
+        "value": {},
+        "value_type": { "type": "string", "minLength": 1 },
+        "owner": { "type": "string", "minLength": 1 },
+        "source": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["kind", "ref"],
+          "properties": {
+            "kind": { "type": "string", "minLength": 1 },
+            "ref": { "type": "string", "minLength": 1 },
+            "revision": { "type": ["integer", "null"] }
+          }
+        },
+        "rationale": { "type": "string", "minLength": 1 },
+        "resolved_at": { "type": "string", "format": "date-time" }
+      }
     }
   }
 }