causantic 0.9.4 → 0.10.1

package/dist/models/model-registry.js

@@ -7,16 +7,29 @@ export const MODEL_REGISTRY = {
         hfId: 'nomic-ai/nomic-embed-text-v1.5',
         dims: 768,
         contextTokens: 8192,
+        pooling: 'mean',
         usesPrefix: true,
         documentPrefix: 'search_document: ',
         queryPrefix: 'search_query: ',
         notes: 'Matryoshka dimensions (768/512/384/256/128). Needs task prefixes.',
     },
+    'arctic-embed-m': {
+        id: 'arctic-embed-m',
+        hfId: 'Snowflake/snowflake-arctic-embed-m-v1.5',
+        dims: 768,
+        contextTokens: 512,
+        pooling: 'cls',
+        usesPrefix: true,
+        documentPrefix: '',
+        queryPrefix: 'Represent this sentence for searching relevant passages: ',
+        notes: 'BertModel, CLS pooling. Matryoshka (768/256). MTEB retrieval 55.1. 512 token context.',
+    },
     'jina-code': {
         id: 'jina-code',
         hfId: 'jinaai/jina-embeddings-v2-base-code',
         dims: 768,
         contextTokens: 8192,
+        pooling: 'mean',
         usesPrefix: false,
         documentPrefix: '',
         queryPrefix: '',
@@ -27,6 +40,7 @@ export const MODEL_REGISTRY = {
         hfId: 'Xenova/jina-embeddings-v2-small-en',
         dims: 512,
         contextTokens: 8192,
+        pooling: 'mean',
         usesPrefix: false,
         documentPrefix: '',
         queryPrefix: '',
@@ -37,6 +51,7 @@ export const MODEL_REGISTRY = {
         hfId: 'Xenova/bge-small-en-v1.5',
         dims: 384,
         contextTokens: 512,
+        pooling: 'cls',
         usesPrefix: false,
         documentPrefix: '',
         queryPrefix: '',

package/dist/models/model-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../src/models/model-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAqBH,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,mBAAmB;QACnC,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE,mEAAmE;KAC3E;IACD,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,uDAAuD;KAC/D;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,4BAA4B;KACpC;IACD,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,GAAG;QAClB,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,oDAAoD;KAC5D;CACF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"model-registry.js","sourceRoot":"","sources":["../../src/models/model-registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuBH,MAAM,CAAC,MAAM,cAAc,GAAgC;IACzD,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,gCAAgC;QACtC,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,MAAM;QAEf,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,mBAAmB;QACnC,WAAW,EAAE,gBAAgB;QAC7B,KAAK,EAAE,mEAAmE;KAC3E;IACD,gBAAgB,EAAE;QAChB,EAAE,EAAE,gBAAgB;QACpB,IAAI,EAAE,yCAAyC;QAC/C,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,GAAG;QAClB,OAAO,EAAE,KAAK;QAEd,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,2DAA2D;QACxE,KAAK,EAAE,uFAAuF;KAC/F;IACD,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,MAAM;QAEf,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,uDAAuD;KAC/D;IACD,YAAY,EAAE;QACZ,EAAE,EAAE,YAAY;QAChB,IAAI,EAAE,oCAAoC;QAC1C,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,IAAI;QACnB,OAAO,EAAE,MAAM;QAEf,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,4BAA4B;KACpC;IACD,WAAW,EAAE;QACX,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,GAAG;QACT,aAAa,EAAE,GAAG;QAClB,OAAO,EAAE,KAAK;QAEd,UAAU,EAAE,KAAK;QACjB,cAAc,EAAE,EAAE;QAClB,WAAW,EAAE,EAAE;QACf,KAAK,EAAE,oDAAoD;KAC5D;CACF,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,EAAU;IACjC,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,kBAAkB,EAAE,gBAAgB,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;AACrC,CAAC"}

package/dist/repomap/cache.d.ts

@@ -0,0 +1,58 @@
+/**
+ * File-level cache for parsed tags.
+ *
+ * Stores parsed tags per file, keyed by file path + mtime.
+ * When a file's mtime changes, only that file is re-parsed.
+ * When the file list changes (new/deleted files), the file list hash
+ * is invalidated and a full rescan is triggered.
+ */
+import type { Tag } from './parser.js';
+import type { ScannedFile } from './scanner.js';
+/** In-memory tag cache for a project. */
+export declare class TagCache {
+    /** Cache keyed by relative file path → cached tags. */
+    private fileCache;
+    /** Hash of the file list for staleness detection. */
+    private fileListHash;
+    /**
+     * Compute a hash of the file list (just paths, sorted).
+     * Used to detect when files are added or removed.
+     */
+    private computeFileListHash;
+    /**
+     * Get cached tags for files that haven't changed.
+     * Returns which files need re-parsing.
+     *
+     * @param files - Current list of scanned files
+     * @returns Object with cached tags and files needing re-parse
+     */
+    resolve(files: ScannedFile[]): {
+        /** Tags from cache (file hasn't changed). */
+        cached: Map<string, Tag[]>;
+        /** Files that need re-parsing (new or modified). */
+        stale: ScannedFile[];
+        /** Whether the file list itself changed (files added/removed). */
+        fileListChanged: boolean;
+    };
+    /**
+     * Update the cache with newly parsed tags.
+     */
+    update(file: ScannedFile, tags: Tag[]): void;
+    /**
+     * Get total number of cached files.
+     */
+    get size(): number;
+    /**
+     * Clear the entire cache.
+     */
+    clear(): void;
+}
+/**
+ * Get or create a cache for a project.
+ */
+export declare function getProjectCache(projectPath: string): TagCache;
+/**
+ * Clear all project caches.
+ */
+export declare function clearAllCaches(): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/repomap/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/repomap/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,yCAAyC;AACzC,qBAAa,QAAQ;IACnB,uDAAuD;IACvD,OAAO,CAAC,SAAS,CAAqC;IACtD,qDAAqD;IACrD,OAAO,CAAC,YAAY,CAAc;IAElC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG;QAC7B,6CAA6C;QAC7C,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3B,oDAAoD;QACpD,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,kEAAkE;QAClE,eAAe,EAAE,OAAO,CAAC;KAC1B;IAiCD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAO5C;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,QAAQ,CAO7D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

package/dist/repomap/cache.js

@@ -0,0 +1,101 @@
+/**
+ * File-level cache for parsed tags.
+ *
+ * Stores parsed tags per file, keyed by file path + mtime.
+ * When a file's mtime changes, only that file is re-parsed.
+ * When the file list changes (new/deleted files), the file list hash
+ * is invalidated and a full rescan is triggered.
+ */
+import { createHash } from 'crypto';
+/** In-memory tag cache for a project. */
+export class TagCache {
+    /** Cache keyed by relative file path → cached tags. */
+    fileCache = new Map();
+    /** Hash of the file list for staleness detection. */
+    fileListHash = '';
+    /**
+     * Compute a hash of the file list (just paths, sorted).
+     * Used to detect when files are added or removed.
+     */
+    computeFileListHash(files) {
+        const paths = files.map((f) => f.relativePath).join('\n');
+        return createHash('md5').update(paths).digest('hex');
+    }
+    /**
+     * Get cached tags for files that haven't changed.
+     * Returns which files need re-parsing.
+     *
+     * @param files - Current list of scanned files
+     * @returns Object with cached tags and files needing re-parse
+     */
+    resolve(files) {
+        const newHash = this.computeFileListHash(files);
+        const fileListChanged = newHash !== this.fileListHash;
+        if (fileListChanged) {
+            // File list changed — keep per-file cache entries that still exist,
+            // but mark the list as changed so the graph is rebuilt
+            this.fileListHash = newHash;
+            // Remove entries for files no longer in the list
+            const currentPaths = new Set(files.map((f) => f.relativePath));
+            for (const path of this.fileCache.keys()) {
+                if (!currentPaths.has(path)) {
+                    this.fileCache.delete(path);
+                }
+            }
+        }
+        const cached = new Map();
+        const stale = [];
+        for (const file of files) {
+            const entry = this.fileCache.get(file.relativePath);
+            if (entry && entry.mtimeMs === file.mtimeMs) {
+                cached.set(file.relativePath, entry.tags);
+            }
+            else {
+                stale.push(file);
+            }
+        }
+        return { cached, stale, fileListChanged };
+    }
+    /**
+     * Update the cache with newly parsed tags.
+     */
+    update(file, tags) {
+        this.fileCache.set(file.relativePath, {
+            mtimeMs: file.mtimeMs,
+            tags,
+        });
+    }
+    /**
+     * Get total number of cached files.
+     */
+    get size() {
+        return this.fileCache.size;
+    }
+    /**
+     * Clear the entire cache.
+     */
+    clear() {
+        this.fileCache.clear();
+        this.fileListHash = '';
+    }
+}
+/** Global cache instances per project path. */
+const projectCaches = new Map();
+/**
+ * Get or create a cache for a project.
+ */
+export function getProjectCache(projectPath) {
+    let cache = projectCaches.get(projectPath);
+    if (!cache) {
+        cache = new TagCache();
+        projectCaches.set(projectPath, cache);
+    }
+    return cache;
+}
+/**
+ * Clear all project caches.
+ */
+export function clearAllCaches() {
+    projectCaches.clear();
+}
+//# sourceMappingURL=cache.js.map

package/dist/repomap/cache.js.map

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

package/dist/repomap/graph.d.ts

@@ -0,0 +1,54 @@
+/**
+ * File dependency graph construction and importance ranking.
+ *
+ * Builds a graph where files are nodes and cross-file references are edges.
+ * Ranks files by importance using degree-weighted scoring.
+ */
+import type { Tag } from './parser.js';
+/** A node in the dependency graph (one per file). */
+export interface FileNode {
+    /** Relative file path. */
+    path: string;
+    /** Definitions in this file. */
+    definitions: Tag[];
+    /** All tags (definitions + references). */
+    tags: Tag[];
+    /** Importance score (higher = more important). */
+    score: number;
+}
+/** An edge in the dependency graph. */
+export interface FileEdge {
+    /** File that references a symbol. */
+    from: string;
+    /** File that defines the symbol. */
+    to: string;
+    /** Total weight of this edge. */
+    weight: number;
+    /** Symbol names that create this link. */
+    symbols: string[];
+}
+/** The complete dependency graph. */
+export interface DependencyGraph {
+    /** All file nodes, keyed by relative path. */
+    nodes: Map<string, FileNode>;
+    /** All edges between files. */
+    edges: FileEdge[];
+    /** Files ranked by importance (descending). */
+    rankedFiles: FileNode[];
+}
+/**
+ * Build a dependency graph from parsed tags.
+ *
+ * @param tagsByFile - Map from relative file path to tags extracted from that file
+ * @returns The complete dependency graph with importance ranking
+ */
+export declare function buildGraph(tagsByFile: Map<string, Tag[]>): DependencyGraph;
+/**
+ * Get the most important definitions across all files,
+ * respecting file ranking order.
+ *
+ * Returns definitions from the most important files first,
+ * with definitions within each file ordered by type priority.
+ */
+export declare function getRankedDefinitions(graph: DependencyGraph): Tag[];
+//# sourceMappingURL=graph.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/repomap/graph.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEvC,qDAAqD;AACrD,MAAM,WAAW,QAAQ;IACvB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,WAAW,EAAE,GAAG,EAAE,CAAC;IACnB,2CAA2C;IAC3C,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uCAAuC;AACvC,MAAM,WAAW,QAAQ;IACvB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,+BAA+B;IAC/B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,QAAQ,EAAE,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,eAAe,CA+E1E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,GAAG,EAAE,CA2BlE"}

package/dist/repomap/graph.js

@@ -0,0 +1,113 @@
+/**
+ * File dependency graph construction and importance ranking.
+ *
+ * Builds a graph where files are nodes and cross-file references are edges.
+ * Ranks files by importance using degree-weighted scoring.
+ */
+/**
+ * Build a dependency graph from parsed tags.
+ *
+ * @param tagsByFile - Map from relative file path to tags extracted from that file
+ * @returns The complete dependency graph with importance ranking
+ */
+export function buildGraph(tagsByFile) {
+    // Build index of definitions: symbol name → file paths
+    const definitionIndex = new Map();
+    const nodes = new Map();
+    for (const [filePath, tags] of tagsByFile) {
+        const definitions = tags.filter((t) => t.kind === 'def');
+        nodes.set(filePath, {
+            path: filePath,
+            definitions,
+            tags,
+            score: 0,
+        });
+        for (const def of definitions) {
+            const files = definitionIndex.get(def.name) ?? new Set();
+            files.add(filePath);
+            definitionIndex.set(def.name, files);
+        }
+    }
+    // Build edges: file A references a symbol defined in file B
+    const edgeMap = new Map();
+    for (const [filePath, tags] of tagsByFile) {
+        const references = tags.filter((t) => t.kind === 'ref');
+        for (const ref of references) {
+            const defFiles = definitionIndex.get(ref.name);
+            if (!defFiles)
+                continue;
+            for (const defFile of defFiles) {
+                if (defFile === filePath)
+                    continue; // Skip self-references
+                const edgeKey = `${filePath}→${defFile}`;
+                const existing = edgeMap.get(edgeKey);
+                // Weight bonus for specific identifier names (longer names = more specific)
+                const nameWeight = Math.max(1, Math.log2(ref.name.length));
+                if (existing) {
+                    existing.weight += nameWeight;
+                    existing.symbols.add(ref.name);
+                }
+                else {
+                    edgeMap.set(edgeKey, {
+                        weight: nameWeight,
+                        symbols: new Set([ref.name]),
+                    });
+                }
+            }
+        }
+    }
+    const edges = [];
+    for (const [key, { weight, symbols }] of edgeMap) {
+        const [from, to] = key.split('→');
+        edges.push({ from, to, weight, symbols: [...symbols] });
+    }
+    // Compute importance: sum of weighted in-edges (files that are referenced most)
+    for (const edge of edges) {
+        const targetNode = nodes.get(edge.to);
+        if (targetNode) {
+            targetNode.score += edge.weight;
+        }
+    }
+    // Also give a small base score based on definition count
+    // (files with many definitions are structurally important even if not referenced)
+    for (const node of nodes.values()) {
+        node.score += node.definitions.length * 0.1;
+    }
+    // Rank by score descending
+    const rankedFiles = [...nodes.values()].sort((a, b) => b.score - a.score);
+    return { nodes, edges, rankedFiles };
+}
+/**
+ * Get the most important definitions across all files,
+ * respecting file ranking order.
+ *
+ * Returns definitions from the most important files first,
+ * with definitions within each file ordered by type priority.
+ */
+export function getRankedDefinitions(graph) {
+    const typePriority = {
+        class: 0,
+        interface: 1,
+        type: 2,
+        enum: 3,
+        function: 4,
+        variable: 5,
+        method: 6,
+        export: 7,
+        import: 8,
+        identifier: 9,
+    };
+    const result = [];
+    for (const node of graph.rankedFiles) {
+        const sorted = [...node.definitions].sort((a, b) => {
+            const pa = typePriority[a.type] ?? 99;
+            const pb = typePriority[b.type] ?? 99;
+            if (pa !== pb)
+                return pa - pb;
+            return a.line - b.line;
+        });
+        result.push(...sorted);
+    }
+    return result;
+}
+//# sourceMappingURL=graph.js.map

package/dist/repomap/graph.js.map

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

package/dist/repomap/index.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Repo Map: structural codebase summary.
+ *
+ * Provides a compact overview of a project's structure — files, definitions,
+ * and cross-file relationships — within a token budget. Designed to give
+ * Claude Code the structural context it needs without reading individual files.
+ *
+ * @example
+ * ```typescript
+ * const map = await buildRepoMap('/path/to/project', { maxTokens: 1024 });
+ * console.log(map.text);       // Compact structural summary
+ * console.log(map.fileCount);  // Number of files scanned
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { type DependencyGraph } from './graph.js';
+export type { Tag } from './parser.js';
+export type { DependencyGraph, FileNode, FileEdge } from './graph.js';
+export type { ScannedFile, ScanOptions } from './scanner.js';
+export type { RenderOptions } from './renderer.js';
+export { scanProject } from './scanner.js';
+export { parseFile, isSupportedExtension, getLanguageForExtension } from './parser.js';
+export { parseFileRegex, isRegexSupportedExtension } from './regex-parser.js';
+export { buildGraph, getRankedDefinitions } from './graph.js';
+export { renderMap, renderMinimalSummary } from './renderer.js';
+export { getProjectCache, clearAllCaches, TagCache } from './cache.js';
+/** Options for building a repo map. */
+export interface RepoMapOptions {
+    /** Maximum tokens for the output. Default: 1024. */
+    maxTokens?: number;
+    /** Files to boost to the top of the output. */
+    focusFiles?: string[];
+    /** Additional extensions to include. */
+    extraExtensions?: string[];
+    /** Additional directories to skip. */
+    skipDirs?: string[];
+    /** Whether to show line numbers. Default: true. */
+    showLineNumbers?: boolean;
+    /** Maximum files to scan. Default: 10000. */
+    maxFiles?: number;
+}
+/** Result of building a repo map. */
+export interface RepoMapResult {
+    /** The rendered text map. */
+    text: string;
+    /** Number of source files found. */
+    fileCount: number;
+    /** Number of definitions extracted. */
+    definitionCount: number;
+    /** Number of cross-file edges. */
+    edgeCount: number;
+    /** Number of files that were re-parsed (cache misses). */
+    parsedCount: number;
+    /** Duration in milliseconds. */
+    durationMs: number;
+    /** The dependency graph (for programmatic access). */
+    graph: DependencyGraph;
+}
+/**
+ * Build a structural repo map for a project.
+ *
+ * Pipeline:
+ * 1. Scan directory for source files (filtered by gitignore)
+ * 2. Parse files with tree-sitter (cached by mtime)
+ * 3. Build dependency graph (files → edges → importance ranking)
+ * 4. Render ranked definitions within token budget
+ *
+ * @param projectPath - Absolute path to the project root
+ * @param options - Configuration options
+ * @returns Repo map result with text and metadata
+ */
+export declare function buildRepoMap(projectPath: string, options?: RepoMapOptions): Promise<RepoMapResult>;
+/**
+ * Look up which file defines a given symbol name.
+ * Returns the file path and line number, or null if not found.
+ */
+export declare function findSymbol(graph: DependencyGraph, symbolName: string): {
+    file: string;
+    line: number;
+    type: string;
+} | null;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/repomap/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAI9D,YAAY,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEvE,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,wCAAwC;IACxC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qCAAqC;AACrC,MAAM,WAAW,aAAa;IAC5B,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,KAAK,EAAE,eAAe,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAmDxB;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,MAAM,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASrD"}

package/dist/repomap/index.js

@@ -0,0 +1,99 @@
+/**
+ * Repo Map: structural codebase summary.
+ *
+ * Provides a compact overview of a project's structure — files, definitions,
+ * and cross-file relationships — within a token budget. Designed to give
+ * Claude Code the structural context it needs without reading individual files.
+ *
+ * @example
+ * ```typescript
+ * const map = await buildRepoMap('/path/to/project', { maxTokens: 1024 });
+ * console.log(map.text);       // Compact structural summary
+ * console.log(map.fileCount);  // Number of files scanned
+ * ```
+ *
+ * @packageDocumentation
+ */
+import { scanProject } from './scanner.js';
+import { parseFile } from './parser.js';
+import { buildGraph } from './graph.js';
+import { renderMap } from './renderer.js';
+import { getProjectCache } from './cache.js';
+export { scanProject } from './scanner.js';
+export { parseFile, isSupportedExtension, getLanguageForExtension } from './parser.js';
+export { parseFileRegex, isRegexSupportedExtension } from './regex-parser.js';
+export { buildGraph, getRankedDefinitions } from './graph.js';
+export { renderMap, renderMinimalSummary } from './renderer.js';
+export { getProjectCache, clearAllCaches, TagCache } from './cache.js';
+/**
+ * Build a structural repo map for a project.
+ *
+ * Pipeline:
+ * 1. Scan directory for source files (filtered by gitignore)
+ * 2. Parse files with tree-sitter (cached by mtime)
+ * 3. Build dependency graph (files → edges → importance ranking)
+ * 4. Render ranked definitions within token budget
+ *
+ * @param projectPath - Absolute path to the project root
+ * @param options - Configuration options
+ * @returns Repo map result with text and metadata
+ */
+export async function buildRepoMap(projectPath, options = {}) {
+    const start = performance.now();
+    // 1. Scan
+    const scanOptions = {
+        extraExtensions: options.extraExtensions,
+        skipDirs: options.skipDirs,
+        maxFiles: options.maxFiles,
+    };
+    const files = scanProject(projectPath, scanOptions);
+    // 2. Parse (with caching)
+    const cache = getProjectCache(projectPath);
+    const { cached, stale } = cache.resolve(files);
+    // Parse stale files
+    const tagsByFile = new Map(cached);
+    for (const file of stale) {
+        const tags = await parseFile(file.absolutePath, file.relativePath);
+        tagsByFile.set(file.relativePath, tags);
+        cache.update(file, tags);
+    }
+    // 3. Build graph
+    const graph = buildGraph(tagsByFile);
+    // 4. Render
+    const renderOptions = {
+        maxTokens: options.maxTokens ?? 1024,
+        focusFiles: options.focusFiles,
+        showLineNumbers: options.showLineNumbers,
+    };
+    const text = renderMap(graph, renderOptions);
+    const durationMs = performance.now() - start;
+    // Count definitions
+    let definitionCount = 0;
+    for (const node of graph.nodes.values()) {
+        definitionCount += node.definitions.length;
+    }
+    return {
+        text,
+        fileCount: files.length,
+        definitionCount,
+        edgeCount: graph.edges.length,
+        parsedCount: stale.length,
+        durationMs,
+        graph,
+    };
+}
+/**
+ * Look up which file defines a given symbol name.
+ * Returns the file path and line number, or null if not found.
+ */
+export function findSymbol(graph, symbolName) {
+    for (const node of graph.rankedFiles) {
+        for (const def of node.definitions) {
+            if (def.name === symbolName) {
+                return { file: def.file, line: def.line, type: def.type };
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=index.js.map

package/dist/repomap/index.js.map

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

package/dist/repomap/parser.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Tree-sitter AST parser for extracting definitions and references.
+ *
+ * Uses web-tree-sitter (WASM) to parse source files and extract:
+ * - Definitions: classes, functions, methods, interfaces, type aliases, exports
+ * - References: imports, identifiers used in code
+ *
+ * Supported languages: TypeScript, JavaScript, Python, Java, C, C++,
+ * Rust, Go, Ruby, C#, PHP, Bash (tree-sitter).
+ * Fallback regex parsing: Scala, Kotlin, Swift, Haskell, Lua, Dart,
+ * Zig, Elixir, Perl, R.
+ */
+/** A tag extracted from a source file. */
+export interface Tag {
+    /** The symbol name (e.g., 'MyClass', 'myFunction'). */
+    name: string;
+    /** Whether this is a definition or reference. */
+    kind: 'def' | 'ref';
+    /** Line number (1-based). */
+    line: number;
+    /** The file this tag belongs to (relative path). */
+    file: string;
+    /** Specific type of definition/reference. */
+    type: 'class' | 'function' | 'method' | 'interface' | 'type' | 'enum' | 'variable' | 'export' | 'import' | 'identifier';
+}
+/**
+ * Parse a source file and extract tags (definitions + references).
+ *
+ * @param filePath - Absolute path to the source file
+ * @param relativePath - Relative path for tag metadata
+ * @returns Array of tags extracted from the file
+ */
+export declare function parseFile(filePath: string, relativePath: string): Promise<Tag[]>;
+/**
+ * Get the language name for a file extension.
+ * Checks tree-sitter languages first, then regex-based fallback languages.
+ */
+export declare function getLanguageForExtension(ext: string): string | undefined;
+/**
+ * Check if a file extension is supported (tree-sitter or regex fallback).
+ */
+export declare function isSupportedExtension(ext: string): boolean;
+//# sourceMappingURL=parser.d.ts.map

package/dist/repomap/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/repomap/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,0CAA0C;AAC1C,MAAM,WAAW,GAAG;IAClB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,IAAI,EACA,OAAO,GACP,UAAU,GACV,QAAQ,GACR,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,YAAY,CAAC;CAClB;AA4gBD;;;;;;GAMG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAqStF;AAmSD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEzD"}