mustflow 2.58.1 → 2.68.6

package/dist/core/source-anchors.js

@@ -265,11 +265,90 @@ export function sourceAnchorPathIsGeneratedOrVendor(relativePath) {
 export function sourceAnchorTextContainsSecretLike(value) {
     return textContainsSecretLike(value);
 }
-export function parseSourceAnchorsInContent(relativePath, content) {
+function collectCommentLines(content) {
     const lines = content.split(/\r?\n/);
+    const commentLines = [];
+    let insideBlockComment = false;
+    let stringQuote = null;
+    let escaped = false;
+    let lineIndex = 0;
+    while (lineIndex < lines.length) {
+        const line = lines[lineIndex] ?? '';
+        let index = 0;
+        while (index < line.length) {
+            if (insideBlockComment) {
+                const endIndex = line.indexOf('*/', index);
+                const segmentEnd = endIndex === -1 ? line.length : endIndex;
+                commentLines.push({ lineNumber: lineIndex + 1, text: line.slice(index, segmentEnd) });
+                if (endIndex === -1) {
+                    index = line.length;
+                    continue;
+                }
+                insideBlockComment = false;
+                index = endIndex + 2;
+                continue;
+            }
+            const character = line[index];
+            const nextCharacter = line[index + 1];
+            if (stringQuote) {
+                if (escaped) {
+                    escaped = false;
+                    index += 1;
+                    continue;
+                }
+                if (character === '\\') {
+                    escaped = true;
+                    index += 1;
+                    continue;
+                }
+                if (character === stringQuote) {
+                    stringQuote = null;
+                }
+                index += 1;
+                continue;
+            }
+            if (character === '"' || character === "'" || character === '`') {
+                stringQuote = character;
+                index += 1;
+                continue;
+            }
+            if (character === '/' && nextCharacter === '*') {
+                const commentStart = index + 2;
+                const endIndex = line.indexOf('*/', commentStart);
+                const segmentEnd = endIndex === -1 ? line.length : endIndex;
+                commentLines.push({ lineNumber: lineIndex + 1, text: line.slice(commentStart, segmentEnd) });
+                if (endIndex === -1) {
+                    insideBlockComment = true;
+                    index = line.length;
+                    continue;
+                }
+                index = endIndex + 2;
+                continue;
+            }
+            if (character === '/' && nextCharacter === '/') {
+                commentLines.push({ lineNumber: lineIndex + 1, text: line.slice(index + 2) });
+                break;
+            }
+            if (character === '#' && line.slice(0, index).trim().length === 0) {
+                commentLines.push({ lineNumber: lineIndex + 1, text: line.slice(index + 1) });
+                break;
+            }
+            index += 1;
+        }
+        if (stringQuote !== '`') {
+            stringQuote = null;
+        }
+        escaped = false;
+        lineIndex += 1;
+    }
+    return commentLines;
+}
+export function parseSourceAnchorsInContent(relativePath, content) {
+    const lines = collectCommentLines(content);
     const anchors = [];
     for (let index = 0; index < lines.length; index += 1) {
-        const normalized = stripSourceAnchorCommentPrefix(lines[index] ?? '');
+        const commentLine = lines[index];
+        const normalized = stripSourceAnchorCommentPrefix(commentLine?.text ?? '');
         if (!normalized.startsWith('mf:anchor')) {
             continue;
         }
@@ -278,12 +357,18 @@ export function parseSourceAnchorsInContent(relativePath, content) {
         const fields = new Map();
         const unsupportedFields = [];
         const rawLines = [normalized];
+        let previousLineNumber = commentLine?.lineNumber ?? 0;
         for (let fieldIndex = index + 1; fieldIndex < lines.length; fieldIndex += 1) {
-            const fieldLine = stripSourceAnchorCommentPrefix(lines[fieldIndex] ?? '');
+            const nextCommentLine = lines[fieldIndex];
+            if (!nextCommentLine || nextCommentLine.lineNumber > previousLineNumber + 1) {
+                break;
+            }
+            const fieldLine = stripSourceAnchorCommentPrefix(nextCommentLine.text);
             if (fieldLine.length === 0) {
+                previousLineNumber = nextCommentLine.lineNumber;
                 continue;
             }
-            if (fieldLine.startsWith('@') || /^[A-Za-z_$][\w$]*\s/u.test(fieldLine)) {
+            if (fieldLine.startsWith('mf:anchor') || fieldLine.startsWith('@') || /^[A-Za-z_$][\w$]*\s/u.test(fieldLine)) {
                 break;
             }
             const field = readSourceAnchorField(fieldLine);
@@ -291,6 +376,7 @@ export function parseSourceAnchorsInContent(relativePath, content) {
                 break;
             }
             rawLines.push(fieldLine);
+            previousLineNumber = nextCommentLine.lineNumber;
             if (!SOURCE_ANCHOR_ALLOWED_FIELDS.has(field.key)) {
                 unsupportedFields.push(field.key);
                 continue;
@@ -302,7 +388,7 @@ export function parseSourceAnchorsInContent(relativePath, content) {
             rawId,
             idValid: SOURCE_ANCHOR_ID_PATTERN.test(rawId),
             path: relativePath,
-            lineStart: index + 1,
+            lineStart: commentLine?.lineNumber ?? index + 1,
             fields,
             unsupportedFields,
             rawText: rawLines.join('\n'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.58.1",
+  "version": "2.68.6",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/schemas/README.md

@@ -7,7 +7,7 @@ Current schemas:
 
 - `doctor-report.schema.json`: output of `mf doctor --json`
 - `adapter-compatibility-report.schema.json`: output of `mf adapters status --json`
-- `context-report.schema.json`: output of `mf context --json`
+- `context-report.schema.json`: output of `mf context --json`, including prompt-cache profiles and optional cache audit data
 - `workspace-summary.schema.json`: output of `mf api workspace-summary --json`
 - `command-catalog.schema.json`: output of `mf api command-catalog --json`
 - `verification-plan.schema.json`: output of `mf api verification-plan --changed --json`
@@ -49,6 +49,14 @@ Current schemas:
   `mf impact <path...> --json`
 - `line-endings-report.schema.json`: output of `mf line-endings check --json` and  
   `mf line-endings normalize --json`
+- `quality-gaming-report.schema.json`: output of `mf quality check --json`, containing changed-file
+  quality-gaming risks such as line stuffing, validation suppressions, test bypass markers, type
+  escapes, generated/vendor logic, empty catch swallowing, and placeholder implementations
+- `skill-route-report.schema.json`: output of `mf skill route --json`, containing compact route
+  candidates, selected main and adjunct skills, score breakdowns, route read plans, and source
+  route shards without granting command authority or replacing selected `SKILL.md` reads
+- `route-fixture.schema.json`: parsed `.mustflow/skills/route-fixtures.json`, containing strict
+  skill-route golden cases with required and forbidden route expectations
 - `latest-run-pointer.schema.json`: `.mustflow/state/runs/latest.json` when `mf verify` writes a
   pointer to the latest verify run bundle, including the verify completion verdict, evidence model,
   and coverage matrix

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"] }
+      }
     }
   }
 }