mustflow 2.74.5 → 2.74.6

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-  "version": "2.74.5",
+  "version": "2.74.6",
   "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

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.6"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"