gitnexus 1.3.6 → 1.3.8

package/dist/storage/repo-manager.js

@@ -151,7 +151,13 @@ export const registerRepo = async (repoPath, meta) => {
     const name = path.basename(resolved);
     const { storagePath } = getStoragePaths(resolved);
     const entries = await readRegistry();
-    const existing = entries.findIndex((e) => path.resolve(e.path) === resolved);
+    const existing = entries.findIndex((e) => {
+        const a = path.resolve(e.path);
+        const b = resolved;
+        return process.platform === 'win32'
+            ? a.toLowerCase() === b.toLowerCase()
+            : a === b;
+    });
     const entry = {
         name,
         path: resolved,
@@ -227,5 +233,13 @@ export const loadCLIConfig = async () => {
 export const saveCLIConfig = async (config) => {
     const dir = getGlobalDir();
     await fs.mkdir(dir, { recursive: true });
-    await fs.writeFile(getGlobalConfigPath(), JSON.stringify(config, null, 2), 'utf-8');
+    const configPath = getGlobalConfigPath();
+    await fs.writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    // Restrict file permissions on Unix (config may contain API keys)
+    if (process.platform !== 'win32') {
+        try {
+            await fs.chmod(configPath, 0o600);
+        }
+        catch { /* best-effort */ }
+    }
 };

package/hooks/claude/gitnexus-hook.cjs

@@ -101,20 +101,40 @@ function main() {
     const pattern = extractPattern(toolName, toolInput);
     if (!pattern || pattern.length < 3) return;
 
-    // Resolve CLI path relative to this hook script (same package)
-    // hooks/claude/gitnexus-hook.cjs → dist/cli/index.js
-    const cliPath = path.resolve(__dirname, '..', '..', 'dist', 'cli', 'index.js');
+    // Resolve CLI path — try multiple strategies:
+    // 1. Relative path (works when script is inside npm package)
+    // 2. require.resolve (works when gitnexus is globally installed)
+    // 3. Fall back to npx (works when neither is available)
+    let cliPath = path.resolve(__dirname, '..', '..', 'dist', 'cli', 'index.js');
+    if (!fs.existsSync(cliPath)) {
+      try {
+        cliPath = require.resolve('gitnexus/dist/cli/index.js');
+      } catch {
+        cliPath = ''; // will use npx fallback
+      }
+    }
 
     // augment CLI writes result to stderr (KuzuDB's native module captures
     // stdout fd at OS level, making it unusable in subprocess contexts).
     const { spawnSync } = require('child_process');
     let result = '';
     try {
-      const child = spawnSync(
-        process.execPath,
-        [cliPath, 'augment', pattern],
-        { encoding: 'utf-8', timeout: 8000, cwd, stdio: ['pipe', 'pipe', 'pipe'] }
-      );
+      let child;
+      if (cliPath) {
+        child = spawnSync(
+          process.execPath,
+          [cliPath, 'augment', pattern],
+          { encoding: 'utf-8', timeout: 8000, cwd, stdio: ['pipe', 'pipe', 'pipe'] }
+        );
+      } else {
+        // npx fallback
+        const cmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+        child = spawnSync(
+          cmd,
+          ['-y', 'gitnexus', 'augment', pattern],
+          { encoding: 'utf-8', timeout: 15000, cwd, stdio: ['pipe', 'pipe', 'pipe'] }
+        );
+      }
       result = child.stderr || '';
     } catch { /* graceful failure */ }
 

package/hooks/claude/pre-tool-use.sh

@@ -63,7 +63,8 @@ if [ "$found" = false ]; then
 fi
 
 # Run gitnexus augment — must be fast (<500ms target)
-RESULT=$(cd "$CWD" && npx -y gitnexus augment "$PATTERN" 2>/dev/null)
+# augment writes to stderr (KuzuDB captures stdout at OS level), so capture stderr and discard stdout
+RESULT=$(cd "$CWD" && npx -y gitnexus augment "$PATTERN" 2>&1 1>/dev/null)
 
 if [ -n "$RESULT" ]; then
   ESCAPED=$(echo "$RESULT" | jq -Rs .)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitnexus",
-  "version": "1.3.6",
+  "version": "1.3.8",
   "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",
@@ -39,6 +39,11 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsx watch src/cli/index.ts",
+    "test": "vitest run test/unit",
+    "test:integration": "vitest run test/integration",
+    "test:all": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
     "prepare": "npm run build",
     "postinstall": "node scripts/patch-tree-sitter-swift.cjs"
   },
@@ -64,11 +69,11 @@
     "tree-sitter-go": "^0.21.0",
     "tree-sitter-java": "^0.21.0",
     "tree-sitter-javascript": "^0.21.0",
+    "tree-sitter-kotlin": "^0.3.8",
     "tree-sitter-php": "^0.23.12",
     "tree-sitter-python": "^0.21.0",
     "tree-sitter-rust": "^0.21.0",
     "tree-sitter-typescript": "^0.21.0",
-    "typescript": "^5.4.5",
     "uuid": "^13.0.0"
   },
   "optionalDependencies": {
@@ -80,7 +85,10 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.0.0",
     "@types/uuid": "^10.0.0",
-    "tsx": "^4.0.0"
+    "@vitest/coverage-v8": "^4.0.18",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.5",
+    "vitest": "^4.0.18"
   },
   "engines": {
     "node": ">=18.0.0"

package/dist/cli/claude-hooks.d.ts

@@ -1,22 +0,0 @@
-/**
- * Claude Code Hook Registration
- *
- * Registers the GitNexus PreToolUse hook in ~/.claude/hooks.json
- * so that grep/glob/bash calls are automatically augmented with
- * knowledge graph context.
- *
- * Idempotent — safe to call multiple times.
- */
-/**
- * Register (or verify) the GitNexus hook in Claude Code's global hooks.json.
- *
- * - Creates ~/.claude/ and hooks.json if they don't exist
- * - Preserves existing hooks from other tools
- * - Skips if GitNexus hook is already registered
- *
- * Returns a status message for the CLI output.
- */
-export declare function registerClaudeHook(): Promise<{
-    registered: boolean;
-    message: string;
-}>;

package/dist/cli/claude-hooks.js

@@ -1,97 +0,0 @@
-/**
- * Claude Code Hook Registration
- *
- * Registers the GitNexus PreToolUse hook in ~/.claude/hooks.json
- * so that grep/glob/bash calls are automatically augmented with
- * knowledge graph context.
- *
- * Idempotent — safe to call multiple times.
- */
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import { fileURLToPath } from 'url';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-/**
- * Get the absolute path to the gitnexus-hook.js file.
- * Works for both local dev and npm-installed packages.
- */
-function getHookScriptPath() {
-    // From dist/cli/claude-hooks.js → hooks/claude/gitnexus-hook.js
-    const packageRoot = path.resolve(__dirname, '..', '..');
-    return path.join(packageRoot, 'hooks', 'claude', 'gitnexus-hook.cjs');
-}
-/**
- * Register (or verify) the GitNexus hook in Claude Code's global hooks.json.
- *
- * - Creates ~/.claude/ and hooks.json if they don't exist
- * - Preserves existing hooks from other tools
- * - Skips if GitNexus hook is already registered
- *
- * Returns a status message for the CLI output.
- */
-export async function registerClaudeHook() {
-    const claudeDir = path.join(os.homedir(), '.claude');
-    const hooksFile = path.join(claudeDir, 'hooks.json');
-    const hookScript = getHookScriptPath();
-    // Check if the hook script exists
-    try {
-        await fs.access(hookScript);
-    }
-    catch {
-        return { registered: false, message: 'Hook script not found (package may be incomplete)' };
-    }
-    // Build the hook command — use node + absolute path for reliability
-    const hookCommand = `node "${hookScript}"`;
-    // Check if ~/.claude/ exists (user has Claude Code installed)
-    try {
-        await fs.access(claudeDir);
-    }
-    catch {
-        // No Claude Code installation — skip silently
-        return { registered: false, message: 'Claude Code not detected (~/.claude/ not found)' };
-    }
-    // Read existing hooks.json or start fresh
-    let hooksConfig = {};
-    try {
-        const existing = await fs.readFile(hooksFile, 'utf-8');
-        hooksConfig = JSON.parse(existing);
-    }
-    catch {
-        // File doesn't exist or is invalid — we'll create it
-    }
-    // Ensure the hooks structure exists
-    if (!hooksConfig.hooks) {
-        hooksConfig.hooks = {};
-    }
-    if (!Array.isArray(hooksConfig.hooks.PreToolUse)) {
-        hooksConfig.hooks.PreToolUse = [];
-    }
-    // Check if GitNexus hook is already registered
-    const existingEntry = hooksConfig.hooks.PreToolUse.find((entry) => {
-        if (!entry.hooks || !Array.isArray(entry.hooks))
-            return false;
-        return entry.hooks.some((h) => h.command && (h.command.includes('gitnexus-hook') ||
-            h.command.includes('gitnexus augment')));
-    });
-    if (existingEntry) {
-        return { registered: true, message: 'Claude Code hook already registered' };
-    }
-    // Add the GitNexus hook entry
-    hooksConfig.hooks.PreToolUse.push({
-        matcher: {
-            tool_name: "Grep|Glob|Bash"
-        },
-        hooks: [
-            {
-                type: "command",
-                command: hookCommand,
-                timeout: 8000
-            }
-        ]
-    });
-    // Write back
-    await fs.writeFile(hooksFile, JSON.stringify(hooksConfig, null, 2) + '\n', 'utf-8');
-    return { registered: true, message: 'Claude Code hook registered' };
-}

package/dist/cli/view.d.ts

@@ -1,13 +0,0 @@
-/**
- * View Command
- *
- * Generates a self-contained graph.html from the KuzuDB index and
- * opens it in the default browser.
- *
- * Usage: gitnexus view [path] [--no-open]
- */
-export interface ViewCommandOptions {
-    noOpen?: boolean;
-    output?: string;
-}
-export declare const viewCommand: (inputPath?: string, options?: ViewCommandOptions) => Promise<void>;

package/dist/cli/view.js

@@ -1,59 +0,0 @@
-/**
- * View Command
- *
- * Generates a self-contained graph.html from the KuzuDB index and
- * opens it in the default browser.
- *
- * Usage: gitnexus view [path] [--no-open]
- */
-import path from 'path';
-import fs from 'fs/promises';
-import { exec } from 'child_process';
-import { findRepo } from '../storage/repo-manager.js';
-import { initKuzu } from '../core/kuzu/kuzu-adapter.js';
-import { buildGraph } from '../server/api.js';
-import { generateHTMLGraphViewer } from '../core/graph/html-graph-viewer.js';
-import { getCurrentCommit } from '../storage/git.js';
-function openInBrowser(filePath) {
-    const url = `file://${filePath}`;
-    let cmd;
-    if (process.platform === 'darwin') {
-        cmd = `open "${url}"`;
-    }
-    else if (process.platform === 'win32') {
-        cmd = `start "" "${url}"`;
-    }
-    else {
-        cmd = `xdg-open "${url}"`;
-    }
-    exec(cmd, (err) => {
-        if (err)
-            console.error('Failed to open browser:', err.message);
-    });
-}
-export const viewCommand = async (inputPath, options) => {
-    console.log('⚠ Experimental: gitnexus view is under active development.\n');
-    const repoPath = inputPath ? path.resolve(inputPath) : process.cwd();
-    const repo = await findRepo(repoPath);
-    if (!repo) {
-        console.error('No index found. Run: gitnexus analyze');
-        process.exit(1);
-    }
-    const currentCommit = getCurrentCommit(repo.repoPath);
-    if (currentCommit !== repo.meta.lastCommit) {
-        console.warn('Index is stale — showing last indexed state. Run: gitnexus analyze\n');
-    }
-    await initKuzu(repo.kuzuPath);
-    const { nodes, relationships } = await buildGraph();
-    const projectName = path.basename(repo.repoPath);
-    const outputPath = options?.output
-        ? path.resolve(options.output)
-        : path.join(repo.storagePath, 'graph.html');
-    const html = generateHTMLGraphViewer(nodes, relationships, projectName);
-    await fs.writeFile(outputPath, html, 'utf-8');
-    console.log(`Graph written to: ${outputPath}`);
-    console.log(`Nodes: ${nodes.length}  Edges: ${relationships.length}`);
-    if (!options?.noOpen) {
-        openInBrowser(outputPath);
-    }
-};

package/dist/core/graph/html-graph-viewer.d.ts

@@ -1,15 +0,0 @@
-/**
- * HTML Graph Viewer Generator
- *
- * Produces a self-contained graph.html that renders the knowledge graph
- * using Sigma.js v2 + graphology (both from CDN).
- *
- * Critical: node `content` fields are stripped before embedding to prevent
- * </script> injection from source code breaking the HTML parser.
- */
-import { GraphNode, GraphRelationship } from './types.js';
-/**
- * Generate a self-contained HTML file that renders the knowledge graph.
- * Strips large/unsafe fields from nodes before embedding.
- */
-export declare function generateHTMLGraphViewer(nodes: GraphNode[], relationships: GraphRelationship[], projectName: string): string;