@devflow-tools/context-engine 0.14.4 → 0.16.0

package/dist/onboarding-pack-builder.js

@@ -1,5 +1,60 @@
-import { readFileSync, existsSync } from "fs";
-import { join, basename } from "path";
+import CGModule from "@colbymchenry/codegraph";
+import { IndexerAdapter } from "./indexer-adapter.js";
+import { GraphAdapter } from "./graph-adapter.js";
+import { getProjectHash } from "@devflow-tools/sdk";
+import { randomUUID } from "node:crypto";
+import { readFileSync, existsSync, mkdirSync, realpathSync, renameSync, statSync, unlinkSync, writeFileSync, } from "node:fs";
+import { join, basename, resolve } from "node:path";
+const CG = CGModule.default ?? CGModule;
+export class OnboardingPackBuildError extends Error {
+    code;
+    rootPath;
+    constructor(code, message, rootPath, options) {
+        super(message, options);
+        this.code = code;
+        this.rootPath = rootPath;
+        this.name = "OnboardingPackBuildError";
+    }
+}
+const DEFAULT_FILE_OPERATIONS = {
+    mkdirSync,
+    writeFileSync,
+    renameSync,
+    unlinkSync,
+};
+export async function createOnboardingPackDependencies(rootPath) {
+    if (!CG.isInitialized(rootPath)) {
+        throw new OnboardingPackBuildError("CODEGRAPH_NOT_INITIALIZED", `CodeGraph is not initialized at ${rootPath}. Run \`devflow init\` first.`, rootPath);
+    }
+    const codegraph = CG.openSync(rootPath);
+    return {
+        codegraph,
+        indexer: new IndexerAdapter(codegraph, rootPath),
+        graph: new GraphAdapter(codegraph),
+        dispose: () => codegraph.close(),
+    };
+}
+export function canonicalizeOnboardingRoot(rootPath) {
+    if (!rootPath || rootPath.trim().length === 0) {
+        throw new OnboardingPackBuildError("ROOT_PATH_REQUIRED", "rootPath is required");
+    }
+    const absoluteRoot = resolve(rootPath);
+    let canonicalRoot;
+    try {
+        canonicalRoot = realpathSync.native(absoluteRoot);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT" || code === "ENOTDIR") {
+            throw new OnboardingPackBuildError("ROOT_NOT_FOUND", `Project root does not exist: ${absoluteRoot}.`, absoluteRoot, { cause: error });
+        }
+        throw error;
+    }
+    if (!statSync(canonicalRoot).isDirectory()) {
+        throw new OnboardingPackBuildError("ROOT_NOT_DIRECTORY", `Project root is not a directory: ${canonicalRoot}.`, canonicalRoot);
+    }
+    return canonicalRoot;
+}
 const STACK_SIGNATURES = [
     { framework: "React", files: ["react", "react-dom"] },
     { framework: "Next.js", files: ["next"] },
@@ -80,10 +135,35 @@ function resolveProjectName(root) {
     }
     return basename(root);
 }
