mustflow 1.15.97

package/schemas/explain-report.schema.json

@@ -0,0 +1,471 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/explain-report.schema.json",
+  "title": "mustflow explain report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "topic",
+    "mustflow_root",
+    "decision"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "explain" },
+    "topic": { "enum": ["anchor", "asset-optimization", "authority", "command", "retention", "skill", "skills", "surface"] },
+    "mustflow_root": { "type": "string" },
+    "decision": {
+      "oneOf": [
+        { "$ref": "#/$defs/authorityDecision" },
+        { "$ref": "#/$defs/commandDecision" },
+        { "$ref": "#/$defs/retentionDecision" },
+        { "$ref": "#/$defs/skillRouteDecision" },
+        { "$ref": "#/$defs/skillRouteAlignmentDecision" },
+        { "$ref": "#/$defs/publicSurfaceDecision" },
+        { "$ref": "#/$defs/sourceAnchorDecision" }
+      ]
+    }
+  },
+  "$defs": {
+    "sourceAnchorDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "inputAnchor",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "anchor"
+      ],
+      "properties": {
+        "kind": { "enum": ["found", "missing"] },
+        "inputAnchor": { "type": "string" },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "const": false },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "anchor": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": [
+            "id",
+            "path",
+            "lineStart",
+            "purpose",
+            "search",
+            "invariant",
+            "risk",
+            "navigationOnly",
+            "canInstructAgent"
+          ],
+          "properties": {
+            "id": { "type": "string" },
+            "path": { "type": "string" },
+            "lineStart": { "type": "integer" },
+            "purpose": { "type": ["string", "null"] },
+            "search": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "invariant": { "type": ["string", "null"] },
+            "risk": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "navigationOnly": { "const": true },
+            "canInstructAgent": { "const": false }
+          }
+        }
+      }
+    },
+    "publicSurfaceDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "inputPath",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "surface"
+      ],
+      "properties": {
+        "kind": { "enum": ["overview", "classified"] },
+        "inputPath": { "type": ["string", "null"] },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "const": false },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "surface": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "kind",
+            "category",
+            "isPublicSurface",
+            "validationReasons",
+            "affectedContracts",
+            "updatePolicy",
+            "driftChecks"
+          ],
+          "properties": {
+            "kind": { "type": "string" },
+            "category": { "type": "string" },
+            "isPublicSurface": { "type": "boolean" },
+            "validationReasons": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "affectedContracts": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "updatePolicy": { "enum": ["update", "update_or_mark_stale", "not_applicable"] },
+            "driftChecks": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "authorityDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "inputPath",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "expectation",
+        "boundary"
+      ],
+      "properties": {
+        "kind": { "enum": ["overview", "recognized", "unrecognized"] },
+        "inputPath": { "type": ["string", "null"] },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "type": "boolean" },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "expectation": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": ["docId", "authority", "lifecycle"],
+          "properties": {
+            "docId": { "type": "string" },
+            "authority": { "type": "string" },
+            "lifecycle": { "type": "string" }
+          }
+        },
+        "boundary": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["role", "canDefine", "cannotDefine"],
+          "properties": {
+            "role": { "type": "string" },
+            "canDefine": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "cannotDefine": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "commandDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "inputCommand",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "intent"
+      ],
+      "properties": {
+        "kind": { "enum": ["allowed", "blocked", "unknown"] },
+        "inputCommand": { "type": "string" },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "type": "boolean" },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "intent": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": [
+            "name",
+            "status",
+            "lifecycle",
+            "runPolicy",
+            "stdin",
+            "timeoutSeconds",
+            "mode",
+            "cwd",
+            "writes",
+            "network",
+            "destructive",
+            "successExitCodes",
+            "requiredAfter"
+          ],
+          "properties": {
+            "name": { "type": "string" },
+            "status": { "type": ["string", "null"] },
+            "lifecycle": { "type": ["string", "null"] },
+            "runPolicy": { "type": ["string", "null"] },
+            "stdin": { "type": ["string", "null"] },
+            "timeoutSeconds": { "type": ["integer", "null"] },
+            "mode": { "enum": ["argv", "shell", "missing"] },
+            "cwd": { "type": ["string", "null"] },
+            "writes": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "network": { "type": ["boolean", "null"] },
+            "destructive": { "type": ["boolean", "null"] },
+            "successExitCodes": {
+              "type": "array",
+              "items": { "type": "integer" }
+            },
+            "requiredAfter": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "retentionDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "retention"
+      ],
+      "properties": {
+        "kind": { "const": "retention" },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "const": false },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "retention": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "enabled",
+            "rawEvents",
+            "runReceipts",
+            "knowledge",
+            "context",
+            "repoMap"
+          ],
+          "properties": {
+            "enabled": { "type": "boolean" },
+            "rawEvents": { "$ref": "#/$defs/rawEventsRetention" },
+            "runReceipts": { "$ref": "#/$defs/runReceiptsRetention" },
+            "knowledge": { "$ref": "#/$defs/knowledgeRetention" },
+            "context": { "$ref": "#/$defs/contextRetention" },
+            "repoMap": { "$ref": "#/$defs/repoMapRetention" }
+          }
+        }
+      }
+    },
+    "skillRouteDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "inputSkill",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "route"
+      ],
+      "properties": {
+        "kind": { "const": "skill_route" },
+        "inputSkill": { "type": "string" },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "const": false },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "route": {
+          "type": ["object", "null"],
+          "additionalProperties": false,
+          "required": [
+            "skill",
+            "skillPath",
+            "trigger",
+            "requiredInput",
+            "editScope",
+            "risk",
+            "verificationIntents",
+            "expectedOutput",
+            "declaredCommandIntents"
+          ],
+          "properties": {
+            "skill": { "type": "string" },
+            "skillPath": { "type": "string" },
+            "trigger": { "type": "string" },
+            "requiredInput": { "type": "string" },
+            "editScope": { "type": "string" },
+            "risk": { "type": "string" },
+            "verificationIntents": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "expectedOutput": { "type": "string" },
+            "declaredCommandIntents": {
+              "type": "array",
+              "items": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "skillRouteAlignmentDecision": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "decision",
+        "reason",
+        "effectiveAction",
+        "countsAsMustflowVerification",
+        "sourceFiles",
+        "alignment"
+      ],
+      "properties": {
+        "kind": { "const": "skill_routes" },
+        "decision": { "type": "string" },
+        "reason": { "type": "string" },
+        "effectiveAction": { "type": "string" },
+        "countsAsMustflowVerification": { "const": false },
+        "sourceFiles": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "alignment": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["status", "issueCount", "issues", "summary", "action"],
+          "properties": {
+            "status": { "enum": ["ok", "fail"] },
+            "issueCount": { "type": "integer" },
+            "issues": {
+              "type": "array",
+              "items": { "type": "string" }
+            },
+            "summary": { "type": "string" },
+            "action": { "type": ["string", "null"] }
+          }
+        }
+      }
+    },
+    "rawEventsRetention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["store", "maxFileMb", "maxTotalMb", "maxAgeDays", "onLimit"],
+      "properties": {
+        "store": { "type": ["string", "null"] },
+        "maxFileMb": { "type": ["integer", "null"] },
+        "maxTotalMb": { "type": ["integer", "null"] },
+        "maxAgeDays": { "type": ["integer", "null"] },
+        "onLimit": { "type": ["string", "null"] }
+      }
+    },
+    "runReceiptsRetention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "store",
+        "maxFileKb",
+        "maxItems",
+        "maxTotalMb",
+        "stdoutTailBytes",
+        "stderrTailBytes"
+      ],
+      "properties": {
+        "store": { "type": "string" },
+        "maxFileKb": { "type": "integer" },
+        "maxItems": { "type": "integer" },
+        "maxTotalMb": { "type": "integer" },
+        "stdoutTailBytes": { "type": "integer" },
+        "stderrTailBytes": { "type": "integer" }
+      }
+    },
+    "knowledgeRetention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "store", "maxFileKb", "maxTotalMb"],
+      "properties": {
+        "enabled": { "type": ["boolean", "null"] },
+        "store": { "type": ["string", "null"] },
+        "maxFileKb": { "type": "integer" },
+        "maxTotalMb": { "type": ["integer", "null"] }
+      }
+    },
+    "contextRetention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxFileKb"],
+      "properties": {
+        "maxFileKb": { "type": "integer" }
+      }
+    },
+    "repoMapRetention": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["maxFileKb", "failIfLarger"],
+      "properties": {
+        "maxFileKb": { "type": "integer" },
+        "failIfLarger": { "type": "boolean" }
+      }
+    }
+  }
+}

