@deksden-com/dd-flow-cli 0.4.1 → 0.5.0

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

@@ -1,125 +1,181 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "dd-flow/flow-contract@3",
-  "title": "dd-flow canonical flow contract",
-  "description": "Structural contract for the complete flow-contract.json catalog. Dynamic cross-key relationships are validated by the shared CLI normalizer.",
+  "$id": "dd-flow/flow-contract@5",
+  "title": "dd-flow canonical runtime contract",
+  "description": "Structural contract for the SPC-004 v0.2 and SPC-005 runtime/PLAN cutover. Dynamic command and cross-repository checks belong to companion projects.",
   "type": "object",
   "additionalProperties": false,
-  "required": ["id", "version", "capabilities", "stages", "transitions", "readiness", "merge_queue", "defaults", "legacy_aliases", "flow_flags"],
+  "required": [
+    "schema_id",
+    "id",
+    "contract_id",
+    "version",
+    "status",
+    "source",
+    "specifications",
+    "stage_lifecycle",
+    "run",
+    "artifacts",
+    "plan",
+    "validation",
+    "workspace",
+    "lint",
+    "removed_contracts",
+    "presets",
+    "policy"
+  ],
   "properties": {
-    "id": {"type":"string","pattern":"^dd-flow-canonical-[0-9]{4}-[0-9]{2}$"},
-    "version": {"const":3},
-    "capabilities": {"type":"array","uniqueItems":true,"items":{"type":"string","minLength":1}},
-    "stages": {"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/stage"}},
-    "transitions": {"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/stringArray"}},
-    "entrypoints": {"type":"object","additionalProperties":{"$ref":"#/definitions/entrypoint"}},
-    "readiness": {"$ref":"#/definitions/readiness"},
-    "merge_queue": {"$ref":"#/definitions/mergeQueue"},
-    "defaults": {"$ref":"#/definitions/defaults"},
-    "auto_policy": {"$ref":"#/definitions/autoPolicy"},
-    "legacy_aliases": {"$ref":"#/definitions/stringMap"},
-    "route_aliases": {"$ref":"#/definitions/stringMap"},
-    "flow_flags": {"$ref":"#/definitions/flowFlags"}
-  },
-  "definitions": {
-    "nonEmptyString": {"type":"string","minLength":1},
-    "stringArray": {"type":"array","uniqueItems":true,"items":{"$ref":"#/definitions/nonEmptyString"}},
-    "stringMap": {"type":"object","additionalProperties":{"$ref":"#/definitions/nonEmptyString"}},
-    "flagScalar": {"type":["string","number","boolean","null"]},
-    "flagMap": {"type":"object","additionalProperties":{"$ref":"#/definitions/flagScalar"}},
-    "stage": {
-      "type":"object","additionalProperties":false,"required":["terminal"],
-      "properties":{"terminal":{"type":"boolean"},"report_enabled":{"type":"boolean"}}
+    "schema_id": {"const": "dd-flow/flow-contract@5"},
+    "id": {"const": "dd-flow-canonical-2026-08"},
+    "contract_id": {"type": "string", "pattern": "^dd-flow-canonical-[0-9]{4}-[0-9]{2}$"},
+    "version": {"const": 5},
+    "status": {"const": "active"},
+    "source": {"const": ".memory-bank/dd-flow/common/runtime-contract.md"},
+    "specifications": {
+      "type": "array",
+      "minItems": 2,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "version", "sha256"],
+        "properties": {
+          "id": {"enum": ["SPC-004", "SPC-005"]},
+          "version": {"type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$"},
+          "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+        }
+      }
     },
-    "entrypoint": {
-      "type":"object","additionalProperties":false,
+    "stage_lifecycle": {"$ref": "#/definitions/stageLifecycle"},
+    "run": {"$ref": "#/definitions/runContract"},
+    "artifacts": {"$ref": "#/definitions/artifactContract"},
+    "plan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["semantic_source", "schema", "progress_projection", "worker_projection", "coverage_source", "removed"],
       "properties": {
-        "stage":{"$ref":"#/definitions/nonEmptyString"},
-        "logical_stages":{"$ref":"#/definitions/stringArray"},
-        "creates_protocol":{"type":"boolean"},
-        "purpose":{"$ref":"#/definitions/nonEmptyString"},
-        "mode":{"$ref":"#/definitions/nonEmptyString"}
-      },
-      "anyOf":[{"required":["stage"]},{"required":["logical_stages"]}]
+        "semantic_source": {"const": ".memory-bank/protocol/<PRT-ID>/plan.json"},
+        "schema": {"const": ".memory-bank/dd-flow/schemas/protocol-plan.schema.json"},
+        "progress_projection": {"const": "run.json.plan_progress"},
+        "worker_projection": {"const": "run.json.workers"},
+        "coverage_source": {"const": "<RUN-home>/02-plan/aspect-map.json"},
+        "removed": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}}
+      }
     },
