@djolex999/vir-cli 0.14.1 → 0.16.0

package/dist/cli/embedSetup.js

@@ -0,0 +1,62 @@
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { stdin, stdout } from "node:process";
+import { createInterface } from "node:readline/promises";
+import { LOCAL_PROVIDER_DIR, LocalProvider, buildSetupPlan, isLocalProviderInstalled, } from "../search/localProvider.js";
+import * as ui from "../ui/display.js";
+// `vir embed --setup`: the one-command activation path for semantic search
+// without Ollama. States the disk cost and waits for consent BEFORE touching
+// disk or network; --yes skips the prompt, never the cost statement.
+export async function runEmbedSetup(yes) {
+    ui.header("embed --setup");
+    ui.blank();
+    const plan = buildSetupPlan(isLocalProviderInstalled(), false);
+    for (const l of plan.lines)
+        ui.line(ui.text(l));
+    ui.blank();
+    if (!yes) {
+        const rl = createInterface({ input: stdin, output: stdout });
+        const answer = (await rl.question("Proceed? [y/N] ")).trim().toLowerCase();
+        rl.close();
+        if (answer !== "y" && answer !== "yes") {
+            ui.line(ui.dim("aborted — nothing was installed"));
+            return;
+        }
+    }
+    if (plan.needsInstall) {
+        mkdirSync(LOCAL_PROVIDER_DIR, { recursive: true });
+        const pkgPath = join(LOCAL_PROVIDER_DIR, "package.json");
+        if (!existsSync(pkgPath)) {
+            writeFileSync(pkgPath, `${JSON.stringify({ name: "vir-embedder", private: true }, null, 2)}\n`);
+        }
+        ui.line(ui.dim("installing fastembed (npm output follows)…"));
+        const res = spawnSync("npm", [
+            "install",
+            "fastembed@^2",
+            "--prefix",
+            LOCAL_PROVIDER_DIR,
+            "--no-fund",
+            "--no-audit",
+        ], { stdio: "inherit" });
+        if (res.error && res.error.code === "ENOENT") {
+            ui.row(ui.errorColor(ui.CROSS), ui.text("npm not found on PATH"));
+            ui.line(ui.dim("install Node.js/npm, then re-run vir embed --setup"));
+            process.exitCode = 1;
+            return;
+        }
+        if (res.status !== 0) {
+            ui.row(ui.errorColor(ui.CROSS), ui.text("npm install failed — see output above"));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    ui.line(ui.dim("downloading the model and warming up (first embed)…"));
+    const t0 = Date.now();
+    const provider = new LocalProvider();
+    await provider.embedDoc("vir local embedding setup probe");
+    const secs = Math.round((Date.now() - t0) / 1000);
+    ui.row(ui.success(ui.CHECK), ui.text(`local provider ready: ${provider.modelName}, ${provider.dimensions}d (${secs}s)`));
+    ui.line(ui.dim("vir uses it automatically when Ollama is not running; `vir embed` backfills notes."));
+}
+//# sourceMappingURL=embedSetup.js.map

package/dist/cli/embedSetup.js.map

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

package/dist/cli/queries.js

@@ -0,0 +1,44 @@
+// Below this many logged queries, "never surfaced" is dominated by "never
+// asked about" — a handful of queries can only touch a handful of notes, so
+// presenting the rest as dead weight is noise dressed as signal. 20 queries
+// at topK 5–8 give every genuinely useful note ~100+ chances to surface.
+export const MIN_DEAD_WEIGHT_SAMPLE = 20;
+export function buildQueriesReport(records, allSlugs, topN = 10) {
+    const surfaced = new Map();
+    let embedding = 0;
+    let tfidf = 0;
+    let degraded = 0;
+    for (const r of records) {
+        if (r.method === "embedding")
+            embedding += 1;
+        else
+            tfidf += 1;
+        if (r.degraded)
+            degraded += 1;
+        for (const h of r.hits) {
+            const s = surfaced.get(h.slug) ?? { count: 0, rankSum: 0 };
+            s.count += 1;
+            s.rankSum += h.rank;
+            surfaced.set(h.slug, s);
+        }
+    }
+    const topNotes = [...surfaced.entries()]
+        .map(([slug, s]) => ({
+        slug,
+        count: s.count,
+        avgRank: Math.round((s.rankSum / s.count) * 100) / 100,
+    }))
+        .sort((a, b) => b.count - a.count || a.avgRank - b.avgRank)
+        .slice(0, topN);
+    return {
+        total: records.length,
+        byMethod: { embedding, tfidf },
+        degraded,
+        degradedRate: records.length === 0 ? 0 : degraded / records.length,
+        topNotes,
+        deadWeight: records.length < MIN_DEAD_WEIGHT_SAMPLE
+            ? null
+            : allSlugs.filter((s) => !surfaced.has(s)),
+    };
+}
+//# sourceMappingURL=queries.js.map

package/dist/cli/queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/cli/queries.ts"],"names":[],"mappings":"AAEA,0EAA0E;AAC1E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAczC,MAAM,UAAU,kBAAkB,CAChC,OAAyB,EACzB,QAAkB,EAClB,IAAI,GAAG,EAAE;IAET,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA8C,CAAC;IACvE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS,IAAI,CAAC,CAAC;;YACxC,KAAK,IAAI,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,QAAQ;YAAE,QAAQ,IAAI,CAAC,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACvB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YAC3D,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;YACb,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC;YACpB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnB,IAAI;QACJ,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG;KACvD,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SAC1D,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IAElB,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,MAAM;QACrB,QAAQ,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE;QAC9B,QAAQ;QACR,YAAY,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM;QAClE,QAAQ;QACR,UAAU,EACR,OAAO,CAAC,MAAM,GAAG,sBAAsB;YACrC,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC"}

package/dist/cli.js

@@ -29,9 +29,11 @@ import { composeFromSources, estimateComposeCostTokens, gatherSources, } from ".
 import { computeCost } from "./cost/pricing.js";
 import { countByCategory, summarizeAll, summarizeProject, } from "./pipeline/summarizer.js";
 import { buildPeriodPrompt, estimatePeriodCostTokens, periodLabel, periodRange, selectNotesInPeriod, summarizePeriod, } from "./pipeline/periodSummary.js";
-import { embeddingForNote, isOllamaAvailable, } from "./search/embedder.js";
+import { embedNoteWithProvider, resolveEmbeddingProvider, } from "./search/provider.js";
 import { acquireLock, LockHeldError, releaseLock } from "./pipeline/lock.js";
-import { search, searchWithOutcome, vaultRoot } from "./search/retriever.js";
+import { loadIndex, searchWithOutcome, vaultRoot } from "./search/retriever.js";
+import { QUERY_LOG_PATH, readQueryLog, recordQueryEvent, } from "./search/queryLog.js";
+import { MIN_DEAD_WEIGHT_SAMPLE, buildQueriesReport } from "./cli/queries.js";
 import { buildQueryResults, errorPayload } from "./output/json.js";
 import { synthesize } from "./search/synthesizer.js";
 import { runMcpServer } from "./mcp/server.js";
@@ -39,6 +41,7 @@ import { runReview } from "./cli/review.js";
 import { runAction } from "./cli/runAction.js";
 import { buildInitConfig } from "./cli/initConfig.js";
 import { runReconcile } from "./cli/reconcile.js";
+import { runEmbedSetup } from "./cli/embedSetup.js";
 import { installToClaudeCode, isClaudeAvailable, isInstalled, uninstallFromClaudeCode, } from "./mcp/install.js";
 import { install as installDaemon, status as daemonStatus, uninstall as uninstallDaemon, } from "./daemon/index.js";
 import { StateDb } from "./state/db.js";
@@ -216,6 +219,54 @@ program
         ui.line(`  ${ui.dim(ui.BULLET)} ${ui.text(label.padEnd(42))} ${ui.dim(`${s.calls}×`)}  ${ui.warn(ui.formatUsd(s.cost))}`);
     }
 }));
