token-pilot 0.1.1

package/dist/core/symbol-resolver.js

@@ -0,0 +1,102 @@
+export class SymbolResolver {
+    astIndex;
+    constructor(astIndex) {
+        this.astIndex = astIndex;
+    }
+    /**
+     * Resolve a symbol by qualified name.
+     * First tries ast-index, falls back to searching cached structure.
+     */
+    async resolve(qualifiedName, structure) {
+        // Try ast-index first
+        const detail = await this.astIndex.symbol(qualifiedName);
+        if (detail) {
+            // ast-index only provides start_line; estimate end_line from structure
+            let endLine = detail.start_line + 10;
+            if (structure) {
+                const found = this.findInStructure(qualifiedName, structure.symbols);
+                if (found)
+                    endLine = found.location.endLine;
+            }
+            return {
+                symbol: {
+                    name: detail.name,
+                    qualifiedName: qualifiedName,
+                    kind: this.mapKind(detail.kind),
+                    signature: detail.signature ?? detail.name,
+                    location: {
+                        startLine: detail.start_line,
+                        endLine,
+                        lineCount: endLine - detail.start_line + 1,
+                    },
+                    visibility: 'default',
+                    async: false,
+                    static: false,
+                    decorators: [],
+                    children: [],
+                    doc: null,
+                    references: [],
+                },
+                filePath: detail.file,
+                startLine: detail.start_line,
+                endLine,
+            };
+        }
+        // Fallback: search in provided structure
+        if (structure) {
+            const found = this.findInStructure(qualifiedName, structure.symbols);
+            if (found) {
+                return {
+                    symbol: found,
+                    filePath: structure.path,
+                    startLine: found.location.startLine,
+                    endLine: found.location.endLine,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract source code for a resolved symbol from file lines.
+     */
+    extractSource(resolved, lines, options = {}) {
+        const { contextBefore = 2, contextAfter = 0 } = options;
+        const start = Math.max(0, resolved.startLine - 1 - contextBefore);
+        const end = Math.min(lines.length, resolved.endLine + contextAfter);
+        const output = [];
+        for (let i = start; i < end; i++) {
+            const lineNum = String(i + 1).padStart(4);
+            output.push(`${lineNum} | ${lines[i]}`);
+        }
+        return output.join('\n');
+    }
+    mapKind(kind) {
+        const map = {
+            function: 'function', class: 'class', method: 'method',
+            property: 'property', variable: 'variable', type: 'type',
+            interface: 'interface', enum: 'enum', constant: 'constant',
+            namespace: 'namespace', struct: 'class', trait: 'interface',
+            impl: 'class', module: 'namespace',
+        };
+        return map[kind.toLowerCase()] ?? 'function';
+    }
+    findInStructure(qualifiedName, symbols) {
+        const parts = qualifiedName.split('.');
+        for (const sym of symbols) {
+            if (parts.length === 1 && sym.name === parts[0]) {
+                return sym;
+            }
+            if (parts.length === 2 && sym.name === parts[0]) {
+                const child = sym.children.find(c => c.name === parts[1]);
+                if (child)
+                    return child;
+            }
+            // Recurse
+            const found = this.findInStructure(qualifiedName, sym.children);
+            if (found)
+                return found;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=symbol-resolver.js.map

package/dist/core/symbol-resolver.js.map

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

package/dist/core/token-estimator.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Estimate token count for text content.
+ * Uses a simple heuristic calibrated against cl100k_base.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Format a token savings message.
+ */
+export declare function formatSavings(actual: number, wouldBe: number): string;
+//# sourceMappingURL=token-estimator.d.ts.map

package/dist/core/token-estimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.d.ts","sourceRoot":"","sources":["../../src/core/token-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIrE"}

package/dist/core/token-estimator.js

@@ -0,0 +1,22 @@
+/**
+ * Estimate token count for text content.
+ * Uses a simple heuristic calibrated against cl100k_base.
+ */
+export function estimateTokens(text) {
+    if (text.length === 0)
+        return 0;
+    const charEstimate = Math.ceil(text.length / 4);
+    const whitespaceRatio = (text.match(/\s/g)?.length ?? 0) / text.length;
+    const adjustment = 1 - (whitespaceRatio * 0.3);
+    return Math.ceil(charEstimate * adjustment);
+}
+/**
+ * Format a token savings message.
+ */
+export function formatSavings(actual, wouldBe) {
+    if (wouldBe <= 0)
+        return '';
+    const saved = Math.round((1 - actual / wouldBe) * 100);
+    return `TOKEN SAVINGS: ~${actual} tokens (structure) vs ~${wouldBe} tokens (full file) = ${saved}% saved`;
+}
+//# sourceMappingURL=token-estimator.js.map

package/dist/core/token-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-estimator.js","sourceRoot":"","sources":["../../src/core/token-estimator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,MAAM,eAAe,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACvE,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,OAAe;IAC3D,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IACvD,OAAO,mBAAmB,MAAM,2BAA2B,OAAO,yBAAyB,KAAK,SAAS,CAAC;AAC5G,CAAC"}

package/dist/core/validation.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Resolve a user-provided path and validate it stays within projectRoot.
+ * Prevents path traversal attacks (e.g. ../../etc/passwd).
+ */
+export declare function resolveSafePath(projectRoot: string, userPath: string): string;
+/**
+ * Validate smart_read arguments.
+ */
+export declare function validateSmartReadArgs(args: unknown): {
+    path: string;
+    show_imports?: boolean;
+    show_docs?: boolean;
+    show_references?: boolean;
+    depth?: number;
+};
+/**
+ * Validate read_symbol arguments.
+ */
+export declare function validateReadSymbolArgs(args: unknown): {
+    path: string;
+    symbol: string;
+    context_before?: number;
+    context_after?: number;
+};
+/**
+ * Validate read_range arguments.
+ */
+export declare function validateReadRangeArgs(args: unknown): {
+    path: string;
+    start_line: number;
+    end_line: number;
+};
+/**
+ * Validate read_diff arguments.
+ */
+export declare function validateReadDiffArgs(args: unknown): {
+    path: string;
+    context_lines?: number;
+};
+/**
+ * Validate search_code arguments.
+ */
+export declare function validateSearchCodeArgs(args: unknown): {
+    query: string;
+    in_file?: string;
+    max_results?: number;
+    fuzzy?: boolean;
+};
+/**
+ * Validate find_usages arguments.
+ */
+export declare function validateFindUsagesArgs(args: unknown): {
+    symbol: string;
+};
+/**
+ * Validate find_implementations arguments.
+ */
+export declare function validateFindImplementationsArgs(args: unknown): {
+    name: string;
+};
+/**
+ * Validate class_hierarchy arguments.
+ */
+export declare function validateClassHierarchyArgs(args: unknown): {
+    name: string;
+};
+/**
+ * Validate smart_read_many arguments.
+ */
+export declare function validateSmartReadManyArgs(args: unknown): {
+    paths: string[];
+};
+export declare function validateExportAstIndexArgs(args: unknown): {
+    paths?: string[];
+    format?: 'markdown' | 'json';
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/core/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/core/validation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAS7E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAeA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAiBA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAkBA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAYA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAcA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CASxE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAS/E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAS1E;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAc5E;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,OAAO,GAAG;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAC9B,CAqBA"}

package/dist/core/validation.js

@@ -0,0 +1,208 @@
+import { resolve, relative } from 'node:path';
+/**
+ * Resolve a user-provided path and validate it stays within projectRoot.
+ * Prevents path traversal attacks (e.g. ../../etc/passwd).
+ */
+export function resolveSafePath(projectRoot, userPath) {
+    const absPath = resolve(projectRoot, userPath);
+    const rel = relative(projectRoot, absPath);
+    if (rel.startsWith('..') || resolve(projectRoot, rel) !== absPath) {
+        throw new Error(`Path "${userPath}" resolves outside project root.`);
+    }
+    return absPath;
+}
+/**
+ * Validate smart_read arguments.
+ */
+export function validateSmartReadArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.path !== 'string' || a.path.length === 0) {
+        throw new Error('Required parameter "path" must be a non-empty string.');
+    }
+    return {
+        path: a.path,
+        show_imports: optionalBool(a.show_imports, 'show_imports'),
+        show_docs: optionalBool(a.show_docs, 'show_docs'),
+        show_references: optionalBool(a.show_references, 'show_references'),
+        depth: optionalNumber(a.depth, 'depth'),
+    };
+}
+/**
+ * Validate read_symbol arguments.
+ */
+export function validateReadSymbolArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.path !== 'string' || a.path.length === 0) {
+        throw new Error('Required parameter "path" must be a non-empty string.');
+    }
+    if (typeof a.symbol !== 'string' || a.symbol.length === 0) {
+        throw new Error('Required parameter "symbol" must be a non-empty string.');
+    }
+    return {
+        path: a.path,
+        symbol: a.symbol,
+        context_before: optionalNumber(a.context_before, 'context_before'),
+        context_after: optionalNumber(a.context_after, 'context_after'),
+    };
+}
+/**
+ * Validate read_range arguments.
+ */
+export function validateReadRangeArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.path !== 'string' || a.path.length === 0) {
+        throw new Error('Required parameter "path" must be a non-empty string.');
+    }
+    if (typeof a.start_line !== 'number' || !Number.isInteger(a.start_line) || a.start_line < 1) {
+        throw new Error('Required parameter "start_line" must be a positive integer.');
+    }
+    if (typeof a.end_line !== 'number' || !Number.isInteger(a.end_line) || a.end_line < 1) {
+        throw new Error('Required parameter "end_line" must be a positive integer.');
+    }
+    if (a.end_line < a.start_line) {
+        throw new Error('"end_line" must be >= "start_line".');
+    }
+    return { path: a.path, start_line: a.start_line, end_line: a.end_line };
+}
+/**
+ * Validate read_diff arguments.
+ */
+export function validateReadDiffArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.path !== 'string' || a.path.length === 0) {
+        throw new Error('Required parameter "path" must be a non-empty string.');
+    }
+    return {
+        path: a.path,
+        context_lines: optionalNumber(a.context_lines, 'context_lines'),
+    };
+}
+/**
+ * Validate search_code arguments.
+ */
+export function validateSearchCodeArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.query !== 'string' || a.query.length === 0) {
+        throw new Error('Required parameter "query" must be a non-empty string.');
+    }
+    return {
+        query: a.query,
+        in_file: optionalString(a.in_file, 'in_file'),
+        max_results: optionalNumber(a.max_results, 'max_results'),
+        fuzzy: optionalBool(a.fuzzy, 'fuzzy'),
+    };
+}
+/**
+ * Validate find_usages arguments.
+ */
+export function validateFindUsagesArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.symbol !== 'string' || a.symbol.length === 0) {
+        throw new Error('Required parameter "symbol" must be a non-empty string.');
+    }
+    return { symbol: a.symbol };
+}
+/**
+ * Validate find_implementations arguments.
+ */
+export function validateFindImplementationsArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.name !== 'string' || a.name.length === 0) {
+        throw new Error('Required parameter "name" must be a non-empty string.');
+    }
+    return { name: a.name };
+}
+/**
+ * Validate class_hierarchy arguments.
+ */
+export function validateClassHierarchyArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (typeof a.name !== 'string' || a.name.length === 0) {
+        throw new Error('Required parameter "name" must be a non-empty string.');
+    }
+    return { name: a.name };
+}
+/**
+ * Validate smart_read_many arguments.
+ */
+export function validateSmartReadManyArgs(args) {
+    if (!args || typeof args !== 'object') {
+        throw new Error('Arguments must be an object.');
+    }
+    const a = args;
+    if (!Array.isArray(a.paths)) {
+        throw new Error('Required parameter "paths" must be an array of strings.');
+    }
+    for (const p of a.paths) {
+        if (typeof p !== 'string' || p.length === 0) {
+            throw new Error('Each path in "paths" must be a non-empty string.');
+        }
+    }
+    return { paths: a.paths };
+}
+export function validateExportAstIndexArgs(args) {
+    if (!args || typeof args !== 'object')
+        return {};
+    const a = args;
+    const result = {};
+    if (Array.isArray(a.paths)) {
+        for (const p of a.paths) {
+            if (typeof p !== 'string')
+                throw new Error('Each path must be a string.');
+        }
+        result.paths = a.paths;
+    }
+    if (a.format !== undefined) {
+        if (a.format !== 'markdown' && a.format !== 'json') {
+            throw new Error('"format" must be "markdown" or "json".');
+        }
+        result.format = a.format;
+    }
+    return result;
+}
+function optionalString(val, name) {
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val !== 'string')
+        throw new Error(`"${name}" must be a string.`);
+    return val;
+}
+function optionalBool(val, name) {
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val !== 'boolean')
+        throw new Error(`"${name}" must be a boolean.`);
+    return val;
+}
+function optionalNumber(val, name) {
+    if (val === undefined || val === null)
+        return undefined;
+    if (typeof val !== 'number')
+        throw new Error(`"${name}" must be a number.`);
+    return val;
+}
+//# sourceMappingURL=validation.js.map

