contextsliver 0.1.1

package/dist/utils/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AASA;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEvD"}

package/dist/utils/tokens.js

@@ -0,0 +1,28 @@
+// Token counting. Used to label tool responses with an approximate token cost so the agent
+// can reason about budget. Counts are deliberately labeled "~approximate".
+//
+// Uses gpt-tokenizer (cl100k_base) — pure JS, synchronous, no WASM/native. If it ever throws
+// (e.g. unexpected input), we fall back to a rough chars/4 estimate rather than failing the call.
+import { encode } from 'gpt-tokenizer';
+const FALLBACK_CHARS_PER_TOKEN = 4;
+/**
+ * Count tokens in a string using cl100k_base, with a chars/4 fallback on any error.
+ * Returns a non-negative integer. Never throws.
+ */
+export function countTokens(text) {
+    if (!text)
+        return 0;
+    try {
+        return encode(text).length;
+    }
+    catch {
+        return Math.ceil(text.length / FALLBACK_CHARS_PER_TOKEN);
+    }
+}
+/**
+ * Sum tokens across multiple strings (e.g. a response with several content parts).
+ */
+export function countTokensMany(texts) {
+    return texts.reduce((sum, t) => sum + countTokens(t), 0);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/utils/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/utils/tokens.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,2EAA2E;AAC3E,EAAE;AACF,6FAA6F;AAC7F,kGAAkG;AAClG,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,wBAAwB,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/watcher/hasher.d.ts

@@ -0,0 +1,11 @@
+import type { GraphStore } from '../graph/store.js';
+/** SHA-256 hex digest of a string. */
+export declare function hashContent(content: string): string;
+/** Hash a file on disk by reading it. Returns null if the file can't be read. */
+export declare function hashFile(absPath: string): string | null;
+/**
+ * Decide whether a file needs re-indexing.
+ * Returns true if the file is new OR its content hash differs from the stored hash.
+ */
+export declare function isDirty(store: GraphStore, relPath: string, newHash: string): boolean;
+//# sourceMappingURL=hasher.d.ts.map

package/dist/watcher/hasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasher.d.ts","sourceRoot":"","sources":["../../src/watcher/hasher.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGpF"}

package/dist/watcher/hasher.js

@@ -0,0 +1,29 @@
+// Content hashing + dirty-flag logic.
+//
+// The watcher needs to decide whether a changed file actually needs re-indexing. We hash the
+// file content with SHA-256 and compare to the stored hash; if they match, the change was a
+// no-op save (common in editors) and we skip the re-parse.
+import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
+/** SHA-256 hex digest of a string. */
+export function hashContent(content) {
+    return createHash('sha256').update(content).digest('hex');
+}
+/** Hash a file on disk by reading it. Returns null if the file can't be read. */
+export function hashFile(absPath) {
+    try {
+        return hashContent(readFileSync(absPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Decide whether a file needs re-indexing.
+ * Returns true if the file is new OR its content hash differs from the stored hash.
+ */
+export function isDirty(store, relPath, newHash) {
+    const stored = store.getFileHash(relPath);
+    return stored !== newHash;
+}
+//# sourceMappingURL=hasher.js.map

package/dist/watcher/hasher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hasher.js","sourceRoot":"","sources":["../../src/watcher/hasher.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,6FAA6F;AAC7F,4FAA4F;AAC5F,2DAA2D;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGvC,sCAAsC;AACtC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAiB,EAAE,OAAe,EAAE,OAAe;IACzE,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,MAAM,KAAK,OAAO,CAAC;AAC5B,CAAC"}

package/dist/watcher/index.d.ts

@@ -0,0 +1,9 @@
+import { type FSWatcher } from 'chokidar';
+import type { GraphStore } from '../graph/store.js';
+/**
+ * Start watching the project root for changes. Returns the chokidar watcher
+ * (call .close() to stop). Reads from the GraphStore to detect unchanged files (hash dedup)
+ * before re-parsing.
+ */
+export declare function startWatcher(store: GraphStore, projectRoot: string): FSWatcher;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAQA,OAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAyBpD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CA8C9E"}

package/dist/watcher/index.js

@@ -0,0 +1,100 @@
+// File watcher with debounced incremental re-indexing.
+//
+// Watches the project tree with chokidar. On a file change/add, debounce 300ms then re-index
+// only that file (skipping if its content hash is unchanged — handles editor save-without-edit).
+// On unlink, remove the file + its symbols from the index.
+//
+// The watcher must NEVER throw into the event loop (it's a background process). All errors are
+// caught and logged to stderr. It also never touches stdout.
+import chokidar from 'chokidar';
+import { relative, resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import { hashFile, isDirty } from './hasher.js';
+import { indexFile } from '../parser/index.js';
+import { pluginForFile } from '../parser/languages/registry.js';
+import { toPosix } from '../utils/paths.js';
+import { log } from '../utils/logger.js';
+const DEBOUNCE_MS = 300;
+/** Glob patterns the watcher ignores. */
+const IGNORED_GLOBS = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/.sliver/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/out/**',
+    '**/*.min.js',
+    '**/*.min.css',
+    '**/__pycache__/**',
+    '**/.next/**',
+    '**/.nuxt/**',
+    '**/coverage/**',
+];
+/**
+ * Start watching the project root for changes. Returns the chokidar watcher
+ * (call .close() to stop). Reads from the GraphStore to detect unchanged files (hash dedup)
+ * before re-parsing.
+ */
+export function startWatcher(store, projectRoot) {
+    const root = resolve(projectRoot);
+    const timers = new Map();
+    const watcher = chokidar.watch(root, {
+        ignored: IGNORED_GLOBS,
+        persistent: true,
+        ignoreInitial: true, // don't fire for files present at startup (already indexed)
+    });
+    const relOf = (abs) => toPosix(relative(root, abs));
+    const handleChange = (absPath) => {
+        const rel = relOf(absPath);
+        if (!pluginForFile(rel))
+            return; // unsupported extension
+        // Debounce: collapse rapid saves into one re-index.
+        const existing = timers.get(rel);
+        if (existing)
+            clearTimeout(existing);
+        timers.set(rel, setTimeout(() => {
+            timers.delete(rel);
+            reindexFile(store, root, rel, absPath);
+        }, DEBOUNCE_MS));
+    };
+    watcher
+        .on('change', handleChange)
+        .on('add', handleChange)
+        .on('unlink', (absPath) => {
+        const rel = relOf(absPath);
+        if (!pluginForFile(rel))
+            return;
+        try {
+            store.deleteFile(rel);
+            log(`Removed from index: ${rel}`);
+        }
+        catch (err) {
+            log(`Error removing ${rel}: ${err.message}`, 'error');
+        }
+    })
+        .on('error', (err) => log(`Watcher error: ${err.message}`, 'error'));
+    log('File watcher started');
+    return watcher;
+}
+/** Re-index a single file if its content changed since the last index. */
+function reindexFile(store, root, rel, abs) {
+    try {
+        if (!existsSync(abs))
+            return;
+        const newHash = hashFile(abs);
+        if (!newHash)
+            return;
+        if (!isDirty(store, rel, newHash)) {
+            log(`Skip (unchanged): ${rel}`);
+            return;
+        }
+        const source = readFileSync(abs, 'utf-8');
+        const result = indexFile(store, root, abs, source, newHash);
+        if (result)
+            log(`Re-indexed: ${rel}`);
+    }
+    catch (err) {
+        log(`Error re-indexing ${rel}: ${err.message}`, 'error');
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

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

package/grammars/python/tags.scm

@@ -0,0 +1,16 @@
+;; ContextSliver Tree-sitter query for Python.
+;; Same capture convention as grammars/typescript/tags.scm (see CONTRIBUTING.md).
+
+;; ── Functions ──────────────────────────────────────────────────────────────
+(function_definition name: (identifier) @name) @definition.function
+
+;; ── Classes ────────────────────────────────────────────────────────────────
+;; Capture base classes for inheritance edges (arguments of the class).
+(class_definition
+  name: (identifier) @name
+  (argument_list (identifier) @extends)?) @definition.class
+
+;; ── Imports ────────────────────────────────────────────────────────────────
+;; import X / import X as Y / from M import a, b
+(import_statement) @import
+(import_from_statement) @import

package/grammars/typescript/tags.scm

@@ -0,0 +1,39 @@
+;; ContextSliver Tree-sitter query for TypeScript / JavaScript / TSX.
+;;
+;; Capture convention (see CONTRIBUTING.md):
+;;   @name                       — the identifier naming a symbol
+;;   @definition.function        — function/method/arrow declaration
+;;   @definition.class           — class declaration
+;;   @definition.interface       — interface declaration
+;;   @definition.type            — type alias / enum
+;;   @definition.variable        — top-level / exported variable or constant
+;;   @import                     — an import statement (extract specifier + names)
+;;
+;; NOTE: for `const x = ...` we capture the declarator as @definition.variable and let the
+;; extractor inspect the value child to reclassify arrow/function-expression values as
+;; functions. This avoids conflicting overlapping patterns in the query (which the query
+;; compiler rejects as a structural error).
+
+;; ── Functions ──────────────────────────────────────────────────────────────
+(function_declaration name: (identifier) @name) @definition.function
+(generator_function_declaration name: (identifier) @name) @definition.function
+(method_definition name: (_) @name) @definition.function
+
+;; ── Arrow / const functions ────────────────────────────────────────────────
+;; Declared as variable; extractor inspects value to set kind=function when arrow/function.
+(lexical_declaration (variable_declarator name: (identifier) @name)) @definition.variable
+
+;; ── Classes ────────────────────────────────────────────────────────────────
+;; Heritage clauses (extends/implements) are read directly from the class node in the extractor.
+;; (In the TS grammar the class name is a type_identifier, not an identifier.)
+(class_declaration name: (type_identifier) @name) @definition.class
+
+;; ── Interfaces ─────────────────────────────────────────────────────────────
+(interface_declaration name: (type_identifier) @name) @definition.interface
+
+;; ── Type aliases & enums ───────────────────────────────────────────────────
+(type_alias_declaration name: (type_identifier) @name) @definition.type
+(enum_declaration name: (identifier) @name) @definition.type
+
+;; ── Imports ────────────────────────────────────────────────────────────────
+(import_statement) @import

package/hooks/pre-tool-use.js

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+// Optional Claude Code PreToolUse hook.
+//
+// When enabled in Claude Code, this runs before each tool call. If the agent is about to use
+// Read/Grep/Glob to explore code (instead of the cheaper cs_* MCP tools), it emits a gentle
+// reminder on stderr. It never blocks — it's a nudge, consistent with the CLAUDE.md guidance.
+//
+// To enable (Claude Code): add to your settings.json hooks:
+//   "PreToolUse": [{ "matcher": "Read|Grep|Glob", "hooks": [{ "type": "command",
+//     "command": "node /path/to/hooks/pre-tool-use.js" }] }]
+//
+// Input (JSON on stdin): { "tool_name": "Read", "tool_input": { "file_path": "..." } }
+// Exit code 0 = allow; anything on stderr is shown to the agent as feedback.
+'use strict';
+
+let raw = '';
+process.stdin.on('data', (c) => (raw += c));
+process.stdin.on('end', () => {
+  let payload;
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    // Not a valid hook payload — pass through silently.
+    process.exit(0);
+  }
+
+  const tool = payload?.tool_name;
+  const toolsToNudge = new Set(['Read', 'Grep', 'Glob']);
+  if (!toolsToNudge.has(tool)) {
+    process.exit(0);
+  }
+
+  // Only nudge for code files; ignore docs/config reads.
+  const target = payload?.tool_input?.file_path || payload?.tool_input?.pattern || '';
+  const codeExt = /\.(ts|tsx|js|jsx|py|go|rs|java)$/i;
+  if (target && !codeExt.test(target)) {
+    process.exit(0);
+  }
+
+  process.stderr.write(
+    '[contextsliver] Consider using cs_get_context / cs_blast_radius / cs_search_symbols ' +
+      'before reading whole files — they return just the connected subgraph and cost far fewer ' +
+      'tokens. Pass your session_id to skip already-sent context.\n',
+  );
+  process.exit(0);
+});

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "contextsliver",
+  "version": "0.1.1",
+  "description": "Universal context-management MCP server for AI coding agents. On-demand dependency-graph pruning with session awareness.",
+  "keywords": [
+    "mcp",
+    "claude",
+    "cursor",
+    "ai",
+    "coding",
+    "context",
+    "token-reduction",
+    "tree-sitter"
+  ],
+  "homepage": "https://github.com/DevMuneeb/contextsliver",
+  "bugs": "https://github.com/DevMuneeb/contextsliver/issues",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/DevMuneeb/contextsliver.git"
+  },
+  "license": "MIT",
+  "author": "DevMuneeb",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "contextsliver": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "grammars/",
+    "templates/",
+    "hooks/"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js start",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:bench": "vitest bench",
+    "lint": "eslint src/ test/",
+    "format": "prettier --write src/ test/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^11.0.0",
+    "chokidar": "^4.0.0",
+    "commander": "^12.0.0",
+    "gpt-tokenizer": "^2.5.0",
+    "tree-sitter": "0.22.4",
+    "tree-sitter-python": "0.23.6",
+    "tree-sitter-typescript": "0.23.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.0.0"
+  },
+  "//overrides": "The tree-sitter grammar packages declare inconsistent peer ranges (python wants ^0.25, typescript wants ^0.21) but share the same runtime ABI. Force a single runtime version so npm install resolves cleanly for end users.",
+  "overrides": {
+    "tree-sitter": "0.22.4"
+  },
+  "allowScripts": {
+    "better-sqlite3@11.10.0": true,
+    "tree-sitter@0.22.4": true,
+    "tree-sitter-python@0.23.6": true,
+    "tree-sitter-typescript@0.23.2": true,
+    "tree-sitter-javascript@0.23.1": true,
+    "esbuild@0.21.5": true
+  }
+}

package/templates/CLAUDE.md

@@ -0,0 +1,50 @@
+# ContextSliver — Code Navigation Rules
+
+## How to navigate this codebase (IMPORTANT — read before touching any file)
+
+This project has ContextSliver installed. Before reading any file with Read or
+running grep/find to explore code, use the MCP tools below. They cost ~300–800
+tokens. Reading a whole file costs 2,000–8,000 tokens and fills your context
+window unnecessarily.
+
+### Rule 1: Finding what connects to a symbol
+Use `cs_blast_radius` instead of grep.
+
+Example — before editing AuthService:
+```
+cs_blast_radius({ symbol_name: "AuthService", session_id: "YOUR_SESSION_ID" })
+```
+
+This returns who calls AuthService and what AuthService depends on.
+Only then read the specific files you actually need.
+
+### Rule 2: Getting a single symbol + its immediate neighbors
+Use `cs_get_context` to start a session and get a symbol's definition + 1-hop neighbors:
+```
+cs_get_context({ symbol_name: "AuthService" })
+```
+This returns a `session_id` — save it and pass it to every subsequent cs_* call.
+
+### Rule 3: Searching for a symbol you don't know the exact location of
+Use `cs_search_symbols` instead of find or grep:
+```
+cs_search_symbols({ query: "token validation", limit: 10 })
+```
+
+### Rule 4: Understanding the current index state
+```
+cs_index_status()
+```
+
+### Rule 5: After making changes
+Run the project's test command. Do not assume changes are correct without
+running tests.
+
+## Session ID
+Get a session ID from the first `cs_get_context` call and pass it to every
+subsequent tool call this session. This prevents re-sending context you already
+have and saves tokens. Already-sent symbols are listed in `already_in_context`.
+
+<!-- Keep this file under 200 lines.
+     These are nudges, not hard rules. Hard enforcement is via the PreToolUse
+     hook in /hooks/pre-tool-use.js — enable it for stricter control. -->

package/templates/mcp-config-claude-code.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "contextsliver": {
+      "command": "npx",
+      "args": ["contextsliver", "start"],
+      "env": {}
+    }
+  }
+}

package/templates/mcp-config-cline.json

@@ -0,0 +1,15 @@
+{
+  "mcpServers": {
+    "contextsliver": {
+      "command": "npx",
+      "args": ["contextsliver", "start"],
+      "disabled": false,
+      "autoApprove": [
+        "cs_blast_radius",
+        "cs_get_context",
+        "cs_search_symbols",
+        "cs_index_status"
+      ]
+    }
+  }
+}

package/templates/mcp-config-cursor.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "contextsliver": {
+      "command": "npx",
+      "args": ["contextsliver", "start"],
+      "type": "stdio"
+    }
+  }
+}