@deksden-com/dd-flow-cli 0.9.0-beta.15 → 0.9.0-beta.151

package/dist/schemas/memory-bootstrap-receipt-v2.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-bootstrap-receipt@2",
+  "description": "Bootstrap execution readiness, not semantic Memory Bank acceptance. Unborn HEAD is explicit, never a fabricated commit.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "request_id", "flow_id", "project_root", "workspace", "baseline_sha256", "project_current", "upgrade_target", "effective_execution", "readiness", "storage", "effects"],
+  "properties": {
+    "schema_id": {"const": "dd-flow/memory-bootstrap-receipt@2"},
+    "request_id": {"type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9_.-]{0,95}$"},
+    "flow_id": {"enum": ["mb-init", "mb-upgrade"]},
+    "project_root": {"type": "string", "minLength": 1},
+    "workspace": {
+      "type": "object", "additionalProperties": false,
+      "required": ["path", "repository", "branch", "commit", "git_state"],
+      "properties": {
+        "path": {"type": "string", "minLength": 1},
+        "repository": {"type": "string", "minLength": 1},
+        "branch": {"type": "string", "minLength": 1},
+        "commit": {"anyOf": [{"type": "string", "pattern": "^[a-f0-9]{40}$"}, {"type": "null"}]},
+        "git_state": {"enum": ["unborn", "committed"]}
+      },
+      "allOf": [
+        {"if": {"properties": {"git_state": {"const": "unborn"}}}, "then": {"properties": {"commit": {"type": "null"}}}},
+        {"if": {"properties": {"git_state": {"const": "committed"}}}, "then": {"properties": {"commit": {"type": "string", "pattern": "^[a-f0-9]{40}$"}}}}
+      ]
+    },
+    "baseline_sha256": {"$ref": "#/$defs/digest"},
+    "project_current": {"anyOf": [{"$ref": "#/$defs/pack"}, {"type": "null"}]},
+    "upgrade_target": {"$ref": "#/$defs/pack"},
+    "effective_execution": {
+      "type": "object", "additionalProperties": false, "required": ["engine_sha256", "canon_sha256"],
+      "properties": {"engine_sha256": {"$ref": "#/$defs/digest"}, "canon_sha256": {"$ref": "#/$defs/digest"}}
+    },
+    "readiness": {"enum": ["ready", "blocked", "failed", "unknown"]},
+    "storage": {
+      "type": "object", "additionalProperties": false,
+      "required": ["route", "outcome", "compatibility_receipt", "drain_receipt", "backup_receipt", "plan_receipt", "apply_receipt", "verification_receipt"],
+      "properties": {
+        "route": {"enum": ["verified-no-op", "migration"]},
+        "outcome": {"enum": ["no-op", "prepared", "applied", "blocked", "failed", "unknown"]},
+        "compatibility_receipt": {"$ref": "#/$defs/receipt"},
+        "drain_receipt": {"$ref": "#/$defs/optionalReceipt"},
+        "backup_receipt": {"$ref": "#/$defs/optionalReceipt"},
+        "plan_receipt": {"$ref": "#/$defs/optionalReceipt"},
+        "apply_receipt": {"$ref": "#/$defs/optionalReceipt"},
+        "verification_receipt": {"$ref": "#/$defs/optionalReceipt"}
+      }
+    },
+    "effects": {"type": "array", "items": {
+      "type": "object", "additionalProperties": false, "required": ["kind", "receipt"],
+      "properties": {"kind": {"enum": ["scaffold", "pack-install", "storage-apply"]}, "receipt": {"$ref": "#/$defs/receipt"}}
+    }}
+  },
+  "$defs": {
+    "digest": {"type": "string", "pattern": "^[a-f0-9]{64}$"},
+    "pack": {
+      "type": "object", "additionalProperties": false, "required": ["canon_version", "pack_sha256"],
+      "properties": {"canon_version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$"}, "pack_sha256": {"$ref": "#/$defs/digest"}}
+    },
+    "receipt": {
+      "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": {"$ref": "#/$defs/digest"}}
+    },
+    "optionalReceipt": {"anyOf": [{"$ref": "#/$defs/receipt"}, {"type": "null"}]}
+  }
+}

package/dist/schemas/memory-bootstrap-receipt.schema.json