package/dist/core/validation.js.map

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

package/dist/formatters/structure.d.ts

@@ -0,0 +1,13 @@
+import type { FileStructure } from '../types.js';
+export interface FormatOptions {
+    showImports?: boolean;
+    showDocs?: boolean;
+    showDependencyHints?: boolean;
+    maxDepth?: number;
+    showTokenSavings?: boolean;
+}
+/**
+ * Format a FileStructure as token-optimized text for LLMs.
+ */
+export declare function formatOutline(structure: FileStructure, options?: FormatOptions): string;
+//# sourceMappingURL=structure.d.ts.map

package/dist/formatters/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../src/formatters/structure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,aAAa,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,GAAE,aAAkB,GAAG,MAAM,CAmD3F"}

package/dist/formatters/structure.js

@@ -0,0 +1,90 @@
+/**
+ * Format a FileStructure as token-optimized text for LLMs.
+ */
+export function formatOutline(structure, options = {}) {
+    const { showImports = true, showDocs = true, showDependencyHints = true, maxDepth = 2, } = options;
+    const lines = [];
+    // Header
+    const sizeKB = (structure.meta.bytes / 1024).toFixed(1);
+    lines.push(`FILE: ${structure.path} (${structure.meta.lines} lines, ${sizeKB}KB)`);
+    lines.push(`LANGUAGE: ${structure.language}`);
+    lines.push('');
+    // Imports
+    if (showImports && structure.imports.length > 0) {
+        lines.push('IMPORTS:');
+        for (const imp of structure.imports) {
+            if (imp.isNamespace) {
+                lines.push(`  * as ${imp.specifiers[0]} from '${imp.source}'`);
+            }
+            else if (imp.isDefault) {
+                lines.push(`  ${imp.specifiers[0]} from '${imp.source}'`);
+            }
+            else {
+                lines.push(`  { ${imp.specifiers.join(', ')} } from '${imp.source}'`);
+            }
+        }
+        lines.push('');
+    }
+    // Exports
+    if (structure.exports.length > 0) {
+        lines.push('EXPORTS:');
+        for (const exp of structure.exports) {
+            const defaultLabel = exp.isDefault ? ' (default)' : '';
+            lines.push(`  ${exp.kind} ${exp.name}${defaultLabel}`);
+        }
+        lines.push('');
+    }
+    // Structure
+    lines.push('STRUCTURE:');
+    for (const sym of structure.symbols) {
+        formatSymbolTree(sym, lines, 1, maxDepth, showDocs, showDependencyHints);
+    }
+    lines.push('');
+    lines.push('HINT: Use read_symbol("<ClassName>.<method>") to load a specific symbol.');
+    return lines.join('\n');
+}
+function formatSymbolTree(sym, lines, depth, maxDepth, showDocs, showDeps) {
+    const indent = '  '.repeat(depth);
+    const asyncPrefix = sym.async ? 'async ' : '';
+    const staticPrefix = sym.static ? 'static ' : '';
+    const visPrefix = sym.visibility !== 'default' ? `${sym.visibility} ` : '';
+    // Decorators
+    for (const dec of sym.decorators) {
+        lines.push(`${indent}@${dec}`);
+    }
+    // Symbol line
+    const loc = `[L${sym.location.startLine}-${sym.location.endLine}]`;
+    const lineCount = `(${sym.location.lineCount} lines)`;
+    if (sym.kind === 'class' || sym.kind === 'interface' || sym.kind === 'enum') {
+        lines.push(`${indent}${sym.kind} ${sym.name}: ${loc} ${lineCount}`);
+    }
+    else {
+        lines.push(`${indent}- ${visPrefix}${staticPrefix}${asyncPrefix}${sym.signature} ${loc} ${lineCount}`);
+    }
+    // Dependency hints (references)
+    if (showDeps && sym.references.length > 0) {
+        lines.push(`${indent}    calls: ${sym.references.join(', ')}`);
+    }
+    // Children
+    if (depth < maxDepth && sym.children.length > 0) {
+        // Group by visibility
+        const publicMethods = sym.children.filter(c => c.visibility === 'public' || c.visibility === 'default');
+        const privateMethods = sym.children.filter(c => c.visibility === 'private' || c.visibility === 'protected');
+        if (publicMethods.length > 0) {
+            lines.push(`${indent}  Public Methods:`);
+            for (const child of publicMethods) {
+                formatSymbolTree(child, lines, depth + 2, maxDepth, showDocs, showDeps);
+            }
+        }
+        if (privateMethods.length > 0) {
+            lines.push(`${indent}  Private Methods:`);
+            for (const child of privateMethods) {
+                formatSymbolTree(child, lines, depth + 2, maxDepth, showDocs, showDeps);
+            }
+        }
+    }
+    else if (sym.children.length > 0) {
+        lines.push(`${indent}  (${sym.children.length} members — increase depth to see)`);
+    }
+}
+//# sourceMappingURL=structure.js.map

