@shuyhere/takotako 0.0.1

package/dist/cache/manager.js

@@ -0,0 +1,117 @@
+/**
+ * Cache Manager — orchestrates all cache layers.
+ *
+ * Provides a unified interface for:
+ * - Auto-clean intervals across all layers
+ * - Combined status/stats
+ * - Per-layer or global clear
+ * - File write invalidation hooks
+ */
+import { FileCache } from './file-cache.js';
+import { ToolCache } from './tool-cache.js';
+import { SymbolIndex } from './symbol-index.js';
+// ─── Cache Manager ──────────────────────────────────────────────────
+export class CacheManager {
+    file;
+    tool;
+    symbols;
+    config;
+    cleanTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.file = new FileCache(config.file);
+        this.tool = new ToolCache(config.tool);
+        this.symbols = new SymbolIndex(config.symbols);
+    }
+    /**
+     * Start the auto-clean interval.
+     */
+    startAutoClean() {
+        if (!this.config.enabled)
+            return;
+        if (this.cleanTimer)
+            return;
+        this.cleanTimer = setInterval(() => {
+            this.autoClean();
+        }, this.config.autoCleanIntervalMs);
+        // Don't block process exit
+        if (this.cleanTimer.unref) {
+            this.cleanTimer.unref();
+        }
+    }
+    /**
+     * Stop the auto-clean interval.
+     */
+    stopAutoClean() {
+        if (this.cleanTimer) {
+            clearInterval(this.cleanTimer);
+            this.cleanTimer = null;
+        }
+    }
+    /**
+     * Run auto-clean on all layers.
+     */
+    autoClean() {
+        const fileCleaned = this.file.autoClean();
+        const toolCleaned = this.tool.autoClean();
+        if (fileCleaned > 0 || toolCleaned > 0) {
+            console.log(`[cache] Auto-clean: ${fileCleaned} file entries, ${toolCleaned} tool entries evicted`);
+        }
+        return { file: fileCleaned, tool: toolCleaned };
+    }
+    /**
+     * Clear a specific layer or all layers.
+     */
+    clear(layer) {
+        if (!layer || layer === 'file')
+            this.file.clear();
+        if (!layer || layer === 'tool')
+            this.tool.clear();
+        if (!layer || layer === 'symbols')
+            this.symbols.clear();
+    }
+    /**
+     * Get combined status from all layers.
+     */
+    getStatus() {
+        return {
+            enabled: this.config.enabled,
+            file: this.file.getStats(),
+            tool: this.tool.getStats(),
+            symbols: this.symbols.getStats(),
+        };
+    }
+    /**
+     * Notify all layers that a file was written/modified.
+     * Invalidates file cache entry and marks tool cache as potentially stale.
+     */
+    onFileWrite(filePath) {
+        this.file.invalidate(filePath);
+        this.symbols.invalidate(filePath);
+        // Tool cache: invalidate all since file writes can affect any command output
+        // (e.g. git status changes after file write)
+        this.tool.clear();
+    }
+    /**
+     * Persist symbol index to disk.
+     */
+    async persistSymbols() {
+        await this.symbols.persist();
+    }
+    /**
+     * Load symbol index from disk.
+     */
+    async loadSymbols() {
+        return this.symbols.load();
+    }
+    /**
+     * Dispose: stop timers, persist symbols.
+     */
+    async dispose() {
+        this.stopAutoClean();
+        if (this.config.symbols.enabled) {
+            await this.symbols.persist();
+        }
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/cache/manager.js.map

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

package/dist/cache/symbol-index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * AST/Symbol Index Cache — extracts and caches function/class/type symbols.
+ *
+ * Uses regex-based extraction for TypeScript/JavaScript and Python.
+ * Persists index to disk for fast startup. Incremental indexing via mtime checks.
+ */
+import type { SymbolCacheConfig } from '../config/schema.js';
+export type SymbolKind = 'function' | 'class' | 'interface' | 'type' | 'enum' | 'const' | 'variable' | 'method';
+export interface SymbolEntry {
+    name: string;
+    kind: SymbolKind;
+    file: string;
+    line: number;
+    exported: boolean;
+}
+export interface FileIndex {
+    path: string;
+    mtimeMs: number;
+    symbols: SymbolEntry[];
+}
+export interface SymbolIndexStats {
+    filesIndexed: number;
+    totalSymbols: number;
+    lastPersisted: number | null;
+    maxFiles: number;
+}
+export declare class SymbolIndex {
+    private config;
+    private index;
+    private lastPersisted;
+    constructor(config: SymbolCacheConfig);
+    /**
+     * Index a single file, extracting symbols.
+     * Returns null if the file is already indexed and unchanged.
+     */
+    indexFile(filePath: string): Promise<FileIndex | null>;
+    /**
+     * Index all supported files in a directory recursively.
+     */
+    indexDirectory(dirPath: string, maxDepth?: number): Promise<number>;
+    /**
+     * Search for symbols by name (prefix match).
+     */
+    search(query: string, limit?: number): SymbolEntry[];
+    /**
+     * Get all symbols for a specific file.
+     */
+    getFileSymbols(filePath: string): SymbolEntry[];
+    /**
+     * Invalidate a file's symbol index (e.g. after edit).
+     */
+    invalidate(filePath: string): void;
+    /**
+     * Clear the entire index.
+     */
+    clear(): void;
+    /**
+     * Persist the index to disk.
+     */
+    persist(): Promise<void>;
+    /**
+     * Load the index from disk.
+     */
+    load(): Promise<number>;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): SymbolIndexStats;
+    private extractSymbols;
+    private getPatternsForExt;
+    private isSupportedExtension;
+    private resolvePath;
+    private walkDir;
+}
+//# sourceMappingURL=symbol-index.d.ts.map

