mustflow 2.74.6 → 2.74.7

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.6",
+  "version": "2.74.7",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

package/schemas/README.md

@@ -72,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/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.74.6"
+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"