@deksden-com/dd-flow-cli 0.9.0-beta.16 → 0.9.0-beta.160

package/dist/schemas/execution-settings.schema.json

@@ -0,0 +1,162 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/execution-settings@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "flow_id",
+    "descriptor_sha256",
+    "execution",
+    "attached_session_receipt",
+    "stage_session_mode",
+    "delegation",
+    "profiles",
+    "root_profile",
+    "stage_profiles",
+    "work_profiles"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "dd-flow/execution-settings@1"
+    },
+    "flow_id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]{0,47}$"
+    },
+    "descriptor_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "execution": {
+      "enum": [
+        "managed",
+        "attached"
+      ]
+    },
+    "attached_session_receipt": {
+      "anyOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "sha256"
+          ],
+          "properties": {
+            "path": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9_-][a-zA-Z0-9_.-]*(/[a-zA-Z0-9_-][a-zA-Z0-9_.-]*)*$"
+            },
+            "sha256": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "stage_session_mode": {
+      "enum": [
+        "new_session",
+        "same_session"
+      ]
+    },
+    "delegation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "max_parallel",
+        "native_capacity_receipt"
+      ],
+      "properties": {
+        "mode": {
+          "enum": [
+            "external",
+            "native"
+          ]
+        },
+        "max_parallel": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 256
+        },
+        "native_capacity_receipt": {
+          "anyOf": [
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": [
+                "path",
+                "sha256"
+              ],
+              "properties": {
+                "path": {
+                  "type": "string",
+                  "pattern": "^[a-zA-Z0-9_-][a-zA-Z0-9_.-]*(/[a-zA-Z0-9_-][a-zA-Z0-9_.-]*)*$"
+                },
+                "sha256": {
+                  "type": "string",
+                  "pattern": "^[a-f0-9]{64}$"
+                }
+              }
+            },
+            {
+              "type": "null"
+            }
+          ]
+        }
+      }
+    },
+    "profiles": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "revision"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+          },
+          "revision": {
+            "type": "string",
+            "pattern": "^[a-f0-9]{64}$"
+          }
+        }
+      }
+    },
+    "root_profile": {
+      "type": "string",
+      "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+    },
+    "stage_profiles": {
+      "type": "object",
+      "propertyNames": {
+        "type": "string",
+        "pattern": "^[a-z][a-z0-9-]{0,47}$"
+      },
+      "additionalProperties": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+      }
+    },
+    "work_profiles": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "string",
+        "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$"
+      },
+      "uniqueItems": true
+    }
+  }
+}

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

@@ -0,0 +1,54 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/flow-descriptor@1",
+  "title": "Generic flow declaration; contextual admission is additionally required",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "id", "version", "origin", "entry_stage", "terminal_stages", "stages", "edges"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/flow-descriptor@1"},
+    "id": {"$ref": "#/$defs/id"},
+    "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
+    "origin": {"enum": ["canon", "project"]},
+    "entry_stage": {"$ref": "#/$defs/id"},
+    "terminal_stages": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"$ref": "#/$defs/id"}},
+    "stages": {
+      "type": "array", "minItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "directory", "entry_handler", "finish_handler", "instruction", "result_schema"],
+        "properties": {
+          "id": {"$ref": "#/$defs/id"},
+          "directory": {"type": "string", "pattern": "^[a-z0-9][a-z0-9-]*$"},
+          "entry_handler": {"$ref": "#/$defs/id"},
+          "finish_handler": {"$ref": "#/$defs/id"},
+          "instruction": {"$ref": "#/$defs/blob"},
+          "result_schema": {"$ref": "#/$defs/blob"}
+        }
+      }
+    },
+    "edges": {
+      "type": "array", "uniqueItems": true,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["from", "to", "on"],
+        "properties": {
+          "from": {"$ref": "#/$defs/id"},
+          "to": {"$ref": "#/$defs/id"},
+          "on": {"enum": ["accepted", "not-applicable", "needs_repair"]}
+        }
+      }
+    }
+  },
+  "$defs": {
+    "id": {"type": "string", "pattern": "^[a-z][a-z0-9-]{0,47}$"},
+    "blob": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "sha256"],
+      "properties": {
+        "path": {"type": "string", "pattern": "^[a-zA-Z0-9_-][a-zA-Z0-9_.-]*(/[a-zA-Z0-9_-][a-zA-Z0-9_.-]*)*$"},
+        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+      }
+    }
+  }
+}

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

