mustflow 2.74.5 → 2.74.7

package/dist/cli/commands/api.js

@@ -9,6 +9,7 @@ import { listActiveRunLocks } from '../../core/active-run-locks.js';
 import { createChangeVerificationReport, } from '../../core/change-verification.js';
 import { createComplexityBudgetReport, } from '../../core/complexity-budget.js';
 import { readUtf8FileInsideWithoutSymlinks } from '../../core/safe-filesystem.js';
+import { createScriptPackSuggestionReport, } from '../../core/script-pack-suggestions.js';
 import { createVerificationPlanId } from '../../core/verification-plan-id.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { hasCliOptionToken } from '../lib/option-parser.js';
@@ -18,6 +19,7 @@ import { readGitChangedFiles } from '../lib/git-changes.js';
 import { t } from '../lib/i18n.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
 import { createRunPlan } from '../lib/run-plan.js';
+import { listScriptPackScripts } from '../lib/script-pack-registry.js';
 import { checkMustflowProjectReport } from '../lib/validation.js';
 const API_WORKSPACE_SUMMARY_SCHEMA_VERSION = '1';
 const API_COMMAND_CATALOG_SCHEMA_VERSION = '1';
@@ -411,6 +413,39 @@ function toVerificationPlanTestSelection(report) {
         note: report.test_selection.notes[0] ?? null,
     };
 }
