@djolex999/vir-cli 0.13.0 → 0.14.0

package/dist/cli/initConfig.js

@@ -23,6 +23,10 @@ export function buildInitConfig(existing, a) {
         distillPdfs: existing?.distillPdfs,
         filterToolCalls: existing?.filterToolCalls,
         retrievalDiversity: existing?.retrievalDiversity,
+        projects: { ...existing?.projects, ...a.projects },
+        notifications: existing?.notifications,
+        workflowTranscripts: existing?.workflowTranscripts,
+        agentTranscripts: a.agentTranscripts ?? existing?.agentTranscripts,
         models: {
             classify: a.classifyModel,
             distill: a.distillModel,

package/dist/cli/initConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"initConfig.js","sourceRoot":"","sources":["../../src/cli/initConfig.ts"],"names":[],"mappings":"AAiBA,iEAAiE;AACjE,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAC7B,QAAuB,EACvB,CAAc;IAEd,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;QACtC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,0EAA0E;QAC1E,4EAA4E;QAC5E,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,QAAQ,EAAE,eAAe;QAC/D,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,QAAQ,EAAE,SAAS;QAC7C,YAAY,EAAE,QAAQ,EAAE,YAAY;QACpC,SAAS,EAAE,QAAQ,EAAE,SAAS;QAC9B,OAAO,EAAE,QAAQ,EAAE,OAAO;QAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,eAAe,EAAE,QAAQ,EAAE,eAAe;QAC1C,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,QAAQ,EAAE,WAAW;QAClC,eAAe,EAAE,QAAQ,EAAE,eAAe;QAC1C,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB;QAChD,MAAM,EAAE;YACN,QAAQ,EAAE,CAAC,CAAC,aAAa;YACzB,OAAO,EAAE,CAAC,CAAC,YAAY;YACvB,yEAAyE;YACzE,mEAAmE;YACnE,WAAW,EACT,QAAQ,EAAE,MAAM,EAAE,WAAW;gBAC7B,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW;oBACzB,CAAC,CAAC,2BAA2B;oBAC7B,CAAC,CAAC,kBAAkB,CAAC;YACzB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,IAAI,IAAI;gBAC5C,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"initConfig.js","sourceRoot":"","sources":["../../src/cli/initConfig.ts"],"names":[],"mappings":"AAuBA,iEAAiE;AACjE,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,MAAM,UAAU,eAAe,CAC7B,QAAuB,EACvB,CAAc;IAEd,OAAO;QACL,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,SAAS,EAAE,CAAC,CAAC,SAAS;QACtB,iBAAiB,EAAE,CAAC,CAAC,iBAAiB;QACtC,YAAY,EAAE,CAAC,CAAC,YAAY;QAC5B,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,0EAA0E;QAC1E,4EAA4E;QAC5E,eAAe,EAAE,CAAC,CAAC,eAAe,IAAI,QAAQ,EAAE,eAAe;QAC/D,SAAS,EAAE,CAAC,CAAC,SAAS,IAAI,QAAQ,EAAE,SAAS;QAC7C,YAAY,EAAE,QAAQ,EAAE,YAAY;QACpC,SAAS,EAAE,QAAQ,EAAE,SAAS;QAC9B,OAAO,EAAE,QAAQ,EAAE,OAAO;QAC1B,eAAe,EAAE,CAAC,CAAC,eAAe;QAClC,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,eAAe,EAAE,QAAQ,EAAE,eAAe;QAC1C,OAAO,EAAE,CAAC,CAAC,OAAO;QAClB,WAAW,EAAE,QAAQ,EAAE,WAAW;QAClC,eAAe,EAAE,QAAQ,EAAE,eAAe;QAC1C,kBAAkB,EAAE,QAAQ,EAAE,kBAAkB;QAChD,QAAQ,EAAE,EAAE,GAAG,QAAQ,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE;QAClD,aAAa,EAAE,QAAQ,EAAE,aAAa;QACtC,mBAAmB,EAAE,QAAQ,EAAE,mBAAmB;QAClD,gBAAgB,EAAE,CAAC,CAAC,gBAAgB,IAAI,QAAQ,EAAE,gBAAgB;QAClE,MAAM,EAAE;YACN,QAAQ,EAAE,CAAC,CAAC,aAAa;YACzB,OAAO,EAAE,CAAC,CAAC,YAAY;YACvB,yEAAyE;YACzE,mEAAmE;YACnE,WAAW,EACT,QAAQ,EAAE,MAAM,EAAE,WAAW;gBAC7B,CAAC,CAAC,CAAC,QAAQ,KAAK,WAAW;oBACzB,CAAC,CAAC,2BAA2B;oBAC7B,CAAC,CAAC,kBAAkB,CAAC;YACzB,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,IAAI,IAAI;gBAC5C,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBACxD,CAAC,CAAC,EAAE,CAAC;SACR;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/projectSelect.js

@@ -0,0 +1,51 @@
+import checkbox from "@inquirer/checkbox";
+import { readFileSync } from "node:fs";
+import { CONFIG_PATH, ConfigSchema, saveConfig, } from "../config.js";
+import * as ui from "../ui/display.js";
+export function buildProjectChoices(projects, existing) {
+    const nameWidth = Math.min(Math.max(...projects.map((p) => p.name.length), 8), 40);
+    // Default is over-capture: everything not explicitly excluded starts
+    // CHECKED. Transcripts prune at ~30 days, so an accidental enter that
+    // includes too much costs cents; one that excludes too much loses the
+    // sessions forever.
+    return projects.map((p) => ({
+        name: `${p.name.padEnd(nameWidth)}  ${String(p.sessionCount).padStart(3)} session${p.sessionCount === 1 ? " " : "s"}  ~${ui.formatUsd(p.estCost)}`,
+        value: p.name,
+        checked: existing[p.name] !== "exclude",
+    }));
+}
+// Selected = include, unselected = exclude. Every project SHOWN gets decided —
+// that is the point of the triage pass; only projects never shown stay
+// undecided.
+export function decisionsFromSelection(projects, selected) {
+    const chosen = new Set(selected);
+    const out = {};
+    for (const p of projects) {
+        out[p.name] = chosen.has(p.name) ? "include" : "exclude";
+    }
+    return out;
+}
+export async function promptProjectDecisions(projects, existing, message) {
+    const selected = await checkbox({
+        message,
+        choices: buildProjectChoices(projects, existing),
+        pageSize: 15,
+    });
+    return decisionsFromSelection(projects, selected);
+}
+// Persist decisions by patching the RAW config file, not the loaded Config —
+// loadConfig expands ~ paths, and writing those back would bake absolute
+// paths into the user's config. Validated through the schema before saving.
+export function persistProjectDecisions(decisions) {
+    const raw = JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+    raw.projects = {
+        ...(raw.projects ?? {}),
+        ...decisions,
+    };
+    const parsed = ConfigSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new Error(`refusing to save invalid config: ${parsed.error.issues[0]?.message ?? "validation failed"}`);
+    }
+    saveConfig(raw);
+}
+//# sourceMappingURL=projectSelect.js.map

package/dist/cli/projectSelect.js.map

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

package/dist/cli/projects.js

@@ -0,0 +1,119 @@
+import { classifyTranscript, estimateSessionCost, groupByProject, readTranscriptHead, sniffAgentEntrypoint, } from "../pipeline/projects.js";
+import { normalizeModelName } from "../pipeline/distiller.js";
+import { scanSessions } from "../pipeline/scanner.js";
+import { StateDb } from "../state/db.js";
+// Aggregate the scan (every project seen on disk) against DB state into the
+// `vir projects` table. Pure — the command wires in scan/DB/config and an
+// estimator; classification per session:
+//   distilled        row with content (skipped=0)
+//   pending          recorded "project-pending", or unseen under an
+//                    undecided project (it WILL pend on the next run)
+//   excluded         recorded "project-excluded", or unseen under an
+//                    excluded project
+//   neither          heuristic-filter skips, errors, unseen under include
+export function buildProjectsReport(groups, meta, decisions, estCost, nested) {
+    const byPath = new Map(meta.map((m) => [m.path, m]));
+    const rows = [];
+    for (const g of groups) {
+        const decision = decisions[g.name] ?? "undecided";
+        const nestedCounts = nested?.get(g.name);
+        const row = {
+            name: g.name,
+            decision,
+            sessions: g.sessions.length,
+            distilled: 0,
+            pending: 0,
+            excluded: 0,
+            estPendingCost: 0,
+            pendingPaths: [],
+            workflowSessions: nestedCounts?.workflow ?? 0,
+            sidechainSessions: nestedCounts?.sidechain ?? 0,
+            agentSessions: nestedCounts?.agent ?? 0,
+        };
+        for (const s of g.sessions) {
+            const m = byPath.get(s.path);
+            if (m && m.skipped === 0 && m.hasContent === 1) {
+                row.distilled += 1;
+                continue;
+            }
+            const reason = m?.skipReason ?? null;
+            if (reason === "project-pending" || (!m && decision === "undecided")) {
+                row.pending += 1;
+                row.estPendingCost += estCost(s.size);
+                row.pendingPaths.push(s.path);
+            }
+            else if (reason === "project-excluded" ||
+                (!m && decision === "exclude")) {
+                row.excluded += 1;
+            }
+        }
+        rows.push(row);
+    }
+    rows.sort((a, b) => b.estPendingCost - a.estPendingCost || a.name.localeCompare(b.name));
+    return rows;
+}
+// Side-effectful gather for `vir projects` and doctor: scan the transcripts
+// dir, read DB status, apply config decisions. Opens its own StateDb unless
+// one is passed in.
+export function gatherProjectsReport(cfg) {
+    const found = scanSessions(cfg.claudeProjectsDir);
+    // Partition out nested agent-internal transcripts (unless the knob says
+    // include) so they annotate the table instead of counting as sessions.
+    let inScope = found;
+    const nested = new Map();
+    const filteredOut = [];
+    const catByPath = new Map();
+    if (cfg.workflowTranscripts !== "include") {
+        inScope = [];
+        for (const s of found) {
+            const cat = classifyTranscript(s.path, cfg.claudeProjectsDir);
+            if (cat === "session")
+                inScope.push(s);
+            else {
+                filteredOut.push(s);
+                catByPath.set(s.path, cat);
+            }
+        }
+    }
+    // Top-level SDK-launched agents — same partition, its own category/knob.
+    if (cfg.agentTranscripts !== "include") {
+        const stillHuman = [];
+        for (const s of inScope) {
+            if (sniffAgentEntrypoint(readTranscriptHead(s.path)) !== null) {
+                filteredOut.push(s);
+                catByPath.set(s.path, "agent");
+            }
+            else {
+                stillHuman.push(s);
+            }
+        }
+        inScope = stillHuman;
+    }
+    for (const g of groupByProject(filteredOut, cfg.claudeProjectsDir).values()) {
+        const counts = { workflow: 0, sidechain: 0, agent: 0 };
+        for (const s of g.sessions) {
+            counts[catByPath.get(s.path) ?? "sidechain"] += 1;
+        }
+        nested.set(g.name, counts);
+    }
+    const groups = [...groupByProject(inScope, cfg.claudeProjectsDir).values()];
+    // A project whose transcripts are ALL nested would vanish from the table —
+    // keep it visible with an empty session group.
+    for (const name of nested.keys()) {
+        if (!groups.some((g) => g.name === name)) {
+            groups.push({ name, sessions: [], totalBytes: 0 });
+        }
+    }
+    const db = new StateDb();
+    let meta;
+    try {
+        meta = db.listSessionMeta();
+    }
+    finally {
+        db.close();
+    }
+    const classifyId = normalizeModelName(cfg.models.classify, cfg.provider);
+    const distillId = normalizeModelName(cfg.models.distill, cfg.provider);
+    return buildProjectsReport(groups, meta, cfg.projects, (size) => estimateSessionCost(cfg.provider, classifyId, distillId, size, cfg.pricing, cfg.kieTopUpTier), nested);
+}
+//# sourceMappingURL=projects.js.map

package/dist/cli/projects.js.map

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

package/dist/cli.js

@@ -10,12 +10,15 @@ import { existsSync, mkdirSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
-import { CONFIG_PATH, ConfigSchema, configExists, ensureVirDir, expandHome, loadConfig, saveConfig, } from "./config.js";
+import { CONFIG_PATH, maskSecret, ConfigSchema, configExists, ensureVirDir, expandHome, loadConfig, saveConfig, } from "./config.js";
 import { applyPlan, planUpdates } from "./claude/updater.js";
 import { detectDuplicates } from "./dedupe/detector.js";
 import { mergeNotes } from "./dedupe/merger.js";
 import { contradictionCheck, orphanCheck, stalenessCheck, } from "./lint/linter.js";
 import { runPipeline } from "./pipeline/run.js";
+import { categorizeTranscriptHead, classifyTranscript, estimateSessionCost, groupByProject, readTranscriptHead, } from "./pipeline/projects.js";
+import { persistProjectDecisions, promptProjectDecisions, } from "./cli/projectSelect.js";
+import { gatherProjectsReport } from "./cli/projects.js";
 import { scanSessions } from "./pipeline/scanner.js";
 import { parseSession } from "./pipeline/parser.js";
 import { scoreSession } from "./pipeline/filter.js";
@@ -70,6 +73,8 @@ program
     .option("--yes", "Skip the cost confirmation prompt")
     .option("--force-model <model>", "Override the distill model for this run only: haiku | sonnet")
     .option("--dry-run", "Estimate per-session cost after filtering, then exit before any LLM call")
+    .option("--only <project>", "Restrict this run to a project (repeatable, never persisted)", (v, acc) => acc.concat(v), [])
+    .option("--exclude-project <project>", "Skip a project for this run only (repeatable, never persisted)", (v, acc) => acc.concat(v), [])
     .action(runAction(async (opts) => {
     const cfg = loadConfig();
     const daemon = opts.daemon === true;
@@ -104,6 +109,11 @@ program
             throw err;
         }
     }
+    // Interactivity for the undecided-projects triage is a TTY question,
+    // not a --yes question: --yes skips the COST prompt but a human at a
+    // terminal can still answer include/exclude. launchd/cron have no
+    // TTY, so the daemon path can never reach the prompt.
+    const canPromptProjects = process.stdin.isTTY === true && !daemon && !dryRun;
     let summary;
     try {
         summary = await runPipeline(cfg, {
@@ -115,6 +125,18 @@ program
             pdfsOnly,
             forceDistillModel: opts.forceModel,
             dryRun,
+            onlyProjects: opts.only?.length ? opts.only : undefined,
+            excludeProjects: opts.excludeProject?.length
+                ? opts.excludeProject
+                : undefined,
+            onUndecidedProjects: canPromptProjects
+                ? async (pending) => {
+                    const answers = await promptProjectDecisions(pending, cfg.projects, `${pending.length} project(s) have sessions awaiting a decision — select the ones vir should track`);
+                    persistProjectDecisions(answers);
+                    ui.row(ui.success(ui.CHECK), ui.text(`saved ${Object.keys(answers).length} project decision(s)`));
+                    return answers;
+                }
+                : undefined,
             onConfirm: skipPrompt
                 ? undefined
                 : async (newCount) => confirmCostIfNeeded(cfg, newCount),
@@ -939,6 +961,70 @@ program
         db.close();
     }
 }));
+const projectsCmd = program
+    .command("projects")
+    .description("Per-project distillation decisions: table + include/exclude");
+projectsCmd
+    .option("--json", "Machine-readable output")
+    .action(runAction(async (opts) => {
+    const cfg = loadConfig();
+    const rows = gatherProjectsReport(cfg);
+    if (opts.json === true) {
+        process.stdout.write(JSON.stringify(rows.map(({ pendingPaths: _pendingPaths, ...r }) => r), null, 2) + "\n");
+        return;
+    }
+    ui.header("projects");
+    ui.blank();
+    if (rows.length === 0) {
+        ui.line(ui.dim("  no projects found under the Claude projects dir"));
+        return;
+    }
+    const nameW = Math.min(Math.max(...rows.map((r) => r.name.length), 7), 44);
+    ui.line(ui.dim(`  ${"project".padEnd(nameW)}  decision   sessions  distilled  pending  excluded  est. pending`));
+    for (const r of rows) {
+        const decision = r.decision === "include"
+            ? ui.success("include  ")
+            : r.decision === "exclude"
+                ? ui.dim("exclude  ")
+                : ui.warn("undecided");
+        const nestedParts = [
+            ...(r.workflowSessions > 0 ? [`+${r.workflowSessions} workflow`] : []),
+            ...(r.sidechainSessions > 0
+                ? [`+${r.sidechainSessions} sidechain`]
+                : []),
+            ...(r.agentSessions > 0 ? [`+${r.agentSessions} agent`] : []),
+        ];
+        const nestedNote = nestedParts.length > 0 ? ui.dim(`  (${nestedParts.join(", ")})`) : "";
+        ui.line(`  ${ui.text(r.name.padEnd(nameW))}  ${decision}  ${String(r.sessions).padStart(8)}  ${String(r.distilled).padStart(9)}  ${String(r.pending).padStart(7)}  ${String(r.excluded).padStart(8)}  ${r.pending > 0 ? ui.warn(ui.formatUsd(r.estPendingCost).padStart(12)) : ui.dim("—".padStart(12))}${nestedNote}`);
+    }
+    const pending = rows.filter((r) => r.decision === "undecided" && r.pending > 0);
+    if (pending.length > 0) {
+        ui.blank();
+        ui.line(ui.dim(`  ${pending.length} project(s) undecided — vir projects include|exclude <name>, or answer the prompt on the next interactive vir run`));
+    }
+}));
+async function cmdProjectDecision(name, decision) {
+    const cfg = loadConfig();
+    const rows = gatherProjectsReport(cfg);
+    const known = rows.find((r) => r.name === name);
+    if (!known) {
+        console.error(chalk.red(`unknown project '${name}' — seen projects: ${rows.map((r) => r.name).join(", ") || "(none)"}`));
+        process.exitCode = 1;
+        return;
+    }
+    persistProjectDecisions({ [name]: decision });
+    ui.row(ui.success(ui.CHECK), ui.text(decision === "include"
+        ? `${name} will be distilled from the next run (${known.pending} session(s) pending)`
+        : `${name} excluded — forward-looking only; already-distilled notes stay in the vault`));
+}
+projectsCmd
+    .command("include <name>")
+    .description("Track a project's sessions from now on")
+    .action(runAction(async (name) => cmdProjectDecision(name, "include")));
+projectsCmd
+    .command("exclude <name>")
+    .description("Stop tracking a project (existing notes are untouched)")
+    .action(runAction(async (name) => cmdProjectDecision(name, "exclude")));
 program
     .command("status")
     .description("Show processing status + knowledge base breakdown")
@@ -1265,30 +1351,36 @@ async function cmdInit() {
         default: existing?.provider ?? "anthropic",
         choices: [
             {
-                name: "Anthropic  (direct, official pricing)",
+                name: "Anthropic  (direct + reliable, official pricing — recommended)",
                 value: "anthropic",
             },
             {
-                name: "Kie.ai     (same Claude models, ~72% cheaper)",
+                name: "Kie.ai     (~72% cheaper, third-party proxy — you trade reliability for cost)",
                 value: "kie",
             },
         ],
     }));