@@ -0,0 +1,354 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-bootstrap-receipt@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "request_id",
+    "flow_id",
+    "project_root",
+    "workspace",
+    "baseline_sha256",
+    "project_current",
+    "upgrade_target",
+    "effective_execution",
+    "readiness",
+    "storage",
+    "effects"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "dd-flow/memory-bootstrap-receipt@1"
+    },
+    "request_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "flow_id": {
+      "enum": [
+        "mb-init",
+        "mb-upgrade"
+      ]
+    },
+    "project_root": {
+      "type": "string",
+      "minLength": 1
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "repository",
+        "branch",
+        "commit"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1
+        },
+        "repository": {
+          "type": "string",
+          "minLength": 1
+        },
+        "branch": {
+          "type": "string",
+          "minLength": 1
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{40}$"
+        }
+      }
+    },
+    "baseline_sha256": {
+      "type": "string",
+      "pattern": "^[a-f0-9]{64}$"
+    },
+    "project_current": {
+      "anyOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "canon_version",
+            "pack_sha256"
+          ],
+          "properties": {
+            "canon_version": {
+              "type": "string",
+              "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$"
+            },
+            "pack_sha256": {
+              "type": "string",
+              "pattern": "^[a-f0-9]{64}$"
+            }
+          }
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "upgrade_target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "canon_version",
+        "pack_sha256"
+      ],
+      "properties": {
+        "canon_version": {
+          "type": "string",
+          "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(?:-[A-Za-z0-9.-]+)?$"
+        },
+        "pack_sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "effective_execution": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "engine_sha256",
+        "canon_sha256"
+      ],
+      "properties": {
+        "engine_sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        },
+        "canon_sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "readiness": {
+      "enum": [
+        "ready",
+        "blocked",
+        "failed",
+        "unknown"
+      ]
+    },
+    "storage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "route",
+        "outcome",
+        "compatibility_receipt",
+        "drain_receipt",
+        "backup_receipt",
+        "plan_receipt",
+        "apply_receipt",
+        "verification_receipt"
+      ],
+      "properties": {
+        "route": {
+          "enum": [
+            "verified-no-op",
+            "migration"
+          ]
+        },
+        "outcome": {
+          "enum": [
+            "no-op",
+            "prepared",
+            "applied",
+            "blocked",
+            "failed",
+            "unknown"
+          ]
+        },
+        "compatibility_receipt": {
+          "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}$"
+            }
+          }
+        },
+        "drain_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"
+            }
+          ]
+        },
+        "backup_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"
+            }
+          ]
+        },
+        "plan_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"
+            }
+          ]
+        },
+        "apply_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"
+            }
+          ]
+        },
+        "verification_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"
+            }
+          ]
+        }
+      }
+    },
+    "effects": {
+      "type": "array",
+      "minItems": 0,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "kind",
+          "receipt"
+        ],
+        "properties": {
+          "kind": {
+            "enum": [
+              "scaffold",
+              "pack-install",
+              "storage-apply"
+            ]
+          },
+          "receipt": {
+            "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/memory-composition-work-result.schema.json

@@ -0,0 +1,38 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-composition-work-result@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "run_id", "work_id", "packet_sha256", "outcome", "summary", "units"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/memory-composition-work-result@1" },
+    "run_id": { "type": "string", "minLength": 1 },
+    "work_id": { "type": "string", "minLength": 1 },
+    "packet_sha256": { "$ref": "#/$defs/hash" },
+    "outcome": { "enum": ["accepted", "blocked"] },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+    "units": {
+      "type": "array", "minItems": 1, "maxItems": 256,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "summary", "artifacts"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+          "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+          "artifacts": {
+            "type": "array", "minItems": 1, "maxItems": 512,
+            "items": {
+              "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+              "properties": {
+                "root": { "enum": ["workspace", "run"] },
+                "path": { "type": "string", "minLength": 1, "maxLength": 4096 },
+                "sha256": { "$ref": "#/$defs/hash" }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "$defs": { "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }
+}

package/dist/schemas/memory-repair-work-result.schema.json

@@ -0,0 +1,56 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-repair-work-result@1",
+  "type": "object", "additionalProperties": false,
+  "required": ["schema_id", "run_id", "work_id", "packet_sha256", "wave", "outcome", "summary", "changes", "resolutions"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/memory-repair-work-result@1" },
+    "run_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "work_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "packet_sha256": { "$ref": "#/$defs/hash" },
+    "wave": { "type": "integer", "minimum": 1, "maximum": 2 },
+    "outcome": { "enum": ["accepted", "reconciled", "blocked"] },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+    "changes": {
+      "type": "array", "maxItems": 512,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["path", "before_sha256", "after_sha256"],
+        "properties": {
+          "path": { "type": "string", "minLength": 1, "maxLength": 4096 },
+          "before_sha256": { "anyOf": [{ "$ref": "#/$defs/hash" }, { "type": "null" }] },
+          "after_sha256": { "anyOf": [{ "$ref": "#/$defs/hash" }, { "type": "null" }] }
+        }
+      }
+    },
+    "resolutions": {
+      "type": "array", "maxItems": 1024,
+      "items": {
+        "type": "object", "additionalProperties": false, "required": ["finding_id", "summary", "delta_paths", "evidence"],
+        "properties": {
+          "finding_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+          "delta_paths": { "type": "array", "maxItems": 512, "uniqueItems": true, "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
+          "evidence": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/reference" } }
+        }
+      }
+    }
+  },
+  "allOf": [
+    { "if": { "properties": { "outcome": { "const": "accepted" } } },
+      "then": { "properties": { "changes": { "type": "array", "minItems": 1 }, "resolutions": { "type": "array", "minItems": 1, "items": { "type": "object", "properties": { "delta_paths": { "type": "array", "minItems": 1 } } } } } } },
+    { "if": { "properties": { "outcome": { "const": "reconciled" } } },
+      "then": { "properties": { "changes": { "type": "array", "maxItems": 0 }, "resolutions": { "type": "array", "minItems": 1,
+        "items": { "type": "object", "properties": { "delta_paths": { "type": "array", "maxItems": 0 } } } } } } }
+  ],
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "reference": {
+      "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+      "properties": {
+        "root": { "enum": ["run", "workspace"] },
+        "path": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "sha256": { "$ref": "#/$defs/hash" }
+      }
+    }
+  }
+}

