gitnexus 1.6.6-rc.43 → 1.6.6-rc.44

package/dist/cli/clean.d.ts

@@ -7,4 +7,5 @@
 export declare const cleanCommand: (options?: {
     force?: boolean;
     all?: boolean;
+    lbugSidecars?: boolean;
 }) => Promise<void>;

package/dist/cli/clean.js

@@ -5,22 +5,52 @@
  * Also unregisters it from the global registry.
  */
 import fs from 'fs/promises';
+import path from 'path';
 import { logger } from '../core/logger.js';
 import { findRepo, unregisterRepo, listRegisteredRepos, assertSafeStoragePath, UnsafeStoragePathError, } from '../storage/repo-manager.js';
+import { cleanQuarantinedMissingShadowWals, inspectLbugSidecars, listQuarantinedMissingShadowWals, } from '../core/lbug/sidecar-recovery.js';
+import { t } from './i18n/index.js';
 export const cleanCommand = async (options) => {
+    if (options?.lbugSidecars) {
+        const cwd = process.cwd();
+        const repo = await findRepo(cwd);
+        if (!repo) {
+            console.log(t('clean.notFoundHere'));
+            return;
+        }
+        const lbugPath = path.join(repo.storagePath, 'lbug');
+        const state = await inspectLbugSidecars(lbugPath);
+        const quarantined = await listQuarantinedMissingShadowWals(lbugPath);
+        console.log(t('clean.lbugSidecars.state', { state: state.kind }));
+        if (quarantined.length === 0) {
+            console.log(t('clean.lbugSidecars.none'));
+            return;
+        }
+        if (!options.force) {
+            console.log(t('clean.lbugSidecars.preview', { count: quarantined.length }));
+            for (const file of quarantined) {
+                console.log(`  - ${file}`);
+            }
+            console.log(`\n${t('common.runForceConfirm')}`);
+            return;
+        }
+        const deleted = await cleanQuarantinedMissingShadowWals(lbugPath);
+        console.log(t('clean.lbugSidecars.deleted', { count: deleted.length }));
+        return;
+    }
     // --all flag: clean all indexed repos
     if (options?.all) {
         if (!options?.force) {
             const entries = await listRegisteredRepos();
             if (entries.length === 0) {
-                console.log('No indexed repositories found.');
+                console.log(t('common.notIndexed'));
                 return;
             }
-            console.log(`This will delete GitNexus indexes for ${entries.length} repo(s):`);
+            console.log(t('clean.deleteAll', { count: entries.length }));
             for (const entry of entries) {
                 console.log(`  - ${entry.name} (${entry.path})`);
             }
-            console.log('\nRun with --force to confirm deletion.');
+            console.log(`\n${t('common.runForceConfirm')}`);
             return;
         }
         const entries = await listRegisteredRepos();
@@ -46,7 +76,7 @@ export const cleanCommand = async (options) => {
             try {
                 await fs.rm(entry.storagePath, { recursive: true, force: true });
                 await unregisterRepo(entry.path);
-                console.log(`Deleted: ${entry.name} (${entry.storagePath})`);
+                console.log(t('clean.deletedRepo', { name: entry.name, storagePath: entry.storagePath }));
             }
             catch (err) {
                 logger.error({ err }, `Failed to delete ${entry.name}:`);
@@ -58,20 +88,20 @@ export const cleanCommand = async (options) => {
     const cwd = process.cwd();
     const repo = await findRepo(cwd);
     if (!repo) {
-        console.log('No indexed repository found in this directory.');
+        console.log(t('clean.notFoundHere'));
         return;
     }
     const repoName = repo.repoPath.split(/[/\\]/).pop() || repo.repoPath;
     if (!options?.force) {
-        console.log(`This will delete the GitNexus index for: ${repoName}`);
-        console.log(`   Path: ${repo.storagePath}`);
-        console.log('\nRun with --force to confirm deletion.');
+        console.log(t('clean.deleteCurrent', { repoName }));
+        console.log(`   ${t('common.path')}: ${repo.storagePath}`);
+        console.log(`\n${t('common.runForceConfirm')}`);
         return;
     }
     try {
         await fs.rm(repo.storagePath, { recursive: true, force: true });
         await unregisterRepo(repo.repoPath);
-        console.log(`Deleted: ${repo.storagePath}`);
+        console.log(t('common.deleted', { target: repo.storagePath }));
     }
     catch (err) {
         logger.error({ err }, 'Failed to delete:');

package/dist/cli/cli-message.d.ts

@@ -1,3 +1,4 @@
+import { type CliMessageKey, type CliMessageVars } from './i18n/index.js';
 /**
  * String-literal union of all `recoveryHint` tags emitted by the CLI.
  *
@@ -25,13 +26,20 @@ export interface CliMessageFields extends Record<string, unknown> {
  * and any message the user expects to read in plain text.
  */
 export declare function cliInfo(msg: string, fields?: CliMessageFields): void;
+/**
+ * Key-based informational message. Keeps the legacy string API intact while
+ * allowing commands to opt into localized user-facing stderr output.
+ */
+export declare function cliInfoKey(key: CliMessageKey, vars?: CliMessageVars, fields?: Record<string, unknown>): void;
 /**
  * User-facing warning. Operator-actionable but non-fatal — `cliWarn`
  * indicates the command can still proceed in some form.
  */
 export declare function cliWarn(msg: string, fields?: CliMessageFields): void;
+export declare function cliWarnKey(key: CliMessageKey, vars?: CliMessageVars, fields?: Record<string, unknown>): void;
 /**
  * User-facing error. Indicates the command cannot proceed; usually
  * paired with a non-zero exit code at the call site.
  */
 export declare function cliError(msg: string, fields?: CliMessageFields): void;
+export declare function cliErrorKey(key: CliMessageKey, vars?: CliMessageVars, fields?: Record<string, unknown>): void;

package/dist/cli/cli-message.js

@@ -28,6 +28,7 @@
  * stdout would corrupt that pipeline.
  */
 import { logger } from '../core/logger.js';
+import { t } from './i18n/index.js';
 function writeStderr(msg) {
     // Direct write — bypassing `console.*` so it cannot be intercepted by
     // progress-bar redirection (see `cli/analyze.ts:barLog`) or other
@@ -43,6 +44,13 @@ export function cliInfo(msg, fields) {
     writeStderr(msg);
     logger.info(fields ?? {}, msg);
 }
+/**
+ * Key-based informational message. Keeps the legacy string API intact while
+ * allowing commands to opt into localized user-facing stderr output.
+ */
+export function cliInfoKey(key, vars, fields) {
+    cliInfo(t(key, vars), fields);
+}
 /**
  * User-facing warning. Operator-actionable but non-fatal — `cliWarn`
  * indicates the command can still proceed in some form.
@@ -51,6 +59,9 @@ export function cliWarn(msg, fields) {
     writeStderr(msg);
     logger.warn(fields ?? {}, msg);
 }
+export function cliWarnKey(key, vars, fields) {
+    cliWarn(t(key, vars), fields);
+}
 /**
  * User-facing error. Indicates the command cannot proceed; usually
  * paired with a non-zero exit code at the call site.
@@ -59,3 +70,6 @@ export function cliError(msg, fields) {
     writeStderr(msg);
     logger.error(fields ?? {}, msg);
 }
+export function cliErrorKey(key, vars, fields) {
+    cliError(t(key, vars), fields);
+}

package/dist/cli/detect-changes-format.d.ts

@@ -0,0 +1 @@
+export declare function formatDetectChangesResult(result: unknown): string;

package/dist/cli/detect-changes-format.js

@@ -0,0 +1,45 @@
+import { t } from './i18n/index.js';
+export function formatDetectChangesResult(result) {
+    const payload = (result ?? {});
+    if (payload.error)
+        return t('common.error', { message: String(payload.error) });
+    const summary = payload.summary ?? {};
+    if ((summary.changed_count ?? 0) === 0) {
+        return t('tool.detectChanges.noChanges');
+    }
+    const lines = [];
+    lines.push(t('tool.detectChanges.changesSummary', {
+        files: summary.changed_files ?? 0,
+        symbols: summary.changed_count ?? 0,
+    }));
+    lines.push(t('tool.detectChanges.affectedProcesses', { count: summary.affected_count ?? 0 }));
+    lines.push(t('tool.detectChanges.riskLevel', {
+        risk: summary.risk_level || t('tool.detectChanges.unknownRisk'),
+    }));
+    lines.push('');
+    const changed = Array.isArray(payload.changed_symbols) ? payload.changed_symbols : [];
+    if (changed.length > 0) {
+        lines.push(t('tool.detectChanges.changedSymbols'));
+        for (const symbol of changed.slice(0, 15)) {
+            lines.push(`  ${symbol.type ?? 'Symbol'} ${symbol.name ?? '?'} → ${symbol.filePath ?? '?'}`);
+        }
+        if (changed.length > 15) {
+            lines.push(t('tool.detectChanges.overflowMore', { count: changed.length - 15 }));
+        }
+        lines.push('');
+    }
+    const affected = Array.isArray(payload.affected_processes) ? payload.affected_processes : [];
+    if (affected.length > 0) {
+        lines.push(t('tool.detectChanges.affectedExecutionFlows'));
+        for (const processInfo of affected.slice(0, 10)) {
+            const changedSteps = Array.isArray(processInfo.changed_steps)
+                ? processInfo.changed_steps
+                : [];
+            const steps = changedSteps.map((step) => step.symbol ?? '?').join(', ');
+            lines.push(`  • ${processInfo.name ?? '?'} (${t('tool.detectChanges.steps', {
+                count: processInfo.step_count ?? 0,
+            })}) — ${t('tool.detectChanges.changedSteps', { steps })}`);
+        }
+    }
+    return lines.join('\n').trim();
+}

package/dist/cli/doctor.d.ts

@@ -1 +1,3 @@
+export declare function displayWidth(value: string): number;
+export declare function padDisplayEnd(value: string, columns: number): string;
 export declare const doctorCommand: () => Promise<void>;

package/dist/cli/doctor.js

@@ -1,31 +1,70 @@
 import { getRuntimeCapabilities, getRuntimeFingerprint } from '../core/platform/capabilities.js';
 import { resolveEmbeddingConfig } from '../core/embeddings/config.js';
 import { isHttpMode } from '../core/embeddings/http-client.js';
+import { t } from './i18n/index.js';
+function isCombiningMark(codePoint) {
+    return ((codePoint >= 0x0300 && codePoint <= 0x036f) ||
+        (codePoint >= 0x1ab0 && codePoint <= 0x1aff) ||
+        (codePoint >= 0x1dc0 && codePoint <= 0x1dff) ||
+        (codePoint >= 0x20d0 && codePoint <= 0x20ff) ||
+        (codePoint >= 0xfe20 && codePoint <= 0xfe2f));
+}
+function isWideCodePoint(codePoint) {
+    return ((codePoint >= 0x1100 && codePoint <= 0x115f) ||
+        codePoint === 0x2329 ||
+        codePoint === 0x232a ||
+        (codePoint >= 0x2e80 && codePoint <= 0xa4cf && codePoint !== 0x303f) ||
+        (codePoint >= 0xac00 && codePoint <= 0xd7a3) ||
+        (codePoint >= 0xf900 && codePoint <= 0xfaff) ||
+        (codePoint >= 0xfe10 && codePoint <= 0xfe19) ||
+        (codePoint >= 0xfe30 && codePoint <= 0xfe6f) ||
+        (codePoint >= 0xff00 && codePoint <= 0xff60) ||
+        (codePoint >= 0xffe0 && codePoint <= 0xffe6) ||
+        (codePoint >= 0x1f300 && codePoint <= 0x1f64f) ||
+        (codePoint >= 0x1f900 && codePoint <= 0x1f9ff) ||
+        (codePoint >= 0x20000 && codePoint <= 0x3fffd));
+}
+export function displayWidth(value) {
+    let width = 0;
+    for (const char of value) {
+        const codePoint = char.codePointAt(0);
+        if (codePoint === undefined || codePoint === 0)
+            continue;
+        if (isCombiningMark(codePoint))
+            continue;
+        width += isWideCodePoint(codePoint) ? 2 : 1;
+    }
+    return width;
+}
+export function padDisplayEnd(value, columns) {
+    return value + ' '.repeat(Math.max(0, columns - displayWidth(value)));
+}
+const label = (key, width) => padDisplayEnd(t(key), width);
 export const doctorCommand = async () => {
     const fingerprint = getRuntimeFingerprint();
     const capabilities = getRuntimeCapabilities();
     const embeddingConfig = resolveEmbeddingConfig();
-    console.log('GitNexus Doctor\n');
-    console.log('Runtime');
-    console.log(`  OS:        ${fingerprint.platform}/${fingerprint.arch}`);
-    console.log(`  Node:      ${fingerprint.node}`);
-    console.log(`  GitNexus:  ${fingerprint.gitnexus}`);
-    console.log(`  LadybugDB: ${fingerprint.ladybugdb ?? 'unknown'}`);
-    console.log(`  ONNX:      ${fingerprint.onnxruntime ?? 'unknown'}`);
+    console.log(t('doctor.title') + '\n');
+    console.log(t('doctor.runtime'));
+    console.log(`  ${label('doctor.labels.os', 10)}${fingerprint.platform}/${fingerprint.arch}`);
+    console.log(`  ${label('doctor.labels.node', 10)}${fingerprint.node}`);
+    console.log(`  ${label('doctor.labels.gitnexus', 10)}${fingerprint.gitnexus}`);
+    console.log(`  ${label('doctor.labels.ladybugdb', 10)}${fingerprint.ladybugdb ?? 'unknown'}`);
+    console.log(`  ${label('doctor.labels.onnx', 10)}${fingerprint.onnxruntime ?? 'unknown'}`);
     console.log('');
-    console.log('Capabilities');
-    console.log(`  Graph store:     ${capabilities.graph}`);
-    console.log(`  Full-text search:${capabilities.fts.padStart(10)}`);
-    console.log(`  VECTOR index:    ${capabilities.vector}`);
-    console.log(`  Semantic mode:   ${capabilities.semanticMode}`);
-    console.log(`  Exact scan limit:${String(capabilities.exactScanLimit).padStart(9)} chunks`);
+    console.log(t('doctor.capabilities'));
+    console.log(`  ${label('doctor.labels.graphStore', 18)}${capabilities.graph}`);
+    console.log(`  ${label('doctor.labels.fullTextSearch', 18)}${capabilities.fts}`);
+    console.log(`  ${label('doctor.labels.vectorIndex', 18)}${capabilities.vector}`);
+    console.log(`  ${label('doctor.labels.semanticMode', 18)}${capabilities.semanticMode}`);
+    console.log(`  ${label('doctor.labels.exactScanLimit', 18)}${t('doctor.chunks', { count: capabilities.exactScanLimit })}`);
     if (capabilities.reason)
-        console.log(`  Note:            ${capabilities.reason}`);
+        console.log(`  ${label('doctor.labels.note', 18)}${capabilities.reason}`);
     console.log('');
-    console.log('Embeddings');
-    console.log(`  Backend:   ${isHttpMode() ? 'http' : 'local'}`);
-    console.log(`  Device:    ${embeddingConfig.device}`);
-    console.log(`  Threads:   ${embeddingConfig.threads}`);
-    console.log(`  Batch:     ${embeddingConfig.batchSize} nodes`);
-    console.log(`  Sub-batch: ${embeddingConfig.subBatchSize} chunks`);
+    console.log(t('doctor.embeddings'));
+    console.log(`  ${label('doctor.labels.backend', 12)}${isHttpMode() ? 'http' : 'local'}`);
+    console.log(`  ${label('doctor.labels.device', 12)}${embeddingConfig.device}`);
+    console.log(`  ${label('doctor.labels.threads', 12)}${embeddingConfig.threads}`);
+    console.log(`  ${label('doctor.labels.batch', 12)}${t('doctor.nodes', { count: embeddingConfig.batchSize })}`);
+    console.log(`  ${label('doctor.labels.subBatch', 12)}${t('doctor.chunks', { count: embeddingConfig.subBatchSize })}`);
 };

package/dist/cli/eval-server.d.ts

@@ -28,6 +28,7 @@
  *   GET  /health       — Health check. Returns {"status":"ok","repos":[...]}
  *   POST /shutdown     — Graceful shutdown.
  */
+export { formatDetectChangesResult } from './detect-changes-format.js';
 export interface EvalServerOptions {
     port?: string;
     host?: string;
@@ -44,7 +45,6 @@ export declare function formatQueryResult(result: any): string;
 export declare function formatContextResult(result: any): string;
 export declare function formatImpactResult(result: any): string;
 export declare function formatCypherResult(result: any): string;
-export declare function formatDetectChangesResult(result: any): string;
 export declare function formatListReposResult(result: any): string;
 export declare function evalServerCommand(options?: EvalServerOptions): Promise<void>;
 export declare const MAX_BODY_SIZE: number;

package/dist/cli/eval-server.js

@@ -34,6 +34,8 @@ import { writeSync } from 'node:fs';
 import { LocalBackend } from '../mcp/local/local-backend.js';
 import { logger } from '../core/logger.js';
 import { cliInfo, cliWarn, cliError } from './cli-message.js';
+import { formatDetectChangesResult } from './detect-changes-format.js';
+export { formatDetectChangesResult } from './detect-changes-format.js';
 /**
  * Validate the --host value. Accepts IPv4, IPv6, or "localhost".
  * Returns the host string unchanged, or null if invalid.
@@ -204,37 +206,6 @@ export function formatCypherResult(result) {
     }
     return typeof result === 'string' ? result : JSON.stringify(result, null, 2);
 }
-export function formatDetectChangesResult(result) {
-    if (result.error)
-        return `Error: ${result.error}`;
-    const summary = result.summary || {};
-    const lines = [];
-    if (summary.changed_count === 0) {
-        return 'No changes detected.';
-    }
-    lines.push(`Changes: ${summary.changed_files || 0} files, ${summary.changed_count || 0} symbols`);
-    lines.push(`Affected processes: ${summary.affected_count || 0}`);
-    lines.push(`Risk level: ${summary.risk_level || 'unknown'}\n`);
-    const changed = result.changed_symbols || [];
-    if (changed.length > 0) {
-        lines.push(`Changed symbols:`);
-        for (const s of changed.slice(0, 15)) {
-            lines.push(`  ${s.type} ${s.name} → ${s.filePath}`);
-        }
-        if (changed.length > 15)
-            lines.push(`  ... and ${changed.length - 15} more`);
-        lines.push('');
-    }
-    const affected = result.affected_processes || [];
-    if (affected.length > 0) {
-        lines.push(`Affected execution flows:`);
-        for (const p of affected.slice(0, 10)) {
-            const steps = (p.changed_steps || []).map((s) => s.symbol).join(', ');
-            lines.push(`  • ${p.name} (${p.step_count} steps) — changed: ${steps}`);
-        }
-    }
-    return lines.join('\n').trim();
-}
 export function formatListReposResult(result) {
     if (!Array.isArray(result) || result.length === 0) {
         return 'No indexed repositories.';

package/dist/cli/help-i18n.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function localizeCliHelp(program: Command): Command;

package/dist/cli/help-i18n.js

@@ -0,0 +1,198 @@
+import { t } from './i18n/index.js';
+const TITLE_KEYS = {
+    'Usage:': 'help.title.usage',
+    'Arguments:': 'help.title.arguments',
+    'Options:': 'help.title.options',
+    'Global Options:': 'help.title.globalOptions',
+    'Commands:': 'help.title.commands',
+};
+const COMMAND_DESCRIPTION_KEYS = {
+    '': 'help.description.root',
+    setup: 'help.command.setup.description',
+    analyze: 'help.command.analyze.description',
+    index: 'help.command.index.description',
+    serve: 'help.command.serve.description',
+    mcp: 'help.command.mcp.description',
+    list: 'help.command.list.description',
+    status: 'help.command.status.description',
+    doctor: 'help.command.doctor.description',
+    clean: 'help.command.clean.description',
+    remove: 'help.command.remove.description',
+    wiki: 'help.command.wiki.description',
+    augment: 'help.command.augment.description',
+    publish: 'help.command.publish.description',
+    query: 'help.command.query.description',
+    context: 'help.command.context.description',
+    impact: 'help.command.impact.description',
+    cypher: 'help.command.cypher.description',
+    'detect-changes': 'help.command.detectChanges.description',
+    'eval-server': 'help.command.evalServer.description',
+    group: 'help.command.group.description',
+    'group create': 'help.command.group.create.description',
+    'group add': 'help.command.group.add.description',
+    'group remove': 'help.command.group.remove.description',
+    'group list': 'help.command.group.list.description',
+    'group status': 'help.command.group.status.description',
+    'group sync': 'help.command.group.sync.description',
+    'group impact': 'help.command.group.impact.description',
+    'group query': 'help.command.group.query.description',
+    'group contracts': 'help.command.group.contracts.description',
+};
+const OPTION_DESCRIPTION_KEYS = {
+    '|-V, --version': 'help.option.version',
+    'analyze|-f, --force': 'help.option.analyze.force',
+    'analyze|--repair-fts': 'help.option.analyze.repairFts',
+    'analyze|--embeddings [limit]': 'help.option.analyze.embeddings',
+    'analyze|--drop-embeddings': 'help.option.analyze.dropEmbeddings',
+    'analyze|--skills': 'help.option.analyze.skills',
+    'analyze|--skip-agents-md': 'help.option.analyze.skipAgentsMd',
+    'analyze|--no-stats': 'help.option.analyze.noStats',
+    'analyze|--skip-skills': 'help.option.analyze.skipSkills',
+    'analyze|--index-only': 'help.option.analyze.indexOnly',
+    'analyze|--skip-git': 'help.option.skipGit',
+    'analyze|--name <alias>': 'help.option.analyze.name',
+    'analyze|--allow-duplicate-name': 'help.option.analyze.allowDuplicateName',
+    'analyze|-v, --verbose': 'help.option.verbose',
+    'analyze|--max-file-size <kb>': 'help.option.analyze.maxFileSize',
+    'analyze|--worker-timeout <seconds>': 'help.option.analyze.workerTimeout',
+    'analyze|--wal-checkpoint-threshold <bytes>': 'help.option.analyze.walCheckpointThreshold',
+    'analyze|--workers <n>': 'help.option.analyze.workers',
+    'analyze|--embedding-threads <n>': 'help.option.analyze.embeddingThreads',
+    'analyze|--embedding-batch-size <n>': 'help.option.analyze.embeddingBatchSize',
+    'analyze|--embedding-sub-batch-size <n>': 'help.option.analyze.embeddingSubBatchSize',
+    'analyze|--embedding-device <device>': 'help.option.analyze.embeddingDevice',
+    'index|-f, --force': 'help.option.index.force',
+    'index|--allow-non-git': 'help.option.index.allowNonGit',
+    'serve|-p, --port <port>': 'help.option.port',
+    'serve|--host <host>': 'help.option.serve.host',
+    'clean|-f, --force': 'help.option.force.confirmation',
+    'clean|--all': 'help.option.clean.all',
+    'clean|--lbug-sidecars': 'help.option.clean.lbugSidecars',
+    'remove|-f, --force': 'help.option.force.confirmation',
+    'wiki|-f, --force': 'help.option.wiki.force',
+    'wiki|--provider <provider>': 'help.option.wiki.provider',
+    'wiki|--model <model>': 'help.option.wiki.model',
+    'wiki|--base-url <url>': 'help.option.wiki.baseUrl',
+    'wiki|--api-key <key>': 'help.option.wiki.apiKey',
+    'wiki|--api-version <version>': 'help.option.wiki.apiVersion',
+    'wiki|--reasoning-model': 'help.option.wiki.reasoningModel',
+    'wiki|--no-reasoning-model': 'help.option.wiki.noReasoningModel',
+    'wiki|--concurrency <n>': 'help.option.wiki.concurrency',
+    'wiki|--timeout <seconds>': 'help.option.wiki.timeout',
+    'wiki|--retries <n>': 'help.option.wiki.retries',
+    'wiki|--gist': 'help.option.wiki.gist',
+    'wiki|-v, --verbose': 'help.option.verbose',
+    'wiki|--review': 'help.option.wiki.review',
+    'wiki|--lang <lang>': 'help.option.wiki.lang',
+    'publish|--id <owner/repo>': 'help.option.publish.id',
+    'publish|--skip-git': 'help.option.skipGit',
+    'query|-r, --repo <name>': 'help.option.repo.targetOmitOne',
+    'query|-c, --context <text>': 'help.option.query.context',
+    'query|-g, --goal <text>': 'help.option.query.goal',
+    'query|-l, --limit <n>': 'help.option.query.limit',
+    'query|--content': 'help.option.content',
+    'context|-r, --repo <name>': 'help.option.repo.target',
+    'context|-u, --uid <uid>': 'help.option.context.uid',
+    'context|-f, --file <path>': 'help.option.context.file',
+    'context|--content': 'help.option.content',
+    'impact|-d, --direction <dir>': 'help.option.impact.direction',
+    'impact|-r, --repo <name>': 'help.option.repo.target',
+    'impact|--depth <n>': 'help.option.impact.depth',
+    'impact|--include-tests': 'help.option.impact.includeTests',
+    'cypher|-r, --repo <name>': 'help.option.repo.target',
+    'detect-changes|-s, --scope <scope>': 'help.option.detectChanges.scope',
+    'detect-changes|-b, --base-ref <ref>': 'help.option.detectChanges.baseRef',
+    'detect-changes|-r, --repo <name>': 'help.option.repo.target',
+    'eval-server|-p, --port <port>': 'help.option.port',
+    'eval-server|--host <host>': 'help.option.evalServer.host',
+    'eval-server|--idle-timeout <seconds>': 'help.option.evalServer.idleTimeout',
+    'group create|--force': 'help.option.group.create.force',
+    'group sync|--skip-embeddings': 'help.option.group.sync.skipEmbeddings',
+    'group sync|--exact-only': 'help.option.group.sync.exactOnly',
+    'group sync|--allow-stale': 'help.option.group.sync.allowStale',
+    'group sync|--verbose': 'help.option.group.sync.verbose',
+    'group sync|--json': 'help.option.json',
+    'group impact|--target <symbol>': 'help.option.group.impact.target',
+    'group impact|--repo <groupPath>': 'help.option.group.impact.repo',
+    'group impact|--direction <dir>': 'help.option.impact.direction',
+    'group impact|--service <path>': 'help.option.group.impact.service',
+    'group impact|--subgroup <path>': 'help.option.group.impact.subgroup',
+    'group impact|--max-depth <n>': 'help.option.impact.depth',
+    'group impact|--cross-depth <n>': 'help.option.group.impact.crossDepth',
+    'group impact|--min-confidence <n>': 'help.option.group.impact.minConfidence',
+    'group impact|--include-tests': 'help.option.impact.includeTests',
+    'group impact|--timeout-ms <n>': 'help.option.group.impact.timeoutMs',
+    'group impact|--json': 'help.option.json',
+    'group query|--subgroup <path>': 'help.option.group.query.subgroup',
+    'group query|--limit <n>': 'help.option.group.query.limit',
+    'group query|--json': 'help.option.json',
+    'group contracts|--type <type>': 'help.option.group.contracts.type',
+    'group contracts|--repo <repo>': 'help.option.group.contracts.repo',
+    'group contracts|--unmatched': 'help.option.group.contracts.unmatched',
+    'group contracts|--json': 'help.option.json',
+};
+function localizeTitle(title) {
+    const key = TITLE_KEYS[title];
+    return key ? t(key) : title;
+}
+function localizeOptionDescription(option) {
+    const extraInfo = [];
+    if (option.argChoices) {
+        const label = t('help.optionMeta.choices');
+        extraInfo.push(`${label}: ${option.argChoices.map((choice) => JSON.stringify(choice)).join(', ')}`);
+    }
+    if (option.defaultValue !== undefined) {
+        const showDefault = option.required ||
+            option.optional ||
+            (option.isBoolean() && typeof option.defaultValue === 'boolean');
+        if (showDefault) {
+            const label = t('help.optionMeta.default');
+            extraInfo.push(`${label}: ${option.defaultValueDescription || JSON.stringify(option.defaultValue)}`);
+        }
+    }
+    if (option.presetArg !== undefined && option.optional) {
+        const label = t('help.optionMeta.preset');
+        extraInfo.push(`${label}: ${JSON.stringify(option.presetArg)}`);
+    }
+    if (option.envVar !== undefined) {
+        const label = t('help.optionMeta.env');
+        extraInfo.push(`${label}: ${option.envVar}`);
+    }
+    if (extraInfo.length > 0) {
+        const extraDescription = `(${extraInfo.join(', ')})`;
+        if (option.description)
+            return `${option.description} ${extraDescription}`;
+        return extraDescription;
+    }
+    return option.description;
+}
+function pathFor(commandPath, command) {
+    if (!command.parent)
+        return '';
+    return commandPath ? `${commandPath} ${command.name()}` : command.name();
+}
+function applyHelpI18n(command, commandPath = '') {
+    const descriptionKey = COMMAND_DESCRIPTION_KEYS[commandPath];
+    if (descriptionKey)
+        command.description(t(descriptionKey));
+    command.helpOption('-h, --help', t('help.option.help'));
+    command.configureHelp({
+        styleTitle: localizeTitle,
+        optionDescription: localizeOptionDescription,
+    });
+    if (command.commands.length > 0) {
+        command.helpCommand('help [command]', t('help.command.help.description'));
+    }
+    for (const option of command.options) {
+        const optionKey = OPTION_DESCRIPTION_KEYS[`${commandPath}|${option.flags}`];
+        if (optionKey)
+            option.description = t(optionKey);
+    }
+    for (const subcommand of command.commands) {
+        applyHelpI18n(subcommand, pathFor(commandPath, subcommand));
+    }
+}
+export function localizeCliHelp(program) {
+    applyHelpI18n(program);
+    return program;
+}