+program
+    .command("queries")
+    .description("Report on logged retrievals from ~/.vir/queries.jsonl")
+    .option("--json", "Emit the full report as JSON for scripting")
+    .option("--top <n>", "How many top-surfaced notes to show (default 10)", "10")
+    .action(runAction(async (opts) => {
+    const cfg = loadConfig();
+    const topN = Math.max(1, Number(opts.top ?? "10") || 10);
+    const records = readQueryLog();
+    // loadIndex walks exactly the retrievable notes (skips summaries/,
+    // .rejected/, archived/, index/log) — the honest denominator for
+    // dead weight.
+    const allSlugs = loadIndex(cfg).map((d) => d.relPath.replace(/\.md$/, ""));
+    const report = buildQueriesReport(records, allSlugs, topN);
+    if (opts.json) {
+        // NOT a plugin contract — scripting output like `vir projects --json`.
+        process.stdout.write(JSON.stringify(report) + "\n");
+        return;
+    }
+    ui.header("queries");
+    ui.blank();
+    if (report.total === 0) {
+        ui.row(ui.warn(ui.WARN_GLYPH), ui.text("no logged queries yet"));
+        ui.line(ui.dim(`  ${QUERY_LOG_PATH} fills as you run \`vir query\` or use the MCP tools`));
+        return;
+    }
+    ui.stat("queries", report.total);
+    ui.stat("method", `${report.byMethod.embedding} embedding · ${report.byMethod.tfidf} tfidf`);
+    ui.stat("degraded", `${report.degraded} (${Math.round(report.degradedRate * 100)}%)`, report.degraded > 0 ? ui.warn : undefined);
+    ui.blank();
+    ui.line(ui.dim(`  top ${Math.min(topN, report.topNotes.length)} surfaced notes`));
+    for (const n of report.topNotes) {
+        ui.line(`  ${ui.dim(ui.BULLET)} ${ui.text(n.slug.padEnd(52))} ${ui.dim(`${n.count}× · avg rank ${n.avgRank}`)}`);
+    }
+    ui.blank();
+    if (report.deadWeight === null) {
+        ui.line(ui.dim(`  dead weight: suppressed — ${report.total} quer${report.total === 1 ? "y" : "ies"} logged, ${MIN_DEAD_WEIGHT_SAMPLE} needed before "never surfaced" means unused rather than unasked`));
+    }
+    else {
+        ui.line(ui.dim(`  dead weight: ${report.deadWeight.length} of ${allSlugs.length} notes never surfaced`));
+        for (const slug of report.deadWeight.slice(0, topN)) {
+            ui.line(`  ${ui.dim(ui.BULLET)} ${ui.muted(slug)}`);
+        }
+        if (report.deadWeight.length > topN) {
+            ui.line(ui.dim(`  … ${report.deadWeight.length - topN} more (\`vir queries --json\` for all)`));
+        }
+    }
+}));
 program
     .command("calibrate <sessionId>")
     .description("Distill ONE session to stdout for A/B model comparison — never writes vault or DB")
