mustflow 2.70.0 → 2.74.1

package/schemas/README.md

@@ -7,12 +7,14 @@ Current schemas:
 
 - `doctor-report.schema.json`: output of `mf doctor --json`
 - `adapter-compatibility-report.schema.json`: output of `mf adapters status --json`
-- `context-report.schema.json`: output of `mf context --json`, including prompt-cache profiles and optional cache audit data
+- `context-report.schema.json`: output of `mf context --json`, including context trust metadata, prompt-cache profiles, and optional cache audit data
 - `workspace-summary.schema.json`: output of `mf api workspace-summary --json`
 - `command-catalog.schema.json`: output of `mf api command-catalog --json`
-- `verification-plan.schema.json`: output of `mf api verification-plan --changed --json`
+- `verification-plan.schema.json`: output of `mf api verification-plan --changed --json`, including
+  risk-priced evidence assessment for the changed surfaces and selected command contract
 - `latest-evidence.schema.json`: output of `mf api latest-evidence --json`
-- `diff-risk.schema.json`: output of `mf api diff-risk --changed --json`
+- `diff-risk.schema.json`: output of `mf api diff-risk --changed --json`, including a read-only
+  complexity budget for structural additions
 - `health.schema.json`: output of `mf api health --json`
 - `locks.schema.json`: output of `mf api locks --json`
 - `api-serve-response.schema.json`: each newline-delimited response from `mf api serve --stdio`
@@ -29,7 +31,8 @@ Current schemas:
 - `next-report.schema.json`: output of `mf next --json`, containing the next safe action,
   changed-file verification gaps, and read-only command recommendations
 - `evidence-report.schema.json`: output of `mf evidence --changed --json`, containing verification
-  requirements, latest bounded evidence, receipts, remaining risks, and gaps without running commands
+  requirements, risk-priced evidence assessment, latest bounded evidence, failure replay capsules,
+  conflict ledgers, receipts, remaining risks, and gaps without running commands
 - `workspace-status.schema.json`: output of `mf workspace status --json`, containing configured
   workspace roots, discovered nested repositories, and per-root command-contract readiness without
   granting command authority
@@ -38,11 +41,12 @@ Current schemas:
   strings
 - `workspace-verification-plan.schema.json`: output of
   `mf workspace verify --changed --plan-only --json`, containing per-root changed-file
-  verification plans without running commands or granting parent-to-child command authority
+  verification plans and risk-priced evidence assessment without running commands or granting
+  parent-to-child command authority
 - `dashboard-export.schema.json`: bounded static export written by `mf dashboard --export-json <path>`,
   including output policy, redaction and truncation metadata, the dashboard harness report, and
-  the evidence-based completion verdict, evidence model, and conservative coverage matrix for the
-  exported snapshot
+  the evidence-based completion verdict, conflict ledger, complexity budget, evidence model, and
+  conservative coverage matrix for the exported snapshot
 - `classify-report.schema.json`: output of `mf classify --changed --json` and  
   `mf classify <path...> --json`
 - `impact-report.schema.json`: output of `mf impact --changed --json` and  
@@ -52,6 +56,12 @@ Current schemas:
 - `quality-gaming-report.schema.json`: output of `mf quality check --json`, containing changed-file
   quality-gaming risks such as line stuffing, validation suppressions, test bypass markers, type
   escapes, generated/vendor logic, empty catch swallowing, and placeholder implementations
+- `script-pack-catalog.schema.json`: output of `mf script-pack list --json`, containing bundled
+  script-pack ids, script refs, action names, usage strings, and associated report schemas
+- `text-budget-report.schema.json`: output of
+  `mf script-pack run core/text-budget check <path...> --json`, containing
+  exact text-budget metrics, input content hashes, policy metadata, findings, and JSON Pointer field
+  checks for bounded user-facing strings and generated text
 - `skill-route-report.schema.json`: output of `mf skill route --json`, containing compact route
   candidates, selected main and adjunct skills, score breakdowns, route read plans, and source
   route shards without granting command authority or replacing selected `SKILL.md` reads
@@ -59,7 +69,7 @@ Current schemas:
   skill-route golden cases with required and forbidden route expectations
 - `latest-run-pointer.schema.json`: `.mustflow/state/runs/latest.json` when `mf verify` writes a
   pointer to the latest verify run bundle, including the verify completion verdict, evidence model,
