mustflow 1.15.97

package/schemas/context-report.schema.json

@@ -0,0 +1,341 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/context-report.schema.json",
+  "title": "mustflow context report",
+  "type": "object",
+  "oneOf": [
+    { "$ref": "#/$defs/agentContextReport" },
+    { "$ref": "#/$defs/promptCacheProfileReport" }
+  ],
+  "$defs": {
+    "agentContextReport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "command",
+        "mustflow_root",
+        "installed",
+        "manifest_lock",
+        "template",
+        "authority",
+        "capabilities",
+        "read_order",
+        "optional_read_order",
+        "command_contract",
+        "effective_policy",
+        "state_policy",
+        "blocked_actions",
+        "latest_run",
+        "issues"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "command": { "const": "context" },
+        "mustflow_root": { "type": "string" },
+        "installed": { "type": "boolean" },
+        "manifest_lock": { "enum": ["missing", "invalid", "present"] },
+        "template": { "$ref": "#/$defs/templateContext" },
+        "authority": { "$ref": "#/$defs/scalarObject" },
+        "capabilities": { "$ref": "#/$defs/scalarObject" },
+        "read_order": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/pathContext" }
+        },
+        "optional_read_order": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/pathContext" }
+        },
+        "command_contract": { "$ref": "#/$defs/commandContractContext" },
+        "effective_policy": { "$ref": "#/$defs/effectivePolicy" },
+        "state_policy": { "$ref": "#/$defs/statePolicy" },
+        "blocked_actions": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "latest_run": { "$ref": "#/$defs/latestRun" },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptCacheProfileReport": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "command",
+        "cache_profile",
+        "prompt_cache",
+        "issues"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "command": { "const": "context" },
+        "cache_profile": { "enum": ["stable", "task", "volatile", "all"] },
+        "prompt_cache": { "$ref": "#/$defs/promptCacheSettings" },
+        "stable_prefix": { "$ref": "#/$defs/stablePrefixLayer" },
+        "task_context": { "$ref": "#/$defs/taskContextLayer" },
+        "volatile_suffix": { "$ref": "#/$defs/volatileSuffixLayer" },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "templateContext": {
+      "anyOf": [
+        { "type": "null" },
+        {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["id", "version"],
+          "properties": {
+            "id": { "type": "string" },
+            "version": { "type": "string" }
+          }
+        }
+      ]
+    },
+    "scalar": { "type": ["string", "number", "boolean", "null"] },
+    "scalarObject": {
+      "type": "object",
+      "additionalProperties": {
+        "anyOf": [
+          { "$ref": "#/$defs/scalar" },
+          {
+            "type": "array",
+            "items": { "$ref": "#/$defs/scalar" }
+          }
+        ]
+      }
+    },
+    "pathContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "exists"],
+      "properties": {
+        "path": { "type": "string" },
+        "exists": { "type": "boolean" }
+      }
+    },
+    "intentContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "status", "lifecycle", "run_policy", "description"],
+      "properties": {
+        "name": { "type": "string" },
+        "status": { "type": "string" },
+        "lifecycle": { "type": ["string", "null"] },
+        "run_policy": { "type": ["string", "null"] },
+        "description": { "type": ["string", "null"] }
+      }
+    },
+    "commandContractContext": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "exists", "intents", "runnable_intents"],
+      "properties": {
+        "path": { "type": "string" },
+        "exists": { "type": "boolean" },
+        "intents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/intentContext" }
+        },
+        "runnable_intents": {
+          "type": "array",
+          "items": { "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"] }
+          }
+        }
+      ]
+    },
+    "promptCacheSettings": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "strategy",
+        "stable_prefix_policy",
+        "prefer_references_when_unchanged",
+        "exclude_volatile_state_from_prefix",
+        "include_content_hashes",
+        "max_stable_prefix_kb",
+        "max_task_context_kb",
+        "max_volatile_suffix_kb"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "strategy": { "type": ["string", "null"] },
+        "stable_prefix_policy": { "type": ["string", "null"] },
+        "prefer_references_when_unchanged": { "type": "boolean" },
+        "exclude_volatile_state_from_prefix": { "type": "boolean" },
+        "include_content_hashes": { "type": "boolean" },
+        "max_stable_prefix_kb": { "type": ["integer", "null"] },
+        "max_task_context_kb": { "type": ["integer", "null"] },
+        "max_volatile_suffix_kb": { "type": ["integer", "null"] }
+      }
+    },
+    "stablePrefixLayer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cache_layer", "cache_key", "policy", "documents", "volatile_excluded"],
+      "properties": {
+        "cache_layer": { "const": "stable" },
+        "cache_key": { "type": ["string", "null"] },
+        "policy": { "type": ["string", "null"] },
+        "documents": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptCacheDocument" }
+        },
+        "volatile_excluded": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptCacheDocument": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "exists", "content_hash"],
+      "properties": {
+        "path": { "type": "string" },
+        "exists": { "type": "boolean" },
+        "content_hash": { "type": ["string", "null"] }
+      }
+    },
+    "taskContextLayer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cache_layer", "read_policy", "sources"],
+      "properties": {
+        "cache_layer": { "const": "task" },
+        "read_policy": { "type": ["string", "null"] },
+        "sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "volatileSuffixLayer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cache_layer",
+        "sources",
+        "never_place_before_stable_prefix",
+        "include_absolute_root",
+        "include_latest_run"
+      ],
+      "properties": {
+        "cache_layer": { "const": "volatile" },
+        "sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "never_place_before_stable_prefix": { "type": "boolean" },
+        "include_absolute_root": { "const": false },
+        "include_latest_run": { "const": false }
+      }
+    }
+  }
+}

