mustflow 2.85.4 → 2.99.0

package/dist/cli/script-packs/repo-approval-gate.js

@@ -0,0 +1,100 @@
+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 { resolveMustflowRoot } from '../lib/project-root.js';
+import { checkRepoApprovalGate, REPO_APPROVAL_GATE_SCRIPT_REF, } from '../../core/repo-approval-gate.js';
+const REPO_APPROVAL_GATE_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--action', kind: 'string' },
+];
+export function getRepoApprovalGateHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/approval-gate check --action <type> [options]',
+        summary: t(lang, 'approvalGate.help.summary'),
+        options: [
+            { label: '--action <type>', description: t(lang, 'approvalGate.help.option.action') },
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/approval-gate check --action git_commit',
+            'mf script-pack run repo/approval-gate check --action dependency_install --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'approvalGate.help.exit.ok') },
+            { label: '1', description: t(lang, 'approvalGate.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parsedStringOccurrences(parsed, name) {
+    return parsed.occurrences
+        .filter((occurrence) => occurrence.name === name && typeof occurrence.value === 'string')
+        .map((occurrence) => String(occurrence.value));
+}
+function parseRepoApprovalGateOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, REPO_APPROVAL_GATE_OPTIONS, { allowPositionals: false });
+    const json = hasParsedCliOption(parsed, '--json');
+    const actionTypes = parsedStringOccurrences(parsed, '--action').map((entry) => entry.trim()).filter(Boolean);
+    if (action !== 'check') {
+        return {
+            action: 'check',
+            json,
+            actionTypes,
+            error: action
+                ? t(lang, 'approvalGate.error.unknownAction', { action })
+                : t(lang, 'approvalGate.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, json, actionTypes, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    if (actionTypes.length === 0) {
+        return { action, json, actionTypes, error: t(lang, 'approvalGate.error.missingActionType') };
+    }
+    return { action, json, actionTypes };
+}
+function renderRepoApprovalGateSummary(report, lang) {
+    const lines = [
+        t(lang, 'approvalGate.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${REPO_APPROVAL_GATE_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'approvalGate.label.approvalRequired')}: ${report.approval_required ? t(lang, 'value.yes') : t(lang, 'value.no')}`,
+        `${t(lang, 'approvalGate.label.configuredRequiredActions')}: ${report.policy.required_for.length}`,
+    ];
+    if (report.decisions.length > 0) {
+        lines.push(t(lang, 'approvalGate.label.decisions'));
+        for (const decision of report.decisions) {
+            const state = decision.approval_required ? t(lang, 'value.yes') : t(lang, 'value.no');
+            lines.push(`- ${decision.action_type}: ${state} (${decision.reason})`);
+        }
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'approvalGate.label.findings'));
+        for (const finding of report.findings) {
+            lines.push(`- ${finding.code}: ${finding.message}`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'approvalGate.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    return lines.join('\n');
+}
+export function runRepoApprovalGateScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoApprovalGateHelp(lang));
+        return 0;
+    }
+    const options = parseRepoApprovalGateOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/approval-gate --help', getRepoApprovalGateHelp(lang), lang);
+        return 1;
+    }
+    const report = checkRepoApprovalGate(resolveMustflowRoot(), options.actionTypes);
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderRepoApprovalGateSummary(report, lang));
+    return report.ok ? 0 : 1;
+}

package/dist/cli/script-packs/repo-git-ignore-audit.js