package/schemas/impact-report.schema.json

@@ -0,0 +1,121 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/impact-report.schema.json",
+  "title": "mustflow impact report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mustflow_root",
+    "source",
+    "files",
+    "versioning_enabled",
+    "version_sources",
+    "classification_summary",
+    "version_impact"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "impact" },
+    "mustflow_root": { "type": "string" },
+    "source": { "enum": ["changed", "paths"] },
+    "files": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "versioning_enabled": { "type": "boolean" },
+    "version_sources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/versionSource" }
+    },
+    "classification_summary": { "$ref": "#/$defs/classificationSummary" },
+    "version_impact": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "requiresVersionDecision",
+        "severity",
+        "suggestedBump",
+        "reasons",
+        "affectedVersionSources",
+        "affectedSurfaces"
+      ],
+      "properties": {
+        "requiresVersionDecision": { "type": "boolean" },
+        "severity": { "enum": ["none", "metadata", "contract"] },
+        "suggestedBump": { "enum": ["minor", "patch", null] },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "affectedVersionSources": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "affectedSurfaces": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  },
+  "$defs": {
+    "versionSource": {
+      "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"]
+        }
+      }
+    },
+    "classificationSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "fileCount",
+        "publicSurfaceCount",
+        "changeKinds",
+        "validationReasons",
+        "updatePolicies",
+        "driftChecks",
+        "affectedContracts"
+      ],
+      "properties": {
+        "fileCount": { "type": "integer" },
+        "publicSurfaceCount": { "type": "integer" },
+        "changeKinds": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "validationReasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "updatePolicies": {
+          "type": "array",
+          "items": { "enum": ["update", "update_or_mark_stale"] }
+        },
+        "driftChecks": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "affectedContracts": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/schemas/line-endings-report.schema.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/line-endings-report.schema.json",
+  "title": "mustflow line-endings report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mode",
+    "scope",
+    "ok",
+    "mustflow_root",
+    "policy",
+    "policy_path",
+    "git_tracked",
+    "checked_files",
+    "non_compliant_files",
+    "changed_files",
+    "dry_run",
+    "wrote_files",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "line-endings" },
+    "mode": { "enum": ["check", "normalize"] },
+    "scope": { "enum": ["changed", "tracked"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "policy": { "enum": ["lf", "unknown"] },
+    "policy_path": { "type": ["string", "null"] },
+    "git_tracked": { "type": "boolean" },
+    "checked_files": { "type": "integer" },
+    "non_compliant_files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/lineEndingFile" }
+    },
+    "changed_files": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "dry_run": { "type": "boolean" },
+    "wrote_files": { "type": "boolean" },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "lineEndingFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "lineEnding", "wouldChange", "changed"],
+      "properties": {
+        "path": { "type": "string" },
+        "lineEnding": { "enum": ["lf", "crlf", "mixed", "none", "binary"] },
+        "wouldChange": { "type": "boolean" },
+        "changed": { "type": "boolean" }
+      }
+    }
+  }
+}