mustflow 2.74.7 → 2.75.1

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

@@ -61,6 +61,8 @@ export function getScriptPackHelp(lang = 'en') {
             '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 code/outline scan src --json',
+            'mf script-pack run code/symbol-read read src/cli/index.ts --start-line 25 --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',

package/dist/cli/i18n/en.js

@@ -763,8 +763,11 @@ Read these files before working:
     "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.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in 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.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",
@@ -776,6 +779,40 @@ Read these files before working:
     "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}",
+    "codeOutline.help.summary": "Scan TypeScript and JavaScript source files for declaration headers, line ranges, export flags, and content hashes.",
+    "codeOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeOutline.help.exit.ok": "The code outline was scanned without findings",
+    "codeOutline.help.exit.fail": "The code outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline completed without findings.",
+    "codeOutline.error.missingAction": "Specify a code-outline action: scan",
+    "codeOutline.error.unknownAction": "Unknown code-outline action: {action}",
+    "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.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",
+    "codeSymbolRead.help.option.maxSnippetLines": "Maximum snippet lines to print. Default: 250",
+    "codeSymbolRead.help.exit.ok": "The requested source snippet was read",
+    "codeSymbolRead.help.exit.fail": "The snippet request was invalid, unreadable, unsupported, or too large",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "Specify a code-symbol-read action: read",
+    "codeSymbolRead.error.unknownAction": "Unknown code-symbol-read action: {action}",
+    "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>",
     "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",

package/dist/cli/i18n/es.js

@@ -763,8 +763,11 @@ Lee estos archivos antes de trabajar:
     "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.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in 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.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",
@@ -776,6 +779,40 @@ Lee estos archivos antes de trabajar:
     "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}",
+    "codeOutline.help.summary": "Scan TypeScript and JavaScript source files for declaration headers, line ranges, export flags, and content hashes.",
+    "codeOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeOutline.help.exit.ok": "The code outline was scanned without findings",
+    "codeOutline.help.exit.fail": "The code outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline completed without findings.",
+    "codeOutline.error.missingAction": "Specify a code-outline action: scan",
+    "codeOutline.error.unknownAction": "Unknown code-outline action: {action}",
+    "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.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",
+    "codeSymbolRead.help.option.maxSnippetLines": "Maximum snippet lines to print. Default: 250",
+    "codeSymbolRead.help.exit.ok": "The requested source snippet was read",
+    "codeSymbolRead.help.exit.fail": "The snippet request was invalid, unreadable, unsupported, or too large",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "Specify a code-symbol-read action: read",
+    "codeSymbolRead.error.unknownAction": "Unknown code-symbol-read action: {action}",
+    "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>",
     "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",

package/dist/cli/i18n/fr.js

@@ -763,8 +763,11 @@ Lisez ces fichiers avant de travailler :
     "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.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in 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.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",
@@ -776,6 +779,40 @@ Lisez ces fichiers avant de travailler :
     "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}",
+    "codeOutline.help.summary": "Scan TypeScript and JavaScript source files for declaration headers, line ranges, export flags, and content hashes.",
+    "codeOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeOutline.help.exit.ok": "The code outline was scanned without findings",
+    "codeOutline.help.exit.fail": "The code outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline completed without findings.",
+    "codeOutline.error.missingAction": "Specify a code-outline action: scan",
+    "codeOutline.error.unknownAction": "Unknown code-outline action: {action}",
+    "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.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",
+    "codeSymbolRead.help.option.maxSnippetLines": "Maximum snippet lines to print. Default: 250",
+    "codeSymbolRead.help.exit.ok": "The requested source snippet was read",
+    "codeSymbolRead.help.exit.fail": "The snippet request was invalid, unreadable, unsupported, or too large",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "Specify a code-symbol-read action: read",
+    "codeSymbolRead.error.unknownAction": "Unknown code-symbol-read action: {action}",
+    "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>",
     "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",

package/dist/cli/i18n/hi.js

@@ -763,8 +763,11 @@ export const hiMessages = {
     "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.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in 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.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",
@@ -776,6 +779,40 @@ export const hiMessages = {
     "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}",
+    "codeOutline.help.summary": "Scan TypeScript and JavaScript source files for declaration headers, line ranges, export flags, and content hashes.",
+    "codeOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeOutline.help.exit.ok": "The code outline was scanned without findings",
+    "codeOutline.help.exit.fail": "The code outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline completed without findings.",
+    "codeOutline.error.missingAction": "Specify a code-outline action: scan",
+    "codeOutline.error.unknownAction": "Unknown code-outline action: {action}",
+    "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.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",
+    "codeSymbolRead.help.option.maxSnippetLines": "Maximum snippet lines to print. Default: 250",
+    "codeSymbolRead.help.exit.ok": "The requested source snippet was read",
+    "codeSymbolRead.help.exit.fail": "The snippet request was invalid, unreadable, unsupported, or too large",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "Specify a code-symbol-read action: read",
+    "codeSymbolRead.error.unknownAction": "Unknown code-symbol-read action: {action}",
+    "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>",
     "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",

package/dist/cli/i18n/ko.js

@@ -763,8 +763,11 @@ export const koMessages = {
     "scriptPack.suggest.label.recommendations": "추천 항목",
     "scriptPack.suggest.label.runHint": "실행 힌트",
     "scriptPack.suggest.empty": "제공된 경로, skill, phase에 맞는 script-pack 추천이 없습니다.",
+    "scriptPack.pack.code.summary": "소스 코드 탐색 utility script",
     "scriptPack.pack.core.summary": "핵심 내장 utility script",
     "scriptPack.pack.repo.summary": "Repository-boundary utility scripts",
+    "scriptPack.script.codeOutline.summary": "TypeScript와 JavaScript 파일에서 symbol header와 라인 범위를 스캔합니다",
+    "scriptPack.script.codeSymbolRead.summary": "symbol 라인이나 명시 라인 범위로 제한된 소스 snippet을 읽습니다",
     "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",
@@ -776,6 +779,40 @@ export const koMessages = {
     "scriptPack.error.unknownScript": "알 수 없는 script-pack script: {script}",
     "scriptPack.error.missingSuggestInput": "추천 입력을 하나 이상 제공하세요: --path <path>, --changed, --phase <phase>, 또는 --skill <skill>",
     "scriptPack.error.unknownPhase": "알 수 없는 script-pack phase: {phase}",
+    "codeOutline.help.summary": "TypeScript와 JavaScript 소스 파일에서 declaration header, 라인 범위, export flag, content hash를 스캔합니다.",
+    "codeOutline.help.option.maxFiles": "스캔할 최대 소스 파일 수입니다. 기본값: 200",
+    "codeOutline.help.option.maxFileBytes": "각 소스 파일에서 읽을 최대 바이트입니다. 기본값: 1048576",
+    "codeOutline.help.exit.ok": "code outline을 finding 없이 스캔했습니다",
+    "codeOutline.help.exit.fail": "code outline에서 잘못된 입력, 읽을 수 없는 파일, 미지원 파일, 또는 스캔 제한이 발견되었습니다",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline이 finding 없이 완료되었습니다.",
+    "codeOutline.error.missingAction": "code-outline action을 지정하세요: scan",
+    "codeOutline.error.unknownAction": "알 수 없는 code-outline action: {action}",
+    "codeOutline.error.missingPath": "스캔할 소스 파일이나 디렉터리를 하나 이상 제공하세요",
+    "codeOutline.error.invalidPositiveInteger": "{option}은 양의 safe integer여야 합니다: {value}",
+    "codeOutline.error.invalidNonNegativeInteger": "{option}은 0 이상의 safe integer여야 합니다: {value}",
+    "codeSymbolRead.help.summary": "symbol 라인이나 명시 라인 범위에서 제한된 TypeScript 또는 JavaScript source snippet을 읽습니다.",
+    "codeSymbolRead.help.option.startLine": "symbol 또는 범위로 해석할 1-based source line입니다",
+    "codeSymbolRead.help.option.endLine": "선택적 1-based end line입니다. 생략하면 포함하는 outline symbol을 읽습니다",
+    "codeSymbolRead.help.option.contextLines": "포함할 주변 context line 수입니다. 기본값: 0",
+    "codeSymbolRead.help.option.maxSnippetLines": "출력할 최대 snippet line 수입니다. 기본값: 250",
+    "codeSymbolRead.help.exit.ok": "요청한 source snippet을 읽었습니다",
+    "codeSymbolRead.help.exit.fail": "snippet 요청이 잘못되었거나, 읽을 수 없거나, 미지원이거나, 너무 큽니다",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "code-symbol-read action을 지정하세요: read",
+    "codeSymbolRead.error.unknownAction": "알 수 없는 code-symbol-read action: {action}",
+    "codeSymbolRead.error.missingPath": "읽을 소스 파일을 정확히 하나 제공하세요",
+    "codeSymbolRead.error.tooManyPaths": "읽을 소스 파일은 하나만 제공하세요",
+    "codeSymbolRead.error.missingStartLine": "--start-line <line>을 제공하세요",
     "textBudget.help.summary": "파일이나 JSON 문자열 필드의 정확한 텍스트 길이 예산을 검사합니다. 기본 단위는 grapheme입니다.",
     "textBudget.help.option.min": "최소 단위 수를 요구합니다",
     "textBudget.help.option.max": "최대 단위 수를 요구합니다",

package/dist/cli/i18n/zh.js

@@ -763,8 +763,11 @@ export const zhMessages = {
     "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.code.summary": "Source-code orientation utility scripts",
     "scriptPack.pack.core.summary": "Core built-in 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.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",
@@ -776,6 +779,40 @@ export const zhMessages = {
     "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}",
+    "codeOutline.help.summary": "Scan TypeScript and JavaScript source files for declaration headers, line ranges, export flags, and content hashes.",
+    "codeOutline.help.option.maxFiles": "Maximum number of source files to scan. Default: 200",
+    "codeOutline.help.option.maxFileBytes": "Maximum bytes to read from each source file. Default: 1048576",
+    "codeOutline.help.exit.ok": "The code outline was scanned without findings",
+    "codeOutline.help.exit.fail": "The code outline found invalid input, unreadable files, unsupported files, or scan limits",
+    "codeOutline.title": "mustflow code outline",
+    "codeOutline.label.files": "Files",
+    "codeOutline.label.symbols": "Symbols",
+    "codeOutline.label.findings": "Findings",
+    "codeOutline.label.outline": "Outline",
+    "codeOutline.label.issues": "Issues",
+    "codeOutline.clean": "Code outline completed without findings.",
+    "codeOutline.error.missingAction": "Specify a code-outline action: scan",
+    "codeOutline.error.unknownAction": "Unknown code-outline action: {action}",
+    "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.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",
+    "codeSymbolRead.help.option.maxSnippetLines": "Maximum snippet lines to print. Default: 250",
+    "codeSymbolRead.help.exit.ok": "The requested source snippet was read",
+    "codeSymbolRead.help.exit.fail": "The snippet request was invalid, unreadable, unsupported, or too large",
+    "codeSymbolRead.title": "mustflow code symbol read",
+    "codeSymbolRead.label.target": "Target",
+    "codeSymbolRead.label.symbol": "Symbol",
+    "codeSymbolRead.label.snippet": "Snippet",
+    "codeSymbolRead.label.findings": "Findings",
+    "codeSymbolRead.error.missingAction": "Specify a code-symbol-read action: read",
+    "codeSymbolRead.error.unknownAction": "Unknown code-symbol-read action: {action}",
+    "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>",
     "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",

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

@@ -2,6 +2,70 @@ function scriptRef(packId, scriptId) {
     return `${packId}/${scriptId}`;
 }
 export const SCRIPT_PACKS = [
+    {
+        id: 'code',
+        summaryKey: 'scriptPack.pack.code.summary',
+        scripts: [
+            {
+                packId: 'code',
+                id: 'outline',
+                ref: scriptRef('code', 'outline'),
+                usage: 'mf script-pack run code/outline scan <path...> [options]',
+                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.',
+                ],
+                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'],
+                relatedSkills: [
+                    'codebase-orientation',
+                    'javascript-code-change',
+                    'module-boundary-review',
+                    'pattern-scout',
+                    'typescript-code-change',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'code-outline-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/code-outline.js')).runCodeOutlineScript,
+            },
+            {
+                packId: 'code',
+                id: 'symbol-read',
+                ref: scriptRef('code', 'symbol-read'),
+                usage: 'mf script-pack run code/symbol-read read <path> --start-line <line> [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.',
+                ],
+                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'],
+                outputs: ['human_summary', 'json_report', 'source_snippet'],
+                relatedSkills: [
+                    'codebase-orientation',
+                    'javascript-code-change',
+                    'module-boundary-review',
+                    'pattern-scout',
+                    'typescript-code-change',
+                ],
+                riskLevel: 'low',
+                cost: 'low',
+                reportSchemaFile: 'code-symbol-read-report.schema.json',
+                loadRunner: async () => (await import('../script-packs/code-outline.js')).runCodeSymbolReadScript,
+            },
+        ],
+    },
     {
         id: 'core',
         summaryKey: 'scriptPack.pack.core.summary',