package/dist/schemas/memory-review-correction-plan.schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-review-correction-plan@1",
+  "type": "object", "additionalProperties": false,
+  "required": ["schema_id", "run_id", "wave", "review_sha256", "works"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/memory-review-correction-plan@1" },
+    "run_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "wave": { "type": "integer", "minimum": 1, "maximum": 2 },
+    "review_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "works": { "type": "array", "minItems": 1, "maxItems": 256, "items": {
+      "type": "object", "additionalProperties": false,
+      "required": ["key", "task", "unit_ids", "finding_ids", "depends_on", "write_paths", "profile_id"],
+      "properties": {
+        "key": { "$ref": "#/$defs/id" },
+        "task": { "type": "string", "minLength": 1, "maxLength": 16384 },
+        "unit_ids": { "$ref": "#/$defs/nonemptyIds" },
+        "finding_ids": { "$ref": "#/$defs/nonemptyIds" },
+        "depends_on": { "type": "array", "maxItems": 256, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+        "write_paths": { "type": "array", "minItems": 1, "maxItems": 512, "uniqueItems": true,
+          "items": { "type": "string", "minLength": 1, "maxLength": 4096 } },
+        "profile_id": { "type": ["string", "null"], "minLength": 1, "maxLength": 256 }
+      }
+    } }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$" },
+    "nonemptyIds": { "type": "array", "minItems": 1, "maxItems": 1024, "uniqueItems": true, "items": { "$ref": "#/$defs/id" } }
+  }
+}

package/dist/schemas/memory-review-work-result.schema.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/memory-review-work-result@1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_id", "run_id", "work_id", "packet_sha256", "unit_id", "wave", "outcome", "summary", "evidence", "findings"],
+  "properties": {
+    "schema_id": { "const": "dd-flow/memory-review-work-result@1" },
+    "run_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "work_id": { "type": "string", "minLength": 1, "maxLength": 256 },
+    "packet_sha256": { "$ref": "#/$defs/hash" },
+    "unit_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+    "wave": { "type": "integer", "minimum": 0, "maximum": 2 },
+    "outcome": { "enum": ["accepted", "needs_repair", "blocked"] },
+    "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+    "evidence": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/reference" } },
+    "findings": {
+      "type": "array", "maxItems": 1024,
+      "items": {
+        "type": "object", "additionalProperties": false,
+        "required": ["id", "unit_id", "severity", "summary", "evidence"],
+        "properties": {
+          "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "unit_id": { "type": "string", "minLength": 1, "maxLength": 128 },
+          "severity": { "enum": ["minor", "major", "critical"] },
+          "summary": { "type": "string", "minLength": 1, "maxLength": 16384 },
+          "evidence": { "type": "array", "minItems": 1, "maxItems": 256, "items": { "$ref": "#/$defs/reference" } }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "hash": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+    "reference": {
+      "type": "object", "additionalProperties": false, "required": ["root", "path", "sha256"],
+      "properties": {
+        "root": { "enum": ["run", "workspace"] },
+        "path": { "type": "string", "minLength": 1, "maxLength": 4096 },
+        "sha256": { "$ref": "#/$defs/hash" }
+      }
+    }
+  }
+}