@eduardo-afonso/codebase-intelligence 0.1.0 → 2.0.1

package/dist/explorer/SnapshotBuilder.js

@@ -0,0 +1,225 @@
+import * as path from 'path';
+import { EXPLORER_SCHEMA_VERSION } from './types.js';
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+/** Normalise a path to forward-slash separators (POSIX). */
+function toPosix(p) {
+    return p.split(path.sep).join('/');
+}
+/** Derive the visual node type from a relative POSIX path. */
+function nodeTypeFromPath(relativePath) {
+    const basename = relativePath.split('/').pop() ?? '';
+    if (/\.(test|spec)\.(ts|tsx|js|jsx|mjs|cjs)$/.test(basename))
+        return 'test';
+    return 'file';
+}
+/**
+ * Map the internal DependencyType string (stored in GraphEdge.type) to the
+ * richer ExplorerEdgeType vocabulary.
+ */
+function mapEdgeType(type) {
+    switch (type) {
+        case 'import': return 'import';
+        case 'extends':
+        case 'implements': return 'references';
+        case 'unresolved': return 'unknown';
+        default: return 'dependency';
+    }
+}
+/**
+ * Collect every ancestor directory segment of a POSIX relative path.
+ *
+ * Example: 'src/auth/AuthService.ts' → ['src', 'src/auth']
+ */
+function ancestorDirs(posixRelPath) {
+    const parts = posixRelPath.split('/');
+    parts.pop(); // remove filename
+    const dirs = [];
+    let acc = '';
+    for (const part of parts) {
+        acc = acc ? `${acc}/${part}` : part;
+        dirs.push(acc);
+    }
+    return dirs;
+}
+// ---------------------------------------------------------------------------
+// SnapshotBuilder
+// ---------------------------------------------------------------------------
+/**
+ * Builds an {@link ExplorerSnapshot} from an analysed {@link Codebase}.
+ *
+ * Rules:
+ * - The codebase MUST have been analysed (`analyze()` called) before calling
+ *   `build()`. If not, edges will be empty because the graph will be empty.
+ * - IDs are stable POSIX relative paths (e.g. `src/auth/AuthService.ts`).
+ * - External / unresolved graph nodes (not present in `codebase.files()`)
+ *   are silently skipped — we never invent nodes that the analysis cannot prove.
+ * - The resulting snapshot is fully JSON-serialisable with no circular refs.
+ */
+export class SnapshotBuilder {
+    /**
+     * @param codebase   The analysed codebase instance.
+     * @param rootPath   The absolute path that was passed to `Codebase.load()`.
+     *                   Used as `ExplorerSnapshot.rootPath`.
+     */
+    static build(codebase, rootPath) {
+        const resolvedRoot = path.resolve(rootPath);
+        const files = codebase.files();
+        const graph = codebase.graph();
+        const info = codebase.projectInfo();
+        // Map: POSIX file path → POSIX relative ID
+        // Both the graph (via TypeScriptParser) and fast-glob use forward-slash paths,
+        // so we normalise all keys to POSIX to guarantee consistent lookups on Windows.
+        const absToRel = new Map();
+        for (const f of files) {
+            absToRel.set(toPosix(f.path), toPosix(f.relativePath));
+        }
+        // -----------------------------------------------------------------------
+        // 1. File nodes
+        // -----------------------------------------------------------------------
+        const nodes = [];
+        const dirIds = new Set();
+        for (const f of files) {
+            const relId = toPosix(f.relativePath);
+            const basename = relId.split('/').pop() ?? relId;
+            const type = nodeTypeFromPath(relId);
+            // parentId: the immediate containing directory, or undefined for root files
+            const lastSlash = relId.lastIndexOf('/');
+            const parentId = lastSlash > 0 ? relId.substring(0, lastSlash) : undefined;
+            // Metrics will be computed after edges are resolved
+            const dependencyCount = 0;
+            const dependentCount = 0;
+            nodes.push({
+                id: relId,
+                label: basename,
+                path: relId,
+                type,
+                ...(parentId !== undefined ? { parentId } : {}),
+                metrics: {
+                    dependencyCount,
+                    dependentCount,
+                },
+                metadata: {
+                    sizeBytes: f.size,
+                    language: f.language,
+                },
+            });
+            // Register ancestor directories for step 2
+            for (const dir of ancestorDirs(relId)) {
+                dirIds.add(dir);
+            }
+        }
+        // -----------------------------------------------------------------------
+        // 2. Directory nodes (derived from file paths — never invented)
+        // -----------------------------------------------------------------------
+        for (const dirId of dirIds) {
+            const parts = dirId.split('/');
+            const label = parts[parts.length - 1] ?? dirId;
+            const parentId = parts.length > 1
+                ? parts.slice(0, parts.length - 1).join('/')
+                : undefined;
+            nodes.push({
+                id: dirId,
+                label,
+                path: dirId,
+                type: 'directory',
+                ...(parentId !== undefined ? { parentId } : {}),
+            });
+        }
+        // -----------------------------------------------------------------------
+        // 3. Dependency edges (from DependencyGraph)
+        // -----------------------------------------------------------------------
+        const edges = [];
+        const seenEdges = new Set();
+        for (const rawAbsId of graph.nodes()) {
+            let sourceRel = absToRel.get(rawAbsId);
+            if (!sourceRel && rawAbsId.endsWith('.js')) {
+                sourceRel = absToRel.get(rawAbsId.slice(0, -3) + '.ts');
+            }
+            if (!sourceRel)
+                continue; // external / unresolved — skip
+            const absId = rawAbsId.endsWith('.js') && !absToRel.has(rawAbsId) && absToRel.has(rawAbsId.slice(0, -3) + '.ts')
+                ? rawAbsId.slice(0, -3) + '.ts'
+                : rawAbsId;
+            for (const rawDepAbsId of graph.dependenciesOf(rawAbsId)) {
+                let targetRel = absToRel.get(rawDepAbsId);
+                if (!targetRel && rawDepAbsId.endsWith('.js')) {
+                    targetRel = absToRel.get(rawDepAbsId.slice(0, -3) + '.ts');
+                }
+                if (!targetRel)
+                    continue; // external / unresolved — skip
+                const edgeId = `${sourceRel}→${targetRel}`;
+                if (seenEdges.has(edgeId))
+                    continue;
+                seenEdges.add(edgeId);
+                const graphEdge = graph.getEdge(rawAbsId, rawDepAbsId);
+                edges.push({
+                    id: edgeId,
+                    source: sourceRel,
+                    target: targetRel,
+                    type: mapEdgeType(graphEdge?.type),
+                });
+            }
+        }
+        // -----------------------------------------------------------------------
+        // 4. "contains" edges (directory → direct children)
+        // -----------------------------------------------------------------------
+        for (const node of nodes) {
+            if (!node.parentId)
+                continue;
+            const edgeId = `${node.parentId}→${node.id}`;
+            if (seenEdges.has(edgeId))
+                continue;
+            seenEdges.add(edgeId);
+            edges.push({
+                id: edgeId,
+                source: node.parentId,
+                target: node.id,
+                type: 'contains',
+            });
+        }
+        // -----------------------------------------------------------------------
+        // 4.5. Compute node metrics from resolved edges
+        // -----------------------------------------------------------------------
+        const nodeMap = new Map();
+        for (const node of nodes) {
+            nodeMap.set(node.id, node);
+        }
+        for (const edge of edges) {
+            if (edge.type === 'contains')
+                continue;
+            const sourceNode = nodeMap.get(edge.source);
+            if (sourceNode && sourceNode.metrics) {
+                sourceNode.metrics.dependencyCount = (sourceNode.metrics.dependencyCount || 0) + 1;
+            }
+            const targetNode = nodeMap.get(edge.target);
+            if (targetNode && targetNode.metrics) {
+                targetNode.metrics.dependentCount = (targetNode.metrics.dependentCount || 0) + 1;
+            }
+        }
+        // -----------------------------------------------------------------------
+        // 5. Aggregate metadata
+        // -----------------------------------------------------------------------
+        const fileNodes = nodes.filter((n) => n.type !== 'directory');
+        const dirNodes = nodes.filter((n) => n.type === 'directory');
+        const depEdges = edges.filter((e) => e.type !== 'contains');
+        return {
+            schemaVersion: EXPLORER_SCHEMA_VERSION,
+            rootPath: resolvedRoot,
+            generatedAt: new Date().toISOString(),
+            nodes,
+            edges,
+            metadata: {
+                totalFiles: fileNodes.length,
+                totalDirectories: dirNodes.length,
+                totalEdges: depEdges.length,
+                analyzerVersion: '0.1.0',
+                ...(info?.languages ? { languages: info.languages } : {}),
+                ...(info?.frameworks ? { frameworks: info.frameworks } : {}),
+                ...(info?.packageManager ? { packageManager: info.packageManager } : {}),
+            },
+        };
+    }
+}
+//# sourceMappingURL=SnapshotBuilder.js.map

