mustflow 2.74.2 → 2.74.4

package/dist/cli/commands/script-pack.js

@@ -1,9 +1,17 @@
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
 import { t } from '../lib/i18n.js';
-import { formatCliOptionParseError, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
+import { formatCliOptionParseError, getParsedCliStringOption, hasCliOptionToken, hasParsedCliOption, parseCliOptions, } from '../lib/option-parser.js';
 import { resolveMustflowRoot } from '../lib/project-root.js';
-import { findScriptPackScript, SCRIPT_PACKS, } from '../lib/script-pack-registry.js';
+import { findScriptPackScript, listScriptPackScripts, SCRIPT_PACKS, } from '../lib/script-pack-registry.js';
+import { createScriptPackSuggestionReport, isScriptPackSuggestionPhase, } from '../../core/script-pack-suggestions.js';
 const SCRIPT_PACK_LIST_OPTIONS = [{ name: '--json', kind: 'boolean' }];
+const SCRIPT_PACK_SUGGEST_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--changed', kind: 'boolean' },
+    { name: '--phase', kind: 'string' },
+    { name: '--skill', kind: 'string' },
+    { name: '--path', kind: 'string' },
+];
 function createCatalogReport(mustflowRoot, packs) {
     return {
         schema_version: '1',
@@ -20,6 +28,16 @@ function createCatalogReport(mustflowRoot, packs) {
                 usage: script.usage,
                 summary_key: script.summaryKey,
                 actions: script.actions,
+                use_when: script.useWhen,
+                phases: script.phases,
+                read_only: script.readOnly,
+                mutates: script.mutates,
+                network: script.network,
+                inputs: script.inputs,
+                outputs: script.outputs,
+                related_skills: script.relatedSkills,
+                risk_level: script.riskLevel,
+                cost: script.cost,
                 report_schema_file: script.reportSchemaFile,
             })),
         })),
