gitnexus 1.6.6-rc.42 → 1.6.6-rc.44

package/README.md

@@ -158,6 +158,7 @@ gitnexus analyze --skip-agents-md  # Preserve custom AGENTS.md/CLAUDE.md gitnexu
 gitnexus analyze --verbose       # Log skipped files when parsers are unavailable
 gitnexus analyze --max-file-size 1024  # Skip files larger than N KB (default: 512, cap: 32768)
 gitnexus analyze --worker-timeout 60  # Increase worker idle timeout for slow parses
+gitnexus analyze --wal-checkpoint-threshold 67108864  # 64 MiB. Control LadybugDB WAL auto-checkpoint threshold (default: 67108864 = 64 MiB; -1 keeps Ladybug stock ~16 MiB)
 gitnexus mcp                     # Start MCP server (stdio) — serves all indexed repos
 gitnexus serve                   # Start local HTTP server (multi-repo) for web UI
 gitnexus index                   # Register an existing .gitnexus/ folder into the global registry
@@ -307,6 +308,7 @@ Configure the behavior with two environment variables:
 |----------|--------|---------|--------|
 | `GITNEXUS_LBUG_EXTENSION_INSTALL` | `auto`, `load-only`, `never` | `auto` | `auto` runs one bounded INSTALL if LOAD fails. `load-only` only uses already-installed extensions (recommended for offline / firewalled environments). `never` skips optional extensions entirely. |
 | `GITNEXUS_LBUG_EXTENSION_INSTALL_TIMEOUT_MS` | positive integer | `15000` | Wall-clock budget for the out-of-process `INSTALL` child before it is killed. |
