purecontext-mcp 1.2.0 → 1.5.0

package/dist/cli/install-detect.js

@@ -0,0 +1,70 @@
+/**
+ * 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.
+ */
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { homedir, platform } from 'os';
+// ─── Platform config paths ────────────────────────────────────────────────────
+export function getClaudeDesktopConfigPath() {
+    const p = platform();
+    if (p === 'darwin') {
+        return join(homedir(), 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    if (p === 'win32') {
+        const appdata = process.env['APPDATA'];
+        if (!appdata)
+            return null;
+        return join(appdata, 'Claude', 'claude_desktop_config.json');
+    }
+    // Linux and others
+    return join(homedir(), '.config', 'Claude', 'claude_desktop_config.json');
+}
+// ─── Detection ────────────────────────────────────────────────────────────────
+/**
+ * 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 async function detectInstalledIDEs(projectRoot) {
+    const detected = [];
+    // Claude Code — .claude/ directory in project or home
+    if (existsSync(join(projectRoot, '.claude')) || existsSync(join(homedir(), '.claude'))) {
+        detected.push('claude');
+    }
+    // Cursor — .cursor/ directory in project
+    if (existsSync(join(projectRoot, '.cursor'))) {
+        detected.push('cursor');
+    }
+    // Windsurf — .windsurf/ directory in project
+    if (existsSync(join(projectRoot, '.windsurf'))) {
+        detected.push('windsurf');
+    }
+    // Continue — .continue/ directory in project
+    if (existsSync(join(projectRoot, '.continue'))) {
+        detected.push('continue');
+    }
+    // Cline — .vscode/ directory exists (Cline runs inside VS Code)
+    if (existsSync(join(projectRoot, '.vscode'))) {
+        detected.push('cline');
+    }
+    // Roo Code — .roo/ directory in project
+    if (existsSync(join(projectRoot, '.roo'))) {
+        detected.push('roo-code');
+    }
+    // GitHub Copilot — .vscode/ directory exists
+    if (existsSync(join(projectRoot, '.vscode'))) {
+        detected.push('copilot');
+    }
+    // Claude Desktop — platform config path
+    const claudeDesktopConfig = getClaudeDesktopConfigPath();
+    if (claudeDesktopConfig && existsSync(claudeDesktopConfig)) {
+        detected.push('claude-desktop');
+    }
+    return detected;
+}
+//# sourceMappingURL=install-detect.js.map

package/dist/cli/install-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-detect.js","sourceRoot":"","sources":["../../src/cli/install-detect.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAEvC,iFAAiF;AAEjF,MAAM,UAAU,0BAA0B;IACxC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;IACrB,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IACnG,CAAC;IACD,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;IAC/D,CAAC;IACD,mBAAmB;IACnB,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;AAC5E,CAAC;AAED,iFAAiF;AAEjF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,WAAmB;IAC3D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,sDAAsD;IACtD,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QACvF,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,yCAAyC;IACzC,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC/C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,gEAAgE;IAChE,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,wCAAwC;IACxC,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5B,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAED,wCAAwC;IACxC,MAAM,mBAAmB,GAAG,0BAA0B,EAAE,CAAC;IACzD,IAAI,mBAAmB,IAAI,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * Per-IDE writer functions for `purecontext-mcp install <tool>`.
+ *
+ * Each exported `install*` function is idempotent: calling it twice produces
+ * the same result without duplicating content.  Marker comments
+ * (`<!-- purecontext-mcp-start/end -->`) delimit the managed block so that
+ * updates replace rather than append.
+ */
+export type Scope = 'local' | 'global' | 'both';
+export declare const START_MARKER = "<!-- purecontext-mcp-start -->";
+export declare const END_MARKER = "<!-- purecontext-mcp-end -->";
+export declare function getPureContextInstructions(format: 'markdown' | 'mdc' | 'json-system'): string;
+/**
+ * Install for Claude Code.
+ * local  → writes instruction block to <project>/CLAUDE.md
+ * global → writes hooks + ~/.claude/CLAUDE.md (existing behaviour)
+ * both   → both of the above
+ */
+export declare function installClaude(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Write `purecontext.mdc` with MDC frontmatter.
+ * local  → <project>/.cursor/rules/
+ * global → ~/.cursor/rules/
+ */
+export declare function installCursor(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Write `purecontext.md` into the Windsurf rules directory.
+ * local  → <project>/.windsurf/rules/purecontext.md
+ * global → ~/.windsurf/rules/purecontext.md
+ */
+export declare function installWindsurf(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Merge a `systemMessage` field into a Continue `config.json`.
+ * local  → <project>/.continue/config.json
+ * global → ~/.continue/config.json
+ */
+export declare function installContinue(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Write `.clinerules` with a marked block.
+ * local only — Cline has no known global config path.
+ */
+export declare function installCline(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Write `.roo/rules-code.md` with a marked block.
+ * local only — Roo Code has no known global config path.
+ */
+export declare function installRooCode(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Write `.github/copilot-instructions.md` with a marked block.
+ * local only — GitHub Copilot has no standard global instructions path.
+ */
+export declare function installCopilot(projectRoot: string, scope: Scope): Promise<void>;
+/**
+ * Merge the PureContext MCP server entry into the Claude Desktop config JSON.
+ * Always global — scope parameter is accepted for API consistency but ignored.
+ */
+export declare function installClaudeDesktop(_projectRoot: string, _scope: Scope): Promise<void>;
+export declare const INSTALL_WRITERS: Record<string, (projectRoot: string, scope: Scope) => Promise<void>>;
+//# sourceMappingURL=install-writers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-writers.d.ts","sourceRoot":"","sources":["../../src/cli/install-writers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAIhD,eAAO,MAAM,YAAY,mCAAmC,CAAC;AAC7D,eAAO,MAAM,UAAU,iCAAiC,CAAC;AAiCzD,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,aAAa,GAAG,MAAM,CAQ7F;AA8BD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAcpF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBpF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBtF;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBtF;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBrF;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBrF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC7F;AAID,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,CAShG,CAAC"}

package/dist/cli/install-writers.js

@@ -0,0 +1,292 @@
+/**
+ * Per-IDE writer functions for `purecontext-mcp install <tool>`.
+ *
+ * Each exported `install*` function is idempotent: calling it twice produces
+ * the same result without duplicating content.  Marker comments
+ * (`<!-- purecontext-mcp-start/end -->`) delimit the managed block so that
+ * updates replace rather than append.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { cmdHooksInstall } from './hooks.js';
+import { getClaudeDesktopConfigPath } from './install-detect.js';
+// ─── Shared markers ───────────────────────────────────────────────────────────
+export const START_MARKER = '<!-- purecontext-mcp-start -->';
+export const END_MARKER = '<!-- purecontext-mcp-end -->';
+// ─── Shared instruction content ───────────────────────────────────────────────
+const MARKDOWN_CONTENT = `## PureContext MCP — Code Navigation
+
+Always use PureContext MCP tools for code navigation. Never read entire files to find code.
+
+### Mandatory workflow
+
+1. **Start every session**: \`list_repos()\` → get \`repoId\` (required for all tools)
+2. **Find code by name**: \`search_symbols\` → read \`summary\` and \`signature\` → only call \`get_symbol_source\` for symbols you will actually edit
+3. **Find code by behaviour**: \`search_semantic\` for conceptual queries; \`search_text\` for literals/comments
+
+### Key tools
+
+| Goal | Tool |
+|------|------|
+| Find function/class by name | \`search_symbols\` |
+| Find by what it does | \`search_semantic\` |
+| Find literal string or comment | \`search_text\` |
+| All symbols in a file | \`get_file_outline\` |
+| What breaks if I change this | \`get_blast_radius\` |
+| All callers of a function | \`find_references\` |
+| Callers/callees tree | \`get_call_hierarchy\` |
+
+### Anti-patterns — never do these
+
+- Do not read whole files to find a function — use \`search_symbols\` + \`get_symbol_source\`
+- Do not call \`get_symbol_source\` for every result — read \`summary\` first
+- Do not skip \`list_repos\` — every tool needs a \`repoId\`
+- Do not re-search after \`verdict: "no_match"\` — the symbol does not exist`;
+export function getPureContextInstructions(format) {
+    if (format === 'mdc') {
+        return `---\ndescription: PureContext MCP code navigation rules\nalwaysApply: true\n---\n\n${MARKDOWN_CONTENT}`;
+    }
+    if (format === 'json-system') {
+        return MARKDOWN_CONTENT;
+    }
+    return MARKDOWN_CONTENT;
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function replaceMarkerBlock(existing, newBlock) {
+    const startIdx = existing.indexOf(START_MARKER);
+    const endIdx = existing.indexOf(END_MARKER);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        return existing.slice(0, startIdx) + newBlock + existing.slice(endIdx + END_MARKER.length);
+    }
+    // No existing block — append
+    if (!existing.endsWith('\n'))
+        existing += '\n';
+    return existing + '\n' + newBlock + '\n';
+}
+function markedBlock(content) {
+    return `${START_MARKER}\n${content}\n${END_MARKER}`;
+}
+function ensureDir(filePath) {
+    mkdirSync(dirname(filePath), { recursive: true });
+}
+function writeIdempotent(filePath, content) {
+    ensureDir(filePath);
+    writeFileSync(filePath, content, 'utf-8');
+}
+// ─── Per-IDE installers ───────────────────────────────────────────────────────
+/**
+ * Install for Claude Code.
+ * local  → writes instruction block to <project>/CLAUDE.md
+ * global → writes hooks + ~/.claude/CLAUDE.md (existing behaviour)
+ * both   → both of the above
+ */
+export async function installClaude(projectRoot, scope) {
+    if (scope === 'local' || scope === 'both') {
+        const filePath = join(projectRoot, 'CLAUDE.md');
+        const block = markedBlock(getPureContextInstructions('markdown'));
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, 'utf-8');
+            writeFileSync(filePath, replaceMarkerBlock(existing, block), 'utf-8');
+        }
+        else {
+            writeIdempotent(filePath, block + '\n');
+        }
+    }
+    if (scope === 'global' || scope === 'both') {
+        cmdHooksInstall();
+    }
+}
+/**
+ * Write `purecontext.mdc` with MDC frontmatter.
+ * local  → <project>/.cursor/rules/
+ * global → ~/.cursor/rules/
+ */
+export async function installCursor(projectRoot, scope) {
+    const writeMdc = (filePath) => {
+        ensureDir(filePath);
+        const mdcContent = getPureContextInstructions('mdc');
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, 'utf-8');
+            if (existing.includes(START_MARKER)) {
+                writeFileSync(filePath, replaceMarkerBlock(existing, markedBlock(MARKDOWN_CONTENT)), 'utf-8');
+                return;
+            }
+        }
+        writeIdempotent(filePath, mdcContent + '\n');
+    };
+    if (scope === 'local' || scope === 'both') {
+        writeMdc(join(projectRoot, '.cursor', 'rules', 'purecontext.mdc'));
+    }
+    if (scope === 'global' || scope === 'both') {
+        writeMdc(join(homedir(), '.cursor', 'rules', 'purecontext.mdc'));
+    }
+}
+/**
+ * Write `purecontext.md` into the Windsurf rules directory.
+ * local  → <project>/.windsurf/rules/purecontext.md
+ * global → ~/.windsurf/rules/purecontext.md
+ */
+export async function installWindsurf(projectRoot, scope) {
+    const writeLocal = (filePath) => {
+        ensureDir(filePath);
+        writeFileSync(filePath, getPureContextInstructions('markdown') + '\n', 'utf-8');
+    };
+    const writeGlobal = (filePath) => {
+        const block = markedBlock(getPureContextInstructions('markdown'));
+        ensureDir(filePath);
+        if (existsSync(filePath)) {
+            const existing = readFileSync(filePath, 'utf-8');
+            writeFileSync(filePath, replaceMarkerBlock(existing, block), 'utf-8');
+        }
+        else {
+            writeFileSync(filePath, block + '\n', 'utf-8');
+        }
+    };
+    if (scope === 'local' || scope === 'both') {
+        writeLocal(join(projectRoot, '.windsurf', 'rules', 'purecontext.md'));
+    }
+    if (scope === 'global' || scope === 'both') {
+        writeGlobal(join(homedir(), '.windsurf', 'rules', 'purecontext.md'));
+    }
+}
+/**
+ * Merge a `systemMessage` field into a Continue `config.json`.
+ * local  → <project>/.continue/config.json
+ * global → ~/.continue/config.json
+ */
+export async function installContinue(projectRoot, scope) {
+    const writeConfig = (filePath) => {
+        ensureDir(filePath);
+        const instructions = getPureContextInstructions('json-system');
+        let config = {};
+        if (existsSync(filePath)) {
+            try {
+                config = JSON.parse(readFileSync(filePath, 'utf-8'));
+            }
+            catch {
+                config = {};
+            }
+        }
+        config['systemMessage'] = instructions;
+        writeFileSync(filePath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    };
+    if (scope === 'local' || scope === 'both') {
+        writeConfig(join(projectRoot, '.continue', 'config.json'));
+    }
+    if (scope === 'global' || scope === 'both') {
+        writeConfig(join(homedir(), '.continue', 'config.json'));
+    }
+}
+/**
+ * Write `.clinerules` with a marked block.
+ * local only — Cline has no known global config path.
+ */
+export async function installCline(projectRoot, scope) {
+    if (scope === 'global') {
+        console.log('  cline: no known global config path — skipped');
+        return;
+    }
+    const filePath = join(projectRoot, '.clinerules');
+    const block = markedBlock(getPureContextInstructions('markdown'));
+    if (existsSync(filePath)) {
+        const existing = readFileSync(filePath, 'utf-8');
+        writeFileSync(filePath, replaceMarkerBlock(existing, block), 'utf-8');
+    }
+    else {
+        writeIdempotent(filePath, block + '\n');
+    }
+    if (scope === 'both') {
+        console.log('  cline: no known global config path — global install skipped');
+    }
+}
+/**
+ * Write `.roo/rules-code.md` with a marked block.
+ * local only — Roo Code has no known global config path.
+ */
+export async function installRooCode(projectRoot, scope) {
+    if (scope === 'global') {
+        console.log('  roo-code: no known global config path — skipped');
+        return;
+    }
+    const filePath = join(projectRoot, '.roo', 'rules-code.md');
+    const block = markedBlock(getPureContextInstructions('markdown'));
+    ensureDir(filePath);
+    if (existsSync(filePath)) {
+        const existing = readFileSync(filePath, 'utf-8');
+        writeFileSync(filePath, replaceMarkerBlock(existing, block), 'utf-8');
+    }
+    else {
+        writeFileSync(filePath, block + '\n', 'utf-8');
+    }
+    if (scope === 'both') {
+        console.log('  roo-code: no known global config path — global install skipped');
+    }
+}
+/**
+ * Write `.github/copilot-instructions.md` with a marked block.
+ * local only — GitHub Copilot has no standard global instructions path.
+ */
+export async function installCopilot(projectRoot, scope) {
+    if (scope === 'global') {
+        console.log('  copilot: no known global config path — skipped');
+        return;
+    }
+    const filePath = join(projectRoot, '.github', 'copilot-instructions.md');
+    const block = markedBlock(getPureContextInstructions('markdown'));
+    ensureDir(filePath);
+    if (existsSync(filePath)) {
+        const existing = readFileSync(filePath, 'utf-8');
+        writeFileSync(filePath, replaceMarkerBlock(existing, block), 'utf-8');
+    }
+    else {
+        writeFileSync(filePath, block + '\n', 'utf-8');
+    }
+    if (scope === 'both') {
+        console.log('  copilot: no known global config path — global install skipped');
+    }
+}
+/**
+ * Merge the PureContext MCP server entry into the Claude Desktop config JSON.
+ * Always global — scope parameter is accepted for API consistency but ignored.
+ */
+export async function installClaudeDesktop(_projectRoot, _scope) {
+    const configPath = getClaudeDesktopConfigPath();
+    if (!configPath) {
+        throw new Error('Cannot determine Claude Desktop config path for this platform');
+    }
+    ensureDir(configPath);
+    let config = {};
+    if (existsSync(configPath)) {
+        try {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            config = {};
+        }
+    }
+    const mcpServers = (config['mcpServers'] ?? {});
+    const existing = mcpServers['purecontext-mcp'];
+    if (existing?.['command'] === 'npx') {
+        // Already present with same command — skip
+        return;
+    }
+    mcpServers['purecontext-mcp'] = {
+        command: 'npx',
+        args: ['purecontext-mcp'],
+    };
+    config['mcpServers'] = mcpServers;
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+// ─── Dispatch table ───────────────────────────────────────────────────────────
+export const INSTALL_WRITERS = {
+    'claude': installClaude,
+    'cursor': installCursor,
+    'windsurf': installWindsurf,
+    'continue': installContinue,
+    'cline': installCline,
+    'roo-code': installRooCode,
+    'copilot': installCopilot,
+    'claude-desktop': installClaudeDesktop,
+};
+//# sourceMappingURL=install-writers.js.map

package/dist/cli/install-writers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-writers.js","sourceRoot":"","sources":["../../src/cli/install-writers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAIjE,iFAAiF;AAEjF,MAAM,CAAC,MAAM,YAAY,GAAG,gCAAgC,CAAC;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,8BAA8B,CAAC;AAEzD,iFAAiF;AAEjF,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;6EA2BoD,CAAC;AAE9E,MAAM,UAAU,0BAA0B,CAAC,MAA0C;IACnF,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,sFAAsF,gBAAgB,EAAE,CAAC;IAClH,CAAC;IACD,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IACD,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAED,iFAAiF;AAEjF,SAAS,kBAAkB,CAAC,QAAgB,EAAE,QAAgB;IAC5D,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC7F,CAAC;IACD,6BAA6B;IAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,QAAQ,IAAI,IAAI,CAAC;IAC/C,OAAO,QAAQ,GAAG,IAAI,GAAG,QAAQ,GAAG,IAAI,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,GAAG,YAAY,KAAK,OAAO,KAAK,UAAU,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB,EAAE,OAAe;IACxD,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,KAAY;IACnE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,WAAW,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;QAClE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,eAAe,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,KAAY;IACnE,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAE,EAAE;QACpC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,MAAM,UAAU,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACpC,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC9F,OAAO;YACT,CAAC;QACH,CAAC;QACD,eAAe,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC;IAEF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,KAAY;IACrE,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAE;QACtC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,aAAa,CAAC,QAAQ,EAAE,0BAA0B,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAClF,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,EAAE;QACvC,MAAM,KAAK,GAAG,WAAW,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;QAClE,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,gBAAgB,CAAC,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,WAAmB,EAAE,KAAY;IACrE,MAAM,WAAW,GAAG,CAAC,QAAgB,EAAE,EAAE;QACvC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpB,MAAM,YAAY,GAAG,0BAA0B,CAAC,aAAa,CAAC,CAAC;QAC/D,IAAI,MAAM,GAA4B,EAAE,CAAC;QACzC,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAA4B,CAAC;YAClF,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,CAAC,eAAe,CAAC,GAAG,YAAY,CAAC;QACvC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC,CAAC;IAEF,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC1C,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QAC3C,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,KAAY;IAClE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,WAAW,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,eAAe,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,KAAY;IACpE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAC5D,MAAM,KAAK,GAAG,WAAW,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,WAAmB,EAAE,KAAY;IACpE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,yBAAyB,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,WAAW,CAAC,0BAA0B,CAAC,UAAU,CAAC,CAAC,CAAC;IAClE,SAAS,CAAC,QAAQ,CAAC,CAAC;IACpB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,aAAa,CAAC,QAAQ,EAAE,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;SAAM,CAAC;QACN,aAAa,CAAC,QAAQ,EAAE,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iEAAiE,CAAC,CAAC;IACjF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,YAAoB,EAAE,MAAa;IAC5E,MAAM,UAAU,GAAG,0BAA0B,EAAE,CAAC;IAChD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,SAAS,CAAC,UAAU,CAAC,CAAC;IAEtB,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAA4B,CAAC;QACpF,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,CAA4B,CAAC;IAC3E,MAAM,QAAQ,GAAG,UAAU,CAAC,iBAAiB,CAAwC,CAAC;IAEtF,IAAI,QAAQ,EAAE,CAAC,SAAS,CAAC,KAAK,KAAK,EAAE,CAAC;QACpC,2CAA2C;QAC3C,OAAO;IACT,CAAC;IAED,UAAU,CAAC,iBAAiB,CAAC,GAAG;QAC9B,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,iBAAiB,CAAC;KAC1B,CAAC;IACF,MAAM,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC;IAElC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC7E,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAyE;IACnG,QAAQ,EAAE,aAAa;IACvB,QAAQ,EAAE,aAAa;IACvB,UAAU,EAAE,eAAe;IAC3B,UAAU,EAAE,eAAe;IAC3B,OAAO,EAAE,YAAY;IACrB,UAAU,EAAE,cAAc;IAC1B,SAAS,EAAE,cAAc;IACzB,gBAAgB,EAAE,oBAAoB;CACvC,CAAC"}

package/dist/cli/install.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `purecontext-mcp install <tool|all>  [--scope=local|global|both]  [--dry-run]  [--list]`
+ *
+ * Installs PureContext agent instructions into the conventions file of the
+ * specified AI coding IDE.  `install all` auto-detects installed tools and
+ * installs each in sequence.  `install --list` shows detection state without
+ * writing anything.
+ *
+ * If `--scope` is omitted the user is prompted interactively.  In
+ * non-interactive environments (piped stdin) the prompt is skipped and
+ * `local` is used as a safe default.
+ */
+export declare function runInstallCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/cli/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA2IH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BrE"}

package/dist/cli/install.js

@@ -0,0 +1,150 @@
+/**
+ * `purecontext-mcp install <tool|all>  [--scope=local|global|both]  [--dry-run]  [--list]`
+ *
+ * Installs PureContext agent instructions into the conventions file of the
+ * specified AI coding IDE.  `install all` auto-detects installed tools and
+ * installs each in sequence.  `install --list` shows detection state without
+ * writing anything.
+ *
+ * If `--scope` is omitted the user is prompted interactively.  In
+ * non-interactive environments (piped stdin) the prompt is skipped and
+ * `local` is used as a safe default.
+ */
+import { createInterface } from 'readline';
+import { detectInstalledIDEs } from './install-detect.js';
+import { INSTALL_WRITERS } from './install-writers.js';
+// ─── Scope helpers ────────────────────────────────────────────────────────────
+const VALID_SCOPES = ['local', 'global', 'both'];
+function parseScope(args) {
+    // --scope=local  or  --scope local
+    const eqForm = args.find((a) => a.startsWith('--scope='))?.split('=')[1];
+    if (eqForm)
+        return VALID_SCOPES.includes(eqForm) ? eqForm : undefined;
+    const idx = args.indexOf('--scope');
+    if (idx !== -1 && args[idx + 1]) {
+        const val = args[idx + 1];
+        return VALID_SCOPES.includes(val) ? val : undefined;
+    }
+    return undefined;
+}
+async function promptScope() {
+    if (!process.stdin.isTTY)
+        return 'local';
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        console.log('\nWhere should PureContext be installed?');
+        console.log('  1) Local  — this project only');
+        console.log('  2) Global — all projects (user-level config)');
+        console.log('  3) Both\n');
+        rl.question('Choice [1/2/3]: ', (answer) => {
+            rl.close();
+            const trimmed = answer.trim();
+            if (trimmed === '2')
+                resolve('global');
+            else if (trimmed === '3')
+                resolve('both');
+            else
+                resolve('local');
+        });
+    });
+}
+// ─── Constants ────────────────────────────────────────────────────────────────
+const KNOWN_TOOLS = [
+    'claude',
+    'cursor',
+    'windsurf',
+    'continue',
+    'cline',
+    'roo-code',
+    'copilot',
+    'claude-desktop',
+];
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function isKnownTool(tool) {
+    return KNOWN_TOOLS.includes(tool);
+}
+async function runInstall(tool, projectRoot, dryRun, scope) {
+    const writer = INSTALL_WRITERS[tool];
+    if (!writer)
+        return false;
+    if (dryRun) {
+        console.log(`  [dry-run] Would install: ${tool} (${scope})`);
+        return true;
+    }
+    try {
+        await writer(projectRoot, scope);
+        return true;
+    }
+    catch (err) {
+        process.stderr.write(`  Error installing ${tool}: ${err.message}\n`);
+        return false;
+    }
+}
+// ─── Sub-commands ─────────────────────────────────────────────────────────────
+async function cmdInstallOne(tool, projectRoot, dryRun, scope) {
+    if (!isKnownTool(tool)) {
+        process.stderr.write(`Unknown tool: "${tool}"\nValid tools: ${KNOWN_TOOLS.join(', ')}\n`);
+        process.exit(1);
+    }
+    const ok = await runInstall(tool, projectRoot, dryRun, scope);
+    if (ok && !dryRun) {
+        console.log(`\nInstalled for ${tool} (${scope}).`);
+    }
+}
+async function cmdInstallAll(projectRoot, dryRun, scope) {
+    const detected = await detectInstalledIDEs(projectRoot);
+    if (detected.length === 0) {
+        console.log('No supported IDEs detected in this directory.');
+        console.log(`Run \`npx purecontext-mcp install <tool>\` to install for a specific tool.`);
+        console.log(`Supported tools: ${KNOWN_TOOLS.join(', ')}`);
+        return;
+    }
+    const notDetected = KNOWN_TOOLS.filter((t) => !detected.includes(t));
+    console.log(`Detected IDEs: ${detected.join(', ')}\n`);
+    // Always include claude hooks when installing any tool
+    const toInstall = detected.includes('claude')
+        ? detected
+        : ['claude', ...detected];
+    for (const tool of toInstall) {
+        const label = `Installing ${tool}...`.padEnd(24);
+        const ok = await runInstall(tool, projectRoot, dryRun, scope);
+        console.log(`${label} ${ok ? '✓' : '✗'}`);
+    }
+    if (notDetected.length > 0) {
+        console.log(`\nNot detected: ${notDetected.join(', ')}`);
+        console.log(`Run \`npx purecontext-mcp install <tool>\` to install for a specific tool manually.`);
+    }
+}
+async function cmdInstallList(projectRoot) {
+    const detected = await detectInstalledIDEs(projectRoot);
+    console.log('\nIDE detection results:\n');
+    for (const tool of KNOWN_TOOLS) {
+        const status = detected.includes(tool) ? 'detected' : 'not detected';
+        console.log(`  ${tool.padEnd(16)} ${status}`);
+    }
+    console.log();
+}
+// ─── CLI dispatcher ───────────────────────────────────────────────────────────
+export async function runInstallCommand(args) {
+    const projectRoot = process.cwd();
+    const dryRun = args.includes('--dry-run');
+    const listFlag = args.includes('--list');
+    const toolArg = args.find((a) => !a.startsWith('--'));
+    if (listFlag) {
+        await cmdInstallList(projectRoot);
+        return;
+    }
+    if (!toolArg) {
+        process.stderr.write('Usage: purecontext-mcp install <tool|all>  [--scope=local|global|both]  [--dry-run]  [--list]\n');
+        process.stderr.write(`Supported tools: ${KNOWN_TOOLS.join(', ')}\n`);
+        process.exit(1);
+    }
+    const scope = parseScope(args) ?? (await promptScope());
+    if (toolArg === 'all') {
+        await cmdInstallAll(projectRoot, dryRun, scope);
+    }
+    else {
+        await cmdInstallOne(toolArg, projectRoot, dryRun, scope);
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/cli/install.js.map

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

package/dist/config/config-loader.js

@@ -127,6 +127,9 @@ function mergeConfig(partial) {
         },
         maxFileSizeBytes: partial.maxFileSizeBytes ?? DEFAULT_CONFIG.maxFileSizeBytes,
         allowSymlinks: partial.allowSymlinks ?? DEFAULT_CONFIG.allowSymlinks,
+        indexing: {
+            cssVariables: partial.indexing?.cssVariables ?? DEFAULT_CONFIG.indexing.cssVariables,
+        },
         transport: partial.transport ?? DEFAULT_CONFIG.transport,
         http: {
             port: pctxPort ?? partial.http?.port ?? DEFAULT_CONFIG.http.port,