@@ -0,0 +1,119 @@
+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 { auditRepoGitIgnore, REPO_GIT_IGNORE_AUDIT_SCRIPT_REF, } from '../../core/repo-git-ignore-audit.js';
+const REPO_GIT_IGNORE_AUDIT_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--max-paths', kind: 'string' },
+];
+export function getRepoGitIgnoreAuditHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/git-ignore-audit audit [path...] [options]',
+        summary: t(lang, 'gitIgnoreAudit.help.summary'),
+        options: [
+            { label: '--max-paths <n>', description: t(lang, 'gitIgnoreAudit.help.option.maxPaths') },
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/git-ignore-audit audit --json',
+            'mf script-pack run repo/git-ignore-audit audit .env.local dist/app.js --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'gitIgnoreAudit.help.exit.ok') },
+            { label: '1', description: t(lang, 'gitIgnoreAudit.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parsePositiveInteger(value, label, lang) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        return t(lang, 'gitIgnoreAudit.error.invalidPositiveInteger', { option: label });
+    }
+    return parsed;
+}
+function parseRepoGitIgnoreAuditOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, REPO_GIT_IGNORE_AUDIT_OPTIONS, { allowPositionals: true });
+    const json = hasParsedCliOption(parsed, '--json');
+    if (action !== 'audit') {
+        return {
+            action: 'audit',
+            paths: parsed.positionals,
+            json,
+            error: action
+                ? t(lang, 'gitIgnoreAudit.error.unknownAction', { action })
+                : t(lang, 'gitIgnoreAudit.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, paths: parsed.positionals, json, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    const maxPaths = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-paths') ?? undefined, '--max-paths', lang);
+    if (typeof maxPaths === 'string') {
+        return { action, paths: parsed.positionals, json, error: maxPaths };
+    }
+    return {
+        action,
+        paths: parsed.positionals,
+        json,
+        maxPaths,
+    };
+}
+function renderRepoGitIgnoreAuditSummary(report, lang) {
+    const lines = [
+        t(lang, 'gitIgnoreAudit.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${REPO_GIT_IGNORE_AUDIT_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'gitIgnoreAudit.label.pathsChecked')}: ${report.summary.paths_checked}`,
+        `${t(lang, 'gitIgnoreAudit.label.ignoredPaths')}: ${report.summary.ignored_paths}`,
+        `${t(lang, 'gitIgnoreAudit.label.ignoreSources')}: ${report.summary.ignore_sources}`,
+    ];
+    if (report.paths.length > 0) {
+        lines.push(t(lang, 'gitIgnoreAudit.label.paths'));
+        for (const entry of report.paths) {
+            const evidence = entry.source_path && entry.source_line
+                ? ` (${entry.source_path}:${entry.source_line} ${entry.pattern ?? ''})`
+                : '';
+            lines.push(`- ${entry.path}: ${entry.status}${evidence}`);
+        }
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'gitIgnoreAudit.label.findings'));
+        for (const finding of report.findings) {
+            lines.push(`- ${finding.path}: ${finding.code} (${finding.message})`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'gitIgnoreAudit.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.paths.length === 0 && report.findings.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'gitIgnoreAudit.clean'));
+    }
+    return lines.join('\n');
+}
+export function runRepoGitIgnoreAuditScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoGitIgnoreAuditHelp(lang));
+        return 0;
+    }
+    const options = parseRepoGitIgnoreAuditOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/git-ignore-audit --help', getRepoGitIgnoreAuditHelp(lang), lang);
+        return 1;
+    }
+    const report = auditRepoGitIgnore(resolveMustflowRoot(), {
+        paths: options.paths,
+        maxPaths: options.maxPaths,
+    });
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderRepoGitIgnoreAuditSummary(report, lang));
+    return report.ok ? 0 : 1;
+}

package/dist/cli/script-packs/repo-manifest-lock-drift.js

