mustflow 2.23.0 → 2.24.2

package/schemas/workspace-command-catalog.schema.json

@@ -0,0 +1,172 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/workspace-command-catalog.schema.json",
+  "title": "mustflow workspace command catalog report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "workspace",
+    "policy",
+    "repository_count",
+    "total_intent_count",
+    "runnable_intent_count",
+    "repositories",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "workspace command-catalog" },
+    "mustflow_root": { "type": "string" },
+    "workspace": { "$ref": "#/$defs/workspace" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "repository_count": { "type": "integer", "minimum": 0 },
+    "total_intent_count": { "type": "integer", "minimum": 0 },
+    "runnable_intent_count": { "type": "integer", "minimum": 0 },
+    "repositories": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/repository" }
+    },
+    "issues": { "$ref": "#/$defs/stringArray" }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "nullableString": {
+      "type": ["string", "null"]
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "roots",
+        "max_depth",
+        "max_repositories",
+        "follow_symlinks",
+        "stop_at_repository_root"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "roots": { "$ref": "#/$defs/stringArray" },
+        "max_depth": { "type": "integer", "minimum": 1 },
+        "max_repositories": { "type": "integer", "minimum": 1 },
+        "follow_symlinks": { "type": "boolean" },
+        "stop_at_repository_root": { "type": "boolean" }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "grants_command_authority",
+        "parent_root_grants_child_authority",
+        "command_authority_per_root",
+        "run_entrypoint_per_root",
+        "executes_commands",
+        "raw_commands_included"
+      ],
+      "properties": {
+        "mode": { "const": "read_only" },
+        "grants_command_authority": { "const": false },
+        "parent_root_grants_child_authority": { "const": false },
+        "command_authority_per_root": { "const": ".mustflow/config/commands.toml" },
+        "run_entrypoint_per_root": { "const": "mf run <intent>" },
+        "executes_commands": { "const": false },
+        "raw_commands_included": { "const": false }
+      }
+    },
+    "commandSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "parse_error",
+        "total_intents",
+        "runnable_count",
+        "runnable_intents",
+        "blocked_count"
+      ],
+      "properties": {
+        "path": { "$ref": "#/$defs/nullableString" },
+        "exists": { "type": "boolean" },
+        "parse_error": { "$ref": "#/$defs/nullableString" },
+        "total_intents": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_count": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_intents": { "$ref": "#/$defs/stringArray" },
+        "blocked_count": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relative_path",
+        "status",
+        "command_contract",
+        "intent_count",
+        "runnable_count",
+        "blocked_count",
+        "intents",
+        "issues"
+      ],
+      "properties": {
+        "relative_path": { "type": "string" },
+        "status": { "enum": ["available", "contract_missing", "contract_invalid"] },
+        "command_contract": { "$ref": "#/$defs/commandSurface" },
+        "intent_count": { "type": "integer", "minimum": 0 },
+        "runnable_count": { "type": "integer", "minimum": 0 },
+        "blocked_count": { "type": "integer", "minimum": 0 },
+        "intents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/intent" }
+        },
+        "issues": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "intent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name",
+        "description",
+        "status",
+        "lifecycle",
+        "run_policy",
+        "runnable",
+        "reason_code",
+        "detail",
+        "run_command",
+        "run_from_repository",
+        "timeout_seconds",
+        "required_after",
+        "writes",
+        "network",
+        "destructive"
+      ],
+      "properties": {
+        "name": { "type": "string" },
+        "description": { "$ref": "#/$defs/nullableString" },
+        "status": { "$ref": "#/$defs/nullableString" },
+        "lifecycle": { "$ref": "#/$defs/nullableString" },
+        "run_policy": { "$ref": "#/$defs/nullableString" },
+        "runnable": { "type": "boolean" },
+        "reason_code": { "$ref": "#/$defs/nullableString" },
+        "detail": { "$ref": "#/$defs/nullableString" },
+        "run_command": { "$ref": "#/$defs/nullableString" },
+        "run_from_repository": { "type": "string" },
+        "timeout_seconds": { "type": ["integer", "null"], "minimum": 1 },
+        "required_after": { "$ref": "#/$defs/stringArray" },
+        "writes": { "$ref": "#/$defs/stringArray" },
+        "network": { "type": ["boolean", "null"] },
+        "destructive": { "type": ["boolean", "null"] }
+      }
+    }
+  }
+}