@@ -12,6 +12,35 @@
     "project": {"$ref": "#/definitions/identity"},
     "subject": {"$ref": "#/definitions/identity"},
     "flow_kind": {"type": "string", "minLength": 1},
+    "start_request": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_id", "request_id", "request_sha256", "allocation_sha256"],
+      "properties": {
+        "schema_id": {"const": "dd-flow/run-start-request@1"},
+        "request_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,95}$"},
+        "request_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "allocation_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "publication_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+      }
+    },
+    "workspace_route": {
+      "type": "object", "additionalProperties": false, "required": ["revision", "sha256"],
+      "properties": {"revision": {"type": "integer", "minimum": 1}, "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}}
+    },
+    "execution_bundle": {
+      "type": "object", "additionalProperties": false,
+      "required": ["schema_id", "manifest_sha256", "descriptor_sha256", "admission_sha256", "flow_id"],
+      "properties": {
+        "schema_id": {"const": "dd-flow/run-execution-bundle@1"},
+        "manifest_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "descriptor_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "admission_sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+        "flow_id": {"type": "string", "minLength": 1}
+      }
+    },
+    "verification_matrix_contract": {"const": "dd-flow/verification-matrix@1"},
+    "accepted_intent_contract": {"const": "dd-flow/accepted-intent@1"},
+    "final_check_coverage_contract": {"const": "dd-flow/final-check-coverage@1"},
     "status": {"enum": ["created", "running", "paused", "waiting_for_user", "done", "failed", "blocked", "cancelled", "discarded"]},
     "verdict": {"type": ["string", "null"]},
     "started_at": {"type": "string", "format": "date-time"},

package/dist/schemas/harness-catalog.schema.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/harness-catalog@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "version",
+    "entries"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "dd-flow/harness-catalog@1"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$"
+    },
+    "entries": {
+      "type": "array",
+      "minItems": 6,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "executable_candidates",
+          "probe_module",
+          "probe_timeout_ms",
+          "version_range",
+          "protocol_version"
+        ],
+        "properties": {
+          "id": {
+            "enum": [
+              "codex",
+              "zcode",
+              "agy",
+              "opencode",
+              "grok",
+              "droid"
+            ]
+          },
+          "executable_candidates": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "pattern": "^[a-zA-Z0-9][a-zA-Z0-9._-]*$"
+            },
+            "uniqueItems": true
+          },
+          "probe_module": {
+            "enum": [
+              "codex-discovery",
+              "zcode-discovery",
+              "agy-discovery",
+              "opencode-discovery",
+              "grok-discovery",
+              "droid-discovery"
+            ]
+          },
+          "probe_timeout_ms": {
+            "type": "integer",
+            "minimum": 1,
+            "maximum": 30000
+          },
+          "version_range": {
+            "type": "string",
+            "minLength": 1
+          },
+          "protocol_version": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  }
+}

package/dist/schemas/interactive-stage-result.schema.json

@@ -0,0 +1,47 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/interactive-stage-result@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "flow_id", "run_id", "stage", "input_sha256", "baseline_sha256", "user_inputs_sha256", "scope_revision", "file_changes_sha256", "work_collection_sha256", "summary", "predecessors", "details"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/interactive-stage-result@1" },
+    "flow_id": { "const": "interactive" },
+    "run_id": { "type": "string", "pattern": "^RUN-[0-9]+-[a-z0-9-]+$" },
+    "stage": { "enum": ["preflight", "interactive", "consolidation", "hardening", "review", "integration"] },
+    "input_sha256": { "$ref": "#/$defs/digest" },
+    "baseline_sha256": { "$ref": "#/$defs/digest" },
+    "user_inputs_sha256": { "$ref": "#/$defs/digest" },
+    "scope_revision": { "$ref": "#/$defs/digest" },
+    "file_changes_sha256": { "$ref": "#/$defs/digest" },
+    "work_collection_sha256": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }] },
+    "summary": { "$ref": "#/$defs/text" },
+    "predecessors": {
+      "type": "array", "maxItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["stage", "path", "sha256"],
+        "properties": {
+          "stage": { "enum": ["preflight", "interactive", "consolidation", "hardening", "review"] },
+          "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\\u0000]+$" },
+          "sha256": { "$ref": "#/$defs/digest" }
+        }
+      }
+    },
+    "details": {
+      "type": "object", "additionalProperties": false, "required": ["change_summary", "review", "limitations"],
+      "properties": {
+        "change_summary": { "$ref": "#/$defs/text" },
+        "review": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/review" }] },
+        "limitations": { "type": "array", "maxItems": 4096, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+      }
+    }
+  },
+  "$defs": {
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "text": { "type": "string", "minLength": 1, "maxLength": 16384, "pattern": "^[^\\u0000]+$" },
+    "review": {
+      "type": "object", "additionalProperties": false, "required": ["verdict", "summary"],
+      "properties": { "verdict": { "enum": ["accept", "revise"] }, "summary": { "$ref": "#/$defs/text" } }
+    }
+  }
+}

