gitnexus 1.6.6-rc.96 → 1.6.6-rc.97

package/README.md

@@ -170,6 +170,13 @@ gitnexus clean --all --force     # Delete all indexes
 gitnexus wiki [path]             # Generate LLM-powered docs from knowledge graph
 gitnexus wiki --model <model>    # Wiki with custom LLM model (default: gpt-4o-mini)
 
+# Direct graph queries — the same tools the MCP server exposes, no MCP daemon needed
+gitnexus query "<concept>"                                    # Process-grouped hybrid search
+gitnexus context <symbol> [--uid <uid> | --file <path>]       # 360° symbol view; flags disambiguate a shared name
+gitnexus impact <symbol> [--uid <uid> | --file <path> | --kind <kind>]  # Blast radius; flags disambiguate a shared name
+gitnexus detect-changes          # Map the working-tree diff to affected symbols and execution flows
+gitnexus cypher "<query>"        # Run a raw Cypher query against the knowledge graph
+
 # Repository groups (multi-repo / monorepo service tracking)
 gitnexus group create <name>                                   # Create a repository group
 gitnexus group add <group> <groupPath> <registryName>          # Add a repo to a group. <groupPath> is a hierarchy path (e.g. hr/hiring/backend); <registryName> is the repo's name from the registry (see `gitnexus list`)

package/dist/cli/help-i18n.js

@@ -97,6 +97,9 @@ const OPTION_DESCRIPTION_KEYS = {
     'context|--content': 'help.option.content',
     'impact|-d, --direction <dir>': 'help.option.impact.direction',
     'impact|-r, --repo <name>': 'help.option.repo.target',
+    'impact|-u, --uid <uid>': 'help.option.context.uid',
+    'impact|-f, --file <path>': 'help.option.context.file',
+    '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',

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

@@ -41,8 +41,9 @@ export declare const en: {
     readonly 'tool.noIndexed': "GitNexus: No indexed repositories found. Run: gitnexus analyze";
     readonly 'tool.usage.query': "Usage: gitnexus query <search_query>";
     readonly 'tool.usage.context': "Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]";
-    readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--direction upstream|downstream]";
+    readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]";
     readonly 'tool.usage.cypher': "Usage: gitnexus cypher <cypher_query>";
+    readonly 'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.";
     readonly 'tool.detectChanges.noChanges': "No changes detected.";
     readonly 'tool.detectChanges.changesSummary': "Changes: {{files}} files, {{symbols}} symbols";
     readonly 'tool.detectChanges.affectedProcesses': "Affected processes: {{count}}";