package/dist/cache/symbol-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-index.d.ts","sourceRoot":"","sources":["../../src/cache/symbol-index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAiCD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,aAAa,CAAuB;gBAEhC,MAAM,EAAE,iBAAiB;IAIrC;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IA+C5D;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAepE;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,EAAE;IAgBhD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAI/C;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB7B;;OAEG;IACH,QAAQ,IAAI,gBAAgB;IAe5B,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,oBAAoB;IAI5B,OAAO,CAAC,WAAW;YAOL,OAAO;CA6BtB"}

package/dist/cache/symbol-index.js

@@ -0,0 +1,267 @@
+/**
+ * AST/Symbol Index Cache — extracts and caches function/class/type symbols.
+ *
+ * Uses regex-based extraction for TypeScript/JavaScript and Python.
+ * Persists index to disk for fast startup. Incremental indexing via mtime checks.
+ */
+import { readFile, writeFile, stat, mkdir } from 'node:fs/promises';
+import { dirname, extname, resolve } from 'node:path';
+import { readdir } from 'node:fs/promises';
+import { homedir } from 'node:os';
+// ─── Regex patterns for symbol extraction ───────────────────────────
+// TypeScript/JavaScript patterns
+const TS_PATTERNS = [
+    { kind: 'function', regex: /^export\s+(?:async\s+)?function\s+(\w+)/gm, exported: true },
+    { kind: 'function', regex: /^(?:async\s+)?function\s+(\w+)/gm, exported: false },
+    { kind: 'class', regex: /^export\s+(?:abstract\s+)?class\s+(\w+)/gm, exported: true },
+    { kind: 'class', regex: /^(?:abstract\s+)?class\s+(\w+)/gm, exported: false },
+    { kind: 'interface', regex: /^export\s+interface\s+(\w+)/gm, exported: true },
+    { kind: 'interface', regex: /^interface\s+(\w+)/gm, exported: false },
+    { kind: 'type', regex: /^export\s+type\s+(\w+)/gm, exported: true },
+    { kind: 'type', regex: /^type\s+(\w+)/gm, exported: false },
+    { kind: 'enum', regex: /^export\s+(?:const\s+)?enum\s+(\w+)/gm, exported: true },
+    { kind: 'enum', regex: /^(?:const\s+)?enum\s+(\w+)/gm, exported: false },
+    { kind: 'const', regex: /^export\s+const\s+(\w+)/gm, exported: true },
+];
+// Python patterns
+const PY_PATTERNS = [
+    { kind: 'function', regex: /^(?:async\s+)?def\s+(\w+)/gm, exported: true },
+    { kind: 'class', regex: /^class\s+(\w+)/gm, exported: true },
+];
+// ─── Symbol Index Cache ─────────────────────────────────────────────
+export class SymbolIndex {
+    config;
+    index = new Map();
+    lastPersisted = null;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Index a single file, extracting symbols.
+     * Returns null if the file is already indexed and unchanged.
+     */
+    async indexFile(filePath) {
+        if (!this.config.enabled)
+            return null;
+        // Check mtime to skip unchanged files
+        let mtimeMs;
+        try {
+            const st = await stat(filePath);
+            mtimeMs = st.mtimeMs;
+        }
+        catch {
+            // File gone — remove from index
+            this.index.delete(filePath);
+            return null;
+        }
+        const existing = this.index.get(filePath);
+        if (existing && existing.mtimeMs === mtimeMs) {
+            return existing; // Unchanged
+        }
+        // Read and parse
+        let content;
+        try {
+            content = await readFile(filePath, 'utf-8');
+        }
+        catch {
+            return null;
+        }
+        const ext = extname(filePath).toLowerCase();
+        const symbols = this.extractSymbols(filePath, content, ext);
+        const fileIndex = { path: filePath, mtimeMs, symbols };
+        this.index.set(filePath, fileIndex);
+        // Enforce max files limit
+        if (this.index.size > this.config.maxFiles) {
+            // Remove oldest entries (by insertion order — Map preserves insertion order)
+            const excess = this.index.size - this.config.maxFiles;
+            const keys = this.index.keys();
+            for (let i = 0; i < excess; i++) {
+                const { value } = keys.next();
+                if (value)
+                    this.index.delete(value);
+            }
+        }
+        return fileIndex;
+    }
+    /**
+     * Index all supported files in a directory recursively.
+     */
+    async indexDirectory(dirPath, maxDepth = 5) {
+        if (!this.config.enabled)
+            return 0;
+        let indexed = 0;
+        await this.walkDir(dirPath, maxDepth, 0, async (filePath) => {
+            if (this.index.size >= this.config.maxFiles)
+                return;
+            const ext = extname(filePath).toLowerCase();
+            if (this.isSupportedExtension(ext)) {
+                await this.indexFile(filePath);
+                indexed++;
+            }
+        });
+        return indexed;
+    }
+    /**
+     * Search for symbols by name (prefix match).
+     */
+    search(query, limit = 20) {
+        const results = [];
+        const lowerQuery = query.toLowerCase();
+        for (const fileIndex of this.index.values()) {
+            for (const sym of fileIndex.symbols) {
+                if (sym.name.toLowerCase().startsWith(lowerQuery)) {
+                    results.push(sym);
+                    if (results.length >= limit)
+                        return results;
+                }
+            }
+        }
+        return results;
+    }
+    /**
+     * Get all symbols for a specific file.
+     */
+    getFileSymbols(filePath) {
+        return this.index.get(filePath)?.symbols ?? [];
+    }
+    /**
+     * Invalidate a file's symbol index (e.g. after edit).
+     */
+    invalidate(filePath) {
+        this.index.delete(filePath);
+    }
+    /**
+     * Clear the entire index.
+     */
+    clear() {
+        this.index.clear();
+    }
+    /**
+     * Persist the index to disk.
+     */
+    async persist() {
+        const persistPath = this.resolvePath(this.config.persistPath);
+        const data = {
+            version: 1,
+            updatedAt: new Date().toISOString(),
+            files: Array.from(this.index.values()),
+        };
+        try {
+            await mkdir(dirname(persistPath), { recursive: true });
+            await writeFile(persistPath, JSON.stringify(data), 'utf-8');
+            this.lastPersisted = Date.now();
+        }
+        catch (err) {
+            console.error(`[symbol-index] Failed to persist: ${err}`);
+        }
+    }
+    /**
+     * Load the index from disk.
+     */
+    async load() {
+        const persistPath = this.resolvePath(this.config.persistPath);
+        try {
+            const raw = await readFile(persistPath, 'utf-8');
+            const data = JSON.parse(raw);
+            if (data.version !== 1)
+                return 0;
+            for (const fileIndex of data.files) {
+                this.index.set(fileIndex.path, fileIndex);
+            }
+            this.lastPersisted = Date.now();
+            return data.files.length;
+        }
+        catch {
+            return 0; // No persisted index
+        }
+    }
+    /**
+     * Get cache statistics.
+     */
+    getStats() {
+        let totalSymbols = 0;
+        for (const fileIndex of this.index.values()) {
+            totalSymbols += fileIndex.symbols.length;
+        }
+        return {
+            filesIndexed: this.index.size,
+            totalSymbols,
+            lastPersisted: this.lastPersisted,
+            maxFiles: this.config.maxFiles,
+        };
+    }
+    // ─── Private ────────────────────────────────────────────────────
+    extractSymbols(filePath, content, ext) {
+        const patterns = this.getPatternsForExt(ext);
+        if (!patterns)
+            return [];
+        const lines = content.split('\n');
+        const symbols = [];
+        const seen = new Set();
+        for (const { kind, regex, exported } of patterns) {
+            // Reset regex state
+            regex.lastIndex = 0;
+            let match;
+            while ((match = regex.exec(content)) !== null) {
+                const name = match[1];
+                const key = `${kind}:${name}:${exported}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                // Find line number
+                const lineNum = content.slice(0, match.index).split('\n').length;
+                symbols.push({ name, kind, file: filePath, line: lineNum, exported });
+            }
+        }
+        return symbols;
+    }
+    getPatternsForExt(ext) {
+        switch (ext) {
+            case '.ts':
+            case '.tsx':
+            case '.js':
+            case '.jsx':
+            case '.mts':
+            case '.mjs':
+                return TS_PATTERNS;
+            case '.py':
+                return PY_PATTERNS;
+            default:
+                return null;
+        }
+    }
+    isSupportedExtension(ext) {
+        return ['.ts', '.tsx', '.js', '.jsx', '.mts', '.mjs', '.py'].includes(ext);
+    }
+    resolvePath(p) {
+        if (p.startsWith('~/') || p === '~') {
+            return resolve(homedir(), p.slice(2));
+        }
+        return resolve(p);
+    }
+    async walkDir(dir, maxDepth, depth, callback) {
+        if (depth > maxDepth)
+            return;
+        let entries;
+        try {
+            entries = await readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const fullPath = resolve(dir, entry.name);
+            // Skip common non-source directories
+            if (entry.isDirectory()) {
+                if (['node_modules', '.git', 'dist', 'build', '.next', '__pycache__', '.venv'].includes(entry.name)) {
+                    continue;
+                }
+                await this.walkDir(fullPath, maxDepth, depth + 1, callback);
+            }
+            else if (entry.isFile()) {
+                await callback(fullPath);
+            }
+        }
+    }
+}
+//# sourceMappingURL=symbol-index.js.map

package/dist/cache/symbol-index.js.map

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

package/dist/cache/tool-cache.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Tool Execution Cache — caches command results keyed by SHA256(command+args+cwd).
+ *
+ * Features:
+ * - Per-command TTL overrides (git status 10s, ls 30s, grep 15s, etc.)
+ * - Blocklist for side-effect commands (test, build, make, etc.)
+ * - Auto-invalidation on file writes in the same cwd
+ */
+import type { ToolCacheConfig } from '../config/schema.js';
+export interface ToolCacheEntry {
+    output: string;
+    success: boolean;
+    error?: string;
+    cachedAt: number;
+    ttlMs: number;
+    commandKey: string;
+}
+export interface ToolCacheStats {
+    entries: number;
+    hits: number;
+    misses: number;
+    blocked: number;
+    evictions: number;
+    hitRate: number;
+}
+export declare class ToolCache {
+    private config;
+    private cache;
+    private hits;
+    private misses;
+    private blocked;
+    private evictions;
+    constructor(config: ToolCacheConfig);
+    /**
+     * Build a cache key from command, args, and cwd.
+     */
+    static buildKey(command: string, cwd: string): string;
+    /**
+     * Check if a command is blocklisted (should never be cached).
+     */
+    isBlocked(command: string): boolean;
+    /**
+     * Get the TTL for a command in milliseconds.
+     */
+    getTtlMs(command: string): number;
+    /**
+     * Get a cached result if valid, or null if stale/missing/blocked.
+     */
+    get(command: string, cwd: string): ToolCacheEntry | null;
+    /**
+     * Store a command result in cache.
+     */
+    set(command: string, cwd: string, output: string, success: boolean, error?: string): void;
+    /**
+     * Invalidate all cached commands for a given cwd (e.g. after file write).
+     */
+    invalidateCwd(cwd: string): void;
+    /**
+     * Clear the entire cache.
+     */
+    clear(): void;
+    /**
+     * Run auto-clean: remove expired entries.
+     */
+    autoClean(): number;
+    /**
+     * Get cache statistics.
+     */
+    getStats(): ToolCacheStats;
+    /**
+     * Reset counters (for testing).
+     */
+    resetStats(): void;
+}
+//# sourceMappingURL=tool-cache.d.ts.map

package/dist/cache/tool-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-cache.d.ts","sourceRoot":"","sources":["../../src/cache/tool-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAwBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAK;gBAEV,MAAM,EAAE,eAAe;IAInC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAMrD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOnC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAkBjC;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IA2BxD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAiBzF;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAWhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,MAAM;IAanB;;OAEG;IACH,QAAQ,IAAI,cAAc;IAY1B;;OAEG;IACH,UAAU,IAAI,IAAI;CAMnB"}