+    // Secret prompt discipline: mask while typing, echo only a masked
+    // confirmation (maskSecret), and NEVER render the existing key as the
+    // visible inquirer default — that prints the full secret to the terminal
+    // before a single keystroke. Empty input keeps the existing/env key.
+    const promptSecret = async (message, keep, validate) => {
+        const value = await input({
+            message: keep
+                ? `${message} (Enter keeps ${maskSecret(keep)})`
+                : message,
+            transformer: (v, { isFinal }) => isFinal ? maskSecret(v || keep || "") : "•".repeat(v.length),
+            validate: (v) => (v === "" && keep ? true : validate(v)),
+        });
+        return value === "" && keep ? keep : value;
+    };
     let anthropicApiKey;
     let kieApiKey;
     if (provider === "anthropic") {
-        anthropicApiKey = await input({
-            message: "Anthropic API key",
-            default: existing?.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY ?? "",
-            validate: (v) => v.startsWith("sk-ant-") ? true : "key should start with sk-ant-",
-        });
+        anthropicApiKey = await promptSecret("Anthropic API key", existing?.anthropicApiKey ?? process.env.ANTHROPIC_API_KEY ?? undefined, (v) => (v.startsWith("sk-ant-") ? true : "key should start with sk-ant-"));
     }
     else {
-        kieApiKey = await input({
-            message: "Kie.ai API key",
-            default: existing?.kieApiKey ?? process.env.KIE_API_KEY ?? "",
-            validate: (v) => v.length > 10 ? true : "enter a valid Kie.ai API key",
-        });
+        kieApiKey = await promptSecret("Kie.ai API key", existing?.kieApiKey ?? process.env.KIE_API_KEY ?? undefined, (v) => (v.length > 10 ? true : "enter a valid Kie.ai API key"));
     }
     // ── model pickers (provider-aware) ──────────────────────────────────────
     const classifyChoices = provider === "anthropic"