-  and coverage matrix
+  complexity budget, failure replay capsule, conflict ledger, and coverage matrix
 - `handoff-validation-report.schema.json`: output of  
   `mf handoff validate <path> --json`
 - `version-sources-report.schema.json`: output of `mf version-sources --json`
@@ -69,14 +79,16 @@ Current schemas:
   `mf explain surface --json`, and `mf explain why <target> --json`. Verify explanations include the shared
   `decisionGraph` evidence model; latest-failure explanations include bounded latest-run metadata only.
 - `verify-report.schema.json`: output of `mf verify --reason <event> --json`, including an
-  explicit execution aggregate, evidence-based completion verdict, and evidence model with a
+  explicit execution aggregate, risk-priced evidence assessment, evidence-based completion verdict,
+  failure replay capsule, conflict ledger, and evidence model with a read-only complexity budget and
   conservative coverage matrix for the selected receipts and skipped checks
 - `verify-run-manifest.schema.json`: `.mustflow/state/runs/verify-*/manifest.json`, including
-  the same execution aggregate, completion verdict, evidence model, and coverage matrix as the verify report
+  the same execution aggregate, risk assessment, completion verdict, failure replay capsule,
+  conflict ledger, evidence model, complexity budget, and coverage matrix as the verify report
 - `change-verification-report.schema.json`: output of `mf verify --reason <event> --plan-only --json` and  
   `mf verify --from-classification <classify-report.json> --plan-only --json`, including the `decision_graph` that links
   changed surfaces, classification reasons, command candidates, eligibility, selected or not-selected state,
-  effects, and gaps.
+  effects, gaps, and risk-priced evidence requirements.
   Local-index command-effect graphs and command preconditions are explanation-only and cannot grant command authority.
 
 These schemas define stable, automation-facing fields. Human-readable command  

package/schemas/change-verification-report.schema.json

@@ -55,6 +55,9 @@
         "$ref": "#/$defs/verificationGap"
       }
     },
+    "risk_assessment": {
+      "$ref": "#/$defs/riskAssessment"
+    },
     "schedule": {
       "$ref": "#/$defs/verificationSchedule"
     },
@@ -328,6 +331,32 @@
         }
       }
     },
+    "riskAssessment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "source",
+        "level",
+        "reasons",
+        "required_evidence",
+        "blocking_gaps",
+        "rollback_required",
+        "human_approval_required",
+        "manual_review_required"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "source": { "const": "change_classification_and_command_contract" },
+        "level": { "enum": ["low", "medium", "high", "critical"] },
+        "reasons": { "$ref": "#/$defs/stringArray" },
+        "required_evidence": { "$ref": "#/$defs/stringArray" },
+        "blocking_gaps": { "$ref": "#/$defs/stringArray" },
+        "rollback_required": { "type": "boolean" },
+        "human_approval_required": { "type": "boolean" },
+        "manual_review_required": { "type": "boolean" }
+      }
+    },
     "testSelectionReport": {
       "type": "object",
       "additionalProperties": false,

package/schemas/context-report.schema.json

@@ -121,7 +121,61 @@
       "required": ["path", "exists"],
       "properties": {
         "path": { "type": "string" },
-        "exists": { "type": "boolean" }
+        "exists": { "type": "boolean" },
+        "trust": { "$ref": "#/$defs/contextTrust" }
+      }
+    },
+    "contextTrust": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_kind",
+        "authority",
+        "cache_layer",
+        "freshness",
+        "content_hash",
+        "can_instruct_agent",
+        "grants_command_authority",
+        "notes"
+      ],
+      "properties": {
+        "source_kind": {
+          "enum": [
+            "workflow_file",
+            "command_contract",
+            "skill_file",
+            "context_file",
+            "generated_cache",
+            "generated_state",
+            "source_placeholder",
+            "runtime_volatile",
+            "unknown_file"
+          ]
+        },
+        "authority": {
+          "enum": [
+            "binding",
+            "workflow_policy",
+            "configuration",
+            "command_contract",
+            "procedure",
+            "contextual",
+            "hint",
+            "generated",
+            "evidence_only",
+            "volatile",
+            "unknown"
+          ]
+        },
+        "cache_layer": { "enum": ["stable", "task", "volatile", null] },
+        "freshness": { "enum": ["hash_verified", "missing", "dynamic", "runtime_volatile", "unchecked"] },
+        "content_hash": { "type": ["string", "null"] },
+        "can_instruct_agent": { "type": "boolean" },
+        "grants_command_authority": { "type": "boolean" },
+        "notes": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
       }
     },
     "intentContext": {
@@ -364,7 +418,8 @@
       "properties": {
         "path": { "type": "string" },
         "exists": { "type": "boolean" },
-        "content_hash": { "type": ["string", "null"] }
+        "content_hash": { "type": ["string", "null"] },
+        "trust": { "$ref": "#/$defs/contextTrust" }
       }
     },
     "taskContextLayer": {
@@ -617,6 +672,7 @@
           "type": "array",
           "items": { "type": "string" }
         },