-    "readiness": {
-      "type":"object","additionalProperties":false,"required":["command","allowed_from","target_stage"],
-      "properties":{"command":{"const":"ready-for-merge"},"allowed_from":{"$ref":"#/definitions/stringArray"},"target_stage":{"$ref":"#/definitions/nonEmptyString"}}
+    "validation": {"$ref": "#/definitions/validationContract"},
+    "workspace": {"$ref": "#/definitions/workspaceContract"},
+    "lint": {"$ref": "#/definitions/lintContract"},
+    "removed_contracts": {"type": "array", "minItems": 1, "uniqueItems": true, "items": {"type": "string", "minLength": 1}},
+    "presets": {"$ref": "#/definitions/presets"},
+    "policy": {"$ref": "#/definitions/policy"}
+  },
+  "definitions": {
+    "nonEmptyString": {"type": "string", "minLength": 1},
+    "stageLifecycle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["actions", "start_command", "finish_command", "prompt_sections", "current_write_alias", "archive_pattern"],
+      "properties": {
+        "actions": {
+          "const": ["stage_start", "stage_finish"]
+        },
+        "start_command": {"const": "dd-flow stage start <RUN> --stage <stage> --json"},
+        "finish_command": {"const": "dd-flow stage finish <RUN> --stage <stage> --status done --json"},
+        "prompt_sections": {
+          "const": [
+            "stage_identity",
+            "runtime_context",
+            "intake",
+            "applicable_instructions",
+            "stage_cli",
+            "file_boundaries",
+            "completion_contract"
+          ]
+        },
+        "current_write_alias": {"const": "@stage"},
+        "archive_pattern": {"const": "try-NNN"}
+      }
     },
-    "mergeQueue": {
-      "type":"object","additionalProperties":false,"required":["complete"],
-      "properties":{"complete":{"type":"object","additionalProperties":false,"required":["target_stage","next_action"],"properties":{"target_stage":{"$ref":"#/definitions/nonEmptyString"},"next_action":{"$ref":"#/definitions/nonEmptyString"}}}}
+    "runContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["current_state", "history", "sole_authority", "legacy_state"],
+      "properties": {
+        "current_state": {"const": "run.json"},
+        "history": {"const": "timeline.jsonl"},
+        "sole_authority": {"const": true},
+        "legacy_state": {"const": "retired"}
+      }
     },
-    "defaults": {
-      "type":"object","additionalProperties":false,"required":["registered_next_action"],
+    "artifactContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["finish_outputs", "model_input", "mechanical_facts"],
       "properties": {
-        "registered_next_action":{"$ref":"#/definitions/nonEmptyString"},
-        "ordinary_protocol_flow_kind":{"$ref":"#/definitions/nonEmptyString"},
-        "normal_stage_layout":{"$ref":"#/definitions/stringArray"},
-        "legacy_coding_stage_layout":{"$ref":"#/definitions/stringArray"}
+        "finish_outputs": {"const": ["stage-report.json", "stage-report.md", "stage-report.html", "summary.md"]},
+        "model_input": {"const": "semantic-only"},
+        "mechanical_facts": {"const": "cli-owned"}
       }
     },