@@ -1313,9 +1405,10 @@ async function cmdInit() {
     const distillChoices = provider === "anthropic"
         ? [
             {
-                name: "claude-sonnet-4-6  (recommended)",
-                value: "claude-sonnet-4-6",
+                name: "claude-sonnet-5  (recommended)",
+                value: "claude-sonnet-5",
             },
+            { name: "claude-sonnet-4-6", value: "claude-sonnet-4-6" },
             {
                 name: "claude-haiku-4-5-20251001  (faster, cheaper)",
                 value: "claude-haiku-4-5-20251001",
@@ -1345,6 +1438,67 @@ async function cmdInit() {
                 : "must be between 0 and 1";
         },
     }));
+    // ── project triage (the primary decision point) ─────────────────────────
+    // Every project found under the Claude projects dir is shown once with its
+    // session count and rough cost; selected = include, unselected = exclude.
+    // Projects that appear later start undecided and trigger the run prompt.
+    let projectDecisions = {};
+    let agentTranscriptsAnswer;
+    try {
+        const projectsDirX = expandHome(claudeProjectsDir);
+        const allFound = scanSessions(projectsDirX);
+        // Triage counts + the agent-transcript question. Only top-level
+        // transcripts count (nested workflow/sidechain have their own filter),
+        // and agent transcripts are excluded from the per-project multi-select
+        // numbers so the costs shown reflect what would actually distill.
+        const topLevel = allFound.filter((s) => classifyTranscript(s.path, projectsDirX) === "session");
+        const counts = { interactive: 0, agent: 0, stub: 0 };
+        const agentPaths = new Set();
+        for (const s of topLevel) {
+            const cat = categorizeTranscriptHead(readTranscriptHead(s.path), s.size);
+            counts[cat] += 1;
+            if (cat === "agent")
+                agentPaths.add(s.path);
+        }
+        if (counts.agent > 0) {
+            ui.blank();
+            ui.line(ui.dim(`  ${counts.interactive} interactive · ${counts.agent} SDK-launched · ${counts.stub} stubs`));
+            agentTranscriptsAnswer = (await select({
+                message: "SDK-launched agent transcripts (review/verify harness output) — distill them?",
+                default: existing?.agentTranscripts ?? "exclude",
+                choices: [
+                    {
+                        name: "Exclude  (recommended — agent-internal execution, not your decisions)",
+                        value: "exclude",
+                    },
+                    { name: "Include  (distill them like any session)", value: "include" },
+                ],
+            }));
+        }
+        const found = agentTranscriptsAnswer !== "include"
+            ? topLevel.filter((s) => !agentPaths.has(s.path))
+            : topLevel;
+        const groups = [...groupByProject(found, projectsDirX).values()];
+        if (groups.length > 0) {
+            const classifyId = normalizeModelName(classifyModel, provider);
+            const distillId = normalizeModelName(distillModel, provider);
+            const infos = groups
+                .map((g) => ({
+                name: g.name,
+                sessionCount: g.sessions.length,
+                totalBytes: g.totalBytes,
+                estCost: g.sessions.reduce((sum, s) => sum +
+                    estimateSessionCost(provider, classifyId, distillId, s.size), 0),
+            }))
+                .sort((a, b) => b.estCost - a.estCost);
+            ui.blank();
+            ui.line(ui.dim("  Which projects should vir distill? Costs are rough upper bounds."));
+            projectDecisions = await promptProjectDecisions(infos, existing?.projects ?? {}, "Projects to track");
+        }
+    }
+    catch (err) {
+        console.warn(chalk.yellow(`project scan failed (${err.message}) — you can decide later with vir projects`));
+    }
     const parsed = ConfigSchema.safeParse(buildInitConfig(existing, {
         vaultPath,
         outputDir,
@@ -1358,6 +1512,8 @@ async function cmdInit() {
         pdfsDir,
         classifyModel,
         distillModel,
+        projects: projectDecisions,
+        agentTranscripts: agentTranscriptsAnswer,
     }));
     if (!parsed.success) {
         console.error(chalk.red("invalid config:"));