opencode-rag-plugin 1.12.17 → 1.14.6

package/dist/cli/commands/status.js

@@ -0,0 +1,104 @@
+/**
+ * `status` command — shows index statistics, store health, and configuration summary.
+ */
+import path from "node:path";
+import fs from "node:fs";
+import { c, resolveCliContext, cleanupContext, logCliError, logCliInfo, formatTimestamp } from "../format.js";
+import { getIndexStatusSummary } from "../../indexer.js";
+/**
+ * Check for a stale index.lock file and clean it up if the owning process is dead.
+ *
+ * An `index.lock` file is created by `runIndexPass` to prevent concurrent index
+ * operations. If the process that created it has terminated (e.g. crash, Ctrl+C),
+ * the lock becomes stale and must be removed before any new index pass can start.
+ * This function also warns the user when a live index pass is detected.
+ *
+ * @param storePath - Path to the vector store directory.
+ * @param logFilePath - Path to the debug log file for status output.
+ */
+function checkStaleLock(storePath, logFilePath) {
+    const lockPath = path.join(storePath, "index.lock");
+    if (!fs.existsSync(lockPath))
+        return;
+    try {
+        const raw = fs.readFileSync(lockPath, "utf-8");
+        const lock = JSON.parse(raw);
+        if (lock.pid) {
+            try {
+                // Signal 0 tests whether the process exists without actually sending a signal.
+                process.kill(lock.pid, 0);
+                logCliInfo(logFilePath, "status", `\n${c.warn("⚠")} Index lock is held by running process ${c.num(lock.pid)} — status may be stale until it completes.`);
+                return;
+            }
+            catch {
+                // Process is dead — lock is stale
+            }
+        }
+        logCliInfo(logFilePath, "status", `\n${c.warn("⚠")} Stale index.lock found (PID ${lock.pid ?? "unknown"} is no longer running) — removing it.`);
+        fs.unlinkSync(lockPath);
+    }
+    catch {
+        // Can't read or parse the lock file — not our concern, ignore silently
+    }
+}
+/**
+ * Register the `status` command on the given Commander program.
+ *
+ * Displays a comprehensive overview of the current index: chunk counts,
+ * store path, embedding provider/model, file extensions, manifest status,
+ * keyword index state, and whether a rebuild is required.
+ *
+ * @param program - The Commander `Command` instance to register on.
+ */
+export function registerStatusCommand(program) {
+    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, { skipProbe: true, skipKeywordIndex: true });
+            const { config, store, storePath, keywordIndex } = ctx;
+            logFilePath = ctx.logFilePath;
+            checkStaleLock(storePath, logFilePath);
+            const count = await store.count();
+            const summary = await getIndexStatusSummary(cwd, storePath, config, store, true);
+            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);
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,CAAC,EAAE,iBAAiB,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAGzD;;;;;;;;;;GAUG;AACH,SAAS,cAAc,CAAC,SAAiB,EAAE,WAAmB;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACpD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO;IAErC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAyC,CAAC;QAErE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACb,IAAI,CAAC;gBACH,+EAA+E;gBAC/E,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBAC1B,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;gBACzJ,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;QACH,CAAC;QAED,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,GAAG,IAAI,SAAS,uCAAuC,CAAC,CAAC;QAChJ,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,sBAAsB,CAAC;SACnC,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,OAAmB,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;YACrE,MAAM,GAAG,GAAG,MAAM,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;YACvG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;YACvD,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YAE9B,cAAc,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YAEvC,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;YAClC,MAAM,OAAO,GAAG,MAAM,qBAAqB,CACzC,GAAG,EACH,SAAS,EACT,MAAM,EACN,KAAK,EACL,IAAI,CACL,CAAC;YAEF,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1F,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;YAC3F,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC7G,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtH,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChH,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACtG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACvI,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;YAChG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACxG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;YACzH,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;YACtG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YACrG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;YACxG,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;YAC/G,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACtF,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO;gBACpD,CAAC,CAAC,YAAY,EAAE,KAAK,EAAE,IAAI,CAAC;gBAC5B,CAAC,CAAC,CAAC,CAAC;YACN,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,QAAQ,MAAM,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3L,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACpH,CAAC;YACD,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,IAAI,OAAO,CAAC,sBAAsB,GAAG,CAAC,IAAI,OAAO,CAAC,eAAe,GAAG,OAAO,CAAC,sBAAsB,GAAG,GAAG,EAAE,CAAC;gBACxI,UAAU,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;YACvK,CAAC;YACD,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAI,GAAa,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;YACtD,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,kBAAkB,CAAC,CAAC;YACjF,WAAW,CAAC,WAAW,EAAE,QAAQ,EAAE,0BAA0B,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;YAC7E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,14 @@
+/**
+ * `ui` command — starts a local web UI for browsing the vector database.
+ */
+import type { Command } from "commander";
+/**
+ * Register the `ui` command on the given Commander program.
+ *
+ * Starts an HTTP server on localhost that serves a single-page dashboard
+ * for browsing indexed chunks, files, and running searches. Optionally
+ * opens the system browser automatically.
+ *
+ * @param program - The Commander `Command` instance to register on.
+ */
+export declare function registerUiCommand(program: Command): void;

