@exero1/claudecontext 0.1.0

package/dist/src/graph/traversal.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/src/index.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * ClaudeContext MCP server entry point.
+ *
+ * CRITICAL: Never console.log() — stdout is the JSON-RPC channel.
+ * All logging goes to process.stderr.write().
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { existsSync, readFileSync, mkdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { z } from 'zod';
+import { Db } from './storage/db.js';
+import { registerTools } from './server.js';
+import { readLastLines, appendLog } from './markdown/writer.js';
+const log = (msg) => {
+    process.stderr.write(`[claudecontext] ${msg}\n`);
+};
+async function main() {
+    const startMs = Date.now();
+    // Determine project root from env or cwd
+    const projectRoot = resolve(process.env['CLAUDECONTEXT_PROJECT_ROOT'] ?? process.cwd());
+    const stateDir = join(projectRoot, '.claudecontext');
+    if (!existsSync(stateDir)) {
+        mkdirSync(stateDir, { recursive: true });
+    }
+    const dbPath = join(stateDir, 'state.db');
+    const l0LogPath = join(stateDir, 'l0.log');
+    const areasPath = join(stateDir, 'areas.json');
+    // Load and validate areas config with Zod
+    const AreaDefSchema = z.object({
+        name: z.string().min(1),
+        globs: z.array(z.string()),
+        docPath: z.string().min(1),
+    });
+    let areas = [];
+    if (existsSync(areasPath)) {
+        try {
+            const parsed = JSON.parse(readFileSync(areasPath, 'utf8'));
+            areas = z.array(AreaDefSchema).parse(parsed);
+        }
+        catch (e) {
+            log(`Warning: failed to parse/validate areas.json: ${e}. Proceeding without areas.`);
+        }
+    }
+    // Check for session lock conflict
+    if (Db.isLocked(stateDir)) {
+        log('Warning: another MCP server may be running for this project (stale lock ignored)');
+    }
+    // Open database
+    const db = new Db(dbPath);
+    log(`Database opened: ${dbPath}`);
+    // Recover L0 from disk (in case of crash)
+    const l0Lines = readLastLines(l0LogPath, 200);
+    if (l0Lines.length > 0) {
+        log(`Recovered ${l0Lines.length} L0 log lines from disk`);
+    }
+    // Record startup in L0
+    appendLog(l0LogPath, `[${new Date().toISOString()}] MCP server started (pid=${process.pid})`);
+    // Create MCP server
+    const server = new Server({ name: 'claudecontext', version: '0.1.0' }, { capabilities: { tools: {} } });
+    // Register all tools
+    registerTools(server, db, { projectRoot, stateDir, areas });
+    // Graceful shutdown
+    const shutdown = () => {
+        log('Shutting down...');
+        appendLog(l0LogPath, `[${new Date().toISOString()}] MCP server stopped`);
+        db.close();
+        process.exit(0);
+    };
+    process.on('SIGTERM', shutdown);
+    process.on('SIGINT', shutdown);
+    // Start stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log(`ClaudeContext MCP server ready (startup=${Date.now() - startMs}ms)`);
+}
+main().catch(err => {
+    process.stderr.write(`[claudecontext] Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/indexing/codebase.d.ts

@@ -0,0 +1,30 @@
+import type { Db } from '../storage/db.js';
+export interface RankedFile {
+    path: string;
+    score: number;
+    lastTouched: number;
+    touchCount: number;
+    graphNeighborBoost: boolean;
+}
+/**
+ * Score a file for relevance to the active task.
+ *
+ * Score components:
+ * - Recency: exp(-0.05 * daysSinceTouch) — files touched today score ~1.0
+ * - Frequency: log(touchCount + 1) / log(10) — diminishing returns on repeated touches
+ * - Graph boost: +0.2 if file has edges to active task files within 2 hops
+ */
+export declare function scoreFile(lastTouched: number, touchCount: number, hasGraphNeighbor: boolean, now?: number): number;
+/**
+ * Rank all indexed files by relevance to the active task.
+ * Returns top N files sorted by score descending.
+ */
+export declare function rankFiles(db: Db, taskFiles: string[], limit?: number): RankedFile[];
+/**
+ * Search for files matching a query string.
+ * Path-substring match + optional ripgrep content search (searchContent=true).
+ * Content matches receive a +0.5 score boost vs pure path matches.
+ * Multi-word queries default to searchContent=true (caller-controlled via server.ts).
+ */
+export declare function searchFiles(db: Db, query: string, taskFiles: string[], projectRoot: string, limit?: number, searchContent?: boolean): RankedFile[];
+//# sourceMappingURL=codebase.d.ts.map

package/dist/src/indexing/codebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase.d.ts","sourceRoot":"","sources":["../../../src/indexing/codebase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAG3C,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,OAAO,EACzB,GAAG,SAAa,GACf,MAAM,CAMR;AAsBD;;;GAGG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,SAAK,GACT,UAAU,EAAE,CAed;AAyBD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EAAE,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,SAAK,EACV,aAAa,UAAQ,GACpB,UAAU,EAAE,CAoDd"}

package/dist/src/indexing/codebase.js

@@ -0,0 +1,127 @@
+import { spawnSync } from 'node:child_process';
+/**
+ * Score a file for relevance to the active task.
+ *
+ * Score components:
+ * - Recency: exp(-0.05 * daysSinceTouch) — files touched today score ~1.0
+ * - Frequency: log(touchCount + 1) / log(10) — diminishing returns on repeated touches
+ * - Graph boost: +0.2 if file has edges to active task files within 2 hops
+ */
+export function scoreFile(lastTouched, touchCount, hasGraphNeighbor, now = Date.now()) {
+    const daysSince = (now - lastTouched) / (24 * 60 * 60 * 1000);
+    const recency = Math.exp(-0.05 * daysSince);
+    const frequency = Math.log(touchCount + 1) / Math.log(10);
+    const boost = hasGraphNeighbor ? 0.2 : 0.0;
+    return recency + frequency + boost;
+}
+/**
+ * Find files that are graph neighbors of the active task files (within 2 hops).
+ */
+function getGraphNeighbors(db, taskFiles) {
+    const neighbors = new Set();
+    for (const file of taskFiles) {
+        // Hop 1
+        const hop1 = db.getEdgesFrom(file, 20);
+        for (const edge of hop1) {
+            neighbors.add(edge.to_node);
+            // Hop 2
+            const hop2 = db.getEdgesFrom(edge.to_node, 10);
+            for (const e2 of hop2) {
+                neighbors.add(e2.to_node);
+            }
+        }
+    }
+    return neighbors;
+}
+/**
+ * Rank all indexed files by relevance to the active task.
+ * Returns top N files sorted by score descending.
+ */
+export function rankFiles(db, taskFiles, limit = 20) {
+    const graphNeighbors = getGraphNeighbors(db, taskFiles);
+    const allFiles = db.getTopFiles(500); // Pull enough from DB for re-ranking
+    const now = Date.now();
+    const ranked = allFiles.map(f => ({
+        path: f.path,
+        score: scoreFile(f.last_touched, f.touch_count, graphNeighbors.has(f.path), now),
+        lastTouched: f.last_touched,
+        touchCount: f.touch_count,
+        graphNeighborBoost: graphNeighbors.has(f.path),
+    }));
+    ranked.sort((a, b) => b.score - a.score);
+    return ranked.slice(0, limit);
+}
+/**
+ * Search file contents using ripgrep. Returns absolute paths of matching files.
+ * Falls back to empty array if rg is not available.
+ */
+function searchByContent(query, projectRoot, limit = 50) {
+    const result = spawnSync('rg', [
+        '--files-with-matches',
+        '--ignore-case',
+        '--max-count=1',
+        '--',
+        query,
+        projectRoot,
+    ], { encoding: 'utf8', timeout: 10_000 });
+    if (result.error || result.status !== 0)
+        return [];
+    return result.stdout
+        .split('\n')
+        .map(l => l.trim())
+        .filter(l => l.length > 0)
+        .slice(0, limit);
+}
+/**
+ * Search for files matching a query string.
+ * Path-substring match + optional ripgrep content search (searchContent=true).
+ * Content matches receive a +0.5 score boost vs pure path matches.
+ * Multi-word queries default to searchContent=true (caller-controlled via server.ts).
+ */
+export function searchFiles(db, query, taskFiles, projectRoot, limit = 10, searchContent = false) {
+    const graphNeighbors = getGraphNeighbors(db, taskFiles);
+    const allFiles = db.getTopFiles(1000);
+    const lowerQuery = query.toLowerCase();
+    const now = Date.now();
+    const contentMatchBoost = 0.5;
+    // Path matches from DB
+    const pathMatchPaths = new Set(allFiles.filter(f => f.path.toLowerCase().includes(lowerQuery)).map(f => f.path));
+    // Content matches via ripgrep (if enabled)
+    const contentMatchPaths = new Set();
+    if (searchContent) {
+        for (const f of searchByContent(query, projectRoot, 50)) {
+            contentMatchPaths.add(f);
+        }
+    }
+    // Score DB-indexed files that match path or content
+    const allMatchPaths = new Set([...pathMatchPaths, ...contentMatchPaths]);
+    const matches = allFiles
+        .filter(f => allMatchPaths.has(f.path))
+        .map(f => {
+        const baseScore = scoreFile(f.last_touched, f.touch_count, graphNeighbors.has(f.path), now);
+        // Boost content-only matches (not path matches) to surface content hits
+        const boost = contentMatchPaths.has(f.path) && !pathMatchPaths.has(f.path) ? contentMatchBoost : 0;
+        return {
+            path: f.path,
+            score: baseScore + boost,
+            lastTouched: f.last_touched,
+            touchCount: f.touch_count,
+            graphNeighborBoost: graphNeighbors.has(f.path),
+        };
+    });
+    // Add content-matched files not yet indexed in DB
+    for (const f of contentMatchPaths) {
+        if (!allFiles.some(af => af.path === f)) {
+            matches.push({
+                path: f,
+                score: contentMatchBoost,
+                lastTouched: 0,
+                touchCount: 0,
+                graphNeighborBoost: false,
+            });
+        }
+    }
+    matches.sort((a, b) => b.score - a.score);
+    return matches.slice(0, limit);
+}
+//# sourceMappingURL=codebase.js.map

package/dist/src/indexing/codebase.js.map

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

package/dist/src/markdown/writer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Atomic write: write to a temp file, then rename into place.
+ * This prevents partial writes corrupting the target file.
+ */
+export declare function atomicWrite(filePath: string, content: string): void;
+/**
+ * Read a file, returning empty string if it doesn't exist.
+ */
+export declare function safeRead(filePath: string): string;
+/**
+ * Patch a specific section in a markdown file.
+ * Sections are delimited by ## headings.
+ * If the section doesn't exist, it is appended.
+ *
+ * @param filePath - path to the markdown file
+ * @param sectionHeading - exact heading text (e.g. "Files touched")
+ * @param newContent - new content for the section (without the heading line)
+ */
+export declare function patchSection(filePath: string, sectionHeading: string, newContent: string): void;
+/**
+ * Append a line to an append-only log file (e.g., l0.log).
+ * Creates the file if it doesn't exist.
+ * If maxLines is set, rotates the file to keep only the last maxLines lines after appending.
+ */
+export declare function appendLog(filePath: string, line: string, maxLines?: number): void;
+/**
+ * Read the last N lines from a log file (tail behaviour).
+ */
+export declare function readLastLines(filePath: string, n: number): string[];
+/**
+ * Ensure a file exists with default content. Does nothing if file already exists.
+ */
+export declare function ensureFile(filePath: string, defaultContent: string): void;
+//# sourceMappingURL=writer.d.ts.map

package/dist/src/markdown/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/markdown/writer.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQnE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CA6B/F;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAWjF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAKnE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAIzE"}

package/dist/src/markdown/writer.js

@@ -0,0 +1,96 @@
+import { writeFileSync, readFileSync, existsSync, mkdirSync, renameSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { randomBytes } from 'node:crypto';
+/**
+ * Atomic write: write to a temp file, then rename into place.
+ * This prevents partial writes corrupting the target file.
+ */
+export function atomicWrite(filePath, content) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const tmp = join(dir, `.tmp-${randomBytes(6).toString('hex')}`);
+    writeFileSync(tmp, content, 'utf8');
+    renameSync(tmp, filePath);
+}
+/**
+ * Read a file, returning empty string if it doesn't exist.
+ */
+export function safeRead(filePath) {
+    if (!existsSync(filePath))
+        return '';
+    return readFileSync(filePath, 'utf8');
+}
+/**
+ * Patch a specific section in a markdown file.
+ * Sections are delimited by ## headings.
+ * If the section doesn't exist, it is appended.
+ *
+ * @param filePath - path to the markdown file
+ * @param sectionHeading - exact heading text (e.g. "Files touched")
+ * @param newContent - new content for the section (without the heading line)
+ */
+export function patchSection(filePath, sectionHeading, newContent) {
+    const existing = safeRead(filePath);
+    const headingLine = `## ${sectionHeading}`;
+    const lines = existing.split('\n');
+    const startIdx = lines.findIndex(l => l.trim() === headingLine);
+    if (startIdx === -1) {
+        // Section doesn't exist — append it
+        const appended = existing.trimEnd() + `\n\n${headingLine}\n${newContent}\n`;
+        atomicWrite(filePath, appended);
+        return;
+    }
+    // Find the next ## heading after startIdx
+    let endIdx = lines.length;
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        if (lines[i] !== undefined && lines[i].startsWith('## ')) {
+            endIdx = i;
+            break;
+        }
+    }
+    const before = lines.slice(0, startIdx + 1).join('\n');
+    const after = lines.slice(endIdx).join('\n');
+    const patched = after
+        ? `${before}\n${newContent}\n${after.startsWith('\n') ? after : '\n' + after}`
+        : `${before}\n${newContent}\n`;
+    atomicWrite(filePath, patched);
+}
+/**
+ * Append a line to an append-only log file (e.g., l0.log).
+ * Creates the file if it doesn't exist.
+ * If maxLines is set, rotates the file to keep only the last maxLines lines after appending.
+ */
+export function appendLog(filePath, line, maxLines) {
+    const dir = dirname(filePath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const entry = line.endsWith('\n') ? line : line + '\n';
+    writeFileSync(filePath, entry, { flag: 'a', encoding: 'utf8' });
+    if (maxLines !== undefined) {
+        const all = readFileSync(filePath, 'utf8').split('\n').filter(l => l.trim());
+        if (all.length > maxLines) {
+            writeFileSync(filePath, all.slice(-maxLines).join('\n') + '\n', 'utf8');
+        }
+    }
+}
+/**
+ * Read the last N lines from a log file (tail behaviour).
+ */
+export function readLastLines(filePath, n) {
+    if (!existsSync(filePath))
+        return [];
+    const content = readFileSync(filePath, 'utf8');
+    const lines = content.split('\n').filter(l => l.trim().length > 0);
+    return lines.slice(-n);
+}
+/**
+ * Ensure a file exists with default content. Does nothing if file already exists.
+ */
+export function ensureFile(filePath, defaultContent) {
+    if (!existsSync(filePath)) {
+        atomicWrite(filePath, defaultContent);
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/src/markdown/writer.js.map

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

package/dist/src/server.d.ts

@@ -0,0 +1,15 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import type { Db } from './storage/db.js';
+import type { AreaDef } from './graph/indexer.js';
+export interface ServerConfig {
+    projectRoot: string;
+    stateDir: string;
+    areas: AreaDef[];
+}
+/**
+ * Register all 10 ClaudeContext MCP tools on the given server.
+ * Protocol: 2025-03-26 — tool annotations required.
+ * NEVER console.log() — stdout is the JSON-RPC channel.
+ */
+export declare function registerTools(server: Server, db: Db, config: ServerConfig): void;
+//# sourceMappingURL=server.d.ts.map

package/dist/src/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAGnE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAM1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAOlD,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0gBhF"}