token-pilot 0.1.1

package/dist/handlers/smart-read.js

@@ -0,0 +1,86 @@
+import { readFile, stat } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { formatOutline } from '../formatters/structure.js';
+import { estimateTokens, formatSavings } from '../core/token-estimator.js';
+import { resolveSafePath } from '../core/validation.js';
+export async function handleSmartRead(args, projectRoot, astIndex, fileCache, contextRegistry, config) {
+    const absPath = resolveSafePath(projectRoot, args.path);
+    // 1. Read file content
+    const content = await readFile(absPath, 'utf-8');
+    const lines = content.split('\n');
+    // 2. Small-file pass-through
+    if (lines.length <= config.smartRead.smallFileThreshold) {
+        const tokens = estimateTokens(content);
+        contextRegistry.trackLoad(absPath, {
+            type: 'full',
+            startLine: 1,
+            endLine: lines.length,
+            tokens,
+        });
+        contextRegistry.setContentHash(absPath, createHash('sha256').update(content).digest('hex'));
+        return {
+            content: [{
+                    type: 'text',
+                    text: `FILE: ${args.path} (${lines.length} lines — returned in full, below threshold)\n\n${content}`,
+                }],
+        };
+    }
+    // 3. Check cache
+    let cached = fileCache.get(absPath);
+    const isStale = cached ? await fileCache.isStale(absPath) : true;
+    if (!cached || isStale) {
+        // 4. Get structure from ast-index
+        const structure = await astIndex.outline(absPath);
+        if (!structure) {
+            // ast-index doesn't support this — return raw
+            return {
+                content: [{
+                        type: 'text',
+                        text: `FILE: ${args.path} (${lines.length} lines — language not supported, raw content)\n\n${content}`,
+                    }],
+            };
+        }
+        const fileStat = await stat(absPath);
+        const hash = createHash('sha256').update(content).digest('hex');
+        cached = {
+            structure,
+            content,
+            lines,
+            mtime: fileStat.mtimeMs,
+            hash,
+            lastAccess: Date.now(),
+        };
+        fileCache.set(absPath, cached);
+    }
+    // 5. Advisory context check
+    const previouslyLoaded = contextRegistry.getLoaded(absPath);
+    if (previouslyLoaded && !contextRegistry.isStale(absPath, cached.hash)) {
+        if (config.smartRead.advisoryReminders) {
+            const reminder = contextRegistry.compactReminder(absPath, cached.structure.symbols);
+            return { content: [{ type: 'text', text: reminder }] };
+        }
+    }
+    // 6. Format output
+    const output = formatOutline(cached.structure, {
+        showImports: args.show_imports ?? config.display.showImports,
+        showDocs: args.show_docs ?? config.display.showDocs,
+        showDependencyHints: config.smartRead.showDependencyHints,
+        maxDepth: args.depth ?? config.display.maxDepth,
+    });
+    // 7. Add token savings
+    const structureTokens = estimateTokens(output);
+    const fullTokens = estimateTokens(content);
+    const savings = config.display.showTokenSavings
+        ? '\n' + formatSavings(structureTokens, fullTokens)
+        : '';
+    // 8. Track
+    contextRegistry.trackLoad(absPath, {
+        type: 'structure',
+        startLine: 1,
+        endLine: cached.structure.meta.lines,
+        tokens: structureTokens,
+    });
+    contextRegistry.setContentHash(absPath, cached.hash);
+    return { content: [{ type: 'text', text: output + savings }] };
+}
+//# sourceMappingURL=smart-read.js.map

package/dist/handlers/smart-read.js.map

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

package/dist/hooks/installer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Install Token Pilot hook into Claude Code settings.
+ * Creates or updates .claude/settings.json with PreToolUse hook.
+ */
+export declare function installHook(projectRoot: string): Promise<{
+    installed: boolean;
+    message: string;
+}>;
+/**
+ * Remove Token Pilot hook from Claude Code settings.
+ */
+export declare function uninstallHook(projectRoot: string): Promise<{
+    removed: boolean;
+    message: string;
+}>;
+//# sourceMappingURL=installer.d.ts.map