-    "autoPolicy": {
-      "type":"object","additionalProperties":false,
+    "validationContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["permission_scope", "memory_bank_scope", "alias_policy"],
       "properties": {
-        "ready_for_code_auto":{"$ref":"#/definitions/nonEmptyString"},
-        "ready_for_code_after_user_review":{"$ref":"#/definitions/nonEmptyString"},
-        "home_config_path":{"$ref":"#/definitions/nonEmptyString"},
-        "snapshot_authority":{"$ref":"#/definitions/nonEmptyString"},
-        "legacy_profile_projection":{"$ref":"#/definitions/nonEmptyString"}
+        "permission_scope": {"const": "known-targets-only"},
+        "memory_bank_scope": {"const": "post-write-delta"},
+        "alias_policy": {"const": "typed-contained-fail-closed"}
       }
     },
-    "flowFlags": {
-      "type":"object","additionalProperties":false,
-      "required":["source_precedence","definitions","presets","flows","mandatory_floors"],
+    "workspaceContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["manager", "command", "project_hooks", "fallbacks"],
       "properties": {
-        "source_precedence": {
-          "type":"array","minItems":1,"uniqueItems":true,
-          "items":{"enum":["flow_default","preset","task_profile","protocol_override","run_override","escalation","compatibility_alias"]}
-        },
-        "definitions": {"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/flagDefinition"}},
-        "presets": {"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/flagMap"}},
-        "flows": {"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/flowFlagConsumer"}},
-        "mandatory_floors": {"type":"array","items":{"$ref":"#/definitions/mandatoryFloor"}},
-        "reduction_matrix": {"type":"object","additionalProperties":{"$ref":"#/definitions/reductionEntry"}},
-        "consumer_matrix": {"type":"object","additionalProperties":{"$ref":"#/definitions/stringArray"}}
+        "manager": {"const": "official-worktrunk"},
+        "command": {"const": "wt switch --create <branch> --base <base> --format json"},
+        "project_hooks": {"const": [".worktreeinclude", ".config/wt.toml"]},
+        "fallbacks": {"const": "forbidden"}
       }
     },
-    "flagDefinition": {
-      "type":"object","additionalProperties":false,"required":["type","owner","description"],
+    "lintContract": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["progress_channel", "result_channel", "default_concurrency", "findings_order"],
       "properties": {
-        "type":{"enum":["boolean","enum","number","string"]},
-        "values":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/definitions/flagScalar"}},
-        "owner":{"$ref":"#/definitions/nonEmptyString"},
-        "description":{"$ref":"#/definitions/nonEmptyString"}
-      },
-      "allOf":[
-        {"if":{"properties":{"type":{"const":"enum"}},"required":["type"]},"then":{"required":["values"]}},
-        {"if":{"properties":{"type":{"enum":["boolean","number","string"]}},"required":["type"]},"then":{"not":{"required":["values"]}}}
-      ]
+        "progress_channel": {"const": "stderr"},
+        "result_channel": {"const": "stdout"},
+        "default_concurrency": {"const": 32},
+        "findings_order": {"const": "deterministic"}
+      }
     },
-    "flowFlagConsumer": {
-      "type":"object","additionalProperties":false,"required":["default_preset","supported","defaults"],
+    "presets": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["compact", "normal", "full"],
       "properties": {
-        "default_preset":{"$ref":"#/definitions/nonEmptyString"},
-        "supported":{"type":"array","minItems":1,"uniqueItems":true,"items":{"$ref":"#/definitions/nonEmptyString"}},
-        "defaults":{"type":"object","additionalProperties":false,"required":["preset"],"properties":{"preset":{"$ref":"#/definitions/nonEmptyString"}}}
+        "compact": {"$ref": "#/definitions/preset"},
+        "normal": {"$ref": "#/definitions/preset"},
+        "full": {"$ref": "#/definitions/preset"}
       }
     },
-    "mandatoryFloor": {
-      "type":"object","additionalProperties":false,"required":["when","values","reason"],
+    "preset": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["planning", "verification"],
       "properties": {
-        "when":{"type":"object","minProperties":1,"additionalProperties":{"$ref":"#/definitions/stringArray"}},
-        "values":{"$ref":"#/definitions/flagMap"},
-        "reason":{"$ref":"#/definitions/nonEmptyString"}
+        "planning": {"enum": ["compact", "normal", "full"]},
+        "verification": {"enum": ["mandatory", "full"]}
       }
     },