package/dist/explorer/SnapshotBuilder.js.map

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

package/dist/explorer/types.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Explorer contract — stable, versioned, JSON-serialisable.
+ *
+ * These types describe the normalised representation of an analysed codebase
+ * that the Interactive Map Explorer consumes. They are deliberately decoupled
+ * from the internal analysis types so the Explorer UI has no dependency on
+ * ts-morph, the parser, or any other analysis detail.
+ *
+ * Schema version follows semver (MAJOR.MINOR) — bump MAJOR on breaking changes.
+ */
+export declare const EXPLORER_SCHEMA_VERSION: '1.0';
+export type ExplorerNodeType = 'file' | 'directory' | 'module' | 'package' | 'test' | 'unknown';
+export interface ExplorerNodeMetrics {
+    /** Lines-of-code, if available */
+    linesOfCode?: number;
+    /** Number of direct dependencies (outgoing edges) */
+    dependencyCount?: number;
+    /** Number of direct dependents (incoming edges) */
+    dependentCount?: number;
+}
+export interface ExplorerNode {
+    /** Stable identifier — normalised relative path (POSIX separators) */
+    id: string;
+    /** Display name — typically the basename */
+    label: string;
+    /** Normalised relative path from the codebase root (POSIX separators) */
+    path: string;
+    /** Node category */
+    type: ExplorerNodeType;
+    /** ID of the containing directory node, absent for the root */
+    parentId?: string;
+    /** Detected package name from package.json, when available */
+    packageName?: string;
+    /** Architectural layer label, e.g. "ui", "domain", "infra" */
+    layer?: string;
+    /** Optional metrics gathered during analysis */
+    metrics?: ExplorerNodeMetrics;
+    /** Arbitrary extra metadata — must be JSON-serialisable */
+    metadata?: Record<string, unknown>;
+}
+export type ExplorerEdgeType = 'import' | 'export' | 'dependency' | 'contains' | 'references' | 'test' | 'unknown';
+export interface ExplorerEdge {
+    /** Stable identifier — `"${source}→${target}"` */
+    id: string;
+    /** ID of the source node (the file that declares the import) */
+    source: string;
+    /** ID of the target node (the file being imported) */
+    target: string;
+    /** Relationship kind */
+    type: ExplorerEdgeType;
+    /** Optional weight, e.g. import frequency */
+    weight?: number;
+    /** Arbitrary extra metadata — must be JSON-serialisable */
+    metadata?: Record<string, unknown>;
+}
+export interface ExplorerSnapshotMetadata {
+    totalFiles: number;
+    totalDirectories: number;
+    totalEdges: number;
+    /** Version string of the codebase-intelligence package that produced this */
+    analyzerVersion?: string;
+    /** Languages detected in the analysed project */
+    languages?: string[];
+    /** Frameworks detected in the analysed project */
+    frameworks?: string[];
+    /** Package manager detected in the analysed project */
+    packageManager?: string;
+}
+/**
+ * The full, self-contained snapshot of an analysed codebase.
+ * This is the only value the Explorer UI depends on — it can be loaded from
+ * disk or produced in-memory by the SnapshotBuilder.
+ */
+export interface ExplorerSnapshot {
+    /** Schema version for forward/backward compatibility checks */
+    schemaVersion: typeof EXPLORER_SCHEMA_VERSION;
+    /** Absolute path of the analysed codebase root */
+    rootPath: string;
+    /** ISO-8601 timestamp of when the snapshot was generated */
+    generatedAt: string;
+    /** All nodes (files + directories) */
+    nodes: ExplorerNode[];
+    /** All directed edges (imports / dependencies / contains) */
+    edges: ExplorerEdge[];
+    /** Aggregate metadata about the snapshot */
+    metadata: ExplorerSnapshotMetadata;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/explorer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/explorer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,eAAO,MAAM,uBAAuB,EAAG,KAAc,CAAC;AAMtD,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,WAAW,GACX,QAAQ,GACR,SAAS,GACT,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,IAAI,EAAE,gBAAgB,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,UAAU,GACV,YAAY,GACZ,MAAM,GACN,SAAS,CAAC;AAEd,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,IAAI,EAAE,gBAAgB,CAAC;IACvB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+DAA+D;IAC/D,aAAa,EAAE,OAAO,uBAAuB,CAAC;IAC9C,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,6DAA6D;IAC7D,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,EAAE,wBAAwB,CAAC;CACpC"}

package/dist/explorer/types.js

@@ -0,0 +1,12 @@
+/**
+ * Explorer contract — stable, versioned, JSON-serialisable.
+ *
+ * These types describe the normalised representation of an analysed codebase
+ * that the Interactive Map Explorer consumes. They are deliberately decoupled
+ * from the internal analysis types so the Explorer UI has no dependency on
+ * ts-morph, the parser, or any other analysis detail.
+ *
+ * Schema version follows semver (MAJOR.MINOR) — bump MAJOR on breaking changes.
+ */
+export const EXPLORER_SCHEMA_VERSION = '1.0';
+//# sourceMappingURL=types.js.map

package/dist/explorer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/explorer/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAc,CAAC"}

package/dist/explorer/ui/App.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const App: React.FC;
+//# sourceMappingURL=App.d.ts.map

package/dist/explorer/ui/App.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"App.d.ts","sourceRoot":"","sources":["../../../src/explorer/ui/App.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AA0BpE,eAAO,MAAM,GAAG,EAAE,KAAK,CAAC,EA8EvB,CAAC"}

package/dist/explorer/ui/App.js

@@ -0,0 +1,43 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import React, { useEffect, useState, useMemo, useRef } from 'react';
+import ForceGraph2D, { ForceGraphMethods } from 'react-force-graph-2d';
+export const App = () => {
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const [hoverNode, setHoverNode] = useState(null);
+    const fgRef = useRef();
+    useEffect(() => {
+        fetch('/api/snapshot')
+            .then((res) => {
+            if (!res.ok)
+                throw new Error('Failed to fetch snapshot');
+            return res.json();
+        })
+            .then((json) => setData(json))
+            .catch((err) => setError(err.message));
+    }, []);
+    const graphData = useMemo(() => {
+        if (!data)
+            return { nodes: [], links: [] };
+        // We only map files for the node graph for now (ignore directories to keep it clean)
+        // "contains" edges can clutter the view, so we filter them out.
+        const fileNodes = data.nodes.filter(n => n.type === 'file' || n.type === 'test');
+        const validNodeIds = new Set(fileNodes.map(n => n.id));
+        const dependencyEdges = data.edges.filter(e => e.type !== 'contains' && validNodeIds.has(e.source) && validNodeIds.has(e.target));
+        return {
+            nodes: fileNodes.map(n => ({ ...n })),
+            links: dependencyEdges.map(e => ({ ...e }))
+        };
+    }, [data]);
+    if (error) {
+        return _jsx("div", { className: "loader-container", children: _jsxs("p", { style: { color: '#f44336' }, children: ["Error: ", error] }) });
+    }
+    if (!data) {
+        return (_jsxs("div", { className: "loader-container", children: [_jsx("div", { className: "spinner" }), _jsx("p", { children: "Analyzing codebase..." })] }));
+    }
+    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: "overlay", children: [_jsx("h1", { children: "Codebase Intelligence" }), _jsxs("div", { className: "stat-row", children: [_jsx("span", { children: "Files" }), _jsx("span", { children: data.metadata.totalFiles })] }), _jsxs("div", { className: "stat-row", children: [_jsx("span", { children: "Dependencies" }), _jsx("span", { children: data.metadata.totalEdges })] })] }), _jsx(ForceGraph2D, { ref: fgRef, graphData: graphData, nodeLabel: "label", nodeColor: (node) => node.type === 'test' ? '#4CAF50' : '#61dafb', nodeRelSize: 6, nodeVal: (node) => {
+                    // Bigger nodes for files with many dependencies
+                    return 1 + Math.log10(1 + (node.metrics?.dependentCount || 0) + (node.metrics?.dependencyCount || 0));
+                }, linkColor: () => 'rgba(255, 255, 255, 0.2)', linkDirectionalArrowLength: 3.5, linkDirectionalArrowRelPos: 1, onNodeHover: (node) => setHoverNode(node || null) })] }));
+};
+//# sourceMappingURL=App.js.map