@@ -28,16 +46,23 @@ function createCatalogReport(mustflowRoot, packs) {
 }
 export function getScriptPackHelp(lang = 'en') {
     return renderHelp({
-        usage: 'mf script-pack <list|run> [options]',
+        usage: 'mf script-pack <list|suggest|run> [options]',
         summary: t(lang, 'scriptPack.help.summary'),
         options: [
             { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '--changed', description: t(lang, 'scriptPack.help.option.changed') },
+            { label: '--phase <phase>', description: t(lang, 'scriptPack.help.option.phase') },
+            { label: '--skill <skill>', description: t(lang, 'scriptPack.help.option.skill') },
+            { label: '--path <path>', description: t(lang, 'scriptPack.help.option.path') },
             { label: '-h, --help', description: t(lang, 'cli.option.help') },
         ],
         examples: [
             'mf script-pack list',
             'mf script-pack list --json',
+            'mf script-pack suggest --path src/cli/index.ts --phase before_change',
+            'mf script-pack suggest --changed --phase after_change --json',
             'mf script-pack run core/text-budget check README.md --max 5000',
+            'mf script-pack run repo/generated-boundary check src/cli/index.ts --json',
             'mf script-pack run core/text-budget --help',
         ],
         exitCodes: [
@@ -67,6 +92,83 @@ function parseListOptions(args, lang) {
     }
     return { json };
 }
+function getParsedCliStringOccurrences(parsed, name) {
+    return parsed.occurrences
+        .filter((occurrence) => occurrence.name === name && typeof occurrence.value === 'string')
+        .map((occurrence) => String(occurrence.value));
+}
+function parseSuggestOptions(args, lang) {
+    const parsed = parseCliOptions(args, SCRIPT_PACK_SUGGEST_OPTIONS, { allowPositionals: true });
+    const json = hasParsedCliOption(parsed, '--json');
+    const changed = hasParsedCliOption(parsed, '--changed');
+    const phases = getParsedCliStringOccurrences(parsed, '--phase');
+    const invalidPhase = phases.find((phase) => !isScriptPackSuggestionPhase(phase));
+    if (parsed.error) {
+        return { json, changed, phases: [], skills: [], paths: parsed.positionals, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    if (invalidPhase) {
+        return {
+            json,
+            changed,
+            phases: [],
+            skills: [],
+            paths: parsed.positionals,
+            error: t(lang, 'scriptPack.error.unknownPhase', { phase: invalidPhase }),
+        };
+    }
+    const optionPaths = getParsedCliStringOccurrences(parsed, '--path');
+    const firstPath = getParsedCliStringOption(parsed, '--path');
+    const paths = optionPaths.length > 0 ? optionPaths : firstPath ? [firstPath] : [];
+    const skills = getParsedCliStringOccurrences(parsed, '--skill');
+    const selectorsPresent = changed || phases.length > 0 || skills.length > 0 || paths.length > 0 || parsed.positionals.length > 0;
+    if (!selectorsPresent) {
+        return {
+            json,
+            changed,
+            phases: phases.filter(isScriptPackSuggestionPhase),
+            skills,
+            paths,
+            error: t(lang, 'scriptPack.error.missingSuggestInput'),
+        };
+    }
+    return {
+        json,
+        changed,
+        phases: phases.filter(isScriptPackSuggestionPhase),
+        skills,
+        paths: [...paths, ...parsed.positionals],
+    };
+}
+function renderSuggestionSummary(report, lang) {
+    const lines = [
+        t(lang, 'scriptPack.suggest.title'),
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'scriptPack.suggest.label.suggestions')}: ${report.suggestions.length}`,
+    ];
+    if (report.analyzed_paths.length > 0) {
+        lines.push(t(lang, 'scriptPack.suggest.label.analyzedPaths'));
+        for (const entry of report.analyzed_paths) {
+            lines.push(`- ${entry.path}: ${entry.surfaces.join(', ')}`);
+        }
+    }
+    if (report.suggestions.length > 0) {
+        lines.push(t(lang, 'scriptPack.suggest.label.recommendations'));
+        for (const suggestion of report.suggestions) {
+            lines.push(`- ${suggestion.script_ref}: ${suggestion.confidence}, score ${suggestion.score}`);
+            for (const reason of suggestion.reasons) {
+                lines.push(`  - ${reason}`);
+            }
+            lines.push(`  - ${t(lang, 'scriptPack.suggest.label.runHint')}: ${suggestion.run_hint}`);
+        }
+    }
+    else {
+        lines.push(t(lang, 'scriptPack.suggest.empty'));
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'generatedBoundary.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    return lines.join('\n');
+}
 async function runScriptPackList(args, reporter, lang) {
     if (hasCliOptionToken(args, '--help', ['-h'])) {
         reporter.stdout(getScriptPackHelp(lang));
@@ -85,6 +187,30 @@ async function runScriptPackList(args, reporter, lang) {
     reporter.stdout(renderCatalogSummary(report, lang));
     return 0;
 }
+async function runScriptPackSuggest(args, reporter, lang) {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getScriptPackHelp(lang));
+        return 0;
+    }
+    const options = parseSuggestOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack suggest --help', getScriptPackHelp(lang), lang);
+        return 1;
+    }
+    const report = createScriptPackSuggestionReport(resolveMustflowRoot(), {
+        changed: options.changed,
+        phases: options.phases,
+        skills: options.skills,
+        paths: options.paths,
+        scripts: listScriptPackScripts(),
+    });
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return 0;
+    }
+    reporter.stdout(renderSuggestionSummary(report, lang));
+    return 0;
+}
 async function runScriptPackScript(args, reporter, lang) {
     const [scriptRef, ...scriptArgs] = args;
     if (args.length === 1 && hasCliOptionToken(args, '--help', ['-h'])) {
@@ -116,6 +242,9 @@ export async function runScriptPack(args, reporter, lang = 'en') {
     if (action === 'list') {
         return runScriptPackList(rest, reporter, lang);
     }
+    if (action === 'suggest') {
+        return runScriptPackSuggest(rest, reporter, lang);
+    }
     if (action === 'run') {
         return runScriptPackScript(rest, reporter, lang);
     }

package/dist/cli/i18n/en.js

@@ -40,7 +40,7 @@ export const enMessages = {
     "command.map.summary": "Generate REPO_MAP.md",
     "command.lineEndings.summary": "Inspect and normalize line-ending policy",
     "command.quality.summary": "Inspect changed files for quality-gaming patterns",
-    "command.scriptPack.summary": "List and run bundled mustflow script packs",
+    "command.scriptPack.summary": "List, suggest, and run bundled mustflow script packs",
     "command.run.summary": "Run a configured oneshot command",
     "command.context.summary": "Print machine-readable agent context",
     "command.tech.summary": "Manage technology preferences for agents",
@@ -749,19 +749,33 @@ Read these files before working:
     "quality.clean": "No quality-gaming risks found.",
     "quality.error.missingAction": "Specify a quality action: check",
     "quality.error.unknownAction": "Unknown quality action: {action}",
-    "scriptPack.help.summary": "List and run bundled mustflow script-pack utilities through one stable command namespace.",
+    "scriptPack.help.summary": "List, suggest, and run bundled mustflow script-pack utilities through one stable command namespace.",
     "scriptPack.help.exit.ok": "The script-pack command completed successfully",
     "scriptPack.help.exit.fail": "The script-pack command received invalid input or the selected script failed",
+    "scriptPack.help.option.changed": "Suggest scripts for current Git working-tree changes",
+    "scriptPack.help.option.phase": "Limit suggestions to before_change, during_change, after_change, or review",
+    "scriptPack.help.option.skill": "Prefer scripts related to a mustflow skill name",
+    "scriptPack.help.option.path": "Add a candidate path to classify for script suggestions",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "Suggestions",
+    "scriptPack.suggest.label.analyzedPaths": "Analyzed paths",
+    "scriptPack.suggest.label.recommendations": "Recommendations",
+    "scriptPack.suggest.label.runHint": "Run hint",
+    "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
-    "scriptPack.error.missingAction": "Specify a script-pack action: list or run",
+    "scriptPack.error.missingAction": "Specify a script-pack action: list, suggest, or run",
     "scriptPack.error.unknownAction": "Unknown script-pack action: {action}",
     "scriptPack.error.missingScript": "Specify a script ref such as core/text-budget",
     "scriptPack.error.unknownScript": "Unknown script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "Provide at least one suggestion input: --path <path>, --changed, --phase <phase>, or --skill <skill>",
+    "scriptPack.error.unknownPhase": "Unknown script-pack phase: {phase}",
     "textBudget.help.summary": "Check exact text length budgets for files or JSON string fields using grapheme counts by default.",
     "textBudget.help.option.min": "Require at least this many units",
     "textBudget.help.option.max": "Require at most this many units",
@@ -785,6 +799,19 @@ Read these files before working:
     "textBudget.error.invalidNumber": "{option} must be a non-negative safe integer: {value}",
     "textBudget.error.invalidUnit": "Unknown text-budget unit: {unit}. Use one of: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min must be less than or equal to --max",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": "Run a configured oneshot command from .mustflow/config/commands.toml.",
     "run.help.option.dryRun": "Print a non-executing command plan",
     "run.help.option.planOnly": "Alias for --dry-run",

package/dist/cli/i18n/es.js

@@ -40,7 +40,7 @@ export const esMessages = {
     "command.map.summary": "Genera REPO_MAP.md",
     "command.lineEndings.summary": "Inspecciona y normaliza la política de finales de línea",
     "command.quality.summary": "Inspect changed files for quality-gaming patterns",
-    "command.scriptPack.summary": "List and run bundled mustflow script packs",
+    "command.scriptPack.summary": "List, suggest, and run bundled mustflow script packs",
     "command.run.summary": "Ejecuta un comando configurado de una sola ejecución",
     "command.context.summary": "Imprime contexto de agente legible por máquinas",
     "command.tech.summary": "Gestiona preferencias tecnológicas para agentes",
@@ -749,19 +749,33 @@ Lee estos archivos antes de trabajar:
     "quality.clean": "No quality-gaming risks found.",
     "quality.error.missingAction": "Specify a quality action: check",
     "quality.error.unknownAction": "Unknown quality action: {action}",
-    "scriptPack.help.summary": "List and run bundled mustflow script-pack utilities through one stable command namespace.",
+    "scriptPack.help.summary": "List, suggest, and run bundled mustflow script-pack utilities through one stable command namespace.",
     "scriptPack.help.exit.ok": "The script-pack command completed successfully",
     "scriptPack.help.exit.fail": "The script-pack command received invalid input or the selected script failed",
+    "scriptPack.help.option.changed": "Suggest scripts for current Git working-tree changes",
+    "scriptPack.help.option.phase": "Limit suggestions to before_change, during_change, after_change, or review",
+    "scriptPack.help.option.skill": "Prefer scripts related to a mustflow skill name",
+    "scriptPack.help.option.path": "Add a candidate path to classify for script suggestions",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "Suggestions",
+    "scriptPack.suggest.label.analyzedPaths": "Analyzed paths",
+    "scriptPack.suggest.label.recommendations": "Recommendations",
+    "scriptPack.suggest.label.runHint": "Run hint",
+    "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
-    "scriptPack.error.missingAction": "Specify a script-pack action: list or run",
+    "scriptPack.error.missingAction": "Specify a script-pack action: list, suggest, or run",
     "scriptPack.error.unknownAction": "Unknown script-pack action: {action}",
     "scriptPack.error.missingScript": "Specify a script ref such as core/text-budget",
     "scriptPack.error.unknownScript": "Unknown script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "Provide at least one suggestion input: --path <path>, --changed, --phase <phase>, or --skill <skill>",
+    "scriptPack.error.unknownPhase": "Unknown script-pack phase: {phase}",
     "textBudget.help.summary": "Check exact text length budgets for files or JSON string fields using grapheme counts by default.",
     "textBudget.help.option.min": "Require at least this many units",
     "textBudget.help.option.max": "Require at most this many units",
@@ -785,6 +799,19 @@ Lee estos archivos antes de trabajar:
     "textBudget.error.invalidNumber": "{option} must be a non-negative safe integer: {value}",
     "textBudget.error.invalidUnit": "Unknown text-budget unit: {unit}. Use one of: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min must be less than or equal to --max",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": "Ejecuta un comando configurado de una sola ejecución desde .mustflow/config/commands.toml.",
     "run.help.option.dryRun": "Imprime un plan de comando sin ejecutarlo",
     "run.help.option.planOnly": "Alias de --dry-run",

package/dist/cli/i18n/fr.js

@@ -40,7 +40,7 @@ export const frMessages = {
     "command.map.summary": "Génère REPO_MAP.md",
     "command.lineEndings.summary": "Inspecte et normalise la politique de fins de ligne",
     "command.quality.summary": "Inspect changed files for quality-gaming patterns",
-    "command.scriptPack.summary": "List and run bundled mustflow script packs",
+    "command.scriptPack.summary": "List, suggest, and run bundled mustflow script packs",
     "command.run.summary": "Exécute une commande configurée à exécution unique",
     "command.context.summary": "Imprime le contexte d'agent lisible par machine",
     "command.tech.summary": "Gère les préférences technologiques pour les agents",
@@ -749,19 +749,33 @@ Lisez ces fichiers avant de travailler :
     "quality.clean": "No quality-gaming risks found.",
     "quality.error.missingAction": "Specify a quality action: check",
     "quality.error.unknownAction": "Unknown quality action: {action}",
-    "scriptPack.help.summary": "List and run bundled mustflow script-pack utilities through one stable command namespace.",
+    "scriptPack.help.summary": "List, suggest, and run bundled mustflow script-pack utilities through one stable command namespace.",
     "scriptPack.help.exit.ok": "The script-pack command completed successfully",
     "scriptPack.help.exit.fail": "The script-pack command received invalid input or the selected script failed",
+    "scriptPack.help.option.changed": "Suggest scripts for current Git working-tree changes",
+    "scriptPack.help.option.phase": "Limit suggestions to before_change, during_change, after_change, or review",
+    "scriptPack.help.option.skill": "Prefer scripts related to a mustflow skill name",
+    "scriptPack.help.option.path": "Add a candidate path to classify for script suggestions",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "Suggestions",
+    "scriptPack.suggest.label.analyzedPaths": "Analyzed paths",
+    "scriptPack.suggest.label.recommendations": "Recommendations",
+    "scriptPack.suggest.label.runHint": "Run hint",
+    "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
-    "scriptPack.error.missingAction": "Specify a script-pack action: list or run",
+    "scriptPack.error.missingAction": "Specify a script-pack action: list, suggest, or run",
     "scriptPack.error.unknownAction": "Unknown script-pack action: {action}",
     "scriptPack.error.missingScript": "Specify a script ref such as core/text-budget",
     "scriptPack.error.unknownScript": "Unknown script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "Provide at least one suggestion input: --path <path>, --changed, --phase <phase>, or --skill <skill>",
+    "scriptPack.error.unknownPhase": "Unknown script-pack phase: {phase}",
     "textBudget.help.summary": "Check exact text length budgets for files or JSON string fields using grapheme counts by default.",
     "textBudget.help.option.min": "Require at least this many units",
     "textBudget.help.option.max": "Require at most this many units",
@@ -785,6 +799,19 @@ Lisez ces fichiers avant de travailler :
     "textBudget.error.invalidNumber": "{option} must be a non-negative safe integer: {value}",
     "textBudget.error.invalidUnit": "Unknown text-budget unit: {unit}. Use one of: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min must be less than or equal to --max",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": "Exécute une commande configurée à exécution unique depuis .mustflow/config/commands.toml.",
     "run.help.option.dryRun": "Imprime un plan de commande sans l'exécuter",
     "run.help.option.planOnly": "Alias de --dry-run",

package/dist/cli/i18n/hi.js

@@ -40,7 +40,7 @@ export const hiMessages = {
     "command.map.summary": "REPO_MAP.md बनाएँ",
     "command.lineEndings.summary": "लाइन-एंडिंग नीति की जाँच और सामान्यीकरण करें",
     "command.quality.summary": "Inspect changed files for quality-gaming patterns",
-    "command.scriptPack.summary": "List and run bundled mustflow script packs",
+    "command.scriptPack.summary": "List, suggest, and run bundled mustflow script packs",
     "command.run.summary": "कॉन्फ़िगर की गई एक-बार चलने वाली कमांड चलाएँ",
     "command.context.summary": "मशीन-पठनीय एजेंट संदर्भ प्रिंट करें",
     "command.tech.summary": "एजेंटों के लिए technology preferences प्रबंधित करें",
@@ -749,19 +749,33 @@ export const hiMessages = {
     "quality.clean": "No quality-gaming risks found.",
     "quality.error.missingAction": "Specify a quality action: check",
     "quality.error.unknownAction": "Unknown quality action: {action}",
-    "scriptPack.help.summary": "List and run bundled mustflow script-pack utilities through one stable command namespace.",
+    "scriptPack.help.summary": "List, suggest, and run bundled mustflow script-pack utilities through one stable command namespace.",
     "scriptPack.help.exit.ok": "The script-pack command completed successfully",
     "scriptPack.help.exit.fail": "The script-pack command received invalid input or the selected script failed",
+    "scriptPack.help.option.changed": "Suggest scripts for current Git working-tree changes",
+    "scriptPack.help.option.phase": "Limit suggestions to before_change, during_change, after_change, or review",
+    "scriptPack.help.option.skill": "Prefer scripts related to a mustflow skill name",
+    "scriptPack.help.option.path": "Add a candidate path to classify for script suggestions",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "Suggestions",
+    "scriptPack.suggest.label.analyzedPaths": "Analyzed paths",
+    "scriptPack.suggest.label.recommendations": "Recommendations",
+    "scriptPack.suggest.label.runHint": "Run hint",
+    "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
-    "scriptPack.error.missingAction": "Specify a script-pack action: list or run",
+    "scriptPack.error.missingAction": "Specify a script-pack action: list, suggest, or run",
     "scriptPack.error.unknownAction": "Unknown script-pack action: {action}",
     "scriptPack.error.missingScript": "Specify a script ref such as core/text-budget",
     "scriptPack.error.unknownScript": "Unknown script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "Provide at least one suggestion input: --path <path>, --changed, --phase <phase>, or --skill <skill>",
+    "scriptPack.error.unknownPhase": "Unknown script-pack phase: {phase}",
     "textBudget.help.summary": "Check exact text length budgets for files or JSON string fields using grapheme counts by default.",
     "textBudget.help.option.min": "Require at least this many units",
     "textBudget.help.option.max": "Require at most this many units",
@@ -785,6 +799,19 @@ export const hiMessages = {
     "textBudget.error.invalidNumber": "{option} must be a non-negative safe integer: {value}",
     "textBudget.error.invalidUnit": "Unknown text-budget unit: {unit}. Use one of: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min must be less than or equal to --max",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": ".mustflow/config/commands.toml से कॉन्फ़िगर की गई एक-बार चलने वाली कमांड चलाएँ।",
     "run.help.option.dryRun": "कमांड चलाए बिना उसका plan प्रिंट करें",
     "run.help.option.planOnly": "--dry-run का alias",

package/dist/cli/i18n/ko.js

@@ -40,7 +40,7 @@ export const koMessages = {
     "command.map.summary": "REPO_MAP.md를 작성합니다",
     "command.lineEndings.summary": "줄바꿈 정책을 검사하고 정규화합니다",
     "command.quality.summary": "변경 파일의 품질 지표 꼼수를 검사합니다",
-    "command.scriptPack.summary": "mustflow 내장 script pack을 나열하고 실행합니다",
+    "command.scriptPack.summary": "mustflow 내장 script pack을 나열, 추천, 실행합니다",
     "command.run.summary": "설정된 일회성 명령을 실행합니다",
     "command.context.summary": "에이전트 작업 맥락을 출력합니다",
     "command.tech.summary": "에이전트용 기술 선호를 관리합니다",
@@ -749,19 +749,33 @@ export const koMessages = {
     "quality.clean": "품질 지표 꼼수가 발견되지 않았습니다.",
     "quality.error.missingAction": "quality 작업을 지정하세요: check",
     "quality.error.unknownAction": "알 수 없는 quality 작업: {action}",
-    "scriptPack.help.summary": "mustflow 내장 utility script들을 하나의 안정적인 command namespace 아래에서 나열하고 실행합니다.",
+    "scriptPack.help.summary": "mustflow 내장 utility script들을 하나의 안정적인 command namespace 아래에서 나열, 추천, 실행합니다.",
     "scriptPack.help.exit.ok": "script-pack 명령이 성공적으로 완료되었습니다",
     "scriptPack.help.exit.fail": "script-pack 명령에 잘못된 입력이 제공되었거나 선택한 script가 실패했습니다",
+    "scriptPack.help.option.changed": "현재 Git 작업 트리 변경에 맞는 script를 추천합니다",
+    "scriptPack.help.option.phase": "추천을 before_change, during_change, after_change, review 중 하나로 좁힙니다",
+    "scriptPack.help.option.skill": "mustflow skill 이름과 관련된 script를 우선합니다",
+    "scriptPack.help.option.path": "script 추천을 위해 분류할 후보 경로를 추가합니다",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "추천",
+    "scriptPack.suggest.label.analyzedPaths": "분석한 경로",
+    "scriptPack.suggest.label.recommendations": "추천 항목",
+    "scriptPack.suggest.label.runHint": "실행 힌트",
+    "scriptPack.suggest.empty": "제공된 경로, skill, phase에 맞는 script-pack 추천이 없습니다.",
     "scriptPack.pack.core.summary": "핵심 내장 utility script",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "파일이나 JSON 문자열 필드의 정확한 텍스트 길이 예산을 검사합니다",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "작업",
     "scriptPack.label.schema": "스키마",
-    "scriptPack.error.missingAction": "script-pack 작업을 지정하세요: list 또는 run",
+    "scriptPack.error.missingAction": "script-pack 작업을 지정하세요: list, suggest, 또는 run",
     "scriptPack.error.unknownAction": "알 수 없는 script-pack 작업: {action}",
     "scriptPack.error.missingScript": "core/text-budget 같은 script ref를 지정하세요",
     "scriptPack.error.unknownScript": "알 수 없는 script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "추천 입력을 하나 이상 제공하세요: --path <path>, --changed, --phase <phase>, 또는 --skill <skill>",
+    "scriptPack.error.unknownPhase": "알 수 없는 script-pack phase: {phase}",
     "textBudget.help.summary": "파일이나 JSON 문자열 필드의 정확한 텍스트 길이 예산을 검사합니다. 기본 단위는 grapheme입니다.",
     "textBudget.help.option.min": "최소 단위 수를 요구합니다",
     "textBudget.help.option.max": "최대 단위 수를 요구합니다",
@@ -785,6 +799,19 @@ export const koMessages = {
     "textBudget.error.invalidNumber": "{option} 값은 0 이상의 안전한 정수여야 합니다: {value}",
     "textBudget.error.invalidUnit": "알 수 없는 text-budget 단위: {unit}. 다음 중 하나를 사용하세요: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min은 --max보다 작거나 같아야 합니다",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": ".mustflow/config/commands.toml에 설정된 일회성 명령을 실행합니다.",
     "run.help.option.dryRun": "실행하지 않고 명령 계획을 출력합니다",
     "run.help.option.planOnly": "--dry-run과 같은 동작입니다",

package/dist/cli/i18n/zh.js

@@ -40,7 +40,7 @@ export const zhMessages = {
     "command.map.summary": "生成 REPO_MAP.md",
     "command.lineEndings.summary": "检查并规范化换行符策略",
     "command.quality.summary": "Inspect changed files for quality-gaming patterns",
-    "command.scriptPack.summary": "List and run bundled mustflow script packs",
+    "command.scriptPack.summary": "List, suggest, and run bundled mustflow script packs",
     "command.run.summary": "运行已配置的一次性命令",
     "command.context.summary": "输出机器可读的代理上下文",
     "command.tech.summary": "管理代理使用的技术偏好",
@@ -749,19 +749,33 @@ export const zhMessages = {
     "quality.clean": "No quality-gaming risks found.",
     "quality.error.missingAction": "Specify a quality action: check",
     "quality.error.unknownAction": "Unknown quality action: {action}",
-    "scriptPack.help.summary": "List and run bundled mustflow script-pack utilities through one stable command namespace.",
+    "scriptPack.help.summary": "List, suggest, and run bundled mustflow script-pack utilities through one stable command namespace.",
     "scriptPack.help.exit.ok": "The script-pack command completed successfully",
     "scriptPack.help.exit.fail": "The script-pack command received invalid input or the selected script failed",
+    "scriptPack.help.option.changed": "Suggest scripts for current Git working-tree changes",
+    "scriptPack.help.option.phase": "Limit suggestions to before_change, during_change, after_change, or review",
+    "scriptPack.help.option.skill": "Prefer scripts related to a mustflow skill name",
+    "scriptPack.help.option.path": "Add a candidate path to classify for script suggestions",
     "scriptPack.title": "mustflow script packs",
+    "scriptPack.suggest.title": "mustflow script suggestions",
+    "scriptPack.suggest.label.suggestions": "Suggestions",
+    "scriptPack.suggest.label.analyzedPaths": "Analyzed paths",
+    "scriptPack.suggest.label.recommendations": "Recommendations",
+    "scriptPack.suggest.label.runHint": "Run hint",
+    "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
-    "scriptPack.error.missingAction": "Specify a script-pack action: list or run",
+    "scriptPack.error.missingAction": "Specify a script-pack action: list, suggest, or run",
     "scriptPack.error.unknownAction": "Unknown script-pack action: {action}",
     "scriptPack.error.missingScript": "Specify a script ref such as core/text-budget",
     "scriptPack.error.unknownScript": "Unknown script-pack script: {script}",
+    "scriptPack.error.missingSuggestInput": "Provide at least one suggestion input: --path <path>, --changed, --phase <phase>, or --skill <skill>",
+    "scriptPack.error.unknownPhase": "Unknown script-pack phase: {phase}",
     "textBudget.help.summary": "Check exact text length budgets for files or JSON string fields using grapheme counts by default.",
     "textBudget.help.option.min": "Require at least this many units",
     "textBudget.help.option.max": "Require at most this many units",
@@ -785,6 +799,19 @@ export const zhMessages = {
     "textBudget.error.invalidNumber": "{option} must be a non-negative safe integer: {value}",
     "textBudget.error.invalidUnit": "Unknown text-budget unit: {unit}. Use one of: {allowed}",
     "textBudget.error.minGreaterThanMax": "--min must be less than or equal to --max",
+    "generatedBoundary.help.summary": "Check whether candidate edit paths cross generated, ignored, protected, vendor, or cache boundaries.",
+    "generatedBoundary.help.exit.ok": "Every checked target stayed within ordinary editable project paths",
+    "generatedBoundary.help.exit.fail": "A target crossed a generated, ignored, protected, vendor, cache, or root boundary",
+    "generatedBoundary.title": "mustflow generated boundary",
+    "generatedBoundary.label.checkedTargets": "Checked targets",
+    "generatedBoundary.label.findings": "Findings",
+    "generatedBoundary.label.targets": "Targets",
+    "generatedBoundary.label.boundaries": "boundaries",
+    "generatedBoundary.label.issues": "Issues",
+    "generatedBoundary.clean": "No generated, ignored, protected, vendor, or cache boundaries matched.",
+    "generatedBoundary.error.missingAction": "Specify a generated-boundary action: check",
+    "generatedBoundary.error.unknownAction": "Unknown generated-boundary action: {action}",
+    "generatedBoundary.error.missingPath": "Provide at least one path to check",
     "run.help.summary": "从 .mustflow/config/commands.toml 运行已配置的一次性命令。",
     "run.help.option.dryRun": "输出命令计划但不执行",
     "run.help.option.planOnly": "--dry-run 的别名",