package/schemas/workspace-status.schema.json

@@ -0,0 +1,141 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/workspace-status.schema.json",
+  "title": "mustflow workspace status report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "workspace",
+    "policy",
+    "repository_count",
+    "repositories",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "workspace status" },
+    "mustflow_root": { "type": "string" },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "roots",
+        "max_depth",
+        "max_repositories",
+        "follow_symlinks",
+        "stop_at_repository_root"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "roots": { "$ref": "#/$defs/stringArray" },
+        "max_depth": { "type": "integer", "minimum": 1 },
+        "max_repositories": { "type": "integer", "minimum": 1 },
+        "follow_symlinks": { "type": "boolean" },
+        "stop_at_repository_root": { "type": "boolean" }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "grants_command_authority",
+        "parent_root_grants_child_authority",
+        "command_authority_per_root",
+        "run_entrypoint_per_root",
+        "executes_commands",
+        "raw_commands_included"
+      ],
+      "properties": {
+        "mode": { "const": "read_only" },
+        "grants_command_authority": { "const": false },
+        "parent_root_grants_child_authority": { "const": false },
+        "command_authority_per_root": { "const": ".mustflow/config/commands.toml" },
+        "run_entrypoint_per_root": { "const": "mf run <intent>" },
+        "executes_commands": { "const": false },
+        "raw_commands_included": { "const": false }
+      }
+    },
+    "repository_count": { "type": "integer", "minimum": 0 },
+    "repositories": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/repository" }
+    },
+    "issues": { "$ref": "#/$defs/stringArray" }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "nullableString": {
+      "type": ["string", "null"]
+    },
+    "commandSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "parse_error",
+        "total_intents",
+        "runnable_count",
+        "runnable_intents",
+        "blocked_count"
+      ],
+      "properties": {
+        "path": { "$ref": "#/$defs/nullableString" },
+        "exists": { "type": "boolean" },
+        "parse_error": { "$ref": "#/$defs/nullableString" },
+        "total_intents": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_count": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_intents": { "$ref": "#/$defs/stringArray" },
+        "blocked_count": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relative_path",
+        "status",
+        "git_repository",
+        "mustflow",
+        "agent_rules",
+        "repo_map",
+        "mustflow_config",
+        "command_contract",
+        "context_index",
+        "skill_index",
+        "root_document_count",
+        "machine_contract_count",
+        "manifest_count",
+        "command_adapter_count",
+        "editing_policy_count",
+        "issues"
+      ],
+      "properties": {
+        "relative_path": { "type": "string" },
+        "status": { "enum": ["mustflow_ready", "contract_missing", "contract_invalid"] },
+        "git_repository": { "const": true },
+        "mustflow": { "type": "boolean" },
+        "agent_rules": { "$ref": "#/$defs/nullableString" },
+        "repo_map": { "$ref": "#/$defs/nullableString" },
+        "mustflow_config": { "$ref": "#/$defs/nullableString" },
+        "command_contract": { "$ref": "#/$defs/commandSurface" },
+        "context_index": { "$ref": "#/$defs/nullableString" },
+        "skill_index": { "$ref": "#/$defs/nullableString" },
+        "root_document_count": { "type": "integer", "minimum": 0 },
+        "machine_contract_count": { "type": "integer", "minimum": 0 },
+        "manifest_count": { "type": "integer", "minimum": 0 },
+        "command_adapter_count": { "type": "integer", "minimum": 0 },
+        "editing_policy_count": { "type": "integer", "minimum": 0 },
+        "issues": { "$ref": "#/$defs/stringArray" }
+      }
+    }
+  }
+}

package/schemas/workspace-verification-plan.schema.json

