indexer-cli 0.2.1

package/dist/cli/commands/ensure-indexed.js

@@ -0,0 +1,168 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureIndexed = ensureIndexed;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_path_2 = require("node:path");
+const config_js_1 = require("../../core/config.js");
+const types_js_1 = require("../../core/types.js");
+const ollama_js_1 = require("../../embedding/ollama.js");
+const git_js_1 = require("../../engine/git.js");
+const git_js_2 = require("../../engine/git.js");
+const indexer_js_1 = require("../../engine/indexer.js");
+const hash_js_1 = require("../../utils/hash.js");
+const vectors_js_1 = require("../../storage/vectors.js");
+// Extensions that the indexer actually processes (from language plugins).
+// Non-code files in workspace changes are irrelevant for re-index decisions.
+const INDEXED_EXTENSIONS = new Set([
+    ".ts", ".tsx", ".mts", ".cts",
+    ".js", ".jsx", ".mjs", ".cjs",
+    ".py", ".pyi",
+    ".cs",
+    ".gd",
+    ".rb",
+]);
+/**
+ * Returns true if every workspace-modified/added file in workspaceChanges
+ * is already captured in `snapshot` with the same sha256 as on disk.
+ * This prevents repeated reindexing of persistent uncommitted changes.
+ */
+async function workspaceAlreadyIndexed(metadata, repoRoot, snapshot, workspaceChanges) {
+    // Deleted files can't be verified as "already indexed"
+    if (workspaceChanges.deleted.length > 0)
+        return false;
+    const filesToCheck = [
+        ...workspaceChanges.modified,
+        ...workspaceChanges.added,
+    ];
+    if (filesToCheck.length === 0)
+        return true;
+    for (const filePath of filesToCheck) {
+        if (!INDEXED_EXTENSIONS.has((0, node_path_2.extname)(filePath).toLowerCase())) {
+            continue; // Non-code file — not indexed, irrelevant for re-index decision
+        }
+        const record = await metadata.getFile(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, filePath);
+        if (!record)
+            return false; // Code file not in snapshot
+        let content;
+        try {
+            content = await (0, promises_1.readFile)(node_path_1.default.join(repoRoot, filePath), "utf8");
+        }
+        catch {
+            return false; // Unreadable
+        }
+        if ((0, hash_js_1.computeHash)(content) !== record.sha256)
+            return false;
+    }
+    return true;
+}
+async function getIndexPlan(git, repoRoot, metadata, snapshot) {
+    if (!snapshot) {
+        return { isFullReindex: true, changedFiles: undefined };
+    }
+    if (!snapshot.meta.headCommit) {
+        return { isFullReindex: true, changedFiles: undefined };
+    }
+    const headCommit = await git.getHeadCommit(repoRoot);
+    const workspaceChanges = await git.getWorkingTreeChanges(repoRoot);
+    const committedChanges = headCommit && headCommit !== snapshot.meta.headCommit
+        ? await git.getChangedFiles(repoRoot, snapshot.meta.headCommit)
+        : { added: [], modified: [], deleted: [] };
+    const changedFiles = (0, git_js_2.mergeGitDiffs)(committedChanges, workspaceChanges);
+    const hasChanges = changedFiles.added.length > 0 ||
+        changedFiles.modified.length > 0 ||
+        changedFiles.deleted.length > 0;
+    if (!hasChanges)
+        return null;
+    // Optimisation: if the only "changes" are workspace changes that were
+    // already indexed in the latest snapshot (same sha256 on disk), skip.
+    const noCommittedChanges = committedChanges.added.length === 0 &&
+        committedChanges.modified.length === 0 &&
+        committedChanges.deleted.length === 0;
+    if (noCommittedChanges) {
+        const alreadyIndexed = await workspaceAlreadyIndexed(metadata, repoRoot, snapshot, workspaceChanges);
+        if (alreadyIndexed)
+            return null;
+    }
+    return { isFullReindex: false, changedFiles };
+}
+async function ensureIndexed(metadata, repoRoot, options) {
+    const silent = options?.silent ?? false;
+    const git = new git_js_1.SimpleGitOperations();
+    const snapshot = (await metadata.getLatestCompletedSnapshot(types_js_1.DEFAULT_PROJECT_ID)) ??
+        undefined;
+    const indexPlan = await getIndexPlan(git, repoRoot, metadata, snapshot);
+    if (!indexPlan) {
+        return;
+    }
+    const dataDir = node_path_1.default.join(repoRoot, ".indexer-cli");
+    const vectorsPath = node_path_1.default.join(dataDir, "vectors");
+    const vectors = new vectors_js_1.LanceDbVectorStore({
+        dbPath: vectorsPath,
+        vectorSize: config_js_1.config.get("vectorSize"),
+    });
+    const startedAt = Date.now();
+    const embedder = new ollama_js_1.OllamaEmbeddingProvider(config_js_1.config.get("ollamaBaseUrl"), config_js_1.config.get("embeddingModel"), config_js_1.config.get("indexBatchSize"), config_js_1.config.get("indexConcurrency"), config_js_1.config.get("ollamaNumCtx"));
+    let engine = null;
+    try {
+        await vectors.initialize();
+        await embedder.initialize();
+        engine = new indexer_js_1.IndexerEngine({
+            projectId: types_js_1.DEFAULT_PROJECT_ID,
+            repoRoot,
+            metadata,
+            vectors,
+            embedder,
+            git,
+            languagePlugins: (0, indexer_js_1.createDefaultLanguagePlugins)(),
+        });
+        const headCommit = await git.getHeadCommit(repoRoot);
+        // metadata is already initialized by the caller — skip engine.initialize()
+        // to avoid redundant schema/migration checks.
+        const mode = indexPlan.isFullReindex ? "full" : "incremental";
+        if (!silent) {
+            console.log(`Indexing (${mode})...`);
+        }
+        const result = await engine.indexProject({
+            projectId: types_js_1.DEFAULT_PROJECT_ID,
+            repoRoot,
+            gitRef: headCommit ?? "unknown",
+            isFullReindex: indexPlan.isFullReindex,
+            changedFiles: indexPlan.changedFiles,
+            onProgress: silent
+                ? undefined
+                : (processed, total) => {
+                    console.log(`  ${processed}/${total} files...`);
+                },
+        });
+        const elapsedMs = Date.now() - startedAt;
+        const chunkCount = await vectors.countVectors({
+            projectId: types_js_1.DEFAULT_PROJECT_ID,
+            snapshotId: result.snapshotId,
+        });
+        if (!silent) {
+            console.log("Index updated.");
+            console.log(`  Snapshot: ${result.snapshotId}`);
+            console.log(`  Files indexed: ${result.filesIndexed}`);
+            console.log(`  Chunks created: ${chunkCount}`);
+            console.log(`  Time elapsed: ${(elapsedMs / 1000).toFixed(2)}s`);
+        }
+        if (!silent && result.errors.length > 0) {
+            for (const error of result.errors) {
+                console.error(`  Error: ${error}`);
+            }
+        }
+    }
+    catch (indexError) {
+        const message = indexError instanceof Error ? indexError.message : String(indexError);
+        throw new Error(`Auto-indexing failed: ${message}`);
+    }
+    finally {
+        // metadata is borrowed from caller — do NOT close it here
+        await Promise.allSettled([vectors.close(), embedder.close()]);
+    }
+}
+//# sourceMappingURL=ensure-indexed.js.map

