opencode-rag-plugin 1.12.17 → 1.14.7

package/dist/cli.js

@@ -1,1256 +1,12 @@
-#!/usr/bin/env node
-import { Command } from "commander";
-import path from "node:path";
-import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
-import os from "node:os";
-import { spawnSync } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import chokidar from "chokidar";
-import pc from "picocolors";
-import { loadConfig, DEFAULT_CONFIG } from "./core/config.js";
-import { resolveRagContext } from "./core/bootstrap.js";
-import { getCurrentVersion, checkForUpdate, applyUpdate, } from "./updater.js";
-import { appendDebugLog } from "./core/fileLogger.js";
-import { checkProviderHealth, pullOllamaModels } from "./embedder/health.js";
-import { retrieve } from "./retriever/retriever.js";
-import { destroyAllPooledConnections } from "./embedder/http.js";
-import { createWatchPassScheduler, createWatchIgnore, getIndexStatusSummary, runIndexPass, } from "./indexer.js";
-const c = {
-    heading: (s) => pc.bold(pc.cyan(s)),
-    label: (s) => pc.dim(s),
-    dim: (s) => pc.dim(s),
-    value: (s) => pc.green(s),
-    num: (s) => pc.green(String(s)),
-    file: (s) => pc.yellow(s),
-    lang: (s) => pc.cyan(s),
-    score: (s) => pc.magenta(s),
-    desc: (s) => pc.dim(s),
-    success: (s) => pc.green(s),
-    warn: (s) => pc.yellow(s),
-    error: (s) => pc.red(s),
-    enabled: (s) => pc.green(s),
-    disabled: (s) => pc.yellow(s),
-    created: (s) => pc.green(s),
-    updated: (s) => pc.yellow(s),
-    exists: (s) => pc.dim(s),
-};
-function logCliError(logFilePath, scope, message, error) {
-    console.error(c.error(message));
-    //appendDebugLog(logFilePath, { scope, message, error });
-}
-function logCliInfo(logFilePath, scope, message) {
-    console.log(message);
-    //appendDebugLog(logFilePath, { scope, message });
-}
-async function resolveCliContext(opt, logFilePath) {
-    const ctx = await resolveRagContext({ configPath: opt.config });
-    logCliInfo(logFilePath, "config", `${c.label("Config:")} ${c.file(ctx.logFilePath)}`);
-    logConfigDetails(logFilePath, ctx.config);
-    return ctx;
-}
-function logConfigDetails(logFilePath, config) {
-    logCliInfo(logFilePath, "config", `  ${c.label("Embedding provider:")} ${c.value(config.embedding.provider)}`);
-    logCliInfo(logFilePath, "config", `  ${c.label("Embedding model:")}    ${c.value(config.embedding.model)}`);
-    logCliInfo(logFilePath, "config", `  ${c.label("Vector store:")}       ${c.file(config.vectorStore.path)}`);
-}
-async function cleanupContext(ctx) {
-    await ctx.store.close();
-    destroyAllPooledConnections();
-}
-function formatTimestamp(timestamp) {
-    if (!timestamp)
-        return "never";
-    return new Date(timestamp).toLocaleString();
-}
-function logIndexSummary(logFilePath, stats) {
-    logCliInfo(logFilePath, "index", `  ${c.label("New:")}              ${c.num(stats.newFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Modified:")}         ${c.num(stats.modifiedFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Unchanged:")}        ${c.num(stats.unchangedFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Deleted:")}          ${c.num(stats.deletedFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Removed:")}          ${c.num(stats.removedFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Empty skipped:")}    ${c.num(stats.skippedEmptyFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Small skipped:")}    ${c.num(stats.skippedSmallFiles)}`);
-    logCliInfo(logFilePath, "index", `  ${c.label("Chunks written:")}   ${c.num(stats.totalChunks)}`);
-}
-function formatDuration(ms) {
-    const seconds = (ms / 1000).toFixed(1);
-    if (ms < 60000)
-        return `${seconds}s`;
-    const minutes = Math.floor(ms / 60000);
-    const secs = ((ms % 60000) / 1000).toFixed(0);
-    return `${minutes}m ${secs}s`;
-}
-function getPackageRoot() {
-    return path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
-}
-function getPackageMetadata() {
-    const packageJsonPath = path.join(getPackageRoot(), "package.json");
-    return JSON.parse(readFileSync(packageJsonPath, "utf-8"));
-}
-function getStringRecord(value) {
-    if (!value || typeof value !== "object" || Array.isArray(value)) {
-        return {};
-    }
-    return Object.fromEntries(Object.entries(value).filter((entry) => typeof entry[1] === "string"));
-}
-function readJsonObject(filePath) {
-    if (!existsSync(filePath)) {
-        return undefined;
-    }
-    return JSON.parse(readFileSync(filePath, "utf-8"));
-}
-function writeJsonFile(filePath, value) {
-    writeFileSync(filePath, `${JSON.stringify(value, null, 2)}\n`, "utf-8");
-}
-function toPosixPath(input) {
-    return input.split(path.sep).join("/");
-}
-function resolveWorkspacePackageSpecifier(opencodeDir, packageRoot, version) {
-    const workspaceRoot = path.parse(opencodeDir).root.toLowerCase();
-    const sourceRoot = path.parse(packageRoot).root.toLowerCase();
-    if (workspaceRoot === sourceRoot) {
-        return `file:${toPosixPath(path.relative(opencodeDir, packageRoot))}`;
-    }
-    return version;
-}
-function buildWorkspacePackageJson(existing, packageMetadata, opencodeDir) {
-    const existingDependencies = getStringRecord(existing?.dependencies);
-    const pluginVersion = existingDependencies["@opencode-ai/plugin"] ??
-        packageMetadata.devDependencies?.["@opencode-ai/plugin"] ??
-        packageMetadata.peerDependencies?.["@opencode-ai/plugin"] ??
-        ">=1.0.0";
-    return {
-        ...existing,
-        name: typeof existing?.name === "string" ? existing.name : ".opencode",
-        private: true,
-        type: "module",
-        dependencies: {
-            ...existingDependencies,
-            "@opencode-ai/plugin": pluginVersion,
-            [packageMetadata.name]: resolveWorkspacePackageSpecifier(opencodeDir, getPackageRoot(), packageMetadata.version),
-        },
-    };
-}
-function buildOpencodeConfig(existing) {
-    const next = { ...(existing ?? {}) };
-    if (typeof next.$schema !== "string") {
-        next.$schema = "https://opencode.ai/config.json";
-    }
-    // Plugin is loaded via .opencode/plugins/rag-plugin.js auto-discovery,
-    // not via npm package resolution. Stale "plugin" entries from older
-    // init versions would trigger npm install (which fails due to native
-    // dependencies like canvas) and produce "Plugin export is not a function".
-    delete next.plugin;
-    return next;
-}
-export function removeStaleGlobalPluginRegistrations(homeDir, pluginName) {
-    const globalConfigDir = path.join(homeDir, ".config", "opencode");
-    const updatedPaths = [];
-    for (const cfgFile of ["opencode.jsonc", "opencode.json"]) {
-        const configPath = path.join(globalConfigDir, cfgFile);
-        if (!existsSync(configPath)) {
-            continue;
-        }
-        try {
-            const cfg = readJsonObject(configPath);
-            if (!cfg || !Array.isArray(cfg.plugin)) {
-                continue;
-            }
-            const nextPlugins = cfg.plugin.filter((entry) => typeof entry === "string" && entry !== pluginName);
-            if (nextPlugins.length === cfg.plugin.length) {
-                continue;
-            }
-            if (nextPlugins.length > 0) {
-                cfg.plugin = nextPlugins;
-            }
-            else {
-                delete cfg.plugin;
-            }
-            writeJsonFile(configPath, cfg);
-            updatedPaths.push(configPath);
-        }
-        catch {
-            // Ignore malformed OpenCode config files and leave them unchanged.
-        }
-    }
-    return updatedPaths;
-}
-function generateWorkspacePluginFile(packageName) {
-    return [
-        `import plugin from "../node_modules/${packageName}/dist/plugin-entry.js";`,
-        `export const id = plugin.id;`,
-        `export const server = plugin.server;`,
-        `export default plugin;`,
-        "",
-    ].join("\n");
-}
-function generateWorkspaceTuiPluginFile(packageName) {
-    return [
-        `import plugin from "../node_modules/${packageName}/dist/tui.js";`,
-        `export default plugin;`,
-        "",
-    ].join("\n");
-}
-function generateSkillFile() {
-    return [
-        "---",
-        "name: opencode-rag",
-        "description: Semantic code retrieval via OpenCodeRAG — vector search, file skeletons, and symbol usage lookup for this workspace",
-        "---",
-        "",
-        "## OpenCodeRAG Tools",
-        "",
-        "This workspace has OpenCodeRAG indexed for semantic code search. Use these tools BEFORE planning, editing, or answering code questions.",
-        "",
-        "### Decision tree — ALWAYS follow this order",
-        "",
-        "1. User mentions code behavior/architecture → `search_semantic(query)`",
-        "2. User mentions a file path → `get_file_skeleton(filePath)` THEN `read` on specific lines",
-        "3. User mentions a function/class/variable to edit → `find_usages(symbolName)` THEN `search_semantic` THEN `edit`",
-        "4. User asks a code question → `search_semantic` to gather context before answering",
-        "",
-        "### When to use each tool",
-        "",
-        "| Tool | Use when | Example |",
-        "|------|----------|---------|",
-        "| `search_semantic` | Any code search — find relevant code by meaning or keyword | `\"authentication middleware\"` |",
-        "| `get_file_skeleton` | You have a file path but need to orient before reading | `\"src/plugin.ts\"` |",
-        "| `find_usages` | Before editing any function, class, or variable — check all call sites | `\"createRagHooks\"` |",
-        "",
-        "### Workflow",
-        "",
-        "1. **Skeleton first** — call `get_file_skeleton(filePath)` to see structure",
-        "2. **Find usages** — call `find_usages(symbolName)` before modifying any symbol",
-        "3. **Search** — call `search_semantic(query)` to find relevant code",
-        "4. **Read** — use the `read` tool on specific line ranges identified above",
-        "5. **Edit** — now you have full context to make safe changes",
-        "",
-        "### Anti-patterns — NEVER do these",
-        "",
-        "- Reading full files without calling `get_file_skeleton` first (wastes tokens)",
-        "- Editing a function without calling `find_usages` first (breaks call sites)",
-        "- Answering code questions without calling `search_semantic` first (you guess at behavior)",
-        "- Using `grep`/`glob` when `search_semantic` would find the answer faster",
-        "",
-        "### Parameters",
-        "",
-        "- `search_semantic`: `query` (req), `pathHints?`, `languageHints?`, `topK?`",
-        "- `get_file_skeleton`: `filePath` (req)",
-        "- `find_usages`: `symbolName` (req), `pathHint?`, `topK?`",
-        "",
-        "### Tips",
-        "",
-        "- Use `pathHints` to narrow searches to specific directories",
-        "- Use `languageHints` to filter by file type",
-        "- `find_usages` is essential before refactoring — it shows every reference",
-        "- If no results appear, the workspace may not be indexed yet — run `opencode-rag index`",
-        "",
-    ].join("\n");
-}
-function mergeGitignoreContent(existingContent) {
-    const lines = existingContent ? existingContent.split(/\r?\n/) : [];
-    const trimmed = new Set(lines.map((line) => line.trim()));
-    const requiredEntries = ["node_modules/", "package-lock.json", "rag_db/", "opencode-rag.log"];
-    const missing = requiredEntries.filter((entry) => !trimmed.has(entry));
-    if (!existingContent) {
-        return [
-            "# Ignore workspace-local plugin dependencies",
-            "node_modules/",
-            "package-lock.json",
-            "",
-            "# Ignore the LanceDB vector store (binary data)",
-            "rag_db/",
-            "",
-            "# Ignore logs",
-            "opencode-rag.log",
-            "",
-        ].join("\n");
-    }
-    if (missing.length === 0) {
-        return existingContent.endsWith("\n") ? existingContent : `${existingContent}\n`;
-    }
-    const merged = [...lines];
-    const lastLine = merged.length > 0 ? (merged[merged.length - 1] ?? "") : "";
-    if (lastLine.trim().length > 0) {
-        merged.push("");
-    }
-    merged.push("# OpenCodeRAG workspace state", ...missing, "");
-    return merged.join("\n");
-}
-function installWorkspaceDependencies(opencodeDir) {
-    const quoteForCmd = (value) => /[\s"]/u.test(value) ? `"${value.replace(/"/g, '""')}"` : value;
-    const attempts = [
-        {
-            args: ["install", "--silent", "--no-package-lock"],
-            retry: false,
-        },
-        {
-            args: [
-                "install",
-                "--silent",
-                "--no-package-lock",
-                "--ignore-scripts",
-                "--no-optional",
-            ],
-            retry: true,
-        },
-    ];
-    let lastError;
-    for (const attempt of attempts) {
-        if (attempt.retry) {
-            console.log(c.warn("  Retrying dependency install without native module compilation..."));
-        }
-        const result = process.platform === "win32"
-            ? spawnSync(process.env.ComSpec ?? "cmd.exe", ["/d", "/s", "/c", `npm ${attempt.args.map(quoteForCmd).join(" ")}`], {
-                cwd: opencodeDir,
-                stdio: "inherit",
-                env: process.env,
-            })
-            : spawnSync("npm", attempt.args, {
-                cwd: opencodeDir,
-                stdio: "inherit",
-                env: process.env,
-            });
-        if (result.status === 0) {
-            return;
-        }
-        lastError = result.error ?? new Error(`npm install exited with code ${result.status ?? 1}`);
-    }
-    throw lastError ?? new Error("npm install failed for workspace dependencies");
-}
-const program = new Command();
-program
-    .name("opencode-rag")
-    .description("Local-first RAG semantic code search")
-    .version(getPackageMetadata().version);
-program
-    .command("index")
-    .description("Index workspace files")
-    .option("-c, --config <path>", "path to config file")
-    .option("-f, --force", "force full re-index")
-    .option("-w, --watch", "watch workspace and incrementally re-index on changes")
-    .action(async (options) => {
-    const started = Date.now();
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { config, embedder, store, storePath, keywordIndex, descriptionProvider, dimension } = ctx;
-        logFilePath = ctx.logFilePath;
-        logCliInfo(logFilePath, "index", `\n${c.heading("Indexing workspace...")}`);
-        logCliInfo(logFilePath, "index", `  ${c.label("Vector dimension:")}   ${c.num(dimension)}`);
-        if (descriptionProvider) {
-            const descriptionConfig = config.description ?? { provider: "ollama", model: "qwen2.5:3b" };
-            logCliInfo(logFilePath, "index", `  ${c.label("Description LLM:")}  ${c.value(descriptionConfig.model)} (${descriptionConfig.provider})`);
-        }
-        logCliInfo(logFilePath, "index", `${c.label("Scanning:")} ${c.file(cwd)}`);
-        const runPass = async (watchTriggered = false) => {
-            const passStarted = Date.now();
-            const stats = await runIndexPass({
-                cwd,
-                storePath,
-                config,
-                store,
-                embedder,
-                keywordIndex,
-                descriptionProvider,
-                force: Boolean(options.force && !watchTriggered),
-                logger: {
-                    info: (message) => {
-                        console.log(message);
-                        appendDebugLog(logFilePath, { scope: "index", message });
-                    },
-                    warn: (message) => {
-                        console.warn(message);
-                        appendDebugLog(logFilePath, { scope: "index", message: `WARN: ${message}` });
-                    },
-                    debug: (message) => {
-                        appendDebugLog(logFilePath, { scope: "index", message: `DEBUG: ${message}`, severity: "debug" });
-                    },
-                },
-            });
-            logIndexSummary(logFilePath, stats);
-            logCliInfo(logFilePath, "index", `\n${c.success("Indexing complete.")} ${c.num(stats.finalCount)} chunks stored (${formatDuration(Date.now() - passStarted)}).`);
-        };
-        await runPass(false);
-        if (!options.watch) {
-            await cleanupContext(ctx);
-            return;
-        }
-        logCliInfo(logFilePath, "index", `\n${c.heading("Watching for changes...")}`);
-        const scheduler = createWatchPassScheduler(() => runPass(true), (error) => {
-            const message = error.message || String(error);
-            logCliError(logFilePath, "watch", `\nWatch reindex failed: ${message}`, error);
-        }, 300);
-        const watcher = chokidar.watch(cwd, {
-            ignored: createWatchIgnore(cwd, config, storePath),
-            ignoreInitial: true,
-            persistent: true,
-        });
-        const handleChange = () => scheduler.notifyChange();
-        watcher.on("add", handleChange);
-        watcher.on("change", handleChange);
-        watcher.on("unlink", handleChange);
-        watcher.on("unlinkDir", handleChange);
-        watcher.on("addDir", handleChange);
-        watcher.on("error", (error) => {
-            logCliError(logFilePath, "watch", `Watcher error: ${error.message}`, error);
-            console.error(c.error(`\nWatcher error: ${error.message}`));
-        });
-        const shutdown = async () => {
-            scheduler.close();
-            await scheduler.waitForIdle();
-            await Promise.race([
-                watcher.close(),
-                new Promise((r) => setTimeout(r, 5000)),
-            ]);
-            await cleanupContext(ctx);
-            process.exit(0);
-        };
-        process.once("SIGINT", () => void shutdown());
-        process.once("SIGTERM", () => void shutdown());
-        const duration = formatDuration(Date.now() - started);
-        logCliInfo(logFilePath, "index", `${c.success("Watcher ready")} (${duration} startup). Press Ctrl+C to stop.`);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "index", `\nIndexing failed: ${message}`, err);
-        if (message.toLowerCase().includes("fetch") || message.toLowerCase().includes("econnrefused")) {
-            console.error(c.warn("Hint: Is your embedding provider running?"));
-        }
-        process.exit(1);
-    }
-});
-program
-    .command("query")
-    .description("Search the indexed codebase")
-    .argument("<query>", "natural language query")
-    .option("-c, --config <path>", "path to config file")
-    .option("-n, --top-k <number>", "number of results", "10")
-    .option("--explain", "show hybrid score breakdown")
-    .action(async (query, options) => {
-    const started = Date.now();
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { config, embedder, store, storePath, keywordIndex } = ctx;
-        logFilePath = ctx.logFilePath;
-        logCliInfo(logFilePath, "query", `\n${c.heading("Querying:")} "${query}"`);
-        logCliInfo(logFilePath, "query", `${c.label("Top-K:")} ${c.num(parseInt(options.topK ?? "10", 10))}`);
-        const indexedCount = await store.count();
-        if (indexedCount === 0) {
-            logCliInfo(logFilePath, "query", `${c.warn("No indexed chunks found.")} Run 'opencode-rag index' first.`);
-            await cleanupContext(ctx);
-            return;
-        }
-        logCliInfo(logFilePath, "query", `${c.label("Searching")} ${c.num(indexedCount)} indexed chunks...`);
-        const topK = parseInt(options.topK ?? "10", 10);
-        const minScore = config.retrieval.minScore;
-        const hybridCfg = config.retrieval.hybridSearch;
-        const rawResults = await retrieve(query, embedder, store, {
-            topK,
-            minScore,
-            keywordIndex,
-            keywordWeight: hybridCfg?.keywordWeight,
-            queryPrefix: config.embedding.queryPrefix,
-            explain: options.explain ?? false,
-        });
-        const results = dedupeResults(rawResults);
-        if (results.length === 0) {
-            logCliInfo(logFilePath, "query", c.warn("No results found."));
-            await cleanupContext(ctx);
-            return;
-        }
-        const duration = formatDuration(Date.now() - started);
-        logCliInfo(logFilePath, "query", `\n${c.num(results.length)} result(s) in ${duration}:\n`);
-        for (const r of results) {
-            logCliInfo(logFilePath, "query", `  ${c.file(r.chunk.metadata.filePath)}:${c.value(String(r.chunk.metadata.startLine))}-${c.value(String(r.chunk.metadata.endLine))}`);
-            logCliInfo(logFilePath, "query", `  ${c.label("Score:")} ${c.score(r.score.toFixed(4))}`);
-            if (r.explanation) {
-                const sb = r.explanation.scoreBreakdown;
-                logCliInfo(logFilePath, "query", `  ${c.label("  Vector:")} ${c.score(sb.rawVectorScore.toFixed(4))}  ${c.label("Keyword:")} ${c.score(sb.rawKeywordScore.toFixed(4))}  ${c.label("KW weight:")} ${sb.keywordWeight.toFixed(2)}`);
-                if (r.explanation.matchedTerms && r.explanation.matchedTerms.length > 0) {
-                    logCliInfo(logFilePath, "query", `  ${c.label("  Matched:")} ${c.lang(r.explanation.matchedTerms.join(", "))}`);
-                }
-            }
-            logCliInfo(logFilePath, "query", `  ${pc.dim(r.chunk.content.slice(0, 200).replace(/\n/g, "\n  "))}`);
-        }
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "query", `\nQuery failed: ${message}`, err);
-        if (message.toLowerCase().includes("fetch") || message.toLowerCase().includes("econnrefused")) {
-            console.error(c.warn("Hint: Is your embedding provider running?"));
-        }
-        process.exit(1);
-    }
-});
-program
-    .command("clear")
-    .description("Clear all indexed data")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { store } = ctx;
-        logFilePath = ctx.logFilePath;
-        const prevCount = await store.count();
-        if (prevCount === 0) {
-            logCliInfo(logFilePath, "clear", c.warn("No indexed data to clear."));
-        }
-        else {
-            logCliInfo(logFilePath, "clear", `${c.label("Clearing")} ${c.num(prevCount)} indexed chunks...`);
-        }
-        await store.clear();
-        logCliInfo(logFilePath, "clear", `${c.success("Done.")} vector database directory removed.`);
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "clear", `\nClear failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("status")
-    .description("Show indexing status")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { config, store, storePath, keywordIndex } = ctx;
-        logFilePath = ctx.logFilePath;
-        const count = await store.count();
-        const summary = await getIndexStatusSummary(cwd, storePath, config, store);
-        logCliInfo(logFilePath, "status", `\n${c.heading("Indexed chunks:")}    ${c.num(count)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Store path:")}        ${c.file(storePath)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Embedding provider:")} ${c.value(config.embedding.provider)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Embedding model:")}   ${c.value(config.embedding.model)}`);
-        logCliInfo(logFilePath, "status", `${c.label("File extensions:")}   ${config.indexing.includeExtensions.join(", ")}`);
-        logCliInfo(logFilePath, "status", `${c.label("Excluded dirs:")}     ${config.indexing.excludeDirs.join(", ")}`);
-        logCliInfo(logFilePath, "status", `${c.label("Default top-K:")}     ${c.num(config.retrieval.topK)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Plugin enabled:")}    ${config.openCode.enabled ? c.enabled("yes") : c.disabled("no")}`);
-        logCliInfo(logFilePath, "status", `${c.label("Manifest status:")}   ${summary.manifestStatus}`);
-        logCliInfo(logFilePath, "status", `${c.label("Manifest entries:")}  ${c.num(summary.manifestEntries)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Last indexed:")}      ${c.value(formatTimestamp(summary.lastIndexedAt))}`);
-        logCliInfo(logFilePath, "status", `${c.label("Up-to-date files:")}  ${c.num(summary.upToDateFiles)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Pending files:")}     ${c.num(summary.pendingFiles)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Indexed chunks:")}    ${c.num(summary.storeChunkCount)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Expected chunks:")}   ${c.num(summary.manifestExpectedChunks)}`);
-        logCliInfo(logFilePath, "status", `${c.label("Watch mode:")}        ${c.dim("off")}`);
-        const kiCount = config.retrieval.hybridSearch?.enabled
-            ? keywordIndex?.count() ?? 0
-            : 0;
-        logCliInfo(logFilePath, "status", `${c.label("Keyword index:")}     ${config.retrieval.hybridSearch?.enabled ? c.enabled("enabled") : c.disabled("disabled")} (${c.num(kiCount)} chunks)`);
-        if (summary.rebuildRequired) {
-            logCliInfo(logFilePath, "status", `${c.label("Rebuild required:")}  ${c.warn("yes")} (manifest missing/corrupt)`);
-        }
-        if (summary.storeChunkCount > 0 && summary.manifestExpectedChunks > 0 && summary.storeChunkCount < summary.manifestExpectedChunks * 0.5) {
-            logCliInfo(logFilePath, "status", `${c.label("Data loss detected:")} ${c.warn("yes")} — store has fewer chunks than expected. Run 'opencode-rag index' to rebuild.`);
-        }
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "status", `\nStatus check failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("list")
-    .description("List all indexed files with chunk counts")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { store } = ctx;
-        logFilePath = ctx.logFilePath;
-        const files = await store.listFiles();
-        if (files.length === 0) {
-            logCliInfo(logFilePath, "list", `${c.warn("No indexed files found.")} Run 'opencode-rag index' first.`);
-            await cleanupContext(ctx);
-            return;
-        }
-        logCliInfo(logFilePath, "list", `\n${c.num(files.length)} file(s) indexed:\n`);
-        for (const f of files) {
-            logCliInfo(logFilePath, "list", `  ${c.file(f.filePath)}  ${c.label("(")}${c.lang(f.language)}${c.label(", ")}${c.num(f.chunkCount)} chunk${f.chunkCount === 1 ? "" : "s"}${c.label(")")}`);
-        }
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "list", `\nList failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("show <file>")
-    .description("Show chunks for a specific file")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (file, options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { store } = ctx;
-        logFilePath = ctx.logFilePath;
-        const chunks = await store.getChunksByFilePath(file);
-        if (chunks.length === 0) {
-            logCliInfo(logFilePath, "show", `${c.warn(`No chunks found for '${file}'.`)}`);
-            await cleanupContext(ctx);
-            return;
-        }
-        logCliInfo(logFilePath, "show", `\n${c.num(chunks.length)} chunk(s) for ${c.file(file)}:\n`);
-        for (const chunk of chunks) {
-            logCliInfo(logFilePath, "show", `  ${c.label("[")}${c.value(String(chunk.metadata.startLine))}${c.label("-")}${c.value(String(chunk.metadata.endLine))}${c.label("]")} ${c.label("(")}${c.lang(chunk.metadata.language)}${c.label(")")} ${pc.dim(chunk.id)}`);
-            if (chunk.description) {
-                logCliInfo(logFilePath, "show", `  ${c.desc(">")} ${c.desc(chunk.description)}`);
-            }
-            logCliInfo(logFilePath, "show", `  ${chunk.content}\n`);
-        }
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "show", `\nShow failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("dump")
-    .description("Dump all indexed chunks")
-    .option("-c, --config <path>", "path to config file")
-    .option("--offset <number>", "start at chunk offset", "0")
-    .option("--limit <number>", "max number of chunks to dump", "25")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { store, storePath } = ctx;
-        logFilePath = ctx.logFilePath;
-        const total = await store.count();
-        if (total === 0) {
-            logCliInfo(logFilePath, "dump", `${c.warn("No indexed chunks found.")} Run 'opencode-rag index' first.`);
-            await cleanupContext(ctx);
-            return;
-        }
-        const offset = parseInt(options.offset ?? "0", 10);
-        const limit = parseInt(options.limit ?? "25", 10);
-        const chunks = await store.getChunks(offset, limit);
-        logCliInfo(logFilePath, "dump", `\n${c.heading("Chunks")} ${c.value(String(offset + 1))}${c.label("-")}${c.value(String(offset + chunks.length))} of ${c.num(total)}:\n`);
-        for (const chunk of chunks) {
-            logCliInfo(logFilePath, "dump", `  ${c.file(chunk.filePath)}:${c.value(String(chunk.startLine))}${c.label("-")}${c.value(String(chunk.endLine))} ${c.label("(")}${c.lang(chunk.language)}${c.label(")")}`);
-            logCliInfo(logFilePath, "dump", `  ${chunk.content}\n`);
-        }
-        if (offset + limit < total) {
-            logCliInfo(logFilePath, "dump", `  ${c.dim(`... ${total - offset - limit} more (use --offset ${offset + limit} to continue)`)}`);
-        }
-        await cleanupContext(ctx);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "dump", `\nDump failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("ui")
-    .description("Start the web UI for browsing the vector database")
-    .option("-c, --config <path>", "path to config file")
-    .option("-p, --port <number>", "port to listen on (default: from config or 3210)")
-    .option("--no-open", "do not open browser automatically")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        let logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { config, storePath } = ctx;
-        logFilePath = ctx.logFilePath;
-        const port = parseInt(options.port ?? String(config.ui?.port ?? 3210), 10);
-        const openBrowser = options.open !== false && (config.ui?.openBrowser ?? true);
-        const { startWebUi } = await import("./web/server.js");
-        const server = await startWebUi(storePath, port, cwd);
-        const url = `http://127.0.0.1:${server.port}`;
-        logCliInfo(logFilePath, "ui", `\n${c.heading("OpenCodeRAG Web UI")}`);
-        logCliInfo(logFilePath, "ui", `  ${c.label("URL:")} ${c.value(url)}`);
-        logCliInfo(logFilePath, "ui", `  ${c.dim("Press Ctrl+C to stop")}\n`);
-        if (openBrowser) {
-            const { spawn } = await import("node:child_process");
-            try {
-                if (process.platform === "win32") {
-                    spawn("cmd.exe", ["/c", "start", url], { detached: true, stdio: "ignore" }).unref();
-                }
-                else {
-                    const cmd = process.platform === "darwin" ? "open" : "xdg-open";
-                    spawn(cmd, [url], { detached: true, stdio: "ignore" }).unref();
-                }
-            }
-            catch {
-                console.error(c.dim(`Could not open browser automatically. Open ${url} manually.`));
-            }
-        }
-        process.on("SIGINT", async () => {
-            await server.close();
-            process.exit(0);
-        });
-        process.on("SIGTERM", async () => {
-            await server.close();
-            process.exit(0);
-        });
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "ui", `\nUI failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("mcp")
-    .description("Start MCP server for semantic code retrieval (stdio transport)")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (options) => {
-    try {
-        const { runMcpServer } = await import("./mcp/cli.js");
-        await runMcpServer({
-            configPath: options.config,
-            cwd: process.cwd(),
-        });
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        const logFilePath = path.resolve(process.cwd(), ".opencode", "opencode-rag.log");
-        logCliError(logFilePath, "mcp", `\nMCP server failed: ${message}`, err);
-        process.exit(1);
-    }
-});
-program
-    .command("update")
-    .description("Check for and install OpenCodeRAG updates from GitHub")
-    .option("--check", "only check for updates, don't install")
-    .option("-y, --yes", "skip confirmation prompt")
-    .option("-v, --verbose", "show build/install output")
-    .action(async (options) => {
-    try {
-        const currentVersion = getCurrentVersion();
-        console.log(`\n${c.heading("OpenCodeRAG Updater")}\n`);
-        console.log(`  ${c.label("Current version:")} ${c.value(currentVersion)}`);
-        console.log(`  ${c.label("Checking for updates...")}`);
-        const info = await checkForUpdate(currentVersion);
-        if (!info.updateAvailable) {
-            console.log(`  ${c.success("Already up to date.")}\n`);
-            return;
-        }
-        console.log(`  ${c.label("Latest version:")}  ${c.value(info.latestVersion)}`);
-        if (info.releaseUrl) {
-            console.log(`  ${c.label("Release:")}         ${c.file(info.releaseUrl)}`);
-        }
-        console.log();
-        if (options.check) {
-            console.log(`  ${c.warn("Update available. Run `opencode-rag update` to install.")}\n`);
-            return;
-        }
-        if (!options.yes) {
-            const readline = await import("node:readline");
-            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-            const answer = await new Promise((resolve) => {
-                rl.question(`  Install update to ${info.latestVersion}? [y/N] `, resolve);
-            });
-            rl.close();
-            if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
-                console.log(`  ${c.dim("Cancelled.")}\n`);
-                return;
-            }
-        }
-        console.log(`  ${c.label("Applying update...")}\n`);
-        const result = applyUpdate({
-            repoRoot: path.resolve(getPackageRoot()),
-            verbose: options.verbose ?? false,
-        });
-        if (result.success) {
-            console.log(`  ${c.success(result.message)}\n`);
-        }
-        else {
-            console.error(`  ${c.error(result.message)}\n`);
-            process.exit(1);
-        }
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        console.error(c.error(`\nUpdate failed: ${message}\n`));
-        process.exit(1);
-    }
-});
-// ── Eval commands ──────────────────────────────────────────────
-program
-    .command("eval:sessions")
-    .description("List all logged evaluation sessions")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (options) => {
-    try {
-        const cwd = process.cwd();
-        const logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { storePath } = ctx;
-        const { listSessions } = await import("./eval/storage.js");
-        const sessions = listSessions(storePath);
-        if (sessions.length === 0) {
-            console.log(c.warn("\nNo evaluation sessions found. Sessions are logged automatically during OpenCode usage.\n"));
-            return;
-        }
-        console.log(`\n${c.heading("Evaluation Sessions")} (${sessions.length})\n`);
-        console.log("  ID                          Queries  Input Tok  RAG Ctx   Cost");
-        console.log("  " + "─".repeat(64));
-        for (const s of sessions) {
-            const id = (s.sessionID ?? "").padEnd(28);
-            const queries = String(s.messageCount).padStart(6);
-            const input = String(s.totalTokens.input).padStart(9);
-            const ragCtx = String(s.ragContextTokens).padStart(8);
-            const cost = `$${s.totalCost.toFixed(4)}`.padStart(7);
-            console.log(`  ${id}  ${queries}  ${input}  ${ragCtx}  ${cost}`);
-        }
-        console.log();
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        console.error(c.error(`\nFailed: ${message}\n`));
-        process.exit(1);
-    }
-});
-program
-    .command("eval:analyze <sessionID>")
-    .description("Analyze token usage for a specific session")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (sessionID, options) => {
-    try {
-        const cwd = process.cwd();
-        const logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { storePath } = ctx;
-        const { analyzeTokenUsage } = await import("./eval/token-analysis.js");
-        const analysis = analyzeTokenUsage(storePath, sessionID);
-        if (analysis.queryCount === 0) {
-            console.log(c.warn(`\nNo messages found for session '${sessionID}'.\n`));
-            return;
-        }
-        console.log(`\n${c.heading("Token Analysis")} — ${c.value(sessionID)}\n`);
-        console.log(`  Queries:          ${analysis.queryCount}`);
-        console.log(`  Input tokens:     ${c.num(analysis.totals.inputTokens.toLocaleString())}`);
-        console.log(`  Output tokens:    ${c.num(analysis.totals.outputTokens.toLocaleString())}`);
-        console.log(`  Reasoning tokens: ${c.num(analysis.totals.reasoningTokens.toLocaleString())}`);
-        console.log(`  Cache read:       ${c.num(analysis.totals.cacheRead.toLocaleString())}`);
-        console.log(`  Cost:             ${c.num(`$${analysis.totals.cost.toFixed(4)}`)}`);
-        console.log();
-        console.log(`  ${c.heading("RAG Impact")}`);
-        console.log(`  Context injected: ${c.num(analysis.totals.ragContextTokens.toLocaleString())} tokens`);
-        console.log(`  System guidance:  ${c.num(analysis.totals.systemGuidanceTokens.toLocaleString())} tokens`);
-        console.log(`  Read calls:       ${c.num(analysis.totals.readToolCalls)}`);
-        console.log(`  RAG tool calls:   ${c.num(analysis.totals.ragToolCalls)}`);
-        console.log();
-        console.log(`  ${c.heading("Projection")}`);
-        console.log(`  Tokens with RAG:    ${c.num(analysis.estimates.tokensWithRAG.toLocaleString())}`);
-        console.log(`  Tokens without RAG: ${c.num(analysis.estimates.tokensWithoutRAG.toLocaleString())}`);
-        const savingsColor = analysis.estimates.netSavings > 0 ? c.success : c.warn;
-        console.log(`  Net savings:        ${savingsColor(`${analysis.estimates.netSavings > 0 ? "+" : ""}${analysis.estimates.netSavings.toLocaleString()} tokens (${analysis.estimates.percentSavings}%)`)}`);
-        console.log();
-        if (analysis.breakdowns.length > 0) {
-            console.log(`  ${c.heading("Per-Query Breakdown")}`);
-            console.log("  #    Input   RAG ctx  Reads  RAG tools  Score");
-            console.log("  " + "─".repeat(52));
-            for (let i = 0; i < analysis.breakdowns.length; i++) {
-                const b = analysis.breakdowns[i];
-                const num = String(i + 1).padStart(3);
-                const input = String(b.inputTokens).padStart(7);
-                const ctx = String(b.ragContextTokens).padStart(7);
-                const reads = String(b.readToolCalls).padStart(5);
-                const tools = String(b.ragToolCalls).padStart(9);
-                const score = b.ragTopScore.toFixed(2);
-                console.log(`  ${num}  ${input}  ${ctx}  ${reads}  ${tools}  ${score}`);
-            }
-        }
-        console.log();
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        console.error(c.error(`\nFailed: ${message}\n`));
-        process.exit(1);
-    }
-});
-program
-    .command("eval:compare <sessionA> <sessionB>")
-    .description("Compare token usage between two sessions (e.g. RAG-on vs RAG-off)")
-    .option("-c, --config <path>", "path to config file")
-    .action(async (sessionA, sessionB, options) => {
-    try {
-        const cwd = process.cwd();
-        const logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ctx = await resolveCliContext(options, logFilePath);
-        const { storePath } = ctx;
-        const { analyzeTokenUsage, compareTokenAnalyses, formatTokenReport } = await import("./eval/token-analysis.js");
-        const a = analyzeTokenUsage(storePath, sessionA);
-        const b = analyzeTokenUsage(storePath, sessionB);
-        if (a.queryCount === 0 && b.queryCount === 0) {
-            console.log(c.warn(`\nNo messages found for sessions '${sessionA}' or '${sessionB}'.\n`));
-            return;
-        }
-        const comparison = compareTokenAnalyses(a, b);
-        const report = formatTokenReport(a, b, comparison);
-        console.log(report);
-    }
-    catch (err) {
-        const message = err.message || String(err);
-        console.error(c.error(`\nFailed: ${message}\n`));
-        process.exit(1);
-    }
-});
-function generateDefaultConfigJson() {
-    return JSON.stringify({
-        embedding: {
-            provider: DEFAULT_CONFIG.embedding.provider,
-            baseUrl: DEFAULT_CONFIG.embedding.baseUrl,
-            model: DEFAULT_CONFIG.embedding.model,
-            timeoutMs: DEFAULT_CONFIG.embedding.timeoutMs,
-        },
-        indexing: {
-            includeExtensions: DEFAULT_CONFIG.indexing.includeExtensions,
-            excludeDirs: DEFAULT_CONFIG.indexing.excludeDirs,
-            chunkOverlap: DEFAULT_CONFIG.indexing.chunkOverlap,
-            minFileSizeBytes: DEFAULT_CONFIG.indexing.minFileSizeBytes,
-            concurrency: DEFAULT_CONFIG.indexing.concurrency,
-            embedBatchSize: DEFAULT_CONFIG.indexing.embedBatchSize,
-        },
-        vectorStore: {
-            path: DEFAULT_CONFIG.vectorStore.path,
-        },
-        retrieval: {
-            topK: DEFAULT_CONFIG.retrieval.topK,
-            minScore: DEFAULT_CONFIG.retrieval.minScore,
-            hybridSearch: {
-                enabled: DEFAULT_CONFIG.retrieval.hybridSearch.enabled,
-                keywordWeight: DEFAULT_CONFIG.retrieval.hybridSearch.keywordWeight,
-            },
-        },
-        openCode: {
-            enabled: DEFAULT_CONFIG.openCode.enabled,
-            maxContextChunks: DEFAULT_CONFIG.openCode.maxContextChunks,
-            readOverride: DEFAULT_CONFIG.openCode.readOverride,
-            autoIndex: {
-                enabled: DEFAULT_CONFIG.openCode.autoIndex.enabled,
-                debounceMs: DEFAULT_CONFIG.openCode.autoIndex.debounceMs,
-                intervalMs: DEFAULT_CONFIG.openCode.autoIndex.intervalMs,
-            },
-            autoInject: {
-                enabled: DEFAULT_CONFIG.openCode.autoInject.enabled,
-                minScore: DEFAULT_CONFIG.openCode.autoInject.minScore,
-                maxChunks: DEFAULT_CONFIG.openCode.autoInject.maxChunks,
-                maxTokens: DEFAULT_CONFIG.openCode.autoInject.maxTokens,
-                contentType: DEFAULT_CONFIG.openCode.autoInject.contentType,
-            },
-        },
-        imageDescription: {
-            enabled: DEFAULT_CONFIG.imageDescription.enabled,
-            provider: DEFAULT_CONFIG.imageDescription.provider,
-            model: DEFAULT_CONFIG.imageDescription.model,
-            baseUrl: DEFAULT_CONFIG.imageDescription.baseUrl,
-            timeoutMs: DEFAULT_CONFIG.imageDescription.timeoutMs,
-            think: DEFAULT_CONFIG.imageDescription.think,
-            numCtx: DEFAULT_CONFIG.imageDescription.numCtx,
-        },
-        description: {
-            enabled: DEFAULT_CONFIG.description.enabled,
-            provider: DEFAULT_CONFIG.description.provider,
-            baseUrl: DEFAULT_CONFIG.description.baseUrl,
-            model: DEFAULT_CONFIG.description.model,
-            think: DEFAULT_CONFIG.description.think,
-            numCtx: DEFAULT_CONFIG.description.numCtx,
-            timeoutMs: DEFAULT_CONFIG.description.timeoutMs,
-        },
-        mcp: {
-            enabled: DEFAULT_CONFIG.mcp.enabled,
-        },
-        logging: {
-            level: DEFAULT_CONFIG.logging.level,
-            logFilePath: DEFAULT_CONFIG.logging.logFilePath,
-        },
-        chunking: {
-            nodeTypes: {},
-        },
-    }, null, 2) + "\n";
-}
-program
-    .command("init")
-    .description("Configure the current workspace for OpenCodeRAG")
-    .option("-f, --force", "overwrite existing files")
-    .option("--skip-install", "skip installing workspace-local plugin dependencies")
-    .option("--skip-health-check", "skip provider connectivity and model availability check")
-    .action(async (options) => {
-    const cwd = process.cwd();
-    const packageMetadata = getPackageMetadata();
-    const configPath = path.join(cwd, "opencode-rag.json");
-    const opencodeDir = path.join(cwd, ".opencode");
-    const gitignorePath = path.join(opencodeDir, ".gitignore");
-    const opencodeConfigPath = path.join(opencodeDir, "opencode.json");
-    const pluginsDir = path.join(opencodeDir, "plugins");
-    const pluginEntryPath = path.join(pluginsDir, "rag-plugin.js");
-    const tuiPluginEntryPath = path.join(pluginsDir, "rag-tui.js");
-    const tuiConfigPath = path.join(opencodeDir, "tui.json");
-    const opencodePackagePath = path.join(opencodeDir, "package.json");
-    console.log(`\n${c.heading("Initializing OpenCodeRAG in workspace...")}\n`);
-    if (!existsSync(opencodeDir)) {
-        mkdirSync(opencodeDir, { recursive: true });
-        console.log(`  ${c.created("Created:")}  .opencode/`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/`);
-    }
-    if (!existsSync(pluginsDir)) {
-        mkdirSync(pluginsDir, { recursive: true });
-        console.log(`  ${c.created("Created:")}  .opencode/plugins/`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/plugins/`);
-    }
-    const gitignoreExists = existsSync(gitignorePath);
-    const nextGitignoreContent = mergeGitignoreContent(gitignoreExists ? readFileSync(gitignorePath, "utf-8") : undefined);
-    if (!gitignoreExists || options.force || readFileSync(gitignorePath, "utf-8") !== nextGitignoreContent) {
-        writeFileSync(gitignorePath, nextGitignoreContent, "utf-8");
-        console.log(`  ${gitignoreExists ? c.updated("Updated:") : c.created("Created:")} .opencode/.gitignore`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/.gitignore`);
-    }
-    const opencodeConfigExists = existsSync(opencodeConfigPath);
-    const nextOpencodeConfig = buildOpencodeConfig(readJsonObject(opencodeConfigPath));
-    if (!opencodeConfigExists || options.force) {
-        writeJsonFile(opencodeConfigPath, nextOpencodeConfig);
-        console.log(`  ${opencodeConfigExists ? c.updated("Updated:") : c.created("Created:")} .opencode/opencode.json`);
-    }
-    else if (JSON.stringify(readJsonObject(opencodeConfigPath)) !== JSON.stringify(nextOpencodeConfig)) {
-        writeJsonFile(opencodeConfigPath, nextOpencodeConfig);
-        console.log(`  ${c.updated("Updated:")}  .opencode/opencode.json`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/opencode.json`);
-    }
-    const pluginEntryExists = existsSync(pluginEntryPath);
-    const pluginEntryContent = generateWorkspacePluginFile(packageMetadata.name);
-    if (!pluginEntryExists || options.force) {
-        writeFileSync(pluginEntryPath, pluginEntryContent, "utf-8");
-        console.log(`  ${pluginEntryExists ? c.updated("Updated:") : c.created("Created:")} .opencode/plugins/rag-plugin.js`);
-    }
-    else if (readFileSync(pluginEntryPath, "utf-8") !== pluginEntryContent) {
-        writeFileSync(pluginEntryPath, pluginEntryContent, "utf-8");
-        console.log(`  ${c.updated("Updated:")}  .opencode/plugins/rag-plugin.js`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/plugins/rag-plugin.js`);
-    }
-    const tuiPluginEntryExists = existsSync(tuiPluginEntryPath);
-    const tuiPluginEntryContent = generateWorkspaceTuiPluginFile(packageMetadata.name);
-    if (!tuiPluginEntryExists || options.force) {
-        writeFileSync(tuiPluginEntryPath, tuiPluginEntryContent, "utf-8");
-        console.log(`  ${tuiPluginEntryExists ? c.updated("Updated:") : c.created("Created:")} .opencode/plugins/rag-tui.js`);
-    }
-    else if (readFileSync(tuiPluginEntryPath, "utf-8") !== tuiPluginEntryContent) {
-        writeFileSync(tuiPluginEntryPath, tuiPluginEntryContent, "utf-8");
-        console.log(`  ${c.updated("Updated:")}  .opencode/plugins/rag-tui.js`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/plugins/rag-tui.js`);
-    }
-    const tuiConfigExists = existsSync(tuiConfigPath);
-    const nextTuiConfig = { plugin: ["./plugins/rag-tui.js"] };
-    if (!tuiConfigExists || options.force) {
-        writeJsonFile(tuiConfigPath, nextTuiConfig);
-        console.log(`  ${tuiConfigExists ? c.updated("Updated:") : c.created("Created:")} .opencode/tui.json`);
-    }
-    else if (JSON.stringify(readJsonObject(tuiConfigPath)) !== JSON.stringify(nextTuiConfig)) {
-        writeJsonFile(tuiConfigPath, nextTuiConfig);
-        console.log(`  ${c.updated("Updated:")}  .opencode/tui.json`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/tui.json`);
-    }
-    const skillsDir = path.join(opencodeDir, "skills");
-    const skillDir = path.join(skillsDir, "opencode-rag");
-    const skillPath = path.join(skillDir, "SKILL.md");
-    if (!existsSync(skillDir)) {
-        mkdirSync(skillDir, { recursive: true });
-        console.log(`  ${c.created("Created:")}  .opencode/skills/opencode-rag/`);
-    }
-    const skillContent = generateSkillFile();
-    const skillExists = existsSync(skillPath);
-    if (!skillExists || options.force) {
-        writeFileSync(skillPath, skillContent, "utf-8");
-        console.log(`  ${skillExists ? c.updated("Updated:") : c.created("Created:")} .opencode/skills/opencode-rag/SKILL.md`);
-    }
-    else if (readFileSync(skillPath, "utf-8") !== skillContent) {
-        writeFileSync(skillPath, skillContent, "utf-8");
-        console.log(`  ${c.updated("Updated:")}  .opencode/skills/opencode-rag/SKILL.md`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/skills/opencode-rag/SKILL.md`);
-    }
-    const workspacePackageExists = existsSync(opencodePackagePath);
-    const nextWorkspacePackage = buildWorkspacePackageJson(readJsonObject(opencodePackagePath), packageMetadata, opencodeDir);
-    if (!workspacePackageExists || options.force) {
-        writeJsonFile(opencodePackagePath, nextWorkspacePackage);
-        console.log(`  ${workspacePackageExists ? c.updated("Updated:") : c.created("Created:")} .opencode/package.json`);
-    }
-    else if (JSON.stringify(readJsonObject(opencodePackagePath)) !== JSON.stringify(nextWorkspacePackage)) {
-        writeJsonFile(opencodePackagePath, nextWorkspacePackage);
-        console.log(`  ${c.updated("Updated:")}  .opencode/package.json`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   .opencode/package.json`);
-    }
-    const configExists = existsSync(configPath);
-    if (!configExists || options.force) {
-        writeFileSync(configPath, generateDefaultConfigJson(), "utf-8");
-        console.log(`  ${configExists ? c.updated("Updated:") : c.created("Created:")} opencode-rag.json`);
-    }
-    else {
-        console.log(`  ${c.exists("Exists:")}   opencode-rag.json`);
-    }
-    // ── Provider health check ──────────────────────────────────
-    if (!options.skipHealthCheck) {
-        console.log(`\n${c.heading("Checking provider connectivity...")}\n`);
-        const logFilePath = path.resolve(cwd, ".opencode", "opencode-rag.log");
-        const ragConfig = loadConfig(configPath);
-        const results = await checkProviderHealth(ragConfig);
-        for (const r of results) {
-            const icon = r.status === "ok" ? c.success("✓") : r.status === "missing" ? c.warn("○") : c.error("✗");
-            const typeLabel = r.type === "image_description" ? "image description" : r.type;
-            const label = `${typeLabel} model`;
-            console.log(`  ${icon} ${c.value(r.model)} (${r.provider}) — ${label}: ${r.status}`);
-            if (r.error)
-                console.log(`    ${c.dim(r.error)}`);
-        }
-        const missingOllama = results.filter((r) => r.status === "missing" && r.provider === "ollama");
-        if (missingOllama.length > 0) {
-            const pullEntries = missingOllama.map((r) => {
-                if (r.type === "embedding") {
-                    return { model: r.model, baseUrl: ragConfig.embedding.baseUrl, proxy: ragConfig.embedding.proxy };
-                }
-                if (r.type === "description" && ragConfig.description) {
-                    return { model: r.model, baseUrl: ragConfig.description.baseUrl, proxy: ragConfig.description.proxy };
-                }
-                if (r.type === "image_description" && ragConfig.imageDescription) {
-                    return { model: r.model, baseUrl: ragConfig.imageDescription.baseUrl, proxy: ragConfig.imageDescription.proxy };
-                }
-                return { model: r.model, baseUrl: ragConfig.embedding.baseUrl, proxy: ragConfig.embedding.proxy };
-            });
-            console.log(`\n  ${c.warn("Models not found:")} ${pullEntries.map((e) => e.model).join(", ")}`);
-            const readline = await import("node:readline");
-            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-            const answer = await new Promise((resolve) => {
-                rl.question(`  Pull ${pullEntries.length === 1 ? "this model" : "these models"} now? (y/n) `, resolve);
-            });
-            rl.close();
-            if (answer.toLowerCase() === "y" || answer.toLowerCase() === "yes") {
-                console.log();
-                try {
-                    await pullOllamaModels(pullEntries, (model, line) => {
-                        console.log(`  ${c.value(model)}: ${line}`);
-                    });
-                    console.log(`\n  ${c.success("Models pulled successfully.")}`);
-                }
-                catch (err) {
-                    console.error(`\n  ${c.error("Pull failed:")} ${err.message}`);
-                    console.log(`  ${c.dim("Pull manually with: ollama pull <model>")}`);
-                }
-            }
-            else {
-                console.log(`  ${c.dim("Skipped. Pull manually with: ollama pull <model>")}`);
-            }
-        }
-        const hasErrors = results.some((r) => r.status === "error");
-        if (hasErrors) {
-            console.log(`\n  ${c.warn("Some providers are not reachable.")} Check configuration and network, then run ${c.file("'opencode-rag index'")}.`);
-        }
-    }
-    if (!options.skipInstall) {
-        console.log(`\n${c.heading("Installing workspace-local plugin dependencies...")}\n`);
-        installWorkspaceDependencies(opencodeDir);
-        console.log(`\n  ${c.success("Installed:")} .opencode/node_modules/`);
-        const updatedGlobalConfigs = removeStaleGlobalPluginRegistrations(os.homedir(), packageMetadata.name);
-        if (updatedGlobalConfigs.length > 0) {
-            for (const configPath of updatedGlobalConfigs) {
-                console.log(`  ${c.warn("Removed stale plugin registration from")} ${configPath}`);
-            }
-        }
-        console.log(`  ${c.dim("OpenCode loads the plugin from .opencode/plugins/rag-plugin.js; no global plugin registration is required.")}`);
-    }
-    else {
-        console.log(`\n  ${c.exists("Skipped:")}   dependency installation (--skip-install)`);
-    }
-    console.log(`\n${c.success("Done.")} Restart OpenCode if it is running, then run ${c.file("'opencode-rag index'")} in this workspace.`);
-});
 /**
- * Determine whether the CLI should auto-run for the current module.
- * Resolves the first argv entry so symlinked binaries compare against the
- * real file path, and returns false if the path cannot be resolved.
+ * Backwards-compatibility shim — re-exports the public API from the new
+ * `cli/` module tree so existing tests and external consumers that import
+ * from `../cli.js` continue to work unchanged.
+ *
+ * The actual CLI entry point is now `cli/index.ts` (compiled to `dist/cli/index.js`).
  */
-function dedupeResults(results) {
-    const seen = new Set();
-    const deduped = [];
-    for (const result of results) {
-        const chunk = result.chunk;
-        const key = [
-            chunk.metadata.filePath,
-            chunk.metadata.startLine,
-            chunk.metadata.endLine,
-            chunk.content,
-        ].join(":");
-        if (seen.has(key))
-            continue;
-        seen.add(key);
-        deduped.push(result);
-    }
-    return deduped;
-}
-export function shouldAutoRunCli(moduleUrl, argv1) {
-    if (!argv1) {
-        return false;
-    }
-    try {
-        const resolvedPath = realpathSync(argv1).replace(/\\/g, "/");
-        const normalizedUrl = moduleUrl.replace(/\\/g, "/");
-        return normalizedUrl === `file://${resolvedPath}` || normalizedUrl.endsWith(`/${resolvedPath}`) || normalizedUrl.includes(resolvedPath);
-    }
-    catch {
-        return false;
-    }
-}
-if (shouldAutoRunCli(import.meta.url, process.argv[1])) {
-    void program.parseAsync(process.argv);
-}
-else {
-    // Fallback: if the module appears to be running as a CLI (has argv with commands like 'init', 'index', etc.)
-    // and not being imported as a library, parse the arguments anyway
-    const commands = ['init', 'index', 'query', 'clear', 'status', 'list', 'show', 'dump', 'ui', 'mcp', 'update', 'eval:sessions', 'eval:analyze', 'eval:compare'];
-    const cmd = process.argv[2];
-    if (process.argv.length > 2 && cmd && commands.includes(cmd.toLowerCase())) {
-        void program.parseAsync(process.argv);
-    }
-}
-export async function runCli(argv = process.argv) {
-    await program.parseAsync(argv);
-}
+/** Main CLI runner and auto-launch detection. */
+export { runCli, shouldAutoRunCli } from "./cli/index.js";
+/** Cleanup helper that removes stale global plugin registration symlinks. */
+export { removeStaleGlobalPluginRegistrations } from "./cli/commands/init-helpers.js";
 //# sourceMappingURL=cli.js.map