+        "trust": { "$ref": "#/$defs/contextTrust" },
         "issue": { "type": ["string", "null"] }
       }
     },

package/schemas/dashboard-export.schema.json

@@ -197,6 +197,9 @@
           "type": "array",
           "items": { "$ref": "#/$defs/evidenceGap" }
         },
+        "complexity_budget": { "$ref": "verify-report.schema.json#/$defs/complexityBudget" },
+        "risk_assessment": { "$ref": "#/$defs/riskAssessment" },
+        "conflict_ledger": { "$ref": "verify-report.schema.json#/$defs/conflictLedger" },
         "remaining_risks": {
           "type": "array",
           "items": { "$ref": "#/$defs/evidenceRemainingRisk" }
@@ -304,6 +307,41 @@
         "detail": { "type": "string" }
       }
     },
+    "riskAssessment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "source",
+        "level",
+        "reasons",
+        "required_evidence",
+        "blocking_gaps",
+        "rollback_required",
+        "human_approval_required",
+        "manual_review_required"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "source": { "const": "change_classification_and_command_contract" },
+        "level": { "enum": ["low", "medium", "high", "critical"] },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "required_evidence": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "blocking_gaps": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "rollback_required": { "type": "boolean" },
+        "human_approval_required": { "type": "boolean" },
+        "manual_review_required": { "type": "boolean" }
+      }
+    },
     "evidenceExplanation": {
       "type": "object",
       "additionalProperties": false,
@@ -377,6 +415,7 @@
             "receipt_binding_risk_count": { "type": "integer" },
             "stale_receipt_count": { "type": "integer" },
             "plan_mismatch_count": { "type": "integer" },
+            "risk_priced_evidence_risk_count": { "type": "integer" },
             "risks": { "$ref": "#/$defs/completionVerdictRisks" },
             "receipt_binding": { "$ref": "#/$defs/completionVerdictReceiptBinding" },
             "latest_run_status": { "type": ["string", "null"] }
@@ -434,7 +473,8 @@
         "write_drift": { "type": "integer" },
         "receipt_binding": { "type": "integer" },
         "stale_receipt": { "type": "integer" },
-        "plan_mismatch": { "type": "integer" }
+        "plan_mismatch": { "type": "integer" },
+        "risk_priced_evidence": { "type": "integer" }
       }
     },
     "completionVerdictReceiptBinding": {
@@ -505,6 +545,7 @@
           "properties": {
             "completion_verdict": { "$ref": "#/$defs/completionVerdict" },
             "evidence_model": { "$ref": "#/$defs/evidenceModel" },
+            "conflict_ledger": { "$ref": "verify-report.schema.json#/$defs/conflictLedger" },
             "changed_file_count": { "type": "integer" },
             "changed_surfaces": { "$ref": "#/$defs/stringArray" },
             "decision_graph_summary": {

package/schemas/diff-risk.schema.json

@@ -37,6 +37,12 @@
     "update_policies": { "$ref": "#/$defs/stringArray" },
     "drift_checks": { "$ref": "#/$defs/stringArray" },
     "required_verification": { "$ref": "#/$defs/stringArray" },
+    "complexity_budget": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "verify-report.schema.json#/$defs/complexityBudget" }
+      ]
+    },
     "residual_corrections": { "$ref": "#/$defs/residualCorrections" },
     "gap_count": { "type": "integer", "minimum": 0 },
     "gaps": {

package/schemas/evidence-report.schema.json

@@ -107,6 +107,7 @@
         "changed_files": { "$ref": "#/$defs/stringArray" },
         "validation_reasons": { "$ref": "#/$defs/stringArray" },
         "selected_intents": { "$ref": "#/$defs/stringArray" },
+        "risk_assessment": { "$ref": "#/$defs/riskAssessment" },
         "requirement_count": { "type": "integer", "minimum": 0 },
         "gap_count": { "type": "integer", "minimum": 0 },
         "requirements": {
@@ -199,6 +200,24 @@
         "receipt_count": { "type": ["integer", "null"], "minimum": 0 },
         "skipped_check_count": { "type": "integer", "minimum": 0 },
         "remaining_risk_count": { "type": "integer", "minimum": 0 },
+        "risk_assessment": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/riskAssessment" }
+          ]
+        },
+        "failure_replay_capsule": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "verify-report.schema.json#/$defs/failureReplayCapsule" }
+          ]
+        },
+        "conflict_ledger": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "verify-report.schema.json#/$defs/conflictLedger" }
+          ]
+        },
         "requirements": {
           "type": "array",
           "items": { "$ref": "#/$defs/latestRequirement" }
@@ -255,6 +274,32 @@
         "detail": { "type": "string" }
       }
     },