package/dist/schemas/interactive-work-result.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/interactive-work-result@1",
+  "type": "object", "additionalProperties": false,
+  "required": ["schema_id", "run_id", "work_id", "stage", "packet_sha256", "verdict", "summary", "changes", "checks", "issues", "limitations"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/interactive-work-result@1" },
+    "run_id": { "type": "string", "pattern": "^RUN-[0-9]+-[a-z0-9-]+$" },
+    "work_id": { "type": "string", "minLength": 1, "maxLength": 200 },
+    "stage": { "enum": ["hardening", "review"] },
+    "packet_sha256": { "$ref": "#/$defs/digest" },
+    "verdict": { "enum": ["ready", "needs_work", "blocked"] },
+    "summary": { "$ref": "#/$defs/text" },
+    "changes": {
+      "type": "array", "maxItems": 20000,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["path", "before_sha256", "after_sha256"],
+        "dependentRequired": { "before_mode": ["after_mode"], "after_mode": ["before_mode"] },
+        "properties": { "path": { "$ref": "#/$defs/path" }, "before_sha256": { "$ref": "#/$defs/nullable_digest" }, "after_sha256": { "$ref": "#/$defs/nullable_digest" },
+          "before_mode": { "$ref": "#/$defs/mode" }, "after_mode": { "$ref": "#/$defs/mode" } }
+      }
+    },
+    "checks": { "type": "array", "maxItems": 4096, "items": { "$ref": "#/$defs/run_reference" } },
+    "issues": {
+      "type": "array", "maxItems": 4096,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["id", "severity", "summary", "evidence"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 200, "pattern": "^[^\\u0000]+$" },
+          "severity": { "enum": ["critical", "major", "minor"] },
+          "summary": { "$ref": "#/$defs/text" },
+          "evidence": { "type": "array", "minItems": 1, "maxItems": 4096, "items": { "$ref": "#/$defs/reference" } }
+        }
+      }
+    },
+    "issue_decisions": {
+      "type": "array", "maxItems": 4096,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["work_id", "issue_id", "outcome", "summary", "evidence"],
+        "properties": {
+          "work_id": { "type": "string", "minLength": 1, "maxLength": 200 },
+          "issue_id": { "type": ["string", "null"], "minLength": 1, "maxLength": 200, "pattern": "^[^\\u0000]+$" },
+          "outcome": { "enum": ["resolved", "still_open", "not_applicable"] },
+          "summary": { "$ref": "#/$defs/text" },
+          "evidence": { "type": "array", "minItems": 1, "maxItems": 4096, "items": { "$ref": "#/$defs/reference" } }
+        }
+      }
+    },
+    "limitations": { "type": "array", "maxItems": 4096, "uniqueItems": true, "items": { "$ref": "#/$defs/text" } }
+  },
+  "$defs": {
+    "mode": { "type": ["integer", "null"], "minimum": 0, "maximum": 4095 },
+    "digest": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "nullable_digest": { "oneOf": [{ "type": "null" }, { "$ref": "#/$defs/digest" }] },
+    "text": { "type": "string", "minLength": 1, "maxLength": 16384, "pattern": "^[^\\u0000]+$" },
+    "path": { "type": "string", "minLength": 1, "maxLength": 4096, "pattern": "^(?!/)(?!.*(?:^|/)\\.\\.(?:/|$))[^\\\\\\u0000]+$" },
+    "reference": {
+      "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+      "properties": { "root": { "enum": ["run", "workspace"] }, "path": { "$ref": "#/$defs/path" }, "sha256": { "$ref": "#/$defs/digest" } }
+    },
+    "run_reference": { "allOf": [{ "$ref": "#/$defs/reference" }, { "type": "object", "properties": { "root": { "const": "run" } } }] }
+  }
+}

