purecontext-mcp 1.0.1

package/dist/config/config-loader.js

@@ -0,0 +1,168 @@
+import { readFileSync, existsSync } from 'fs';
+import { randomBytes } from 'crypto';
+import { join } from 'path';
+import { logger } from '../core/logger.js';
+import { ConfigValidationError } from '../core/errors.js';
+import { DEFAULT_CONFIG, getConfigPath, validateConfig, } from './config-schema.js';
+// ─── Module-level singleton ────────────────────────────────────────────────────
+let _loaded = null;
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * 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 function getConfig() {
+    if (_loaded)
+        return _loaded;
+    _loaded = loadConfig();
+    return _loaded;
+}
+/**
+ * Clear the cached config so the next `getConfig()` call re-reads from disk.
+ */
+export function reloadConfig() {
+    _loaded = null;
+}
+/**
+ * Load and merge config without caching. Useful for `config --check`.
+ */
+export function loadConfig(configPath) {
+    const path = configPath ?? getConfigPath();
+    if (!existsSync(path)) {
+        logger.debug(`No config file found at ${path} — using defaults`);
+        return mergeConfig({});
+    }
+    let raw;
+    try {
+        const text = readFileSync(path, 'utf8');
+        raw = JSON.parse(text);
+    }
+    catch (err) {
+        logger.warn(`Failed to parse config at ${path}: ${err} — using defaults`);
+        return mergeConfig({});
+    }
+    const { valid, errors } = validateConfig(raw);
+    if (!valid) {
+        const formatted = errors.map((e) => `  ${e}`).join('\n');
+        const err = new ConfigValidationError(formatted, path);
+        logger.warn(`${err.userMessage}\nRun 'purecontext-mcp config --check' for full validation.\n` +
+            'Falling back to defaults.');
+        return { ...DEFAULT_CONFIG, ai: { ...DEFAULT_CONFIG.ai }, telemetry: { ...DEFAULT_CONFIG.telemetry } };
+    }
+    return mergeConfig(raw);
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * 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 function resolveEnvVar(value) {
+    const match = /^\$\{([^}]+)\}$/.exec(value);
+    if (!match)
+        return value;
+    const resolved = process.env[match[1]] ?? '';
+    if (!resolved) {
+        logger.warn(`Config: env variable "${match[1]}" referenced in ai.apiKey is not set`);
+    }
+    return resolved;
+}
+function mergeConfig(partial) {
+    // Environment variable overrides (priority: env var > config file > default)
+    const pctxDataDir = process.env['PCTX_DATA_DIR'];
+    const pctxPort = process.env['PCTX_PORT'] ? parseInt(process.env['PCTX_PORT'], 10) : undefined;
+    const pctxHost = process.env['PCTX_HOST'];
+    const rawApiKey = partial.ai?.apiKey ?? DEFAULT_CONFIG.ai.apiKey;
+    const resolvedApiKey = resolveEnvVar(rawApiKey);
+    // Resolve auth token (supports ${ENV_VAR} notation)
+    const authEnabled = partial.http?.auth?.enabled ?? DEFAULT_CONFIG.http.auth.enabled;
+    const rawAuthToken = partial.http?.auth?.token ?? DEFAULT_CONFIG.http.auth.token;
+    let resolvedAuthToken = resolveEnvVar(rawAuthToken);
+    // Generate a random token if auth is enabled but no token is configured
+    if (authEnabled && !resolvedAuthToken) {
+        resolvedAuthToken = randomBytes(32).toString('hex');
+        process.stderr.write(`PureContext MCP auth token: ${resolvedAuthToken}\n`);
+    }
+    const cfg = {
+        indexDir: pctxDataDir
+            ? join(pctxDataDir, 'indexes')
+            : (partial.indexDir ?? DEFAULT_CONFIG.indexDir),
+        fileLimit: partial.fileLimit ?? DEFAULT_CONFIG.fileLimit,
+        watchDebounceMs: partial.watchDebounceMs ?? DEFAULT_CONFIG.watchDebounceMs,
+        concurrency: partial.concurrency ?? DEFAULT_CONFIG.concurrency,
+        excludePatterns: partial.excludePatterns ?? DEFAULT_CONFIG.excludePatterns,
+        adapters: partial.adapters ?? DEFAULT_CONFIG.adapters,
+        ai: {
+            provider: partial.ai?.provider ?? DEFAULT_CONFIG.ai.provider,
+            allowRemoteAI: partial.ai?.allowRemoteAI ?? DEFAULT_CONFIG.ai.allowRemoteAI,
+            apiKey: resolvedApiKey,
+            endpoint: partial.ai?.endpoint !== undefined ? partial.ai.endpoint : DEFAULT_CONFIG.ai.endpoint,
+            model: partial.ai?.model ?? DEFAULT_CONFIG.ai.model,
+            batchSize: partial.ai?.batchSize ?? DEFAULT_CONFIG.ai.batchSize,
+            embeddingModel: partial.ai?.embeddingModel !== undefined
+                ? partial.ai.embeddingModel
+                : DEFAULT_CONFIG.ai.embeddingModel,
+            embeddingProvider: partial.ai?.embeddingProvider !== undefined
+                ? partial.ai.embeddingProvider
+                : DEFAULT_CONFIG.ai.embeddingProvider,
+            openaiApiKey: resolveEnvVar(partial.ai?.openaiApiKey ?? DEFAULT_CONFIG.ai.openaiApiKey),
+        },
+        semantic: {
+            enabled: partial.semantic?.enabled ?? DEFAULT_CONFIG.semantic.enabled,
+            provider: partial.semantic?.provider ?? DEFAULT_CONFIG.semantic.provider,
+            localEmbeddingEndpoint: partial.semantic?.localEmbeddingEndpoint !== undefined
+                ? partial.semantic.localEmbeddingEndpoint
+                : DEFAULT_CONFIG.semantic.localEmbeddingEndpoint,
+            dimension: partial.semantic?.dimension !== undefined
+                ? partial.semantic.dimension
+                : DEFAULT_CONFIG.semantic.dimension,
+            threshold: partial.semantic?.threshold ?? DEFAULT_CONFIG.semantic.threshold,
+            batchSize: partial.semantic?.batchSize ?? DEFAULT_CONFIG.semantic.batchSize,
+            concurrency: partial.semantic?.concurrency ?? DEFAULT_CONFIG.semantic.concurrency,
+        },
+        maxFileSizeBytes: partial.maxFileSizeBytes ?? DEFAULT_CONFIG.maxFileSizeBytes,
+        allowSymlinks: partial.allowSymlinks ?? DEFAULT_CONFIG.allowSymlinks,
+        transport: partial.transport ?? DEFAULT_CONFIG.transport,
+        http: {
+            port: pctxPort ?? partial.http?.port ?? DEFAULT_CONFIG.http.port,
+            host: pctxHost ?? partial.http?.host ?? DEFAULT_CONFIG.http.host,
+            corsOrigins: partial.http?.corsOrigins ?? DEFAULT_CONFIG.http.corsOrigins,
+            auth: {
+                enabled: authEnabled,
+                token: resolvedAuthToken,
+            },
+        },
+        rateLimit: {
+            enabled: partial.rateLimit?.enabled ?? DEFAULT_CONFIG.rateLimit.enabled,
+            maxTokens: partial.rateLimit?.maxTokens ?? DEFAULT_CONFIG.rateLimit.maxTokens,
+            refillRate: partial.rateLimit?.refillRate ?? DEFAULT_CONFIG.rateLimit.refillRate,
+            perToolLimits: partial.rateLimit?.perToolLimits !== undefined
+                ? { ...DEFAULT_CONFIG.rateLimit.perToolLimits, ...partial.rateLimit.perToolLimits }
+                : { ...DEFAULT_CONFIG.rateLimit.perToolLimits },
+        },
+        layers: partial.layers !== undefined ? partial.layers : DEFAULT_CONFIG.layers,
+        server: {
+            requireAuth: partial.server?.requireAuth ?? DEFAULT_CONFIG.server.requireAuth,
+            adminKey: process.env['PCTX_ADMIN_KEY'] ?? partial.server?.adminKey ?? DEFAULT_CONFIG.server.adminKey,
+        },
+        telemetry: {
+            enabled: partial.telemetry?.enabled ?? DEFAULT_CONFIG.telemetry.enabled,
+            endpoint: partial.telemetry?.endpoint ?? DEFAULT_CONFIG.telemetry.endpoint,
+        },
+    };
+    // Warn if remote AI is enabled but no key is available
+    if (cfg.ai.allowRemoteAI && cfg.ai.provider !== 'none' && !cfg.ai.apiKey) {
+        logger.warn('ai.allowRemoteAI is true but ai.apiKey is empty — AI summarization will be skipped');
+    }
+    // Warn if host is not loopback and auth is disabled
+    if (cfg.transport !== 'stdio' && cfg.http.host !== '127.0.0.1' && !cfg.http.auth.enabled) {
+        logger.warn(`HTTP server bound to ${cfg.http.host} without auth — consider enabling http.auth.enabled`);
+    }
+    return cfg;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config/config-loader.js.map

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

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

@@ -0,0 +1,228 @@
+export interface PureContextConfig {
+    /** Directory where SQLite index files are stored. */
+    indexDir: string;
+    /** Maximum number of source files to index per project. 0 = unlimited. Default: 10000. */
+    fileLimit: number;
+    /** Debounce window in ms for the file watcher (default 2000). */
+    watchDebounceMs: number;
+    /** Worker threads for parallel parsing. Default: min(CPU count, 8). */
+    concurrency: number;
+    /** Additional glob patterns to exclude during file discovery. */
+    excludePatterns: string[];
+    /**
+     * Which framework adapters to activate.
+     *   'auto'   — detect from project config files (default)
+     *   'none'   — disable all adapters
+     *   string[] — explicit list (e.g. ['vue', 'nuxt'])
+     */
+    adapters: 'auto' | 'none' | string[];
+    /** AI summarization settings. */
+    ai: {
+        /**
+         * AI provider for symbol summarization.
+         *   'none'               — disables AI (default)
+         *   'anthropic'          — Anthropic Messages API (uses ANTHROPIC_API_KEY or ai.apiKey)
+         *   'openai-compatible'  — any OpenAI-compatible /v1/chat/completions endpoint
+         */
+        provider: 'anthropic' | 'openai-compatible' | 'none';
+        /** Allow the server to make outbound AI API calls (default false). */
+        allowRemoteAI: boolean;
+        /**
+         * API key. Accepts a literal key or `'${ENV_VAR}'` notation (resolved from env at load time).
+         * For 'anthropic', falls back to ANTHROPIC_API_KEY if not set.
+         */
+        apiKey: string;
+        /**
+         * Base URL for the OpenAI-compatible endpoint (e.g. 'http://localhost:11434').
+         * Required when provider is 'openai-compatible'. Ignored for 'anthropic'.
+         */
+        endpoint: string | null;
+        /** Model to use. Defaults to 'claude-haiku-4-5-20251001' for Anthropic, 'gpt-4o-mini' for openai-compatible. */
+        model: string;
+        /** Number of symbols per API batch (default 50). Lower values suit self-hosted models with small context windows. */
+        batchSize: number;
+        /**
+         * Embedding model name for semantic search.
+         * For 'voyage' provider: 'voyage-code-2' (default).
+         * For 'openai-compatible': model supported by the endpoint (e.g. 'nomic-embed-text').
+         * null = no embeddings.
+         */
+        embeddingModel: string | null;
+        /**
+         * Embedding provider for semantic search.
+         * 'voyage'            — Voyage AI (Anthropic-recommended for code, uses ai.apiKey).
+         * 'openai-compatible' — any /v1/embeddings endpoint (uses ai.endpoint and ai.apiKey).
+         * null                — semantic search disabled (FTS5 keyword fallback only).
+         */
+        embeddingProvider: 'voyage' | 'openai-compatible' | null;
+        /**
+         * API key for OpenAI services (embeddings, etc.).
+         * Accepts a literal key or '${ENV_VAR}' notation.
+         * Falls back to OPENAI_API_KEY env var if not set.
+         */
+        openaiApiKey: string;
+    };
+    /** Phase 11 semantic search settings (HNSW + embeddings). */
+    semantic: {
+        /**
+         * Whether semantic search is active.
+         * When false (default), all search falls back to FTS keyword search.
+         */
+        enabled: boolean;
+        /**
+         * Embedding provider for Phase 11 HNSW semantic search.
+         *   'anthropic' — Anthropic embedding endpoint (uses ai.apiKey / ANTHROPIC_API_KEY)
+         *   'openai'    — OpenAI text-embedding-3-small (uses ai.openaiApiKey / OPENAI_API_KEY)
+         *   'local'     — Local model via Ollama or similar (uses semantic.localEmbeddingEndpoint)
+         *   'none'      — Semantic search disabled (default)
+         */
+        provider: 'anthropic' | 'openai' | 'local' | 'none';
+        /**
+         * Base URL for local embedding endpoint (e.g. 'http://localhost:11434').
+         * Required when provider is 'local'.
+         */
+        localEmbeddingEndpoint: string | null;
+        /**
+         * Embedding vector dimension.
+         * null = auto-detected from provider (1024 for Anthropic, 1536 for OpenAI, 384 for local).
+         */
+        dimension: number | null;
+        /**
+         * Minimum symbol count to trigger semantic indexing (default: 50000).
+         * Repos below this threshold use FTS-only search.
+         * Lower this value to test semantic indexing on small repos.
+         */
+        threshold: number;
+        /**
+         * Number of symbols per embedding batch (default: 500).
+         * Balances API call overhead against memory usage.
+         */
+        batchSize: number;
+        /**
+         * Number of parallel embedding batches (default: 2).
+         * Higher values improve throughput but increase API quota usage.
+         */
+        concurrency: number;
+    };
+    /** Maximum file size in bytes to index (default: 1 MB). Files larger than this are skipped. */
+    maxFileSizeBytes: number;
+    /**
+     * When false (default), symlinks that resolve to a path outside the project root are blocked.
+     * Set to true only if your project intentionally uses external symlinks.
+     */
+    allowSymlinks: boolean;
+    /**
+     * Which transport(s) to start.
+     *   'stdio' — stdin/stdout (default; required for Claude Code)
+     *   'http'  — HTTP + Streamable HTTP
+     *   'both'  — stdio AND HTTP simultaneously
+     */
+    transport: 'stdio' | 'http' | 'both';
+    /** HTTP server settings (used when transport is 'http' or 'both'). */
+    http: {
+        /** TCP port to listen on (default: 3000). */
+        port: number;
+        /** Interface to bind to (default: '127.0.0.1' — loopback only). */
+        host: string;
+        /**
+         * Allowed CORS origins. Supports '*' wildcard within a segment.
+         * Default: ['http://localhost:*'] — any localhost port.
+         */
+        corsOrigins: string[];
+        /** Bearer token authentication for the HTTP transport. */
+        auth: {
+            /**
+             * Enable bearer token authentication on all /mcp requests.
+             * Default: false. Strongly recommended when host is not '127.0.0.1'.
+             */
+            enabled: boolean;
+            /**
+             * Bearer token to require. Supports '${ENV_VAR}' notation.
+             * If enabled=true and this is empty, a random token is generated
+             * at startup and printed to stderr.
+             */
+            token: string;
+        };
+    };
+    /**
+     * Rate limiting settings (HTTP transport only).
+     * Ignored when transport is 'stdio'.
+     */
+    rateLimit: {
+        /**
+         * Enable rate limiting on all MCP tool calls.
+         * Default: true (HTTP transport). Stdio transport never rate-limits.
+         */
+        enabled: boolean;
+        /**
+         * Maximum tokens a single client bucket can accumulate (burst capacity).
+         * Default: 100.
+         */
+        maxTokens: number;
+        /**
+         * Tokens replenished per second for each client bucket.
+         * Default: 10.
+         */
+        refillRate: number;
+        /**
+         * Token costs per MCP tool name. Tools not listed cost 1 token.
+         * Expensive operations (e.g. indexing) should have higher costs.
+         */
+        perToolLimits: Record<string, number>;
+    };
+    /**
+     * Architectural layer definitions and allowed dependency directions.
+     * Used by the get_layer_violations tool.
+     * null means no layer config — the tool will report an error if called without inline config.
+     */
+    layers: LayersConfig | null;
+    /**
+     * Server mode settings (used when `--server` flag or transport is 'http'/'both').
+     */
+    server: {
+        /**
+         * Require API key authentication on all /mcp and /api/* requests.
+         * Default: false (local stdio mode). Automatically true in --server mode.
+         */
+        requireAuth: boolean;
+        /**
+         * Admin key for /admin/* endpoints.
+         * Prefer setting via PCTX_ADMIN_KEY environment variable — never commit to config.json.
+         * When blank, falls back to PCTX_ADMIN_KEY env var.
+         */
+        adminKey: string;
+    };
+    /** Anonymous opt-in telemetry settings. Default: disabled. */
+    telemetry: {
+        /** Send anonymous usage stats (languages used, file counts, timing). Default: false. */
+        enabled: boolean;
+        /**
+         * Endpoint to POST telemetry events to.
+         * Default: 'https://telemetry.purecontext.dev/v1/event'.
+         */
+        endpoint: string;
+    };
+}
+export interface LayerDefinition {
+    /** Layer name (e.g. 'core', 'handlers'). */
+    name: string;
+    /** Glob patterns for files belonging to this layer (relative to repo root). */
+    paths: string[];
+}
+export interface LayerRule {
+    from: string;
+    to: string;
+    allowed: boolean;
+}
+export interface LayersConfig {
+    definitions: LayerDefinition[];
+    rules: LayerRule[];
+}
+export declare const DEFAULT_CONFIG: PureContextConfig;
+export declare function getConfigPath(): string;
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateConfig(raw: unknown): ValidationResult;
+//# sourceMappingURL=config-schema.d.ts.map

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

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