-export async function buildOnboardingPack(root, cg, indexer, graph) {
+export function writeOnboardingPackAtomically(rootPath, pack, fileOperations = DEFAULT_FILE_OPERATIONS) {
+    const outputDir = join(rootPath, ".devflow");
+    const outputPath = join(outputDir, "onboarding-pack.json");
+    const tempPath = join(outputDir, `.onboarding-pack.json.${process.pid}.${randomUUID()}.tmp`);
+    let cleanupTemp = true;
+    try {
+        fileOperations.mkdirSync(outputDir, { recursive: true });
+        fileOperations.writeFileSync(tempPath, JSON.stringify(pack, null, 2), { encoding: "utf-8", flag: "wx" });
+        fileOperations.renameSync(tempPath, outputPath);
+        cleanupTemp = false;
+    }
+    catch (error) {
+        throw new OnboardingPackBuildError("PERSISTENCE_FAILED", `Failed to persist onboarding pack at ${outputPath}. Check directory write permissions and available disk space.`, rootPath, { cause: error });
+    }
+    finally {
+        if (cleanupTemp) {
+            try {
+                fileOperations.unlinkSync(tempPath);
+            }
+            catch {
+                // The temp file may not have been created.
+            }
+        }
+    }
+}
+async function buildCanonicalOnboardingPack(rootPath, cg, indexer, graph) {
     const stats = cg.getStats();
     const files = cg.getFiles();
-    const stack = detectStack(root, files);
+    const stack = detectStack(rootPath, files);
     const topSymbols = await indexer.getTopSymbols(20);
     const topNodes = await graph.getTopCentralNodes(20);
     const layers = await graph.getLayerSummary();
@@ -126,10 +206,11 @@ export async function buildOnboardingPack(root, cg, indexer, graph) {
             return `${s.name} 依赖关系`;
         return `${s.name} 使用方式`;
     });
-    return {
-        projectName: resolveProjectName(root),
+    const pack = {
+        projectName: resolveProjectName(rootPath),
         createdAt: new Date().toISOString(),
-        root,
+        rootPath,
+        projectHash: getProjectHash(rootPath),
         stats: {
             files: stats.fileCount,
             symbols: stats.nodeCount,
@@ -144,5 +225,41 @@ export async function buildOnboardingPack(root, cg, indexer, graph) {
         recommendedWorkflows: ["scan", "verify", "report"],
         recommendedQueries,
     };
+    writeOnboardingPackAtomically(rootPath, pack);
+    return pack;
+}
+export async function buildOnboardingPack(rootPath, cg, indexer, graph) {
+    const canonicalRoot = canonicalizeOnboardingRoot(rootPath);
+    return buildCanonicalOnboardingPack(canonicalRoot, cg, indexer, graph);
+}
+export class OnboardingPackBuilder {
+    createDependencies;
+    constructor(createDependencies = createOnboardingPackDependencies) {
+        this.createDependencies = createDependencies;
+    }
+    async build(rootPath) {
+        const canonicalRoot = canonicalizeOnboardingRoot(rootPath);
+        let dependencies;
+        let buildError;
+        try {
+            dependencies = await this.createDependencies(canonicalRoot);
+            return await buildCanonicalOnboardingPack(canonicalRoot, dependencies.codegraph, dependencies.indexer, dependencies.graph);
+        }
+        catch (error) {
+            buildError = error;
+            throw error;
+        }
+        finally {
+            if (dependencies?.dispose) {
+                try {
+                    await dependencies.dispose();
+                }
+                catch (disposeError) {
+                    if (buildError === undefined)
+                        throw disposeError;
+                }
+            }
+        }
+    }
 }
 //# sourceMappingURL=onboarding-pack-builder.js.map

package/dist/onboarding-pack-builder.js.map

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

package/dist/retrieval-handlers.d.ts

@@ -0,0 +1,42 @@
+import type { CanonicalGetMemoryResult, GetKnowledgeResult, GetMemoryOptions, GetMemoryResult, GetProjectContextResult, KnowledgeEntry, TaskContextResult } from '@devflow-tools/sdk';
+export interface ProjectContextRetriever {
+    buildTaskContext(query: string, options?: {
+        maxTokens?: number;
+        mode?: 'fast' | 'deep';
+        sessionId?: string;
+    }): Promise<TaskContextResult>;
+}
+export interface MemoryRetriever {
+    getAll(options?: string | GetMemoryOptions): Promise<GetMemoryResult>;
+}
+export interface KnowledgeRetriever {
+    getScopes?(): string[];
+    search(query: string, options?: {
+        sources?: string[];
+        budgetTokens?: number;
+    }): Promise<KnowledgeEntry[]>;
+    searchWithStatus?(query: string, options: {
+        sources?: string[];
+        budgetTokens?: number;
+    }): Promise<{
+        entries: KnowledgeEntry[];
+        warnings: string[];
+        budgetTokens?: number;
+        tokenCount?: number;
+        truncatedCount?: number;
+    }>;
+}
+export interface GetProjectContextArgs {
+    query: string;
+    mode?: 'fast' | 'deep';
+    maxTokens?: number;
+    sessionId?: string;
+}
+export declare function getProjectContextResult(context: ProjectContextRetriever, args: GetProjectContextArgs, freshnessMs: number): Promise<GetProjectContextResult>;
+export declare function getMemoryResult(memory: MemoryRetriever, options: GetMemoryOptions): Promise<CanonicalGetMemoryResult>;
+export declare function getKnowledgeResult(knowledge: KnowledgeRetriever, args: {
+    query: string;
+    scope?: string;
+    budgetTokens?: number;
+}): Promise<GetKnowledgeResult>;
+//# sourceMappingURL=retrieval-handlers.d.ts.map

package/dist/retrieval-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-handlers.d.ts","sourceRoot":"","sources":["../src/retrieval-handlers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAC3E,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,IAAI,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1G,gBAAgB,CAAC,CACf,KAAK,EAAE,MAAM,EACb,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GACrD,OAAO,CAAC;QACT,OAAO,EAAE,cAAc,EAAE,CAAC;QAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,uBAAuB,EAChC,IAAI,EAAE,qBAAqB,EAC3B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,uBAAuB,CAAC,CAyBlC;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,wBAAwB,CAAC,CAenC;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,kBAAkB,EAC7B,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,OAAO,CAAC,kBAAkB,CAAC,CAgC7B"}

package/dist/retrieval-handlers.js

@@ -0,0 +1,74 @@
+export async function getProjectContextResult(context, args, freshnessMs) {
+    const result = await context.buildTaskContext(args.query, {
+        mode: args.mode ?? 'fast',
+        maxTokens: args.maxTokens,
+        sessionId: args.sessionId,
+    });
+    const fallback = Boolean(result._devflow?.fallback);
+    return {
+        ...result,
+        _devflow_unique: {
+            search_method: result.warnings?.length ? 'bm25_semantic' : 'bm25_vector_rrf',
+            task_oriented: true,
+            risk_aware: true,
+            memory_injected: true,
+            knowledge_injected: true,
+            token_estimated: true,
+            required_vs_optional: true,
+        },
+        _accuracy: {
+            data_freshness_ms: freshnessMs,
+            source_layer: 'composite',
+            degradation: fallback ? 'fallback' : 'none',
+        },
+    };
+}
+export async function getMemoryResult(memory, options) {
+    const result = await memory.getAll(options);
+    return {
+        ...result,
+        _devflow_unique: {
+            memory_version: 1,
+            structured_storage: true,
+            project_context_included: true,
+        },
+        _accuracy: {
+            data_freshness_ms: 0,
+            source_layer: 'memory',
+            degradation: 'none',
+        },
+    };
+}
+export async function getKnowledgeResult(knowledge, args) {
+    const scopeName = args.scope?.trim() || 'all';
+    const availableScopes = knowledge.getScopes?.() ?? [];
+    if (scopeName !== 'all' && availableScopes.length > 0 && !availableScopes.includes(scopeName)) {
+        throw new Error(`Unknown knowledge scope ${JSON.stringify(scopeName)}. Available scopes: ${availableScopes.join(', ')}`);
+    }
+    const searchOptions = {
+        sources: scopeName === 'all' ? undefined : [scopeName],
+    };
+    if (args.budgetTokens !== undefined)
+        searchOptions.budgetTokens = args.budgetTokens;
+    const detailed = knowledge.searchWithStatus
+        ? await knowledge.searchWithStatus(args.query, searchOptions)
+        : { entries: await knowledge.search(args.query, searchOptions), warnings: [] };
+    return {
+        results: detailed.entries,
+        warnings: detailed.warnings,
+        budgetTokens: detailed.budgetTokens ?? args.budgetTokens ?? 3000,
+        tokenCount: detailed.tokenCount,
+        truncatedCount: detailed.truncatedCount ?? 0,
+        _devflow_unique: {
+            source_versioned: true,
+            code_examples_included: true,
+            search_scope: scopeName,
+        },
+        _accuracy: {
+            data_freshness_ms: 0,
+            source_layer: 'knowledge',
+            degradation: detailed.warnings.length > 0 ? 'bm25_only' : 'none',
+        },
+    };
+}
+//# sourceMappingURL=retrieval-handlers.js.map

package/dist/retrieval-handlers.js.map

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

package/dist/symbol-embedder.d.ts

@@ -0,0 +1,38 @@
+import type { CodeGraph } from "@colbymchenry/codegraph";
+import type { EmbeddingProvider } from "@devflow-tools/memory-engine";
+import type { SymbolVectorStore } from "./symbol-vector-store.js";
+export interface SymbolEmbeddingStatus {
+    state: "idle" | "building" | "ready" | "failed";
+    vectorCount: number;
+    nodeCount: number;
+    error?: string;
+}
+export declare class SymbolEmbedder {
+    private cg;
+    private embedder;
+    private store;
+    private buildPromise;
+    private mutationTail;
+    private status;
+    constructor(cg: CodeGraph, embedder: EmbeddingProvider, store: SymbolVectorStore);
+    getStatus(): SymbolEmbeddingStatus;
+    buildAllIfNeeded(onProgress?: (progress: {
+        current: number;
+        total: number;
+    }) => void): Promise<void>;
+    buildAll(onProgress?: (progress: {
+        current: number;
+        total: number;
+    }) => void): Promise<void>;
+    updateForFiles(filePaths: string[]): Promise<void>;
+    isBuilt(): boolean;
+    private runBuildIfNeeded;
+    private recoverLoadedProvider;
+    private getAllNodes;
+    private buildAllNodes;
+    private embedNodes;
+    private createEntries;
+    private enqueueMutation;
+    private setStatus;
+}
+//# sourceMappingURL=symbol-embedder.d.ts.map

package/dist/symbol-embedder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-embedder.d.ts","sourceRoot":"","sources":["../src/symbol-embedder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAQ,MAAM,yBAAyB,CAAC;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAKlC,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAUD,qBAAa,cAAc;IAUvB,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,KAAK;IAXf,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,MAAM,CAIZ;gBAGQ,EAAE,EAAE,SAAS,EACb,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,EAAE,iBAAiB;IAGlC,SAAS,IAAI,qBAAqB;IAQlC,gBAAgB,CACd,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAClE,OAAO,CAAC,IAAI,CAAC;IAiCV,QAAQ,CACZ,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,GAClE,OAAO,CAAC,IAAI,CAAC;IAYV,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxD,OAAO,IAAI,OAAO;YAUJ,gBAAgB;YAgBhB,qBAAqB;IASnC,OAAO,CAAC,WAAW;YAQL,aAAa;YAcb,UAAU;YAKV,aAAa;IAe3B,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,SAAS;CAWlB"}

package/dist/symbol-embedder.js

@@ -0,0 +1,174 @@
+const BATCH_SIZE = 32;
+const HEALTHY_COVERAGE = 0.9;
+function buildNodeText(node) {
+    return `${node.name} ${node.kind} ${node.signature ?? ""} ${node.filePath}`;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export class SymbolEmbedder {
+    cg;
+    embedder;
+    store;
+    buildPromise = null;
+    mutationTail = Promise.resolve();
+    status = {
+        state: "idle",
+        vectorCount: 0,
+        nodeCount: 0,
+    };
+    constructor(cg, embedder, store) {
+        this.cg = cg;
+        this.embedder = embedder;
+        this.store = store;
+    }
+    getStatus() {
+        return {
+            ...this.status,
+            vectorCount: this.store.count(),
+            nodeCount: this.cg.getStats().nodeCount,
+        };
+    }
+    buildAllIfNeeded(onProgress) {
+        if (this.buildPromise)
+            return this.buildPromise;
+        if (this.status.state === "ready" && this.isBuilt()) {
+            if (this.embedder.getStatus() === "ready") {
+                return Promise.resolve();
+            }
+            const recovery = this.enqueueMutation(() => this.recoverLoadedProvider())
+                .catch((error) => {
+                this.setStatus("failed", errorMessage(error));
+                throw error;
+            })
+                .finally(() => {
+                this.buildPromise = null;
+            });
+            this.buildPromise = recovery;
+            return recovery;
+        }
+        this.setStatus("building");
+        const build = this.enqueueMutation(async () => {
+            await this.runBuildIfNeeded(onProgress);
+        })
+            .catch((error) => {
+            this.setStatus("failed", errorMessage(error));
+            throw error;
+        })
+            .finally(() => {
+            this.buildPromise = null;
+        });
+        this.buildPromise = build;
+        return build;
+    }
+    async buildAll(onProgress) {
+        await this.enqueueMutation(async () => {
+            const warmed = await this.embedder.warmup();
+            if (!warmed) {
+                throw new Error(this.embedder.getLastError() ?? "Embedding model warmup failed");
+            }
+            await this.buildAllNodes(onProgress);
+        });
+    }
+    async updateForFiles(filePaths) {
+        const changedFiles = [...new Set(filePaths)];
+        if (changedFiles.length === 0)
+            return;
+        await this.enqueueMutation(async () => {
+            this.setStatus("building");
+            this.store.deleteByFiles(changedFiles);
+            try {
+                const warmed = await this.embedder.warmup();
+                if (!warmed) {
+                    throw new Error(this.embedder.getLastError() ?? "Embedding model warmup failed");
+                }
+                for (const filePath of changedFiles) {
+                    const nodes = this.cg.getNodesInFile(filePath);
+                    for (let offset = 0; offset < nodes.length; offset += BATCH_SIZE) {
+                        await this.embedNodes(nodes.slice(offset, offset + BATCH_SIZE));
+                    }
+                }
+                this.setStatus(this.isBuilt() ? "ready" : "idle");
+            }
+            catch (error) {
+                this.setStatus("failed", errorMessage(error));
+                throw error;
+            }
+        });
+    }
+    isBuilt() {
+        const nodeCount = this.cg.getStats().nodeCount;
+        const vectorCount = this.store.count();
+        const sourceCount = this.store.countSources();
+        const requiredCount = nodeCount * HEALTHY_COVERAGE;
+        return vectorCount === sourceCount
+            && vectorCount >= requiredCount
+            && sourceCount >= requiredCount;
+    }
+    async runBuildIfNeeded(onProgress) {
+        const warmed = await this.embedder.warmup();
+        if (!warmed) {
+            throw new Error(this.embedder.getLastError() ?? "Embedding model warmup failed");
+        }
+        if (!this.isBuilt()) {
+            await this.buildAllNodes(onProgress);
+        }
+        this.setStatus("ready");
+    }
+    async recoverLoadedProvider() {
+        const warmed = await this.embedder.warmup();
+        if (!warmed) {
+            throw new Error(this.embedder.getLastError() ?? "Embedding model warmup failed");
+        }
+    }
+    getAllNodes() {
+        const allNodes = [];
+        for (const file of this.cg.getFiles()) {
+            allNodes.push(...this.cg.getNodesInFile(file.path));
+        }
+        return allNodes;
+    }
+    async buildAllNodes(onProgress) {
+        const allNodes = this.getAllNodes();
+        const total = allNodes.length;
+        const entries = [];
+        for (let offset = 0; offset < total; offset += BATCH_SIZE) {
+            const batch = allNodes.slice(offset, offset + BATCH_SIZE);
+            entries.push(...await this.createEntries(batch));
+            onProgress?.({ current: offset + batch.length, total });
+        }
+        this.store.replaceAll(entries);
+    }
+    async embedNodes(nodes) {
+        if (nodes.length === 0)
+            return;
+        this.store.upsertBatch(await this.createEntries(nodes));
+    }
+    async createEntries(nodes) {
+        if (nodes.length === 0)
+            return [];
+        const embeddings = await this.embedder.embedBatch(nodes.map(buildNodeText));
+        if (embeddings.length !== nodes.length) {
+            throw new Error(`Embedding model returned ${embeddings.length} vectors for ${nodes.length} symbols`);
+        }
+        return nodes.map((node, index) => ({
+            id: node.id,
+            filePath: node.filePath,
+            embedding: embeddings[index],
+        }));
+    }
+    enqueueMutation(operation) {
+        const result = this.mutationTail.then(operation, operation);
+        this.mutationTail = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    setStatus(state, error) {
+        this.status = {
+            state,
+            vectorCount: this.store.count(),
+            nodeCount: this.cg.getStats().nodeCount,
+            ...(error ? { error } : {}),
+        };
+    }
+}
+//# sourceMappingURL=symbol-embedder.js.map

package/dist/symbol-embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-embedder.js","sourceRoot":"","sources":["../src/symbol-embedder.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,GAAG,EAAE,CAAC;AACtB,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAS7B,SAAS,aAAa,CAAC,IAAU;IAC/B,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC9E,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,OAAO,cAAc;IAUf;IACA;IACA;IAXF,YAAY,GAAyB,IAAI,CAAC;IAC1C,YAAY,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAChD,MAAM,GAA0B;QACtC,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,CAAC;KACb,CAAC;IAEF,YACU,EAAa,EACb,QAA2B,EAC3B,KAAwB;QAFxB,OAAE,GAAF,EAAE,CAAW;QACb,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,UAAK,GAAL,KAAK,CAAmB;IAC/B,CAAC;IAEJ,SAAS;QACP,OAAO;YACL,GAAG,IAAI,CAAC,MAAM;YACd,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/B,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS;SACxC,CAAC;IACJ,CAAC;IAED,gBAAgB,CACd,UAAmE;QAEnE,IAAI,IAAI,CAAC,YAAY;YAAE,OAAO,IAAI,CAAC,YAAY,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,KAAK,OAAO,EAAE,CAAC;gBAC1C,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YAC3B,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC;iBACtE,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBACxB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YAC3B,CAAC,CAAC,CAAC;YACL,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;YAC7B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YAC5C,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC;aACC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;YAC9C,MAAM,KAAK,CAAC;QACd,CAAC,CAAC;aACD,OAAO,CAAC,GAAG,EAAE;YACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC,CAAC;QACL,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,UAAmE;QAEnE,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,+BAA+B,CAChE,CAAC;YACJ,CAAC;YACD,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAmB;QACtC,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QAC7C,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtC,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,IAAI,EAAE;YACpC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;YAC3B,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;YAEvC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,+BAA+B,CAChE,CAAC;gBACJ,CAAC;gBAED,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;oBACpC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;oBAC/C,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,IAAI,UAAU,EAAE,CAAC;wBACjE,MAAM,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;oBAClE,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9C,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC;QAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACvC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,SAAS,GAAG,gBAAgB,CAAC;QACnD,OAAO,WAAW,KAAK,WAAW;eAC7B,WAAW,IAAI,aAAa;eAC5B,WAAW,IAAI,aAAa,CAAC;IACpC,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,UAAmE;QAEnE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,+BAA+B,CAChE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAEO,KAAK,CAAC,qBAAqB;QACjC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,+BAA+B,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,WAAW;QACjB,MAAM,QAAQ,GAAW,EAAE,CAAC;QAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,UAAmE;QAEnE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC;QAC9B,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,CAAC;YAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;YAC1D,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,UAAU,CAAC,KAAa;QACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,KAAa;QACvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC;QAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,4BAA4B,UAAU,CAAC,MAAM,gBAAgB,KAAK,CAAC,MAAM,UAAU,CACpF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,UAAU,CAAC,KAAK,CAAE;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,eAAe,CAAI,SAA2B;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,SAAS,CACf,KAAqC,EACrC,KAAc;QAEd,IAAI,CAAC,MAAM,GAAG;YACZ,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;YAC/B,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,SAAS;YACvC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/symbol-vector-store.d.ts

@@ -0,0 +1,25 @@
+export interface SymbolVectorEntry {
+    id: string;
+    filePath: string;
+    embedding: Float32Array;
+}
+export declare class SymbolVectorStore {
+    private db;
+    private initialized;
+    constructor(projectRoot: string);
+    initialize(): void;
+    upsert(id: string, filePath: string, embedding: Float32Array): void;
+    upsertBatch(entries: SymbolVectorEntry[]): void;
+    replaceAll(entries: SymbolVectorEntry[]): void;
+    search(embedding: Float32Array, limit: number): Array<{
+        id: string;
+        distance: number;
+    }>;
+    delete(ids: string[]): void;
+    deleteByFiles(filePaths: string[]): void;
+    get(id: string): Buffer | null;
+    count(): number;
+    countSources(): number;
+    close(): void;
+}
+//# sourceMappingURL=symbol-vector-store.d.ts.map

package/dist/symbol-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbol-vector-store.d.ts","sourceRoot":"","sources":["../src/symbol-vector-store.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,YAAY,CAAC;CACzB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAS/B,UAAU,IAAI,IAAI;IAkBlB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,IAAI;IAKnE,WAAW,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAuB/C,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAuB9C,MAAM,CACJ,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAgB1C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI;IAc3B,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAWxC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAO9B,KAAK,IAAI,MAAM;IAOf,YAAY,IAAI,MAAM;IAOtB,KAAK,IAAI,IAAI;CAGd"}