purecontext-mcp 1.0.1

package/dist/adapters/vue-preprocessor.js

@@ -0,0 +1,82 @@
+/**
+ * Vue Single-File Component (SFC) pre-processor.
+ *
+ * Splits a raw .vue file buffer into typed ProcessedBlock[] so the TypeScript/
+ * JavaScript language handlers can parse each script block independently.
+ * Template and style blocks are intentionally omitted — they don't contain
+ * symbols we want to index.
+ *
+ * Byte-offset correctness:
+ *   offsetInOriginal is always computed from Buffer.byteLength(), never from
+ *   string character indices. This ensures symbols inside multi-byte content
+ *   that precedes the script block are positioned correctly.
+ */
+import { ParseError } from '../core/errors.js';
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Split a Vue SFC buffer into its typed script blocks.
+ *
+ * Returns one ProcessedBlock per <script> / <script setup> block found,
+ * with language set to 'typescript' when lang="ts" or lang="tsx" is present,
+ * and 'javascript' otherwise.
+ *
+ * Returns [] for files with no script block (template/style-only SFCs).
+ * Throws ParseError for files with mismatched <script> open/close tags.
+ */
+export function splitVueSFC(source, filePath) {
+    const str = source.toString('utf8');
+    // ── Validate tag balance ──────────────────────────────────────────────────
+    const openCount = countMatches(str, /<script\b/gi);
+    const closeCount = countMatches(str, /<\/script>/gi);
+    if (openCount !== closeCount) {
+        throw new ParseError(`Malformed Vue SFC: ${openCount} <script> open tags but ${closeCount} </script> close tags`, filePath);
+    }
+    if (openCount === 0) {
+        return [];
+    }
+    // ── Extract script blocks ─────────────────────────────────────────────────
+    // Captures: group 1 = attributes (everything between <script and >)
+    //           group 2 = inner content
+    const SCRIPT_RE = /<script([^>]*)>([\s\S]*?)<\/script>/gi;
+    const blocks = [];
+    let match;
+    while ((match = SCRIPT_RE.exec(str)) !== null) {
+        const attrs = match[1] ?? '';
+        const innerContent = match[2] ?? '';
+        // Byte offset of the first character of inner content within the original
+        // file.  We reconstruct the open tag length in characters and then convert
+        // the prefix to bytes so multi-byte characters before this point are
+        // accounted for correctly.
+        //
+        //   match.index          → char index of '<'
+        //   7                    → length of '<script'
+        //   attrs.length         → attribute string length in chars
+        //   1                    → the '>' character
+        const contentCharStart = match.index + 7 + attrs.length + 1;
+        const offsetInOriginal = Buffer.byteLength(str.slice(0, contentCharStart), 'utf8');
+        const language = detectLanguage(attrs);
+        blocks.push({
+            content: Buffer.from(innerContent, 'utf8'),
+            language,
+            offsetInOriginal,
+        });
+    }
+    return blocks;
+}
+// ─── Internals ────────────────────────────────────────────────────────────────
+/**
+ * Determine the block language from the <script> tag attributes string.
+ *   lang="ts" | lang="tsx"  → 'typescript'
+ *   lang="js" | (no lang)   → 'javascript'
+ */
+function detectLanguage(attrs) {
+    const langMatch = attrs.match(/\blang=["']([^"']+)["']/i);
+    if (!langMatch)
+        return 'javascript';
+    const lang = langMatch[1].toLowerCase();
+    return lang === 'ts' || lang === 'tsx' ? 'typescript' : 'javascript';
+}
+function countMatches(str, re) {
+    return (str.match(re) ?? []).length;
+}
+//# sourceMappingURL=vue-preprocessor.js.map

