mustflow 2.23.0 → 2.25.0

package/schemas/evidence-report.schema.json

@@ -0,0 +1,287 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/evidence-report.schema.json",
+  "title": "mustflow evidence report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "status",
+    "source",
+    "policy",
+    "plan",
+    "latest",
+    "coverage",
+    "recommended_commands",
+    "export_path",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "evidence" },
+    "mustflow_root": { "type": "string" },
+    "status": {
+      "enum": ["verified", "unresolved", "needs_verification", "gaps", "latest_only", "no_changes", "unavailable"]
+    },
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["mode", "changed", "plan_path", "latest_path"],
+      "properties": {
+        "mode": { "enum": ["changed", "latest", "plan"] },
+        "changed": { "type": "boolean" },
+        "plan_path": { "type": ["string", "null"] },
+        "latest_path": { "const": ".mustflow/state/runs/latest.json" }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "command_authority",
+        "direct_commands_allowed",
+        "executes_commands",
+        "grants_command_authority",
+        "raw_output_included",
+        "hidden_reasoning_included",
+        "writes_files"
+      ],
+      "properties": {
+        "mode": { "const": "read_only_report" },
+        "command_authority": { "const": ".mustflow/config/commands.toml" },
+        "direct_commands_allowed": { "const": false },
+        "executes_commands": { "const": false },
+        "grants_command_authority": { "const": false },
+        "raw_output_included": { "const": false },
+        "hidden_reasoning_included": { "const": false },
+        "writes_files": { "type": "boolean" }
+      }
+    },
+    "plan": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/plan" }
+      ]
+    },
+    "latest": { "$ref": "#/$defs/latest" },
+    "coverage": { "$ref": "#/$defs/coverage" },
+    "recommended_commands": { "$ref": "#/$defs/stringArray" },
+    "export_path": { "type": ["string", "null"] },
+    "issues": { "$ref": "#/$defs/stringArray" }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "nullableStringArray": {
+      "type": "array",
+      "items": { "type": ["string", "null"] }
+    },
+    "plan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "status",
+        "verification_plan_id",
+        "changed_file_count",
+        "changed_files",
+        "validation_reasons",
+        "selected_intents",
+        "requirement_count",
+        "gap_count",
+        "requirements",
+        "gaps",
+        "test_selection",
+        "issues"
+      ],
+      "properties": {
+        "source": { "enum": ["changed", "plan_file"] },
+        "status": { "enum": ["available", "unavailable", "no_changes"] },
+        "verification_plan_id": { "type": ["string", "null"] },
+        "changed_file_count": { "type": ["integer", "null"], "minimum": 0 },
+        "changed_files": { "$ref": "#/$defs/stringArray" },
+        "validation_reasons": { "$ref": "#/$defs/stringArray" },
+        "selected_intents": { "$ref": "#/$defs/stringArray" },
+        "requirement_count": { "type": "integer", "minimum": 0 },
+        "gap_count": { "type": "integer", "minimum": 0 },
+        "requirements": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/requirement" }
+        },
+        "gaps": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidenceItem" }
+        },
+        "test_selection": {
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["status", "candidate_count", "selected_count", "note"],
+              "properties": {
+                "status": { "type": ["string", "null"] },
+                "candidate_count": { "type": ["integer", "null"], "minimum": 0 },
+                "selected_count": { "type": ["integer", "null"], "minimum": 0 },
+                "note": { "type": ["string", "null"] }
+              }
+            }
+          ]
+        },
+        "issues": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "reason",
+        "file_count",
+        "files",
+        "surfaces",
+        "affected_contracts",
+        "candidate_intents",
+        "selected_intents",
+        "skipped_intents",
+        "status",
+        "evidence_receipts",
+        "gap_reasons"
+      ],
+      "properties": {
+        "reason": { "type": "string" },
+        "file_count": { "type": "integer", "minimum": 0 },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "surfaces": { "$ref": "#/$defs/stringArray" },
+        "affected_contracts": { "$ref": "#/$defs/stringArray" },
+        "candidate_intents": { "$ref": "#/$defs/stringArray" },
+        "selected_intents": { "$ref": "#/$defs/stringArray" },
+        "skipped_intents": { "$ref": "#/$defs/stringArray" },
+        "status": { "enum": ["covered_by_latest", "selected", "blocked", "unselected"] },
+        "evidence_receipts": { "$ref": "#/$defs/stringArray" },
+        "gap_reasons": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "latest": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "status",
+        "exists",
+        "path",
+        "kind",
+        "verification_plan_id",
+        "applies_to_plan",
+        "completion_verdict_status",
+        "execution_status",
+        "receipt_count",
+        "skipped_check_count",
+        "remaining_risk_count",
+        "requirements",
+        "receipts",
+        "skipped_checks",
+        "remaining_risks",
+        "issues"
+      ],
+      "properties": {
+        "status": { "enum": ["available", "missing", "unavailable", "not_requested"] },
+        "exists": { "type": "boolean" },
+        "path": { "const": ".mustflow/state/runs/latest.json" },
+        "kind": { "enum": ["run_receipt", "verify_run_summary", "unknown", null] },
+        "verification_plan_id": { "type": ["string", "null"] },
+        "applies_to_plan": { "type": ["boolean", "null"] },
+        "completion_verdict_status": { "type": ["string", "null"] },
+        "execution_status": { "type": ["string", "null"] },
+        "receipt_count": { "type": ["integer", "null"], "minimum": 0 },
+        "skipped_check_count": { "type": "integer", "minimum": 0 },
+        "remaining_risk_count": { "type": "integer", "minimum": 0 },
+        "requirements": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/latestRequirement" }
+        },
+        "receipts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/latestReceipt" }
+        },
+        "skipped_checks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidenceItem" }
+        },
+        "remaining_risks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/evidenceItem" }
+        },
+        "issues": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "latestRequirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reason", "outcome", "selected_intents", "skipped_intents"],
+      "properties": {
+        "reason": { "type": "string" },
+        "outcome": { "type": ["string", "null"] },
+        "selected_intents": { "$ref": "#/$defs/stringArray" },
+        "skipped_intents": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "latestReceipt": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["intent", "status", "skipped", "verification_plan_id", "receipt_path", "receipt_sha256"],
+      "properties": {
+        "intent": { "type": ["string", "null"] },
+        "status": { "type": ["string", "null"] },
+        "skipped": { "type": "boolean" },
+        "verification_plan_id": { "type": ["string", "null"] },
+        "receipt_path": { "type": ["string", "null"] },
+        "receipt_sha256": { "type": ["string", "null"] }
+      }
+    },
+    "evidenceItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reason", "intent", "status", "files", "surfaces", "detail"],
+      "properties": {
+        "reason": { "type": ["string", "null"] },
+        "intent": { "type": ["string", "null"] },
+        "status": { "type": ["string", "null"] },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "surfaces": { "$ref": "#/$defs/stringArray" },
+        "detail": { "type": "string" }
+      }
+    },
+    "coverage": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requirement_count",
+        "covered_by_latest_count",
+        "selected_requirement_count",
+        "blocked_requirement_count",
+        "unselected_requirement_count",
+        "selected_intent_count",
+        "receipt_count",
+        "skipped_check_count",
+        "remaining_risk_count",
+        "gap_count"
+      ],
+      "properties": {
+        "requirement_count": { "type": "integer", "minimum": 0 },
+        "covered_by_latest_count": { "type": "integer", "minimum": 0 },
+        "selected_requirement_count": { "type": "integer", "minimum": 0 },
+        "blocked_requirement_count": { "type": "integer", "minimum": 0 },
+        "unselected_requirement_count": { "type": "integer", "minimum": 0 },
+        "selected_intent_count": { "type": "integer", "minimum": 0 },
+        "receipt_count": { "type": "integer", "minimum": 0 },
+        "skipped_check_count": { "type": "integer", "minimum": 0 },
+        "remaining_risk_count": { "type": "integer", "minimum": 0 },
+        "gap_count": { "type": "integer", "minimum": 0 }
+      }
+    }
+  }
+}

