segreant 0.1.0 → 0.2.0

package/dist/cli/flags.js

@@ -49,6 +49,74 @@ export function parseFlags(argv) {
     }
     return flags;
 }
+/**
+ * Every option name some command reads, used ONLY to suggest a correction for
+ * a mistyped one. It is not an allowlist: commands read options through
+ * helpers and arrays a source scan cannot follow, so rejecting by this list
+ * would refuse valid options.
+ */
+const KNOWN_OPTION_NAMES = [
+    'account-ref', 'all', 'allow-unmetered', 'apply', 'archive', 'as-of', 'at', 'attempts', 'auto', 'category', 'centre',
+    'cache-read', 'cache-write', 'cache-write-1h', 'clear', 'clear-webhook', 'close-status', 'commit', 'control', 'coverage', 'cwd', 'daily', 'dashboard-port', 'data-class',
+    'days', 'debug', 'decision', 'deep', 'demo', 'detail', 'disabled', 'dry-run', 'economic', 'effective-at', 'every',
+    'exact-money', 'file', 'finalize', 'format', 'free', 'from', 'grain', 'help', 'id', 'import-id', 'include-imported', 'input', 'into',
+    'json', 'key', 'key-id', 'kind', 'labor-rate', 'like', 'limit', 'list', 'manifest', 'materiality', 'me', 'method', 'mode',
+    'name', 'note', 'notify', 'notify-url', 'origin', 'out', 'output', 'owner', 'path-prefix', 'policy', 'port', 'priority',
+    'project', 'project-ref', 'pubkey', 'purpose', 'rating', 'reason', 'recommend', 'reconcile', 'record-id', 'refresh',
+    'reopen', 'repo', 'request', 'rescan', 'risk', 'root', 'runaway', 'scope', 'sensitivity', 'serve', 'session',
+    'set-webhook', 'setup', 'sign', 'soft', 'start', 'target-currency', 'to', 'tool', 'trust', 'ts', 'tsf', 'unit',
+    'until', 'url', 'use', 'verdict', 'verify', 'watch', 'window', 'wrap', 'write',
+];
+function editDistance(a, b) {
+    const row = Array.from({ length: b.length + 1 }, (_, j) => j);
+    for (let i = 1; i <= a.length; i++) {
+        let prev = row[0];
+        row[0] = i;
+        for (let j = 1; j <= b.length; j++) {
+            const keep = row[j];
+            row[j] = Math.min(row[j] + 1, row[j - 1] + 1, prev + (a[i - 1] === b[j - 1] ? 0 : 1));
+            prev = keep;
+        }
+    }
+    return row[b.length];
+}
+/** The closest known option name, when one is close enough to be the intended one. */
+export function suggestOption(name) {
+    let best = null;
+    let bestD = Infinity;
+    for (const known of KNOWN_OPTION_NAMES) {
+        const d = editDistance(name, known);
+        if (d < bestD) {
+            best = known;
+            bestD = d;
+        }
+    }
+    return best !== null && bestD <= Math.max(1, Math.floor(name.length / 3)) ? best : null;
+}
+/**
+ * Wrap parsed flags so the options a command actually read are recorded.
+ * `segreant budget --dayly 5` used to exit 0 having set nothing (H014), and a
+ * command that ignores `--json` printed prose without saying so (H013). After
+ * a command finishes, every option it never read is reported and the exit code
+ * is 2. A mistyped `--apply` is therefore caught after the default preview,
+ * which writes nothing.
+ */
+export function trackFlags(flags) {
+    const read = new Set(['_']);
+    const proxy = new Proxy(flags, {
+        get(target, key, receiver) {
+            if (typeof key === 'string')
+                read.add(key);
+            return Reflect.get(target, key, receiver);
+        },
+        has(target, key) {
+            if (typeof key === 'string')
+                read.add(key);
+            return Reflect.has(target, key);
+        },
+    });
+    return { flags: proxy, unread: () => Object.keys(flags).filter((k) => !read.has(k)) };
+}
 export function rangeFor(window) {
     const now = Date.now();
     const day = 24 * 60 * 60 * 1000;

package/dist/cli/homeCmd.js

@@ -0,0 +1,117 @@
+/**
+ * Bare `segreant`: the first thing anyone sees.
+ *
+ * Read-only, like every command without --apply: it never imports on its own.
+ * With nothing recorded yet it says what Segreant does, which tools it can read
+ * on this machine, and the one command that reads them. With a ledger it leads
+ * with the month, the plans, and how much of the AI work stayed in the code
+ * (from the last measurement), then the next step. `segreant guide` keeps the
+ * full checklist.
+ */
+import { existsSync } from 'node:fs';
+import { Store } from '../store/db.js';
+import { dbPath, isDemo } from '../config.js';
+import { defaultClaudeCodeRoot } from '../connect/claudeCode.js';
+import { defaultCodexRoot } from '../connect/codex.js';
+import { defaultOpencodeDbPath } from '../connect/opencode.js';
+import { defaultAntigravityRoot } from '../connect/antigravity.js';
+import { detectPlans, planName } from '../plans/detect.js';
+import { keptSummary, realizationFromStore } from '../value/realization.js';
+import { planComparisons, printPlanLines } from './planCmd.js';
+import { summarizeBasis } from '../cost/basis.js';
+import { basisLines } from './basisLines.js';
+import { C, color, usd, num, printJson } from './ui.js';
+import { rangeFor } from './flags.js';
+const DAY = 86_400_000;
+function toolsOnThisMachine() {
+    const plans = new Map(detectPlans().map((p) => [p.source, planName(p)]));
+    const out = [];
+    if (existsSync(defaultClaudeCodeRoot()))
+        out.push({ id: 'claude-code', label: 'Claude Code', plan: plans.get('claude-code') ?? null });
+    const codex = defaultCodexRoot();
+    if (codex !== null && existsSync(codex))
+        out.push({ id: 'codex', label: 'Codex', plan: plans.get('codex') ?? null });
+    const opencode = defaultOpencodeDbPath();
+    if (opencode !== null && existsSync(opencode))
+        out.push({ id: 'opencode', label: 'opencode', plan: null });
+    if (defaultAntigravityRoot() !== null)
+        out.push({ id: 'antigravity', label: 'Antigravity', plan: null });
+    return out;
+}
+export function cmdHome(flags) {
+    const store = new Store(dbPath());
+    const month = rangeFor('month');
+    const summary = store.summary(month.startMs, month.endMs);
+    const everything = store.summary(0, Date.now() + 1000);
+    const tools = toolsOnThisMachine();
+    const now = Date.now();
+    // The last measurement of what stayed in the code, over the last 90 days of commits.
+    const stored = realizationFromStore(store);
+    const recent = stored.units.filter((u) => u.tsEpochMs >= now - 90 * DAY);
+    const kept = recent.length > 0 ? keptSummary({ units: recent, windowDays: stored.windowDays }) : null;
+    const plans = everything.requests > 0 && !isDemo() ? planComparisons(store, month.startMs, month.endMs) : [];
+    const basis = summarizeBasis(store.pricingEvidenceByModel(month.startMs, month.endMs));
+    store.close();
+    if (flags.json) {
+        printJson({
+            empty: everything.requests === 0,
+            tools,
+            last30Days: { listCostUsd: summary.costUsd, requests: summary.requests, basis },
+            kept: kept === null ? null : { ...kept, asOf: new Date(stored.generatedAt).toISOString() },
+            plans,
+        });
+        return;
+    }
+    const tty = process.stdout.isTTY ?? false;
+    console.log('');
+    console.log(color(tty, C.bold, '  Segreant') + color(tty, C.gray, ' — what your AI coding spend produced, measured on your machine') + (isDemo() ? color(tty, C.yellow, '   ● DEMO DATA') : ''));
+    console.log('');
+    if (everything.requests === 0) {
+        if (tools.length > 0) {
+            const found = tools.map((t) => `${t.label}${t.plan ? ` (${t.plan})` : ''}`).join(' · ');
+            console.log(`  Found on this machine: ${color(tty, C.bold, found)}`);
+            console.log('');
+            console.log('  Read their logs and measure what the work produced:');
+            console.log(color(tty, C.cyan, '    segreant scan --setup'));
+            console.log(color(tty, C.gray, '    Nothing about you leaves this machine. The first run takes a few minutes; the month appears after about one.'));
+        }
+        else {
+            console.log('  No AI coding tool logs found here (Claude Code, Codex, Antigravity and opencode are read today).');
+            console.log(color(tty, C.cyan, '    segreant scan') + color(tty, C.gray, '   looks further and lists what it can and cannot read'));
+        }
+        console.log('');
+        console.log(color(tty, C.gray, '  See every screen with sample data first:  segreant demo --serve'));
+        console.log('');
+        return;
+    }
+    const plainList = basis.cohorts.length === 1 && basis.cohorts[0].id === 'list_exact';
+    console.log(`  ${color(tty, C.bold, 'Last 30 days')}  ${color(tty, C.green, usd(summary.costUsd))} ${basis.headlineLabel.toLowerCase()}  ${color(tty, C.gray, plainList
+        ? `(${num(summary.requests)} requests · each model's API list rate · not your bill)`
+        : `(${num(summary.requests)} requests, priced in parts:)`)}`);
+    if (!plainList)
+        for (const line of basisLines(basis, '                '))
+            console.log(color(tty, C.gray, line));
+    printPlanLines(tty, plans);
+    console.log('');
+    if (kept !== null && kept.kept.units + kept.notKept.units + kept.contested.units + kept.unknown.units + kept.maturing.units > 0) {
+        const asOf = new Date(stored.generatedAt).toISOString().slice(0, 10);
+        console.log(color(tty, C.bold, '  Did the AI work stay in the code?') + color(tty, C.gray, `   commits of the last 90 days, all projects · measured ${asOf}`));
+        const row = (label, b, tone, what) => {
+            if (b.units === 0)
+                return;
+            console.log(`    ${label.padEnd(10)} ${color(tty, tone, usd(b.costUsd).padStart(10))}  ${String(b.units).padStart(4)} commits  ${color(tty, C.gray, what)}`);
+        };
+        row('Kept', kept.kept, C.green, 'still in the code after 14 days, no tracked check failed');
+        row('Not kept', kept.notKept, C.yellow, 'rewritten, removed or reverted');
+        row('Disputed', kept.contested, C.gray, 'the checks disagreed; not settled either way');
+        row('Unknown', kept.unknown, C.gray, 'not measured');
+        row('Maturing', kept.maturing, C.gray, 'younger than 14 days when measured');
+        console.log(color(tty, C.gray, '    Refresh: segreant scan --setup · one project in full: segreant realize --repo <path>'));
+    }
+    else {
+        console.log(color(tty, C.gray, '  Not measured yet: what the work produced. Run segreant scan --setup, or segreant realize --repo <path> for one project.'));
+    }
+    console.log('');
+    console.log(`  ${color(tty, C.bold, 'Next')}  ${color(tty, C.cyan, 'segreant start')}${color(tty, C.gray, ' opens the dashboard')} · ${color(tty, C.cyan, 'segreant quota')}${color(tty, C.gray, ' your plan limits')} · ${color(tty, C.cyan, 'segreant guide')}${color(tty, C.gray, ' the full checklist')}`);
+    console.log('');
+}

package/dist/cli/importCmd.js

@@ -6,15 +6,20 @@
  */
 import { join } from 'node:path';
 import { Store } from '../store/db.js';
-import { dbPath, loadConfig } from '../config.js';
-import { pricingStatus } from '../cost/pricing.js';
-import { realizeDiscoveredProjects, projectValueBreakdown } from '../value/realization.js';
+import { dbPath, loadConfig, isDemo, DemoWriteBlockedError } from '../config.js';
+import { pricingStatus, refreshPricing, DEFAULT_MANIFEST_URL } from '../cost/pricing.js';
+import { priceCheckDue } from '../cost/firstSight.js';
+import { realizeDiscoveredProjects, projectValueBreakdown, CLI_PERIOD_DAYS, CLI_GIT_BUDGET_MS, SCAN_VALUE_BUDGET_MS, } from '../value/realization.js';
 import { scanWithDiff, saveScan } from '../scan/scan.js';
-import { importClaudeCode, defaultClaudeCodeRoot } from '../connect/claudeCode.js';
-import { importOpencode, defaultOpencodeDbPath } from '../connect/opencode.js';
-import { importCodex, defaultCodexRoot } from '../connect/codex.js';
+import { defaultClaudeCodeRoot } from '../connect/claudeCode.js';
+import { IMPORT_REGISTRY, importerFor } from '../connect/registry.js';
 import {} from '../connect/importShared.js';
 import { C, color, usd, num, printJson } from './ui.js';
+import { rangeFor } from './flags.js';
+import { askPlanPrices } from './planCmd.js';
+import { askModelPrices } from './askModelPrices.js';
+import { summarizeBasis } from '../cost/basis.js';
+import { basisLines } from './basisLines.js';
 /**
  * Live import: poll the source(s) on an interval and fold in new traffic as it
  * appears. Reads are read-only snapshots (SQLite WAL / streamed JSONL), so the
@@ -78,33 +83,107 @@ async function cmdImportWatch(targets, opts) {
         process.on('SIGTERM', stop);
     });
 }
-const IMPORT_RUNNERS = {
-    'claude-code': {
-        label: 'Claude Code',
-        location: (r) => r ?? defaultClaudeCodeRoot(),
-        run: (store, opts) => importClaudeCode(store, opts),
-    },
-    opencode: {
-        label: 'opencode',
-        location: (r) => r ?? defaultOpencodeDbPath() ?? '(opencode not found on this machine)',
-        run: (store, opts) => importOpencode(store, opts),
-    },
-    codex: {
-        label: 'Codex CLI',
-        location: (r) => r ?? defaultCodexRoot() ?? '(Codex not found on this machine)',
-        run: (store, opts) => importCodex(store, opts),
-    },
-};
+const IMPORT_RUNNERS = Object.fromEntries(IMPORT_REGISTRY.map((e) => [e.id, {
+        label: e.label,
+        // Claude Code's root is reported even when absent (it says where to look).
+        location: (r) => r ?? e.locate() ?? (e.id === 'claude-code' ? defaultClaudeCodeRoot() : `(${e.label} not found on this machine)`),
+        run: e.run,
+        recentFirst: e.recentFirst,
+    }]));
 /** Normalize the aliases users actually type. */
 function resolveImporterId(what) {
-    const w = what.toLowerCase();
-    if (w === 'claude-code' || w === 'claudecode' || w === 'claude')
-        return 'claude-code';
-    if (w === 'opencode')
-        return 'opencode';
-    if (w === 'codex' || w === 'codex-cli')
-        return 'codex';
-    return null;
+    return importerFor(what)?.id ?? null;
+}
+/**
+ * One source's two passes as one summary. The backfill counted every file
+ * again (the recent ones as unchanged), so file and truncation totals come
+ * from it; rows and money add, because each pass inserted different rows.
+ */
+function mergeImportSummaries(recent, rest) {
+    if (recent === undefined)
+        return rest;
+    const byModel = {};
+    for (const part of [recent.byModel, rest.byModel]) {
+        for (const [model, v] of Object.entries(part)) {
+            const into = byModel[model] ?? { requests: 0, costUsd: 0 };
+            into.requests += v.requests;
+            into.costUsd += v.costUsd;
+            byModel[model] = into;
+        }
+    }
+    const lo = [recent.earliestMs, rest.earliestMs].filter((v) => v !== null);
+    const hi = [recent.latestMs, rest.latestMs].filter((v) => v !== null);
+    const conflicts = (recent.conflictingObservations ?? 0) + (rest.conflictingObservations ?? 0);
+    return {
+        ...rest,
+        inserted: recent.inserted + rest.inserted,
+        eventsSeen: recent.eventsSeen + rest.eventsSeen,
+        costUsd: recent.costUsd + rest.costUsd,
+        estimatedCostUsd: recent.estimatedCostUsd + rest.estimatedCostUsd,
+        byModel,
+        earliestMs: lo.length > 0 ? Math.min(...lo) : null,
+        latestMs: hi.length > 0 ? Math.max(...hi) : null,
+        relabelled: [...recent.relabelled, ...rest.relabelled],
+        ...(conflicts > 0 ? { conflictingObservations: conflicts } : {}),
+    };
+}
+/** "kept $1,643 · not kept $408": a project's answer from git, or why there is none yet. */
+function keptLine(tty, d) {
+    if (!d.measured)
+        return color(tty, C.gray, d.skipped === 'no-spend' ? 'no priced spend' : 'not measured in this run');
+    const k = d.kept;
+    if (k === undefined || k.kept.units + k.notKept.units + k.contested.units + k.unknown.units === 0) {
+        return color(tty, C.gray, k !== undefined && k.maturing.units > 0 ? 'maturing (commits under 14 days)' : 'no commits to judge');
+    }
+    const parts = [];
+    if (k.kept.costUsd >= 0.005)
+        parts.push(color(tty, C.green, `kept ${usd(k.kept.costUsd)}`));
+    if (k.notKept.costUsd >= 0.005)
+        parts.push(color(tty, C.yellow, `not kept ${usd(k.notKept.costUsd)}`));
+    if (k.contested.costUsd >= 0.005)
+        parts.push(color(tty, C.gray, `disputed ${usd(k.contested.costUsd)}`));
+    if (k.unknown.costUsd >= 0.005)
+        parts.push(color(tty, C.gray, `not measured yet ${usd(k.unknown.costUsd)}`));
+    if (k.maturing.costUsd >= 0.005)
+        parts.push(color(tty, C.gray, `maturing ${usd(k.maturing.costUsd)}`));
+    if (parts.length === 0)
+        return color(tty, C.gray, 'no spend on its commits');
+    return parts.join(color(tty, C.gray, ' · '));
+}
+/**
+ * The part of a project's period spend that is on no measured commit, with its
+ * reasons. Printed under the project line so the buckets above plus this line
+ * add up to the project's total; before, $222 of one project's $567 had no line.
+ */
+export function offCommitLine(d) {
+    const c = d.coverage;
+    if (c === undefined)
+        return null;
+    const parts = [];
+    if (c.noCommitFollowedUsd >= 0.005)
+        parts.push(`${usd(c.noCommitFollowedUsd)} no commit followed within 8 hours`);
+    if (c.beforeOldestUsd >= 0.005)
+        parts.push(`${usd(c.beforeOldestUsd)} before the oldest commit measured`);
+    if (c.notCommittedYetUsd >= 0.005)
+        parts.push(`${usd(c.notCommittedYetUsd)} not committed yet`);
+    return parts.length === 0 ? null : `not on a commit: ${parts.join(' · ')}`;
+}
+/** Repositories the shared deadline did not reach: named, with the command that measures them. */
+function printUnmeasured(tty, discovered) {
+    const left = discovered.filter((d) => d.skipped === 'deadline');
+    if (left.length > 0) {
+        const spend = left.reduce((s, d) => s + (d.periodCostUsd ?? d.costUsd), 0);
+        console.log(color(tty, C.gray, `    ${left.length} smaller project(s) (${usd(spend)} of spend) were not measured in the time this scan allows.`));
+        console.log(color(tty, C.gray, `    Measure one with: segreant realize --repo "${left[0].repoPath}"`));
+    }
+    // The scan keeps to its time budget, so a large project can come back partly
+    // measured. Name the biggest such gap and the command that finishes it.
+    const partial = discovered
+        .filter((d) => d.measured && d.kept !== undefined && d.kept.unknown.costUsd >= 1)
+        .sort((a, b) => b.kept.unknown.costUsd - a.kept.unknown.costUsd)[0];
+    if (partial !== undefined) {
+        console.log(color(tty, C.gray, `    ${partial.project}: ${usd(partial.kept.unknown.costUsd)} not measured yet in the time this scan allows. Finish it with: segreant realize --repo "${partial.repoPath}"`));
+    }
 }
 /** "3 files, 507 lines" — the parts of an import that hit a resource bound. */
 function truncationDetail(sum) {
@@ -186,6 +265,12 @@ export async function cmdImport(flags) {
         process.exitCode = 1;
         return;
     }
+    // Demo mode opens demo.db. Real usage must not land there, under sample-data labels.
+    if (isDemo()) {
+        console.error(`  ${new DemoWriteBlockedError('the import').message}`);
+        process.exitCode = 1;
+        return;
+    }
     const days = typeof flags.days === 'string' ? Number(flags.days) : null;
     const sinceMs = days && days > 0 ? Date.now() - days * 24 * 60 * 60 * 1000 : 0;
     const root = typeof flags.root === 'string' ? flags.root : undefined;
@@ -253,7 +338,10 @@ export async function cmdDiscover(flags) {
     const store = new Store(dbPath());
     const paths = store.projectPaths();
     const progress = repoProgress(flags);
-    const discovered = await realizeDiscoveredProjects(store, { windowDays, onProgress: progress.onProgress });
+    const discovered = await realizeDiscoveredProjects(store, {
+        windowDays, onProgress: progress.onProgress, sinceDays: CLI_PERIOD_DAYS, gitScanBudgetMs: CLI_GIT_BUDGET_MS,
+        stageBudgetMs: SCAN_VALUE_BUDGET_MS,
+    });
     progress.finish();
     const projects = projectValueBreakdown(store, { windowDays });
     store.close();
@@ -286,10 +374,11 @@ export async function cmdDiscover(flags) {
             ? color(tty, C.gray, 'RoI —')
             : color(tty, roi > 60 ? C.green : roi > 30 ? C.yellow : C.red, `RoI ${Math.round(roi)}`);
         const tools = d.sources.length ? d.sources.join(', ') : 'unknown';
-        console.log(`  ${color(tty, C.bold, d.project.padEnd(22))} ${usd(d.costUsd).padStart(10)}   ${d.realizedUnits}/${d.units} realized   ${roiStr}`);
+        console.log(`  ${color(tty, C.bold, d.project.padEnd(22))} ${usd(d.costUsd).padStart(10)}   ${keptLine(tty, d)}   ${roiStr}`);
         console.log(color(tty, C.gray, `    ${d.repoPath}`));
         console.log(color(tty, C.gray, `    coded with: ${tools}`));
     }
+    printUnmeasured(tty, discovered);
     console.log('');
     console.log(color(tty, C.gray, '  RoI here scores every stored unit (all time); "segreant roi --repo" scopes to a window — the two can differ.'));
     console.log(color(tty, C.gray, '  Now live in: segreant roi · segreant today · the dashboard (By project).'));
@@ -358,7 +447,7 @@ export async function cmdScan(flags) {
         console.log('');
         console.log(color(tty, C.bold, '  Scan — find your AI tools and repos, then set it all up'));
         console.log(color(tty, C.gray, '  ' + '─'.repeat(64)));
-        console.log(color(tty, C.gray, '  Read-only: reads what exists on disk. Nothing is imported or sent.'));
+        console.log(color(tty, C.gray, '  Reads what exists on disk and remembers this scan to report changes. Nothing is imported or sent.'));
         console.log('');
         // Detected tools.
         console.log(color(tty, C.bold, '  AI coding tools on this machine'));
@@ -375,7 +464,7 @@ export async function cmdScan(flags) {
         if (otherPresent.length > 0) {
             console.log(color(tty, C.bold, '  Other AI tools detected (not yet natively supported)'));
             for (const a of otherPresent) {
-                console.log(`  ${color(tty, C.gray, '·')} ${a.label.padEnd(16)} ${color(tty, C.gray, a.evidence ?? '')}`);
+                console.log(`  ${color(tty, C.gray, '·')} ${a.label.padEnd(16)} ${color(tty, C.gray, a.notReadBecause ? `not read: ${a.notReadBecause}` : a.evidence ?? '')}`);
             }
             console.log(color(tty, C.gray, '    We see these exist, but don\'t read their usage data yet — spend from them isn\'t counted above.'));
             console.log('');
@@ -412,7 +501,25 @@ export async function cmdScan(flags) {
     // Imported rows keep the price they were recorded at, so a stale card turns
     // every model newer than it into a fallback estimate for good (until a
     // reprice). Say so BEFORE the import, where it can still be avoided.
-    const prices = pricingStatus(loadConfig().pricing.maxAgeDays);
+    const pricingCfg = loadConfig().pricing;
+    let prices = pricingStatus(pricingCfg.maxAgeDays);
+    // Imported rows keep the price they are recorded at, so the best moment to
+    // learn new models is before the import, not after it. Only when someone is
+    // at the terminal: a scripted import does not gain a network call it did not
+    // ask for (the running proxy still looks models up on first sight). Only the
+    // built-in public list, which is what this line and the privacy statement
+    // disclose: a custom pricing.manifestUrl is refreshed when its operator asks
+    // (segreant pricing --refresh, or autoRefresh), never by scan (PR #146 review).
+    const builtInList = pricingCfg.manifestUrl === null || pricingCfg.manifestUrl === undefined || pricingCfg.manifestUrl === DEFAULT_MANIFEST_URL;
+    if (flags.setup && !flags.json && tty && !isDemo() && pricingCfg.lookupUnknownModels && builtInList && priceCheckDue(prices)) {
+        console.log(color(tty, C.gray, '  Checking the public price list so imported requests get current prices (sends nothing about you)…'));
+        const checked = await refreshPricing(DEFAULT_MANIFEST_URL);
+        console.log(checked.ok
+            ? color(tty, C.gray, `  Prices current: ${num(checked.modelCount ?? 0)} models on the card.`)
+            : color(tty, C.yellow, `  Price check skipped: ${checked.error ?? 'the price list could not be read'}.`));
+        prices = pricingStatus(pricingCfg.maxAgeDays);
+        console.log('');
+    }
     if (prices.stale && !flags.json) {
         const age = prices.ageDays === null ? 'of unknown age' : `${num(prices.ageDays)} days old`;
         console.log(color(tty, C.yellow, `  Prices are ${age}: models released since then will be priced by a fallback estimate.`));
@@ -448,6 +555,34 @@ export async function cmdScan(flags) {
     if (!flags.json)
         console.log(color(tty, C.bold, '  Setting up…'));
     let totalNew = 0;
+    // Newest first: the logs of the last 30 days, then the month's number, then
+    // the older history. The month is exact after the first pass (see
+    // ImportOptions.modifiedSinceMs); the backfill only adds older rows.
+    const month = rangeFor('month');
+    const reading = !flags.json && process.stderr.isTTY;
+    const recent = new Map();
+    for (const t of present) {
+        const runner = IMPORT_RUNNERS[t.id];
+        if (!runner)
+            continue;
+        if (reading)
+            process.stderr.write(`    Reading the last 30 days of ${t.label} logs…`);
+        recent.set(t.id, await runner.run(store, runner.recentFirst ? { modifiedSinceMs: month.startMs } : {}));
+        if (reading)
+            process.stderr.write('\r\x1b[2K');
+    }
+    if (!flags.json && recent.size > 0) {
+        const m = store.summary(month.startMs, month.endMs);
+        const basis = summarizeBasis(store.pricingEvidenceByModel(month.startMs, month.endMs));
+        const plainList = basis.cohorts.length === 1 && basis.cohorts[0].id === 'list_exact';
+        console.log(`    ${color(tty, C.bold, 'Last 30 days')}  ${color(tty, C.green, usd(m.costUsd))} ${basis.headlineLabel.toLowerCase()}  ${color(tty, C.gray, plainList
+            ? `(${num(m.requests)} requests · each model's API list rate · not your bill)`
+            : `(${num(m.requests)} requests, priced in parts:)`)}`);
+        if (!plainList)
+            for (const line of basisLines(basis, '                  '))
+                console.log(color(tty, C.gray, line));
+        console.log(color(tty, C.gray, '    Now reading older history, then measuring what the work produced…'));
+    }
     for (const t of present) {
         const runner = IMPORT_RUNNERS[t.id];
         if (!runner) {
@@ -456,12 +591,18 @@ export async function cmdScan(flags) {
             }
             continue;
         }
-        const reading = !flags.json && process.stderr.isTTY;
-        if (reading)
-            process.stderr.write(`    Reading ${t.label} logs…`);
-        const sum = await runner.run(store, {});
-        if (reading)
-            process.stderr.write('\r\x1b[2K');
+        const first = recent.get(t.id);
+        let sum;
+        if (runner.recentFirst) {
+            if (reading)
+                process.stderr.write(`    Reading older ${t.label} logs…`);
+            sum = mergeImportSummaries(first, await runner.run(store, {}));
+            if (reading)
+                process.stderr.write('\r\x1b[2K');
+        }
+        else {
+            sum = first;
+        }
         totalNew += sum.inserted;
         if (!flags.json) {
             console.log(`    ${color(tty, C.green, '✓')} ${t.label.padEnd(16)} ${color(tty, C.green, `${num(sum.inserted)} new`)}` +
@@ -474,27 +615,42 @@ export async function cmdScan(flags) {
     if (present.length === 0 && !flags.json)
         console.log(color(tty, C.gray, '    No detected tools to import.'));
     const progress = repoProgress(flags);
-    const discovered = await realizeDiscoveredProjects(store, { onProgress: progress.onProgress });
+    const discovered = await realizeDiscoveredProjects(store, {
+        onProgress: progress.onProgress, sinceDays: CLI_PERIOD_DAYS, gitScanBudgetMs: CLI_GIT_BUDGET_MS,
+        stageBudgetMs: SCAN_VALUE_BUDGET_MS,
+    });
     progress.finish();
-    const projects = projectValueBreakdown(store, {});
-    const roiByProject = new Map(projects.map((p) => [p.project, p.roiIndex]));
     store.close();
     if (!flags.json) {
         console.log('');
-        console.log(color(tty, C.bold, `  Correlated ${discovered.length} project(s) into per-project RoI`));
-        for (const d of discovered.slice(0, 12)) {
-            const roi = roiByProject.get(d.project);
-            const roiStr = roi == null
-                ? color(tty, C.gray, 'RoI —')
-                : color(tty, roi > 60 ? C.green : roi > 30 ? C.yellow : C.red, `RoI ${Math.round(roi)}`);
+        const shown = discovered.filter((d) => d.skipped !== 'no-spend');
+        console.log(color(tty, C.bold, `  Did the AI work stay in the code?`) + color(tty, C.gray, `   last ${CLI_PERIOD_DAYS} days by project · list cost (estimate), not your bill`));
+        for (const d of shown.slice(0, 12)) {
             const tools = d.sources.length ? d.sources.join(', ') : 'unknown';
-            console.log(`    ${color(tty, C.bold, d.project.padEnd(22))} ${usd(d.costUsd).padStart(10)}   ${roiStr}   ${color(tty, C.gray, `coded with: ${tools}`)}`);
+            console.log(`    ${color(tty, C.bold, d.project.padEnd(24))} ${usd(d.periodCostUsd ?? d.costUsd).padStart(10)}   ${keptLine(tty, d)}   ${color(tty, C.gray, `coded with: ${tools}`)}`);
+            const off = offCommitLine(d);
+            if (off !== null)
+                console.log(color(tty, C.gray, `    ${''.padEnd(24)} ${''.padStart(10)}   ${off}`));
         }
+        if (shown.length > 12)
+            console.log(color(tty, C.gray, `    …and ${shown.length - 12} more (segreant discover lists them all)`));
+        const idle = discovered.length - shown.length;
+        if (idle > 0)
+            console.log(color(tty, C.gray, `    ${idle} more repositor${idle === 1 ? 'y has' : 'ies have'} no priced AI spend in the last ${CLI_PERIOD_DAYS} days.`));
+        printUnmeasured(tty, discovered);
         console.log('');
-        console.log(color(tty, C.gray, '  RoI here scores every stored unit (all time); "segreant roi --repo" scopes to a window — the two can differ.'));
-        console.log(color(tty, C.gray, `  Imported ${num(totalNew)} new request(s). Now live in: segreant today · roi · the dashboard.`));
+        console.log(color(tty, C.gray, '  Kept: most of a commit\'s lines are still in the code after 14 days and no check you track failed. Not kept: a tracked check failed, or the lines were rewritten, removed or reverted.'));
+        console.log(color(tty, C.gray, '  The full picture for one project: segreant realize --repo <path> · value against your time: segreant roi'));
+        console.log(color(tty, C.gray, `  Imported ${num(totalNew)} new request(s). Now live in: segreant today · month · the dashboard.`));
         console.log(color(tty, C.gray, '  Safe to re-run any time to fold in new tools, repos, and traffic.'));
         console.log('');
+        if (await askPlanPrices(tty) > 0)
+            console.log(color(tty, C.gray, '  Saved. segreant month now shows each plan beside the work it did.'));
+        await askModelPrices(tty);
+        if (present.some((t) => t.id === 'claude-code')) {
+            console.log(color(tty, C.gray, '  Claude\'s live usage meter: segreant statusline --setup shows the one line to add to Claude Code.'));
+        }
+        console.log('');
     }
     if (flags.json)
         printJson({ setup: true, totalNew, discovered });

package/dist/cli/launchCmd.js

@@ -14,7 +14,8 @@ import { spawn } from 'node:child_process';
 import { loadConfig } from '../config.js';
 import { probeProxyState } from '../egress/proxyHealth.js';
 import {} from './flags.js';
-function capConfigured(cfg) {
+/** Whether any hard cap is set. The start banner uses the same test, so its advice matches launch. */
+export function capConfigured(cfg) {
     const b = cfg.budget;
     return b.dailyUsd !== null || b.sessionUsd !== null || b.runawayMaxUsd !== null;
 }