@@ -0,0 +1,122 @@
+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 { checkRepoManifestLockDrift, REPO_MANIFEST_LOCK_DRIFT_SCRIPT_REF, } from '../../core/repo-manifest-lock-drift.js';
+const REPO_MANIFEST_LOCK_DRIFT_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--max-entries', kind: 'string' },
+];
+export function getRepoManifestLockDriftHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/manifest-lock-drift check [path...] [options]',
+        summary: t(lang, 'manifestLockDrift.help.summary'),
+        options: [
+            { label: '--max-entries <n>', description: t(lang, 'manifestLockDrift.help.option.maxEntries') },
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/manifest-lock-drift check --json',
+            'mf script-pack run repo/manifest-lock-drift check AGENTS.md .mustflow/config/commands.toml --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'manifestLockDrift.help.exit.ok') },
+            { label: '1', description: t(lang, 'manifestLockDrift.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parsePositiveInteger(value, label, lang) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        return t(lang, 'manifestLockDrift.error.invalidPositiveInteger', { option: label });
+    }
+    return parsed;
+}
+function parseRepoManifestLockDriftOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, REPO_MANIFEST_LOCK_DRIFT_OPTIONS, { allowPositionals: true });
+    const json = hasParsedCliOption(parsed, '--json');
+    if (action !== 'check') {
+        return {
+            action: 'check',
+            paths: parsed.positionals,
+            json,
+            error: action
+                ? t(lang, 'manifestLockDrift.error.unknownAction', { action })
+                : t(lang, 'manifestLockDrift.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, paths: parsed.positionals, json, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    const maxEntries = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-entries') ?? undefined, '--max-entries', lang);
+    if (typeof maxEntries === 'string') {
+        return { action, paths: parsed.positionals, json, error: maxEntries };
+    }
+    return {
+        action,
+        paths: parsed.positionals,
+        json,
+        maxEntries,
+    };
+}
+function renderRepoManifestLockDriftSummary(report, lang) {
+    const lines = [
+        t(lang, 'manifestLockDrift.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${REPO_MANIFEST_LOCK_DRIFT_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'manifestLockDrift.label.entriesChecked')}: ${report.summary.entries_checked}`,
+        `${t(lang, 'manifestLockDrift.label.hashMismatches')}: ${report.summary.hash_mismatches}`,
+        `${t(lang, 'manifestLockDrift.label.missingEntries')}: ${report.summary.missing_entries}`,
+    ];
+    if (report.entries.length > 0) {
+        lines.push(t(lang, 'manifestLockDrift.label.entries'));
+        for (const entry of report.entries) {
+            if (entry.status === 'skipped') {
+                continue;
+            }
+            const evidence = entry.lock_hash && entry.actual_hash && entry.lock_hash !== entry.actual_hash
+                ? ` (${entry.lock_hash} != ${entry.actual_hash})`
+                : '';
+            lines.push(`- ${entry.path}: ${entry.status}${evidence}`);
+        }
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'manifestLockDrift.label.findings'));
+        for (const finding of report.findings) {
+            lines.push(`- ${finding.path}: ${finding.code} (${finding.message})`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'manifestLockDrift.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.findings.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'manifestLockDrift.clean'));
+    }
+    return lines.join('\n');
+}
+export function runRepoManifestLockDriftScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoManifestLockDriftHelp(lang));
+        return 0;
+    }
+    const options = parseRepoManifestLockDriftOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/manifest-lock-drift --help', getRepoManifestLockDriftHelp(lang), lang);
+        return 1;
+    }
+    const report = checkRepoManifestLockDrift(resolveMustflowRoot(), {
+        paths: options.paths,
+        maxEntries: options.maxEntries,
+    });
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderRepoManifestLockDriftSummary(report, lang));
+    return report.ok ? 0 : 1;
+}

package/dist/cli/script-packs/repo-merge-conflict-scan.js