-    "reductionEntry": {
-      "type":"object","additionalProperties":false,"required":["skips","keeps","reduced_artifact_status"],
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_of_truth", "runtime_owner", "lint_owner", "integrated_gate"],
       "properties": {
-        "skips":{"$ref":"#/definitions/stringArray"},
-        "keeps":{"$ref":"#/definitions/stringArray"},
-        "reduced_artifact_status":{"$ref":"#/definitions/nonEmptyString"}
+        "source_of_truth": {"const": "canonical prompts and schemas"},
+        "runtime_owner": {"const": "dd-flow-cli"},
+        "lint_owner": {"const": "mb-lint"},
+        "integrated_gate": {"const": "compatible releases plus clean specify-to-plan eval"}
       }
     }
   }

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

@@ -1,35 +1,141 @@
 {
   "$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.",
+  "$id": "dd-flow/flow-run@2",
+  "title": "dd-flow canonical RUN state",
+  "description": "The sole current machine-readable state for one RUN. Event history belongs to timeline.jsonl.",
   "type": "object",
   "additionalProperties": true,
-  "required": ["schema_id", "run_index_schema_id", "run_id", "runtime_revision", "snapshot_revision", "snapshot_checksum", "flow_flags"],
+  "required": ["schema_id", "run_id", "project", "subject", "status", "started_at", "workspace", "current_stage", "attempts", "session_coverage", "usage_coverage", "artifacts"],
   "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" } }