@@ -0,0 +1,195 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/workspace-verification-plan.schema.json",
+  "title": "mustflow workspace verification plan report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "workspace",
+    "policy",
+    "repository_count",
+    "total_changed_file_count",
+    "total_requirement_count",
+    "total_selected_intent_count",
+    "total_gap_count",
+    "repositories",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "workspace verify" },
+    "mustflow_root": { "type": "string" },
+    "workspace": { "$ref": "#/$defs/workspace" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "repository_count": { "type": "integer", "minimum": 0 },
+    "total_changed_file_count": { "type": "integer", "minimum": 0 },
+    "total_requirement_count": { "type": "integer", "minimum": 0 },
+    "total_selected_intent_count": { "type": "integer", "minimum": 0 },
+    "total_gap_count": { "type": "integer", "minimum": 0 },
+    "repositories": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/repository" }
+    },
+    "issues": { "$ref": "#/$defs/stringArray" }
+  },
+  "$defs": {
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "nullableString": {
+      "type": ["string", "null"]
+    },
+    "workspace": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "roots",
+        "max_depth",
+        "max_repositories",
+        "follow_symlinks",
+        "stop_at_repository_root"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "roots": { "$ref": "#/$defs/stringArray" },
+        "max_depth": { "type": "integer", "minimum": 1 },
+        "max_repositories": { "type": "integer", "minimum": 1 },
+        "follow_symlinks": { "type": "boolean" },
+        "stop_at_repository_root": { "type": "boolean" }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "mode",
+        "grants_command_authority",
+        "parent_root_grants_child_authority",
+        "command_authority_per_root",
+        "run_entrypoint_per_root",
+        "executes_commands",
+        "raw_commands_included",
+        "plan_command_per_root",
+        "selected_intents_run_via"
+      ],
+      "properties": {
+        "mode": { "const": "read_only" },
+        "grants_command_authority": { "const": false },
+        "parent_root_grants_child_authority": { "const": false },
+        "command_authority_per_root": { "const": ".mustflow/config/commands.toml" },
+        "run_entrypoint_per_root": { "const": "mf run <intent>" },
+        "executes_commands": { "const": false },
+        "raw_commands_included": { "const": false },
+        "plan_command_per_root": { "const": "mf verify --changed --plan-only --json" },
+        "selected_intents_run_via": { "const": "mf run <intent>" }
+      }
+    },
+    "commandSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "parse_error",
+        "total_intents",
+        "runnable_count",
+        "runnable_intents",
+        "blocked_count"
+      ],
+      "properties": {
+        "path": { "$ref": "#/$defs/nullableString" },
+        "exists": { "type": "boolean" },
+        "parse_error": { "$ref": "#/$defs/nullableString" },
+        "total_intents": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_count": { "type": ["integer", "null"], "minimum": 0 },
+        "runnable_intents": { "$ref": "#/$defs/stringArray" },
+        "blocked_count": { "type": ["integer", "null"], "minimum": 0 }
+      }
+    },
+    "repository": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "relative_path",
+        "status",
+        "command_contract",
+        "changed_file_count",
+        "changed_files",
+        "verification_plan_id",
+        "requirement_count",
+        "candidate_count",
+        "selected_intent_count",
+        "gap_count",
+        "selected_intents",
+        "gaps",
+        "issues"
+      ],
+      "properties": {
+        "relative_path": { "type": "string" },
+        "status": {
+          "enum": [
+            "available",
+            "contract_missing",
+            "contract_invalid",
+            "git_unavailable",
+            "plan_unavailable"
+          ]
+        },
+        "command_contract": { "$ref": "#/$defs/commandSurface" },
+        "changed_file_count": { "type": ["integer", "null"], "minimum": 0 },
+        "changed_files": { "$ref": "#/$defs/stringArray" },
+        "verification_plan_id": {
+          "type": ["string", "null"],
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "requirement_count": { "type": "integer", "minimum": 0 },
+        "candidate_count": { "type": "integer", "minimum": 0 },
+        "selected_intent_count": { "type": "integer", "minimum": 0 },
+        "gap_count": { "type": "integer", "minimum": 0 },
+        "selected_intents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/selectedIntent" }
+        },
+        "gaps": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/gap" }
+        },
+        "issues": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "selectedIntent": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "intent",
+        "run_command",
+        "run_from_repository",
+        "locks",
+        "conflict_count"
+      ],
+      "properties": {
+        "intent": { "type": "string" },
+        "run_command": { "$ref": "#/$defs/nullableString" },
+        "run_from_repository": { "type": "string" },
+        "locks": { "$ref": "#/$defs/stringArray" },
+        "conflict_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "gap": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["reason", "files", "surfaces", "detail"],
+      "properties": {
+        "reason": { "type": "string" },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "surfaces": { "$ref": "#/$defs/stringArray" },
+        "detail": { "type": "string" }
+      }
+    }
+  }
+}

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.23.0"
+version = "2.24.2"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"