package/schemas/explain-report.schema.json

@@ -395,6 +395,7 @@
             "missing_timeout",
             "missing_command_source",
             "unsafe_intent_name",
+            "agent_shell_requires_allow",
             "blocked_shell_background_pattern",
             "blocked_long_running_command_pattern",
             "cwd_outside_project",
@@ -886,8 +887,11 @@
             "missing_timeout",
             "missing_command_source",
             "unsafe_intent_name",
+            "agent_shell_requires_allow",
             "blocked_shell_background_pattern",
             "blocked_long_running_command_pattern",
+            "cwd_outside_project",
+            "max_output_bytes_exceeds_limit",
             null
           ]
         },

package/schemas/next-report.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/next-report.schema.json",
+  "title": "mustflow next report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "status",
+    "policy",
+    "state",
+    "decision",
+    "recommended_commands",
+    "blockers",
+    "warnings",
+    "gaps",
+    "verification_plan_id"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "next" },
+    "mustflow_root": { "type": "string" },
+    "status": {
+      "enum": ["setup_required", "blocked", "idle", "needs_verification", "unavailable"]
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command_authority",
+        "direct_commands_allowed",
+        "grants_command_authority",
+        "writes_files"
+      ],
+      "properties": {
+        "command_authority": { "const": ".mustflow/config/commands.toml" },
+        "direct_commands_allowed": { "const": false },
+        "grants_command_authority": { "const": false },
+        "writes_files": { "const": false }
+      }
+    },
+    "state": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "installed",
+        "check_ok",
+        "command_contract_ok",
+        "git_status",
+        "changed_file_count",
+        "validation_reasons",
+        "selected_intents",
+        "gap_count"
+      ],
+      "properties": {
+        "installed": { "type": "boolean" },
+        "check_ok": { "type": "boolean" },
+        "command_contract_ok": { "type": "boolean" },
+        "git_status": { "enum": ["available", "unavailable"] },
+        "changed_file_count": { "type": ["integer", "null"] },
+        "validation_reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "selected_intents": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "gap_count": { "type": "integer" }
+      }
+    },
+    "decision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "command", "title", "detail"],
+      "properties": {
+        "kind": {
+          "enum": ["setup", "repair", "inspect", "configure_commands", "verify", "none"]
+        },
+        "command": { "type": ["string", "null"] },
+        "title": { "type": "string" },
+        "detail": { "type": "string" }
+      }
+    },
+    "recommended_commands": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "blockers": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "warnings": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "gaps": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["reason", "files", "surfaces", "detail"],
+        "properties": {
+          "reason": { "type": "string" },
+          "files": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "surfaces": {
+            "type": "array",
+            "items": { "type": "string" }
+          },
+          "detail": { "type": "string" }
+        }
+      }
+    },
+    "verification_plan_id": { "type": ["string", "null"] }
+  }
+}

