mustflow 2.59.0 → 2.69.0

package/schemas/context-report.schema.json

@@ -79,6 +79,9 @@
         "stable_prefix": { "$ref": "#/$defs/stablePrefixLayer" },
         "task_context": { "$ref": "#/$defs/taskContextLayer" },
         "volatile_suffix": { "$ref": "#/$defs/volatileSuffixLayer" },
+        "prompt_bundle": { "$ref": "#/$defs/promptBundle" },
+        "prompt_bundle_diff": { "$ref": "#/$defs/promptBundleDiff" },
+        "cache_audit": { "$ref": "#/$defs/promptCacheAudit" },
         "issues": {
           "type": "array",
           "items": { "type": "string" }
@@ -375,9 +378,79 @@
           "type": "array",
           "items": { "type": "string" }
         },
+        "route_read_plan": { "$ref": "#/$defs/taskRouteReadPlan" },
+        "repo_map_read_plan": { "$ref": "#/$defs/taskRepoMapReadPlan" },
         "local_index": { "$ref": "#/$defs/promptCacheLocalIndex" }
       }
     },
+    "taskRouteReadPlan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "resolver_command",
+        "stable_kernel",
+        "route_sources",
+        "selected_skill_paths_source",
+        "route_metadata_fallback",
+        "expanded_index_fallback",
+        "selection_limits"
+      ],
+      "properties": {
+        "resolver_command": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "stable_kernel": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "route_sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "selected_skill_paths_source": { "type": "string" },
+        "route_metadata_fallback": { "$ref": "#/$defs/taskRouteFallback" },
+        "expanded_index_fallback": { "$ref": "#/$defs/taskRouteFallback" },
+        "selection_limits": { "$ref": "#/$defs/taskRouteSelectionLimits" }
+      }
+    },
+    "taskRouteFallback": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "read_when", "avoid_by_default"],
+      "properties": {
+        "path": { "type": "string" },
+        "read_when": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "avoid_by_default": { "type": "boolean" }
+      }
+    },
+    "taskRouteSelectionLimits": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["candidates", "main", "adjuncts"],
+      "properties": {
+        "candidates": { "type": "integer", "minimum": 0 },
+        "main": { "type": "integer", "minimum": 0 },
+        "adjuncts": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "taskRepoMapReadPlan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["source", "strategy", "anchor_sources", "fallback"],
+      "properties": {
+        "source": { "const": "repo_map_navigation" },
+        "strategy": { "const": "select_anchors_or_spans_before_full_map" },
+        "anchor_sources": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "fallback": { "$ref": "#/$defs/taskRouteFallback" }
+      }
+    },
     "promptCacheLocalIndex": {
       "type": "object",
       "additionalProperties": false,
@@ -425,6 +498,375 @@
         "include_absolute_root": { "const": false },
         "include_latest_run": { "const": false }
       }