+    "riskAssessment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "source",
+        "level",
+        "reasons",
+        "required_evidence",
+        "blocking_gaps",
+        "rollback_required",
+        "human_approval_required",
+        "manual_review_required"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "source": { "const": "change_classification_and_command_contract" },
+        "level": { "enum": ["low", "medium", "high", "critical"] },
+        "reasons": { "$ref": "#/$defs/stringArray" },
+        "required_evidence": { "$ref": "#/$defs/stringArray" },
+        "blocking_gaps": { "$ref": "#/$defs/stringArray" },
+        "rollback_required": { "type": "boolean" },
+        "human_approval_required": { "type": "boolean" },
+        "manual_review_required": { "type": "boolean" }
+      }
+    },
     "coverage": {
       "type": "object",
       "additionalProperties": false,

package/schemas/latest-run-pointer.schema.json

@@ -39,14 +39,22 @@
     },
     "execution_status": { "enum": ["passed", "partial", "failed", "blocked"] },
     "status": { "enum": ["passed", "partial", "failed", "blocked"] },
+    "risk_assessment": { "$ref": "#/$defs/riskAssessment" },
     "completion_verdict": { "$ref": "#/$defs/completionVerdict" },
     "evidence_model": { "$ref": "#/$defs/evidenceModel" },
+    "conflict_ledger": { "$ref": "verify-report.schema.json#/$defs/conflictLedger" },
     "failure_fingerprint": {
       "anyOf": [
         { "$ref": "#/$defs/failureFingerprint" },
         { "type": "null" }
       ]
     },
+    "failure_replay_capsule": {
+      "anyOf": [
+        { "$ref": "verify-report.schema.json#/$defs/failureReplayCapsule" },
+        { "type": "null" }
+      ]
+    },
     "repeated_failure_summary": {
       "anyOf": [
         { "$ref": "#/$defs/repeatedFailureSummary" },
@@ -196,6 +204,7 @@
             "receipt_binding_risk_count": { "type": "integer" },
             "stale_receipt_count": { "type": "integer" },
             "plan_mismatch_count": { "type": "integer" },
+            "risk_priced_evidence_risk_count": { "type": "integer" },
             "risks": { "$ref": "#/$defs/completionVerdictRisks" },
             "receipt_binding": { "$ref": "#/$defs/completionVerdictReceiptBinding" },
             "latest_run_status": { "type": ["string", "null"] }
@@ -253,7 +262,8 @@
         "write_drift": { "type": "integer" },
         "receipt_binding": { "type": "integer" },
         "stale_receipt": { "type": "integer" },
-        "plan_mismatch": { "type": "integer" }
+        "plan_mismatch": { "type": "integer" },
+        "risk_priced_evidence": { "type": "integer" }
       }
     },
     "completionVerdictReceiptBinding": {
@@ -322,6 +332,10 @@
           "type": "array",
           "items": { "$ref": "#/$defs/evidenceGap" }
         },
+        "complexity_budget": { "$ref": "verify-report.schema.json#/$defs/complexityBudget" },
+        "risk_assessment": { "$ref": "#/$defs/riskAssessment" },
+        "failure_replay_capsule": { "$ref": "verify-report.schema.json#/$defs/failureReplayCapsule" },
+        "conflict_ledger": { "$ref": "verify-report.schema.json#/$defs/conflictLedger" },
         "remaining_risks": {
           "type": "array",
           "items": { "$ref": "#/$defs/evidenceRemainingRisk" }
@@ -467,6 +481,41 @@
         "detail": { "type": "string" }
       }
     },