package/dist/explorer/ui/App.js.map

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

package/dist/explorer/ui/main.d.ts

@@ -0,0 +1,2 @@
+import './index.css';
+//# sourceMappingURL=main.d.ts.map

package/dist/explorer/ui/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/explorer/ui/main.tsx"],"names":[],"mappings":"AAGA,OAAO,aAAa,CAAC"}

package/dist/explorer/ui/main.js

@@ -0,0 +1,8 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+import './index.css';
+const root = createRoot(document.getElementById('root'));
+root.render(_jsx(React.StrictMode, { children: _jsx(App, {}) }));
+//# sourceMappingURL=main.js.map

package/dist/explorer/ui/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../../src/explorer/ui/main.tsx"],"names":[],"mappings":";AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,aAAa,CAAC;AAErB,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,cAAc,CAAC,MAAM,CAAE,CAAC,CAAC;AAC1D,IAAI,CAAC,MAAM,CACT,KAAC,KAAK,CAAC,UAAU,cACf,KAAC,GAAG,KAAG,GACU,CACpB,CAAC"}

package/dist/index.d.ts

@@ -5,4 +5,21 @@ export type { ProjectInfo } from './discovery/ProjectDetector.js';
 export type { SymbolQuery } from './index/SymbolIndex.js';
 export type { SearchResult, SearchOptions, SearchMode } from './search/CodeSearch.js';
 export { CACHE_DIR_NAME } from './core/AnalysisCache.js';