package/schemas/onboard-commands-report.schema.json

@@ -0,0 +1,100 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/onboard-commands-report.schema.json",
+  "title": "mustflow onboard commands report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "command_contract_path",
+    "policy",
+    "summary",
+    "suggestions",
+    "next_steps"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "onboard commands" },
+    "mustflow_root": { "type": "string" },
+    "command_contract_path": { "const": ".mustflow/config/commands.toml" },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "command_authority",
+        "suggestions_grant_command_authority",
+        "suggestions_are_review_only",
+        "writes_files"
+      ],
+      "properties": {
+        "command_authority": { "const": ".mustflow/config/commands.toml" },
+        "suggestions_grant_command_authority": { "const": false },
+        "suggestions_are_review_only": { "const": true },
+        "writes_files": { "const": false }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "total_intents",
+        "runnable_intents",
+        "manual_only_intents",
+        "unknown_intents",
+        "suggestions",
+        "package_scripts",
+        "make_targets",
+        "just_recipes",
+        "contract_errors",
+        "contract_warnings"
+      ],
+      "properties": {
+        "total_intents": { "type": "integer" },
+        "runnable_intents": { "type": "integer" },
+        "manual_only_intents": { "type": "integer" },
+        "unknown_intents": { "type": "integer" },
+        "suggestions": { "type": "integer" },
+        "package_scripts": { "type": "integer" },
+        "make_targets": { "type": "integer" },
+        "just_recipes": { "type": "integer" },
+        "contract_errors": { "type": "integer" },
+        "contract_warnings": { "type": "integer" }
+      }
+    },
+    "suggestions": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "sourceFile",
+          "sourceKind",
+          "sourceName",
+          "commandHint",
+          "suggestedIntent",
+          "status",
+          "reason",
+          "snippet"
+        ],
+        "properties": {
+          "sourceFile": { "type": "string" },
+          "sourceKind": {
+            "enum": ["package_script", "make_target", "just_recipe"]
+          },
+          "sourceName": { "type": "string" },
+          "commandHint": { "type": "string" },
+          "suggestedIntent": { "type": "string" },
+          "status": { "const": "unknown" },
+          "reason": { "type": "string" },
+          "snippet": { "type": "string" }
+        }
+      }
+    },
+    "next_steps": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  }
+}