+    "riskAssessment": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "source",
+        "level",
+        "reasons",
+        "required_evidence",
+        "blocking_gaps",
+        "rollback_required",
+        "human_approval_required",
+        "manual_review_required"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "source": { "const": "change_classification_and_command_contract" },
+        "level": { "enum": ["low", "medium", "high", "critical"] },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "required_evidence": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "blocking_gaps": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "rollback_required": { "type": "boolean" },
+        "human_approval_required": { "type": "boolean" },
+        "manual_review_required": { "type": "boolean" }
+      }
+    },
     "reproEvidence": {
       "type": "object",
       "additionalProperties": false,

package/schemas/script-pack-catalog.schema.json

@@ -0,0 +1,68 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/script-pack-catalog.schema.json",
+  "title": "mustflow script-pack catalog",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "action",
+    "ok",
+    "mustflow_root",
+    "packs",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "action": { "const": "list" },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "packs": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/pack" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "pack": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "summary_key", "scripts"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "summary_key": { "type": "string" },
+        "scripts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/script" }
+        }
+      }
+    },
+    "script": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "ref", "usage", "summary_key", "actions", "report_schema_file"],
+      "properties": {
+        "id": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "ref": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$" },
+        "usage": { "type": "string" },
+        "summary_key": { "type": "string" },
+        "actions": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" },
+          "minItems": 1
+        },
+        "report_schema_file": {
+          "anyOf": [
+            { "type": "string", "pattern": "^[a-z0-9-]+\\.schema\\.json$" },
+            { "type": "null" }
+          ]
+        }
+      }
+    }
+  }
+}

package/schemas/text-budget-report.schema.json

@@ -0,0 +1,131 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/text-budget-report.schema.json",
+  "title": "mustflow text-budget report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "policy",
+    "input_hash",
+    "metrics",
+    "findings",
+    "artifacts",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "core" },
+    "script_id": { "const": "text-budget" },
+    "script_ref": { "const": "core/text-budget" },
+    "action": { "const": "check" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "metrics": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/metric" }
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "artifacts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/artifact" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "unit": {
+      "description": "Counting unit. The line unit counts line segments after splitting on line breaks, so a trailing line break contributes an empty final line.",
+      "enum": ["grapheme", "code-point", "utf16", "utf8-byte", "word", "line"]
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["min", "max", "exact", "unit", "json_pointer", "max_file_bytes"],
+      "properties": {
+        "min": { "type": ["integer", "null"], "minimum": 0 },
+        "max": { "type": ["integer", "null"], "minimum": 0 },
+        "exact": { "type": ["integer", "null"], "minimum": 0 },
+        "unit": { "$ref": "#/$defs/unit" },
+        "json_pointer": { "type": ["string", "null"] },
+        "max_file_bytes": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "metric": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "value", "unit", "path", "json_pointer", "content_sha256"],
+      "properties": {
+        "name": { "const": "text_length" },
+        "value": { "type": "integer", "minimum": 0 },
+        "unit": { "$ref": "#/$defs/unit" },
+        "path": { "type": "string" },
+        "json_pointer": { "type": ["string", "null"] },
+        "content_sha256": { "$ref": "#/$defs/sha256" }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "message", "path", "json_pointer", "metric", "actual", "expected"],
+      "properties": {
+        "code": {
+          "enum": [
+            "text_budget_above_max",
+            "text_budget_below_min",
+            "text_budget_not_exact",
+            "text_budget_unreadable",
+            "text_budget_json_parse_failed",
+            "text_budget_json_pointer_invalid",
+            "text_budget_json_pointer_missing",
+            "text_budget_json_pointer_not_string"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "json_pointer": { "type": ["string", "null"] },
+        "metric": {
+          "anyOf": [
+            { "const": "text_length" },
+            { "type": "null" }
+          ]
+        },
+        "actual": { "type": ["integer", "null"], "minimum": 0 },
+        "expected": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    },
+    "artifact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path", "sha256", "size_bytes"],
+      "properties": {
+        "kind": { "const": "input" },
+        "path": { "type": "string" },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "size_bytes": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}