+export type { ContextNode, ContextNodeKind, ContextStrategy, ContextOptions, LLMContextPayload, ContextPayloadMetadata, } from './context/types.js';
+export type { IContextEngine, AIProvider, EmbeddingProvider, VectorStore, VectorSearchResult, } from './context/interfaces.js';
+export { ContextEngine } from './context/ContextEngine.js';
+export { ShallowStrategy, SignatureStrategy, DeepStrategy } from './context/strategies/index.js';
+export type { ContextBuildStrategy } from './context/strategies/index.js';
+export { SignatureExtractor } from './context/SignatureExtractor.js';
+export { NoopAIProvider } from './ai/providers/NoopAIProvider.js';
+export { CodebaseWithAI } from './ai/CodebaseWithAI.js';
+export type { ExplainOptions, AskOptions } from './ai/CodebaseWithAI.js';
+export { SemanticChunker } from './context/SemanticChunker.js';
+export type { SemanticChunk, ChunkerOptions } from './context/SemanticChunker.js';
+export { RAGPipeline } from './ai/RAGPipeline.js';
+export type { RAGPipelineOptions } from './ai/RAGPipeline.js';
+export type { FileChange, ChangeStatus, ChangeSetOptions, ChangeSetProvider, UnanalyzableReason, ChangeSetImpact, } from './diff/types.js';
+export { GitNotAvailableError, NotAGitRepositoryError, InvalidGitRefError, GitCommandError, } from './diff/errors.js';
+export { GitChangeSetProvider } from './diff/GitChangeSetProvider.js';
+export { ChangeSetImpactAnalyzer } from './diff/ChangeSetImpactAnalyzer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,YAAY,EACV,YAAY,EACZ,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,UAAU,EACX,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,YAAY,EACV,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AACjG,YAAY,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGlF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAG9D,YAAY,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,4 +1,20 @@
 // Public API — only expose what consumers need
 export { Codebase } from './core/Codebase.js';
 export { CACHE_DIR_NAME } from './core/AnalysisCache.js';
