mustflow 2.85.4 → 2.99.0

package/schemas/repo-manifest-lock-drift-report.schema.json

@@ -0,0 +1,202 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/repo-manifest-lock-drift-report.schema.json",
+  "title": "mustflow repo manifest-lock-drift report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "input",
+    "policy",
+    "input_hash",
+    "lock",
+    "summary",
+    "entries",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "repo" },
+    "script_id": { "const": "manifest-lock-drift" },
+    "script_ref": { "const": "repo/manifest-lock-drift" },
+    "action": { "const": "check" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["paths"],
+      "properties": {
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["lock_path", "input_mode", "max_entries", "extra_manifest_file_detection"],
+      "properties": {
+        "lock_path": { "const": ".mustflow/config/manifest.lock.toml" },
+        "input_mode": { "enum": ["all_locked_files", "explicit_paths"] },
+        "max_entries": { "type": "integer", "minimum": 1 },
+        "extra_manifest_file_detection": { "const": "not_authoritative" }
+      }
+    },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "lock": { "$ref": "#/$defs/lockMetadata" },
+    "summary": { "$ref": "#/$defs/summary" },
+    "entries": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/entry" }
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "nullableString": {
+      "type": ["string", "null"]
+    },
+    "nullableSha256": {
+      "anyOf": [
+        { "$ref": "#/$defs/sha256" },
+        { "type": "null" }
+      ]
+    },
+    "lockMetadata": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "exists",
+        "schema_version",
+        "template_id",
+        "template_version",
+        "template_profile",
+        "template_locale",
+        "entries_total"
+      ],
+      "properties": {
+        "path": { "const": ".mustflow/config/manifest.lock.toml" },
+        "exists": { "type": "boolean" },
+        "schema_version": { "$ref": "#/$defs/nullableString" },
+        "template_id": { "$ref": "#/$defs/nullableString" },
+        "template_version": { "$ref": "#/$defs/nullableString" },
+        "template_profile": { "$ref": "#/$defs/nullableString" },
+        "template_locale": { "$ref": "#/$defs/nullableString" },
+        "entries_total": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "entries_total",
+        "entries_checked",
+        "clean_entries",
+        "missing_entries",
+        "hash_mismatches",
+        "unreadable_entries",
+        "unsafe_entries",
+        "skipped_entries",
+        "findings"
+      ],
+      "properties": {
+        "entries_total": { "type": "integer", "minimum": 0 },
+        "entries_checked": { "type": "integer", "minimum": 0 },
+        "clean_entries": { "type": "integer", "minimum": 0 },
+        "missing_entries": { "type": "integer", "minimum": 0 },
+        "hash_mismatches": { "type": "integer", "minimum": 0 },
+        "unreadable_entries": { "type": "integer", "minimum": 0 },
+        "unsafe_entries": { "type": "integer", "minimum": 0 },
+        "skipped_entries": { "type": "integer", "minimum": 0 },
+        "findings": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "entry": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "path",
+        "source",
+        "last_action",
+        "lock_hash",
+        "actual_hash",
+        "exists",
+        "status"
+      ],
+      "properties": {
+        "path": { "type": "string" },
+        "source": { "$ref": "#/$defs/nullableString" },
+        "last_action": { "$ref": "#/$defs/nullableString" },
+        "lock_hash": { "$ref": "#/$defs/nullableString" },
+        "actual_hash": { "$ref": "#/$defs/nullableSha256" },
+        "exists": { "type": "boolean" },
+        "status": {
+          "enum": ["clean", "hash_mismatch", "missing", "unreadable", "unsafe_path", "skipped"]
+        }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "severity",
+        "message",
+        "path",
+        "expected_hash",
+        "actual_hash",
+        "json_pointer",
+        "metric",
+        "actual",
+        "expected"
+      ],
+      "properties": {
+        "code": {
+          "enum": [
+            "manifest_lock_missing",
+            "manifest_lock_invalid",
+            "manifest_lock_max_entries_exceeded",
+            "manifest_lock_entry_path_outside_root",
+            "manifest_lock_entry_missing",
+            "manifest_lock_entry_unreadable",
+            "manifest_lock_entry_invalid_hash",
+            "manifest_lock_hash_mismatch"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "expected_hash": { "$ref": "#/$defs/nullableString" },
+        "actual_hash": { "$ref": "#/$defs/nullableSha256" },
+        "json_pointer": { "type": ["string", "null"] },
+        "metric": { "type": ["string", "null"] },
+        "actual": { "type": ["number", "null"] },
+        "expected": { "type": ["number", "null"] }
+      }
+    }
+  }
+}

