mustflow 2.22.17 → 2.22.47

package/schemas/verification-plan.schema.json

@@ -0,0 +1,245 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/verification-plan.schema.json",
+  "title": "mustflow verification plan API report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "source",
+    "status",
+    "verification_plan_id",
+    "classification",
+    "requirements",
+    "candidates",
+    "gaps",
+    "schedule",
+    "test_selection",
+    "execution_policy",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "api verification-plan" },
+    "mustflow_root": { "type": "string" },
+    "source": { "$ref": "#/$defs/source" },
+    "status": { "enum": ["available", "unavailable"] },
+    "verification_plan_id": {
+      "type": ["string", "null"],
+      "pattern": "^sha256:[0-9a-f]{64}$"
+    },
+    "classification": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/classification" }
+      ]
+    },
+    "requirements": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/requirement" }
+    },
+    "candidates": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/candidate" }
+    },
+    "gaps": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/gap" }
+    },
+    "schedule": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/schedule" }
+      ]
+    },
+    "test_selection": {
+      "anyOf": [
+        { "type": "null" },
+        { "$ref": "#/$defs/testSelection" }
+      ]
+    },
+    "execution_policy": { "$ref": "#/$defs/executionPolicy" },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "source": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "command"],
+      "properties": {
+        "kind": { "const": "changed" },
+        "command": { "const": "mf verify --changed --plan-only --json" }
+      }
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "classification": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source",
+        "file_count",
+        "files",
+        "validation_reasons",
+        "public_surface_count",
+        "update_policies",
+        "drift_checks"
+      ],
+      "properties": {
+        "source": { "const": "changed" },
+        "file_count": { "type": "integer", "minimum": 0 },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "validation_reasons": { "$ref": "#/$defs/stringArray" },
+        "public_surface_count": { "type": "integer", "minimum": 0 },
+        "update_policies": { "$ref": "#/$defs/stringArray" },
+        "drift_checks": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "requirement": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "reason",
+        "file_count",
+        "files",
+        "surfaces",
+        "affected_contracts",
+        "drift_checks",
+        "update_policies"
+      ],
+      "properties": {
+        "reason": { "type": "string" },
+        "file_count": { "type": "integer", "minimum": 0 },
+        "files": { "$ref": "#/$defs/stringArray" },
+        "surfaces": { "$ref": "#/$defs/stringArray" },
+        "affected_contracts": { "$ref": "#/$defs/stringArray" },
+        "drift_checks": { "$ref": "#/$defs/stringArray" },
+        "update_policies": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "reason",
+        "intent",
+        "status",
+        "selection_state",
+        "eligibility_state",
+        "candidate_state",
+        "skip_reason",
+        "detail"
+      ],
+      "properties": {
+        "reason": { "type": "string" },
+        "intent": { "type": ["string", "null"] },
+        "status": { "type": "string" },
+        "selection_state": { "type": "string" },
+        "eligibility_state": { "type": "string" },
+        "candidate_state": { "type": "string" },
+        "skip_reason": { "type": ["string", "null"] },
+        "detail": { "type": ["string", "null"] }
+      }
+    },
+    "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" }
+      }
+    },
+    "schedule": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "runner",
+        "entry_count",
+        "batch_count",
+        "selected_intents",
+        "entries",
+        "batches",
+        "notes"
+      ],
+      "properties": {
+        "runner": { "type": "string" },
+        "entry_count": { "type": "integer", "minimum": 0 },
+        "batch_count": { "type": "integer", "minimum": 0 },
+        "selected_intents": { "$ref": "#/$defs/stringArray" },
+        "entries": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scheduleEntry" }
+        },
+        "batches": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scheduleBatch" }
+        },
+        "notes": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "scheduleEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "intent",
+        "run_command",
+        "preview_command",
+        "parallel_eligible",
+        "parallel_reason",
+        "locks",
+        "conflict_count"
+      ],
+      "properties": {
+        "intent": { "type": "string" },
+        "run_command": { "type": ["string", "null"] },
+        "preview_command": { "type": ["string", "null"] },
+        "parallel_eligible": { "type": "boolean" },
+        "parallel_reason": { "type": "string" },
+        "locks": { "$ref": "#/$defs/stringArray" },
+        "conflict_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "scheduleBatch": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["index", "intents", "locks"],
+      "properties": {
+        "index": { "type": "integer", "minimum": 1 },
+        "intents": { "$ref": "#/$defs/stringArray" },
+        "locks": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "testSelection": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "candidate_count", "selected_count", "note"],
+      "properties": {
+        "status": { "type": "string" },
+        "candidate_count": { "type": "integer", "minimum": 0 },
+        "selected_count": { "type": "integer", "minimum": 0 },
+        "note": { "type": ["string", "null"] }
+      }
+    },
+    "executionPolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["plan_command", "run_command", "direct_commands_allowed", "selected_intents_run_via"],
+      "properties": {
+        "plan_command": { "const": "mf verify --changed --plan-only --json" },
+        "run_command": { "const": "mf verify --changed --json" },
+        "direct_commands_allowed": { "const": false },
+        "selected_intents_run_via": { "const": "mf run <intent>" }
+      }
+    }
+  }
+}

package/schemas/workspace-summary.schema.json