@@ -177,6 +178,7 @@ export declare const en: {
     readonly 'help.option.repo.target': "Target repository";
     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.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";

package/dist/cli/i18n/en.js

@@ -41,8 +41,9 @@ export const en = {
     'tool.noIndexed': 'GitNexus: No indexed repositories found. Run: gitnexus analyze',
     'tool.usage.query': 'Usage: gitnexus query <search_query>',
     'tool.usage.context': 'Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]',
-    'tool.usage.impact': 'Usage: gitnexus impact <symbol_name> [--direction upstream|downstream]',
+    'tool.usage.impact': 'Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]',
     'tool.usage.cypher': 'Usage: gitnexus cypher <cypher_query>',
+    'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.",
     'tool.detectChanges.noChanges': 'No changes detected.',
     'tool.detectChanges.changesSummary': 'Changes: {{files}} files, {{symbols}} symbols',
     'tool.detectChanges.affectedProcesses': 'Affected processes: {{count}}',
@@ -177,6 +178,7 @@ export const en = {
     'help.option.repo.target': 'Target repository',
     'help.option.context.uid': 'Direct symbol UID (zero-ambiguity lookup)',
     'help.option.context.file': 'File path to disambiguate common names',
+    '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',

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

@@ -42,8 +42,9 @@ export declare const cliResources: {
         readonly 'tool.noIndexed': "GitNexus: No indexed repositories found. Run: gitnexus analyze";
         readonly 'tool.usage.query': "Usage: gitnexus query <search_query>";
         readonly 'tool.usage.context': "Usage: gitnexus context <symbol_name> [--uid <uid>] [--file <path>]";
-        readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--direction upstream|downstream]";
+        readonly 'tool.usage.impact': "Usage: gitnexus impact <symbol_name> [--uid <uid>] [--file <path>] [--kind <kind>] [--direction upstream|downstream]";
         readonly 'tool.usage.cypher': "Usage: gitnexus cypher <cypher_query>";
+        readonly 'tool.warn.unknownKind': "--kind '{{kind}}' is not a known symbol kind (e.g. Function, Class, Method); it will not narrow the result.";
         readonly 'tool.detectChanges.noChanges': "No changes detected.";
         readonly 'tool.detectChanges.changesSummary': "Changes: {{files}} files, {{symbols}} symbols";
         readonly 'tool.detectChanges.affectedProcesses': "Affected processes: {{count}}";
@@ -178,6 +179,7 @@ export declare const cliResources: {
         readonly 'help.option.repo.target': "Target repository";
         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.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";
@@ -253,6 +255,7 @@ export declare const cliResources: {
         'tool.usage.context': string;
         'tool.usage.impact': string;
         'tool.usage.cypher': string;
+        'tool.warn.unknownKind': string;
         'tool.detectChanges.noChanges': string;
         'tool.detectChanges.changesSummary': string;
         'tool.detectChanges.affectedProcesses': string;
@@ -387,6 +390,7 @@ export declare const cliResources: {
         'help.option.repo.target': string;
         'help.option.context.uid': string;
         'help.option.context.file': string;
+        'help.option.impact.kind': string;
         'help.option.impact.direction': string;
         'help.option.impact.depth': string;
         'help.option.impact.includeTests': string;

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

@@ -43,6 +43,7 @@ export declare const zhCN: {
     'tool.usage.context': string;
     'tool.usage.impact': string;
     'tool.usage.cypher': string;
+    'tool.warn.unknownKind': string;
     'tool.detectChanges.noChanges': string;
     'tool.detectChanges.changesSummary': string;
     'tool.detectChanges.affectedProcesses': string;
@@ -177,6 +178,7 @@ export declare const zhCN: {
     'help.option.repo.target': string;
     'help.option.context.uid': string;
     'help.option.context.file': string;
+    'help.option.impact.kind': string;
     'help.option.impact.direction': string;
     'help.option.impact.depth': string;
     'help.option.impact.includeTests': string;

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

@@ -41,8 +41,9 @@ export const zhCN = {
     'tool.noIndexed': 'GitNexus：未找到已索引仓库。请运行：gitnexus analyze',
     'tool.usage.query': '用法：gitnexus query <搜索词>',
     'tool.usage.context': '用法：gitnexus context <符号名> [--uid <uid>] [--file <路径>]',
-    'tool.usage.impact': '用法：gitnexus impact <符号名> [--direction upstream|downstream]',
+    'tool.usage.impact': '用法：gitnexus impact <符号名> [--uid <uid>] [--file <路径>] [--kind <类型>] [--direction upstream|downstream]',
     'tool.usage.cypher': '用法：gitnexus cypher <Cypher 查询>',
+    'tool.warn.unknownKind': "--kind '{{kind}}' 不是已知的符号类型（如 Function、Class、Method），不会用于缩小结果范围。",
     'tool.detectChanges.noChanges': '未检测到变更。',
     'tool.detectChanges.changesSummary': '变更：{{files}} 个文件，{{symbols}} 个符号',
     'tool.detectChanges.affectedProcesses': '受影响流程：{{count}}',
@@ -177,6 +178,7 @@ export const zhCN = {
     'help.option.repo.target': '目标仓库',
     'help.option.context.uid': '直接符号 UID（零歧义查找）',
     'help.option.context.file': '用于消除常见名称歧义的文件路径',
+    'help.option.impact.kind': '用于消除常见名称歧义的类型过滤（如 Function、Class、Method）',
     'help.option.impact.direction': 'upstream（依赖它的项）或 downstream（它依赖的项）',
     'help.option.impact.depth': '最大关系遍历深度（默认：3）',
     'help.option.impact.includeTests': '在结果中包含测试文件',

package/dist/cli/index.js

@@ -142,10 +142,13 @@ program
     .option('--content', 'Include full symbol source code')
     .action(createLbugLazyAction(() => import('./tool.js'), 'contextCommand'));
 program
-    .command('impact <target>')
+    .command('impact [target]')
     .description('Blast radius analysis: what breaks if you change a symbol')
     .option('-d, --direction <dir>', 'upstream (dependants) or downstream (dependencies)', 'upstream')
     .option('-r, --repo <name>', 'Target repository')
+    .option('-u, --uid <uid>', 'Direct symbol UID (zero-ambiguity lookup)')
+    .option('-f, --file <path>', 'File path to disambiguate common names')
+    .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)')

package/dist/cli/tool.d.ts

@@ -27,9 +27,12 @@ export declare function contextCommand(name: string, options?: {
     uid?: string;
     content?: boolean;
 }): Promise<void>;
-export declare function impactCommand(target: string, options?: {
+export declare function impactCommand(target?: string, options?: {
     direction?: string;
     repo?: string;
+    uid?: string;
+    file?: string;
+    kind?: string;
     depth?: string;
     includeTests?: boolean;
     limit?: string;

package/dist/cli/tool.js

@@ -15,8 +15,8 @@
  * See the output() function for details (#324).
  */
 import { writeSync } from 'node:fs';
-import { LocalBackend } from '../mcp/local/local-backend.js';
-import { cliErrorKey } from './cli-message.js';
+import { LocalBackend, VALID_NODE_LABELS } from '../mcp/local/local-backend.js';
+import { cliErrorKey, cliWarnKey } from './cli-message.js';
 import { formatDetectChangesResult } from './detect-changes-format.js';
 let _backend = null;
 async function getBackend() {
@@ -72,6 +72,11 @@ export async function queryCommand(queryText, options) {
     output(result);
 }
 export async function contextCommand(name, options) {
+    // Reject a `--`-prefixed uid swallowed from a following flag (see impactCommand).
+    if (options?.uid?.startsWith('--')) {
+        cliErrorKey('tool.usage.context');
+        process.exit(1);
+    }
     if (!name?.trim() && !options?.uid) {
         cliErrorKey('tool.usage.context');
         process.exit(1);
@@ -87,10 +92,25 @@ export async function contextCommand(name, options) {
     output(result);
 }
 export async function impactCommand(target, options) {
-    if (!target?.trim()) {
+    // A `--`-prefixed uid means Commander swallowed a following flag as the uid
+    // value (e.g. `impact --uid --file x` → uid === '--file'). Reject it rather
+    // than forwarding a garbage uid that would silently resolve to not-found.
+    if (options?.uid?.startsWith('--')) {
         cliErrorKey('tool.usage.impact');
         process.exit(1);
     }
+    // Target is an optional positional: a uid alone is enough to resolve (parity
+    // with `context [name]`). Only error when neither a target nor a uid is given.
+    if (!target?.trim() && !options?.uid) {
+        cliErrorKey('tool.usage.impact');
+        process.exit(1);
+    }
+    // Soft-validate --kind: an unknown kind is a no-op hint (the backend scores
+    // it but it matches nothing), so warn and proceed rather than rejecting —
+    // parity with the lenient MCP surface and forward-compatible with new labels.
+    if (options?.kind && !VALID_NODE_LABELS.has(options.kind)) {
+        cliWarnKey('tool.warn.unknownKind', { kind: options.kind });
+    }
     try {
         const backend = await getBackend();
         const rawLimit = parseInt(options?.limit ?? '', 10);
@@ -98,7 +118,10 @@ export async function impactCommand(target, options) {
         const parsedLimit = Number.isFinite(rawLimit) ? rawLimit : undefined;
         const parsedOffset = Number.isFinite(rawOffset) ? rawOffset : undefined;
         const result = await backend.callTool('impact', {
-            target,
+            target: target || undefined,
+            target_uid: options?.uid,
+            file_path: options?.file,
+            kind: options?.kind,
             direction: options?.direction || 'upstream',
             maxDepth: options?.depth ? parseInt(options.depth, 10) : undefined,
             includeTests: options?.includeTests ?? false,

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

@@ -2379,8 +2379,14 @@ export class LocalBackend {
         const rawOffset = typeof opts.offset === 'number' && Number.isFinite(opts.offset) ? opts.offset : 0;
         const paginationOffset = Math.max(0, Math.trunc(rawOffset));
         const summaryOnly = opts.summaryOnly ?? false;
-        const relTypeFilter = relationTypes.map((t) => `'${t}'`).join(', ');
-        const confidenceFilter = minConfidence > 0 ? ` AND r.confidence >= ${minConfidence}` : '';
+        // Bind the BFS frontier query's filters as parameters (#1907 review F5):
+        // node ids and relation types as bound lists, the confidence floor as a
+        // bound number — no string interpolation reaches the query text. Preserve
+        // the original "no confidence clause when minConfidence <= 0" behavior: an
+        // unconditional `>= 0` would wrongly exclude NULL-confidence edges that the
+        // unfiltered query includes.
+        const safeMinConfidence = Number.isFinite(minConfidence) ? minConfidence : 0;
+        const confidenceFilter = safeMinConfidence > 0 ? ' AND r.confidence >= $minConfidence' : '';
         const symId = sym.id || sym[0];
         const impacted = [];
         const visited = new Set([symId]);
@@ -2449,13 +2455,17 @@ export class LocalBackend {
         }
         for (let depth = 1; depth <= maxDepth && frontier.length > 0; depth++) {
             const nextFrontier = [];
-            // Batch frontier nodes into a single Cypher query per depth level
-            const idList = frontier.map((id) => `'${id.replace(/'/g, "''")}'`).join(', ');
+            // Batch frontier nodes into a single Cypher query per depth level.
+            // ids/types/confidence are bound parameters (see above) — no interpolation.
             const query = direction === 'upstream'
-                ? `MATCH (caller)-[r:CodeRelation]->(n) WHERE n.id IN [${idList}] AND r.type IN [${relTypeFilter}]${confidenceFilter} RETURN n.id AS sourceId, caller.id AS id, caller.name AS name, labels(caller)[0] AS type, caller.filePath AS filePath, r.type AS relType, r.confidence AS confidence`
-                : `MATCH (n)-[r:CodeRelation]->(callee) WHERE n.id IN [${idList}] AND r.type IN [${relTypeFilter}]${confidenceFilter} RETURN n.id AS sourceId, callee.id AS id, callee.name AS name, labels(callee)[0] AS type, callee.filePath AS filePath, r.type AS relType, r.confidence AS confidence`;
+                ? `MATCH (caller)-[r:CodeRelation]->(n) WHERE n.id IN $frontierIds AND r.type IN $relTypes${confidenceFilter} RETURN n.id AS sourceId, caller.id AS id, caller.name AS name, labels(caller)[0] AS type, caller.filePath AS filePath, r.type AS relType, r.confidence AS confidence`
+                : `MATCH (n)-[r:CodeRelation]->(callee) WHERE n.id IN $frontierIds AND r.type IN $relTypes${confidenceFilter} RETURN n.id AS sourceId, callee.id AS id, callee.name AS name, labels(callee)[0] AS type, callee.filePath AS filePath, r.type AS relType, r.confidence AS confidence`;
             try {
-                const related = await executeQuery(repo.id, query);
+                const related = await executeParameterized(repo.id, query, {
+                    frontierIds: frontier,
+                    relTypes: relationTypes,
+                    ...(safeMinConfidence > 0 ? { minConfidence: safeMinConfidence } : {}),
+                });
                 for (const rel of related) {
                     const relId = rel.id || rel[1];
                     const filePath = rel.filePath || rel[4] || '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.6.6-rc.96",
+  "version": "1.6.6-rc.97",
   "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",