@@ -0,0 +1,123 @@
+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 { checkRepoMergeConflictScan, REPO_MERGE_CONFLICT_SCAN_SCRIPT_REF, } from '../../core/repo-merge-conflict-scan.js';
+const REPO_MERGE_CONFLICT_SCAN_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--max-files', kind: 'string' },
+    { name: '--max-file-bytes', kind: 'string' },
+];
+export function getRepoMergeConflictScanHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/merge-conflict-scan check [path...] [options]',
+        summary: t(lang, 'mergeConflictScan.help.summary'),
+        options: [
+            { label: '--max-files <n>', description: t(lang, 'mergeConflictScan.help.option.maxFiles') },
+            { label: '--max-file-bytes <n>', description: t(lang, 'mergeConflictScan.help.option.maxFileBytes') },
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/merge-conflict-scan check --json',
+            'mf script-pack run repo/merge-conflict-scan check src README.md --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'mergeConflictScan.help.exit.ok') },
+            { label: '1', description: t(lang, 'mergeConflictScan.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parsePositiveInteger(value, label, lang) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        return t(lang, 'mergeConflictScan.error.invalidPositiveInteger', { option: label });
+    }
+    return parsed;
+}
+function parseRepoMergeConflictScanOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, REPO_MERGE_CONFLICT_SCAN_OPTIONS, { allowPositionals: true });
+    const json = hasParsedCliOption(parsed, '--json');
+    if (action !== 'check') {
+        return {
+            action: 'check',
+            paths: parsed.positionals,
+            json,
+            error: action
+                ? t(lang, 'mergeConflictScan.error.unknownAction', { action })
+                : t(lang, 'mergeConflictScan.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, paths: parsed.positionals, json, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    const maxFiles = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-files') ?? undefined, '--max-files', lang);
+    if (typeof maxFiles === 'string') {
+        return { action, paths: parsed.positionals, json, error: maxFiles };
+    }
+    const maxFileBytes = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-file-bytes') ?? undefined, '--max-file-bytes', lang);
+    if (typeof maxFileBytes === 'string') {
+        return { action, paths: parsed.positionals, json, error: maxFileBytes };
+    }
+    return {
+        action,
+        paths: parsed.positionals,
+        json,
+        maxFiles,
+        maxFileBytes,
+    };
+}
+function renderRepoMergeConflictScanSummary(report, lang) {
+    const lines = [
+        t(lang, 'mergeConflictScan.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${REPO_MERGE_CONFLICT_SCAN_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'mergeConflictScan.label.filesChecked')}: ${report.summary.files_checked}`,
+        `${t(lang, 'mergeConflictScan.label.markersFound')}: ${report.summary.markers_found}`,
+    ];
+    if (report.markers.length > 0) {
+        lines.push(t(lang, 'mergeConflictScan.label.markers'));
+        for (const marker of report.markers) {
+            lines.push(`- ${marker.path}:${marker.line}:${marker.column} ${marker.marker}`);
+        }
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'mergeConflictScan.label.findings'));
+        for (const finding of report.findings) {
+            lines.push(`- ${finding.path}: ${finding.code} (${finding.message})`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'mergeConflictScan.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.markers.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'mergeConflictScan.clean'));
+    }
+    return lines.join('\n');
+}
+export function runRepoMergeConflictScanScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoMergeConflictScanHelp(lang));
+        return 0;
+    }
+    const options = parseRepoMergeConflictScanOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/merge-conflict-scan --help', getRepoMergeConflictScanHelp(lang), lang);
+        return 1;
+    }
+    const report = checkRepoMergeConflictScan(resolveMustflowRoot(), {
+        paths: options.paths,
+        maxFiles: options.maxFiles,
+        maxFileBytes: options.maxFileBytes,
+    });
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderRepoMergeConflictScanSummary(report, lang));
+    return report.ok ? 0 : 1;
+}

package/dist/cli/script-packs/repo-skill-route-audit.js

@@ -0,0 +1,86 @@
+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 { resolveMustflowRoot } from '../lib/project-root.js';
+import { auditSkillRoutes, SKILL_ROUTE_AUDIT_SCRIPT_REF, } from '../../core/skill-route-audit.js';
+const SKILL_ROUTE_AUDIT_OPTIONS = [{ name: '--json', kind: 'boolean' }];
+export function getRepoSkillRouteAuditHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/skill-route-audit audit [options]',
+        summary: t(lang, 'skillRouteAudit.help.summary'),
+        options: [
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/skill-route-audit audit',
+            'mf script-pack run repo/skill-route-audit audit --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'skillRouteAudit.help.exit.ok') },
+            { label: '1', description: t(lang, 'skillRouteAudit.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parseSkillRouteAuditOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, SKILL_ROUTE_AUDIT_OPTIONS, { allowPositionals: false });
+    const json = hasParsedCliOption(parsed, '--json');
+    if (action !== 'audit') {
+        return {
+            action: 'audit',
+            json,
+            error: action
+                ? t(lang, 'skillRouteAudit.error.unknownAction', { action })
+                : t(lang, 'skillRouteAudit.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, json, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    return { action, json };
+}
+function renderSkillRouteAuditSummary(report, lang) {
+    const lines = [
+        t(lang, 'skillRouteAudit.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${SKILL_ROUTE_AUDIT_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'skillRouteAudit.label.sourceSkills')}: ${report.counts.source_skills}`,
+        `${t(lang, 'skillRouteAudit.label.routeMetadata')}: ${report.counts.route_metadata}`,
+        `${t(lang, 'skillRouteAudit.label.indexRoutes')}: ${report.counts.index_routes}`,
+        `${t(lang, 'skillRouteAudit.label.templateSkills')}: ${report.counts.template_skills}`,
+        `${t(lang, 'skillRouteAudit.label.findings')}: ${report.findings.length}`,
+    ];
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'skillRouteAudit.label.findings'));
+        for (const finding of report.findings) {
+            const target = finding.skill ?? finding.route ?? finding.path;
+            lines.push(`- ${target}: ${finding.code} (${finding.message})`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'generatedBoundary.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.findings.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'skillRouteAudit.clean'));
+    }
+    return lines.join('\n');
+}
+export function runRepoSkillRouteAuditScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoSkillRouteAuditHelp(lang));
+        return 0;
+    }
+    const options = parseSkillRouteAuditOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/skill-route-audit --help', getRepoSkillRouteAuditHelp(lang), lang);
+        return 1;
+    }
+    const report = auditSkillRoutes(resolveMustflowRoot());
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderSkillRouteAuditSummary(report, lang));
+    return report.ok ? 0 : 1;
+}