+    },
+    "promptCacheAudit": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["measurement", "estimator", "canonicalization", "summary", "layers", "issues"],
+      "properties": {
+        "measurement": { "const": "reference_bundle" },
+        "estimator": { "$ref": "#/$defs/promptCacheAuditEstimator" },
+        "canonicalization": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "summary": { "$ref": "#/$defs/promptCacheAuditSummary" },
+        "layers": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptCacheAuditLayer" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptBundle": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "schema_version",
+        "renderer",
+        "content_included",
+        "request_shape_hash",
+        "bundle_hash",
+        "layers",
+        "issues"
+      ],
+      "properties": {
+        "schema_version": { "const": "1" },
+        "renderer": { "const": "reference_bundle_utf8_lf_v1" },
+        "content_included": { "const": false },
+        "request_shape_hash": { "type": "string" },
+        "bundle_hash": { "type": "string" },
+        "layers": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptBundleLayer" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptBundleLayer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["cache_layer", "blocks"],
+      "properties": {
+        "cache_layer": { "enum": ["stable", "task", "volatile"] },
+        "blocks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptBundleBlock" }
+        }
+      }
+    },
+    "promptBundleBlock": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "cache_layer",
+        "order",
+        "kind",
+        "path",
+        "source",
+        "source_kind",
+        "selection_policy",
+        "content_included",
+        "content_hash",
+        "rendered_digest",
+        "rendered_bytes",
+        "estimated_tokens",
+        "cacheability",
+        "reload_on",
+        "issue"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "cache_layer": { "enum": ["stable", "task", "volatile"] },
+        "order": { "type": "integer", "minimum": 1 },
+        "kind": { "enum": ["file", "source_placeholder"] },
+        "path": { "type": ["string", "null"] },
+        "source": { "type": ["string", "null"] },
+        "source_kind": { "enum": ["file_reference", "dynamic_selection", "runtime_volatile"] },
+        "selection_policy": {
+          "enum": [
+            "always_rendered",
+            "read_when_selected",
+            "fallback_when_needed",
+            "selected_at_runtime",
+            "volatile_runtime"
+          ]
+        },
+        "content_included": { "const": false },
+        "content_hash": { "type": ["string", "null"] },
+        "rendered_digest": { "type": ["string", "null"] },
+        "rendered_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "estimated_tokens": { "type": ["integer", "null"], "minimum": 0 },
+        "cacheability": {
+          "enum": [
+            "provider_prefix_candidate",
+            "task_selective",
+            "task_fallback",
+            "runtime_selection",
+            "volatile_suffix"
+          ]
+        },
+        "reload_on": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "issue": { "type": ["string", "null"] }
+      }
+    },
+    "promptBundleDiff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "baseline_path",
+        "status",
+        "baseline_request_shape_hash",
+        "current_request_shape_hash",
+        "request_shape_changed",
+        "baseline_bundle_hash",
+        "current_bundle_hash",
+        "bundle_changed",
+        "first_difference",
+        "stable_diff",
+        "changed_blocks",
+        "issues"
+      ],
+      "properties": {
+        "baseline_path": { "type": "string" },
+        "status": {
+          "enum": [
+            "unchanged",
+            "changed",
+            "baseline_missing",
+            "baseline_unreadable",
+            "baseline_invalid",
+            "baseline_without_prompt_bundle"
+          ]
+        },
+        "baseline_request_shape_hash": { "type": ["string", "null"] },
+        "current_request_shape_hash": { "type": "string" },
+        "request_shape_changed": { "type": ["boolean", "null"] },
+        "baseline_bundle_hash": { "type": ["string", "null"] },
+        "current_bundle_hash": { "type": "string" },
+        "bundle_changed": { "type": ["boolean", "null"] },
+        "first_difference": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/promptBundleBlockDiff" }
+          ]
+        },
+        "stable_diff": { "$ref": "#/$defs/promptBundleStableDiff" },
+        "changed_blocks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptBundleBlockDiff" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptBundleStableDiff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "stable_block_count",
+        "baseline_stable_block_count",
+        "matching_prefix_blocks",
+        "matching_prefix_ratio",
+        "stable_prefix_preserved",
+        "first_stable_difference",
+        "first_stable_invalidation_reason"
+      ],
+      "properties": {
+        "stable_block_count": { "type": "integer", "minimum": 0 },
+        "baseline_stable_block_count": { "type": ["integer", "null"], "minimum": 0 },
+        "matching_prefix_blocks": { "type": "integer", "minimum": 0 },
+        "matching_prefix_ratio": { "type": ["number", "null"], "minimum": 0, "maximum": 1 },
+        "stable_prefix_preserved": { "type": ["boolean", "null"] },
+        "first_stable_difference": {
+          "anyOf": [
+            { "type": "null" },
+            { "$ref": "#/$defs/promptBundleBlockDiff" }
+          ]
+        },
+        "first_stable_invalidation_reason": { "type": ["string", "null"] }
+      }
+    },
+    "promptBundleBlockDiff": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "kind",
+        "cache_layer",
+        "order",
+        "current_id",
+        "baseline_id",
+        "reason",
+        "fields"
+      ],
+      "properties": {
+        "kind": { "enum": ["added", "removed", "changed"] },
+        "cache_layer": { "type": ["string", "null"], "enum": ["stable", "task", "volatile", null] },
+        "order": { "type": ["integer", "null"], "minimum": 1 },
+        "current_id": { "type": ["string", "null"] },
+        "baseline_id": { "type": ["string", "null"] },
+        "reason": { "type": "string" },
+        "fields": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptCacheAuditEstimator": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "estimated_bytes_per_token", "caveat"],
+      "properties": {
+        "name": { "const": "reference_bundle_utf8_lf_v1" },
+        "estimated_bytes_per_token": { "const": 4 },
+        "caveat": { "type": "string" }
+      }
+    },
+    "promptCacheAuditSummary": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "rendered_bytes",
+        "estimated_tokens",
+        "measured_block_count",
+        "dynamic_source_count",
+        "unresolved_reference_count",
+        "volatile_before_stable_count",
+        "serialization_deterministic",
+        "stable_leaf_skill_isolated",
+        "stable_leaf_skill_risk_paths",
+        "leaf_skill_change_stable_hash_delta",
+        "stable_rendered_bytes",
+        "stable_estimated_tokens",
+        "stable_budget_status",
+        "stable_largest_block_budget_share",
+        "task_budget_status",
+        "volatile_budget_status"
+      ],
+      "properties": {
+        "rendered_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "estimated_tokens": { "type": ["integer", "null"], "minimum": 0 },
+        "measured_block_count": { "type": "integer", "minimum": 0 },
+        "dynamic_source_count": { "type": "integer", "minimum": 0 },
+        "unresolved_reference_count": { "type": "integer", "minimum": 0 },
+        "volatile_before_stable_count": { "type": "integer", "minimum": 0 },
+        "serialization_deterministic": { "const": true },
+        "stable_leaf_skill_isolated": { "type": ["boolean", "null"] },
+        "stable_leaf_skill_risk_paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "leaf_skill_change_stable_hash_delta": {
+          "type": ["integer", "null"],
+          "enum": [0, null]
+        },
+        "stable_rendered_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "stable_estimated_tokens": { "type": ["integer", "null"], "minimum": 0 },
+        "stable_budget_status": {
+          "type": ["string", "null"],
+          "enum": ["within_budget", "over_budget", "unknown", null]
+        },
+        "stable_largest_block_budget_share": { "type": ["number", "null"], "minimum": 0 },
+        "task_budget_status": {
+          "type": ["string", "null"],
+          "enum": ["within_budget", "over_budget", "unknown", null]
+        },
+        "volatile_budget_status": {
+          "type": ["string", "null"],
+          "enum": ["within_budget", "over_budget", "unknown", null]
+        }
+      }
+    },
+    "promptCacheAuditLayer": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "cache_layer",
+        "budget_kb",
+        "budget_bytes",
+        "rendered_bytes",
+        "estimated_tokens",
+        "budget_status",
+        "blocks",
+        "largest_blocks",
+        "issues"
+      ],
+      "properties": {
+        "cache_layer": { "enum": ["stable", "task", "volatile"] },
+        "budget_kb": { "type": ["integer", "null"] },
+        "budget_bytes": { "type": ["integer", "null"] },
+        "target_kb": { "type": ["integer", "null"] },
+        "target_bytes": { "type": ["integer", "null"] },
+        "target_status": { "enum": ["within_budget", "over_budget", "unknown"] },
+        "rendered_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "estimated_tokens": { "type": ["integer", "null"], "minimum": 0 },
+        "budget_status": { "enum": ["within_budget", "over_budget", "unknown"] },
+        "blocks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptCacheAuditBlock" }
+        },
+        "largest_blocks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/promptCacheAuditBlock" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "promptCacheAuditBlock": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id",
+        "kind",
+        "path",
+        "source",
+        "exists",
+        "content_hash",
+        "rendered_bytes",
+        "estimated_tokens",
+        "budget_share",
+        "issue"
+      ],
+      "properties": {
+        "id": { "type": "string" },
+        "kind": { "enum": ["file", "source_placeholder"] },
+        "path": { "type": ["string", "null"] },
+        "source": { "type": ["string", "null"] },
+        "source_kind": { "enum": ["file_reference", "dynamic_selection", "runtime_volatile"] },
+        "selection_policy": {
+          "enum": [
+            "always_rendered",
+            "read_when_selected",
+            "fallback_when_needed",
+            "selected_at_runtime",
+            "volatile_runtime"
+          ]
+        },
+        "measurement_status": { "enum": ["measured", "hash_only_deferred", "dynamic_unmeasured"] },
+        "candidate_exists": { "type": ["boolean", "null"] },
+        "candidate_content_hash": { "type": ["string", "null"] },
+        "exists": { "type": ["boolean", "null"] },
+        "content_hash": { "type": ["string", "null"] },
+        "rendered_bytes": { "type": ["integer", "null"], "minimum": 0 },
+        "estimated_tokens": { "type": ["integer", "null"], "minimum": 0 },
+        "budget_share": { "type": ["number", "null"], "minimum": 0 },
+        "issue": { "type": ["string", "null"] }
+      }
     }
   }
 }

package/schemas/quality-gaming-report.schema.json

@@ -60,6 +60,7 @@
             "type_escape_added",
             "test_bypass_marker_added",
             "placeholder_added",
+            "empty_catch_swallow_added",
             "generated_or_vendor_logic_added",
             "large_helper_container_added"
           ]

package/schemas/route-fixture.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/route-fixture.schema.json",
+  "title": "mustflow skill route fixture",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "cases"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "cases": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/case" }
+    }
+  },
+  "$defs": {
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "nonEmptyStringArray": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonEmptyString" }
+    },
+    "case": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "paths", "reasons"],
+      "anyOf": [
+        { "required": ["required_main"] },
+        { "required": ["required_candidates"] },
+        { "required": ["required_adjuncts"] },
+        { "required": ["forbidden_candidates"] }
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "task": {
+          "oneOf": [
+            { "$ref": "#/$defs/nonEmptyString" },
+            { "type": "null" }
+          ]
+        },
+        "paths": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "reasons": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "max_candidates": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        },
+        "required_main": { "$ref": "#/$defs/nonEmptyString" },
+        "required_candidates": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "required_adjuncts": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "forbidden_candidates": { "$ref": "#/$defs/nonEmptyStringArray" }
+      }
+    }
+  }
+}