package/schemas/contract-lint-report.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/contract-lint-report.schema.json",
+  "title": "mustflow contract-lint report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "command", "mustflow_root", "report"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "contract-lint" },
+    "mustflow_root": { "type": "string" },
+    "report": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "summary", "issues", "sourceFiles"],
+      "properties": {
+        "status": { "enum": ["passed", "warning", "failed"] },
+        "summary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "totalIntents",
+            "configured",
+            "runnable",
+            "manualOnly",
+            "unknown",
+            "errors",
+            "warnings"
+          ],
+          "properties": {
+            "totalIntents": { "type": "integer" },
+            "configured": { "type": "integer" },
+            "runnable": { "type": "integer" },
+            "manualOnly": { "type": "integer" },
+            "unknown": { "type": "integer" },
+            "errors": { "type": "integer" },
+            "warnings": { "type": "integer" }
+          }
+        },
+        "issues": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["severity", "code", "intent", "message"],
+            "properties": {
+              "severity": { "enum": ["error", "warning"] },
+              "code": { "type": "string" },
+              "intent": { "type": ["string", "null"] },
+              "message": { "type": "string" }
+            }
+          }
+        },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/docs-review-list.schema.json

@@ -0,0 +1,72 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/docs-review-list.schema.json",
+  "title": "mustflow docs review list output",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "command", "ledger_path", "count", "documents"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "docs review list" },
+    "ledger_path": { "const": ".mustflow/review/docs.toml" },
+    "count": { "type": "integer" },
+    "documents": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/document" }
+    }
+  },
+  "$defs": {
+    "document": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "status",
+        "origin",
+        "reason",
+        "first_seen_at",
+        "last_touched_at",
+        "review_priority",
+        "release_blocking",
+        "triage_reason"
+      ],
+      "properties": {
+        "path": { "type": "string" },
+        "status": {
+          "enum": ["pending", "in_review", "changes_made", "approved", "needs_human", "ignored"]
+        },
+        "origin": { "type": "string" },
+        "reason": { "type": "string" },
+        "first_seen_at": { "type": "string" },
+        "last_touched_at": { "type": "string" },
+        "review_priority": { "enum": ["P0", "P1", "P2"] },
+        "release_blocking": { "type": "boolean" },
+        "triage_reason": {
+          "enum": [
+            "release_contract",
+            "authority_or_security_skill",
+            "default_template_source",
+            "english_command_doc",
+            "user_visible_doc",
+            "translation_review_debt",
+            "test_fixture"
+          ]
+        },
+        "last_touched_by_kind": { "enum": ["human", "llm", "tool", "external"] },
+        "last_touched_by_id": { "type": "string" },
+        "reviewed_at": { "type": "string" },
+        "reviewer_kind": { "enum": ["human", "llm", "tool", "external"] },
+        "reviewer_id": { "type": "string" },
+        "reviewer_label": { "type": "string" },
+        "reviewer_provider": { "type": "string" },
+        "reviewer_model": { "type": "string" },
+        "reviewer_command_intent": { "type": "string" },
+        "review_summary": { "type": "string" },
+        "review_comment": { "type": "string" },
+        "commented_at": { "type": "string" },
+        "commented_by_kind": { "enum": ["human", "llm", "tool", "external"] },
+        "commented_by_id": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/doctor-report.schema.json

@@ -0,0 +1,175 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/doctor-report.schema.json",
+  "title": "mustflow doctor report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "installed",
+    "strict",
+    "ok",
+    "check",
+    "context",
+    "effective_policy",
+    "state_policy",
+    "blocked_actions",
+    "diagnostics",
+    "next_steps"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "doctor" },
+    "mustflow_root": { "type": "string" },
+    "installed": { "type": "boolean" },
+    "strict": { "type": "boolean" },
+    "ok": { "type": "boolean" },
+    "check": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["ok", "issue_count", "issues"],
+      "properties": {
+        "ok": { "type": "boolean" },
+        "issue_count": { "type": "integer" },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "context": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "manifest_lock",
+        "template",
+        "command_contract_exists",
+        "runnable_intents",
+        "missing_read_order",
+        "missing_optional_read_order",
+        "latest_run_exists"
+      ],
+      "properties": {
+        "manifest_lock": { "enum": ["missing", "invalid", "present"] },
+        "template": {
+          "anyOf": [
+            { "type": "null" },
+            {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["id", "version"],
+              "properties": {
+                "id": { "type": "string" },
+                "version": { "type": "string" }
+              }
+            }
+          ]
+        },
+        "command_contract_exists": { "type": "boolean" },
+        "runnable_intents": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "missing_read_order": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "missing_optional_read_order": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "latest_run_exists": { "type": "boolean" }
+      }
+    },
+    "effective_policy": { "$ref": "#/$defs/effectivePolicy" },
+    "state_policy": { "$ref": "#/$defs/statePolicy" },
+    "blocked_actions": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "diagnostics": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["id", "status", "summary", "action"],
+        "properties": {
+          "id": {
+            "enum": [
+              "install",
+              "validation",
+              "skill_routes",
+              "commands",
+              "read_order",
+              "optional_read_order",
+              "repo_map",
+              "local_index",
+              "latest_run"
+            ]
+          },
+          "status": { "enum": ["ok", "warn", "fail", "info"] },
+          "summary": { "type": "string" },
+          "action": { "type": ["string", "null"] }
+        }
+      }
+    },
+    "next_steps": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "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" }
+      }
+    }
+  }
+}