package/dist/cli/script-packs/repo-version-source.js

@@ -0,0 +1,92 @@
+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 { resolveMustflowRoot } from '../lib/project-root.js';
+import { inspectRepoVersionSource, REPO_VERSION_SOURCE_SCRIPT_REF, } from '../../core/repo-version-source.js';
+const REPO_VERSION_SOURCE_OPTIONS = [{ name: '--json', kind: 'boolean' }];
+export function getRepoVersionSourceHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run repo/version-source inspect [options]',
+        summary: t(lang, 'versionSource.help.summary'),
+        options: [
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf script-pack run repo/version-source inspect',
+            'mf script-pack run repo/version-source inspect --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'versionSource.help.exit.ok') },
+            { label: '1', description: t(lang, 'versionSource.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parseRepoVersionSourceOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, REPO_VERSION_SOURCE_OPTIONS, { allowPositionals: false });
+    const json = hasParsedCliOption(parsed, '--json');
+    if (action !== 'inspect') {
+        return {
+            action: 'inspect',
+            json,
+            error: action
+                ? t(lang, 'versionSource.error.unknownAction', { action })
+                : t(lang, 'versionSource.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return { action, json, error: formatCliOptionParseError(parsed.error, lang) };
+    }
+    return { action, json };
+}
+function renderRepoVersionSourceSummary(report, lang) {
+    const authorityParts = [
+        `source ${report.counts.source_authority_sources}`,
+        `derived ${report.counts.derived_authority_sources}`,
+        `unclassified ${report.counts.unclassified_authority_sources}`,
+    ];
+    const lines = [
+        t(lang, 'versionSource.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${REPO_VERSION_SOURCE_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'versionSource.label.versioning')}: ${report.versioning_enabled ? t(lang, 'versionSources.value.enabled') : t(lang, 'versionSources.value.disabled')}`,
+        `${t(lang, 'versionSource.label.sources')}: ${report.counts.sources}`,
+        `${t(lang, 'versionSource.label.sourceAuthorities')}: ${authorityParts.join(', ')}`,
+    ];
+    for (const source of report.sources) {
+        const metadata = [source.kind, source.declared ? 'declared' : undefined, source.authority].filter(Boolean).join(', ');
+        lines.push(`- ${source.path} (${metadata})`);
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'versionSource.label.findings'));
+        for (const finding of report.findings) {
+            lines.push(`- ${finding.path}: ${finding.code} (${finding.message})`);
+        }
+    }
+    if (report.issues.length > 0) {
+        lines.push(t(lang, 'versionSource.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.sources.length === 0 && report.findings.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'versionSources.noSources'));
+    }
+    return lines.join('\n');
+}
+export function runRepoVersionSourceScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getRepoVersionSourceHelp(lang));
+        return 0;
+    }
+    const options = parseRepoVersionSourceOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run repo/version-source --help', getRepoVersionSourceHelp(lang), lang);
+        return 1;
+    }
+    const report = inspectRepoVersionSource(resolveMustflowRoot());
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderRepoVersionSourceSummary(report, lang));
+    return report.ok ? 0 : 1;
+}