@@ -643,25 +694,64 @@ program
 }));
 program
     .command("embed")
-    .description("Generate Ollama embeddings for distilled notes")
+    .description("Generate embeddings for distilled notes")
     .option("--force", "Regenerate even if embedding already exists")
+    .option("--setup", "Install the local embedding provider (fastembed + bge-small) on demand")
+    .option("--yes", "Skip the --setup disk-cost confirmation")
     .action(runAction(async (opts) => {
+    if (opts.setup) {
+        await runEmbedSetup(opts.yes === true);
+        return;
+    }
     const cfg = loadConfig();
     ui.header("embed");
     ui.blank();
-    if (!(await isOllamaAvailable())) {
-        ui.row(ui.errorColor(ui.CROSS), ui.text("Ollama not running"));
-        ui.line(ui.dim("  brew install ollama"));
-        ui.line(ui.dim("  ollama pull nomic-embed-text"));
-        ui.line(ui.dim("  ollama serve"));
+    const provider = await resolveEmbeddingProvider(cfg.embeddingProvider);
+    if (!provider) {
+        ui.row(ui.errorColor(ui.CROSS), ui.text("no embedding provider available"));
+        ui.line(ui.dim("  vir embed --setup      # local provider, no Ollama needed (~233 MB)"));
+        ui.line(ui.dim("  or: brew install ollama && ollama pull nomic-embed-text && ollama serve"));
         process.exitCode = 1;
         return;
     }
+    const provenance = provider.provenance();
     const db = new StateDb();
     try {
         const rows = db.listDistilled();
         const root = join(cfg.vaultPath, cfg.outputDir);
-        const existing = new Set(db.getEmbeddings(root).map((r) => r.sessionId));
+        const embeddedRows = [
+            ...db.getEmbeddings(root),
+            ...db.getArticleEmbeddings(),
+            ...db.getTopicEmbeddings(root, cfg.topicsDir),
+            ...db.getPdfEmbeddings(),
+        ];
+        // Crossing a model boundary is an index invalidation, not a gap fill —
+        // it needs --force AND explicit consent, with the cost stated first.
+        // Without --force, mismatched rows stay excluded from vector search
+        // (counted, reported) and only NULL-embedding gaps are filled.
+        const mismatched = embeddedRows.filter((r) => r.embeddingModel !== provider.modelName).length;
+        if (mismatched > 0 && !opts.force) {
+            ui.row(ui.warn(ui.WARN_GLYPH), ui.text(`${mismatched} note(s) are embedded under a different model than the active one (${provider.modelName})`));
+            ui.line(ui.dim("they are excluded from vector search until re-embedded"));
+            ui.line(ui.dim("run `vir embed --force` to re-embed the whole index"));
+        }
+        if (mismatched > 0 && opts.force) {
+            const estSecs = Math.max(1, Math.round(rows.length * 0.15));
+            ui.row(ui.warn(ui.WARN_GLYPH), ui.text(`model boundary: re-embedding ${rows.length} note(s) under ${provider.modelName} (~${estSecs}s), replacing vectors from other models`));
+            if (!opts.yes) {
+                const rl = createInterface({ input: stdin, output: stdout });
+                const answer = (await rl.question("Proceed? [y/N] ")).trim().toLowerCase();
+                rl.close();
+                if (answer !== "y" && answer !== "yes") {
+                    ui.line(ui.dim("aborted — index unchanged"));
+                    return;
+                }
+            }
+        }
+        const existing = new Set(db
+            .getEmbeddings(root)
+            .filter((r) => r.embeddingModel === provider.modelName)
+            .map((r) => r.sessionId));
         const target = opts.force
             ? rows
             : rows.filter((r) => !existing.has(r.sessionId));
@@ -702,12 +792,12 @@ program
                 skipped += 1;
                 continue;
             }
-            const vec = await embeddingForNote(r.content);
+            const vec = await embedNoteWithProvider(provider, r.content);
             if (!vec) {
                 errors += 1;
                 continue;
             }
-            db.storeEmbedding(r.sessionId, vec);
+            db.storeEmbedding(r.sessionId, vec, provenance);
             embedded += 1;
             sp.text = ui.dim(`embedding notes (${embedded}/${total})`);
         }
@@ -716,12 +806,12 @@ program
                 skipped += 1;
                 continue;
             }
-            const vec = await embeddingForNote(t.content);
+            const vec = await embedNoteWithProvider(provider, t.content);
             if (!vec) {
                 errors += 1;
                 continue;
             }
-            db.storeTopicEmbedding(t.id, vec);
+            db.storeTopicEmbedding(t.id, vec, provenance);
             embedded += 1;
             sp.text = ui.dim(`embedding notes (${embedded}/${total})`);
         }
@@ -730,12 +820,12 @@ program
                 skipped += 1;
                 continue;
             }
