mustflow 2.59.0 → 2.69.0

package/README.md

@@ -270,6 +270,7 @@ mf run mustflow_update_apply
 | `mf docs review approve <path>` | Mark review complete and hide the document from the default queue. |
 | `mf handoff validate <path>` | Validate a restricted work-item or handoff JSON record without writing files. |
 | `mf context --json` | Print read order, command rules, available capabilities, and recent run summary as JSON. |
+| `mf skill route` | Resolve compact skill route candidates from task text, paths, and reasons before reading selected skill documents. |
 | `mf map --stdout` | Print the current mustflow root map to stdout. |
 | `mf map --write` | Create or update `REPO_MAP.md`. |
 | `mf quality check` | Inspect changed files for quality-gaming patterns without writing files. |

package/dist/cli/commands/context.js

@@ -1,5 +1,5 @@
 import { printUsageError, renderHelp } from '../lib/cli-output.js';
-import { getAgentContext, getPromptCacheProfileContext } from '../lib/agent-context.js';
+import { getAgentContext, getPromptCacheProfileContext, } from '../lib/agent-context.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';
@@ -16,9 +16,27 @@ export function getContextHelp(lang = 'en') {
                 label: '--cache-profile <profile>',
                 description: t(lang, 'context.help.option.cacheProfile'),
             },
+            {
+                label: '--cache-audit',
+                description: t(lang, 'context.help.option.cacheAudit'),
+            },
+            {
+                label: '--cache-compare <path>',
+                description: 'Compare the current prompt bundle with a prior context JSON report inside the mustflow root.',
+            },
+            { label: '--task <text>', description: 'Task text used to resolve selected task-layer skill context.' },
+            { label: '--path <path>', description: 'Changed or expected path for task-layer route resolution; may be repeated.' },
+            { label: '--reason <reason>', description: 'Classification or verification reason for route resolution; may be repeated.' },
+            { label: '--max-candidates <count>', description: 'Maximum skill route candidates to consider while resolving task context.' },
             { label: '-h, --help', description: t(lang, 'cli.option.help') },
         ],