package/dist/adapters/vue-preprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue-preprocessor.js","sourceRoot":"","sources":["../../src/adapters/vue-preprocessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,iFAAiF;AAEjF;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc,EAAE,QAAgB;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEpC,6EAA6E;IAC7E,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IACrD,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;QAC7B,MAAM,IAAI,UAAU,CAClB,sBAAsB,SAAS,2BAA2B,UAAU,uBAAuB,EAC3F,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,6EAA6E;IAC7E,oEAAoE;IACpE,oCAAoC;IACpC,MAAM,SAAS,GAAG,uCAAuC,CAAC;IAC1D,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7B,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEpC,0EAA0E;QAC1E,2EAA2E;QAC3E,qEAAqE;QACrE,2BAA2B;QAC3B,EAAE;QACF,6CAA6C;QAC7C,+CAA+C;QAC/C,4DAA4D;QAC5D,6CAA6C;QAC7C,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QAC5D,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC,CAAC;QAEnF,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;QAEvC,MAAM,CAAC,IAAI,CAAC;YACV,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC;YAC1C,QAAQ;YACR,gBAAgB;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,YAAY,CAAC;IACpC,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;IACzC,OAAO,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC;AACvE,CAAC;AAED,SAAS,YAAY,CAAC,GAAW,EAAE,EAAU;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;AACtC,CAAC"}

package/dist/adapters/vue.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Vue 3 framework adapter.
+ *
+ * Responsibilities:
+ *  1. Detect Vue projects (package.json has `vue` dep, or .vue files present).
+ *  2. Pre-process .vue SFCs into typed script blocks via vue-preprocessor.
+ *  3. Emit one `component` symbol per .vue file (name derived from filename or
+ *     from an explicit `defineOptions({ name: '...' })` call).
+ *  4. Upgrade exported `useXxx` functions to kind `'composable'` via enrichMetadata.
+ */
+import type { FrameworkAdapter } from '../core/types.js';
+export declare const vueAdapter: FrameworkAdapter;
+//# sourceMappingURL=vue.d.ts.map

package/dist/adapters/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../../src/adapters/vue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAsB,MAAM,kBAAkB,CAAC;AA0C7E,eAAO,MAAM,UAAU,EAAE,gBAqGxB,CAAC"}

package/dist/adapters/vue.js