+// Context Engine — CE-2: Implementation
+export { ContextEngine } from './context/ContextEngine.js';
+// Context Engine — CE-3: Strategy classes & SignatureExtractor
+export { ShallowStrategy, SignatureStrategy, DeepStrategy } from './context/strategies/index.js';
+export { SignatureExtractor } from './context/SignatureExtractor.js';
+// Context Engine — CE-4: AI Provider Interface
+export { NoopAIProvider } from './ai/providers/NoopAIProvider.js';
+export { CodebaseWithAI } from './ai/CodebaseWithAI.js';
+// Context Engine — CE-5: Semantic Chunker
+export { SemanticChunker } from './context/SemanticChunker.js';
+// Context Engine — CE-6: EmbeddingProvider + VectorStore Abstractions
+export { RAGPipeline } from './ai/RAGPipeline.js';
+export { GitNotAvailableError, NotAGitRepositoryError, InvalidGitRefError, GitCommandError, } from './diff/errors.js';
+// Diff Impact — DI-2 & DI-3: Provider & Analyzer
+export { GitChangeSetProvider } from './diff/GitChangeSetProvider.js';
+export { ChangeSetImpactAnalyzer } from './diff/ChangeSetImpactAnalyzer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAc9C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAc9C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkBzD,wCAAwC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,+DAA+D;AAC/D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAEjG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE,+CAA+C;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,sEAAsE;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYlD,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,iDAAiD;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/ui/assets/index-D4w3JVrv.css

@@ -0,0 +1 @@
+body,html,#root{color:#fff;background-color:#0f111a;width:100vw;height:100vh;margin:0;padding:0;font-family:system-ui,-apple-system,sans-serif;overflow:hidden}.loader-container{flex-direction:column;justify-content:center;align-items:center;gap:16px;width:100vw;height:100vh;display:flex}.spinner{border:4px solid #ffffff1a;border-left-color:#61dafb;border-radius:50%;width:40px;height:40px;animation:1s linear infinite spin}@keyframes spin{to{transform:rotate(360deg)}}.overlay{-webkit-backdrop-filter:blur(8px);backdrop-filter:blur(8px);pointer-events:none;z-index:10;background:#0f111acc;border:1px solid #ffffff1a;border-radius:8px;min-width:200px;padding:16px;position:absolute;top:16px;left:16px;box-shadow:0 4px 20px #00000080}.overlay h1{color:#fff;letter-spacing:.5px;margin:0 0 12px;font-size:16px;font-weight:600}.stat-row{color:#aaa;justify-content:space-between;margin-bottom:8px;font-size:13px;display:flex}.stat-row span:last-child{color:#61dafb;font-weight:700}