codestrate 0.1.0

package/README.md

@@ -0,0 +1,154 @@
+# Coding Intelligence MCP Server
+
+An "external fine-tuning" layer for cloud coding models (Claude Code, Codex, Gemini, OpenCode). Provides structural code retrieval via tree-sitter AST parsing, graph-based symbol navigation, project memory, and executable validation via the Model Context Protocol.
+
+## Architecture
+
+```
+Model (Claude Code / Codex / OpenCode)
+        │
+        │ MCP (stdio / HTTP)
+        ▼
+┌──────────────────────────────────────────────────────┐
+│              Coding Intelligence MCP Server          │
+├──────────────────────────────────────────────────────┤
+│  Tools (13)                                           │
+│  ├─ ci_get_context        — [Primary] Context bundle  │
+│  ├─ ci_repo_overview      — Project structure         │
+│  ├─ ci_search_code        — Hybrid code search        │
+│  ├─ ci_inspect_symbol     — Symbol definition         │
+│  ├─ ci_search_history     — Git history               │
+│  ├─ ci_recall_experience  — Past solutions             │
+│  ├─ ci_run_validation     — Build/test/lint           │
+│  ├─ ci_record_experience  — Save knowledge            │
+│  ├─ ci_trace_flow         — BFS call/import traversal  │
+│  ├─ ci_analyze_impact     — Change impact analysis     │
+│  ├─ ci_status             — Index state report         │
+│  ├─ ci_reindex            — Rebuild symbol index       │
+│  └─ ci_explore            — AST + graph unified query  │
+│                                                         │
+│  Prompts (3)                                            │
+│  ├─ debug-runtime-error   — 10-step debug workflow     │
+│  ├─ implement-feature     — 8-step impl workflow       │
+│  └─ review-code           — 6-step review              │
+└──────────────────────────────────────────────────────┘
+```
+
+## Quick Start
+
+```bash
+npx coding-intelligence-mcp-server
+```
+
+Or from source:
+
+```bash
+git clone <repo> && cd coding-intelligence-mcp-server
+npm install
+npm run build
+node dist/index.js
+```
+
+## Tools
+
+### Primary Tool
+- **`ci_get_context`** — Call FIRST for any task. Takes a natural language task description and returns relevant symbols, files, tests, git history, and past experiences within a token budget.
+
+### AST & Graph Intelligence
+- **`ci_explore`** — Unified code exploration: search by FTS5 full-text, camelCase segments, or symbol name across the graph index. Returns ranked nodes + edges with neighbor context.
+- **`ci_trace_flow`** — BFS traversal of call/import graph. Given a symbol, find callers and callees up to configurable depth. Uses tree-sitter parsed AST relations.
+- **`ci_inspect_symbol`** — Symbol definition with ±5 lines context, callers, callees, related tests, and graph neighbors.
+
+### Code Intelligence
+- **`ci_repo_overview`** — Scan repository to infer structure, build system, frameworks, entry points, and commands.
+- **`ci_search_code`** — Hybrid search (ripgrep + symbol matching) with BM25 scoring, language/scope filters.
+
+### Change Analysis
+- **`ci_analyze_impact`** — Given file changes, find dependents, imports, exports, and related tests using the graph index.
+- **`ci_status`** — Report index state: repo fingerprint, commit, indexed age, symbol/relation counts, staleness detection.
+- **`ci_reindex`** — Rebuild the symbol index from scratch (full) or via git diff (incremental).
+
+### Memory & Learning
+- **`ci_recall_experience`** — Retrieve past verified fixes and knowledge (hybrid: experiences + semantic memories).
+- **`ci_record_experience`** — Save a verified bug-fix with validation evidence (commit SHA, changed files, build/test pass).
+
+### Validation
+- **`ci_run_validation`** — Execute build/test/lint from config allowlist (permission-gated).
+
+### Git
+- **`ci_search_history`** — Search git commit history by message query.
+
+## Configuration
+
+Create `.ci-mcp.json` in your project root:
+
+```json
+{
+  "commands": {
+    "build": "npm run build",
+    "test": "npm test",
+    "lint": "npm run lint"
+  },
+  "timeout": 300,
+  "storePath": "~/.ci-mcp/store"
+}
+```
+
+Transport modes:
+- `stdio` (default) — for local use with Claude Code, OpenCode
+- `TRANSPORT=http PORT=3000` — for remote/HTTP access
+
+## Features
+
+### Tree-Sitter AST Parsing
+TypeScript and Python files are parsed via WASM-compiled tree-sitter grammars. The parser extracts:
+- Symbol definitions (class, interface, function, method, type, enum, variable)
+- Call relationships (who calls whom)
+- Import statements (dependency edges)
+- Export declarations
+
+Two WASM grammars (~1.8 MB total) ship with the npm package and load lazily.
+
+### Graph Model
+A directed graph of symbol dependencies is stored in SQLite with FTS5 full-text search:
+- **Nodes**: each symbol (class, function, method, etc.) is a node
+- **Edges**: calls, extends, implements, imports, composes — all stored as typed edges
+- **Search**: FTS5 (BM25-ranked), LIKE fallback, and **camelCase-aware** matching (`getUserData` → matches `%get%User%Data%`)
+- **Traversal**: BFS shortest-path search on the edge graph
+
+### SQLite Store (Production)
+The default persistence backend uses `better-sqlite3` with:
+- Schema migrations (5 current — initial, experiences, memories, FTS5, graph)
+- WAL journal for concurrent reads
+- Foreign key cascading for graph edge cleanup
+- In-memory mode available for tests
+
+## Comparison to Xanther
+
+| Feature | Xanther XCE | This Server |
+|---------|-------------|-------------|
+| Backend | Hosted | **Local/self-host** |
+| Symbol index | ✅ PRAT | **✅ Tree-sitter AST** |
+| Symbol graph | ❌ | **✅ BFS + FTS5 + camelCase** |
+| Code search | ✅ Semantic | ✅ Hybrid (rg + symbol) |
+| Context bundle | ✅ xce_get_context | ✅ ci_get_context |
+| Execution | ❌ | **✅ Build/test/lint** |
+| Verified memory | ❌ (XME Coming Soon) | **✅ Quality-scored** |
+| Steering files | ✅ | ✅ Prompts included |
+| Open source | Integration only | **Full code** |
+
+## Prompts
+
+Accessible as MCP Prompt resources:
+- `ci://prompts/debug-runtime-error`
+- `ci://prompts/implement-feature`
+- `ci://prompts/review-code`
+
+## Limitations
+- C++/Rust/Go/PHP AST parsing not yet available (only tree-sitter typescript + python WASM grammars are bundled)
+- JSON store (default) doesn't support FTS5 — SQLite mode required for full-text search
+- Incremental reindex (`ci_reindex --mode incremental`) uses git diff but only covers changed files, not cascading dependents
+
+## License
+
+MIT