package/schemas/repo-merge-conflict-scan-report.schema.json

@@ -0,0 +1,169 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/repo-merge-conflict-scan-report.schema.json",
+  "title": "mustflow repo merge-conflict-scan report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "input",
+    "policy",
+    "input_hash",
+    "summary",
+    "files",
+    "markers",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "repo" },
+    "script_id": { "const": "merge-conflict-scan" },
+    "script_ref": { "const": "repo/merge-conflict-scan" },
+    "action": { "const": "check" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["paths"],
+      "properties": {
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "policy": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["input_mode", "marker_prefixes", "max_files", "max_file_bytes", "skipped_directories"],
+      "properties": {
+        "input_mode": { "enum": ["explicit_paths", "git_changed_files"] },
+        "marker_prefixes": {
+          "type": "array",
+          "items": { "enum": ["<<<<<<<", "|||||||", "=======", ">>>>>>>"] }
+        },
+        "max_files": { "type": "integer", "minimum": 1 },
+        "max_file_bytes": { "type": "integer", "minimum": 1 },
+        "skipped_directories": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "summary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["files_checked", "markers_found", "files_with_markers", "issues"],
+      "properties": {
+        "files_checked": { "type": "integer", "minimum": 0 },
+        "markers_found": { "type": "integer", "minimum": 0 },
+        "files_with_markers": { "type": "integer", "minimum": 0 },
+        "issues": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/file" }
+    },
+    "markers": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/marker" }
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "markerKind": {
+      "enum": ["start", "base", "separator", "end"]
+    },
+    "file": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "sha256", "bytes", "markers"],
+      "properties": {
+        "path": { "type": "string" },
+        "sha256": { "$ref": "#/$defs/sha256" },
+        "bytes": { "type": "integer", "minimum": 0 },
+        "markers": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "marker": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "line", "column", "marker", "marker_length"],
+      "properties": {
+        "path": { "type": "string" },
+        "line": { "type": "integer", "minimum": 1 },
+        "column": { "type": "integer", "minimum": 1 },
+        "marker": { "$ref": "#/$defs/markerKind" },
+        "marker_length": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "severity",
+        "message",
+        "path",
+        "line",
+        "marker",
+        "json_pointer",
+        "metric",
+        "actual",
+        "expected"
+      ],
+      "properties": {
+        "code": {
+          "enum": [
+            "merge_conflict_marker_detected",
+            "merge_conflict_scan_git_unavailable",
+            "merge_conflict_scan_no_input_files",
+            "merge_conflict_scan_max_files_exceeded",
+            "merge_conflict_scan_file_too_large",
+            "merge_conflict_scan_unreadable_path",
+            "merge_conflict_scan_path_outside_root"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "line": { "type": ["integer", "null"], "minimum": 1 },
+        "marker": {
+          "anyOf": [
+            { "$ref": "#/$defs/markerKind" },
+            { "type": "null" }
+          ]
+        },
+        "json_pointer": { "type": ["string", "null"] },
+        "metric": { "type": ["string", "null"] },
+        "actual": { "type": ["number", "null"] },
+        "expected": { "type": ["number", "null"] }
+      }
+    }
+  }
+}

package/schemas/repo-version-source-report.schema.json

@@ -0,0 +1,127 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/repo-version-source-report.schema.json",
+  "title": "mustflow repo version-source report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "input",
+    "input_hash",
+    "versioning_enabled",
+    "counts",
+    "sources",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "repo" },
+    "script_id": { "const": "version-source" },
+    "script_ref": { "const": "repo/version-source" },
+    "action": { "const": "inspect" },
+    "status": { "enum": ["passed", "failed", "error"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["preferences_path", "declared_sources_path"],
+      "properties": {
+        "preferences_path": { "const": ".mustflow/config/preferences.toml" },
+        "declared_sources_path": { "const": ".mustflow/config/versioning.toml" }
+      }
+    },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "versioning_enabled": { "type": "boolean" },
+    "counts": { "$ref": "#/$defs/counts" },
+    "sources": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/versionSource" }
+    },
+    "findings": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/finding" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "sha256": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "sources",
+        "declared_sources",
+        "source_authority_sources",
+        "derived_authority_sources",
+        "unclassified_authority_sources"
+      ],
+      "properties": {
+        "sources": { "type": "integer", "minimum": 0 },
+        "declared_sources": { "type": "integer", "minimum": 0 },
+        "source_authority_sources": { "type": "integer", "minimum": 0 },
+        "derived_authority_sources": { "type": "integer", "minimum": 0 },
+        "unclassified_authority_sources": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "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"]
+        }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "code",
+        "severity",
+        "message",
+        "path",
+        "json_pointer",
+        "metric",
+        "actual",
+        "expected"
+      ],
+      "properties": {
+        "code": { "const": "versioning_enabled_without_sources" },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "json_pointer": { "type": ["string", "null"] },
+        "metric": { "type": ["string", "null"] },
+        "actual": { "type": ["number", "null"] },
+        "expected": { "type": ["number", "null"] }
+      }
+    }
+  }
+}

