mustflow 2.75.1 → 2.84.0

package/dist/cli/i18n/zh.js

@@ -585,6 +585,7 @@ export const zhMessages = {
     "docs.help.summary": "跟踪由 LLM 创建或修改后需要文字审阅的文档。",
     "docs.help.option.all": "包含已批准和已忽略的文档",
     "docs.help.option.status": "按审阅状态过滤",
+    "docs.help.option.changed": "从 git status 添加所有已更改的文档审阅候选项",
     "docs.help.option.reason": "记录文档需要审阅的原因",
     "docs.help.option.origin": "记录审阅来源，例如 llm_modified",
     "docs.help.option.actorKind": "记录谁修改了文档：human、llm、tool 或 external",
@@ -600,6 +601,8 @@ export const zhMessages = {
     "docs.review.empty": "没有需要审阅的文档。",
     "docs.review.wrote": "写入",
     "docs.review.added": "已添加",
+    "docs.review.changed.none": "没有已更改的文档需要审阅。",
+    "docs.review.changed.added": "已添加更改文档：{count}",
     "docs.review.commented": "已添加评论",
     "docs.review.marked.approved": "已批准",
     "docs.review.marked.needs_human": "已标记为 needs_human",
@@ -612,6 +615,9 @@ export const zhMessages = {
     "docs.error.emptyComment": "审核评论不能为空",
     "docs.error.commentSourceConflict": "只能使用 --comment 或 --comment-file 其中一个",
     "docs.error.commentFileIsDocument": "--comment-file 不能指向正在审核的文档",
+    "docs.error.changedPathConflict": "使用 --changed 时不要提供文档路径",
+    "docs.error.changedCommentConflict": "使用 --changed 时不要提供 --comment 或 --comment-file",
+    "docs.error.changedFilesUnavailable": "无法通过 git status 检查更改文件：{message}",
     "docs.error.invalidStatus": "无效审阅状态。请使用：{statuses}",
     "docs.error.invalidReviewerKind": "无效审阅者类型。请使用：{kinds}",
     "docs.error.missingReviewerKind": "缺少 --reviewer-kind。请使用：{kinds}",
@@ -765,11 +771,17 @@ export const zhMessages = {
     "scriptPack.suggest.empty": "No script-pack suggestions matched the supplied paths, skills, or phases.",
     "scriptPack.pack.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in utility scripts",
+    "scriptPack.pack.docs.summary": "Documentation reference utility scripts",
     "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
     "scriptPack.script.codeOutline.summary": "Scan TypeScript and JavaScript files for symbol headers and line ranges",
-    "scriptPack.script.codeSymbolRead.summary": "Read a bounded source snippet by symbol line or explicit line range",
+    "scriptPack.script.codeSymbolRead.summary": "Read a bounded source snippet by source anchor, symbol line, or explicit line range",
+    "scriptPack.script.codeRouteOutline.summary": "Scan Hono, Elysia, Axum, and NestJS route methods, paths, handlers, and lifecycle chains",
+    "scriptPack.script.codeExportDiff.summary": "Compare exported source signatures and return metadata across git refs",
     "scriptPack.script.textBudget.summary": "Check exact text length budgets for files or JSON string fields",
+    "scriptPack.script.referenceDrift.summary": "Check documented command, script-pack, schema, and path references for drift",
+    "scriptPack.script.configChain.summary": "Inspect nearby config files and static config inheritance",
     "scriptPack.script.generatedBoundary.summary": "Check whether candidate paths cross generated, ignored, protected, vendor, or cache boundaries",
+    "scriptPack.script.relatedFiles.summary": "Map likely related files for source-oriented repository navigation",
     "scriptPack.label.script": "Script",
     "scriptPack.label.actions": "actions",
     "scriptPack.label.schema": "schema",
@@ -796,7 +808,8 @@ export const zhMessages = {
     "codeOutline.error.missingPath": "Provide at least one source file or directory to scan",
     "codeOutline.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
     "codeOutline.error.invalidNonNegativeInteger": "{option} must be a non-negative safe integer: {value}",
-    "codeSymbolRead.help.summary": "Read a bounded TypeScript or JavaScript source snippet from a symbol line or explicit line range.",
+    "codeSymbolRead.help.summary": "Read a bounded TypeScript or JavaScript source snippet from a source anchor, symbol line, or explicit line range.",
+    "codeSymbolRead.help.option.anchor": "Source anchor id to resolve to its target symbol",
     "codeSymbolRead.help.option.startLine": "1-based source line to resolve to a symbol or range",
     "codeSymbolRead.help.option.endLine": "Optional explicit 1-based end line; when omitted, the containing outline symbol is read",
     "codeSymbolRead.help.option.contextLines": "Number of surrounding context lines to include. Default: 0",
@@ -813,6 +826,56 @@ export const zhMessages = {
     "codeSymbolRead.error.missingPath": "Provide exactly one source file to read",
     "codeSymbolRead.error.tooManyPaths": "Provide only one source file to read",
     "codeSymbolRead.error.missingStartLine": "Provide --start-line <line>",
+    "codeSymbolRead.error.anchorConflict": "Use either --anchor <id> or <path> with --start-line/--end-line, not both",
+    "codeRouteOutline.help.summary": "Scan Hono, Elysia, Axum, and NestJS route source files for method, path, handler, lifecycle, and line metadata.",
+    "codeRouteOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeRouteOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeRouteOutline.help.exit.ok": "The route outline was scanned without findings",
+    "codeRouteOutline.help.exit.fail": "The route outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeRouteOutline.title": "mustflow route outline",
+    "codeRouteOutline.label.files": "Files",
+    "codeRouteOutline.label.routes": "Routes",
+    "codeRouteOutline.label.findings": "Findings",
+    "codeRouteOutline.label.outline": "Route outline",
+    "codeRouteOutline.label.issues": "Issues",
+    "codeRouteOutline.clean": "No Hono, Elysia, Axum, or NestJS routes were found.",
+    "codeRouteOutline.error.missingAction": "Specify a route-outline action: scan",
+    "codeRouteOutline.error.unknownAction": "Unknown route-outline action: {action}",
+    "codeRouteOutline.error.missingPath": "Provide at least one source file or directory to scan",
+    "codeRouteOutline.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
+    "exportDiff.help.summary": "Compare exported TS/JS signatures, return metadata, and package surface hints across a git base and head.",
+    "exportDiff.help.option.base": "Git base ref to compare from. Default: HEAD",
+    "exportDiff.help.option.head": "Git head ref to compare to. Omit to compare the base with the working tree.",
+    "exportDiff.help.option.maxFiles": "Maximum number of changed source files to inspect. Default: 100",
+    "exportDiff.help.option.maxFileBytes": "Maximum bytes to read from each source file snapshot. Default: 1048576",
+    "exportDiff.help.exit.ok": "The export diff completed without input errors",
+    "exportDiff.help.exit.fail": "The export diff could not read git input or exceeded configured limits",
+    "exportDiff.title": "mustflow export diff",
+    "exportDiff.label.files": "Files",
+    "exportDiff.label.added": "Added",
+    "exportDiff.label.removed": "Removed",
+    "exportDiff.label.changed": "Changed",
+    "exportDiff.label.exports": "Exports",
+    "exportDiff.label.findings": "Findings",
+    "exportDiff.label.issues": "Issues",
+    "exportDiff.clean": "No exported TypeScript or JavaScript declaration changes were found.",
+    "exportDiff.error.missingAction": "Specify an export-diff action: compare",
+    "exportDiff.error.unknownAction": "Unknown export-diff action: {action}",
+    "exportDiff.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
+    "referenceDrift.help.summary": "Check documentation references against current mf commands, script-pack refs, schema files, and repository paths.",
+    "referenceDrift.help.option.maxFiles": "Maximum number of document files to inspect. Default: 200",
+    "referenceDrift.help.option.maxFileBytes": "Maximum bytes to read from each document file. Default: 524288",
+    "referenceDrift.help.exit.ok": "All checked documentation references resolved against current repository surfaces",
+    "referenceDrift.help.exit.fail": "A documentation reference was stale, missing, unknown, unreadable, or over a configured limit",
+    "referenceDrift.title": "mustflow reference drift",
+    "referenceDrift.label.files": "Files",
+    "referenceDrift.label.references": "References",
+    "referenceDrift.label.findings": "Findings",
+    "referenceDrift.label.issues": "Issues",
+    "referenceDrift.clean": "No documentation references were found.",
+    "referenceDrift.error.missingAction": "Specify a reference-drift action: check",
+    "referenceDrift.error.unknownAction": "Unknown reference-drift action: {action}",
+    "referenceDrift.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
     "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",
@@ -849,6 +912,42 @@ export const zhMessages = {
     "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",
+    "relatedFiles.help.summary": "Map direct imports, importers, sibling files, and nearby config boundaries for source-oriented repository navigation.",
+    "relatedFiles.help.option.maxFiles": "Maximum number of source or related files to scan. Default: 1000",
+    "relatedFiles.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 262144",
+    "relatedFiles.help.option.maxCandidates": "Maximum number of related-file candidates to report. Default: 200",
+    "relatedFiles.help.exit.ok": "The related-file map completed without input or scan-limit findings",
+    "relatedFiles.help.exit.fail": "The related-file map found invalid input, unreadable paths, or scan limits",
+    "relatedFiles.title": "mustflow related files",
+    "relatedFiles.label.targets": "Targets",
+    "relatedFiles.label.candidates": "Candidates",
+    "relatedFiles.label.truncated": "Truncated",
+    "relatedFiles.label.related": "Related files",
+    "relatedFiles.label.confidence": "confidence",
+    "relatedFiles.label.findings": "Findings",
+    "relatedFiles.label.issues": "Issues",
+    "relatedFiles.clean": "No related-file candidates were found.",
+    "relatedFiles.error.missingAction": "Specify a related-files action: map",
+    "relatedFiles.error.unknownAction": "Unknown related-files action: {action}",
+    "relatedFiles.error.missingPath": "Provide at least one path to map",
+    "relatedFiles.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
+    "configChain.help.summary": "Inspect nearby config files, static inheritance, workspace hints, and dynamic config boundaries.",
+    "configChain.help.option.maxConfigs": "Maximum number of config files to inspect. Default: 120",
+    "configChain.help.option.maxFileBytes": "Maximum bytes to read from each config file. Default: 262144",
+    "configChain.help.exit.ok": "The config chain was inspected without blocking findings",
+    "configChain.help.exit.fail": "The config chain found invalid input, unreadable files, parse errors, or scan limits",
+    "configChain.title": "mustflow config chain",
+    "configChain.label.targets": "Targets",
+    "configChain.label.configs": "Configs",
+    "configChain.label.edges": "Edges",
+    "configChain.label.findings": "Findings",
+    "configChain.label.dynamic": "dynamic",
+    "configChain.label.issues": "Issues",
+    "configChain.clean": "No nearby config files were found.",
+    "configChain.error.missingAction": "Specify a config-chain action: inspect",
+    "configChain.error.unknownAction": "Unknown config-chain action: {action}",
+    "configChain.error.missingPath": "Provide at least one path to inspect",
+    "configChain.error.invalidPositiveInteger": "{option} must be a positive safe integer: {value}",
     "run.help.summary": "从 .mustflow/config/commands.toml 运行已配置的一次性命令。",
     "run.help.option.dryRun": "输出命令计划但不执行",
     "run.help.option.planOnly": "--dry-run 的别名",

package/dist/cli/lib/script-pack-registry.js

@@ -14,15 +14,16 @@ export const SCRIPT_PACKS = [
                 summaryKey: 'scriptPack.script.codeOutline.summary',
                 actions: ['scan'],
                 useWhen: [
-                    'Scan TypeScript or JavaScript files for symbol headers before reading large source files chunk by chunk.',
-                    'Build a bounded source outline with file paths, line ranges, signatures, export flags, and content hashes for codebase orientation.',
+                    'Scan supported source files for symbol headers and source anchors before reading large files chunk by chunk.',
+                    'Build a bounded source outline with file paths, language metadata, line ranges, signatures, ' +
+                        'export flags, source-anchor metadata, and content hashes for codebase orientation.',
                 ],
                 phases: ['before_change', 'during_change', 'review'],
                 readOnly: true,
                 mutates: false,
                 network: false,
                 inputs: ['path', 'max_files', 'max_file_bytes'],
-                outputs: ['human_summary', 'json_report', 'symbol_outline'],
+                outputs: ['human_summary', 'json_report', 'symbol_outline', 'source_anchors'],
                 relatedSkills: [
                     'codebase-orientation',
                     'javascript-code-change',
@@ -39,18 +40,18 @@ export const SCRIPT_PACKS = [
                 packId: 'code',
                 id: 'symbol-read',
                 ref: scriptRef('code', 'symbol-read'),
-                usage: 'mf script-pack run code/symbol-read read <path> --start-line <line> [options]',
+                usage: 'mf script-pack run code/symbol-read read (<path> --start-line <line> | --anchor <id>) [options]',
                 summaryKey: 'scriptPack.script.codeSymbolRead.summary',
                 actions: ['read'],
                 useWhen: [
-                    'Read only the resolved symbol range or an explicit bounded line range after a code outline identifies the relevant line.',
-                    'Fetch a focused source snippet with path, line, symbol, and content-hash metadata instead of repeatedly paging through a whole file.',
+                    'Read only the resolved symbol range, source-anchor target, or explicit bounded line range after a code outline identifies the relevant location.',
+                    'Fetch a focused source snippet with path, anchor, line, symbol, and content-hash metadata instead of repeatedly paging through a whole file.',
                 ],
                 phases: ['before_change', 'during_change', 'review'],
                 readOnly: true,
                 mutates: false,
                 network: false,
-                inputs: ['path', 'start_line', 'end_line', 'context_lines', 'max_file_bytes', 'max_snippet_lines'],
+                inputs: ['path', 'anchor_id', 'start_line', 'end_line', 'context_lines', 'max_file_bytes', 'max_snippet_lines'],
                 outputs: ['human_summary', 'json_report', 'source_snippet'],
                 relatedSkills: [
                     'codebase-orientation',
@@ -64,6 +65,66 @@ export const SCRIPT_PACKS = [
                 reportSchemaFile: 'code-symbol-read-report.schema.json',
                 loadRunner: async () => (await import('../script-packs/code-outline.js')).runCodeSymbolReadScript,
             },
+            {
+                packId: 'code',
+                id: 'route-outline',
+                ref: scriptRef('code', 'route-outline'),
+                usage: 'mf script-pack run code/route-outline scan <path...> [options]',
+                summaryKey: 'scriptPack.script.codeRouteOutline.summary',
+                actions: ['scan'],
+                useWhen: [
+                    'Scan Hono, Elysia, Axum, and NestJS route source files for method, path, framework, lifecycle, handler, and line metadata before reading whole modules.',
+                    'Build a bounded first-pass route outline with paths, line ranges, lifecycle calls, and content hashes for HTTP route orientation.',
+                ],
+                phases: ['before_change', 'during_change', 'after_change', 'review'],
+                readOnly: true,
+                mutates: false,
+                network: false,
+                inputs: ['path', 'max_files', 'max_file_bytes'],
+                outputs: ['human_summary', 'json_report', 'route_outline', 'route_lifecycle'],
+                relatedSkills: [
+                    'api-contract-change',
+                    'backend-reliability-change',
+                    'axum-code-change',
+                    'elysia-code-change',
+                    'hono-code-change',
+                    'nestjs-code-change',
+                    'http-delivery-streaming',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'route-outline-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/code-route-outline.js')).runCodeRouteOutlineScript,
+            },
+            {
+                packId: 'code',
+                id: 'export-diff',
+                ref: scriptRef('code', 'export-diff'),
+                usage: 'mf script-pack run code/export-diff compare [path...] [options]',
+                summaryKey: 'scriptPack.script.codeExportDiff.summary',
+                actions: ['compare'],
+                useWhen: [
+                    'Compare exported TypeScript and JavaScript declaration signatures, return metadata, and package surface hints across a git base and head.',
+                    'Review public-ish API changes after source edits without reading every changed file from top to bottom.',
+                ],
+                phases: ['after_change', 'review'],
+                readOnly: true,
+                mutates: false,
+                network: false,
+                inputs: ['base_ref', 'head_ref', 'path', 'max_files', 'max_file_bytes'],
+                outputs: ['human_summary', 'json_report', 'export_diff', 'return_type_changes', 'package_surface'],
+                relatedSkills: [
+                    'api-contract-change',
+                    'dependency-upgrade-review',
+                    'javascript-code-change',
+                    'public-json-contract-change',
+                    'typescript-code-change',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'export-diff-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/code-export-diff.js')).runCodeExportDiffScript,
+            },
         ],
     },
     {
@@ -100,10 +161,74 @@ export const SCRIPT_PACKS = [
             },
         ],
     },
+    {
+        id: 'docs',
+        summaryKey: 'scriptPack.pack.docs.summary',
+        scripts: [
+            {
+                packId: 'docs',
+                id: 'reference-drift',
+                ref: scriptRef('docs', 'reference-drift'),
+                usage: 'mf script-pack run docs/reference-drift check [path...] [options]',
+                summaryKey: 'scriptPack.script.referenceDrift.summary',
+                actions: ['check'],
+                useWhen: [
+                    'Check documentation references to mf commands, script-pack refs, schema files, and repository paths against current local surfaces.',
+                    'Review docs after CLI, schema, script-pack, or repository structure changes before claiming references are synchronized.',
+                ],
+                phases: ['after_change', 'review'],
+                readOnly: true,
+                mutates: false,
+                network: false,
+                inputs: ['path', 'max_files', 'max_file_bytes'],
+                outputs: ['human_summary', 'json_report', 'reference_drift', 'stale_reference_findings'],
+                relatedSkills: [
+                    'cli-output-contract-review',
+                    'docs-prose-review',
+                    'public-json-contract-change',
+                    'readme-authoring',
+                    'release-notes-authoring',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'reference-drift-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/docs-reference-drift.js')).runDocsReferenceDriftScript,
+            },
+        ],
+    },
     {
         id: 'repo',
         summaryKey: 'scriptPack.pack.repo.summary',
         scripts: [
+            {
+                packId: 'repo',
+                id: 'config-chain',
+                ref: scriptRef('repo', 'config-chain'),
+                usage: 'mf script-pack run repo/config-chain inspect <path...> [options]',
+                summaryKey: 'scriptPack.script.configChain.summary',
+                actions: ['inspect'],
+                useWhen: [
+                    'Inspect nearby tsconfig, package, ESLint, Prettier, Vite, Vitest, Tailwind, Jest, and Playwright config files before assuming effective rules.',
+                    'Build a read-only config chain with extends, references, workspaces, dynamic-config findings, and source path context.',
+                ],
+                phases: ['before_change', 'during_change', 'after_change', 'review'],
+                readOnly: true,
+                mutates: false,
+                network: false,
+                inputs: ['path', 'max_configs', 'max_file_bytes'],
+                outputs: ['human_summary', 'json_report', 'config_chain', 'config_edges'],
+                relatedSkills: [
+                    'bun-code-change',
+                    'config-env-change',
+                    'dependency-reality-check',
+                    'tailwind-code-change',
+                    'typescript-code-change',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'config-chain-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/repo-config-chain.js')).runRepoConfigChainScript,
+            },
             {
                 packId: 'repo',
                 id: 'generated-boundary',
@@ -133,6 +258,36 @@ export const SCRIPT_PACKS = [
                 reportSchemaFile: 'generated-boundary-report.schema.json',
                 loadRunner: async () => (await import('../script-packs/repo-generated-boundary.js')).runRepoGeneratedBoundaryScript,
             },
+            {
+                packId: 'repo',
+                id: 'related-files',
+                ref: scriptRef('repo', 'related-files'),
+                usage: 'mf script-pack run repo/related-files map <path...> [options]',
+                summaryKey: 'scriptPack.script.relatedFiles.summary',
+                actions: ['map'],
+                useWhen: [
+                    'Map direct imports, importers, sibling tests, sibling docs, sibling styles, type siblings, ' +
+                        'and nearby config files for a source path before widening context reads.',
+                    'Review likely adjacent files after a partial implementation without treating the result as verification scope or completeness proof.',
+                ],
+                phases: ['before_change', 'during_change', 'after_change', 'review'],
+                readOnly: true,
+                mutates: false,
+                network: false,
+                inputs: ['path', 'max_files', 'max_file_bytes', 'max_candidates'],
+                outputs: ['human_summary', 'json_report', 'related_file_candidates'],
+                relatedSkills: [
+                    'codebase-orientation',
+                    'heuristic-candidate-selection',
+                    'module-boundary-review',
+                    'typescript-code-change',
+                    'javascript-code-change',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'related-files-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/repo-related-files.js')).runRepoRelatedFilesScript,
+            },
         ],
     },
 ];

package/dist/cli/script-packs/code-export-diff.js

@@ -0,0 +1,160 @@
+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 { CODE_EXPORT_DIFF_SCRIPT_REF, inspectExportDiff, } from '../../core/export-diff.js';
+const EXPORT_DIFF_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--base', kind: 'string' },
+    { name: '--head', kind: 'string' },
+    { name: '--max-files', kind: 'string' },
+    { name: '--max-file-bytes', kind: 'string' },
+];
+function parsePositiveInteger(value, option, lang) {
+    if (value === null) {
+        return { value: null };
+    }
+    if (!/^[1-9]\d*$/u.test(value)) {
+        return { value: null, error: t(lang, 'exportDiff.error.invalidPositiveInteger', { option, value }) };
+    }
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed)) {
+        return { value: null, error: t(lang, 'exportDiff.error.invalidPositiveInteger', { option, value }) };
+    }
+    return { value: parsed };
+}
+export function getCodeExportDiffHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf script-pack run code/export-diff compare [path...] [options]',
+        summary: t(lang, 'exportDiff.help.summary'),
+        options: [
+            { label: '--base <ref>', description: t(lang, 'exportDiff.help.option.base') },
+            { label: '--head <ref>', description: t(lang, 'exportDiff.help.option.head') },
+            { label: '--max-files <count>', description: t(lang, 'exportDiff.help.option.maxFiles') },
+            { label: '--max-file-bytes <bytes>', description: t(lang, 'exportDiff.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 code/export-diff compare --base HEAD --json',
+            'mf script-pack run code/export-diff compare src --base HEAD~1 --head HEAD --json',
+            'mf script-pack run code/export-diff compare src/index.ts --max-files 20 --json',
+        ],
+        exitCodes: [
+            { label: '0', description: t(lang, 'exportDiff.help.exit.ok') },
+            { label: '1', description: t(lang, 'exportDiff.help.exit.fail') },
+        ],
+    }, lang);
+}
+function parseExportDiffOptions(args, lang) {
+    const [action, ...rest] = args;
+    const parsed = parseCliOptions(rest, EXPORT_DIFF_OPTIONS, { allowPositionals: true });
+    const json = hasParsedCliOption(parsed, '--json');
+    const baseRef = getParsedCliStringOption(parsed, '--base');
+    const headRef = getParsedCliStringOption(parsed, '--head');
+    const maxFiles = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-files'), '--max-files', lang);
+    const maxFileBytes = parsePositiveInteger(getParsedCliStringOption(parsed, '--max-file-bytes'), '--max-file-bytes', lang);
+    if (action !== 'compare') {
+        return {
+            action: 'compare',
+            json,
+            baseRef,
+            headRef,
+            paths: parsed.positionals,
+            maxFiles: maxFiles.value,
+            maxFileBytes: maxFileBytes.value,
+            error: action ? t(lang, 'exportDiff.error.unknownAction', { action }) : t(lang, 'exportDiff.error.missingAction'),
+        };
+    }
+    if (parsed.error) {
+        return {
+            action,
+            json,
+            baseRef,
+            headRef,
+            paths: parsed.positionals,
+            maxFiles: maxFiles.value,
+            maxFileBytes: maxFileBytes.value,
+            error: formatCliOptionParseError(parsed.error, lang),
+        };
+    }
+    for (const candidate of [maxFiles, maxFileBytes]) {
+        if (candidate.error) {
+            return {
+                action,
+                json,
+                baseRef,
+                headRef,
+                paths: parsed.positionals,
+                maxFiles: maxFiles.value,
+                maxFileBytes: maxFileBytes.value,
+                error: candidate.error,
+            };
+        }
+    }
+    return {
+        action,
+        json,
+        baseRef,
+        headRef,
+        paths: parsed.positionals,
+        maxFiles: maxFiles.value,
+        maxFileBytes: maxFileBytes.value,
+    };
+}
+function renderExportDiffSummary(report, lang) {
+    const lines = [
+        t(lang, 'exportDiff.title'),
+        `${t(lang, 'scriptPack.label.script')}: ${CODE_EXPORT_DIFF_SCRIPT_REF}`,
+        `${t(lang, 'label.status')}: ${report.status}`,
+        `${t(lang, 'exportDiff.label.files')}: ${report.summary.files_changed}`,
+        `${t(lang, 'exportDiff.label.added')}: ${report.summary.added}`,
+        `${t(lang, 'exportDiff.label.removed')}: ${report.summary.removed}`,
+        `${t(lang, 'exportDiff.label.changed')}: ${report.summary.changed}`,
+    ];
+    if (report.exports.length > 0) {
+        lines.push(t(lang, 'exportDiff.label.exports'));
+        for (const entry of report.exports.filter((candidate) => candidate.change !== 'unchanged')) {
+            const beforeReturn = entry.before?.return_type ?? t(lang, 'value.none');
+            const afterReturn = entry.after?.return_type ?? t(lang, 'value.none');
+            lines.push(`- ${entry.path}: ${entry.change} ${entry.kind} ${entry.name} (${entry.compatibility}, ${beforeReturn} -> ${afterReturn})`);
+        }
+    }
+    if (report.findings.length > 0) {
+        lines.push(t(lang, 'exportDiff.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, 'exportDiff.label.issues'), ...report.issues.map((issue) => `- ${issue}`));
+    }
+    if (report.exports.length === 0 && report.findings.length === 0 && report.issues.length === 0) {
+        lines.push(t(lang, 'exportDiff.clean'));
+    }
+    return lines.join('\n');
+}
+export function runCodeExportDiffScript(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getCodeExportDiffHelp(lang));
+        return 0;
+    }
+    const options = parseExportDiffOptions(args, lang);
+    if (options.error) {
+        printUsageError(reporter, options.error, 'mf script-pack run code/export-diff --help', getCodeExportDiffHelp(lang), lang);
+        return 1;
+    }
+    const report = inspectExportDiff(resolveMustflowRoot(), {
+        baseRef: options.baseRef ?? undefined,
+        headRef: options.headRef,
+        paths: options.paths,
+        maxFiles: options.maxFiles ?? undefined,
+        maxFileBytes: options.maxFileBytes ?? undefined,
+    });
+    if (options.json) {
+        reporter.stdout(JSON.stringify(report, null, 2));
+        return report.ok ? 0 : 1;
+    }
+    reporter.stdout(renderExportDiffSummary(report, lang));
+    return report.ok ? 0 : 1;
+}