package/dist/formatters/structure.js.map

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

package/dist/git/file-watcher.d.ts

@@ -0,0 +1,17 @@
+import type { FileCache } from '../core/file-cache.js';
+import type { ContextRegistry } from '../core/context-registry.js';
+/**
+ * Watches project files for changes and auto-invalidates cache.
+ * Only watches files that are currently cached to avoid unnecessary overhead.
+ */
+export declare class FileWatcher {
+    private projectRoot;
+    private fileCache;
+    private contextRegistry;
+    private watcher;
+    private ignore;
+    constructor(projectRoot: string, fileCache: FileCache, contextRegistry: ContextRegistry, ignore: string[]);
+    start(): void;
+    stop(): void;
+}
+//# sourceMappingURL=file-watcher.d.ts.map

package/dist/git/file-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.d.ts","sourceRoot":"","sources":["../../src/git/file-watcher.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAEnE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,MAAM,CAAW;gBAGvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,EACpB,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,MAAM,EAAE;IAQlB,KAAK,IAAI,IAAI;IAiCb,IAAI,IAAI,IAAI;CAIb"}

package/dist/git/file-watcher.js

@@ -0,0 +1,54 @@
+import { watch } from 'chokidar';
+import { resolve } from 'node:path';
+/**
+ * Watches project files for changes and auto-invalidates cache.
+ * Only watches files that are currently cached to avoid unnecessary overhead.
+ */
+export class FileWatcher {
+    projectRoot;
+    fileCache;
+    contextRegistry;
+    watcher = null;
+    ignore;
+    constructor(projectRoot, fileCache, contextRegistry, ignore) {
+        this.projectRoot = projectRoot;
+        this.fileCache = fileCache;
+        this.contextRegistry = contextRegistry;
+        this.ignore = ignore;
+    }
+    start() {
+        this.watcher = watch(this.projectRoot, {
+            persistent: false,
+            ignoreInitial: true,
+            ignored: [
+                '**/node_modules/**',
+                '**/.git/**',
+                '**/dist/**',
+                '**/build/**',
+                '**/__pycache__/**',
+                '**/target/**', // Rust
+                ...this.ignore.map(p => resolve(this.projectRoot, p)),
+            ],
+            depth: 10,
+        });
+        this.watcher.on('change', (filePath) => {
+            // Invalidate only if this file is in cache
+            const absPath = resolve(filePath);
+            if (this.fileCache.get(absPath)) {
+                this.fileCache.invalidate(absPath);
+                // Don't invalidate context registry — the advisory reminder will
+                // detect staleness via content hash mismatch
+            }
+        });
+        this.watcher.on('unlink', (filePath) => {
+            const absPath = resolve(filePath);
+            this.fileCache.invalidate(absPath);
+            this.contextRegistry.forget(absPath);
+        });
+    }
+    stop() {
+        this.watcher?.close();
+        this.watcher = null;
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/git/file-watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-watcher.js","sourceRoot":"","sources":["../../src/git/file-watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,OAAO,EAAW,MAAM,WAAW,CAAC;AAI7C;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,WAAW,CAAS;IACpB,SAAS,CAAY;IACrB,eAAe,CAAkB;IACjC,OAAO,GAAoC,IAAI,CAAC;IAChD,MAAM,CAAW;IAEzB,YACE,WAAmB,EACnB,SAAoB,EACpB,eAAgC,EAChC,MAAgB;QAEhB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE;YACrC,UAAU,EAAE,KAAK;YACjB,aAAa,EAAE,IAAI;YACnB,OAAO,EAAE;gBACP,oBAAoB;gBACpB,YAAY;gBACZ,YAAY;gBACZ,aAAa;gBACb,mBAAmB;gBACnB,cAAc,EAAE,OAAO;gBACvB,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;aACtD;YACD,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE;YAC7C,2CAA2C;YAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;gBACnC,iEAAiE;gBACjE,6CAA6C;YAC/C,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAgB,EAAE,EAAE;YAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}