-        examples: ['mf context --json', 'mf context --json --cache-profile stable'],
+        examples: [
+            'mf context --json',
+            'mf context --json --cache-profile stable',
+            'mf context --json --cache-audit',
+            'mf context --json --cache-profile all --cache-compare .mustflow/cache/baseline-context.json',
+            'mf context --json --cache-audit --task "change TypeScript CLI output" --path src/cli/commands/context.ts --reason code_change',
+        ],
         exitCodes: [
             {
                 label: '0',
@@ -31,6 +49,12 @@ export function getContextHelp(lang = 'en') {
 const CONTEXT_OPTIONS = [
     { name: '--json', kind: 'boolean' },
     { name: '--cache-profile', kind: 'string' },
+    { name: '--cache-audit', kind: 'boolean' },
+    { name: '--cache-compare', kind: 'string' },
+    { name: '--task', kind: 'string' },
+    { name: '--path', kind: 'string' },
+    { name: '--reason', kind: 'string' },
+    { name: '--max-candidates', kind: 'string' },
 ];
 const CACHE_PROFILES = new Set(['stable', 'task', 'volatile', 'all']);
 function parseCacheProfile(value) {
@@ -42,6 +66,32 @@ function parseCacheProfile(value) {
     }
     return { profile: value, invalid: false };
 }
+function parseMaxCandidates(value) {
+    if (value === null) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isInteger(parsed) && parsed > 0 ? parsed : Number.NaN;
+}
+function getParsedCliStringOptions(parsed, name) {
+    return parsed.occurrences
+        .filter((occurrence) => occurrence.name === name && typeof occurrence.value === 'string')
+        .map((occurrence) => occurrence.value);
+}
+function hasRouteSignalOptions(parsed) {
+    return (getParsedCliStringOption(parsed, '--task') !== null ||
+        getParsedCliStringOption(parsed, '--max-candidates') !== null ||
+        getParsedCliStringOptions(parsed, '--path').length > 0 ||
+        getParsedCliStringOptions(parsed, '--reason').length > 0);
+}
+function readPromptCacheRouteInput(parsed) {
+    return {
+        taskText: getParsedCliStringOption(parsed, '--task'),
+        paths: getParsedCliStringOptions(parsed, '--path'),
+        reasons: getParsedCliStringOptions(parsed, '--reason'),
+        maxCandidates: parseMaxCandidates(getParsedCliStringOption(parsed, '--max-candidates')),
+    };
+}
 export async function runContext(args, reporter, lang = 'en') {
     if (hasCliOptionToken(args, '--help', ['-h'])) {
         reporter.stdout(getContextHelp(lang));
@@ -57,14 +107,39 @@ export async function runContext(args, reporter, lang = 'en') {
         printUsageError(reporter, t(lang, 'cli.error.unexpectedValue', { option: '--cache-profile' }), 'mf context --help', getContextHelp(lang), lang);
         return 1;
     }
-    if (cacheProfile.profile && !hasParsedCliOption(parsed, '--json')) {
+    const jsonRequested = hasParsedCliOption(parsed, '--json');
+    const cacheAudit = hasParsedCliOption(parsed, '--cache-audit');
+    const cacheComparePath = getParsedCliStringOption(parsed, '--cache-compare');
+    const routeSignalOptions = hasRouteSignalOptions(parsed);
+    const routeInput = readPromptCacheRouteInput(parsed);
+    if (Number.isNaN(routeInput.maxCandidates)) {
+        printUsageError(reporter, t(lang, 'cli.error.unexpectedValue', { option: '--max-candidates' }), 'mf context --help', getContextHelp(lang), lang);
+        return 1;
+    }
+    if (cacheProfile.profile && !jsonRequested) {
         printUsageError(reporter, t(lang, 'cli.error.unexpectedArgument', { argument: '--cache-profile' }), 'mf context --help', getContextHelp(lang), lang);
         return 1;
     }
+    if (cacheAudit && !jsonRequested) {
+        printUsageError(reporter, t(lang, 'cli.error.unexpectedArgument', { argument: '--cache-audit' }), 'mf context --help', getContextHelp(lang), lang);
+        return 1;
+    }
+    if (cacheComparePath && !jsonRequested) {
+        printUsageError(reporter, t(lang, 'cli.error.unexpectedArgument', { argument: '--cache-compare' }), 'mf context --help', getContextHelp(lang), lang);
+        return 1;
+    }
+    if (routeSignalOptions && !jsonRequested) {
+        printUsageError(reporter, t(lang, 'cli.error.unexpectedArgument', { argument: '--task/--path/--reason/--max-candidates' }), 'mf context --help', getContextHelp(lang), lang);
+        return 1;
+    }
     const mustflowRoot = resolveMustflowRoot();
-    if (hasParsedCliOption(parsed, '--json')) {
-        if (cacheProfile.profile) {
-            reporter.stdout(JSON.stringify(await getPromptCacheProfileContext(mustflowRoot, cacheProfile.profile), null, 2));
+    if (jsonRequested) {
+        if (cacheProfile.profile || cacheAudit || cacheComparePath || routeSignalOptions) {
+            reporter.stdout(JSON.stringify(await getPromptCacheProfileContext(mustflowRoot, cacheProfile.profile ?? 'all', {
+                includeAudit: cacheAudit,
+                comparePath: cacheComparePath,
+                routeInput,
+            }), null, 2));
             return 0;
         }
         const context = getAgentContext(mustflowRoot);

package/dist/cli/commands/skill.js

@@ -0,0 +1,116 @@
+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 { resolveSkillRoutes } from '../../core/skill-route-resolution.js';
+const SKILL_OPTIONS = [
+    { name: '--json', kind: 'boolean' },
+    { name: '--task', kind: 'string' },
+    { name: '--path', kind: 'string' },
+    { name: '--reason', kind: 'string' },
+    { name: '--max-candidates', kind: 'string' },
+];
+export function getSkillHelp(lang = 'en') {
+    return renderHelp({
+        usage: 'mf skill route [options]',
+        summary: t(lang, 'command.skill.summary'),
+        options: [
+            { label: '--task <text>', description: 'Task text used for route scoring' },
+            { label: '--path <path>', description: 'Changed or expected path; may be repeated' },
+            { label: '--reason <reason>', description: 'Classification or verification reason; may be repeated' },
+            { label: '--max-candidates <count>', description: 'Maximum candidates to return, from 1 to 10' },
+            { label: '--json', description: t(lang, 'cli.option.json') },
+            { label: '-h, --help', description: t(lang, 'cli.option.help') },
+        ],
+        examples: [
+            'mf skill route --task "change TypeScript CLI output" --path src/cli/index.ts --reason code_change --json',
+            'mf skill route --reason docs_change --path docs-site/src/content/docs/en/commands/context.md',
+        ],
+        exitCodes: [
+            { label: '0', description: 'Skill route candidates were resolved' },
+            { label: '1', description: t(lang, 'cli.common.invalidInput') },
+        ],
+    }, lang);
+}
+function parseMaxCandidates(value) {
+    if (value === null) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isInteger(parsed) ? parsed : Number.NaN;
+}
+function getParsedCliStringOptions(parsed, name) {
+    return parsed.occurrences
+        .filter((occurrence) => occurrence.name === name && typeof occurrence.value === 'string')
+        .map((occurrence) => occurrence.value);
+}
+function parseSkillArgs(args) {
+    const parsed = parseCliOptions(args, SKILL_OPTIONS, { allowPositionals: true });
+    return {
+        json: hasParsedCliOption(parsed, '--json'),
+        action: parsed.positionals[0] ?? null,
+        taskText: getParsedCliStringOption(parsed, '--task'),
+        paths: getParsedCliStringOptions(parsed, '--path'),
+        reasons: getParsedCliStringOptions(parsed, '--reason'),
+        maxCandidates: parseMaxCandidates(getParsedCliStringOption(parsed, '--max-candidates')),
+        error: parsed.error,
+    };
+}
+function renderSkillRouteReport(report, lang) {
+    const lines = [
+        'mustflow skill route',
+        `${t(lang, 'label.mustflowRoot')}: ${resolveMustflowRoot()}`,
+        `selected_main: ${report.selected.main?.skill ?? t(lang, 'value.none')}`,
+        `selected_adjuncts: ${report.selected.adjuncts.map((candidate) => candidate.skill).join(', ') || t(lang, 'value.none')}`,
+        '',
+        'Candidates',
+    ];
+    if (report.candidates.length === 0) {
+        lines.push(`- ${t(lang, 'value.none')}`);
+    }
+    else {
+        for (const candidate of report.candidates) {
+            lines.push(`- ${candidate.skill} (${candidate.route_type}, score ${candidate.score.toFixed(1)})`, `  path: ${candidate.skill_path}`, `  reasons: ${candidate.selection_reasons.join(', ') || t(lang, 'value.none')}`);
+        }
+    }
+    lines.push('', 'Read plan', ...report.read_plan.selected_skill_paths.map((skillPath) => `- read selected skill: ${skillPath}`), `- avoid by default: ${report.read_plan.avoid_by_default.join(', ') || t(lang, 'value.none')}`, `- fallback route metadata: ${report.read_plan.fallback_route_metadata.path}`, '', 'Source files', ...report.source_files.map((sourceFile) => `- ${sourceFile}`));
+    return lines.join('\n');
+}
+export function runSkill(args, reporter, lang = 'en') {
+    if (hasCliOptionToken(args, '--help', ['-h'])) {
+        reporter.stdout(getSkillHelp(lang));
+        return 0;
+    }
+    const parsed = parseSkillArgs(args);
+    if (parsed.error) {
+        printUsageError(reporter, formatCliOptionParseError(parsed.error, lang), 'mf skill --help', getSkillHelp(lang), lang);
+        return 1;
+    }
+    if (parsed.action !== 'route') {
+        printUsageError(reporter, t(lang, parsed.action ? 'cli.error.unexpectedArgument' : 'cli.error.missingValue', {
+            argument: parsed.action ?? '',
+            option: 'route',
+        }), 'mf skill --help', getSkillHelp(lang), lang);
+        return 1;
+    }
+    if (Number.isNaN(parsed.maxCandidates)) {
+        printUsageError(reporter, t(lang, 'cli.error.unexpectedValue', { option: '--max-candidates' }), 'mf skill --help', getSkillHelp(lang), lang);
+        return 1;
+    }
+    const report = resolveSkillRoutes(resolveMustflowRoot(), {
+        taskText: parsed.taskText,
+        paths: parsed.paths,
+        reasons: parsed.reasons,
+        maxCandidates: parsed.maxCandidates,
+    });
+    if (parsed.json) {
+        reporter.stdout(JSON.stringify({
+            ...report,
+            command: 'skill',
+            action: 'route',
+        }, null, 2));
+        return 0;
+    }
+    reporter.stdout(renderSkillRouteReport(report, lang));
+    return 0;
+}

package/dist/cli/i18n/en.js

@@ -48,6 +48,7 @@ export const enMessages = {
     "command.handoff.summary": "Validate restricted work-item and handoff records",
     "command.index.summary": "Build the local mustflow SQLite index",
     "command.search.summary": "Search the local mustflow SQLite index",
+    "command.skill.summary": "Resolve compact skill route candidates",
     "command.dashboard.summary": "Start the local mustflow dashboard",
     "command.version.summary": "Show package version and optional npm update status",
     "command.versionSources.summary": "Show detected version sources",
@@ -143,6 +144,7 @@ export const enMessages = {
     "context.help.summary": "Print the agent context for the current mustflow root.",
     "context.help.option.json": "Print machine-readable context JSON",
     "context.help.option.cacheProfile": "Print a prompt-cache profile: stable, task, volatile, or all",
+    "context.help.option.cacheAudit": "Include prompt-cache rendered byte, token estimate, and budget audit data",
     "context.help.exit.ok": "Context was inspected and printed",
     "context.title": "mustflow context",
     "api.help.summary": "Print stable machine-readable API reports for the current mustflow root.",
@@ -733,7 +735,7 @@ Read these files before working:
     "lineEndings.error.checkModeOption": "check does not accept --apply or --dry-run",
     "lineEndings.error.conflictingModes": "Cannot combine --apply and --dry-run",
     "quality.help.summary": "Inspect changed files for quality-gaming patterns such as line stuffing, validation suppressions, " +
-        "test bypass markers, type escapes, and placeholder implementations.",
+        "test bypass markers, type escapes, empty catch blocks, and placeholder implementations.",
     "quality.help.option.all": "Inspect every tracked text file instead of only changed files",
     "quality.help.exit.ok": "Quality-gaming risks were inspected and no risk was found",
     "quality.help.exit.fail": "Quality-gaming risks, repository issues, or invalid input were found",

package/dist/cli/i18n/es.js

@@ -48,6 +48,7 @@ export const esMessages = {
     "command.handoff.summary": "Valida registros restringidos de trabajo y handoff",
     "command.index.summary": "Construye el índice SQLite local de mustflow",
     "command.search.summary": "Busca en el índice SQLite local de mustflow",
+    "command.skill.summary": "Resuelve candidatos compactos de ruta de skill",
     "command.dashboard.summary": "Inicia el dashboard local de mustflow",
     "command.version.summary": "Muestra la versión del paquete y el estado de actualización en npm",
     "command.versionSources.summary": "Muestra fuentes de versión detectadas",
@@ -143,6 +144,7 @@ export const esMessages = {
     "context.help.summary": "Imprime el contexto de agente para la raíz mustflow actual.",
     "context.help.option.json": "Imprime JSON de contexto legible por máquinas",
     "context.help.option.cacheProfile": "Imprime un perfil de caché de prompt: stable, task, volatile o all",
+    "context.help.option.cacheAudit": "Incluye bytes renderizados, estimación de tokens y auditoría de presupuesto de caché de prompt",
     "context.help.exit.ok": "El contexto se inspeccionó e imprimió",
     "context.title": "contexto mustflow",
     "api.help.summary": "Imprime informes API estables legibles por máquinas para la raíz mustflow actual.",
@@ -733,7 +735,7 @@ Lee estos archivos antes de trabajar:
     "lineEndings.error.checkModeOption": "check does not accept --apply or --dry-run",
     "lineEndings.error.conflictingModes": "Cannot combine --apply and --dry-run",
     "quality.help.summary": "Inspect changed files for quality-gaming patterns such as line stuffing, validation suppressions, " +
-        "test bypass markers, type escapes, and placeholder implementations.",
+        "test bypass markers, type escapes, empty catch blocks, and placeholder implementations.",
     "quality.help.option.all": "Inspect every tracked text file instead of only changed files",
     "quality.help.exit.ok": "Quality-gaming risks were inspected and no risk was found",
     "quality.help.exit.fail": "Quality-gaming risks, repository issues, or invalid input were found",

package/dist/cli/i18n/fr.js

@@ -48,6 +48,7 @@ export const frMessages = {
     "command.handoff.summary": "Valide les enregistrements restreints de travail et de handoff",
     "command.index.summary": "Construit l'index SQLite local de mustflow",
     "command.search.summary": "Recherche dans l'index SQLite local de mustflow",
+    "command.skill.summary": "Résout des candidats compacts de route de skill",
     "command.dashboard.summary": "Démarre le tableau de bord mustflow local",
     "command.version.summary": "Affiche la version du paquet et l'état de mise à jour npm",
     "command.versionSources.summary": "Affiche les sources de version détectées",
@@ -143,6 +144,7 @@ export const frMessages = {
     "context.help.summary": "Imprime le contexte d'agent pour la racine mustflow actuelle.",
     "context.help.option.json": "Imprime le JSON de contexte lisible par machine",
     "context.help.option.cacheProfile": "Imprime un profil de cache de prompt : stable, task, volatile ou all",
+    "context.help.option.cacheAudit": "Inclut les octets rendus, l'estimation de tokens et l'audit de budget du cache de prompt",
     "context.help.exit.ok": "Le contexte a été inspecté et imprimé",
     "context.title": "contexte mustflow",
     "api.help.summary": "Imprime des rapports API stables lisibles par machine pour la racine mustflow actuelle.",
@@ -733,7 +735,7 @@ Lisez ces fichiers avant de travailler :
     "lineEndings.error.checkModeOption": "check does not accept --apply or --dry-run",
     "lineEndings.error.conflictingModes": "Cannot combine --apply and --dry-run",
     "quality.help.summary": "Inspect changed files for quality-gaming patterns such as line stuffing, validation suppressions, " +
-        "test bypass markers, type escapes, and placeholder implementations.",
+        "test bypass markers, type escapes, empty catch blocks, and placeholder implementations.",
     "quality.help.option.all": "Inspect every tracked text file instead of only changed files",
     "quality.help.exit.ok": "Quality-gaming risks were inspected and no risk was found",
     "quality.help.exit.fail": "Quality-gaming risks, repository issues, or invalid input were found",

package/dist/cli/i18n/hi.js

@@ -48,6 +48,7 @@ export const hiMessages = {
     "command.handoff.summary": "Restricted work-item और handoff records validate करें",
     "command.index.summary": "स्थानीय mustflow SQLite इंडेक्स बनाएँ",
     "command.search.summary": "स्थानीय mustflow SQLite इंडेक्स में खोजें",
+    "command.skill.summary": "छोटे skill route उम्मीदवार चुनें",
     "command.dashboard.summary": "स्थानीय mustflow डैशबोर्ड शुरू करें",
     "command.version.summary": "Package version और npm update status दिखाएँ",
     "command.versionSources.summary": "पहचाने गए संस्करण स्रोत दिखाएँ",
@@ -143,6 +144,7 @@ export const hiMessages = {
     "context.help.summary": "वर्तमान mustflow रूट के लिए एजेंट संदर्भ प्रिंट करें।",
     "context.help.option.json": "मशीन-पठनीय संदर्भ JSON प्रिंट करें",
     "context.help.option.cacheProfile": "prompt cache profile प्रिंट करें: stable, task, volatile, या all",
+    "context.help.option.cacheAudit": "prompt cache rendered bytes, token estimate, और budget audit data शामिल करें",
     "context.help.exit.ok": "संदर्भ जाँचा और प्रिंट किया गया",
     "context.title": "mustflow संदर्भ",
     "api.help.summary": "वर्तमान mustflow रूट के लिए स्थिर machine-readable API रिपोर्ट प्रिंट करें।",
@@ -733,7 +735,7 @@ export const hiMessages = {
     "lineEndings.error.checkModeOption": "check does not accept --apply or --dry-run",
     "lineEndings.error.conflictingModes": "Cannot combine --apply and --dry-run",
     "quality.help.summary": "Inspect changed files for quality-gaming patterns such as line stuffing, validation suppressions, " +
-        "test bypass markers, type escapes, and placeholder implementations.",
+        "test bypass markers, type escapes, empty catch blocks, and placeholder implementations.",
     "quality.help.option.all": "Inspect every tracked text file instead of only changed files",
     "quality.help.exit.ok": "Quality-gaming risks were inspected and no risk was found",
     "quality.help.exit.fail": "Quality-gaming risks, repository issues, or invalid input were found",

package/dist/cli/i18n/ko.js

@@ -48,6 +48,7 @@ export const koMessages = {
     "command.handoff.summary": "제한된 작업 항목과 인수인계 기록을 검증합니다",
     "command.index.summary": "로컬 mustflow SQLite 색인을 만듭니다",
     "command.search.summary": "로컬 mustflow SQLite 색인을 검색합니다",
+    "command.skill.summary": "간결한 skill route 후보를 고릅니다",
     "command.dashboard.summary": "로컬 mustflow 대시보드를 시작합니다",
     "command.version.summary": "패키지 버전과 npm 업데이트 상태를 출력합니다",
     "command.versionSources.summary": "감지된 버전 기준 원본을 출력합니다",
@@ -143,6 +144,7 @@ export const koMessages = {
     "context.help.summary": "현재 mustflow 루트의 에이전트 작업 맥락을 출력합니다.",
     "context.help.option.json": "맥락을 JSON 형식으로 출력합니다",
     "context.help.option.cacheProfile": "프롬프트 캐시 프로필을 출력합니다: stable, task, volatile, all",
+    "context.help.option.cacheAudit": "프롬프트 캐시의 렌더링 바이트, 토큰 추정, 예산 감사 데이터를 포함합니다",
     "context.help.exit.ok": "맥락을 확인하고 출력했습니다",
     "context.title": "mustflow 맥락",
     "api.help.summary": "현재 mustflow 루트의 안정적 JSON API 보고서를 출력합니다.",
@@ -732,7 +734,7 @@ export const koMessages = {
     "lineEndings.error.unknownAction": "알 수 없는 line-endings 작업: {action}",
     "lineEndings.error.checkModeOption": "check에는 --apply 또는 --dry-run을 사용할 수 없습니다",
     "lineEndings.error.conflictingModes": "--apply와 --dry-run은 함께 사용할 수 없습니다",
-    "quality.help.summary": "긴 줄 몰아넣기, 검증 억제, 테스트 우회 표시, 타입 회피, 미완성 구현 같은 " +
+    "quality.help.summary": "긴 줄 몰아넣기, 검증 억제, 테스트 우회 표시, 타입 회피, 빈 catch, 미완성 구현 같은 " +
         "품질 지표 꼼수를 변경 파일에서 검사합니다.",
     "quality.help.option.all": "변경 파일만이 아니라 추적 중인 모든 텍스트 파일을 검사합니다",
     "quality.help.exit.ok": "품질 지표 꼼수를 검사했고 위험이 발견되지 않았습니다",

package/dist/cli/i18n/zh.js

@@ -48,6 +48,7 @@ export const zhMessages = {
     "command.handoff.summary": "验证受限的工作项和交接记录",
     "command.index.summary": "构建本地 mustflow SQLite 索引",
     "command.search.summary": "搜索本地 mustflow SQLite 索引",
+    "command.skill.summary": "解析紧凑的 skill route 候选项",
     "command.dashboard.summary": "启动本地 mustflow 仪表板",
     "command.version.summary": "显示包版本和 npm 更新状态",
     "command.versionSources.summary": "显示检测到的版本来源",
@@ -143,6 +144,7 @@ export const zhMessages = {
     "context.help.summary": "输出当前 mustflow 根目录的代理上下文。",
     "context.help.option.json": "输出机器可读的上下文 JSON",
     "context.help.option.cacheProfile": "输出提示缓存配置文件：stable、task、volatile 或 all",
+    "context.help.option.cacheAudit": "包含提示缓存渲染字节、token 估算和预算审计数据",
     "context.help.exit.ok": "已检查并输出上下文",
     "context.title": "mustflow 上下文",
     "api.help.summary": "为当前 mustflow 根目录输出稳定的机器可读 API 报告。",
@@ -733,7 +735,7 @@ export const zhMessages = {
     "lineEndings.error.checkModeOption": "check does not accept --apply or --dry-run",
     "lineEndings.error.conflictingModes": "Cannot combine --apply and --dry-run",
     "quality.help.summary": "Inspect changed files for quality-gaming patterns such as line stuffing, validation suppressions, " +
-        "test bypass markers, type escapes, and placeholder implementations.",
+        "test bypass markers, type escapes, empty catch blocks, and placeholder implementations.",
     "quality.help.option.all": "Inspect every tracked text file instead of only changed files",
     "quality.help.exit.ok": "Quality-gaming risks were inspected and no risk was found",
     "quality.help.exit.fail": "Quality-gaming risks, repository issues, or invalid input were found",