+    "schema_id": {"const": "dd-flow/flow-run@2"},
+    "run_id": {"type": "string", "pattern": "^RUN-[0-9]+-[a-z0-9][a-z0-9-]*$"},
+    "project": {"$ref": "#/definitions/identity"},
+    "subject": {"$ref": "#/definitions/identity"},
+    "protocol_id": {"type": "string"},
+    "flow_kind": {"type": "string", "minLength": 1},
+    "status": {"enum": ["created", "running", "done", "failed", "blocked", "discarded"]},
+    "verdict": {"type": ["string", "null"]},
+    "started_at": {"type": "string", "format": "date-time"},
+    "finished_at": {"type": ["string", "null"], "format": "date-time"},
+    "wall_clock_ms": {"type": ["integer", "null"], "minimum": 0},
+    "timing_status": {"enum": ["measured", "partial", "unavailable"]},
+    "workspace": {"$ref": "#/definitions/workspace"},
+    "current_stage": {"type": ["string", "null"]},
+    "plan_ref": {"$ref": "#/definitions/planRef"},
+    "plan_progress": {"$ref": "#/definitions/planProgress"},
+    "workers": {"$ref": "#/definitions/workers"},
+    "attempts": {"type": "array", "items": {"$ref": "#/definitions/attempt"}},
+    "session_coverage": {"$ref": "#/definitions/coverage"},
+    "usage_coverage": {"$ref": "#/definitions/coverage"},
+    "artifacts": {"$ref": "#/definitions/artifacts"},
+    "timeline_path": {"const": "timeline.jsonl"}
   },
   "definitions": {
-    "flowFlags": {
+    "planRef": {
       "type": "object",
-      "required": ["contract", "flow_kind", "snapshot_revision", "resolution_status", "values", "snapshot_checksum"],
+      "additionalProperties": false,
+      "required": ["path", "plan_id", "revision", "sha256"],
       "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" } }
+        "path": {"type": "string", "pattern": "^\\.memory-bank/protocol/[^/]+/plan\\.json$"},
+        "plan_id": {"type": "string", "minLength": 1},
+        "revision": {"type": "integer", "minimum": 1},
+        "sha256": {"type": "string", "pattern": "^[a-f0-9]{64}$"}
+      }
+    },
+    "planProgress": {
+      "type": "object",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^P[0-9]+$": {"$ref": "#/definitions/progressItem"}
+      }
+    },
+    "progressItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status"],
+      "properties": {
+        "status": {"enum": ["pending", "in_progress", "done", "blocked", "skipped"]},
+        "started_at": {"type": "string", "format": "date-time"},
+        "completed_at": {"type": "string", "format": "date-time"},
+        "summary": {"type": "string", "minLength": 1},
+        "evidence": {"type": "array", "items": {"type": "string", "minLength": 1}}
+      }
+    },
+    "workers": {
+      "type": "object",
+      "additionalProperties": false,
+      "patternProperties": {
+        "^JOB-[A-Za-z0-9._-]+$": {"$ref": "#/definitions/worker"}
+      }
+    },
+    "worker": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["units", "status"],
+      "properties": {
+        "units": {"type": "array", "minItems": 1, "items": {"type": "string", "minLength": 1}},
+        "session_id": {"type": "string", "minLength": 1},
+        "status": {"enum": ["registered", "running", "completed", "failed", "blocked"]},
+        "task_ref": {"type": "string", "minLength": 1},
+        "prompt_ref": {"type": "string", "minLength": 1},
+        "report_ref": {"type": "string", "minLength": 1}
+      }
+    },
+    "identity": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "title"],
+      "properties": {"id": {"type": "string", "minLength": 1}, "title": {"type": "string", "minLength": 1}}
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["project_root", "workspace_path", "branch", "base"],
+      "properties": {
+        "project_root": {"type": "string", "minLength": 1},
+        "workspace_path": {"type": "string", "minLength": 1},
+        "branch": {"type": "string", "minLength": 1},
+        "base": {"type": "string", "minLength": 1},
+        "manager": {"const": "official-worktrunk"},
+        "bootstrap_status": {"type": "string", "minLength": 1}
+      }
+    },
+    "attempt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage", "attempt_number", "root", "status"],
+      "properties": {
+        "stage": {"type": "string", "minLength": 1},
+        "attempt_number": {"type": "integer", "minimum": 1},
+        "root": {"type": "string", "minLength": 1},
+        "archive": {"type": ["string", "null"]},
+        "status": {"type": "string", "minLength": 1},
+        "started_at": {"type": "string", "format": "date-time"},
+        "finished_at": {"type": ["string", "null"], "format": "date-time"}
+      }
+    },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "expected", "observed", "missing"],
+      "properties": {
+        "status": {"enum": ["complete", "partial", "unavailable"]},
+        "expected": {"type": "array", "items": {"type": "string"}},
+        "observed": {"type": "array", "items": {"type": "string"}},
+        "missing": {"type": "array", "items": {"type": "string"}},
+        "reason": {"type": "string"}
+      }
+    },
+    "artifacts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["stage_prompt", "stage_report_json", "stage_report_md", "stage_report_html", "summary"],
+      "properties": {
+        "stage_prompt": {"type": "string", "minLength": 1},
+        "stage_report_json": {"type": "string", "minLength": 1},
+        "stage_report_md": {"type": "string", "minLength": 1},
+        "stage_report_html": {"type": "string", "minLength": 1},
+        "summary": {"type": "string", "minLength": 1}
       }
     }
   }

package/dist/schemas/mb-upgrade-review-data.schema.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "dd-flow/mb-upgrade-review-data@1",
-  "title": "mb-upgrade-review data",
-  "description": "Canonical data contract for mb-upgrade-review review-data.json.",
+  "title": "mb-upgrade 05-review data",
+  "description": "Canonical data contract for review-data.json produced by mb-upgrade stage 05-review.",
   "type": "object",
   "additionalProperties": false,
   "required": [

package/dist/schemas/memorybank-permissions-preflight.schema.json

@@ -4,37 +4,13 @@
   "title": "Memory Bank permissions preflight",
   "type": "object",
   "additionalProperties": false,
-  "required": [
-    "schema_id",
-    "ok",
-    "exit_code",
-    "flow",
-    "mode",
-    "platform",
-    "targets",
-    "checks",
-    "summary",
-    "remediation"
-  ],
+  "required": ["schema_id", "ok", "exit_code", "flow", "mode", "platform", "targets", "checks", "summary", "remediation"],
   "properties": {
-    "schema_id": {
-      "const": "dd-flow/memorybank-permissions-preflight@1"
-    },
-    "ok": {
-      "type": "boolean"
-    },
-    "exit_code": {
-      "type": "integer",
-      "enum": [0, 1]
-    },
-    "flow": {
-      "type": "string",
-      "enum": ["mb-init", "mb-upgrade", "mb-audit", "mb-fix", "mb-upgrade-review", "custom"]
-    },
-    "mode": {
-      "type": "string",
-      "enum": ["read", "write", "repair", "report_only"]
-    },
+    "schema_id": { "const": "dd-flow/memorybank-permissions-preflight@1" },
+    "ok": { "type": "boolean" },
+    "exit_code": { "type": "integer", "enum": [0, 1] },
+    "flow": { "type": "string", "enum": ["mb-init", "mb-upgrade", "mb-audit", "mb-fix", "custom"] },
+    "mode": { "type": "string", "enum": ["read", "write", "repair", "report_only"] },
     "platform": {
       "type": "object",
       "additionalProperties": false,
@@ -57,10 +33,7 @@
         "tasks": { "type": "string" }
       }
     },
-    "checks": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/check" }
-    },
+    "checks": { "type": "array", "items": { "$ref": "#/$defs/check" } },
     "summary": {
       "type": "object",
       "additionalProperties": false,
@@ -71,10 +44,7 @@
         "can_continue": { "type": "boolean" }
       }
     },
