mustflow 2.75.1 → 2.84.0

package/schemas/export-diff-report.schema.json

@@ -0,0 +1,220 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/export-diff-report.schema.json",
+  "title": "mustflow export-diff report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "policy",
+    "input_hash",
+    "package_surface",
+    "files",
+    "exports",
+    "summary",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "code" },
+    "script_id": { "const": "export-diff" },
+    "script_ref": { "const": "code/export-diff" },
+    "action": { "const": "compare" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "package_surface": { "$ref": "#/$defs/packageSurface" },
+    "files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/file" }
+    },
+    "exports": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/exportEntry" }
+    },
+    "summary": { "$ref": "#/$defs/summary" },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "sha256Nullable": {
+      "anyOf": [
+        { "$ref": "#/$defs/sha256" },
+        { "type": "null" }
+      ]
+    },
+    "language": {
+      "enum": ["typescript", "tsx", "javascript", "jsx", "javascript-module", "javascript-commonjs", "astro", "svelte", "go", "rust", "python"]
+    },
+    "symbolKind": {
+      "enum": ["function", "class", "interface", "type", "enum", "variable"]
+    },
+    "returnBehavior": {
+      "enum": ["value", "void", "implicit_undefined", "mixed", "throws_only", "unknown"]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "base_ref",
+        "head_ref",
+        "compare_worktree",
+        "max_files",
+        "max_file_bytes",
+        "extensions",
+        "ignored_directories",
+        "path_filters"
+      ],
+      "properties": {
+        "base_ref": { "type": "string" },
+        "head_ref": { "type": ["string", "null"] },
+        "compare_worktree": { "type": "boolean" },
+        "max_files": { "type": "integer", "minimum": 1 },
+        "max_file_bytes": { "type": "integer", "minimum": 1 },
+        "extensions": { "$ref": "#/$defs/stringArray" },
+        "ignored_directories": { "$ref": "#/$defs/stringArray" },
+        "path_filters": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "packageSurface": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["package_json_present", "type", "exports", "bin", "types"],
+      "properties": {
+        "package_json_present": { "type": "boolean" },
+        "type": { "type": ["string", "null"] },
+        "exports": { "$ref": "#/$defs/stringArray" },
+        "bin": { "$ref": "#/$defs/stringArray" },
+        "types": { "type": ["string", "null"] }
+      }
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "path",
+        "language",
+        "base_sha256",
+        "head_sha256",
+        "base_exists",
+        "head_exists",
+        "exported_count_before",
+        "exported_count_after"
+      ],
+      "properties": {
+        "kind": { "const": "source_file" },
+        "path": { "type": "string" },
+        "language": { "$ref": "#/$defs/language" },
+        "base_sha256": { "$ref": "#/$defs/sha256Nullable" },
+        "head_sha256": { "$ref": "#/$defs/sha256Nullable" },
+        "base_exists": { "type": "boolean" },
+        "head_exists": { "type": "boolean" },
+        "exported_count_before": { "type": "integer", "minimum": 0 },
+        "exported_count_after": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "symbolSnapshot": {
+      "type": ["object", "null"],
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "name",
+        "kind",
+        "language",
+        "signature",
+        "return_type",
+        "return_behavior",
+        "async",
+        "line"
+      ],
+      "properties": {
+        "path": { "type": "string" },
+        "name": { "type": "string" },
+        "kind": { "$ref": "#/$defs/symbolKind" },
+        "language": { "$ref": "#/$defs/language" },
+        "signature": { "type": "string" },
+        "return_type": { "type": ["string", "null"] },
+        "return_behavior": { "$ref": "#/$defs/returnBehavior" },
+        "async": { "type": "boolean" },
+        "line": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "exportEntry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "path", "name", "kind", "change", "before", "after", "compatibility"],
+      "properties": {
+        "id": { "type": "string" },
+        "path": { "type": "string" },
+        "name": { "type": "string" },
+        "kind": { "$ref": "#/$defs/symbolKind" },
+        "change": { "enum": ["added", "removed", "changed", "unchanged"] },
+        "before": { "$ref": "#/$defs/symbolSnapshot" },
+        "after": { "$ref": "#/$defs/symbolSnapshot" },
+        "compatibility": {
+          "enum": ["additive", "removed_export", "signature_changed", "return_changed", "unchanged", "unknown"]
+        }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["files_changed", "added", "removed", "changed", "unchanged"],
+      "properties": {
+        "files_changed": { "type": "integer", "minimum": 0 },
+        "added": { "type": "integer", "minimum": 0 },
+        "removed": { "type": "integer", "minimum": 0 },
+        "changed": { "type": "integer", "minimum": 0 },
+        "unchanged": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "message", "path"],
+      "properties": {
+        "code": {
+          "enum": [
+            "export_diff_git_unavailable",
+            "export_diff_invalid_ref",
+            "export_diff_unreadable_path",
+            "export_diff_file_too_large",
+            "export_diff_max_files_exceeded",
+            "export_diff_duplicate_export",
+            "export_diff_reexport_unresolved"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" }
+      }
+    }
+  }
+}

package/schemas/reference-drift-report.schema.json

@@ -0,0 +1,166 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/reference-drift-report.schema.json",
+  "title": "mustflow reference-drift report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "policy",
+    "input_hash",
+    "files",
+    "references",
+    "summary",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "docs" },
+    "script_id": { "const": "reference-drift" },
+    "script_ref": { "const": "docs/reference-drift" },
+    "action": { "const": "check" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/file" }
+    },
+    "references": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/reference" }
+    },
+    "summary": { "$ref": "#/$defs/summary" },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "nullableSha256": {
+      "type": ["string", "null"],
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "referenceKind": {
+      "enum": ["mf_command", "script_pack_ref", "schema_file", "repo_path"]
+    },
+    "referenceStatus": {
+      "enum": ["ok", "missing", "unknown", "skipped"]
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "max_files",
+        "max_file_bytes",
+        "default_paths",
+        "path_filters",
+        "checked_reference_kinds"
+      ],
+      "properties": {
+        "max_files": { "type": "integer", "minimum": 1 },
+        "max_file_bytes": { "type": "integer", "minimum": 1 },
+        "default_paths": { "$ref": "#/$defs/stringArray" },
+        "path_filters": { "$ref": "#/$defs/stringArray" },
+        "checked_reference_kinds": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/referenceKind" }
+        }
+      }
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "path",
+        "sha256",
+        "size_bytes",
+        "line_count",
+        "reference_count"
+      ],
+      "properties": {
+        "kind": { "const": "document" },
+        "path": { "type": "string" },
+        "sha256": { "$ref": "#/$defs/nullableSha256" },
+        "size_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "line_count": { "type": ["integer", "null"], "minimum": 0 },
+        "reference_count": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "reference": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["kind", "path", "line", "value", "target", "status", "message"],
+      "properties": {
+        "kind": { "$ref": "#/$defs/referenceKind" },
+        "path": { "type": "string" },
+        "line": { "type": "integer", "minimum": 1 },
+        "value": { "type": "string" },
+        "target": { "type": "string" },
+        "status": { "$ref": "#/$defs/referenceStatus" },
+        "message": { "type": "string" }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["files_checked", "references_checked", "ok", "missing", "unknown", "skipped"],
+      "properties": {
+        "files_checked": { "type": "integer", "minimum": 0 },
+        "references_checked": { "type": "integer", "minimum": 0 },
+        "ok": { "type": "integer", "minimum": 0 },
+        "missing": { "type": "integer", "minimum": 0 },
+        "unknown": { "type": "integer", "minimum": 0 },
+        "skipped": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "message", "path"],
+      "properties": {
+        "code": {
+          "enum": [
+            "reference_drift_path_outside_root",
+            "reference_drift_unreadable_path",
+            "reference_drift_file_too_large",
+            "reference_drift_max_files_exceeded",
+            "reference_drift_unknown_command",
+            "reference_drift_unknown_script_pack",
+            "reference_drift_unknown_schema",
+            "reference_drift_missing_path"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "line": { "type": "integer", "minimum": 1 }
+      }
+    }
+  }
+}

package/schemas/related-files-report.schema.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/related-files-report.schema.json",
+  "title": "mustflow related-files report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "policy",
+    "input_hash",
+    "targets",
+    "candidates",
+    "truncated",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "repo" },
+    "script_id": { "const": "related-files" },
+    "script_ref": { "const": "repo/related-files" },
+    "action": { "const": "map" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "policy": { "$ref": "#/$defs/policy" },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "targets": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/target" }
+    },
+    "candidates": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/candidate" }
+    },
+    "truncated": { "type": "boolean" },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "stringArray": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "language": {
+      "enum": [
+        "typescript",
+        "tsx",
+        "javascript",
+        "jsx",
+        "javascript-module",
+        "javascript-commonjs",
+        "json",
+        "other"
+      ]
+    },
+    "relationship": {
+      "enum": [
+        "import",
+        "importer",
+        "sibling_test",
+        "sibling_docs",
+        "sibling_style",
+        "sibling_type",
+        "config_parent",
+        "package_boundary"
+      ]
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["max_file_bytes", "max_files", "max_candidates", "extensions", "ignored_directories"],
+      "properties": {
+        "max_file_bytes": { "type": "integer", "minimum": 1 },
+        "max_files": { "type": "integer", "minimum": 1 },
+        "max_candidates": { "type": "integer", "minimum": 1 },
+        "extensions": { "$ref": "#/$defs/stringArray" },
+        "ignored_directories": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "target": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["input", "path", "exists", "kind", "language"],
+      "properties": {
+        "input": { "type": "string" },
+        "path": { "type": "string" },
+        "exists": { "type": ["boolean", "null"] },
+        "kind": { "enum": ["file", "directory", "missing", "other", "unknown"] },
+        "language": { "$ref": "#/$defs/language" }
+      }
+    },
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "relationship", "confidence", "reason", "source_path", "target_path", "line"],
+      "properties": {
+        "path": { "type": "string" },
+        "relationship": { "$ref": "#/$defs/relationship" },
+        "confidence": { "type": "number", "minimum": 0, "maximum": 1 },
+        "reason": { "type": "string" },
+        "source_path": { "type": "string" },
+        "target_path": { "type": "string" },
+        "line": { "type": ["integer", "null"], "minimum": 1 }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "message", "path"],
+      "properties": {
+        "code": {
+          "enum": [
+            "related_files_path_outside_root",
+            "related_files_unreadable_path",
+            "related_files_max_files_exceeded",
+            "related_files_max_candidates_exceeded"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" }
+      }
+    }
+  }
+}