package/dist/constants.d.ts

@@ -0,0 +1,40 @@
+import { type CIConfig } from "./types.js";
+export declare const SERVER_NAME = "coding-intelligence-mcp-server";
+export declare const SERVER_VERSION = "0.1.0";
+export declare const DEFAULT_STORE_PATH: string;
+export declare const INDEX_FILE = "index.json";
+export declare const MEMORY_FILE = "memory.json";
+export declare const MAX_RESPONSE_CHARS = 25000;
+export declare const MAX_SEARCH_RESULTS = 50;
+export declare const DEFAULT_SEARCH_LIMIT = 20;
+export declare const DEFAULT_CONTEXT_TOKEN_BUDGET = 12000;
+export declare const MIN_CONTEXT_TOKEN_BUDGET = 1000;
+export declare const MAX_CONTEXT_TOKEN_BUDGET = 16000;
+export declare const MAX_VALIDATION_TIMEOUT = 600;
+export declare const DEFAULT_VALIDATION_TIMEOUT = 300;
+export declare const MAX_VALIDATION_OUTPUT = 50000;
+export declare const MAX_RECALL_RESULTS = 10;
+/**
+ * Recommended number of primary-tool calls based on project size.
+ * Larger codebases need more exploration calls; smaller ones use
+ * fewer to avoid overhead.
+ */
+export declare function getExploreBudget(fileCount: number): number;
+/**
+ * Output character budget scaled to project size.
+ * User's explicit `maxResponseChars` in config wins unconditionally.
+ * Falls back to MAX_RESPONSE_CHARS when file count is unknown.
+ * Invariant: a larger tier must never get a smaller budget than a smaller one.
+ */
+export declare function getOutputBudget(configOverride: number | null | undefined, fileCount: number | null): number;
+export declare const CONTEXT_BUDGET_BREAKDOWN: {
+    readonly repoMap: 1000;
+    readonly primaryCode: 6000;
+    readonly dependencies: 3000;
+    readonly tests: 3000;
+    readonly memory: 2000;
+    readonly rules: 1000;
+};
+export declare const LANGUAGE_EXTENSIONS: Record<string, string[]>;
+export declare function loadConfig(repoPath?: string): CIConfig;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAO3C,eAAO,MAAM,WAAW,mCAAmC,CAAC;AAC5D,eAAO,MAAM,cAAc,UAAU,CAAC;AAItC,eAAO,MAAM,kBAAkB,QAAsC,CAAC;AACtE,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAIzC,eAAO,MAAM,kBAAkB,QAAS,CAAC;AACzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AACrC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,4BAA4B,QAAS,CAAC;AACnD,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAC9C,eAAO,MAAM,qBAAqB,QAAS,CAAC;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAgBrC;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAOR;AAED,eAAO,MAAM,wBAAwB;;;;;;;CAO3B,CAAC;AAIX,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAmBxD,CAAC;AAUF,wBAAgB,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,QAAQ,CA0CtD"}