-    "remediation": {
-      "type": "array",
-      "items": { "$ref": "#/$defs/remediation" }
-    }
+    "remediation": { "type": "array", "items": { "$ref": "#/$defs/remediation" } }
   },
   "$defs": {
     "check": {
@@ -87,36 +57,12 @@
         "path": { "type": "string" },
         "operation": {
           "type": "string",
-          "enum": [
-            "read_existing_file",
-            "write_existing_file",
-            "create_file",
-            "create_directory",
-            "delete_probe",
-            "stat_metadata",
-            "detect_acl",
-            "detect_flags"
-          ]
-        },
-        "status": {
-          "type": "string",
-          "enum": ["passed", "failed", "warning", "skipped", "unknown"]
+          "enum": ["read_existing_file", "write_existing_file", "create_file", "create_directory", "delete_probe", "stat_metadata", "detect_acl", "detect_flags"]
         },
+        "status": { "type": "string", "enum": ["passed", "failed", "warning", "skipped", "unknown"] },
         "reason": {
           "type": "string",
-          "enum": [
-            "ok",
-            "not_found",
-            "not_writable",
-            "not_readable",
-            "owner_mismatch",
-            "acl_denied",
-            "read_only_attribute",
-            "immutable_flag",
-            "unsupported_platform",
-            "probe_failed",
-            "unknown"
-          ]
+          "enum": ["ok", "not_found", "not_writable", "not_readable", "owner_mismatch", "acl_denied", "read_only_attribute", "immutable_flag", "unsupported_platform", "probe_failed", "unknown"]
         },
         "fs_error": {
           "type": "object",
@@ -130,10 +76,7 @@
         "owner": { "type": "string" },
         "group": { "type": "string" },
         "mode": { "type": "string" },
-        "side_effect": {
-          "type": "string",
-          "enum": ["none", "temporary_probe_created_and_removed", "temporary_probe_cleanup_failed"]
-        }
+        "side_effect": { "type": "string", "enum": ["none", "temporary_probe_created_and_removed", "temporary_probe_cleanup_failed"] }
       }
     },
     "remediation": {
@@ -143,10 +86,7 @@
       "properties": {
         "platform": { "type": "string" },
         "title": { "type": "string" },
-        "commands": {
-          "type": "array",
-          "items": { "type": "string" }
-        },
+        "commands": { "type": "array", "items": { "type": "string" } },
         "requires_user_confirmation": { "type": "boolean" }
       }
     }

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

@@ -235,10 +235,10 @@
     "run": {
       "type": "object",
       "additionalProperties": true,
-      "required": ["run_id", "run_index"],
+      "required": ["run_id", "run_state"],
       "properties": {
         "run_id": { "type": "string", "pattern": "^RUN-[0-9]{3}-[a-z0-9]+(?:-[a-z0-9]+)*$" },
-        "run_index": { "type": "string", "minLength": 1 }
+        "run_state": { "type": "string", "minLength": 1 }
       }
     },
     "stage": {