package/dist/cli/commands/ui.js

@@ -0,0 +1,69 @@
+/**
+ * `ui` command — starts a local web UI for browsing the vector database.
+ */
+import path from "node:path";
+import { c, resolveCliContext, logCliError, logCliInfo } from "../format.js";
+/**
+ * Register the `ui` command on the given Commander program.
+ *
+ * Starts an HTTP server on localhost that serves a single-page dashboard
+ * for browsing indexed chunks, files, and running searches. Optionally
+ * opens the system browser automatically.
+ *
+ * @param program - The Commander `Command` instance to register on.
+ */
+export function registerUiCommand(program) {
+    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);
+        }
+    });
+}
+//# sourceMappingURL=ui.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * `update` command — checks for and installs OpenCodeRAG updates from GitHub.
+ */
+import type { Command } from "commander";
+/**
+ * Register the `update` command on the given Commander program.
+ *
+ * Checks the GitHub repository for a newer release, displays the current
+ * and latest versions, and optionally applies the update by pulling
+ * the latest code and rebuilding.
+ *
+ * @param program - The Commander `Command` instance to register on.
+ */
+export declare function registerUpdateCommand(program: Command): void;

package/dist/cli/commands/update.js

@@ -0,0 +1,76 @@
+/**
+ * `update` command — checks for and installs OpenCodeRAG updates from GitHub.
+ */
+import path from "node:path";
+import { getCurrentVersion, checkForUpdate, applyUpdate } from "../../updater.js";
+import { c } from "../format.js";
+import { getPackageRoot } from "../helpers.js";
+/**
+ * Register the `update` command on the given Commander program.
+ *
+ * Checks the GitHub repository for a newer release, displays the current
+ * and latest versions, and optionally applies the update by pulling
+ * the latest code and rebuilding.
+ *
+ * @param program - The Commander `Command` instance to register on.
+ */
+export function registerUpdateCommand(program) {
+    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);
+        }
+    });
+}
+//# sourceMappingURL=update.js.map

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

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

package/dist/cli/format.d.ts

