purecontext-mcp 1.2.0 → 1.5.1

package/dist/cli/hooks.js

@@ -0,0 +1,570 @@
+/**
+ * `purecontext-mcp hooks --install` / `hooks --list`
+ * `purecontext-mcp hook-pretooluse|hook-posttooluse|hook-precompact|hook-worktree-create|hook-worktree-remove`
+ *
+ * Merges hook entries into ~/.claude/settings.json using CLI-style commands
+ * (npx purecontext-mcp hook-*) so no scripts need to be copied to ~/.claude/hooks/.
+ * Also injects PureContext agent instructions into ~/.claude/CLAUDE.md.
+ */
+import { spawnSync } from 'child_process';
+import { createRequire } from 'module';
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync, } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// ─── Paths ────────────────────────────────────────────────────────────────────
+const CLAUDE_DIR = join(homedir(), '.claude');
+const SETTINGS_PATH = join(CLAUDE_DIR, 'settings.json');
+const CLAUDE_MD_PATH = join(CLAUDE_DIR, 'CLAUDE.md');
+// ─── Settings entries ─────────────────────────────────────────────────────────
+const POST_TOOL_USE_ENTRY = {
+    matcher: 'Edit|Write|MultiEdit',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-posttooluse' }],
+};
+const PRE_COMPACT_ENTRY = {
+    matcher: '',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-precompact' }],
+};
+const PRE_TOOL_USE_ENTRY = {
+    matcher: 'Edit|Write|MultiEdit',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-pretooluse' }],
+};
+const WORKTREE_CREATE_ENTRY = {
+    matcher: '',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-worktree-create' }],
+};
+const WORKTREE_REMOVE_ENTRY = {
+    matcher: '',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-worktree-remove' }],
+};
+const TASK_COMPLETED_ENTRY = {
+    matcher: '',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-taskcompleted' }],
+};
+const SUBAGENT_START_ENTRY = {
+    matcher: '',
+    hooks: [{ type: 'command', command: 'npx purecontext-mcp hook-subagentstart' }],
+};
+// ─── CLAUDE.md block ──────────────────────────────────────────────────────────
+const CLAUDE_MD_BLOCK = `<!-- purecontext-mcp-start -->
+# PureContext MCP — AI Agent Instructions
+
+Full tool reference, navigation patterns, and known limitations: \`AGENT_REFERENCE.md\` in the project root (added by \`npx purecontext-mcp hooks --install\`).
+
+## Mandatory workflow — always follow this order
+
+**Step 1 — Check if the project is indexed**
+
+\`\`\`
+list_repos()
+\`\`\`
+
+If the project is missing: \`index_folder({ path: "/absolute/path/to/project" })\`. All other tools require a \`repoId\` — never skip this step.
+
+**Step 2 — Navigate by symbol, not by file**
+
+Do not read entire files to find code.
+
+| Goal | Tool |
+|------|------|
+| Find a function/class/method by name | \`search_symbols\` |
+| Find code by what it does | \`search_semantic\` |
+| Find a literal string, comment, or config value | \`search_text\` |
+| See all symbols in one file | \`get_file_outline\` |
+| See the whole project structure | \`get_repo_outline\` |
+| Understand a function's dependencies | \`get_context_bundle\` |
+| Know what breaks if I change a symbol | \`get_blast_radius\` |
+| Find all call sites for a symbol | \`find_references\` |
+| Survey a file before editing | \`get_file_outline\` |
+| Non-symbol file content (imports, config blocks) | \`get_file_content\` with startLine/endLine |
+| All implementations of an interface | \`find_implementations\` |
+| Callers/callees tree | \`get_call_hierarchy\` |
+| Class inheritance structure | \`get_class_hierarchy\` |
+| Circular dependencies | \`find_cycles\` |
+| Rename / delete / move safety check | \`check_rename_safe\` / \`check_delete_safe\` / \`check_move_safe\` |
+| Codebase health score | \`health_radar\` |
+| Detailed debt report | \`get_debt_report\` |
+| All TODOs and FIXMEs | \`get_todos\` |
+| Untested exported symbols | \`find_untested_symbols\` |
+| AST node type occurrences | \`search_ast\` |
+| Symbols by decorator | \`search_by_decorator\` |
+| Most complex functions | \`get_complexity_hotspots\` |
+
+**Step 3 — Read summaries before fetching source**
+
+\`search_symbols\` returns signatures and summaries — no source code. Read the \`summary\` field first. Fetch source only for symbols you will actually work with:
+
+\`\`\`
+get_symbol_source({ repoId, symbolId })
+\`\`\`
+
+Summaries describe intent, not contract. For modification tasks, always read the source after using the summary to navigate.
+
+## Anti-patterns — what NOT to do
+
+Do not read whole files to find a function. Use \`search_symbols\` + \`get_symbol_source\`.
+
+Do not call \`get_symbol_source\` for every search result. Read \`signature\` and \`summary\` first. Fetch source only for symbols you will work with.
+
+Do not skip \`list_repos\` at the start of a session. You need a \`repoId\` for every tool call.
+
+Do not use \`search_text\` for symbol lookups. It greps raw file content — slower and less precise than \`search_symbols\` for named code entities.
+
+Do not use \`get_file_content\` as a fallback for reading whole files. If a symbol exists in the index, use \`get_symbol_source\`.
+
+Do not ignore \`_tokenEstimate\` fields. Use them to decide whether to fetch more context or stop.
+
+Do not re-search when \`search_symbols\` returns \`negative_evidence\`. If the response includes \`verdict: "no_match"\`, the symbol does not exist — report the gap rather than trying five more query variants.
+<!-- purecontext-mcp-end -->`;
+// ─── Public install/list commands ─────────────────────────────────────────────
+export function cmdHooksInstall() {
+    mkdirSync(CLAUDE_DIR, { recursive: true });
+    mergeSettings();
+    injectClaudeMd();
+    console.log('\nHooks installed. Reopen Claude Code to activate them.\n');
+    console.log('Hooks registered (via npx purecontext-mcp hook-*):');
+    console.log('  PostToolUse  (hook-posttooluse):       re-indexes edited files automatically');
+    console.log('  PreCompact   (hook-precompact):        injects repo state before context compaction');
+    console.log('  PreToolUse   (hook-pretooluse):        suggests PureContext read tools before editing');
+    console.log('  WorktreeCreate  (hook-worktree-create):  auto-indexes new agent worktrees');
+    console.log('  WorktreeRemove  (hook-worktree-remove):  fires when an agent worktree is removed');
+    console.log('  TaskCompleted   (hook-taskcompleted):    post-task diagnostics and repo summary');
+    console.log('  SubagentStart   (hook-subagentstart):    injects repo orientation for spawned agents');
+}
+export function cmdHooksList() {
+    console.log('\nPureContext Claude Code hooks:\n');
+    const settingsStatus = areSettingsMerged() ? 'registered' : 'not configured';
+    console.log(`  settings.json hooks: ${settingsStatus}`);
+    console.log(`  CLAUDE.md block:     ${isClaudeMdInjected() ? 'present' : 'not present'}\n`);
+    if (areSettingsMerged()) {
+        console.log('  Active hooks:');
+        console.log('    PostToolUse   → npx purecontext-mcp hook-posttooluse');
+        console.log('    PreCompact    → npx purecontext-mcp hook-precompact');
+        console.log('    PreToolUse    → npx purecontext-mcp hook-pretooluse');
+        console.log('    WorktreeCreate → npx purecontext-mcp hook-worktree-create');
+        console.log('    WorktreeRemove → npx purecontext-mcp hook-worktree-remove');
+    }
+}
+// ─── Settings merge ───────────────────────────────────────────────────────────
+export function mergeSettings() {
+    let settings = {};
+    if (existsSync(SETTINGS_PATH)) {
+        try {
+            settings = JSON.parse(readFileSync(SETTINGS_PATH, 'utf-8'));
+        }
+        catch {
+            settings = {};
+        }
+    }
+    const hooks = (settings.hooks ?? {});
+    hooks.PostToolUse = mergeHookEntry(hooks.PostToolUse ?? [], POST_TOOL_USE_ENTRY, ['purecontext-index-hook.mjs', 'hook-posttooluse']);
+    hooks.PreCompact = mergeHookEntry(hooks.PreCompact ?? [], PRE_COMPACT_ENTRY, ['purecontext-precompact-hook.mjs', 'hook-precompact']);
+    hooks.PreToolUse = mergeHookEntry(hooks.PreToolUse ?? [], PRE_TOOL_USE_ENTRY, ['purecontext-edit-guard.mjs', 'hook-pretooluse']);
+    hooks.WorktreeCreate = mergeHookEntry((hooks.WorktreeCreate ?? []), WORKTREE_CREATE_ENTRY, ['hook-worktree-create']);
+    hooks.WorktreeRemove = mergeHookEntry((hooks.WorktreeRemove ?? []), WORKTREE_REMOVE_ENTRY, ['hook-worktree-remove']);
+    hooks.TaskCompleted = mergeHookEntry((hooks.TaskCompleted ?? []), TASK_COMPLETED_ENTRY, ['hook-taskcompleted']);
+    hooks.SubagentStart = mergeHookEntry((hooks.SubagentStart ?? []), SUBAGENT_START_ENTRY, ['hook-subagentstart']);
+    settings.hooks = hooks;
+    mkdirSync(dirname(SETTINGS_PATH), { recursive: true });
+    writeFileSync(SETTINGS_PATH, JSON.stringify(settings, null, 2) + '\n');
+    console.log(`  Updated: ${SETTINGS_PATH}`);
+}
+function mergeHookEntry(existing, entry, matchStrings) {
+    // Remove any existing purecontext entry for this hook type (idempotent).
+    // Matches both old .mjs script paths and current CLI command forms.
+    const filtered = existing.filter((e) => {
+        const hooks = e.hooks ?? [];
+        return !hooks.some((h) => {
+            const cmd = h.command ?? '';
+            return matchStrings.some((s) => cmd.includes(s));
+        });
+    });
+    return [...filtered, entry];
+}
+function areSettingsMerged() {
+    if (!existsSync(SETTINGS_PATH))
+        return false;
+    try {
+        const text = readFileSync(SETTINGS_PATH, 'utf-8');
+        return text.includes('hook-posttooluse') || text.includes('purecontext-index-hook.mjs');
+    }
+    catch {
+        return false;
+    }
+}
+// ─── CLAUDE.md injection ──────────────────────────────────────────────────────
+export function injectClaudeMd() {
+    const START_MARKER = '<!-- purecontext-mcp-start -->';
+    const END_MARKER = '<!-- purecontext-mcp-end -->';
+    if (!existsSync(CLAUDE_MD_PATH)) {
+        writeFileSync(CLAUDE_MD_PATH, CLAUDE_MD_BLOCK + '\n');
+        console.log(`  Created: ${CLAUDE_MD_PATH}`);
+        return;
+    }
+    let content = readFileSync(CLAUDE_MD_PATH, 'utf-8');
+    const startIdx = content.indexOf(START_MARKER);
+    const endIdx = content.indexOf(END_MARKER);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        content = content.slice(0, startIdx) + CLAUDE_MD_BLOCK + content.slice(endIdx + END_MARKER.length);
+    }
+    else {
+        if (!content.endsWith('\n'))
+            content += '\n';
+        content += '\n' + CLAUDE_MD_BLOCK + '\n';
+    }
+    writeFileSync(CLAUDE_MD_PATH, content);
+    console.log(`  Updated: ${CLAUDE_MD_PATH}`);
+}
+function isClaudeMdInjected() {
+    if (!existsSync(CLAUDE_MD_PATH))
+        return false;
+    try {
+        return readFileSync(CLAUDE_MD_PATH, 'utf-8').includes('<!-- purecontext-mcp-start -->');
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Hook command implementations ─────────────────────────────────────────────
+const ROOT_MARKERS = ['.git', 'package.json', 'Cargo.toml', 'go.mod', 'pom.xml'];
+function findRepoRoot(filePath) {
+    let dir = dirname(filePath);
+    while (true) {
+        for (const marker of ROOT_MARKERS) {
+            if (existsSync(join(dir, marker)))
+                return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function reindexRepo(repoRoot) {
+    spawnSync('npx', ['purecontext-mcp', 'index-folder', '--path', repoRoot], {
+        stdio: 'ignore',
+        timeout: 60_000,
+        shell: process.platform === 'win32',
+    });
+}
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+}
+/** PreToolUse: warn before Edit/Write/MultiEdit. */
+export async function cmdHookPreToolUse() {
+    if (process.env.PURECONTEXT_ALLOW_RAW_WRITE === '1')
+        process.exit(0);
+    try {
+        const input = await readStdin();
+        const toolName = (input.tool_name ?? '');
+        if (!['Edit', 'Write', 'MultiEdit'].includes(toolName))
+            process.exit(0);
+        const filePath = (input.tool_input?.file_path ?? '');
+        const target = filePath ? ` ${filePath}` : '';
+        process.stderr.write(`PureContext: before editing${target}, consider:\n` +
+            '  get_symbol_source   → confirm you are editing the right implementation\n' +
+            '  get_blast_radius    → understand what breaks if you change this\n' +
+            '  find_references     → find all call sites that may need updating\n');
+    }
+    catch { /* never block */ }
+    process.exit(0);
+}
+/** PostToolUse: re-index the repo after Edit/Write/MultiEdit. */
+export async function cmdHookPostToolUse() {
+    try {
+        const input = await readStdin();
+        const toolName = (input.tool_name ?? '');
+        const toolInput = (input.tool_input ?? {});
+        if (!['Edit', 'Write', 'MultiEdit'].includes(toolName))
+            process.exit(0);
+        const paths = [];
+        if (toolName === 'Edit' || toolName === 'Write') {
+            const fp = toolInput.file_path;
+            if (fp)
+                paths.push(fp);
+        }
+        else {
+            const edits = (toolInput.edits ?? []);
+            for (const edit of edits) {
+                const fp = edit.file_path;
+                if (fp)
+                    paths.push(fp);
+            }
+        }
+        const roots = new Set();
+        for (const fp of paths) {
+            const root = findRepoRoot(fp);
+            if (root)
+                roots.add(root);
+        }
+        for (const root of roots)
+            reindexRepo(root);
+    }
+    catch { /* never block the edit */ }
+    process.exit(0);
+}
+function readIndexedRepos() {
+    const base = process.env.PCTX_DATA_DIR ?? join(homedir(), '.purecontext');
+    const indexDir = join(base, 'indexes');
+    if (!existsSync(indexDir))
+        return [];
+    const _require = createRequire(import.meta.url);
+    let Database = null;
+    try {
+        Database = _require('better-sqlite3');
+    }
+    catch {
+        return [];
+    }
+    if (!Database)
+        return [];
+    const repos = [];
+    let files;
+    try {
+        files = readdirSync(indexDir).filter((f) => f.endsWith('.db'));
+    }
+    catch {
+        return [];
+    }
+    for (const file of files) {
+        let db;
+        try {
+            db = new Database(join(indexDir, file), { readonly: true });
+            const rows = db.prepare('SELECT id, root_path, file_count, indexed_at FROM repos LIMIT 50').all();
+            repos.push(...rows);
+        }
+        catch { /* skip unreadable db */ }
+        finally {
+            try {
+                db?.close();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    return repos;
+}
+function buildSessionSnapshot(repos) {
+    if (repos.length === 0) {
+        return [
+            'PureContext session snapshot:',
+            '- No repos currently indexed.',
+            '- Run index_folder({ path: "/absolute/path/to/project" }) to index a repo.',
+            '- Use list_repos() to check status after indexing.',
+        ].join('\n');
+    }
+    const lines = ['PureContext session snapshot:'];
+    for (const r of repos) {
+        const indexed = r.indexed_at
+            ? new Date(r.indexed_at).toISOString().slice(0, 19).replace('T', ' ')
+            : 'unknown';
+        lines.push(`- ${r.id} at ${r.root_path} (${r.file_count ?? '?'} files, last indexed ${indexed})`);
+    }
+    lines.push('- Use list_repos() to re-orient if needed.');
+    return lines.join('\n');
+}
+/** PreCompact: inject session snapshot before context compaction. */
+export async function cmdHookPreCompact() {
+    try {
+        await readStdin(); // consume stdin even if unused
+    }
+    catch { /* ignore */ }
+    try {
+        const repos = readIndexedRepos();
+        const message = buildSessionSnapshot(repos);
+        process.stdout.write(JSON.stringify({ systemMessage: message }) + '\n');
+    }
+    catch {
+        process.stdout.write(JSON.stringify({
+            systemMessage: 'PureContext session snapshot unavailable. Use list_repos() to check indexed repos.',
+        }) + '\n');
+    }
+    process.exit(0);
+}
+/** WorktreeCreate: auto-index a new agent worktree. */
+export async function cmdHookWorktreeCreate() {
+    try {
+        const input = await readStdin();
+        const worktreePath = (input.worktreePath ?? input.worktree_path);
+        const cwd = (input.cwd ?? '');
+        const name = (input.name ?? '');
+        const targetPath = worktreePath ?? (cwd && name ? join(cwd, '.claude', 'worktrees', name) : null);
+        if (!targetPath)
+            process.exit(0);
+        spawnSync('npx', ['purecontext-mcp', 'index-folder', '--path', targetPath], {
+            stdio: 'ignore',
+            timeout: 120_000,
+            shell: process.platform === 'win32',
+        });
+    }
+    catch { /* never block */ }
+    process.exit(0);
+}
+/** WorktreeRemove: fires when an agent worktree is removed. No-op for now. */
+export async function cmdHookWorktreeRemove() {
+    try {
+        await readStdin();
+    }
+    catch { /* ignore */ }
+    process.exit(0);
+}
+function readRepoStats() {
+    const base = process.env.PCTX_DATA_DIR ?? join(homedir(), '.purecontext');
+    const indexDir = join(base, 'indexes');
+    if (!existsSync(indexDir))
+        return [];
+    const _require = createRequire(import.meta.url);
+    let Database = null;
+    try {
+        Database = _require('better-sqlite3');
+    }
+    catch {
+        return [];
+    }
+    if (!Database)
+        return [];
+    let files;
+    try {
+        files = readdirSync(indexDir).filter((f) => f.endsWith('.db'));
+    }
+    catch {
+        return [];
+    }
+    const stats = [];
+    for (const file of files) {
+        let db;
+        try {
+            db = new Database(join(indexDir, file), { readonly: true });
+            const repo = db.prepare('SELECT id, root_path, file_count, indexed_at FROM repos LIMIT 1').get();
+            if (!repo)
+                continue;
+            const symRow = db.prepare('SELECT COUNT(*) AS cnt FROM symbols WHERE repo_id = ?').get(repo.id);
+            const highRow = db.prepare('SELECT COUNT(*) AS cnt FROM symbols WHERE repo_id = ? AND cyclomatic_complexity > 5').get(repo.id);
+            // Count TODO/FIXME occurrences across all file summaries stored in symbols
+            const todoRow = db.prepare("SELECT COUNT(*) AS cnt FROM symbols WHERE repo_id = ? AND (UPPER(summary) LIKE '%TODO%' OR UPPER(summary) LIKE '%FIXME%' OR UPPER(summary) LIKE '%HACK%')").get(repo.id);
+            stats.push({
+                repoId: repo.id,
+                rootPath: repo.root_path,
+                fileCount: repo.file_count,
+                symbolCount: symRow.cnt,
+                indexedAt: repo.indexed_at,
+                highComplexityCount: highRow.cnt,
+                todoCount: todoRow.cnt,
+            });
+        }
+        catch { /* skip unreadable db */ }
+        finally {
+            try {
+                db?.close();
+            }
+            catch { /* ignore */ }
+        }
+    }
+    return stats;
+}
+/** TaskCompleted: surface post-task diagnostics and remind about available tools. */
+export async function cmdHookTaskCompleted() {
+    try {
+        await readStdin();
+    }
+    catch { /* ignore */ }
+    try {
+        const repos = readRepoStats();
+        if (repos.length === 0) {
+            process.exit(0);
+        }
+        const lines = ['## PureContext Post-Task Summary\n'];
+        lines.push('**Indexed repos:**');
+        for (const r of repos) {
+            const indexed = r.indexedAt
+                ? new Date(r.indexedAt).toISOString().slice(0, 19).replace('T', ' ')
+                : 'unknown';
+            lines.push(`- \`${r.repoId}\` → \`${r.rootPath}\``);
+            lines.push(`  ${r.fileCount ?? '?'} files · ${r.symbolCount ?? '?'} symbols · indexed ${indexed}`);
+            if (r.highComplexityCount > 0) {
+                lines.push(`  ⚠ ${r.highComplexityCount} high-complexity symbols (cyclomatic > 5)`);
+            }
+            if (r.todoCount > 0) {
+                lines.push(`  📝 ${r.todoCount} symbols with TODO/FIXME/HACK in their summary`);
+            }
+        }
+        lines.push('');
+        lines.push('**Post-task diagnostic tools:**');
+        lines.push('- `find_dead_code`          → orphaned exports with no importers');
+        lines.push('- `find_untested_symbols`   → exported symbols with no test coverage');
+        lines.push('- `get_todos`               → all TODO/FIXME/HACK comments in the codebase');
+        lines.push('- `get_complexity_hotspots` → most complex functions to review');
+        lines.push('- `health_radar`            → overall codebase health score');
+        process.stdout.write(JSON.stringify({ systemMessage: lines.join('\n') }) + '\n');
+    }
+    catch {
+        // Never block task completion
+    }
+    process.exit(0);
+}
+/** SubagentStart: inject condensed repo orientation for spawned subagents. */
+export async function cmdHookSubagentStart() {
+    try {
+        await readStdin();
+    }
+    catch { /* ignore */ }
+    try {
+        const repos = readRepoStats();
+        const lines = ['## PureContext Repo Orientation\n'];
+        if (repos.length === 0) {
+            lines.push('No repos indexed yet.');
+            lines.push('Run `index_folder({ path: "/absolute/path" })` before navigating code.');
+        }
+        else {
+            lines.push('**Indexed repos (use these repoIds with all tools):**');
+            for (const r of repos) {
+                const indexed = r.indexedAt
+                    ? new Date(r.indexedAt).toISOString().slice(0, 19).replace('T', ' ')
+                    : 'unknown';
+                lines.push(`- repoId \`${r.repoId}\` → \`${r.rootPath}\``);
+                lines.push(`  ${r.fileCount ?? '?'} files · ${r.symbolCount ?? '?'} symbols · indexed ${indexed}`);
+            }
+        }
+        lines.push('');
+        lines.push('**Mandatory workflow — follow this order:**');
+        lines.push('1. `list_repos()` — always run first to confirm repoId');
+        lines.push('2. Navigate by symbol, not by file:');
+        lines.push('   | Goal | Tool |');
+        lines.push('   |------|------|');
+        lines.push('   | Find function/class by name | `search_symbols` |');
+        lines.push('   | Find code by what it does | `search_semantic` |');
+        lines.push('   | See all symbols in a file | `get_file_outline` |');
+        lines.push('   | Read a specific symbol | `get_symbol_source` |');
+        lines.push('   | Understand dependencies | `get_context_bundle` |');
+        lines.push('   | Know what breaks if I change X | `get_blast_radius` |');
+        lines.push('   | Find all call sites | `find_references` |');
+        lines.push('   | Non-symbol content (imports, config) | `get_file_content` with startLine/endLine |');
+        lines.push('3. Read `summary` and `signature` before fetching source — only fetch what you will edit.');
+        lines.push('');
+        lines.push('**Never:** read whole files · use `search_text` for symbol lookups · skip `list_repos()`');
+        process.stdout.write(JSON.stringify({ systemMessage: lines.join('\n') }) + '\n');
+    }
+    catch {
+        // Never block the subagent from starting
+    }
+    process.exit(0);
+}
+// ─── CLI dispatcher ───────────────────────────────────────────────────────────
+export function runHooksCommand(args) {
+    const flag = args[0];
+    if (flag === '--install') {
+        cmdHooksInstall();
+    }
+    else if (flag === '--list') {
+        cmdHooksList();
+    }
+    else {
+        process.stderr.write('Usage: purecontext-mcp hooks --install | --list\n');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=hooks.js.map

package/dist/cli/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/cli/hooks.ts"],"names":[],"mappings":"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"}

package/dist/cli/install-detect.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IDE/agent detection for `purecontext-mcp install all`.
+ *
+ * Each tool is detected by the presence of a characteristic directory or
+ * config file in the project root or the user's home directory.
+ */
+export declare function getClaudeDesktopConfigPath(): string | null;
+/**
+ * Return the list of AI coding tools detected in `projectRoot` or the user's
+ * home directory.  Detection is based on characteristic directory/file signals.
+ *
+ * `cline` and `vscode` both trigger on `.vscode/` — intentional; they write
+ * to different output files so there is no conflict.
+ */
+export declare function detectInstalledIDEs(projectRoot: string): Promise<string[]>;
+//# sourceMappingURL=install-detect.d.ts.map

package/dist/cli/install-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-detect.d.ts","sourceRoot":"","sources":["../../src/cli/install-detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAY1D;AAID;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6ChF"}