mustflow 2.74.4 → 2.74.5

package/dist/cli/commands/next.js

@@ -2,12 +2,14 @@ import { createClassifyOutput } from './classify.js';
 import { createChangeVerificationReport, } from '../../core/change-verification.js';
 import { isRecord, readCommandContract, } from '../../core/config-loading.js';
 import { createVerificationPlanId } from '../../core/verification-plan-id.js';
+import { createScriptPackSuggestionReport, } from '../../core/script-pack-suggestions.js';
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { getAgentContext } from '../lib/agent-context.js';
 import { t } from '../lib/i18n.js';
 import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.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 NEXT_SCHEMA_VERSION = '1';
 const COMMAND_AUTHORITY = '.mustflow/config/commands.toml';
@@ -65,6 +67,7 @@ function toOutput(input) {
         blockers: input.blockers ?? [],
         warnings: input.warnings ?? [],
         gaps: input.gaps ?? [],
+        script_pack_suggestions: input.scriptPackSuggestions ?? createEmptyScriptPackSuggestions(),
         verification_plan_id: input.verificationPlanId ?? null,
     };
 }
@@ -82,6 +85,39 @@ function toNextGap(gap) {
         detail: gap.detail,
     };
 }
+function createEmptyScriptPackSuggestions() {
+    return {
+        status: 'empty',
+        input: {
+            phases: [],
+            skills: [],
+            paths: [],
+            changed: false,
+        },
+        analyzed_paths: [],
+        suggestions: [],
+        issues: [],
+    };
+}
+function createNextScriptPackSuggestions(mustflowRoot, classification) {
+    if (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 runnableIntentCommand(mustflowRoot, contract, intentName) {
     const rawIntent = contract.intents[intentName];
     if (!isRecord(rawIntent)) {
@@ -100,6 +136,7 @@ function createChangedOutput(mustflowRoot, contract, classification, report) {
     const intents = selectedIntents(report);
     const gaps = report.gaps.map(toNextGap);
     const verificationPlanId = createVerificationPlanId(report, contract);
+    const scriptPackSuggestions = createNextScriptPackSuggestions(mustflowRoot, classification);
     const state = createState({
         installed: true,
         check_ok: true,
@@ -120,6 +157,7 @@ function createChangedOutput(mustflowRoot, contract, classification, report) {
             recommendedCommands: [...fallbackCommands(mustflowRoot, contract), ...(intents.length > 0 ? ['mf verify --changed --json'] : [])],
             blockers: gaps.map((gap) => gap.detail),
             gaps,
+            scriptPackSuggestions,
             verificationPlanId,
         });
     }
@@ -130,6 +168,7 @@ function createChangedOutput(mustflowRoot, contract, classification, report) {
             state,
             decision: action('verify', 'mf verify --changed --json', 'Run configured verification', 'Changed files have runnable configured verification intents. Use mustflow verification instead of direct commands.'),
             recommendedCommands: ['mf api verification-plan --changed --json', 'mf verify --changed --json'],
+            scriptPackSuggestions,
             verificationPlanId,
         });
     }
@@ -139,6 +178,7 @@ function createChangedOutput(mustflowRoot, contract, classification, report) {
         state,
         decision: action('inspect', 'mf api verification-plan --changed --json', 'Inspect verification plan', 'No runnable verification entries were selected.'),
         recommendedCommands: ['mf api verification-plan --changed --json'],
+        scriptPackSuggestions,
         verificationPlanId,
     });
 }
@@ -272,6 +312,16 @@ function renderNextOutput(output, lang) {
             lines.push(`- ${warning}`);
         }
     }
+    if (output.script_pack_suggestions.suggestions.length > 0 || output.script_pack_suggestions.issues.length > 0) {
+        lines.push('', t(lang, 'scriptPack.suggest.label.recommendations'));
+        for (const suggestion of output.script_pack_suggestions.suggestions) {
+            lines.push(`- ${suggestion.script_ref}: ${suggestion.confidence}, score ${suggestion.score}`);
+            lines.push(`  ${t(lang, 'scriptPack.suggest.label.runHint')}: ${suggestion.run_hint}`);
+        }
+        for (const issue of output.script_pack_suggestions.issues) {
+            lines.push(`- ${issue}`);
+        }
+    }
     lines.push('', t(lang, 'next.section.commands'));
     for (const command of output.recommended_commands) {
         lines.push(`- ${command}`);

package/package.json

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

package/schemas/README.md

@@ -29,7 +29,8 @@ Current schemas:
 - `onboard-commands-report.schema.json`: output of `mf onboard commands --json`, containing
   review-only command-intent suggestions that do not grant command authority or write files
 - `next-report.schema.json`: output of `mf next --json`, containing the next safe action,
-  changed-file verification gaps, and read-only command recommendations
+  changed-file verification gaps, read-only command recommendations, and optional read-only
+  script-pack helper suggestions
 - `evidence-report.schema.json`: output of `mf evidence --changed --json`, containing verification
   requirements, risk-priced evidence assessment, latest bounded evidence, failure replay capsules,
   conflict ledgers, receipts, remaining risks, and gaps without running commands

package/schemas/next-report.schema.json

@@ -116,6 +116,146 @@
         }
       }
     },
+    "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" }
+        }
+      }
+    },
     "verification_plan_id": { "type": ["string", "null"] }
+  },
+  "$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" }
+      }
+    }
   }
 }

package/templates/default/manifest.toml

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