xray-code 0.1.1 → 0.1.2

package/dist/cli.js

@@ -19,6 +19,7 @@ const commander_1 = require("commander");
 const auth_js_1 = require("./auth.js");
 const onboard_js_1 = require("./onboard.js");
 const client_js_1 = require("./client.js");
+const install_js_1 = require("./install.js");
 const program = new commander_1.Command()
     .name("xray")
     .description("X-ray your codebase — instant cross-references and impact analysis")
@@ -109,10 +110,12 @@ program
         catch {
             console.log(`\n  GitHub login skipped — you can run 'npx xray-code login' later.\n`);
         }
-        // Step 3: Show connection status
+        // Step 3: Install Claude Code integration in current project
         const client = new client_js_1.XRayClient(data.server, data.api_key);
         try {
             const health = await client.health();
+            console.log(`\n  Setting up Claude Code integration...\n`);
+            (0, install_js_1.installClaude)(process.cwd(), data.server, data.api_key, data.space, health.symbols, health.uses);
             console.log(`\n  ══════════════════════════════════════════════════`);
             console.log(`  XRay is ready!`);
             console.log(`  ══════════════════════════════════════════════════\n`);
@@ -120,7 +123,9 @@ program
             console.log(`  Symbols:  ${health.symbols.toLocaleString()}`);
             console.log(`  Refs:     ${health.uses.toLocaleString()}`);
             console.log(`  Files:    ${health.files.toLocaleString()}\n`);
-            console.log(`  Try these commands:`);
+            console.log(`  Your Claude Code agent now has ambient code intelligence.`);
+            console.log(`  Every Grep/Glob search automatically gets cross-reference context.\n`);
+            console.log(`  Manual commands:`);
             console.log(`    npx xray-code search <symbol-name>`);
             console.log(`    npx xray-code who-uses <symbol-name>`);
             console.log(`    npx xray-code impact <symbol-name>`);

package/dist/install.d.ts

@@ -0,0 +1,10 @@
+/**
+ * XRay Claude Code integration installer.
+ *
+ * After activation, installs:
+ *   .claude/hooks/xray-inject.sh   — ambient code intelligence on Grep/Glob
+ *   .claude/settings.json          — registers the hook
+ *   CLAUDE.md                      — adds XRay section
+ *   .claude/memory/xray.md         — memory file for AI context
+ */
+export declare function installClaude(projectDir: string, server: string, apiKey: string, space: string, symbols: number, refs: number): void;

package/dist/install.js

@@ -0,0 +1,265 @@
+"use strict";
+/**
+ * XRay Claude Code integration installer.
+ *
+ * After activation, installs:
+ *   .claude/hooks/xray-inject.sh   — ambient code intelligence on Grep/Glob
+ *   .claude/settings.json          — registers the hook
+ *   CLAUDE.md                      — adds XRay section
+ *   .claude/memory/xray.md         — memory file for AI context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.installClaude = installClaude;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const HOOK_SCRIPT = `#!/usr/bin/env bash
+# XRay Code Intelligence — ambient cross-reference injection
+#
+# PreToolUse:Grep|Glob
+#
+# When Claude searches for something, this hook queries the XRay API
+# and injects cross-reference context automatically.
+
+set -uo pipefail
+
+XRAY_SERVER="\${XRAY_SERVER:-__XRAY_SERVER__}"
+XRAY_KEY="\${XRAY_API_KEY:-__XRAY_KEY__}"
+MAX_SYMBOLS=3
+RATE_LIMIT_SECONDS=5
+RATE_FILE="/tmp/.xray-inject-last"
+
+RAW_INPUT=""
+if [[ -t 0 ]]; then
+  RAW_INPUT="\${1:-}"
+else
+  RAW_INPUT=$(cat)
+fi
+
+[[ -z "$RAW_INPUT" ]] && exit 0
+command -v jq &>/dev/null || exit 0
+command -v curl &>/dev/null || exit 0
+
+TOOL_NAME=$(echo "$RAW_INPUT" | jq -r '.tool_name // empty' 2>/dev/null) || exit 0
+if [[ "$TOOL_NAME" != "Grep" ]] && [[ "$TOOL_NAME" != "Glob" ]]; then
+  exit 0
+fi
+
+PATTERN=$(echo "$RAW_INPUT" | jq -r '.tool_input.pattern // empty' 2>/dev/null) || exit 0
+[[ -z "$PATTERN" ]] && exit 0
+
+SEARCH_TERM="$PATTERN"
+SEARCH_TERM="\${SEARCH_TERM//\\*/}"
+SEARCH_TERM="\${SEARCH_TERM//\\?/}"
+SEARCH_TERM="\${SEARCH_TERM//\\^/}"
+SEARCH_TERM="\${SEARCH_TERM//$/}"
+SEARCH_TERM="\${SEARCH_TERM//\\\\b/}"
+SEARCH_TERM="\${SEARCH_TERM//\\\\s+/ }"
+SEARCH_TERM="\${SEARCH_TERM//\\\\w+/}"
+SEARCH_TERM="\${SEARCH_TERM//\\.\\*/}"
+SEARCH_TERM="\${SEARCH_TERM//\\(/}"
+SEARCH_TERM="\${SEARCH_TERM//\\)/}"
+SEARCH_TERM="\${SEARCH_TERM//\\[/}"
+SEARCH_TERM="\${SEARCH_TERM//\\]/}"
+SEARCH_TERM="\${SEARCH_TERM//\\{/}"
+SEARCH_TERM="\${SEARCH_TERM//\\}/}"
+SEARCH_TERM="\${SEARCH_TERM//|/}"
+SEARCH_TERM=$(echo "$SEARCH_TERM" | sed 's|.*/||')
+SEARCH_TERM="\${SEARCH_TERM//\\./}"
+SEARCH_TERM=$(echo "$SEARCH_TERM" | xargs)
+
+if [[ "$SEARCH_TERM" == *" "* ]]; then
+  LONGEST=""
+  for word in $SEARCH_TERM; do
+    if [[ \${#word} -gt \${#LONGEST} ]]; then
+      LONGEST="$word"
+    fi
+  done
+  SEARCH_TERM="$LONGEST"
+fi
+
+[[ \${#SEARCH_TERM} -lt 4 ]] && exit 0
+
+case "\${SEARCH_TERM,,}" in
+  import|require|function|class|struct|enum|trait|interface|const|type|return|async|await|pub|fn|let|mut|self|impl|use|mod|crate)
+    exit 0 ;;
+esac
+
+NOW=$(date +%s)
+if [[ -f "$RATE_FILE" ]]; then
+  LAST=$(cat "$RATE_FILE" 2>/dev/null || echo "0")
+  if (( NOW - LAST < RATE_LIMIT_SECONDS )); then
+    exit 0
+  fi
+fi
+
+CURL_ARGS=(-s --max-time 3)
+if [[ -n "$XRAY_KEY" ]]; then
+  CURL_ARGS+=(-H "X-FoxRef-Key: $XRAY_KEY")
+fi
+
+SEARCH_OUTPUT=$(curl "\${CURL_ARGS[@]}" "\${XRAY_SERVER}/api/v1/search?q=\${SEARCH_TERM}&limit=\${MAX_SYMBOLS}" 2>/dev/null) || exit 0
+[[ -z "$SEARCH_OUTPUT" ]] && exit 0
+
+TOTAL=$(echo "$SEARCH_OUTPUT" | jq -r '.count // 0' 2>/dev/null)
+[[ "$TOTAL" == "0" ]] && exit 0
+
+echo "$NOW" > "$RATE_FILE" 2>/dev/null || true
+
+CONTEXT="XRAY: Pattern '\${SEARCH_TERM}' matches \${TOTAL} indexed symbol(s).\\n"
+
+echo "$SEARCH_OUTPUT" | jq -r '.results[] | "  \\(.name) (\\(.file):\\(.line))"' 2>/dev/null | while IFS= read -r line; do
+  CONTEXT="\${CONTEXT}\${line}\\n"
+done
+
+TOP_SYMBOL=$(echo "$SEARCH_OUTPUT" | jq -r '.results[0].name // empty' 2>/dev/null)
+if [[ -n "$TOP_SYMBOL" ]]; then
+  USES_OUTPUT=$(curl "\${CURL_ARGS[@]}" "\${XRAY_SERVER}/api/v1/who-uses?symbol=\${TOP_SYMBOL}&limit=3" 2>/dev/null) || true
+  if [[ -n "$USES_OUTPUT" ]]; then
+    USES_COUNT=$(echo "$USES_OUTPUT" | jq -r '.count // 0' 2>/dev/null)
+    if [[ "$USES_COUNT" != "0" ]]; then
+      CONTEXT="\${CONTEXT}Top symbol '\${TOP_SYMBOL}' has \${USES_COUNT} cross-references.\\n"
+      echo "$USES_OUTPUT" | jq -r '.hits[:3][] | "    [\\(if .is_heuristic then "heuristic" else "exact" end)] \\(.source_file):\\(.source_line)"' 2>/dev/null | while IFS= read -r line; do
+        CONTEXT="\${CONTEXT}\${line}\\n"
+      done
+      CONTEXT="\${CONTEXT}Run: npx xray-code who-uses \${TOP_SYMBOL} | npx xray-code impact \${TOP_SYMBOL}"
+    fi
+  fi
+fi
+
+ESCAPED_CONTEXT=$(printf '%s' "$CONTEXT" | jq -Rs '.')
+
+cat << EOF
+{
+  "hookSpecificOutput": {
+    "hookEventName": "PreToolUse",
+    "additionalContext": $ESCAPED_CONTEXT
+  }
+}
+EOF
+`;
+function claudeMdSection(space, symbols, refs) {
+    return `## Code Intelligence (XRay)
+
+This project has a code intelligence index at \`xray.proven.dev\`.
+${symbols.toLocaleString()} symbols and ${refs.toLocaleString()} cross-references indexed, updated on every push.
+
+### Commands
+\`\`\`bash
+npx xray-code search <query>           # Fuzzy search for symbols by name
+npx xray-code who-uses <symbol>        # Find all usages of a symbol
+npx xray-code impact <symbol>          # What breaks if I change this?
+npx xray-code symbols-in <file>        # List symbols defined in a file
+npx xray-code health                   # Check index status
+\`\`\`
+
+All commands support \`--json\` for machine-readable output.
+
+### Ambient Intelligence (Automatic)
+
+A hook automatically queries XRay when you search with Grep or Glob.
+You don't need to call xray-code explicitly — it enriches your searches automatically.
+
+### Rules
+- XRay data is **exact** — never approximate or infer on top of it
+- Always check \`impact\` before refactoring shared symbols
+- The index auto-rebuilds on every push to main (webhook)
+`;
+}
+function memoryContent(server) {
+    return `---
+name: xray-code-intelligence
+description: XRay code intelligence at ${server} — symbol search, cross-references, impact analysis
+type: reference
+---
+
+## XRay Code Intelligence
+
+- **URL:** ${server}
+- **What:** Code intelligence index — instant cross-references across the entire codebase
+- **Commands:** npx xray-code search, who-uses, impact, symbols-in, health
+- **Hook:** .claude/hooks/xray-inject.sh auto-injects context on Grep/Glob
+- **Updated:** Index refreshes automatically when code is pushed to GitHub
+- **Note:** All commands support --json flag for structured output
+`;
+}
+function installClaude(projectDir, server, apiKey, space, symbols, refs) {
+    const claudeDir = (0, node_path_1.join)(projectDir, ".claude");
+    const hooksDir = (0, node_path_1.join)(claudeDir, "hooks");
+    const memoryDir = (0, node_path_1.join)(claudeDir, "memory");
+    const settingsPath = (0, node_path_1.join)(claudeDir, "settings.json");
+    const claudeMdPath = (0, node_path_1.join)(projectDir, "CLAUDE.md");
+    const hookPath = (0, node_path_1.join)(hooksDir, "xray-inject.sh");
+    const memoryPath = (0, node_path_1.join)(memoryDir, "xray.md");
+    (0, node_fs_1.mkdirSync)(hooksDir, { recursive: true });
+    (0, node_fs_1.mkdirSync)(memoryDir, { recursive: true });
+    // 1. Write hook script
+    const hookContent = HOOK_SCRIPT
+        .replace("__XRAY_SERVER__", server)
+        .replace("__XRAY_KEY__", apiKey);
+    (0, node_fs_1.writeFileSync)(hookPath, hookContent, { mode: 0o755 });
+    console.log(`  Created: ${hookPath}`);
+    // 2. Update .claude/settings.json
+    let settings = {};
+    if ((0, node_fs_1.existsSync)(settingsPath)) {
+        try {
+            settings = JSON.parse((0, node_fs_1.readFileSync)(settingsPath, "utf-8"));
+        }
+        catch { /* start fresh */ }
+    }
+    if (!settings.hooks || typeof settings.hooks !== "object" || Array.isArray(settings.hooks)) {
+        settings.hooks = {};
+    }
+    const hooks = settings.hooks;
+    const preToolUse = hooks.PreToolUse || [];
+    const hookExists = preToolUse.some((group) => {
+        const groupHooks = group.hooks;
+        return groupHooks?.some((h) => h.command && String(h.command).includes("xray-inject"));
+    });
+    if (!hookExists) {
+        preToolUse.push({
+            matcher: "Grep|Glob",
+            hooks: [
+                {
+                    type: "command",
+                    command: hookPath,
+                    timeout: 5000,
+                    statusMessage: "XRay: injecting code intelligence...",
+                },
+            ],
+        });
+        hooks.PreToolUse = preToolUse;
+        (0, node_fs_1.writeFileSync)(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+        console.log(`  Updated: ${settingsPath}`);
+    }
+    else {
+        console.log(`  Skipped: ${settingsPath} (hook already installed)`);
+    }
+    // 3. Update CLAUDE.md
+    const SECTION_START = "<!-- XRAY_START -->";
+    const SECTION_END = "<!-- XRAY_END -->";
+    const section = claudeMdSection(space, symbols, refs);
+    const wrappedSection = `${SECTION_START}\n${section}\n${SECTION_END}`;
+    if ((0, node_fs_1.existsSync)(claudeMdPath)) {
+        let existing = (0, node_fs_1.readFileSync)(claudeMdPath, "utf-8");
+        if (existing.includes(SECTION_START)) {
+            const startIdx = existing.indexOf(SECTION_START);
+            const endIdx = existing.indexOf(SECTION_END);
+            if (endIdx > startIdx) {
+                existing = existing.slice(0, startIdx) + wrappedSection + existing.slice(endIdx + SECTION_END.length);
+                (0, node_fs_1.writeFileSync)(claudeMdPath, existing);
+                console.log(`  Updated: ${claudeMdPath} (replaced XRay section)`);
+            }
+        }
+        else {
+            (0, node_fs_1.writeFileSync)(claudeMdPath, existing + "\n" + wrappedSection);
+            console.log(`  Updated: ${claudeMdPath} (appended XRay section)`);
+        }
+    }
+    else {
+        (0, node_fs_1.writeFileSync)(claudeMdPath, `# Project Instructions\n\n${wrappedSection}`);
+        console.log(`  Created: ${claudeMdPath}`);
+    }
+    // 4. Write memory file
+    (0, node_fs_1.writeFileSync)(memoryPath, memoryContent(server));
+    console.log(`  Created: ${memoryPath}`);
+}

package/dist/onboard.js

@@ -106,7 +106,7 @@ async function onboard(repoFilter) {
     console.log(`\n  Selected: ${repo.full_name}\n`);
     // ─── Step 2: Clone ────────────────────────────────────────────
     const repoName = (0, node_path_1.basename)(repo.full_name);
-    const cloneDir = (0, node_path_1.join)((0, node_os_1.homedir)(), "Code", repoName);
+    const cloneDir = (0, node_path_1.join)((0, node_os_1.homedir)(), "Code", "xray-tenants", repoName);
     if ((0, node_fs_1.existsSync)(cloneDir)) {
         console.log(`  Repo already exists at ${cloneDir} — pulling latest...`);
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xray-code",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "XRay — code intelligence CLI. X-ray your codebase with instant cross-references.",
   "bin": {
     "xray": "dist/cli.js"