@@ -0,0 +1,282 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/workspace-summary.schema.json",
+  "title": "mustflow workspace summary API report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "installed",
+    "manifest_lock",
+    "template",
+    "check",
+    "read_order",
+    "command_surface",
+    "skill_surface",
+    "git_state",
+    "latest_run",
+    "effective_policy",
+    "state_policy",
+    "blocked_actions",
+    "recommended_read_surfaces",
+    "recommended_next_commands",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "api workspace-summary" },
+    "mustflow_root": { "type": "string" },
+    "installed": { "type": "boolean" },
+    "manifest_lock": { "enum": ["missing", "invalid", "present"] },
+    "template": { "$ref": "#/$defs/templateContext" },
+    "check": { "$ref": "#/$defs/check" },
+    "read_order": { "$ref": "#/$defs/readOrder" },
+    "command_surface": { "$ref": "#/$defs/commandSurface" },
+    "skill_surface": { "$ref": "#/$defs/skillSurface" },
+    "git_state": { "$ref": "#/$defs/gitState" },
+    "latest_run": { "$ref": "#/$defs/latestRun" },
+    "effective_policy": { "$ref": "#/$defs/effectivePolicy" },
+    "state_policy": { "$ref": "#/$defs/statePolicy" },
+    "blocked_actions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "recommended_read_surfaces": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "recommended_next_commands": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "templateContext": {
+      "anyOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "version"],
+          "properties": {
+            "id": { "type": "string" },
+            "version": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "check": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "issue_count", "warning_count", "issues", "warnings"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "issue_count": { "type": "integer", "minimum": 0 },
+        "warning_count": { "type": "integer", "minimum": 0 },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "warnings": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "readOrder": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["required", "optional", "missing_required", "missing_optional"],
+      "properties": {
+        "required": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "optional": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "missing_required": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "missing_optional": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "commandSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "total_intents",
+        "runnable_intents",
+        "runnable_count",
+        "non_runnable_count"
+      ],
+      "properties": {
+        "path": { "type": "string" },
+        "exists": { "type": "boolean" },
+        "total_intents": { "type": "integer", "minimum": 0 },
+        "runnable_intents": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "runnable_count": { "type": "integer", "minimum": 0 },
+        "non_runnable_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "skillSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["index_path", "index_exists", "routes_path", "routes_exists"],
+      "properties": {
+        "index_path": { "const": ".mustflow/skills/INDEX.md" },
+        "index_exists": { "type": "boolean" },
+        "routes_path": { "const": ".mustflow/skills/routes.toml" },
+        "routes_exists": { "type": "boolean" }
+      }
+    },
+    "gitState": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "changed_file_count", "changed_files", "error"],
+          "properties": {
+            "status": { "const": "available" },
+            "changed_file_count": { "type": "integer", "minimum": 0 },
+            "changed_files": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "error": { "type": "null" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "changed_file_count", "changed_files", "error"],
+          "properties": {
+            "status": { "const": "unavailable" },
+            "changed_file_count": { "type": "null" },
+            "changed_files": {
+              "type": "array",
+              "maxItems": 0
+            },
+            "error": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "effectivePolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "entrypoint",
+        "nearest_agents",
+        "command_contract",
+        "project_commands_require_mf_run",
+        "allow_inferred_commands",
+        "auto_stage",
+        "auto_commit",
+        "auto_push",
+        "state_is_versioned",
+        "raw_logs_allowed"
+      ],
+      "properties": {
+        "entrypoint": { "type": "string" },
+        "nearest_agents": { "type": "string" },
+        "command_contract": { "type": "string" },
+        "project_commands_require_mf_run": { "type": "boolean" },
+        "allow_inferred_commands": { "type": "boolean" },
+        "auto_stage": { "type": "boolean" },
+        "auto_commit": { "type": "boolean" },
+        "auto_push": { "type": "boolean" },
+        "state_is_versioned": { "type": "boolean" },
+        "raw_logs_allowed": { "type": "boolean" }
+      }
+    },
+    "statePolicy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cache_path",
+        "state_path",
+        "versioned",
+        "safe_to_delete",
+        "stores_raw_conversation",
+        "stores_full_terminal_output",
+        "stores_hidden_chain_of_thought"
+      ],
+      "properties": {
+        "cache_path": { "type": "string" },
+        "state_path": { "type": "string" },
+        "versioned": { "type": "boolean" },
+        "safe_to_delete": { "type": "boolean" },
+        "stores_raw_conversation": { "type": "boolean" },
+        "stores_full_terminal_output": { "type": "boolean" },
+        "stores_hidden_chain_of_thought": { "type": "boolean" }
+      }
+    },
+    "latestRun": {
+      "oneOf": [
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "exists"],
+          "properties": {
+            "path": { "type": "string" },
+            "exists": { "const": false }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "exists", "valid", "error"],
+          "properties": {
+            "path": { "type": "string" },
+            "exists": { "const": true },
+            "valid": { "const": false },
+            "error": { "type": "string" }
+          }
+        },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "path",
+            "exists",
+            "valid",
+            "intent",
+            "status",
+            "timed_out",
+            "exit_code",
+            "finished_at",
+            "duration_ms"
+          ],
+          "properties": {
+            "path": { "type": "string" },
+            "exists": { "const": true },
+            "valid": { "const": true },
+            "intent": { "type": "string" },
+            "status": { "type": "string" },
+            "timed_out": { "type": "boolean" },
+            "exit_code": { "type": ["integer", "null"] },
+            "finished_at": { "type": ["string", "null"] },
+            "duration_ms": { "type": ["integer", "null"] }
+          }
+        }
+      ]
+    }
+  }
+}