@@ -0,0 +1,112 @@
+/**
+ * CLI formatting helpers — color palette, logging utilities, context resolution,
+ * and result formatting functions shared across all CLI command modules.
+ */
+import { type BootstrapOptions, type RagContext } from "../core/bootstrap.js";
+import type { SearchResult } from "../core/interfaces.js";
+import type { IndexRunStats } from "../indexer.js";
+import type { CliOptions } from "./types.js";
+/**
+ * Semantic color helpers for consistent CLI output styling.
+ *
+ * Each property wraps a {@link picocolors} function to provide semantic naming
+ * (e.g. `c.file` for file paths, `c.error` for errors) so that color choices
+ * can be changed in one place without updating every call site.
+ */
+export declare const c: {
+    /** Bold cyan — used for section headings. */
+    heading: (s: string) => string;
+    /** Dim text — used for labels and secondary information. */
+    label: (s: string) => string;
+    /** Dim text — alias for `label`, used for inline dimming. */
+    dim: (s: string) => string;
+    /** Green text — used for positive values and success states. */
+    value: (s: string) => string;
+    /** Green text — formats numbers as strings for inline display. */
+    num: (s: string | number) => string;
+    /** Yellow text — used for file paths. */
+    file: (s: string) => string;
+    /** Cyan text — used for language names and matched terms. */
+    lang: (s: string) => string;
+    /** Magenta text — used for relevance scores. */
+    score: (s: string) => string;
+    /** Dim text — used for chunk descriptions. */
+    desc: (s: string) => string;
+    /** Green text — used for success messages. */
+    success: (s: string) => string;
+    /** Yellow text — used for warnings. */
+    warn: (s: string) => string;
+    /** Red text — used for error messages. */
+    error: (s: string) => string;
+    /** Green text — used for "enabled" status indicators. */
+    enabled: (s: string) => string;
+    /** Yellow text — used for "disabled" status indicators. */
+    disabled: (s: string) => string;
+    /** Green text — used for "created" file status. */
+    created: (s: string) => string;
+    /** Yellow text — used for "updated" file status. */
+    updated: (s: string) => string;
+    /** Dim text — used for "already exists" file status. */
+    exists: (s: string) => string;
+};
+/**
+ * Log an error message to stderr and optionally append to the debug log.
+ *
+ * @param logFilePath - Absolute path to the debug log file.
+ * @param scope - Logical scope (e.g. "index", "query") for log filtering.
+ * @param message - Human-readable error message.
+ * @param error - Optional error object for structured logging.
+ */
+export declare function logCliError(_logFilePath: string, _scope: string, message: string, _error: unknown): void;
+/**
+ * Log an informational message to stdout and optionally append to the debug log.
+ *
+ * @param logFilePath - Absolute path to the debug log file.
+ * @param scope - Logical scope (e.g. "index", "query") for log filtering.
+ * @param message - Human-readable info message.
+ */
+export declare function logCliInfo(_logFilePath: string, _scope: string, message: string): void;
+/**
+ * Resolve a full `RagContext` from CLI options and log the config details.
+ *
+ * Wraps `resolveRagContext` from the bootstrap module with CLI-specific logging.
+ *
+ * @param opt - Parsed CLI options (may include a `--config` path).
+ * @param logFilePath - Path to the debug log file for config logging.
+ * @returns A fully initialized `RagContext` with store, embedder, and keyword index.
+ */
+export declare function resolveCliContext(opt: CliOptions, logFilePath: string, bootstrapOpts?: Partial<BootstrapOptions>): Promise<RagContext>;
+/**
+ * Gracefully close a `RagContext` — closes the vector store and destroys pooled HTTP connections.
+ *
+ * @param ctx - The `RagContext` to clean up.
+ */
+export declare function cleanupContext(ctx: RagContext): Promise<void>;
+/**
+ * Format a Unix timestamp (milliseconds) into a human-readable locale string.
+ *
+ * @param timestamp - Unix timestamp in milliseconds, or `undefined` for "never".
+ * @returns A localized date string, or `"never"` if the timestamp is falsy.
+ */
+export declare function formatTimestamp(timestamp?: number): string;
+/**
+ * Print an indexing pass summary to stdout.
+ *
+ * @param logFilePath - Path to the debug log file.
+ * @param stats - Statistics from a single indexing pass.
+ */
+export declare function logIndexSummary(logFilePath: string, stats: IndexRunStats): void;
+/**
+ * Format a millisecond duration into a compact human-readable string.
+ *
+ * @param ms - Duration in milliseconds.
+ * @returns A string like `"3.2s"` or `"2m 15s"`.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Remove duplicate search results based on file path, line range, and content.
+ *
+ * @param results - Raw search results that may contain duplicates.
+ * @returns Deduplicated search results preserving original order.
+ */
+export declare function dedupeResults(results: SearchResult[]): SearchResult[];

package/dist/cli/format.js