package/dist/cli/commands/ensure-indexed.js.map

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

package/dist/cli/commands/explain.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerExplainCommand(program: Command): void;

package/dist/cli/commands/explain.js

@@ -0,0 +1,165 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerExplainCommand = registerExplainCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const config_js_1 = require("../../core/config.js");
+const logger_js_1 = require("../../core/logger.js");
+const types_js_1 = require("../../core/types.js");
+const sqlite_js_1 = require("../../storage/sqlite.js");
+const help_text_js_1 = require("../help-text.js");
+const ensure_indexed_js_1 = require("./ensure-indexed.js");
+function registerExplainCommand(program) {
+    program
+        .command("explain <symbol>")
+        .description("Show context for a symbol: signature, callers, and module")
+        .addHelpText("after", `\n${help_text_js_1.PROJECT_ROOT_COMMAND_HELP}\n`)
+        .option("--json", "output as JSON")
+        .action(async (symbolArg, options) => {
+        const resolvedProjectPath = process.cwd();
+        const dataDir = node_path_1.default.join(resolvedProjectPath, ".indexer-cli");
+        const dbPath = node_path_1.default.join(dataDir, "db.sqlite");
+        const isJson = Boolean(options?.json);
+        const rankSymbolMatch = (candidateName, query) => {
+            if (candidateName === query) {
+                return 0;
+            }
+            const candidateNameLower = candidateName.toLowerCase();
+            const queryLower = query.toLowerCase();
+            if (candidateNameLower === queryLower) {
+                return 1;
+            }
+            if (candidateNameLower.startsWith(queryLower)) {
+                return 2;
+            }
+            return 3;
+        };
+        (0, logger_js_1.initLogger)(dataDir);
+        config_js_1.config.load(dataDir);
+        const metadata = new sqlite_js_1.SqliteMetadataStore(dbPath);
+        try {
+            await metadata.initialize();
+            await (0, ensure_indexed_js_1.ensureIndexed)(metadata, resolvedProjectPath, { silent: isJson });
+            const snapshot = await metadata.getLatestCompletedSnapshot(types_js_1.DEFAULT_PROJECT_ID);
+            if (!snapshot) {
+                throw new Error("No completed snapshot found.");
+            }
+            // Parse "file::symbol" or just "symbol"
+            let symbolName;
+            let filterFilePath;
+            if (symbolArg.includes("::")) {
+                const parts = symbolArg.split("::");
+                filterFilePath = parts[0];
+                symbolName = parts[1] ?? symbolArg;
+            }
+            else {
+                symbolName = symbolArg;
+            }
+            // Search symbols by name
+            let symbols = await metadata.searchSymbols(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, symbolName);
+            if (symbols.length === 0) {
+                const camelCaseParts = symbolName
+                    .replace(/([a-z])([A-Z])/g, "$1 $2")
+                    .split(/\s+/)
+                    .filter(Boolean);
+                const fallbackQuery = camelCaseParts[0];
+                if (fallbackQuery && fallbackQuery !== symbolName) {
+                    symbols = await metadata.searchSymbols(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, fallbackQuery);
+                }
+            }
+            const matches = filterFilePath
+                ? symbols.filter((s) => s.filePath === filterFilePath)
+                : [...symbols].sort((a, b) => {
+                    const rankDiff = rankSymbolMatch(a.name, symbolName) -
+                        rankSymbolMatch(b.name, symbolName);
+                    if (rankDiff !== 0) {
+                        return rankDiff;
+                    }
+                    return a.name.localeCompare(b.name);
+                });
+            if (matches.length === 0) {
+                const fuzzy = symbols.slice(0, 5).map((s) => ({
+                    name: s.name,
+                    kind: s.kind,
+                    filePath: s.filePath,
+                }));
+                if (isJson) {
+                    console.log(JSON.stringify({ error: "Symbol not found", suggestions: fuzzy }));
+                }
+                else {
+                    console.error(`Symbol "${symbolName}" not found.`);
+                    if (fuzzy.length > 0) {
+                        console.error(`Did you mean: ${fuzzy.map((s) => `${s.name} (${s.kind}) in ${s.filePath}`).join(", ")}?`);
+                    }
+                }
+                process.exitCode = 1;
+                return;
+            }
+            const results = await Promise.all(matches.map(async (sym) => {
+                const [deps, dependents] = await Promise.all([
+                    metadata.listDependencies(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, sym.filePath),
+                    metadata.getDependents(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, sym.filePath),
+                ]);
+                return {
+                    name: sym.name,
+                    kind: sym.kind,
+                    file: sym.filePath,
+                    lines: {
+                        start: sym.range.start.line,
+                        end: sym.range.end.line,
+                    },
+                    exported: sym.exported,
+                    signature: sym.signature,
+                    docComment: sym.docComment ?? null,
+                    callers: dependents
+                        .map((d) => d.fromPath)
+                        .filter((v, i, arr) => arr.indexOf(v) === i),
+                    callees: deps
+                        .filter((d) => d.dependencyType === "internal" && d.toPath)
+                        .map((d) => d.toPath)
+                        .filter((v, i, arr) => arr.indexOf(v) === i),
+                };
+            }));
+            if (isJson) {
+                console.log(JSON.stringify(results.length === 1 ? results[0] : results, null, 2));
+                return;
+            }
+            for (const result of results) {
+                console.log(`Symbol: ${result.name}`);
+                console.log(`File:   ${result.file} (lines ${result.lines.start}-${result.lines.end})`);
+                console.log(`Kind:   ${result.kind}${result.exported ? " (exported)" : ""}`);
+                if (result.signature) {
+                    console.log(`Signature: ${result.signature}`);
+                }
+                if (result.docComment) {
+                    console.log(`Docs:   ${result.docComment.split("\n")[0]}`);
+                }
+                if (result.callers.length > 0) {
+                    console.log(`\nCallers (${result.callers.length}):`);
+                    for (const caller of result.callers) {
+                        console.log(`  ${caller}`);
+                    }
+                }
+                if (result.callees.length > 0) {
+                    console.log(`\nCallees (${result.callees.length}):`);
+                    for (const callee of result.callees) {
+                        console.log(`  ${callee}`);
+                    }
+                }
+                if (results.length > 1)
+                    console.log("");
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`Explain failed: ${message}`);
+            process.exitCode = 1;
+        }
+        finally {
+            await metadata.close().catch(() => undefined);
+        }
+    });
+}
+//# sourceMappingURL=explain.js.map

