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

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

@@ -0,0 +1,428 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "dd-flow/distill-work-result@1",
+  "title": "Read-only practice extraction or independent distillation criticism",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_id",
+    "flow_id",
+    "run_id",
+    "work_id",
+    "stage",
+    "aspect_id",
+    "summary",
+    "baseline_summary",
+    "checked",
+    "candidates",
+    "decisions",
+    "external_research",
+    "limitations"
+  ],
+  "properties": {
+    "schema_id": {
+      "const": "dd-flow/distill-work-result@1"
+    },
+    "flow_id": {
+      "const": "mb-distill"
+    },
+    "run_id": {
+      "type": "string",
+      "pattern": "^RUN-[0-9]+-[a-z0-9-]+$"
+    },
+    "work_id": {
+      "type": "string",
+      "pattern": "^WRK-[0-9]+-[a-z0-9-]+$"
+    },
+    "stage": {
+      "enum": [
+        "extract",
+        "review"
+      ]
+    },
+    "aspect_id": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 16000
+    },
+    "summary": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 16000
+    },
+    "baseline_summary": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 16000
+    },
+    "checked": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 16000
+    },
+    "candidates": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 1000,
+      "items": {
+        "$ref": "#/$defs/candidate"
+      }
+    },
+    "decisions": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 2000,
+      "items": {
+        "$ref": "#/$defs/decision"
+      }
+    },
+    "external_research": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "used",
+        "reason",
+        "questions",
+        "sources",
+        "signal",
+        "effect"
+      ],
+      "properties": {
+        "used": {
+          "type": "boolean"
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "questions": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 5,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 16000
+          }
+        },
+        "sources": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 64,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "url",
+              "summary"
+            ],
+            "properties": {
+              "url": {
+                "type": "string",
+                "pattern": "^https?://",
+                "maxLength": 4096
+              },
+              "summary": {
+                "type": "string",
+                "minLength": 1,
+                "maxLength": 16000
+              }
+            }
+          }
+        },
+        "signal": {
+          "enum": [
+            "strong",
+            "medium",
+            "weak",
+            "none"
+          ]
+        },
+        "effect": {
+          "enum": [
+            "strengthens",
+            "weakens",
+            "neutral"
+          ]
+        }
+      }
+    },
+    "limitations": {
+      "type": "array",
+      "minItems": 0,
+      "maxItems": 256,
+      "items": {
+        "type": "string",
+        "minLength": 1,
+        "maxLength": 16000
+      }
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "stage": {
+            "const": "review"
+          }
+        },
+        "required": [
+          "stage"
+        ],
+        "type": "object"
+      },
+      "then": {
+        "properties": {
+          "candidates": {
+            "maxItems": 0,
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "else": {
+        "properties": {
+          "decisions": {
+            "maxItems": 0,
+            "type": "array"
+          }
+        },
+        "type": "object"
+      }
+    }
+  ],
+  "$defs": {
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "sha256"
+      ],
+      "properties": {
+        "path": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 4096
+        },
+        "sha256": {
+          "type": "string",
+          "pattern": "^[a-f0-9]{64}$"
+        }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "aspect_id",
+        "practice",
+        "source_refs",
+        "usage_refs",
+        "baseline_refs",
+        "delta",
+        "problem_solved",
+        "applicability",
+        "canon_fit",
+        "agent_leverage",
+        "evidence_strength",
+        "adoption_effort",
+        "complexity_risk",
+        "disposition",
+        "value",
+        "suggested_location",
+        "suggested_form",
+        "suggested_wording",
+        "risks",
+        "open_questions"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[A-Za-z][A-Za-z0-9_-]{0,99}$"
+        },
+        "aspect_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "practice": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "source_refs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        },
+        "usage_refs": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        },
+        "baseline_refs": {
+          "type": "array",
+          "minItems": 1,
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        },
+        "delta": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "problem_solved": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "applicability": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "canon_fit": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "agent_leverage": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "evidence_strength": {
+          "enum": [
+            "strong",
+            "medium",
+            "weak"
+          ]
+        },
+        "adoption_effort": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "complexity_risk": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "disposition": {
+          "enum": [
+            "adopt",
+            "adapt",
+            "observe",
+            "duplicate",
+            "reject"
+          ]
+        },
+        "value": {
+          "enum": [
+            "high",
+            "medium",
+            "low"
+          ]
+        },
+        "suggested_location": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "suggested_form": {
+          "enum": [
+            "rule",
+            "guide",
+            "template",
+            "prompt",
+            "example"
+          ]
+        },
+        "suggested_wording": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "risks": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 256,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 16000
+          }
+        },
+        "open_questions": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 256,
+          "items": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 16000
+          }
+        }
+      }
+    },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "candidate_id",
+        "disposition",
+        "reason",
+        "source_refs",
+        "baseline_refs"
+      ],
+      "properties": {
+        "candidate_id": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "disposition": {
+          "enum": [
+            "adopt",
+            "adapt",
+            "observe",
+            "duplicate",
+            "reject"
+          ]
+        },
+        "reason": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 16000
+        },
+        "source_refs": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        },
+        "baseline_refs": {
+          "type": "array",
+          "minItems": 0,
+          "maxItems": 64,
+          "items": {
+            "$ref": "#/$defs/source"
+          }
+        }
+      }
+    }
+  }
+}

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

@@ -4,9 +4,12 @@
   "type": "object",
   "additionalProperties": false,
   "allOf": [{
-    "if": { "properties": { "flow_id": { "enum": ["mb-audit", "project-review"] } }, "required": ["flow_id"] },
+    "if": { "properties": { "flow_id": { "enum": ["mb-audit", "project-review", "mb-distill", "mb-fix", "review-fix", "release", "deploy", "publish"] } }, "required": ["flow_id"] },
     "then": { "properties": { "project_pack": { "type": "null" } } },
     "else": { "properties": { "project_pack": { "type": "object" } } }
+  }, {
+    "if": { "properties": { "flow_id": { "const": "interactive" } }, "required": ["flow_id"] },
+    "else": { "properties": { "canon": { "type": "object", "properties": { "archive_sha256": { "type": "string" } } } } }
   }],
   "required": [
     "schema_id",
@@ -128,7 +131,8 @@
           "pattern": "^[a-f0-9]{40}$"
         },
         "archive_sha256": {
-          "type": "string",
+          "description": "Selected canonical archive identity. Null only for project-local interactive instructions: canon version/commit are their declared base, while project_pack identifies the actual executable data.",
+          "type": ["string", "null"],
           "pattern": "^[a-f0-9]{64}$"
         }
       }

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"}}
+      }
+    }
+  }
+}

package/dist/schemas/project-flow-pack-manifest.schema.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "dd-flow/project-flow-pack-manifest@2",
   "title": "Project flow pack manifest",
-  "description": "Manifest for the curated project-local dd-flow pack installed under .memory-bank/dd-flow/.",
+  "description": "Manifest shape for current and retained historical project-local packs. The current producer separately enforces canonical-only exclusions; obsolete included paths remain readable for safe upgrade and preservation.",
   "type": "object",
   "additionalProperties": false,
   "required": [
@@ -81,7 +81,7 @@
       "uniqueItems": true,
       "items": {
         "type": "string",
-        "enum": ["mb-init.md", "mb-upgrade.md", "mb-distill.md", "mb-audit.md", "review.md"]
+        "enum": ["mb-init.md", "mb-upgrade.md", "mb-distill.md", "mb-audit.md", "mb-fix.md", "review.md", "review-fix.md", "release.md", "deploy.md", "publish.md"]
       }
     },
     "generated_allow_patterns": {