@@ -0,0 +1,184 @@
+/**
+ * CLI formatting helpers — color palette, logging utilities, context resolution,
+ * and result formatting functions shared across all CLI command modules.
+ */
+import pc from "picocolors";
+import { resolveRagContext } from "../core/bootstrap.js";
+import { destroyAllPooledConnections } from "../embedder/http.js";
+// ── Color palette ───────────────────────────────────────────────
+/**
+ * Semantic color helpers for consistent CLI output styling.
+ *
+ * Each property wraps a {@link picocolors} function to provide semantic naming
+ * (e.g. `c.file` for file paths, `c.error` for errors) so that color choices
+ * can be changed in one place without updating every call site.
+ */
+export const c = {
+    /** Bold cyan — used for section headings. */
+    heading: (s) => pc.bold(pc.cyan(s)),
+    /** Dim text — used for labels and secondary information. */
+    label: (s) => pc.dim(s),
+    /** Dim text — alias for `label`, used for inline dimming. */
+    dim: (s) => pc.dim(s),
+    /** Green text — used for positive values and success states. */
+    value: (s) => pc.green(s),
+    /** Green text — formats numbers as strings for inline display. */
+    num: (s) => pc.green(String(s)),
+    /** Yellow text — used for file paths. */
+    file: (s) => pc.yellow(s),
+    /** Cyan text — used for language names and matched terms. */
+    lang: (s) => pc.cyan(s),
+    /** Magenta text — used for relevance scores. */
+    score: (s) => pc.magenta(s),
+    /** Dim text — used for chunk descriptions. */
+    desc: (s) => pc.dim(s),
+    /** Green text — used for success messages. */
+    success: (s) => pc.green(s),
+    /** Yellow text — used for warnings. */
+    warn: (s) => pc.yellow(s),
+    /** Red text — used for error messages. */
+    error: (s) => pc.red(s),
+    /** Green text — used for "enabled" status indicators. */
+    enabled: (s) => pc.green(s),
+    /** Yellow text — used for "disabled" status indicators. */
+    disabled: (s) => pc.yellow(s),
+    /** Green text — used for "created" file status. */
+    created: (s) => pc.green(s),
+    /** Yellow text — used for "updated" file status. */
+    updated: (s) => pc.yellow(s),
+    /** Dim text — used for "already exists" file status. */
+    exists: (s) => pc.dim(s),
+};
+// ── Logging helpers ─────────────────────────────────────────────
+/**
+ * Log an error message to stderr and optionally append to the debug log.
+ *
+ * @param logFilePath - Absolute path to the debug log file.
+ * @param scope - Logical scope (e.g. "index", "query") for log filtering.
+ * @param message - Human-readable error message.
+ * @param error - Optional error object for structured logging.
+ */
+export function logCliError(_logFilePath, _scope, message, _error) {
+    console.error(c.error(message));
+    //appendDebugLog(logFilePath, { scope, message, error });
+}
+/**
+ * Log an informational message to stdout and optionally append to the debug log.
+ *
+ * @param logFilePath - Absolute path to the debug log file.
+ * @param scope - Logical scope (e.g. "index", "query") for log filtering.
+ * @param message - Human-readable info message.
+ */
+export function logCliInfo(_logFilePath, _scope, message) {
+    console.log(message);
+    //appendDebugLog(logFilePath, { scope, message });
+}
+// ── Context resolution ──────────────────────────────────────────
+/**
+ * Resolve a full `RagContext` from CLI options and log the config details.
+ *
+ * Wraps `resolveRagContext` from the bootstrap module with CLI-specific logging.
+ *
+ * @param opt - Parsed CLI options (may include a `--config` path).
+ * @param logFilePath - Path to the debug log file for config logging.
+ * @returns A fully initialized `RagContext` with store, embedder, and keyword index.
+ */
+export async function resolveCliContext(opt, logFilePath, bootstrapOpts) {
+    const ctx = await resolveRagContext({
+        configPath: opt.config,
+        ...bootstrapOpts,
+    });
+    logCliInfo(logFilePath, "config", `${c.label("Config:")} ${c.file(ctx.logFilePath)}`);
+    logConfigDetails(logFilePath, ctx.config);
+    return ctx;
+}
+/**
+ * Print embedding and vector store configuration to stdout.
+ *
+ * @param logFilePath - Path to the debug log file.
+ * @param config - The resolved `RagConfig` to display.
+ */
+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)}`);
+}
+/**
+ * Gracefully close a `RagContext` — closes the vector store and destroys pooled HTTP connections.
+ *
+ * @param ctx - The `RagContext` to clean up.
+ */
+export async function cleanupContext(ctx) {
+    await ctx.store.close();
+    destroyAllPooledConnections();
+}
+// ── Formatting helpers ──────────────────────────────────────────
+/**
+ * Format a Unix timestamp (milliseconds) into a human-readable locale string.
+ *
+ * @param timestamp - Unix timestamp in milliseconds, or `undefined` for "never".
+ * @returns A localized date string, or `"never"` if the timestamp is falsy.
+ */
+export function formatTimestamp(timestamp) {
+    if (!timestamp)
+        return "never";
+    return new Date(timestamp).toLocaleString();
+}
+/**
+ * Print an indexing pass summary to stdout.
+ *
+ * @param logFilePath - Path to the debug log file.
+ * @param stats - Statistics from a single indexing pass.
+ */
+export 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)}`);
+    if (stats.descriptionFailedFiles > 0) {
+        logCliInfo(logFilePath, "index", `  ${c.label("Desc failed:")}     ${c.num(stats.descriptionFailedFiles)}`);
+    }
+    logCliInfo(logFilePath, "index", `  ${c.label("Chunks written:")}   ${c.num(stats.totalChunks)}`);
+}
+/**
+ * Format a millisecond duration into a compact human-readable string.
+ *
+ * @param ms - Duration in milliseconds.
+ * @returns A string like `"3.2s"` or `"2m 15s"`.
+ */
+export 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`;
+}
+/**
+ * Remove duplicate search results based on file path, line range, and content.
+ *
+ * @param results - Raw search results that may contain duplicates.
+ * @returns Deduplicated search results preserving original order.
+ */
+export 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;
+}
+//# sourceMappingURL=format.js.map

package/dist/cli/format.js.map

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