mustflow 1.15.97

package/schemas/run-receipt.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/run-receipt.schema.json",
+  "title": "mustflow run receipt",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "intent",
+    "status",
+    "timed_out",
+    "started_at",
+    "finished_at",
+    "duration_ms",
+    "cwd",
+    "lifecycle",
+    "run_policy",
+    "mode",
+    "timeout_seconds",
+    "max_output_bytes",
+    "success_exit_codes",
+    "exit_code",
+    "signal",
+    "error",
+    "kill_method",
+    "stdout",
+    "stderr",
+    "receipt_path"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "run" },
+    "intent": { "type": "string" },
+    "status": { "enum": ["passed", "failed", "timed_out", "start_failed"] },
+    "timed_out": { "type": "boolean" },
+    "started_at": { "type": "string", "format": "date-time" },
+    "finished_at": { "type": "string", "format": "date-time" },
+    "duration_ms": { "type": "integer" },
+    "cwd": { "type": "string" },
+    "lifecycle": { "type": "string" },
+    "run_policy": { "type": "string" },
+    "mode": { "enum": ["argv", "shell"] },
+    "argv": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "cmd": { "type": "string" },
+    "timeout_seconds": { "type": "integer" },
+    "max_output_bytes": { "type": "integer" },
+    "success_exit_codes": {
+      "type": "array",
+      "items": { "type": "integer" }
+    },
+    "exit_code": { "type": ["integer", "null"] },
+    "signal": { "type": ["string", "null"] },
+    "error": { "type": ["string", "null"] },
+    "kill_method": { "type": ["string", "null"] },
+    "stdout": { "$ref": "#/$defs/output" },
+    "stderr": { "$ref": "#/$defs/output" },
+    "receipt_path": { "type": "string" }
+  },
+  "$defs": {
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["bytes", "truncated", "tail"],
+      "properties": {
+        "bytes": { "type": "integer" },
+        "truncated": { "type": "boolean" },
+        "tail": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/verify-report.schema.json

@@ -0,0 +1,67 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/verify-report.schema.json",
+  "title": "mustflow verify report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "reason",
+    "reasons",
+    "plan_source",
+    "status",
+    "summary",
+    "results"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "verify" },
+    "mustflow_root": { "type": "string" },
+    "reason": { "type": "string" },
+    "reasons": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "plan_source": { "type": ["string", "null"] },
+    "status": { "enum": ["passed", "partial", "failed", "blocked"] },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["matched", "ran", "passed", "failed", "skipped"],
+      "properties": {
+        "matched": { "type": "integer" },
+        "ran": { "type": "integer" },
+        "passed": { "type": "integer" },
+        "failed": { "type": "integer" },
+        "skipped": { "type": "integer" }
+      }
+    },
+    "results": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "intent",
+          "status",
+          "skipped",
+          "reason",
+          "detail",
+          "exit_code",
+          "receipt"
+        ],
+        "properties": {
+          "intent": { "type": ["string", "null"] },
+          "status": { "enum": ["passed", "failed", "timed_out", "start_failed", "skipped"] },
+          "skipped": { "type": "boolean" },
+          "reason": { "type": ["string", "null"] },
+          "detail": { "type": ["string", "null"] },
+          "exit_code": { "type": ["integer", "null"] },
+          "receipt": { "type": ["object", "null"] }
+        }
+      }
+    }
+  }
+}

package/schemas/version-sources-report.schema.json

@@ -0,0 +1,42 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/version-sources-report.schema.json",
+  "title": "mustflow version sources report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "versioning_enabled",
+    "sources"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "version-sources" },
+    "mustflow_root": { "type": "string" },
+    "versioning_enabled": { "type": "boolean" },
+    "sources": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["path", "kind"],
+        "properties": {
+          "path": { "type": "string" },
+          "kind": {
+            "enum": [
+              "template_lock",
+              "template_manifest",
+              "package_manifest"
+            ]
+          },
+          "declared": { "type": "boolean" },
+          "authority": {
+            "enum": ["source", "derived"]
+          }
+        }
+      }
+    }
+  }
+}

package/templates/default/common/.mustflow/config/commands.toml