package/dist/hooks/installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../../src/hooks/installer.ts"],"names":[],"mappings":"AAmBA;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA+CvG;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4BvG"}

package/dist/hooks/installer.js

@@ -0,0 +1,89 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { resolve, dirname } from 'node:path';
+const HOOK_CONFIG = {
+    hooks: {
+        PreToolUse: [
+            {
+                matcher: "Read",
+                hooks: [
+                    {
+                        type: "command",
+                        command: "token-pilot hook-read $FILE_PATH",
+                    },
+                ],
+            },
+        ],
+    },
+};
+/**
+ * Install Token Pilot hook into Claude Code settings.
+ * Creates or updates .claude/settings.json with PreToolUse hook.
+ */
+export async function installHook(projectRoot) {
+    const settingsPath = resolve(projectRoot, '.claude', 'settings.json');
+    try {
+        // Ensure .claude dir exists
+        await mkdir(dirname(settingsPath), { recursive: true });
+        let settings = {};
+        // Try to read existing settings
+        try {
+            const raw = await readFile(settingsPath, 'utf-8');
+            settings = JSON.parse(raw);
+        }
+        catch {
+            // File doesn't exist or is invalid — start fresh
+        }
+        // Check if hook already exists
+        const existingHooks = settings.hooks?.PreToolUse;
+        if (Array.isArray(existingHooks)) {
+            const hasTokenPilot = existingHooks.some((h) => h.matcher === 'Read' &&
+                h.hooks?.some((hook) => hook.command?.includes('token-pilot')));
+            if (hasTokenPilot) {
+                return { installed: false, message: 'Token Pilot hook already installed.' };
+            }
+            // Add to existing PreToolUse hooks
+            existingHooks.push(HOOK_CONFIG.hooks.PreToolUse[0]);
+        }
+        else {
+            // Create hooks section
+            if (!settings.hooks)
+                settings.hooks = {};
+            settings.hooks.PreToolUse = HOOK_CONFIG.hooks.PreToolUse;
+        }
+        await writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        return {
+            installed: true,
+            message: `Hook installed at ${settingsPath}. Token Pilot will suggest smart_read for large code files.`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { installed: false, message: `Failed to install hook: ${msg}` };
+    }
+}
+/**
+ * Remove Token Pilot hook from Claude Code settings.
+ */
+export async function uninstallHook(projectRoot) {
+    const settingsPath = resolve(projectRoot, '.claude', 'settings.json');
+    try {
+        const raw = await readFile(settingsPath, 'utf-8');
+        const settings = JSON.parse(raw);
+        if (!settings.hooks?.PreToolUse) {
+            return { removed: false, message: 'No hooks to remove.' };
+        }
+        settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter((h) => !(h.matcher === 'Read' && h.hooks?.some((hook) => hook.command?.includes('token-pilot'))));
+        if (settings.hooks.PreToolUse.length === 0) {
+            delete settings.hooks.PreToolUse;
+        }
+        if (Object.keys(settings.hooks).length === 0) {
+            delete settings.hooks;
+        }
+        await writeFile(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+        return { removed: true, message: 'Token Pilot hook removed.' };
+    }
+    catch {
+        return { removed: false, message: 'Settings file not found or invalid.' };
+    }
+}
+//# sourceMappingURL=installer.js.map

package/dist/hooks/installer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../../src/hooks/installer.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,120 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readFileSync } from 'node:fs';
+import { createServer } from './server.js';
+import { installHook, uninstallHook } from './hooks/installer.js';
+import { findBinary, installBinary } from './ast-index/binary-manager.js';
+const SMALL_FILE_THRESHOLD = 80;
+const CODE_EXTENSIONS = new Set([
+    'ts', 'tsx', 'js', 'jsx', 'mjs', 'py', 'go', 'rs', 'java', 'kt', 'kts',
+    'swift', 'cs', 'cpp', 'cc', 'cxx', 'hpp', 'c', 'h', 'php', 'rb', 'scala',
+    'dart', 'lua', 'sh', 'bash', 'sql', 'r', 'vue', 'svelte', 'pl', 'pm',
+    'ex', 'exs', 'groovy', 'm', 'proto', 'bsl',
+]);
+const args = process.argv.slice(2);
+switch (args[0]) {
+    case 'hook-read':
+        if (!args[1]) {
+            console.error('Usage: token-pilot hook-read <file-path>');
+            process.exit(1);
+        }
+        handleHookRead(args[1]);
+        break;
+    case 'install-hook':
+        handleInstallHook(args[1] || process.cwd());
+        break;
+    case 'uninstall-hook':
+        handleUninstallHook(args[1] || process.cwd());
+        break;
+    case 'install-ast-index':
+        handleInstallAstIndex();
+        break;
+    case '--help':
+    case '-h':
+        printHelp();
+        break;
+    default:
+        startServer();
+        break;
+}
+async function startServer() {
+    const projectRoot = args[0] || process.cwd();
+    const server = await createServer(projectRoot);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.on('SIGINT', async () => {
+        await server.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await server.close();
+        process.exit(0);
+    });
+}
+function handleHookRead(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
+    if (!CODE_EXTENSIONS.has(ext)) {
+        process.exit(0);
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const lineCount = content.split('\n').length;
+        if (lineCount <= SMALL_FILE_THRESHOLD) {
+            process.exit(0);
+        }
+    }
+    catch {
+        process.exit(0);
+    }
+    const suggestion = JSON.stringify({
+        decision: "suggest",
+        message: `Consider using smart_read instead of Read for "${filePath}" — it returns a structural overview saving 80-95% tokens. Use read_symbol to load specific functions/methods.`,
+    });
+    process.stdout.write(suggestion);
+    process.exit(0);
+}
+async function handleInstallHook(projectRoot) {
+    const result = await installHook(projectRoot);
+    console.log(result.message);
+    process.exit(result.installed ? 0 : 1);
+}
+async function handleUninstallHook(projectRoot) {
+    const result = await uninstallHook(projectRoot);
+    console.log(result.message);
+    process.exit(result.removed ? 0 : 1);
+}
+async function handleInstallAstIndex() {
+    const status = await findBinary();
+    if (status.available) {
+        console.log(`ast-index ${status.version} already available at ${status.path} (${status.source})`);
+        process.exit(0);
+    }
+    try {
+        const result = await installBinary((msg) => console.log(msg));
+        console.log(`\nast-index ${result.version} installed to ${result.path}`);
+        process.exit(0);
+    }
+    catch (err) {
+        console.error(`Failed: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+}
+function printHelp() {
+    console.log(`token-pilot — MCP server for token-efficient code reading
+
+Usage:
+  token-pilot [project-root]        Start MCP server (default: cwd)
+  token-pilot hook-read <path>      PreToolUse hook for Claude Code
+  token-pilot install-hook [root]   Install hook into .claude/settings.json
+  token-pilot uninstall-hook [root] Remove hook from .claude/settings.json
+  token-pilot install-ast-index     Download ast-index binary (auto on first run)
+  token-pilot --help                Show this help
+
+MCP Tools (14):
+  smart_read, read_symbol, read_range, read_diff, smart_read_many,
+  search_code, find_usages, find_implementations, class_hierarchy,
+  project_overview, export_ast_index, session_analytics, context_status, forget
+`);
+    process.exit(0);
+}
+//# 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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"}

package/dist/integration/context-mode-detector.d.ts

@@ -0,0 +1,16 @@
+export interface ContextModeStatus {
+    detected: boolean;
+    source: 'mcp-json' | 'home-mcp-json' | 'config' | 'none';
+    toolPrefix: string;
+}
+/**
+ * Detect if context-mode MCP plugin is configured alongside Token Pilot.
+ *
+ * Checks two locations:
+ *   1. Project-level .mcp.json (project root)
+ *   2. User-level ~/.mcp.json (home dir)
+ *
+ * Returns detection result with source info.
+ */
+export declare function detectContextMode(projectRoot: string, configOverride?: boolean): Promise<ContextModeStatus>;
+//# sourceMappingURL=context-mode-detector.d.ts.map

package/dist/integration/context-mode-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-mode-detector.d.ts","sourceRoot":"","sources":["../../src/integration/context-mode-detector.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,eAAe,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzD,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,iBAAiB,CAAC,CAqB5B"}

package/dist/integration/context-mode-detector.js

@@ -0,0 +1,53 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+const TOOL_PREFIX = 'mcp__plugin_context-mode_context-mode__';
+/**
+ * Detect if context-mode MCP plugin is configured alongside Token Pilot.
+ *
+ * Checks two locations:
+ *   1. Project-level .mcp.json (project root)
+ *   2. User-level ~/.mcp.json (home dir)
+ *
+ * Returns detection result with source info.
+ */
+export async function detectContextMode(projectRoot, configOverride) {
+    // Config override takes priority
+    if (configOverride === true) {
+        return { detected: true, source: 'config', toolPrefix: TOOL_PREFIX };
+    }
+    if (configOverride === false) {
+        return { detected: false, source: 'none', toolPrefix: TOOL_PREFIX };
+    }
+    // Check project-level .mcp.json
+    if (await checkMcpJson(resolve(projectRoot, '.mcp.json'))) {
+        return { detected: true, source: 'mcp-json', toolPrefix: TOOL_PREFIX };
+    }
+    // Check user-level ~/.mcp.json
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+    if (homeDir && await checkMcpJson(resolve(homeDir, '.mcp.json'))) {
+        return { detected: true, source: 'home-mcp-json', toolPrefix: TOOL_PREFIX };
+    }
+    return { detected: false, source: 'none', toolPrefix: TOOL_PREFIX };
+}
+async function checkMcpJson(path) {
+    try {
+        const raw = await readFile(path, 'utf-8');
+        const config = JSON.parse(raw);
+        const servers = config.mcpServers ?? config.servers ?? {};
+        // Look for any server entry containing "context-mode" in name or command
+        for (const [name, server] of Object.entries(servers)) {
+            if (name.includes('context-mode'))
+                return true;
+            const s = server;
+            if (typeof s.command === 'string' && s.command.includes('context-mode'))
+                return true;
+            if (Array.isArray(s.args) && s.args.some((a) => String(a).includes('context-mode')))
+                return true;
+        }
+    }
+    catch {
+        // File doesn't exist or is invalid
+    }
+    return false;
+}
+//# sourceMappingURL=context-mode-detector.js.map

package/dist/integration/context-mode-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-mode-detector.js","sourceRoot":"","sources":["../../src/integration/context-mode-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,MAAM,WAAW,GAAG,yCAAyC,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAmB,EACnB,cAAwB;IAExB,iCAAiC;IACjC,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IACvE,CAAC;IACD,IAAI,cAAc,KAAK,KAAK,EAAE,CAAC;QAC7B,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IACtE,CAAC;IAED,gCAAgC;IAChC,IAAI,MAAM,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IACzE,CAAC;IAED,+BAA+B;IAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;IAClE,IAAI,OAAO,IAAI,MAAM,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;QACjE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC;AACtE,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACtC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QAE1D,yEAAyE;QACzE,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACrD,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,CAAC,GAAG,MAA6B,CAAC;YACxC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;gBAAE,OAAO,IAAI,CAAC;YACrF,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC3G,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,mCAAmC;IACrC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,36 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+export declare function createServer(projectRoot: string): Promise<Server<{
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    method: string;
+    params?: {
+        [x: string]: unknown;
+        _meta?: {
+            [x: string]: unknown;
+            progressToken?: string | number | undefined;
+            "io.modelcontextprotocol/related-task"?: {
+                taskId: string;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    [x: string]: unknown;
+    _meta?: {
+        [x: string]: unknown;
+        progressToken?: string | number | undefined;
+        "io.modelcontextprotocol/related-task"?: {
+            taskId: string;
+        } | undefined;
+    } | undefined;
+}>>;
+//# sourceMappingURL=server.d.ts.map

package/dist/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;AA2CnE,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiWrD"}