package/dist/constants.js

@@ -0,0 +1,145 @@
+import { homedir } from "os";
+import { join, resolve } from "path";
+import { existsSync, readFileSync } from "fs";
+// ─── Server identity ──────────────────────────────────────
+export const SERVER_NAME = "coding-intelligence-mcp-server";
+export const SERVER_VERSION = "0.1.0";
+// ─── Default paths ────────────────────────────────────────
+export const DEFAULT_STORE_PATH = join(homedir(), ".ci-mcp", "store");
+export const INDEX_FILE = "index.json";
+export const MEMORY_FILE = "memory.json";
+// ─── Limits ───────────────────────────────────────────────
+export const MAX_RESPONSE_CHARS = 25_000;
+export const MAX_SEARCH_RESULTS = 50;
+export const DEFAULT_SEARCH_LIMIT = 20;
+export const DEFAULT_CONTEXT_TOKEN_BUDGET = 12_000;
+export const MIN_CONTEXT_TOKEN_BUDGET = 1_000;
+export const MAX_CONTEXT_TOKEN_BUDGET = 16_000;
+export const MAX_VALIDATION_TIMEOUT = 600;
+export const DEFAULT_VALIDATION_TIMEOUT = 300;
+export const MAX_VALIDATION_OUTPUT = 50_000;
+export const MAX_RECALL_RESULTS = 10;
+// ─── Adaptive output budget ────────────────────────────
+// Scale response size by project file count. Small repos don't
+// need the same ceiling as large ones — tighter budgets prevent
+// context bloat and force tools to prioritize relevance.
+// Invariant: a larger tier must never get a smaller per-call budget
+// than a smaller tier.
+const FILE_TIERS = [
+    { max: 150, budget: 13_000 },
+    { max: 500, budget: 18_000 },
+    { max: 5_000, budget: 24_000 },
+    { max: Infinity, budget: 24_000 },
+];
+/**
+ * Recommended number of primary-tool calls based on project size.
+ * Larger codebases need more exploration calls; smaller ones use
+ * fewer to avoid overhead.
+ */
+export function getExploreBudget(fileCount) {
+    if (fileCount < 500)
+        return 1;
+    else if (fileCount < 5_000)
+        return 2;
+    else if (fileCount < 15_000)
+        return 3;
+    else if (fileCount < 25_000)
+        return 4;
+    else
+        return 5;
+}
+/**
+ * Output character budget scaled to project size.
+ * User's explicit `maxResponseChars` in config wins unconditionally.
+ * Falls back to MAX_RESPONSE_CHARS when file count is unknown.
+ * Invariant: a larger tier must never get a smaller budget than a smaller one.
+ */
+export function getOutputBudget(configOverride, fileCount) {
+    if (configOverride && configOverride > 0)
+        return configOverride;
+    if (!fileCount || fileCount <= 0)
+        return MAX_RESPONSE_CHARS;
+    for (const { max, budget } of FILE_TIERS) {
+        if (fileCount <= max)
+            return budget;
+    }
+    return MAX_RESPONSE_CHARS;
+}
+export const CONTEXT_BUDGET_BREAKDOWN = {
+    repoMap: 1_000,
+    primaryCode: 6_000,
+    dependencies: 3_000,
+    tests: 3_000,
+    memory: 2_000,
+    rules: 1_000,
+};
+// ─── File extensions by language ──────────────────────────
+export const LANGUAGE_EXTENSIONS = {
+    typescript: [".ts", ".tsx", ".mts", ".cts"],
+    javascript: [".js", ".jsx", ".mjs", ".cjs"],
+    python: [".py", ".pyi", ".pyx"],
+    java: [".java", ".kt", ".kts"],
+    kotlin: [".kt", ".kts"],
+    rust: [".rs", ".rlib"],
+    go: [".go"],
+    csharp: [".cs", ".csx"],
+    cpp: [".cpp", ".cc", ".cxx", ".hpp", ".h"],
+    c: [".c", ".h"],
+    ruby: [".rb"],
+    php: [".php"],
+    swift: [".swift"],
+    dart: [".dart"],
+    scala: [".scala"],
+    haskell: [".hs"],
+    elixir: [".ex", ".exs"],
+    clojure: [".clj", ".cljs", ".cljc"],
+};
+// ─── Config loader ────────────────────────────────────────
+const CONFIG_FILES = [
+    ".ci-mcp.json",
+    "ci-mcp.config.json",
+    ".coding-intelligence.json",
+];
+export function loadConfig(repoPath) {
+    const basePath = repoPath || process.cwd();
+    for (const file of CONFIG_FILES) {
+        const path = resolve(basePath, file);
+        if (existsSync(path)) {
+            try {
+                const raw = readFileSync(path, "utf-8");
+                const cfg = JSON.parse(raw);
+                return {
+                    repoPath: basePath,
+                    storePath: cfg.storePath || DEFAULT_STORE_PATH,
+                    maxResponseChars: cfg.maxResponseChars || MAX_RESPONSE_CHARS,
+                    validation: {
+                        commands: {
+                            build: cfg.commands?.build ?? null,
+                            test: cfg.commands?.test ?? null,
+                            lint: cfg.commands?.lint ?? null,
+                        },
+                        timeout: cfg.timeout ?? DEFAULT_VALIDATION_TIMEOUT,
+                        maxOutput: cfg.maxOutput ?? MAX_VALIDATION_OUTPUT,
+                    },
+                    embeddingMode: cfg.embeddingMode || "none",
+                    embeddingApi: cfg.embeddingApi,
+                };
+            }
+            catch {
+                // fall through
+            }
+        }
+    }
+    return {
+        repoPath: basePath,
+        storePath: DEFAULT_STORE_PATH,
+        maxResponseChars: MAX_RESPONSE_CHARS,
+        validation: {
+            commands: { build: undefined, test: undefined, lint: undefined },
+            timeout: DEFAULT_VALIDATION_TIMEOUT,
+            maxOutput: MAX_VALIDATION_OUTPUT,
+        },
+        embeddingMode: "none",
+    };
+}
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

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

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,134 @@
+#!/usr/bin/env node
+/**
+ * Coding Intelligence MCP Server
+ *
+ * An "external fine-tuning" layer for cloud coding models.
+ * Provides structural code retrieval, project memory, and executable validation.
+ *
+ * Tools:
+ *   ci_repo_overview     — Project structure, build system, frameworks
+ *   ci_search_code       — Hybrid code search (ripgrep + symbol matching)
+ *   ci_inspect_symbol    — Symbol definition, callers, callees, tests
+ *   ci_get_context       — [Primary] Context bundle for a task
+ *   ci_search_history    — Git commit history search
+ *   ci_recall_experience — Retrieve past verified solutions
+ *   ci_trace_flow        — Call/import flow graph traversal
+ *   ci_status            — Index health and staleness check
+ *   ci_run_validation    — Execute build/test/lint (allowlist-gated)
+ *   ci_analyze_impact    — Multi-file change impact analysis
+ *   ci_reindex           — Full or incremental re-indexing
+ *   ci_record_experience — Save verified experience to memory
+ *
+ * Resources (prompts):
+ *   ci://prompts/debug-runtime-error
+ *   ci://prompts/implement-feature
+ *   ci://prompts/review-code
+ *
+ * Usage:
+ *   node dist/index.js          # stdio mode (default for local use)
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { readFileSync, existsSync } from "fs";
+import { join, resolve } from "path";
+import { SERVER_NAME, SERVER_VERSION } from "./constants.js";
+import { loadIndex } from "./store/index.js";
+import { loadMemoryStore } from "./store/memory.js";
+import { loadConfig } from "./constants.js";
+// ─── Import tool registrations ────────────────────────────
+import { registerRepoOverview } from "./tools/repo-overview.js";
+import { registerSearchCode } from "./tools/search-code.js";
+import { registerInspectSymbol } from "./tools/inspect-symbol.js";
+import { registerGetContext } from "./tools/get-context.js";
+import { registerSearchHistory } from "./tools/search-history.js";
+import { registerRecallExperience } from "./tools/recall-experience.js";
+import { registerRunValidation } from "./tools/run-validation.js";
+import { registerRecordExperience } from "./tools/record-experience.js";
+import { registerTraceFlow } from "./tools/trace-flow.js";
+import { registerStatus } from "./tools/status.js";
+import { registerReindex } from "./tools/reindex.js";
+import { registerAnalyzeImpact } from "./tools/analyze-impact.js";
+import { registerExplore } from "./tools/explore.js";
+// ─── Initialize server ────────────────────────────────────
+const server = new McpServer({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+});
+// ─── Load persisted state ─────────────────────────────────
+const config = loadConfig();
+if (config.repoPath) {
+    loadIndex(config.storePath);
+    loadMemoryStore(config.storePath);
+}
+// ─── Register tools ───────────────────────────────────────
+registerRepoOverview(server);
+registerSearchCode(server);
+registerInspectSymbol(server);
+registerGetContext(server);
+registerSearchHistory(server);
+registerRecallExperience(server);
+registerTraceFlow(server);
+registerStatus(server);
+registerRunValidation(server);
+registerAnalyzeImpact(server);
+registerReindex(server);
+registerRecordExperience(server);
+registerExplore(server);
+// ─── Register prompt resources ────────────────────────────
+const PROMPTS_DIR = resolve(import.meta.dirname, "../prompts");
+function registerPromptResource(name, description) {
+    const label = name.replace(/-/g, " ").replace(/\b\w/g, c => c.toUpperCase());
+    const filePath = join(PROMPTS_DIR, `${name}.md`);
+    // Register as a resource
+    server.registerResource(label, `ci://prompts/${name}`, { mimeType: "text/markdown", description }, async (uri) => {
+        if (!existsSync(filePath)) {
+            throw new Error(`Prompt not found: ${name}`);
+        }
+        const content = readFileSync(filePath, "utf-8");
+        return {
+            contents: [{
+                    uri: uri.toString(),
+                    mimeType: "text/markdown",
+                    text: content,
+                }],
+        };
+    });
+    // Register as a prompt template
+    server.registerPrompt(name, { description, argsSchema: undefined }, async (args) => {
+        if (!existsSync(filePath)) {
+            throw new Error(`Prompt not found: ${name}`);
+        }
+        let content = readFileSync(filePath, "utf-8");
+        if (args.task) {
+            content = content.replace(/\{\{task\}\}/g, args.task);
+        }
+        return {
+            messages: [
+                {
+                    role: "user",
+                    content: {
+                        type: "text",
+                        text: content,
+                    },
+                },
+            ],
+        };
+    });
+}
+registerPromptResource("debug-runtime-error", "10-step workflow for debugging runtime errors");
+registerPromptResource("implement-feature", "8-step workflow for implementing new features");
+registerPromptResource("review-code", "6-step code review checklist with security and testing concerns");
+// ─── Transport setup ──────────────────────────────────────
+async function runStdio() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`${SERVER_NAME} v${SERVER_VERSION} running via stdio`);
+    console.error(`Tools: repo_overview, search_code, inspect_symbol, get_context, search_history, recall_experience, trace_flow, status, run_validation, analyze_impact, reindex, record_experience`);
+    console.error(`Prompts: debug-runtime-error, implement-feature, review-code`);
+}
+// ─── Entry point ──────────────────────────────────────────
+runStdio().catch(error => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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