+function createEmptyScriptPackSuggestions() {
+    return {
+        status: 'empty',
+        input: {
+            phases: [],
+            skills: [],
+            paths: [],
+            changed: false,
+        },
+        analyzed_paths: [],
+        suggestions: [],
+        issues: [],
+    };
+}
+function createApiScriptPackSuggestions(mustflowRoot, classification) {
+    if (!classification || classification.files.length === 0) {
+        return createEmptyScriptPackSuggestions();
+    }
+    const report = createScriptPackSuggestionReport(mustflowRoot, {
+        changed: false,
+        phases: ['after_change', 'review'],
+        skills: [],
+        paths: classification.files,
+        scripts: listScriptPackScripts(),
+    });
+    return {
+        status: report.status,
+        input: report.input,
+        analyzed_paths: report.analyzed_paths,
+        suggestions: report.suggestions,
+        issues: report.issues,
+    };
+}
 function createUnavailableVerificationPlanOutput(mustflowRoot, classification, issue) {
     return {
         schema_version: API_VERIFICATION_PLAN_SCHEMA_VERSION,
@@ -426,6 +461,7 @@ function createUnavailableVerificationPlanOutput(mustflowRoot, classification, i
         risk_assessment: null,
         schedule: null,
         test_selection: null,
+        script_pack_suggestions: createApiScriptPackSuggestions(mustflowRoot, classification),
         execution_policy: createVerificationPlanExecutionPolicy(),
         issues: [issue],
     };
@@ -484,6 +520,7 @@ function createVerificationPlanOutput() {
         risk_assessment: report.risk_assessment,
         schedule: toVerificationPlanSchedule(report),
         test_selection: toVerificationPlanTestSelection(report),
+        script_pack_suggestions: createApiScriptPackSuggestions(mustflowRoot, classification),
         execution_policy: createVerificationPlanExecutionPolicy(),
         issues: [],
     };

package/dist/cli/commands/skill.js

@@ -2,6 +2,8 @@ import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, getParsedCliStringOption, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
+import { listScriptPackScripts } from '../lib/script-pack-registry.js';
+import { createScriptPackSuggestionReport, } from '../../core/script-pack-suggestions.js';
 import { resolveSkillRoutes } from '../../core/skill-route-resolution.js';
 const SKILL_OPTIONS = [
     { name: '--json', kind: 'boolean' },
@@ -56,6 +58,29 @@ function parseSkillArgs(args) {
         error: parsed.error,
     };
 }
+function selectedSkillNames(report) {
+    return [...new Set([
+            ...(report.selected.main ? [report.selected.main.skill] : []),
+            ...report.selected.adjuncts.map((candidate) => candidate.skill),
+            ...report.candidates.map((candidate) => candidate.skill),
+        ])];
+}
+function createSkillRouteScriptPackSuggestions(mustflowRoot, report, paths) {
+    const suggestionReport = createScriptPackSuggestionReport(mustflowRoot, {
+        changed: false,
+        phases: ['before_change', 'during_change', 'review'],
+        skills: selectedSkillNames(report),
+        paths,
+        scripts: listScriptPackScripts(),
+    });
+    return {
+        status: suggestionReport.status,
+        input: suggestionReport.input,
+        analyzed_paths: suggestionReport.analyzed_paths,
+        suggestions: suggestionReport.suggestions,
+        issues: suggestionReport.issues,
+    };
+}
 function renderSkillRouteReport(report, lang) {
     const lines = [
         'mustflow skill route',
@@ -97,7 +122,8 @@ export function runSkill(args, reporter, lang = 'en') {
         printUsageError(reporter, t(lang, 'cli.error.unexpectedValue', { option: '--max-candidates' }), 'mf skill --help', getSkillHelp(lang), lang);
         return 1;
     }
-    const report = resolveSkillRoutes(resolveMustflowRoot(), {
+    const mustflowRoot = resolveMustflowRoot();
+    const report = resolveSkillRoutes(mustflowRoot, {
         taskText: parsed.taskText,
         paths: parsed.paths,
         reasons: parsed.reasons,
@@ -108,6 +134,7 @@ export function runSkill(args, reporter, lang = 'en') {
             ...report,
             command: 'skill',
             action: 'route',
+            script_pack_suggestions: createSkillRouteScriptPackSuggestions(mustflowRoot, report, parsed.paths),
         }, null, 2));
         return 0;
     }

package/package.json

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

package/schemas/README.md

@@ -11,7 +11,8 @@ Current schemas:
 - `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`, including
-  risk-priced evidence assessment for the changed surfaces and selected command contract
+  risk-priced evidence assessment for the changed surfaces, selected command contract, and optional
+  read-only script-pack helper suggestions
 - `latest-evidence.schema.json`: output of `mf api latest-evidence --json`
 - `diff-risk.schema.json`: output of `mf api diff-risk --changed --json`, including a read-only
   complexity budget for structural additions
@@ -71,8 +72,9 @@ Current schemas:
   `mf script-pack run repo/generated-boundary check <path...> --json`, containing candidate path
   classifications for generated, ignored, protected, vendor, and cache boundaries before or after edits
 - `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
+  candidates, selected main and adjunct skills, score breakdowns, route read plans, source route
+  shards, and optional read-only script-pack helper suggestions 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

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

@@ -153,9 +153,147 @@
     "gap_notes": {
       "type": "array",
       "items": { "type": "string" }
+    },
+    "script_pack_suggestions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "input", "analyzed_paths", "suggestions", "issues"],
+      "properties": {
+        "status": { "type": "string", "enum": ["suggested", "empty", "partial"] },
+        "input": { "$ref": "#/$defs/scriptPackSuggestionInput" },
+        "analyzed_paths": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackAnalyzedPath" }
+        },
+        "suggestions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSuggestion" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
     }
   },
   "$defs": {
+    "scriptPackPhase": {
+      "type": "string",
+      "enum": ["before_change", "during_change", "after_change", "review"]
+    },
+    "scriptPackSurface": {
+      "type": "string",
+      "enum": [
+        "config",
+        "docs",
+        "generated",
+        "package",
+        "schema",
+        "skill",
+        "source",
+        "template",
+        "test",
+        "unknown"
+      ]
+    },
+    "scriptPackSuggestionInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phases", "skills", "paths", "changed"],
+      "properties": {
+        "phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" }
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+        },
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "changed": { "type": "boolean" }
+      }
+    },
+    "scriptPackAnalyzedPath": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "surfaces"],
+      "properties": {
+        "path": { "type": "string" },
+        "surfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSurface" },
+          "minItems": 1
+        }
+      }
+    },
+    "scriptPackSuggestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "script_ref",
+        "score",
+        "confidence",
+        "usage",
+        "phases",
+        "matched_phases",
+        "matched_skills",
+        "matched_surfaces",
+        "reasons",
+        "read_only",
+        "mutates",
+        "network",
+        "risk_level",
+        "cost",
+        "report_schema_file",
+        "run_hint"
+      ],
+      "properties": {
+        "script_ref": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "score": { "type": "integer", "minimum": 0 },
+        "confidence": { "type": "string", "enum": ["low", "medium", "high"] },
+        "usage": { "type": "string" },
+        "phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" },
+          "minItems": 1
+        },
+        "matched_phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" }
+        },
+        "matched_skills": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+        },
+        "matched_surfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSurface" }
+        },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        },
+        "read_only": { "type": "boolean" },
+        "mutates": { "type": "boolean" },
+        "network": { "type": "boolean" },
+        "risk_level": { "type": "string", "enum": ["low", "medium", "high"] },
+        "cost": { "type": "string", "enum": ["low", "medium", "high"] },
+        "report_schema_file": {
+          "anyOf": [
+            { "type": "string", "pattern": "^[a-z0-9-]+\\.schema\\.json$" },
+            { "type": "null" }
+          ]
+        },
+        "run_hint": { "type": "string" }
+      }
+    },
     "candidate": {
       "type": "object",
       "additionalProperties": false,

package/schemas/verification-plan.schema.json

@@ -66,6 +66,27 @@
         { "$ref": "#/$defs/testSelection" }
       ]
     },
+    "script_pack_suggestions": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "input", "analyzed_paths", "suggestions", "issues"],
+      "properties": {
+        "status": { "type": "string", "enum": ["suggested", "empty", "partial"] },
+        "input": { "$ref": "#/$defs/scriptPackSuggestionInput" },
+        "analyzed_paths": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackAnalyzedPath" }
+        },
+        "suggestions": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSuggestion" }
+        },
+        "issues": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
     "execution_policy": { "$ref": "#/$defs/executionPolicy" },
     "issues": {
       "type": "array",
@@ -86,6 +107,123 @@
       "type": "array",
       "items": { "type": "string" }
     },
+    "scriptPackPhase": {
+      "type": "string",
+      "enum": ["before_change", "during_change", "after_change", "review"]
+    },
+    "scriptPackSurface": {
+      "type": "string",
+      "enum": [
+        "config",
+        "docs",
+        "generated",
+        "package",
+        "schema",
+        "skill",
+        "source",
+        "template",
+        "test",
+        "unknown"
+      ]
+    },
+    "scriptPackSuggestionInput": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["phases", "skills", "paths", "changed"],
+      "properties": {
+        "phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" }
+        },
+        "skills": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+        },
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "changed": { "type": "boolean" }
+      }
+    },
+    "scriptPackAnalyzedPath": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "surfaces"],
+      "properties": {
+        "path": { "type": "string" },
+        "surfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSurface" },
+          "minItems": 1
+        }
+      }
+    },
+    "scriptPackSuggestion": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "script_ref",
+        "score",
+        "confidence",
+        "usage",
+        "phases",
+        "matched_phases",
+        "matched_skills",
+        "matched_surfaces",
+        "reasons",
+        "read_only",
+        "mutates",
+        "network",
+        "risk_level",
+        "cost",
+        "report_schema_file",
+        "run_hint"
+      ],
+      "properties": {
+        "script_ref": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*/[a-z0-9]+(?:-[a-z0-9]+)*$"
+        },
+        "score": { "type": "integer", "minimum": 0 },
+        "confidence": { "type": "string", "enum": ["low", "medium", "high"] },
+        "usage": { "type": "string" },
+        "phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" },
+          "minItems": 1
+        },
+        "matched_phases": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackPhase" }
+        },
+        "matched_skills": {
+          "type": "array",
+          "items": { "type": "string", "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$" }
+        },
+        "matched_surfaces": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/scriptPackSurface" }
+        },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" },
+          "minItems": 1
+        },
+        "read_only": { "type": "boolean" },
+        "mutates": { "type": "boolean" },
+        "network": { "type": "boolean" },
+        "risk_level": { "type": "string", "enum": ["low", "medium", "high"] },
+        "cost": { "type": "string", "enum": ["low", "medium", "high"] },
+        "report_schema_file": {
+          "anyOf": [
+            { "type": "string", "pattern": "^[a-z0-9-]+\\.schema\\.json$" },
+            { "type": "null" }
+          ]
+        },
+        "run_hint": { "type": "string" }
+      }
+    },
     "classification": {
       "type": "object",
       "additionalProperties": false,

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.74.5"
+version = "2.74.7"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"