gitnexus 1.6.9-rc.37 → 1.6.9-rc.39

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

@@ -20,18 +20,24 @@ export function formatDetectChangesResult(result) {
     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)) {
+        const shown = changed.slice(0, 15);
+        for (const symbol of shown) {
             lines.push(`  ${symbol.type ?? 'Symbol'} ${symbol.name ?? '?'} → ${symbol.filePath ?? '?'}`);
         }
-        if (changed.length > 15) {
-            lines.push(t('tool.detectChanges.overflowMore', { count: changed.length - 15 }));
+        // Overflow is measured against the TRUE total (summary.changed_count), not
+        // the array length — the array may already be `--limit`-sliced, so using its
+        // length would under-report (or hide) how many symbols are not shown.
+        const totalChanged = summary.changed_count ?? changed.length;
+        if (totalChanged > shown.length) {
+            lines.push(t('tool.detectChanges.overflowMore', { count: totalChanged - shown.length }));
         }
         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 shownAffected = affected.slice(0, 10);
+        for (const processInfo of shownAffected) {
             const changedSteps = Array.isArray(processInfo.changed_steps)
                 ? processInfo.changed_steps
                 : [];
@@ -40,6 +46,10 @@ export function formatDetectChangesResult(result) {
                 count: processInfo.step_count ?? 0,
             })}) — ${t('tool.detectChanges.changedSteps', { steps })}`);
         }
+        const totalAffected = summary.affected_count ?? affected.length;
+        if (totalAffected > shownAffected.length) {
+            lines.push(t('tool.detectChanges.overflowMore', { count: totalAffected - shownAffected.length }));
+        }
     }
     return lines.join('\n').trim();
 }

package/dist/cli/help-i18n.js

@@ -96,6 +96,7 @@ const OPTION_DESCRIPTION_KEYS = {
     'wiki|--lang <lang>': 'help.option.wiki.lang',
     'publish|--id <owner/repo>': 'help.option.publish.id',
     'publish|--skip-git': 'help.option.skipGit',
+    'query|-q, --query <text>': 'help.option.query.flag',
     'query|-r, --repo <name>': 'help.option.repo.targetOmitOne',
     'query|--branch <name>': 'help.option.branch',
     'query|-c, --context <text>': 'help.option.query.context',
@@ -106,6 +107,7 @@ const OPTION_DESCRIPTION_KEYS = {
     'context|--branch <name>': 'help.option.branch',
     'context|-u, --uid <uid>': 'help.option.context.uid',
     'context|-f, --file <path>': 'help.option.context.file',
+    'context|-l, --limit <n>': 'help.option.context.limit',
     'context|--content': 'help.option.content',
     'impact|-d, --direction <dir>': 'help.option.impact.direction',
     'impact|-r, --repo <name>': 'help.option.repo.target',
@@ -115,13 +117,15 @@ const OPTION_DESCRIPTION_KEYS = {
     'impact|--kind <kind>': 'help.option.impact.kind',
     'impact|--depth <n>': 'help.option.impact.depth',
     'impact|--include-tests': 'help.option.impact.includeTests',
-    'impact|--limit <n>': 'help.option.impact.limit',
+    'impact|-l, --limit <n>': 'help.option.impact.limit',
     'impact|--offset <n>': 'help.option.impact.offset',
     'impact|--summary-only': 'help.option.impact.summaryOnly',
     'cypher|-r, --repo <name>': 'help.option.repo.target',
     'cypher|--branch <name>': 'help.option.branch',
+    'cypher|-l, --limit <n>': 'help.option.cypher.limit',
     'detect-changes|-s, --scope <scope>': 'help.option.detectChanges.scope',
     'detect-changes|-b, --base-ref <ref>': 'help.option.detectChanges.baseRef',
+    'detect-changes|-l, --limit <n>': 'help.option.detectChanges.limit',
     'detect-changes|-r, --repo <name>': 'help.option.repo.target',
     'detect-changes|--branch <name>': 'help.option.branch',
     'check|--cycles': 'help.option.check.cycles',

package/dist/cli/i18n/en.d.ts

@@ -48,7 +48,7 @@ export declare const en: {
     readonly 'remove.removed': "Removed: {{name}}";
     readonly 'remove.failed': "Failed to remove {{name}}: {{message}}";
     readonly 'tool.noIndexed': "GitNexus: No indexed repositories found. Run: gitnexus analyze";
-    readonly 'tool.usage.query': "Usage: gitnexus query <search_query>";
+    readonly 'tool.usage.query': "Usage: gitnexus query [search_query]  or  gitnexus query --query <text>";
     readonly 'tool.usage.context': "Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]";
     readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]";
     readonly 'tool.usage.trace': "Usage: gitnexus trace <from> <to> [--from-uid <uid>] [--to-uid <uid>] [--depth <n>]";
@@ -198,11 +198,13 @@ export declare const en: {
     readonly 'help.option.branch': "Scope to a specific branch index (multi-branch repos)";
     readonly 'help.option.context.uid': "Direct symbol UID (zero-ambiguity lookup)";
     readonly 'help.option.context.file': "File path to disambiguate common names";
+    readonly 'help.option.context.limit': "Max callers/callees/processes to return";
+    readonly 'help.option.query.flag': "Search query (alias for positional argument)";
     readonly 'help.option.impact.kind': "Kind filter to disambiguate common names (e.g. Function, Class, Method)";
     readonly 'help.option.impact.direction': "upstream (dependants) or downstream (dependencies)";
     readonly 'help.option.impact.depth': "Max relationship depth (default: 3)";
     readonly 'help.option.impact.includeTests': "Include test files in results";
-    readonly 'help.option.impact.limit': "Max symbols per depth level (default: 100)";
+    readonly 'help.option.impact.limit': "Max symbols per depth level and affected processes/modules to return (default: 100)";
     readonly 'help.option.impact.offset': "Skip N symbols per depth level for pagination";
     readonly 'help.option.impact.summaryOnly': "Return counts and risk only, omit symbol list";
     readonly 'help.option.trace.fromUid': "Source symbol UID (zero-ambiguity lookup)";
@@ -213,6 +215,8 @@ export declare const en: {
     readonly 'help.option.trace.includeTests': "Traverse through test-file symbols (default: false)";
     readonly 'help.option.detectChanges.scope': "What to analyze: unstaged, staged, all, or compare";
     readonly 'help.option.detectChanges.baseRef': "Branch/commit for compare scope (e.g. main)";
+    readonly 'help.option.detectChanges.limit': "Max changed symbols to return";
+    readonly 'help.option.cypher.limit': "Max result rows to return";
     readonly 'help.option.check.cycles': "Detect circular imports and fail when any are found";
     readonly 'help.option.evalServer.host': "Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)";
     readonly 'help.option.evalServer.idleTimeout': "Auto-shutdown after N seconds idle (0 = disabled)";

package/dist/cli/i18n/en.js

@@ -48,7 +48,7 @@ export const en = {
     'remove.removed': 'Removed: {{name}}',
     'remove.failed': 'Failed to remove {{name}}: {{message}}',
     'tool.noIndexed': 'GitNexus: No indexed repositories found. Run: gitnexus analyze',
-    'tool.usage.query': 'Usage: gitnexus query <search_query>',
+    'tool.usage.query': 'Usage: gitnexus query [search_query]  or  gitnexus query --query <text>',
     'tool.usage.context': 'Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]',
     'tool.usage.impact': 'Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]',
     'tool.usage.trace': 'Usage: gitnexus trace <from> <to> [--from-uid <uid>] [--to-uid <uid>] [--depth <n>]',
@@ -198,11 +198,13 @@ export const en = {
     'help.option.branch': 'Scope to a specific branch index (multi-branch repos)',
     'help.option.context.uid': 'Direct symbol UID (zero-ambiguity lookup)',
     'help.option.context.file': 'File path to disambiguate common names',
+    'help.option.context.limit': 'Max callers/callees/processes to return',
+    'help.option.query.flag': 'Search query (alias for positional argument)',
     'help.option.impact.kind': 'Kind filter to disambiguate common names (e.g. Function, Class, Method)',
     'help.option.impact.direction': 'upstream (dependants) or downstream (dependencies)',
     'help.option.impact.depth': 'Max relationship depth (default: 3)',
     'help.option.impact.includeTests': 'Include test files in results',
-    'help.option.impact.limit': 'Max symbols per depth level (default: 100)',
+    'help.option.impact.limit': 'Max symbols per depth level and affected processes/modules to return (default: 100)',
     'help.option.impact.offset': 'Skip N symbols per depth level for pagination',
     'help.option.impact.summaryOnly': 'Return counts and risk only, omit symbol list',
     'help.option.trace.fromUid': 'Source symbol UID (zero-ambiguity lookup)',
@@ -213,6 +215,8 @@ export const en = {
     'help.option.trace.includeTests': 'Traverse through test-file symbols (default: false)',
     'help.option.detectChanges.scope': 'What to analyze: unstaged, staged, all, or compare',
     'help.option.detectChanges.baseRef': 'Branch/commit for compare scope (e.g. main)',
+    'help.option.detectChanges.limit': 'Max changed symbols to return',
+    'help.option.cypher.limit': 'Max result rows to return',
     'help.option.check.cycles': 'Detect circular imports and fail when any are found',
     'help.option.evalServer.host': 'Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)',
     'help.option.evalServer.idleTimeout': 'Auto-shutdown after N seconds idle (0 = disabled)',

package/dist/cli/i18n/resources.d.ts

@@ -49,7 +49,7 @@ export declare const cliResources: {
         readonly 'remove.removed': "Removed: {{name}}";
         readonly 'remove.failed': "Failed to remove {{name}}: {{message}}";
         readonly 'tool.noIndexed': "GitNexus: No indexed repositories found. Run: gitnexus analyze";
-        readonly 'tool.usage.query': "Usage: gitnexus query <search_query>";
+        readonly 'tool.usage.query': "Usage: gitnexus query [search_query]  or  gitnexus query --query <text>";
         readonly 'tool.usage.context': "Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]";
         readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]";
         readonly 'tool.usage.trace': "Usage: gitnexus trace <from> <to> [--from-uid <uid>] [--to-uid <uid>] [--depth <n>]";
@@ -199,11 +199,13 @@ export declare const cliResources: {
         readonly 'help.option.branch': "Scope to a specific branch index (multi-branch repos)";
         readonly 'help.option.context.uid': "Direct symbol UID (zero-ambiguity lookup)";
         readonly 'help.option.context.file': "File path to disambiguate common names";
+        readonly 'help.option.context.limit': "Max callers/callees/processes to return";
+        readonly 'help.option.query.flag': "Search query (alias for positional argument)";
         readonly 'help.option.impact.kind': "Kind filter to disambiguate common names (e.g. Function, Class, Method)";
         readonly 'help.option.impact.direction': "upstream (dependants) or downstream (dependencies)";
         readonly 'help.option.impact.depth': "Max relationship depth (default: 3)";
         readonly 'help.option.impact.includeTests': "Include test files in results";
-        readonly 'help.option.impact.limit': "Max symbols per depth level (default: 100)";
+        readonly 'help.option.impact.limit': "Max symbols per depth level and affected processes/modules to return (default: 100)";
         readonly 'help.option.impact.offset': "Skip N symbols per depth level for pagination";
         readonly 'help.option.impact.summaryOnly': "Return counts and risk only, omit symbol list";
         readonly 'help.option.trace.fromUid': "Source symbol UID (zero-ambiguity lookup)";
@@ -214,6 +216,8 @@ export declare const cliResources: {
         readonly 'help.option.trace.includeTests': "Traverse through test-file symbols (default: false)";
         readonly 'help.option.detectChanges.scope': "What to analyze: unstaged, staged, all, or compare";
         readonly 'help.option.detectChanges.baseRef': "Branch/commit for compare scope (e.g. main)";
+        readonly 'help.option.detectChanges.limit': "Max changed symbols to return";
+        readonly 'help.option.cypher.limit': "Max result rows to return";
         readonly 'help.option.check.cycles': "Detect circular imports and fail when any are found";
         readonly 'help.option.evalServer.host': "Bind address (default: 127.0.0.1, use 0.0.0.0 to expose to all interfaces)";
         readonly 'help.option.evalServer.idleTimeout': "Auto-shutdown after N seconds idle (0 = disabled)";
@@ -437,6 +441,8 @@ export declare const cliResources: {
         'help.option.branch': string;
         'help.option.context.uid': string;
         'help.option.context.file': string;
+        'help.option.context.limit': string;
+        'help.option.query.flag': string;
         'help.option.impact.kind': string;
         'help.option.impact.direction': string;
         'help.option.impact.depth': string;
@@ -452,6 +458,8 @@ export declare const cliResources: {
         'help.option.trace.includeTests': string;
         'help.option.detectChanges.scope': string;
         'help.option.detectChanges.baseRef': string;
+        'help.option.detectChanges.limit': string;
+        'help.option.cypher.limit': string;
         'help.option.check.cycles': string;
         'help.option.evalServer.host': string;
         'help.option.evalServer.idleTimeout': string;

package/dist/cli/i18n/zh-CN.d.ts

@@ -198,6 +198,8 @@ export declare const zhCN: {
     'help.option.branch': string;
     'help.option.context.uid': string;
     'help.option.context.file': string;
+    'help.option.context.limit': string;
+    'help.option.query.flag': string;
     'help.option.impact.kind': string;
     'help.option.impact.direction': string;
     'help.option.impact.depth': string;
@@ -213,6 +215,8 @@ export declare const zhCN: {
     'help.option.trace.includeTests': string;
     'help.option.detectChanges.scope': string;
     'help.option.detectChanges.baseRef': string;
+    'help.option.detectChanges.limit': string;
+    'help.option.cypher.limit': string;
     'help.option.check.cycles': string;
     'help.option.evalServer.host': string;
     'help.option.evalServer.idleTimeout': string;

package/dist/cli/i18n/zh-CN.js

@@ -48,7 +48,7 @@ export const zhCN = {
     'remove.removed': '已移除：{{name}}',
     'remove.failed': '移除 {{name}} 失败：{{message}}',
     'tool.noIndexed': 'GitNexus：未找到已索引仓库。请运行：gitnexus analyze',
-    'tool.usage.query': '用法：gitnexus query <搜索词>',
+    'tool.usage.query': '用法：gitnexus query [搜索词]  或  gitnexus query --query <文本>',
     'tool.usage.context': '用法：gitnexus context <符号名> [--uid <uid>] [--file <路径>]',
     'tool.usage.impact': '用法：gitnexus impact <符号名> [--uid <uid>] [--file <路径>] [--kind <类型>] [--direction upstream|downstream]',
     'tool.usage.trace': '用法：gitnexus trace <起点> <终点> [--from-uid <uid>] [--to-uid <uid>] [--depth <n>]',
@@ -198,11 +198,13 @@ export const zhCN = {
     'help.option.branch': '将查询限定到指定分支的索引（多分支仓库）',
     'help.option.context.uid': '直接符号 UID（零歧义查找）',
     'help.option.context.file': '用于消除常见名称歧义的文件路径',
+    'help.option.context.limit': '最多返回的调用者/被调用者/流程数',
+    'help.option.query.flag': '搜索词（位置参数的别名）',
     'help.option.impact.kind': '用于消除常见名称歧义的类型过滤（如 Function、Class、Method）',
     'help.option.impact.direction': 'upstream（依赖它的项）或 downstream（它依赖的项）',
     'help.option.impact.depth': '最大关系遍历深度（默认：3）',
     'help.option.impact.includeTests': '在结果中包含测试文件',
-    'help.option.impact.limit': '每层深度最大符号数（默认：100）',
+    'help.option.impact.limit': '每层深度最大符号数及最多返回的受影响流程/模块数（默认：100）',
     'help.option.impact.offset': '每层深度跳过 N 个符号（分页用）',
     'help.option.impact.summaryOnly': '仅返回计数和风险等级，省略符号列表',
     'help.option.trace.fromUid': '源符号 UID（零歧义查找）',
@@ -213,6 +215,8 @@ export const zhCN = {
     'help.option.trace.includeTests': '遍历时包含测试文件中的符号（默认：false）',
     'help.option.detectChanges.scope': '分析范围：unstaged、staged、all 或 compare',
     'help.option.detectChanges.baseRef': 'compare 范围的分支/提交（例如 main）',
+    'help.option.detectChanges.limit': '最多返回的已变更符号数',
+    'help.option.cypher.limit': '最多返回的结果行数',
     'help.option.check.cycles': '检测循环导入，并在发现循环时失败',
     'help.option.evalServer.host': '绑定地址（默认：127.0.0.1；用 0.0.0.0 暴露到所有网卡）',
     'help.option.evalServer.idleTimeout': '空闲 N 秒后自动关闭（0 = 禁用）',

package/dist/cli/index.js

@@ -202,8 +202,9 @@ program
 // ─── Direct Tool Commands (no MCP overhead) ────────────────────────
 // These invoke LocalBackend directly for use in eval, scripts, and CI.
 program
-    .command('query <search_query>')
+    .command('query [search_query]')
     .description('Search the knowledge graph for execution flows related to a concept')
+    .option('-q, --query <text>', 'Search query (alias for positional argument)')
     .option('-r, --repo <name>', 'Target repository (omit if only one indexed)')
     .option('--branch <name>', 'Scope to a specific branch index (multi-branch repos)')
     .option('-c, --context <text>', 'Task context to improve ranking')
@@ -218,6 +219,7 @@ program
     .option('--branch <name>', 'Scope to a specific branch index (multi-branch repos)')
     .option('-u, --uid <uid>', 'Direct symbol UID (zero-ambiguity lookup)')
     .option('-f, --file <path>', 'File path to disambiguate common names')
+    .option('-l, --limit <n>', 'Max callers/callees/processes to return')
     .option('--content', 'Include full symbol source code')
     .action(createLbugLazyAction(() => import('./tool.js'), 'contextCommand'));
 program
@@ -233,7 +235,7 @@ program
     .option('--kind <kind>', 'Kind filter to disambiguate common names (e.g. Function, Class, Method)')
     .option('--depth <n>', 'Max relationship depth (default: 3)')
     .option('--include-tests', 'Include test files in results')
-    .option('--limit <n>', 'Max symbols per depth level (default: 100)')
+    .option('-l, --limit <n>', 'Max symbols per depth level and affected processes/modules to return (default: 100)')
     .option('--offset <n>', 'Skip N symbols per depth level for pagination')
     .option('--summary-only', 'Return counts and risk only, omit symbol list')
     .action(createLbugLazyAction(() => import('./tool.js'), 'impactCommand'));
@@ -254,6 +256,7 @@ program
     .description('Execute raw Cypher query against the knowledge graph')
     .option('-r, --repo <name>', 'Target repository')
     .option('--branch <name>', 'Scope to a specific branch index (multi-branch repos)')
+    .option('-l, --limit <n>', 'Max result rows to return')
     .action(createLbugLazyAction(() => import('./tool.js'), 'cypherCommand'));
 program
     .command('detect-changes')
@@ -263,6 +266,7 @@ program
     .option('-b, --base-ref <ref>', 'Branch/commit for compare scope (e.g. main)')
     .option('-r, --repo <name>', 'Target repository')
     .option('--branch <name>', 'Scope to a specific branch index (multi-branch repos)')
+    .option('-l, --limit <n>', 'Max changed symbols to return')
     .action(createLbugLazyAction(() => import('./tool.js'), 'detectChangesCommand'));
 program
     .command('check')

package/dist/cli/tool.d.ts

@@ -14,7 +14,8 @@
  * native module which captures the Node.js process.stdout stream during init.
  * See the output() function for details (#324).
  */
-export declare function queryCommand(queryText: string, options?: {
+export declare function queryCommand(queryText: string | undefined, options?: {
+    query?: string;
     repo?: string;
     branch?: string;
     context?: string;
@@ -27,6 +28,7 @@ export declare function contextCommand(name: string, options?: {
     branch?: string;
     file?: string;
     uid?: string;
+    limit?: string;
     content?: boolean;
 }): Promise<void>;
 export declare function impactCommand(target?: string, options?: {
@@ -47,12 +49,14 @@ export declare function impactCommand(target?: string, options?: {
 export declare function cypherCommand(query: string, options?: {
     repo?: string;
     branch?: string;
+    limit?: string;
 }): Promise<void>;
 export declare function detectChangesCommand(options?: {
     scope?: string;
     baseRef?: string;
     repo?: string;
     branch?: string;
+    limit?: string;
 }): Promise<void>;
 export declare function checkCommand(options?: {
     cycles?: boolean;

package/dist/cli/tool.js

@@ -55,18 +55,46 @@ function output(data) {
         process.stderr.write(text + '\n');
     }
 }
+/**
+ * Parse a `--limit` CLI option into a positive row cap, or `undefined` when the
+ * flag is absent, non-numeric, zero, or negative.
+ *
+ * Treating invalid / 0 / negative input as "no limit" — rather than the old
+ * `options.limit ? Math.max(0, parseInt(...)) : undefined` path, where a string
+ * like `"abc"` is truthy and yields `NaN`, then `slice(0, NaN)` silently EMPTIES
+ * the result with exit 0 — keeps the guardrail commands (impact / context /
+ * detect-changes) honest: a bad `--limit` shows everything, never nothing.
+ */
+function parseLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    return Number.isInteger(n) && n > 0 ? n : undefined;
+}
+/**
+ * Parse an `--offset` CLI option into a non-negative pagination start, or
+ * `undefined` when the flag is absent or invalid. Mirrors {@link parseLimit};
+ * offset `0` is valid ("start at the beginning"), so the guard is `>= 0`.
+ */
+function parseOffset(raw) {
+    if (raw === undefined)
+        return undefined;
+    const n = Number(raw);
+    return Number.isInteger(n) && n >= 0 ? n : undefined;
+}
 export async function queryCommand(queryText, options) {
-    if (!queryText?.trim()) {
+    const resolvedQuery = queryText?.trim() || options?.query?.trim();
+    if (!resolvedQuery) {
         cliErrorKey('tool.usage.query');
         process.exit(1);
     }
     const backend = await getBackend();
     const result = await backend.callTool('query', {
         // #2175: canonical param is search_query; the backend still accepts legacy "query".
-        search_query: queryText,
+        search_query: resolvedQuery,
         task_context: options?.context,
         goal: options?.goal,
-        limit: options?.limit ? parseInt(options.limit) : undefined,
+        limit: parseLimit(options?.limit),
         include_content: options?.content ?? false,
         repo: options?.repo,
         branch: options?.branch,
@@ -83,6 +111,7 @@ export async function contextCommand(name, options) {
         cliErrorKey('tool.usage.context');
         process.exit(1);
     }
+    const limit = parseLimit(options?.limit);
     const backend = await getBackend();
     const result = await backend.callTool('context', {
         name: name || undefined,
@@ -92,6 +121,25 @@ export async function contextCommand(name, options) {
         repo: options?.repo,
         branch: options?.branch,
     });
+    if (limit !== undefined) {
+        // Bound every array-valued category under incoming/outgoing (calls, accesses,
+        // imports, extends, uses, …) — categorize() buckets by relType, so the prior
+        // hardcoded calls/accesses missed the rest (e.g. incoming.accesses) — plus
+        // typed_properties and processes, so --limit caps the whole context payload.
+        for (const dir of [result.incoming, result.outgoing]) {
+            if (!dir)
+                continue;
+            for (const key of Object.keys(dir)) {
+                const bucket = dir[key];
+                if (Array.isArray(bucket))
+                    dir[key] = bucket.slice(0, limit);
+            }
+        }
+        if (Array.isArray(result.typed_properties))
+            result.typed_properties = result.typed_properties.slice(0, limit);
+        if (Array.isArray(result.processes))
+            result.processes = result.processes.slice(0, limit);
+    }
     output(result);
 }
 export async function impactCommand(target, options) {
@@ -116,10 +164,8 @@ export async function impactCommand(target, options) {
     }
     try {
         const backend = await getBackend();
-        const rawLimit = parseInt(options?.limit ?? '', 10);
-        const rawOffset = parseInt(options?.offset ?? '', 10);
-        const parsedLimit = Number.isFinite(rawLimit) ? rawLimit : undefined;
-        const parsedOffset = Number.isFinite(rawOffset) ? rawOffset : undefined;
+        const parsedLimit = parseLimit(options?.limit);
+        const parsedOffset = parseOffset(options?.offset);
         // `--line` is a PDG-only statement anchor (1-based source line). Parse it to
         // an integer when provided and thread it ONLY when present, so the backend's
         // line-without-pdg / non-positive-integer validation fires on the real value
@@ -145,6 +191,15 @@ export async function impactCommand(target, options) {
             offset: parsedOffset,
             summaryOnly: options?.summaryOnly ?? undefined,
         });
+        // Client-side cap of the affected-list payload to --limit (parity with the
+        // other tool commands). The backend already paginates byDepth per level to
+        // the same limit, so byDepth needs no client-side re-slice.
+        if (parsedLimit !== undefined) {
+            if (Array.isArray(result.affected_processes))
+                result.affected_processes = result.affected_processes.slice(0, parsedLimit);
+            if (Array.isArray(result.affected_modules))
+                result.affected_modules = result.affected_modules.slice(0, parsedLimit);
+        }
         output(result);
     }
     catch (err) {
@@ -164,6 +219,7 @@ export async function cypherCommand(query, options) {
         cliErrorKey('tool.usage.cypher');
         process.exit(1);
     }
+    const limit = parseLimit(options?.limit);
     const backend = await getBackend();
     const result = await backend.callTool('cypher', {
         // #2175: canonical param is statement; the backend still accepts legacy "query".
@@ -171,9 +227,30 @@ export async function cypherCommand(query, options) {
         repo: options?.repo,
         branch: options?.branch,
     });
+    if (limit !== undefined) {
+        if (Array.isArray(result)) {
+            // Non-tabular result: a raw row array.
+            result.splice(limit);
+        }
+        else if (result && typeof result === 'object' && typeof result.row_count === 'number') {
+            // Tabular result: { markdown, row_count }. The markdown is a table built as
+            // [header, separator, ...dataRows].join('\n'), so slice it to `limit` data
+            // rows (keeping the 2 header lines) and report a row_count that matches what
+            // is actually printed — otherwise `--limit 2` over 50 rows prints all 50 but
+            // claims row_count: 2.
+            if (typeof result.markdown === 'string' && result.row_count > limit) {
+                result.markdown = result.markdown
+                    .split('\n')
+                    .slice(0, 2 + limit)
+                    .join('\n');
+            }
+            result.row_count = Math.min(result.row_count, limit);
+        }
+    }
     output(result);
 }
 export async function detectChangesCommand(options) {
+    const limit = parseLimit(options?.limit);
     const backend = await getBackend();
     const result = await backend.callTool('detect_changes', {
         scope: options?.scope || 'unstaged',
@@ -181,6 +258,12 @@ export async function detectChangesCommand(options) {
         repo: options?.repo,
         branch: options?.branch,
     });
+    if (limit !== undefined) {
+        if (Array.isArray(result.changed_symbols))
+            result.changed_symbols = result.changed_symbols.slice(0, limit);
+        if (Array.isArray(result.affected_processes))
+            result.affected_processes = result.affected_processes.slice(0, limit);
+    }
     output(formatDetectChangesResult(result));
 }
 export async function checkCommand(options) {

package/dist/core/lbug/lbug-config.d.ts

@@ -72,10 +72,13 @@ export interface LbugConnectionHandle {
     conn: lbug.Connection;
 }
 /**
- * Return true when the error message indicates that a LadybugDB file lock
- * could not be acquired — either at construction time
- * (`new lbug.Database(...)` raises from `local_file_system.cpp`) or during
- * a query (another writer holds the exclusive lock).
+ * Return true when the error message indicates that a LadybugDB write
+ * transaction could not proceed due to lock contention — either a file
+ * lock that could not be acquired (either at construction time,
+ * `new lbug.Database(...)` raising from `local_file_system.cpp`, or during
+ * a query, another writer holds the exclusive lock), or a same-process
+ * write transaction rejected because another write transaction is already
+ * active on the connection.
  *
  * Lives here (not in `lbug-adapter.ts`) so both the construction-time
  * retry (`openWithLockRetry` in this file) and the query-time retry

package/dist/core/lbug/lbug-config.js

@@ -338,10 +338,13 @@ export const isLbugCheckpointIoError = (err) => {
     return LBUG_CHECKPOINT_PERMISSIVE_RE.test(msg);
 };
 /**
- * Return true when the error message indicates that a LadybugDB file lock
- * could not be acquired — either at construction time
- * (`new lbug.Database(...)` raises from `local_file_system.cpp`) or during
- * a query (another writer holds the exclusive lock).
+ * Return true when the error message indicates that a LadybugDB write
+ * transaction could not proceed due to lock contention — either a file
+ * lock that could not be acquired (either at construction time,
+ * `new lbug.Database(...)` raising from `local_file_system.cpp`, or during
+ * a query, another writer holds the exclusive lock), or a same-process
+ * write transaction rejected because another write transaction is already
+ * active on the connection.
  *
  * Lives here (not in `lbug-adapter.ts`) so both the construction-time
  * retry (`openWithLockRetry` in this file) and the query-time retry
@@ -353,10 +356,19 @@ export const isDbBusyError = (err) => {
     // `lock` already subsumes `could not set lock`; the broader term is kept
     // because graph-DB transient errors include "deadlock", "lock contention",
     // and the LadybugDB native module's "could not set lock on file" — all of
-    // which deserve a retry. If a non-transient lock-shaped error ever
-    // surfaces (e.g., "lock file missing" during recovery), tighten this
-    // matcher rather than raising the retry budget.
-    return msg.includes('busy') || msg.includes('lock') || msg.includes('already in use');
+    // which deserve a retry. LadybugDB also reports same-process writer
+    // contention without the words "busy" or "lock".
+    //
+    // "only one write transaction at a time" was observed against LadybugDB
+    // 0.18.0 (see gitnexus/package.json @ladybugdb/core).
+    //
+    // If a non-transient lock-shaped error ever surfaces (e.g., "lock file
+    // missing" during recovery), tighten this matcher rather than raising the
+    // retry budget.
+    return (msg.includes('busy') ||
+        msg.includes('lock') ||
+        msg.includes('already in use') ||
+        msg.includes('only one write transaction at a time'));
 };
 export function createLbugDatabase(lbugModule, databasePath, options = {}) {
     // .d.ts declares fewer args than the native constructor accepts.

package/dist/mcp/local/local-backend.js

@@ -1924,7 +1924,11 @@ export class LocalBackend {
                     return '';
                 if (typeof v === 'object')
                     return JSON.stringify(v);
-                return String(v);
+                // Collapse newlines so a multi-line cell value (e.g. a symbol's
+                // `content`) stays on one physical line. Otherwise the rendered row
+                // spans multiple lines, which corrupts the table and breaks the
+                // CLI's `--limit` line-based slicing (#2310 review).
+                return String(v).replace(/\r?\n/g, ' ');
             })
                 .join(' | ') +
             ' |');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.9-rc.37",
+  "version": "1.6.9-rc.39",
   "description": "Graph-powered code intelligence for AI agents. Index any codebase, query via MCP or CLI.",
   "author": "Abhigyan Patwari",
   "license": "PolyForm-Noncommercial-1.0.0",

package/scripts/cross-platform-tests.ts

@@ -83,6 +83,7 @@ const LBUG_NATIVE = [
 // quoting, path resolution, signal handling)
 const SPAWN_CLI = [
   'test/integration/cli-e2e.test.ts',
+  'test/integration/cli-limit-e2e.test.ts',
   'test/integration/hooks-e2e.test.ts',
   'test/integration/skills-e2e.test.ts',
   'test/integration/server-http-startup.test.ts',