@@ -0,0 +1,134 @@
+/**
+ * Vue 3 framework adapter.
+ *
+ * Responsibilities:
+ *  1. Detect Vue projects (package.json has `vue` dep, or .vue files present).
+ *  2. Pre-process .vue SFCs into typed script blocks via vue-preprocessor.
+ *  3. Emit one `component` symbol per .vue file (name derived from filename or
+ *     from an explicit `defineOptions({ name: '...' })` call).
+ *  4. Upgrade exported `useXxx` functions to kind `'composable'` via enrichMetadata.
+ */
+import { createHash } from 'crypto';
+import { basename } from 'path';
+import { readFileSync, readdirSync } from 'fs';
+import { splitVueSFC } from './vue-preprocessor.js';
+import { registerAdapter } from './adapter-registry.js';
+import { logger } from '../core/logger.js';
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function makeId(filePath, name, kind) {
+    return createHash('sha256')
+        .update(`${filePath}:${name}:${kind}`)
+        .digest('hex')
+        .slice(0, 16);
+}
+/**
+ * Convert kebab-case or camelCase filename stems to PascalCase.
+ * 'my-component' → 'MyComponent'
+ * 'userCard'     → 'UserCard'
+ */
+function toPascalCase(str) {
+    return str
+        .replace(/[-_](.)/g, (_, c) => c.toUpperCase())
+        .replace(/^(.)/, (_, c) => c.toUpperCase());
+}
+function componentNameFromPath(filePath) {
+    return toPascalCase(basename(filePath, '.vue'));
+}
+/**
+ * Try to find an explicit component name from `defineOptions({ name: '...' })`.
+ * Falls back to the filename-derived PascalCase name.
+ */
+function resolveComponentName(source, filePath) {
+    const str = source.toString('utf8');
+    const m = str.match(/defineOptions\s*\(\s*\{[^}]*\bname\s*:\s*['"]([^'"]+)['"]/);
+    if (m)
+        return m[1];
+    return componentNameFromPath(filePath);
+}
+// ─── Vue adapter ──────────────────────────────────────────────────────────────
+export const vueAdapter = {
+    name: 'vue',
+    extensions: () => ['.vue'],
+    // ── Detection ───────────────────────────────────────────────────────────────
+    async detect(projectRoot) {
+        // Primary signal: package.json declares a vue dependency
+        try {
+            const raw = readFileSync(`${projectRoot}/package.json`, 'utf8');
+            const pkg = JSON.parse(raw);
+            const deps = Object.assign({}, pkg['dependencies'], pkg['devDependencies']);
+            if (Object.keys(deps).some((k) => k === 'vue' || k.startsWith('@vue/'))) {
+                return true;
+            }
+        }
+        catch {
+            // No package.json or parse error — fall through to file scan
+        }
+        // Fallback: presence of .vue files in common source directories
+        const scanDirs = [projectRoot, `${projectRoot}/src`, `${projectRoot}/components`];
+        for (const dir of scanDirs) {
+            try {
+                const entries = readdirSync(dir, { withFileTypes: true });
+                if (entries.some((e) => e.isFile() && e.name.endsWith('.vue'))) {
+                    return true;
+                }
+            }
+            catch {
+                // Directory doesn't exist — skip
+            }
+        }
+        return false;
+    },
+    // ── File routing ─────────────────────────────────────────────────────────────
+    fileFilter: (filePath) => filePath.endsWith('.vue'),
+    // ── Pre-processing ───────────────────────────────────────────────────────────
+    preProcess: splitVueSFC,
+    // ── Framework symbol extraction ──────────────────────────────────────────────
+    /**
+     * Emit one `component` symbol per .vue file.
+     * `tree` is the parsed AST of the <script> block (or null for template-only SFCs).
+     * `source` is the full original .vue file buffer.
+     */
+    extractFrameworkSymbols(tree, source, filePath) {
+        const name = resolveComponentName(source, filePath);
+        return [
+            {
+                id: makeId(filePath, name, 'component'),
+                name,
+                kind: 'component',
+                filePath,
+                startByte: 0,
+                endByte: source.length,
+                signature: `<${name}>`,
+                summary: `Vue component ${name}`,
+                frameworkMeta: { vue_component: true },
+            },
+        ];
+    },
+    // ── Metadata enrichment ──────────────────────────────────────────────────────
+    /**
+     * Upgrade exported `useXxx` functions/consts to kind `'composable'`.
+     * The id is recomputed to reflect the new kind so it remains deterministic.
+     */
+    enrichMetadata(symbol) {
+        if ((symbol.kind === 'function' || symbol.kind === 'const') &&
+            /^use[A-Z]/.test(symbol.name)) {
+            return {
+                ...symbol,
+                kind: 'composable',
+                id: makeId(symbol.filePath, symbol.name, 'composable'),
+                frameworkMeta: { ...symbol.frameworkMeta, vue_composable: true },
+            };
+        }
+        if (symbol.kind === 'component') {
+            return {
+                ...symbol,
+                frameworkMeta: { ...symbol.frameworkMeta, vue_component: true },
+            };
+        }
+        return symbol;
+    },
+};
+// ─── Self-registration ────────────────────────────────────────────────────────
+registerAdapter(vueAdapter);
+logger.debug("Adapter 'vue' registered");
+//# sourceMappingURL=vue.js.map

package/dist/adapters/vue.js.map

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

package/dist/config/cli.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `purecontext-mcp config --init`
+ * Write a default config.json to ~/.purecontext/config.json.
+ * No-op if the file already exists.
+ * Prompts the user to opt in to anonymous telemetry.
+ */
+export declare function cmdInit(): Promise<void>;
+/**
+ * `purecontext-mcp --health`
+ * Quick self-check: Node.js version, SQLite, grammar files, config, index dir.
+ * All output goes to stdout so it is easy to grep/capture.
+ * Returns true if all checks passed (exit 0), false if any failed (exit 1).
+ */
+export declare function cmdHealth(write?: (line: string) => void): boolean;
+/**
+ * `purecontext-mcp config --check`
+ * Validate the current config and verify prerequisites (grammars, SQLite).
+ * Returns true if all checks pass.
+ */
+export declare function cmdCheck(): boolean;
+/**
+ * `purecontext-mcp config`
+ * Print the effective configuration (defaults merged with config.json) as JSON.
+ */
+export declare function cmdShow(): void;
+//# sourceMappingURL=cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/config/cli.ts"],"names":[],"mappings":"AAmEA;;;;;GAKG;AACH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA8B7C;AA8BD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA4C,GAAG,OAAO,CA8ExG;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAoElC;AAED;;;GAGG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAG9B"}

package/dist/config/cli.js

@@ -0,0 +1,291 @@
+import { writeFileSync, existsSync, mkdirSync, readFileSync, readdirSync } from 'fs';
+import { dirname, join } from 'path';
+import { homedir } from 'os';
+import { createInterface } from 'readline';
+import { getConfigPath, validateConfig } from './config-schema.js';
+import { loadConfig } from './config-loader.js';
+import { GRAMMARS_DIR } from '../core/parse-dispatcher.js';
+import { openInMemoryDatabase } from '../core/db/schema.js';
+import { VERSION } from '../version.js';
+// ─── Default config template (JSON with explanatory comments) ─────────────────
+const defaultIndexDir = join(homedir(), '.purecontext', 'indexes').replace(/\\/g, '/');
+const CONFIG_TEMPLATE = `{
+  // Directory where SQLite index files are stored.
+  // Default: ~/.purecontext/indexes/
+  "indexDir": "${defaultIndexDir}",
+
+  // Maximum number of source files to index per project.
+  // Set to 0 for unlimited. Raise for large monorepos (e.g. 50000).
+  "fileLimit": 10000,
+
+  // Worker threads for parallel file parsing.
+  // Default: number of CPU cores, up to 8. Set to 1 to disable parallelism.
+  "concurrency": 4,
+
+  // Maximum file size in bytes to index. Files larger than this are skipped silently.
+  // Default: 524288 (512 KB). Raise if you have large generated files you want indexed.
+  "maxFileSizeBytes": 524288,
+
+  // Debounce window in milliseconds for the file watcher.
+  "watchDebounceMs": 2000,
+
+  // Additional glob patterns to exclude from indexing.
+  // Example: ["**/*.generated.ts", "src/vendor/**"]
+  "excludePatterns": [],
+
+  // Framework adapter activation.
+  // "auto"   — detect from project config files (recommended)
+  // "none"   — disable all adapters
+  // ["vue"]  — explicit list
+  "adapters": "auto",
+
+  // AI summarization (Phase 2 feature — keep provider "none" for Phase 1).
+  "ai": {
+    "provider": "none",
+    "allowRemoteAI": false
+  },
+
+  // Transport mode.
+  // "stdio" — stdin/stdout (default; required for Claude Code)
+  // "http"  — HTTP + Streamable HTTP (for web clients)
+  // "both"  — stdio AND HTTP simultaneously
+  "transport": "stdio",
+
+  // HTTP server settings (used when transport is "http" or "both").
+  "http": {
+    "port": 3000,
+    "host": "127.0.0.1",
+    "corsOrigins": ["http://localhost:*"]
+  }
+}
+`;
+// ─── Public commands ──────────────────────────────────────────────────────────
+/**
+ * `purecontext-mcp config --init`
+ * Write a default config.json to ~/.purecontext/config.json.
+ * No-op if the file already exists.
+ * Prompts the user to opt in to anonymous telemetry.
+ */
+export async function cmdInit() {
+    const path = getConfigPath();
+    if (existsSync(path)) {
+        console.log(`Config already exists at ${path}`);
+        console.log('Delete it first if you want to regenerate defaults.');
+        return;
+    }
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, CONFIG_TEMPLATE, 'utf8');
+    console.log(`Created config at ${path}`);
+    // ── Telemetry opt-in prompt ────────────────────────────────────────────────
+    const telemetryEnabled = await promptTelemetryOptIn();
+    // Append the telemetry section to the written config
+    try {
+        const existing = JSON.parse(readFileSync(path, 'utf8'));
+        existing.telemetry = { enabled: telemetryEnabled };
+        writeFileSync(path, JSON.stringify(existing, null, 2) + '\n', 'utf8');
+    }
+    catch {
+        // Non-fatal: if the append fails, telemetry defaults to disabled
+    }
+    if (telemetryEnabled) {
+        console.log('Telemetry enabled. Thank you! You can disable it anytime by setting telemetry.enabled to false.');
+    }
+    else {
+        console.log('Telemetry disabled. You can enable it anytime by setting telemetry.enabled to true in the config.');
+    }
+}
+/**
+ * Prompt the user to opt in to anonymous telemetry.
+ * Returns true if user answered 'y', false otherwise.
+ * Only shown interactively (stdin is a TTY).
+ */
+async function promptTelemetryOptIn() {
+    // Skip prompt when running non-interactively (e.g. in CI or piped input)
+    if (!process.stdin.isTTY)
+        return false;
+    process.stdout.write('\nHelp improve PureContext by sharing anonymous usage stats?\n' +
+        'This sends only aggregate counts (languages used, file counts, timing).\n' +
+        'No code, file names, or personal data is ever collected.\n' +
+        'See docs/TELEMETRY.md for the full list of what is sent.\n\n' +
+        'Enable telemetry? (y/N): ');
+    return new Promise((resolve) => {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        rl.once('line', (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === 'y');
+        });
+        // If stdin closes without input, default to false
+        rl.once('close', () => resolve(false));
+    });
+}
+/**
+ * `purecontext-mcp --health`
+ * Quick self-check: Node.js version, SQLite, grammar files, config, index dir.
+ * All output goes to stdout so it is easy to grep/capture.
+ * Returns true if all checks passed (exit 0), false if any failed (exit 1).
+ */
+export function cmdHealth(write = (l) => process.stdout.write(l + '\n')) {
+    const failures = [];
+    // ── Version header ───────────────────────────────────────────────────────
+    write(`purecontext-mcp v${VERSION}`);
+    // ── Node.js version ──────────────────────────────────────────────────────
+    const nodeVersion = process.version.replace(/^v/, '');
+    const [nodeMajor] = nodeVersion.split('.').map(Number);
+    if (nodeMajor >= 18) {
+        write(`✓ Node.js ${nodeVersion} (supported)`);
+    }
+    else {
+        write(`✗ Node.js ${nodeVersion} (unsupported — requires >= 18.0.0)`);
+        failures.push('node');
+    }
+    // ── SQLite / better-sqlite3 ──────────────────────────────────────────────
+    try {
+        const db = openInMemoryDatabase();
+        db.prepare('SELECT 1').get();
+        db.close();
+        write('✓ better-sqlite3 loaded (prebuilt binary)');
+    }
+    catch {
+        write('✗ better-sqlite3 failed to load — try: npm rebuild better-sqlite3');
+        failures.push('sqlite');
+    }
+    // ── Grammar WASM files ────────────────────────────────────────────────────
+    try {
+        const wasmFiles = readdirSync(GRAMMARS_DIR).filter((f) => f.endsWith('.wasm'));
+        if (wasmFiles.length > 0) {
+            write(`✓ Grammars: ${wasmFiles.length} languages available`);
+        }
+        else {
+            write('✗ Grammars: no grammar files found — try: npm install -g purecontext-mcp@latest');
+            failures.push('grammars');
+        }
+    }
+    catch {
+        write('✗ Grammars: grammar directory not found — try: npm install -g purecontext-mcp@latest');
+        failures.push('grammars');
+    }
+    // ── Config file ──────────────────────────────────────────────────────────
+    const configPath = getConfigPath();
+    if (!existsSync(configPath)) {
+        write('✓ Config: defaults in use (no config.json found)');
+    }
+    else {
+        try {
+            const raw = JSON.parse(readFileSync(configPath, 'utf8'));
+            const { valid, errors } = validateConfig(raw);
+            if (valid) {
+                write(`✓ Config: ${configPath} (valid)`);
+            }
+            else {
+                write(`✗ Config: ${configPath} (${errors.length} error(s) — run 'purecontext-mcp config --check')`);
+                failures.push('config');
+            }
+        }
+        catch {
+            write(`✗ Config: ${configPath} (parse error — run 'purecontext-mcp config --check')`);
+            failures.push('config');
+        }
+    }
+    // ── Index directory ───────────────────────────────────────────────────────
+    const cfg = loadConfig();
+    const indexDir = cfg.indexDir;
+    if (!existsSync(indexDir)) {
+        write(`✓ Index dir: ${indexDir} (not yet created — will be on first index)`);
+    }
+    else {
+        try {
+            const dbFiles = readdirSync(indexDir).filter((f) => f.endsWith('.db'));
+            const repoCount = dbFiles.length;
+            write(`✓ Index dir: ${indexDir} (exists, ${repoCount} repo${repoCount === 1 ? '' : 's'} indexed)`);
+        }
+        catch {
+            write(`✗ Index dir: ${indexDir} (read error)`);
+            failures.push('index-dir');
+        }
+    }
+    return failures.length === 0;
+}
+/**
+ * `purecontext-mcp config --check`
+ * Validate the current config and verify prerequisites (grammars, SQLite).
+ * Returns true if all checks pass.
+ */
+export function cmdCheck() {
+    // Show the quick health summary as a preamble
+    const healthOk = cmdHealth();
+    process.stdout.write('\n');
+    const path = getConfigPath();
+    const issues = [];
+    const passing = [];
+    // ── Config file ──────────────────────────────────────────────────────────
+    if (!existsSync(path)) {
+        passing.push('No config file — defaults in use');
+    }
+    else {
+        try {
+            const raw = JSON.parse(readFileSync(path, 'utf8'));
+            const { valid, errors } = validateConfig(raw);
+            if (valid) {
+                passing.push(`Config file valid: ${path}`);
+            }
+            else {
+                for (const e of errors)
+                    issues.push(`Config: ${e}`);
+            }
+        }
+        catch (err) {
+            issues.push(`Config parse error: ${err}`);
+        }
+    }
+    // ── Grammar WASM files ────────────────────────────────────────────────────
+    const grammars = [
+        'tree-sitter-typescript.wasm',
+        'tree-sitter-tsx.wasm',
+        'tree-sitter-javascript.wasm',
+    ];
+    for (const g of grammars) {
+        const gPath = join(GRAMMARS_DIR, g);
+        if (existsSync(gPath)) {
+            passing.push(`Grammar present: ${g}`);
+        }
+        else {
+            issues.push(`Grammar missing: ${gPath}`);
+        }
+    }
+    // ── SQLite sanity check ───────────────────────────────────────────────────
+    try {
+        const db = openInMemoryDatabase();
+        db.prepare('SELECT 1').get();
+        db.close();
+        passing.push('SQLite working');
+    }
+    catch (err) {
+        issues.push(`SQLite error: ${err}`);
+    }
+    // ── Effective settings ────────────────────────────────────────────────────
+    const cfg = loadConfig();
+    passing.push(`Index directory: ${cfg.indexDir}`);
+    passing.push(`File limit: ${cfg.fileLimit}`);
+    passing.push(`Watch debounce: ${cfg.watchDebounceMs}ms`);
+    // ── Report ────────────────────────────────────────────────────────────────
+    for (const msg of passing)
+        console.log(`  ✓  ${msg}`);
+    for (const msg of issues)
+        console.error(`  ✗  ${msg}`);
+    if (issues.length === 0 && healthOk) {
+        console.log('\nAll checks passed.');
+    }
+    else {
+        console.error(`\n${issues.length + (healthOk ? 0 : 1)} check(s) failed.`);
+    }
+    return issues.length === 0 && healthOk;
+}
+/**
+ * `purecontext-mcp config`
+ * Print the effective configuration (defaults merged with config.json) as JSON.
+ */
+export function cmdShow() {
+    const cfg = loadConfig();
+    console.log(JSON.stringify(cfg, null, 2));
+}
+//# sourceMappingURL=cli.js.map