package/dist/schemas/mb-fix-stage-result.schema.json

@@ -0,0 +1,93 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/mb-fix-stage-result@1",
+  "title": "Selected Memory Bank repair result; claims require independent CLI custody",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "flow_id", "run_id", "stage", "input_sha256", "intake_sha256", "source_observation_sha256", "summary", "predecessors", "details"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/mb-fix-stage-result@1"},
+    "flow_id": {"const": "mb-fix"},
+    "run_id": {"type": "string", "pattern": "^RUN-[0-9]+-[a-z0-9-]+$"},
+    "stage": {"enum": ["intake", "repair", "verify", "review", "finish"]},
+    "input_sha256": {"$ref": "#/$defs/hash"},
+    "intake_sha256": {"$ref": "#/$defs/hash"},
+    "source_observation_sha256": {"$ref": "#/$defs/hash"},
+    "summary": {"$ref": "#/$defs/text"},
+    "predecessors": {
+      "type": "array", "maxItems": 1,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["stage", "path", "sha256"],
+        "properties": {"stage": {"type": "string", "minLength": 1}, "path": {"$ref": "#/$defs/path"}, "sha256": {"$ref": "#/$defs/hash"}}
+      }
+    },
+    "details": {
+      "type": "object", "additionalProperties": false,
+      "required": ["routing", "write_scope", "repair_receipt", "verification", "review", "limitations"],
+      "properties": {
+        "routing": {
+          "type": "array", "minItems": 1, "maxItems": 4096,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["finding_id", "route", "reason", "write_paths"],
+            "properties": {
+              "finding_id": {"type": "string", "minLength": 1, "maxLength": 256},
+              "route": {"enum": ["memory_repair", "review_fix", "upgrade", "defer"]},
+              "reason": {"$ref": "#/$defs/text"},
+              "write_paths": {"type": "array", "maxItems": 512, "uniqueItems": true, "items": {"$ref": "#/$defs/path"}}
+            }
+          }
+        },
+        "write_scope": {
+          "oneOf": [{"type": "null"}, {
+            "type": "object", "additionalProperties": false,
+            "required": ["finding_ids", "paths", "approval_source", "user_inputs_sha256"],
+            "properties": {
+              "finding_ids": {"type": "array", "minItems": 1, "maxItems": 4096, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+              "paths": {"type": "array", "minItems": 1, "maxItems": 512, "uniqueItems": true, "items": {"$ref": "#/$defs/path"}},
+              "approval_source": {"$ref": "#/$defs/artifact"},
+              "user_inputs_sha256": {"$ref": "#/$defs/hash"}
+            }
+          }]
+        },
+        "repair_receipt": {"oneOf": [{"type": "null"}, {"$ref": "#/$defs/artifact"}]},
+        "verification": {
+          "type": "array", "maxItems": 4096,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["finding_id", "verdict", "summary", "evidence"],
+            "properties": {"finding_id": {"type": "string", "minLength": 1}, "verdict": {"enum": ["resolved", "unresolved"]},
+              "summary": {"$ref": "#/$defs/text"}, "evidence": {"$ref": "#/$defs/evidence"}}
+          }
+        },
+        "review": {
+          "type": "array", "maxItems": 4096,
+          "items": {
+            "type": "object", "additionalProperties": false,
+            "required": ["finding_id", "disposition", "summary", "evidence"],
+            "properties": {"finding_id": {"type": "string", "minLength": 1}, "disposition": {"enum": ["accept", "reopen"]},
+              "summary": {"$ref": "#/$defs/text"}, "evidence": {"$ref": "#/$defs/evidence"}}
+          }
+        },
+        "limitations": {"type": "array", "maxItems": 4096, "items": {"$ref": "#/$defs/text"}}
+      }
+    }
+  },
+  "$defs": {
+    "hash": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "path": {"type": "string", "minLength": 1, "maxLength": 4096},
+    "text": {"type": "string", "minLength": 1, "maxLength": 16000},
+    "artifact": {
+      "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+      "properties": {"root": {"const": "run"}, "path": {"$ref": "#/$defs/path"}, "sha256": {"$ref": "#/$defs/hash"}}
+    },
+    "evidence": {
+      "type": "array", "maxItems": 512,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+        "properties": {"root": {"enum": ["project", "run"]}, "path": {"$ref": "#/$defs/path"}, "sha256": {"$ref": "#/$defs/hash"}}
+      }
+    }
+  }
+}