@@ -0,0 +1,251 @@
+schema_version = "1"
+
+# This file is the command-intent contract that prevents agents from guessing commands.
+# mf run executes only configured + oneshot + agent_allowed + closed stdin + explicit timeout + declared command intents.
+# cwd must stay inside the current mustflow root.
+
+[defaults]
+missing_behavior = "do_not_guess"
+allow_inferred_commands = false
+require_lifecycle = true
+require_timeout_for_oneshot = true
+deny_unmanaged_long_running = true
+default_cwd = "."
+default_timeout_seconds = 600
+stdin = "closed"
+max_output_bytes = 1048576
+on_timeout = "terminate_process_tree"
+kill_after_seconds = 5
+
+[intents.test]
+status = "unknown"
+description = "Run the test suite."
+reason = "This repository has not declared its test command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["code_change", "behavior_change"]
+
+[intents.test_related]
+status = "unknown"
+description = "Run tests directly related to changed files."
+reason = "This repository has not declared its related-test command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["code_change", "behavior_change", "test_change"]
+
+[intents.test_fast]
+status = "unknown"
+description = "Run the fast test baseline."
+reason = "This repository has not declared its fast-test command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["low_risk_code_change", "copy_change", "i18n_change"]
+
+[intents.test_coverage]
+status = "manual_only"
+description = "Inspect test coverage information."
+reason = "Coverage runs may be slow or require repository-specific interpretation."
+agent_action = "do_not_run_report_manual"
+required_after = ["test_policy_change", "coverage_request"]
+
+[intents.test_audit]
+status = "unknown"
+description = "Inspect stale or redundant test candidates."
+reason = "This repository has not declared its test-audit command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["test_change", "behavior_removed", "public_api_change"]
+
+[intents.test_release]
+status = "unknown"
+description = "Run release-sensitive package metadata and packaging tests."
+reason = "This repository has not declared its release-test command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["package_metadata_change", "template_version_change", "packaging_change"]
+
+[intents.snapshot_update]
+status = "manual_only"
+description = "Update snapshot test baselines."
+reason = "Snapshot updates can hide unintended output changes and require explicit review."
+agent_action = "do_not_update_snapshots_without_approval"
+required_after = ["snapshot_change", "user_approved_snapshot_update"]
+
+[intents.asset_optimize]
+status = "unknown"
+description = "Optimize web image assets with the repository's declared image pipeline."
+reason = "No image optimization command has been declared for this repository."
+agent_action = "do_not_guess_report_missing"
+required_after = ["image_asset_change", "web_asset_change"]
+
+[intents.lint]
+status = "unknown"
+description = "Run linting or static analysis."
+reason = "This repository has not declared its lint command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["code_change", "style_change"]
+
+[intents.line_endings_check]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Inspect tracked files for CRLF or mixed line-ending drift."
+argv = ["mf", "line-endings", "check", "--json"]
+cwd = "."
+timeout_seconds = 120
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["line_ending_warning", "formatting_change"]
+
+[intents.line_endings_normalize]
+status = "manual_only"
+description = "Normalize tracked text files to the repository line-ending policy."
+reason = "Line-ending normalization rewrites tracked files and requires an explicit request."
+agent_action = "do_not_normalize_report_suggestion_only"
+required_after = ["user_requested_line_ending_normalization"]
+
+[intents.build]
+status = "unknown"
+description = "Run build or type checks."
+reason = "This repository has not declared its build command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["build_config_change", "public_api_change"]
+
+[intents.docs_validate]
+status = "unknown"
+description = "Validate full documentation links, examples, generated docs, search index, and sitemap output."
+reason = "This repository has not declared its documentation validation command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["docs_site_config_change", "release_risk", "before_publish"]
+
+[intents.docs_validate_fast]
+status = "unknown"
+description = "Validate documentation navigation and localized content links without a full static build."
+reason = "This repository has not declared its fast documentation validation command yet."
+agent_action = "do_not_guess_report_missing"
+required_after = ["docs_change", "copy_change", "i18n_change"]
+
+[intents.mustflow_doctor]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Diagnose the mustflow root state, check result, and next steps read-only."
+argv = ["mf", "doctor", "--json"]
+cwd = "."
+timeout_seconds = 300
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["before_task", "mustflow_config_change", "mustflow_docs_change"]
+
+[intents.mustflow_check]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Strictly validate the mustflow document flow and configuration files."
+argv = ["mf", "check", "--strict"]
+cwd = "."
+timeout_seconds = 300
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["mustflow_config_change", "mustflow_docs_change"]
+
+[intents.mustflow_update_dry_run]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Preview installed mustflow workflow template updates without writing files."
+argv = ["mf", "update", "--dry-run", "--json"]
+cwd = "."
+timeout_seconds = 300
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["mustflow_config_change", "mustflow_docs_change", "template_update_check"]
+
+[intents.mustflow_update_apply]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Apply safe installed mustflow workflow template updates after a clean update plan."
+argv = ["mf", "update", "--apply", "--json"]
+cwd = "."
+timeout_seconds = 300
+stdin = "closed"
+success_exit_codes = [0]
+writes = [
+  "AGENTS.md",
+  ".mustflow/config/manifest.lock.toml",
+  ".mustflow/config/commands.toml",
+  ".mustflow/config/mustflow.toml",
+  ".mustflow/config/preferences.toml",
+  ".mustflow/context/**",
+  ".mustflow/docs/**",
+  ".mustflow/skills/**",
+  ".mustflow/backups/**",
+]
+network = false
+destructive = false
+required_after = ["clean_mustflow_update_plan", "template_update_apply"]
+
+[intents.repo_map]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Create or refresh the REPO_MAP.md repository navigation map."
+argv = ["mf", "map", "--write"]
+cwd = "."
+timeout_seconds = 300
+stdin = "closed"
+success_exit_codes = [0]
+writes = ["REPO_MAP.md"]
+network = false
+destructive = false
+required_after = ["structure_change", "directory_change"]
+
+[intents.changes_status]
+status = "configured"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Inspect changed files in the Git working tree read-only."
+argv = ["git", "status", "--short"]
+cwd = "."
+timeout_seconds = 120
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["before_final_report", "commit_message_suggestion"]
+
+[intents.changes_diff_summary]
+status = "configured"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Inspect a read-only summary of Git changes."
+argv = ["git", "diff", "--stat"]
+cwd = "."
+timeout_seconds = 120
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["before_final_report", "commit_message_suggestion"]
+
+[intents.git_commit]
+status = "manual_only"
+description = "Create a Git commit."
+reason = "Creating a commit requires explicit user approval."
+agent_action = "do_not_commit_report_suggestion_only"