package/schemas/skill-route-audit-report.schema.json

@@ -0,0 +1,144 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/skill-route-audit-report.schema.json",
+  "title": "mustflow skill-route-audit report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "pack_id",
+    "script_id",
+    "script_ref",
+    "action",
+    "status",
+    "ok",
+    "mustflow_root",
+    "input",
+    "input_hash",
+    "counts",
+    "inventory",
+    "findings",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "script-pack" },
+    "pack_id": { "const": "repo" },
+    "script_id": { "const": "skill-route-audit" },
+    "script_ref": { "const": "repo/skill-route-audit" },
+    "action": { "const": "audit" },
+    "status": { "enum": ["ok", "issues_found", "partial"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source_skill_root", "template_skill_root", "template_manifest", "template_i18n"],
+      "properties": {
+        "source_skill_root": { "const": ".mustflow/skills" },
+        "template_skill_root": { "const": "templates/default/locales/en/.mustflow/skills" },
+        "template_manifest": { "const": "templates/default/manifest.toml" },
+        "template_i18n": { "const": "templates/default/i18n.toml" }
+      }
+    },
+    "input_hash": { "$ref": "#/$defs/sha256" },
+    "counts": { "$ref": "#/$defs/counts" },
+    "inventory": { "$ref": "#/$defs/inventory" },
+    "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" }
+    },
+    "counts": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_skills",
+        "index_routes",
+        "route_metadata",
+        "template_skills",
+        "manifest_skill_creates",
+        "manifest_profile_entries",
+        "i18n_skill_documents"
+      ],
+      "properties": {
+        "source_skills": { "type": "integer", "minimum": 0 },
+        "index_routes": { "type": "integer", "minimum": 0 },
+        "route_metadata": { "type": "integer", "minimum": 0 },
+        "template_skills": { "type": "integer", "minimum": 0 },
+        "manifest_skill_creates": { "type": "integer", "minimum": 0 },
+        "manifest_profile_entries": { "type": "integer", "minimum": 0 },
+        "i18n_skill_documents": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "inventory": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "source_skills",
+        "index_skills",
+        "route_skills",
+        "template_skills",
+        "manifest_skill_creates",
+        "manifest_profile_skills",
+        "i18n_skill_documents"
+      ],
+      "properties": {
+        "source_skills": { "$ref": "#/$defs/stringArray" },
+        "index_skills": { "$ref": "#/$defs/stringArray" },
+        "route_skills": { "$ref": "#/$defs/stringArray" },
+        "template_skills": { "$ref": "#/$defs/stringArray" },
+        "manifest_skill_creates": { "$ref": "#/$defs/stringArray" },
+        "manifest_profile_skills": { "$ref": "#/$defs/stringArray" },
+        "i18n_skill_documents": { "$ref": "#/$defs/stringArray" }
+      }
+    },
+    "finding": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "message", "path", "skill", "route"],
+      "properties": {
+        "code": {
+          "enum": [
+            "skill_without_route",
+            "route_without_skill",
+            "skill_missing_index_entry",
+            "index_without_skill",
+            "route_missing_index_entry",
+            "frontmatter_name_mismatch",
+            "template_missing_skill",
+            "template_extra_skill",
+            "template_skill_drift",
+            "template_routes_drift",
+            "i18n_missing_document",
+            "i18n_source_mismatch",
+            "i18n_revision_mismatch",
+            "manifest_missing_create",
+            "manifest_create_without_skill",
+            "manifest_profile_missing_skill",
+            "manifest_profile_unknown_skill"
+          ]
+        },
+        "severity": { "enum": ["low", "medium", "high", "critical"] },
+        "message": { "type": "string" },
+        "path": { "type": "string" },
+        "skill": { "type": ["string", "null"] },
+        "route": { "type": ["string", "null"] }
+      }
+    }
+  }
+}