-            const vec = await embeddingForNote(a.content);
+            const vec = await embedNoteWithProvider(provider, a.content);
             if (!vec) {
                 errors += 1;
                 continue;
             }
-            db.storeArticleEmbedding(a.path, vec);
+            db.storeArticleEmbedding(a.path, vec, provenance);
             embedded += 1;
             sp.text = ui.dim(`embedding notes (${embedded}/${total})`);
         }
@@ -744,12 +834,12 @@ program
                 skipped += 1;
                 continue;
             }
-            const vec = await embeddingForNote(p.content);
+            const vec = await embedNoteWithProvider(provider, p.content);
             if (!vec) {
                 errors += 1;
                 continue;
             }
-            db.storePdfEmbedding(p.path, vec);
+            db.storePdfEmbedding(p.path, vec, provenance);
             embedded += 1;
             sp.text = ui.dim(`embedding notes (${embedded}/${total})`);
         }
@@ -792,8 +882,18 @@ async function runQueryJson(question, limit) {
     }
     const db = new StateDb();
     try {
-        const hits = await search(cfg, db, question, limit);
-        const results = buildQueryResults(hits, vaultRoot(cfg), cfg.topicsDir);
+        const t0 = Date.now();
+        const outcome = await searchWithOutcome(cfg, db, question, limit);
+        recordQueryEvent({
+            logQueries: cfg.logQueries,
+            source: "cli",
+            query: question,
+            type: "all",
+            hits: outcome.hits,
+            search: outcome,
+            latencyMs: Date.now() - t0,
+        });
+        const results = buildQueryResults(outcome.hits, vaultRoot(cfg), cfg.topicsDir);
         process.stdout.write(JSON.stringify(results) + "\n");
     }
     catch (err) {
@@ -829,6 +929,7 @@ program
         // served the hits.
         const sp = ui.spinner("searching vault").start();
         let outcome;
+        const t0 = Date.now();
         try {
             outcome = await searchWithOutcome(cfg, db, question, 8);
             sp.stop();
@@ -837,10 +938,28 @@ program
             sp.fail(ui.errorColor(err.message));
             return;
         }
+        recordQueryEvent({
+            logQueries: cfg.logQueries,
+            source: "cli",
+            query: question,
+            type: "all",
+            hits: outcome.hits,
+            search: outcome,
+            latencyMs: Date.now() - t0,
+        });
         const hits = outcome.hits;
         if (outcome.degraded) {
             ui.row(ui.warn(ui.WARN_GLYPH), ui.text(`embedding search failed — results are TF-IDF fallback (${outcome.embedError})`));
         }
+        else if (outcome.noProvider) {
+            // A supported mode with a one-line pointer, not a warning — different
+            // state than a failed provider, different fix.
+            ui.line(ui.dim("no embedding provider — using keyword search"));
+            ui.line(ui.dim("  semantic search: `vir embed --setup` (one command, ~1 min, 233 MB), or install Ollama"));
+        }
+        if (outcome.excludedMismatched > 0) {
+            ui.row(ui.warn(ui.WARN_GLYPH), ui.text(`${outcome.excludedMismatched} note(s) embedded under a different model were excluded — run \`vir embed\` to re-embed them`));
+        }
         if (hits.length === 0) {
             ui.row(ui.warn(ui.WARN_GLYPH), ui.text("no documents matched"));
             return;
@@ -861,7 +980,11 @@ program
         ui.summary({
             sources: { value: relevant.length, color: ui.info },
             via: {
-                value: outcome.degraded ? "tfidf (embeddings failed)" : method,
+                value: outcome.degraded
+                    ? "tfidf (embeddings failed)"
+                    : outcome.noProvider
+                        ? "tfidf (no provider)"
+                        : method,
                 color: outcome.degraded ? ui.warn : ui.accent,
             },
             searched: { value: totalNotes, color: ui.muted },