+| `GITNEXUS_WAL_CHECKPOINT_THRESHOLD` | integer `>= -1` | `67108864` (64 MiB) | LadybugDB WAL auto-checkpoint threshold during analyze (bytes). Auto-checkpoint remains enabled; `-1` keeps Ladybug's stock ~16 MiB. Larger thresholds reduce checkpoint frequency but increase the WAL size at rotation time — choose a smaller value on disk-constrained environments. |
 
 ```bash
 # Offline/airgapped: never reach the network for extensions

package/dist/cli/analyze.d.ts

@@ -69,6 +69,8 @@ export interface AnalyzeOptions {
     maxFileSize?: string;
     /** Override worker sub-batch idle timeout in seconds. */
     workerTimeout?: string;
+    /** Control LadybugDB WAL auto-checkpoint threshold during analyze. */
+    walCheckpointThreshold?: string;
     /** Parse worker pool size; 0 disables workers (sequential fallback). */
     workers?: string;
     embeddingThreads?: string;

package/dist/cli/analyze.js

@@ -12,7 +12,7 @@ import { spawn } from 'child_process';
 import v8 from 'v8';
 import cliProgress from 'cli-progress';
 import { closeLbug } from '../core/lbug/lbug-adapter.js';
-import { isWalCorruptionError, WAL_RECOVERY_SUGGESTION } from '../core/lbug/lbug-config.js';
+import { isLbugCheckpointIoError, isWalCorruptionError, parseWalCheckpointThreshold, WAL_RECOVERY_SUGGESTION, } from '../core/lbug/lbug-config.js';
 import { getStoragePaths, getGlobalRegistryPath, RegistryNameCollisionError, AnalysisNotFinalizedError, assertAnalysisFinalized, } from '../storage/repo-manager.js';
 import { getGitRoot, hasGitDir } from '../storage/git.js';
 import { runFullAnalysis } from '../core/run-analyze.js';
@@ -322,6 +322,14 @@ const forceHeapOOMForTestIfEnabled = () => {
     for (;;)
         chunks.push('x'.repeat(1024 * 1024));
 };
+// 64 MiB keeps auto-checkpoint enabled but triggers less frequently than
+// Ladybug's stock ~16 MiB threshold, reducing rename/remove churn on large
+// runs. Also matches the GitNexus default in `lbug-config.ts`.
+//
+// IMPORTANT: keep README examples (`README.md`, `gitnexus/README.md`) and
+// the `DEFAULT_WAL_CHECKPOINT_THRESHOLD` constant in
+// `gitnexus/src/core/lbug/lbug-config.ts` in sync with this value.
+const RECOMMENDED_WAL_CHECKPOINT_THRESHOLD = 64 * 1024 * 1024;
 /** Re-exec the process with a 16GB heap and larger stack if we're currently below that. */
 async function ensureHeap() {
     const nodeOpts = process.env.NODE_OPTIONS || '';
@@ -378,6 +386,8 @@ const ANALYZE_CLI_ENV_KEYS = [
     'GITNEXUS_PROFILE_DEFERRED_SLOW_MS',
     'GITNEXUS_MAX_FILE_SIZE',
     'GITNEXUS_WORKER_SUB_BATCH_TIMEOUT_MS',
+    'GITNEXUS_WAL_CHECKPOINT_THRESHOLD',
+    'GITNEXUS_WAL_MANUAL_CHECKPOINT',
     'GITNEXUS_EMBEDDING_THREADS',
     'GITNEXUS_EMBEDDING_BATCH_SIZE',
     'GITNEXUS_EMBEDDING_SUB_BATCH_SIZE',
@@ -452,6 +462,15 @@ const analyzeCommandImpl = async (inputPath, options) => {
         }
         process.env.GITNEXUS_WORKER_SUB_BATCH_TIMEOUT_MS = String(Math.round(workerTimeoutSeconds * 1000));
     }
+    if (options?.walCheckpointThreshold !== undefined) {
+        const parsed = parseWalCheckpointThreshold(options.walCheckpointThreshold);
+        if (parsed === undefined) {
+            cliError('  --wal-checkpoint-threshold must be an integer >= -1.\n');
+            process.exitCode = 1;
+            return;
+        }
+        process.env.GITNEXUS_WAL_CHECKPOINT_THRESHOLD = String(parsed);
+    }
     // `--workers` is threaded through `runFullAnalysis` options → PipelineOptions
     // → createWorkerPool, intentionally bypassing the GITNEXUS_WORKER_POOL_SIZE
     // env channel so this CLI surface never mutates `process.env` for pool size.
@@ -859,6 +878,16 @@ const analyzeCommandImpl = async (inputPath, options) => {
             process.exitCode = 1;
             return;
         }
+        if (isLbugCheckpointIoError(err)) {
+            cliError(`  LadybugDB failed while rotating/removing WAL checkpoint files.\n` +
+                `  This can happen when auto-checkpoint runs at the default threshold (~16MB).\n` +
+                `  Retry with a larger checkpoint threshold to reduce checkpoint frequency:\n` +
+                `    gitnexus analyze --wal-checkpoint-threshold ${RECOMMENDED_WAL_CHECKPOINT_THRESHOLD}\n` +
+                `    (or set GITNEXUS_WAL_CHECKPOINT_THRESHOLD=${RECOMMENDED_WAL_CHECKPOINT_THRESHOLD})\n` +
+                `    (Try 33554432 = 32 MiB on small-disk / CI runners.)\n`, { recoveryHint: 'wal-checkpoint-threshold' });
+            process.exitCode = 1;
+            return;
+        }
         // HF download failure — show clean guidance without the raw stack trace.
         // Checked before writeFatalToStderr so the user sees one focused message
         // rather than a stack-trace dump followed by a second remediation block.

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,15 +1,45 @@
+import { type CliMessageKey, type CliMessageVars } from './i18n/index.js';
+/**
+ * String-literal union of all `recoveryHint` tags emitted by the CLI.
+ *
+ * Centralized so a new recovery branch added in `analyze.ts` cannot land
+ * without updating this union — TypeScript will reject the unknown literal
+ * passed via `cliError({ recoveryHint: '...' })`. To add a new hint:
+ *   1. Add the tag string to this union.
+ *   2. Pass it as the `recoveryHint` field at the relevant `cliError`
+ *      call site.
+ *
+ * Consumers can import this type to narrow log-record `recoveryHint`
+ * fields without restating the literal list.
+ */
+export type RecoveryHint = 'wal-corruption' | 'wal-checkpoint-threshold' | 'heap-oom-respawn' | 'native-worker-abort' | 'hf-endpoint-unreachable' | 'large-repo' | 'npm-resolution' | 'module-not-found';
+/**
+ * Common shape for the optional structured-field bag passed to
+ * `cliError`/`cliWarn`/`cliInfo`. Typed so the `recoveryHint` slot is
+ * checked against the {@link RecoveryHint} union.
+ */
+export interface CliMessageFields extends Record<string, unknown> {
+    recoveryHint?: RecoveryHint;
+}
 /**
  * User-facing informational message. Use for banners, listening URLs,
  * and any message the user expects to read in plain text.
  */
-export declare function cliInfo(msg: string, fields?: Record<string, unknown>): void;
+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?: Record<string, unknown>): void;
+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?: Record<string, unknown>): void;
+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;