contextsliver 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DevMuneeb
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+# ContextSliver
+
+> On-demand context management for AI coding agents. Stop reading whole files — ask for the connected subgraph instead.
+
+[![CI](https://github.com/DevMuneeb/contextsliver/actions/workflows/ci.yml/badge.svg)](https://github.com/DevMuneeb/contextsliver/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://img.shields.io/npm/v/contextsliver.svg)](https://www.npmjs.com/package/contextsliver)
+
+## The problem
+
+When you ask an AI coding agent (Claude Code, Cursor, Cline) to *"fix the bug in AuthService,"* it
+repeatedly reads entire files to find the 5% that's relevant — burning 40,000–80,000 tokens on a
+question that needed ~3,000.
+
+```text
+find . -name "*.ts"   → 2,000 tokens (a file listing)
+cat AuthService.ts    → 3,000 tokens (whole file)
+grep -r "AuthService" → 5,000 tokens (40 matches)
+cat AuthMiddleware.ts → 2,500 tokens (whole file, again)
+... × 10 more ...
+```
+
+Existing tools don't fully fix it: Graphify dumps one enormous whole-repo map into context up front;
+Repomix packs the entire repo into one file; Aider's repo-map sends a whole-repo summary with every
+message. **None of them track what the agent has already seen this session.**
+
+## What ContextSliver does
+
+ContextSliver runs as a background **MCP server** on your machine. It indexes your codebase into a
+local SQLite graph of every function, class, and import. When the agent needs context, it calls an
+MCP tool instead of reading files:
+
+```text
+Agent:   "What connects to AuthService? Budget: 2,000 tokens."
+
+ContextSliver:
+  symbol:        AuthService  (src/auth/AuthService.ts)
+  callers:       [AuthMiddleware, LoginController]      ← who uses it
+  dependencies:  [UserRepository, TokenService]         ← what it uses
+  already_in_context: [UserRepository]                  ← skipped, agent already has it
+  // ~380 tokens
+```
+
+Three things make it different:
+
+1. **On-demand pruning** — never sends the whole graph, only the connected subgraph for the task.
+2. **Session ledger** — tracks what the agent has already seen and skips re-sending it.
+3. **One-command setup** — `npx contextsliver init`. No database server, no API key.
+
+## Quickstart
+
+```bash
+# In your project root:
+npx contextsliver init      # creates .sliver/, .mcp.json, CLAUDE.md, indexes the repo
+npx contextsliver start     # runs the MCP server + file watcher (stdio)
+```
+
+Then restart Claude Code / Cursor / Cline — they'll pick up the five tools automatically. See the
+[templates](./templates) for client-specific config.
+
+## The five MCP tools
+
+| Tool | What it does | Typical tokens |
+|------|-------------|---------------|
+| `cs_index_repo` | Trigger a full re-index | ~50 |
+| `cs_get_context` | Symbol definition + immediate connections | ~300–800 |
+| `cs_blast_radius` | All callers + dependents up to N hops | ~500–2,000 |
+| `cs_search_symbols` | Full-text search across indexed symbols | ~200–600 |
+| `cs_index_status` | Index health, file count, last-updated | ~100 |
+
+Pass the `session_id` from your first `cs_get_context` call to every subsequent call to enable
+deduplication.
+
+## Supported languages
+
+- **TypeScript / JavaScript / TSX** (v0.1)
+- **Python** (v0.1)
+- Go, Rust, Java — planned (see [roadmap](#roadmap))
+
+Adding a language = add a grammar package + a `grammars/<lang>/tags.scm` query + a fixture. See
+[CONTRIBUTING.md](./CONTRIBUTING.md).
+
+## How it works
+
+```text
+Your codebase  ──chokidar──▶  Parser (Tree-sitter)  ──▶  SQLite graph (.sliver/index.db)
+                                                                    │
+                              MCP server (stdio) ◀──────────────────┘
+                                    │   session ledger (.sliver/sessions.db)
+                                    ▼
+                          Claude Code / Cursor / Cline
+```
+
+- **Parser**: Tree-sitter extracts symbols + imports per file.
+- **Graph engine**: stores symbol→symbol edges; bidirectional BFS (`blastRadius`) for blast radius
+  with cycle detection.
+- **Session manager**: per-session ledger computes deltas so already-sent context is skipped.
+- **MCP server**: exposes the five tools over stdio.
+
+## Token counting
+
+Counts use [`gpt-tokenizer`](https://www.npmjs.com/package/gpt-tokenizer) (`cl100k_base`) and are
+labeled **~approximate** — close enough for budget guidance, not billing.
+
+## Development
+
+```bash
+npm install
+npm test            # unit + integration tests
+npm run test:bench  # indexing benchmarks
+npm run build       # tsc → dist/
+npm run lint        # eslint
+```
+
+Requires Node ≥ 20.
+
+## Roadmap
+
+- **v0.1** ✅ TS/JS + Python, SQLite graph, session ledger, 5 tools, CLI, watcher
+- **v0.2** — incremental indexing polish, Cursor integration, CI benchmarks
+- **v0.3** — Go + Rust, monorepo workspace resolution, language-plugin docs
+- **v0.4** — PreToolUse hook, Java, published token-reduction benchmarks
+- **v0.5** — Streamable HTTP transport, DuckDB backend for 50k-file repos, PageRank ranking
+- **v1.0** — frozen API, optional native (napi-rs) engine, SCIP/LSP precision backend
+
+See [`contextsliver-spec.md`](./contextsliver-spec.md) for the full specification.
+
+## License
+
+MIT © Muneeb Ur Rehman

package/dist/cli.d.ts

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

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+// ContextSliver CLI entry point. This is what `npx contextsliver <command>` runs.
+//
+// Commands:
+//   init     Set up the project: create .sliver/, append .gitignore, write .mcp.json +
+//            CLAUDE.md, run the initial index.
+//   start    Run the MCP server (stdio) + file watcher. The agent connects to this.
+//   reindex  Force a full re-index.
+//
+// Logging uses console.error (stderr) directly for user-facing CLI messages, and the log()
+// helper for server-internal diagnostics. Neither touches stdout except the MCP transport.
+import { Command } from 'commander';
+import { join, resolve } from 'node:path';
+import { mkdirSync, existsSync, readFileSync, writeFileSync, appendFileSync, } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { startMCPServer } from './mcp/server.js';
+import { GraphStore } from './graph/store.js';
+import { indexRepository } from './parser/index.js';
+import { log } from './utils/logger.js';
+const VERSION = '0.1.0';
+const program = new Command();
+program
+    .name('contextsliver')
+    .description('Universal context-management MCP server for AI coding agents')
+    .version(VERSION);
+// ── init ──────────────────────────────────────────────────────────────────────
+program
+    .command('init')
+    .description('Initialize ContextSliver for the current project')
+    .option('--root <path>', 'Project root directory', process.cwd())
+    .option('--no-index', 'Skip the initial index (index later with `reindex`)')
+    .action(async (opts) => {
+    const root = resolve(opts.root);
+    console.error(`Initializing ContextSliver in ${root}`);
+    // 1. .sliver/
+    mkdirSync(join(root, '.sliver'), { recursive: true });
+    // 2. .gitignore
+    addToGitignore(root);
+    // 3. .mcp.json
+    writeMcpConfig(root);
+    // 4. CLAUDE.md
+    writeClaudeMd(root);
+    // 5. Initial index
+    if (opts.index) {
+        console.error('Indexing project (this may take a few seconds for large repos)...');
+        const dbPath = join(root, '.sliver', 'index.db');
+        // Use better-sqlite3 directly to avoid spinning up the MCP server.
+        const Database = (await import('better-sqlite3')).default;
+        const db = new Database(dbPath);
+        const store = new GraphStore(db);
+        const result = indexRepository(store, root, { force: true });
+        console.error(`✓ Indexed ${result.filesIndexed} file(s), ${result.symbols} symbols, ${result.edges} edges`);
+        db.close();
+    }
+    console.error('\n✓ ContextSliver initialized.');
+    console.error('  Next: restart Claude Code / Cursor to pick up the MCP server, then run:');
+    console.error('    npx contextsliver start');
+});
+// ── start ────────────────────────────────────────────────────────────────────
+program
+    .command('start')
+    .description('Start the ContextSliver MCP server and file watcher')
+    .option('--root <path>', 'Project root directory', process.cwd())
+    .option('--no-watch', 'Disable the file watcher')
+    .action(async (opts) => {
+    const root = resolve(opts.root);
+    log(`Starting ContextSliver MCP server in ${root}`);
+    await startMCPServer({ projectRoot: root, watch: opts.watch });
+});
+// ── reindex ──────────────────────────────────────────────────────────────────
+program
+    .command('reindex')
+    .description('Force a full re-index of the project')
+    .option('--root <path>', 'Project root directory', process.cwd())
+    .option('--force', 'Re-parse every file even if its hash is unchanged', true)
+    .action(async (opts) => {
+    const root = resolve(opts.root);
+    mkdirSync(join(root, '.sliver'), { recursive: true });
+    const dbPath = join(root, '.sliver', 'index.db');
+    const Database = (await import('better-sqlite3')).default;
+    const db = new Database(dbPath);
+    const store = new GraphStore(db);
+    const result = indexRepository(store, root, { force: opts.force });
+    console.error(`✓ Re-indexed: ${result.filesIndexed} file(s) indexed, ${result.filesSkipped} skipped, ` +
+        `${result.symbols} symbols, ${result.edges} edges in ${result.durationMs}ms`);
+    db.close();
+});
+program.parse();
+// ── init helpers ─────────────────────────────────────────────────────────────
+function addToGitignore(root) {
+    const gitignorePath = join(root, '.gitignore');
+    const entry = '\n# ContextSliver index\n.sliver/\n';
+    if (existsSync(gitignorePath)) {
+        const content = readFileSync(gitignorePath, 'utf-8');
+        if (!content.includes('.sliver/')) {
+            appendFileSync(gitignorePath, entry);
+        }
+    }
+    else {
+        writeFileSync(gitignorePath, entry.trimStart());
+    }
+}
+function writeMcpConfig(root) {
+    const configPath = join(root, '.mcp.json');
+    if (existsSync(configPath)) {
+        log('Skipped .mcp.json (already exists)');
+        return;
+    }
+    const config = {
+        mcpServers: {
+            contextsliver: {
+                command: 'npx',
+                args: ['contextsliver', 'start', '--root', root],
+                env: {},
+            },
+        },
+    };
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    log('Created .mcp.json');
+}
+function writeClaudeMd(root) {
+    const claudeMdPath = join(root, 'CLAUDE.md');
+    if (existsSync(claudeMdPath)) {
+        log('Skipped CLAUDE.md (already exists)');
+        return;
+    }
+    const template = readTemplate('CLAUDE.md');
+    writeFileSync(claudeMdPath, template);
+    log('Created CLAUDE.md');
+}
+/** Read a file from templates/, resolving whether we're running from src/ or dist/. */
+function readTemplate(name) {
+    const here = fileURLToPath(import.meta.url);
+    const dir = here.slice(0, here.lastIndexOf('/'));
+    // src/cli.ts → ../templates ; dist/cli.js → ../templates
+    const candidates = [
+        join(dir, '..', 'templates', name),
+        join(dir, '..', '..', 'templates', name),
+        join(process.cwd(), 'templates', name),
+    ];
+    for (const candidate of candidates) {
+        if (existsSync(candidate))
+            return readFileSync(candidate, 'utf-8');
+    }
+    // Fallback: an inline minimal template so init never fails just because the file is missing.
+    return [
+        '# ContextSliver — Code Navigation Rules',
+        '',
+        'This project has ContextSliver installed. Before reading files or running grep/find,',
+        'use the cs_* MCP tools (cs_get_context, cs_blast_radius, cs_search_symbols) to get just',
+        'the connected subgraph. Pass the session_id from your first cs_get_context call to every',
+        'subsequent call to skip context you already have.',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/graph/rank.d.ts

@@ -0,0 +1,9 @@
+import type { SymbolRow } from './types.js';
+/**
+ * Rank symbols by importance. v0.1 stub: returns the input unchanged.
+ *
+ * TODO (v0.5): implement PageRank-style scoring over the symbol graph. Until then the
+ * traversal order (BFS, nearest-first) is a reasonable default.
+ */
+export declare function rankSymbols(symbols: SymbolRow[]): SymbolRow[];
+//# sourceMappingURL=rank.d.ts.map

package/dist/graph/rank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.d.ts","sourceRoot":"","sources":["../../src/graph/rank.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAE7D"}

package/dist/graph/rank.js

@@ -0,0 +1,10 @@
+/**
+ * Rank symbols by importance. v0.1 stub: returns the input unchanged.
+ *
+ * TODO (v0.5): implement PageRank-style scoring over the symbol graph. Until then the
+ * traversal order (BFS, nearest-first) is a reasonable default.
+ */
+export function rankSymbols(symbols) {
+    return symbols;
+}
+//# sourceMappingURL=rank.js.map

package/dist/graph/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../src/graph/rank.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/graph/schema.d.ts

@@ -0,0 +1,4 @@
+export declare const SCHEMA_SQL = "\n  PRAGMA journal_mode = WAL;\n  PRAGMA synchronous = NORMAL;\n  PRAGMA foreign_keys = ON;\n\n  -- One row per indexed file\n  CREATE TABLE IF NOT EXISTS files (\n    id           INTEGER PRIMARY KEY AUTOINCREMENT,\n    path         TEXT    NOT NULL UNIQUE,   -- relative to project root, posix-style\n    content_hash TEXT    NOT NULL,          -- SHA-256 of file content\n    indexed_at   INTEGER NOT NULL,          -- unix timestamp (ms)\n    language     TEXT    NOT NULL           -- 'typescript' | 'python' | ...\n  );\n\n  -- One row per extracted symbol (function, class, interface, variable, type)\n  CREATE TABLE IF NOT EXISTS symbols (\n    id         INTEGER PRIMARY KEY AUTOINCREMENT,\n    file_id    INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,\n    name       TEXT    NOT NULL,            -- e.g. 'AuthService'\n    kind       TEXT    NOT NULL,            -- 'function' | 'class' | 'interface' | 'variable' | 'type'\n    line_start INTEGER NOT NULL,\n    line_end   INTEGER NOT NULL,\n    signature  TEXT,                        -- condensed definition (name + params), not full body\n    package    TEXT                         -- monorepo: owning package name (v0.3)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_symbols_name    ON symbols(name);\n  CREATE INDEX IF NOT EXISTS idx_symbols_file_id ON symbols(file_id);\n  CREATE INDEX IF NOT EXISTS idx_symbols_package ON symbols(package);\n\n  -- Directed edges: symbol A references symbol B\n  CREATE TABLE IF NOT EXISTS edges (\n    id      INTEGER PRIMARY KEY AUTOINCREMENT,\n    from_id INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,\n    to_id   INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,\n    kind    TEXT    NOT NULL,              -- 'calls' | 'imports' | 'extends' | 'implements' | 'uses'\n    UNIQUE(from_id, to_id, kind)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id);\n  CREATE INDEX IF NOT EXISTS idx_edges_to   ON edges(to_id);\n\n  -- Session ledger: what was already sent in each agent session\n  CREATE TABLE IF NOT EXISTS sessions (\n    id           TEXT    PRIMARY KEY,       -- UUID\n    created_at   INTEGER NOT NULL,\n    project_root TEXT    NOT NULL\n  );\n\n  CREATE TABLE IF NOT EXISTS ledger_entries (\n    id            INTEGER PRIMARY KEY AUTOINCREMENT,\n    session_id    TEXT    NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,\n    symbol_id     INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,\n    content_hash  TEXT    NOT NULL,          -- hash of what was sent at the time\n    sent_at       INTEGER NOT NULL,\n    UNIQUE(session_id, symbol_id)\n  );\n\n  CREATE INDEX IF NOT EXISTS idx_ledger_session ON ledger_entries(session_id);\n";
+/** Languages currently supported by the index. Matches parser/languages/registry.ts. */
+export declare const SCHEMA_VERSION = 1;
+//# sourceMappingURL=schema.d.ts.map

package/dist/graph/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,UAAU,6pFA2DtB,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,cAAc,IAAI,CAAC"}

package/dist/graph/schema.js

@@ -0,0 +1,74 @@
+// SQLite schema for the ContextSliver index.
+// Run once on init via `db.exec(SCHEMA_SQL)` — fully idempotent (IF NOT EXISTS).
+//
+// All four tables live in a single .sliver/index.db file:
+//   files          — one row per indexed source file
+//   symbols        — one row per extracted symbol (function/class/interface/...)
+//   edges          — directed symbol→symbol relationships (calls/imports/extends/...)
+//   sessions + ledger_entries — per-session record of what context was already sent
+//
+// See contextsliver-spec.md §6 for the design rationale (SQLite + recursive CTEs,
+// WAL mode for concurrent watcher/server access).
+export const SCHEMA_SQL = `
+  PRAGMA journal_mode = WAL;
+  PRAGMA synchronous = NORMAL;
+  PRAGMA foreign_keys = ON;
+
+  -- One row per indexed file
+  CREATE TABLE IF NOT EXISTS files (
+    id           INTEGER PRIMARY KEY AUTOINCREMENT,
+    path         TEXT    NOT NULL UNIQUE,   -- relative to project root, posix-style
+    content_hash TEXT    NOT NULL,          -- SHA-256 of file content
+    indexed_at   INTEGER NOT NULL,          -- unix timestamp (ms)
+    language     TEXT    NOT NULL           -- 'typescript' | 'python' | ...
+  );
+
+  -- One row per extracted symbol (function, class, interface, variable, type)
+  CREATE TABLE IF NOT EXISTS symbols (
+    id         INTEGER PRIMARY KEY AUTOINCREMENT,
+    file_id    INTEGER NOT NULL REFERENCES files(id) ON DELETE CASCADE,
+    name       TEXT    NOT NULL,            -- e.g. 'AuthService'
+    kind       TEXT    NOT NULL,            -- 'function' | 'class' | 'interface' | 'variable' | 'type'
+    line_start INTEGER NOT NULL,
+    line_end   INTEGER NOT NULL,
+    signature  TEXT,                        -- condensed definition (name + params), not full body
+    package    TEXT                         -- monorepo: owning package name (v0.3)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_symbols_name    ON symbols(name);
+  CREATE INDEX IF NOT EXISTS idx_symbols_file_id ON symbols(file_id);
+  CREATE INDEX IF NOT EXISTS idx_symbols_package ON symbols(package);
+
+  -- Directed edges: symbol A references symbol B
+  CREATE TABLE IF NOT EXISTS edges (
+    id      INTEGER PRIMARY KEY AUTOINCREMENT,
+    from_id INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,
+    to_id   INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,
+    kind    TEXT    NOT NULL,              -- 'calls' | 'imports' | 'extends' | 'implements' | 'uses'
+    UNIQUE(from_id, to_id, kind)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_id);
+  CREATE INDEX IF NOT EXISTS idx_edges_to   ON edges(to_id);
+
+  -- Session ledger: what was already sent in each agent session
+  CREATE TABLE IF NOT EXISTS sessions (
+    id           TEXT    PRIMARY KEY,       -- UUID
+    created_at   INTEGER NOT NULL,
+    project_root TEXT    NOT NULL
+  );
+
+  CREATE TABLE IF NOT EXISTS ledger_entries (
+    id            INTEGER PRIMARY KEY AUTOINCREMENT,
+    session_id    TEXT    NOT NULL REFERENCES sessions(id) ON DELETE CASCADE,
+    symbol_id     INTEGER NOT NULL REFERENCES symbols(id) ON DELETE CASCADE,
+    content_hash  TEXT    NOT NULL,          -- hash of what was sent at the time
+    sent_at       INTEGER NOT NULL,
+    UNIQUE(session_id, symbol_id)
+  );
+
+  CREATE INDEX IF NOT EXISTS idx_ledger_session ON ledger_entries(session_id);
+`;
+/** Languages currently supported by the index. Matches parser/languages/registry.ts. */
+export const SCHEMA_VERSION = 1;
+//# sourceMappingURL=schema.js.map

package/dist/graph/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,iFAAiF;AACjF,EAAE;AACF,0DAA0D;AAC1D,qDAAqD;AACrD,iFAAiF;AACjF,sFAAsF;AACtF,oFAAoF;AACpF,EAAE;AACF,kFAAkF;AAClF,kDAAkD;AAElD,MAAM,CAAC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2DzB,CAAC;AAEF,wFAAwF;AACxF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC"}

package/dist/graph/store.d.ts

@@ -0,0 +1,56 @@
+import type Database from 'better-sqlite3';
+import type { SymbolRow, EdgeKind, FileRow } from './types.js';
+export declare class GraphStore {
+    private db;
+    constructor(db: Database.Database);
+    /** Insert or replace a file row. Returns the file id. */
+    upsertFile(path: string, contentHash: string, language: string): number;
+    getFileId(path: string): number | undefined;
+    getFile(path: string): FileRow | undefined;
+    /** Delete a file and cascade-delete its symbols (and their edges via ON DELETE CASCADE). */
+    deleteFile(path: string): void;
+    /** All indexed files. Used for full re-index accounting. */
+    countFiles(): number;
+    /** Hash of a file's content as stored at last index, or undefined if not indexed. */
+    getFileHash(path: string): string | undefined;
+    /** Insert a symbol for a file. Returns the new symbol id. */
+    insertSymbol(sym: {
+        file_id: number;
+        name: string;
+        kind: string;
+        line_start: number;
+        line_end: number;
+        signature: string | null;
+        package: string | null;
+    }): number;
+    /** Remove all symbols belonging to a file (edges cascade). Used before re-inserting. */
+    deleteFileSymbols(fileId: number): void;
+    /** Find a symbol by exact name (first match). Returns the enriched SymbolRow. */
+    findSymbolByName(name: string): SymbolRow | undefined;
+    /** All symbols matching a name (names are not globally unique). */
+    findSymbolsByName(name: string): SymbolRow[];
+    /** Full-row symbol by id (joined with file path). */
+    getSymbol(id: number): SymbolRow | undefined;
+    /** FTS-lite substring search across symbol name + file path. Used by cs_search_symbols. */
+    searchSymbols(query: string, limit: number): SymbolRow[];
+    /** Look up a symbol by name within a specific file (for import resolution). */
+    findSymbolInFile(fileId: number, name: string): SymbolRow | undefined;
+    /** Insert an edge (UNIQUE constraint dedupes on from/to/kind). Ignores if exists. */
+    insertEdge(fromId: number, toId: number, kind: EdgeKind): void;
+    /** Symbols this symbol points to (forward edges), any kind. */
+    getDependencies(symbolId: number): SymbolRow[];
+    /** Symbols that point to this one (reverse edges), any kind. */
+    getCallers(symbolId: number): SymbolRow[];
+    /** Run a function inside a DB transaction (batches writes). */
+    transaction<T>(fn: () => T): T;
+    /** Expose the raw db for traversal/manager modules that need their own prepared statements. */
+    get raw(): Database.Database;
+    /** Index health stats for cs_index_status. */
+    stats(): {
+        files: number;
+        symbols: number;
+        edges: number;
+        lastIndexedAt: number | null;
+    };
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/graph/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/graph/store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE/D,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAoB;gBAElB,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAOjC,yDAAyD;IACzD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAkBvE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAO3C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAM1C,4FAA4F;IAC5F,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,4DAA4D;IAC5D,UAAU,IAAI,MAAM;IAKpB,qFAAqF;IACrF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAS7C,6DAA6D;IAC7D,YAAY,CAAC,GAAG,EAAE;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,GAAG,MAAM;IAUV,wFAAwF;IACxF,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIvC,iFAAiF;IACjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAYrD,mEAAmE;IACnE,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE;IAW5C,qDAAqD;IACrD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAW5C,2FAA2F;IAC3F,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAgBxD,+EAA+E;IAC/E,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAcrE,qFAAqF;IACrF,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI;IAQ9D,+DAA+D;IAC/D,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAW9C,gEAAgE;IAChE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAazC,+DAA+D;IAC/D,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAI9B,+FAA+F;IAC/F,IAAI,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAE3B;IAED,8CAA8C;IAC9C,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;CAYzF"}