package/dist/config/cli.js.map

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

package/dist/config/config-loader.d.ts

@@ -0,0 +1,26 @@
+import { type PureContextConfig } from './config-schema.js';
+/**
+ * Return the effective configuration.
+ *
+ * Resolution order (later values win):
+ *   1. Built-in defaults
+ *   2. `~/.purecontext/config.json` (if it exists)
+ *
+ * Result is cached after the first call. Call `reloadConfig()` to refresh.
+ */
+export declare function getConfig(): PureContextConfig;
+/**
+ * Clear the cached config so the next `getConfig()` call re-reads from disk.
+ */
+export declare function reloadConfig(): void;
+/**
+ * Load and merge config without caching. Useful for `config --check`.
+ */
+export declare function loadConfig(configPath?: string): PureContextConfig;
+/**
+ * Resolve `'${ENV_VAR}'` notation in a string value.
+ * Returns the environment variable value, or the original string if it doesn't
+ * match the notation, or an empty string if the variable is unset.
+ */
+export declare function resolveEnvVar(value: string): string;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../../src/config/config-loader.ts"],"names":[],"mappings":"AAKA,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAQ5B;;;;;;;;GAQG;AACH,wBAAgB,SAAS,IAAI,iBAAiB,CAI7C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,iBAAiB,CA6BjE;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQnD"}