package/dist/cli/commands/explain.js.map

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

package/dist/cli/commands/index.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerIndexCommand(program: Command): void;

package/dist/cli/commands/index.js

@@ -0,0 +1,271 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerIndexCommand = registerIndexCommand;
+const node_path_1 = __importDefault(require("node:path"));
+const config_js_1 = require("../../core/config.js");
+const types_js_1 = require("../../core/types.js");
+const logger_js_1 = require("../../core/logger.js");
+const ollama_js_1 = require("../../embedding/ollama.js");
+const git_js_1 = require("../../engine/git.js");
+const indexer_js_1 = require("../../engine/indexer.js");
+const scanner_js_1 = require("../../engine/scanner.js");
+const sqlite_js_1 = require("../../storage/sqlite.js");
+const vectors_js_1 = require("../../storage/vectors.js");
+const help_text_js_1 = require("../help-text.js");
+function countChangedFiles(diff) {
+    return diff.added.length + diff.modified.length + diff.deleted.length;
+}
+function buildFileTree(filePaths) {
+    const root = { dirs: new Map(), files: new Set() };
+    for (const filePath of filePaths) {
+        const parts = filePath.split("/");
+        let node = root;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const dir = parts[i];
+            let child = node.dirs.get(dir);
+            if (!child) {
+                child = { dirs: new Map(), files: new Set() };
+                node.dirs.set(dir, child);
+            }
+            node = child;
+        }
+        node.files.add(parts[parts.length - 1]);
+    }
+    return root;
+}
+function printFileTree(node, indent) {
+    const dirs = Array.from(node.dirs.entries()).sort((a, b) => a[0].localeCompare(b[0]));
+    const files = Array.from(node.files).sort((a, b) => a.localeCompare(b));
+    for (const [name, child] of dirs) {
+        console.log(`${indent}${name}/`);
+        printFileTree(child, `${indent}  `);
+    }
+    for (const name of files) {
+        console.log(`${indent}${name}`);
+    }
+}
+function registerIndexCommand(program) {
+    program
+        .command("index")
+        .description("Index project files for semantic search")
+        .addHelpText("after", `\n${help_text_js_1.PROJECT_ROOT_COMMAND_HELP}\n`)
+        .option("--full", "force a full reindex")
+        .option("--dry-run", "show what would change without indexing")
+        .option("--status", "show indexing status for the current project")
+        .option("--tree", "show indexed file tree (use with --status)")
+        .option("--json", "output status as JSON (use with --status)")
+        .action(async (options) => {
+        const resolvedProjectPath = process.cwd();
+        const dataDir = node_path_1.default.join(resolvedProjectPath, ".indexer-cli");
+        const dbPath = node_path_1.default.join(dataDir, "db.sqlite");
+        const vectorsPath = node_path_1.default.join(dataDir, "vectors");
+        (0, logger_js_1.initLogger)(dataDir);
+        config_js_1.config.load(dataDir);
+        const metadata = new sqlite_js_1.SqliteMetadataStore(dbPath);
+        try {
+            await metadata.initialize();
+            if (options?.status) {
+                const snapshot = await metadata.getLatestCompletedSnapshot(types_js_1.DEFAULT_PROJECT_ID);
+                if (!snapshot) {
+                    if (options?.json) {
+                        console.log(JSON.stringify({ indexed: false }, null, 2));
+                    }
+                    else {
+                        console.log("No completed snapshot found. Run `indexer-cli index` first.");
+                    }
+                    return;
+                }
+                const [files, symbols, dependencies] = await Promise.all([
+                    metadata.listFiles(types_js_1.DEFAULT_PROJECT_ID, snapshot.id, {}),
+                    metadata.listSymbols(types_js_1.DEFAULT_PROJECT_ID, snapshot.id),
+                    metadata.listDependencies(types_js_1.DEFAULT_PROJECT_ID, snapshot.id),
+                ]);
+                const vectors = new vectors_js_1.LanceDbVectorStore({
+                    dbPath: vectorsPath,
+                    vectorSize: config_js_1.config.get("vectorSize"),
+                });
+                let vectorCount = 0;
+                try {
+                    await vectors.initialize();
+                    vectorCount = await vectors.countVectors({
+                        projectId: types_js_1.DEFAULT_PROJECT_ID,
+                        snapshotId: snapshot.id,
+                    });
+                }
+                finally {
+                    await vectors.close().catch(() => undefined);
+                }
+                const languages = new Map();
+                for (const file of files) {
+                    const lang = file.languageId || "unknown";
+                    languages.set(lang, (languages.get(lang) ?? 0) + 1);
+                }
+                const symbolKinds = new Map();
+                for (const symbol of symbols) {
+                    symbolKinds.set(symbol.kind, (symbolKinds.get(symbol.kind) ?? 0) + 1);
+                }
+                if (options?.json) {
+                    const output = {
+                        indexed: true,
+                        snapshot: {
+                            id: snapshot.id,
+                            status: snapshot.status,
+                            createdAt: snapshot.createdAt,
+                            gitRef: snapshot.meta.headCommit ?? null,
+                        },
+                        stats: {
+                            files: files.length,
+                            symbols: symbols.length,
+                            chunks: vectorCount,
+                            dependencies: dependencies.length,
+                        },
+                        languages: Object.fromEntries(languages),
+                        symbolKinds: Object.fromEntries(symbolKinds),
+                    };
+                    if (options?.tree) {
+                        output.files = files.map((f) => f.path);
+                    }
+                    console.log(JSON.stringify(output, null, 2));
+                    return;
+                }
+                console.log(`Snapshot: ${snapshot.id} (${snapshot.status})`);
+                console.log(`Created: ${snapshot.createdAt}  |  Git ref: ${snapshot.meta.headCommit ?? "unknown"}`);
+                console.log(`Files: ${files.length}  |  Symbols: ${symbols.length}  |  Chunks: ${vectorCount}  |  Dependencies: ${dependencies.length}`);
+                if (languages.size > 0) {
+                    const langEntries = Array.from(languages.entries())
+                        .sort((a, b) => b[1] - a[1])
+                        .map(([lang, count]) => `${lang}: ${count}`)
+                        .join(", ");
+                    console.log(`Languages: ${langEntries}`);
+                }
+                if (symbolKinds.size > 0) {
+                    const kindEntries = Array.from(symbolKinds.entries())
+                        .sort((a, b) => b[1] - a[1])
+                        .map(([kind, count]) => `${kind}: ${count}`)
+                        .join(", ");
+                    console.log(`Symbol kinds: ${kindEntries}`);
+                }
+                if (options?.tree) {
+                    console.log("");
+                    const filePaths = files.map((f) => f.path);
+                    printFileTree(buildFileTree(filePaths), "");
+                }
+                return;
+            }
+            const startedAt = Date.now();
+            console.log("Preparing indexer...");
+            const vectors = new vectors_js_1.LanceDbVectorStore({
+                dbPath: vectorsPath,
+                vectorSize: config_js_1.config.get("vectorSize"),
+            });
+            const embedder = new ollama_js_1.OllamaEmbeddingProvider(config_js_1.config.get("ollamaBaseUrl"), config_js_1.config.get("embeddingModel"), config_js_1.config.get("indexBatchSize"), config_js_1.config.get("indexConcurrency"), config_js_1.config.get("ollamaNumCtx"));
+            const git = new git_js_1.SimpleGitOperations();
+            let engine = null;
+            try {
+                engine = new indexer_js_1.IndexerEngine({
+                    projectId: types_js_1.DEFAULT_PROJECT_ID,
+                    repoRoot: resolvedProjectPath,
+                    metadata,
+                    vectors,
+                    embedder,
+                    git,
+                    languagePlugins: (0, indexer_js_1.createDefaultLanguagePlugins)(),
+                });
+                const latestSnapshot = await metadata.getLatestCompletedSnapshot(types_js_1.DEFAULT_PROJECT_ID);
+                const headCommit = await git.getHeadCommit(resolvedProjectPath);
+                const changedFiles = !options?.full && latestSnapshot?.meta.headCommit
+                    ? (0, git_js_1.mergeGitDiffs)(await git.getChangedFiles(resolvedProjectPath, latestSnapshot.meta.headCommit), await git.getWorkingTreeChanges(resolvedProjectPath))
+                    : undefined;
+                if (options?.dryRun) {
+                    if (options.full || !latestSnapshot) {
+                        const plannedFiles = await (0, scanner_js_1.scanProjectFiles)(resolvedProjectPath, [
+                            ".ts",
+                            ".tsx",
+                            ".mts",
+                            ".cts",
+                            ".js",
+                            ".jsx",
+                            ".mjs",
+                            ".cjs",
+                            ".py",
+                            ".pyi",
+                            ".cs",
+                            ".gd",
+                        ]);
+                        console.log("Dry run complete.");
+                        console.log("Mode: full reindex");
+                        console.log(`Files to index: ${plannedFiles.length}`);
+                    }
+                    else {
+                        const diff = changedFiles ?? {
+                            added: [],
+                            modified: [],
+                            deleted: [],
+                        };
+                        console.log("Dry run complete.");
+                        console.log("Mode: incremental");
+                        console.log(`Added: ${diff.added.length}`);
+                        console.log(`Modified: ${diff.modified.length}`);
+                        console.log(`Deleted: ${diff.deleted.length}`);
+                        console.log(`Changed total: ${countChangedFiles(diff)}`);
+                    }
+                    return;
+                }
+                await engine.initialize();
+                const mode = options?.full
+                    ? "Running full reindex..."
+                    : "Running incremental index...";
+                console.log(mode);
+                const result = await engine.indexProject({
+                    projectId: types_js_1.DEFAULT_PROJECT_ID,
+                    repoRoot: resolvedProjectPath,
+                    gitRef: headCommit ?? "unknown",
+                    isFullReindex: Boolean(options?.full),
+                    changedFiles,
+                    onProgress: (processed, total) => {
+                        console.log(`  ${processed}/${total} files...`);
+                    },
+                });
+                const snapshot = await metadata.getSnapshot(result.snapshotId);
+                const elapsedMs = Date.now() - startedAt;
+                const totalFiles = snapshot?.totalFiles
+                    ? ` / ${snapshot.totalFiles}`
+                    : "";
+                console.log("Index completed successfully.");
+                console.log(`  Snapshot: ${result.snapshotId}`);
+                console.log(`  Files indexed: ${result.filesIndexed}${totalFiles}`);
+                console.log(`  Chunks created: ${await vectors.countVectors({
+                    projectId: types_js_1.DEFAULT_PROJECT_ID,
+                    snapshotId: result.snapshotId
+                })}`);
+                console.log(`  Time elapsed: ${(elapsedMs / 1000).toFixed(2)}s`);
+                console.log(`  Errors: ${result.errors.length}`);
+                if (result.errors.length > 0) {
+                    for (const error of result.errors) {
+                        console.error(`  - ${error}`);
+                    }
+                }
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                console.error(`Indexing failed: ${message}`);
+                process.exitCode = 1;
+            }
+            finally {
+                if (engine) {
+                    await engine.close().catch(() => undefined);
+                }
+                else {
+                    await Promise.allSettled([vectors.close(), embedder.close()]);
+                }
+            }
+        }
+        finally {
+            await metadata.close().catch(() => undefined);
+        }
+    });
+}
+//# sourceMappingURL=index.js.map