plasalid 0.3.5 → 0.5.0

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

@@ -1,4 +1,6 @@
-export declare function runScanCommand(opts: {
+export interface ScanCommandOptions {
     regex?: string;
     force?: boolean;
-}): Promise<void>;
+    parallel?: number;
+}
+export declare function runScanCommand(opts: ScanCommandOptions): Promise<void>;

package/dist/cli/commands/scan.js

@@ -11,35 +11,159 @@ export async function runScanCommand(opts) {
             return;
         }
     }
-    const summary = await runScan({ regex: opts.regex, force: opts.force, interactive: true });
+    const useInk = !!process.stdout.isTTY;
+    const events = useInk ? await buildInkEvents(opts.parallel ?? 3) : buildPlainTextEvents();
+    const summary = await runScan({
+        regex: opts.regex,
+        force: opts.force,
+        interactive: true,
+        concurrency: opts.parallel,
+        events,
+    });
     renderScanSummary(summary);
 }
+function logDecryptProgress(e) {
+    const marker = e.outcome === "decrypted" ? chalk.dim("·")
+        : e.outcome === "skipped" ? chalk.dim("•")
+            : chalk.red("✗");
+    console.log(`  ${marker} [${e.index + 1}/${e.total}] ${e.fileName} (${e.outcome})`);
+}
+/** Ink-based events (TTY mode) */
+async function buildInkEvents(parallel) {
+    // Lazy-load ink + react so this module stays importable in non-TTY contexts
+    // (and so test environments without React don't choke on the JSX).
+    const { render } = await import("ink");
+    const { createElement } = await import("react");
+    const { ScanDashboard, ScanDashboardController } = await import("../ink/scan_dashboard.js");
+    const controller = new ScanDashboardController();
+    let inkInstance = null;
+    let mountedFiles = 0;
+    return {
+        decryptStart: (count) => {
+            if (count > 0)
+                console.log(chalk.dim(`Decrypting ${count} file(s)...`));
+        },
+        decryptProgress: logDecryptProgress,
+        decryptDone: (e) => {
+            console.log(chalk.dim(`Decrypted ${e.decrypted}, skipped ${e.skipped}, failed ${e.failed}.`));
+            console.log("");
+            mountedFiles = e.decrypted;
+            if (e.decrypted > 0) {
+                inkInstance = render(createElement(ScanDashboard, { controller, totalFiles: e.decrypted, parallel }));
+            }
+        },
+        scanStart: (e) => controller.publish({ type: "scan-start", fileName: e.fileName }),
+        scanProgress: (e) => controller.publish({ type: "scan-progress", fileName: e.fileName, step: e.step }),
+        scanEnd: (e) => controller.publish({
+            type: "scan-end",
+            fileName: e.fileName,
+            status: e.status,
+            transactions: e.transactions,
+            concerns: e.concerns,
+            error: e.error,
+        }),
+        correlating: (pairs) => {
+            if (inkInstance) {
+                inkInstance.unmount();
+                inkInstance = null;
+            }
+            if (mountedFiles > 0 && pairs > 0) {
+                console.log(chalk.dim(`Correlating across files... ${pairs} pair(s) flagged.`));
+            }
+        },
+        committing: () => {
+            // In case correlating fired with 0 pairs, ink may still be mounted; unmount now.
+            if (inkInstance) {
+                inkInstance.unmount();
+                inkInstance = null;
+            }
+            if (mountedFiles > 0)
+                console.log(chalk.dim("Committing..."));
+        },
+    };
+}
+/** Plain-text progress (non-TTY or fallback) */
+function buildPlainTextEvents() {
+    let decryptTotal = 0;
+    // De-dupe scan-progress chatter: only print when the step text changes per file.
+    const lastStepByFile = new Map();
+    return {
+        decryptStart: (count) => {
+            decryptTotal = count;
+            if (count > 0)
+                console.log(chalk.dim(`Decrypting ${count} file(s)...`));
+        },
+        decryptProgress: logDecryptProgress,
+        decryptDone: (e) => {
+            if (decryptTotal === 0)
+                return;
+            console.log(chalk.dim(`Decrypted ${e.decrypted}, skipped ${e.skipped}, failed ${e.failed}.`));
+            console.log("");
+        },
+        scanStart: (e) => {
+            console.log(`${chalk.cyan("→")} ${e.fileName} ${chalk.dim("starting...")}`);
+        },
+        scanProgress: (e) => {
+            if (lastStepByFile.get(e.fileName) === e.step)
+                return;
+            lastStepByFile.set(e.fileName, e.step);
+            console.log(chalk.dim(`    ${e.fileName} · ${e.step}`));
+        },
+        scanEnd: (e) => {
+            lastStepByFile.delete(e.fileName);
+            if (e.status === "scanned") {
+                console.log(`${chalk.green("✓")} ${e.fileName} ${chalk.dim(`(${e.transactions} transactions, ${e.concerns} concerns)`)}`);
+            }
+            else {
+                console.log(`${chalk.red("✗")} ${e.fileName} ${chalk.dim(`— ${e.error ?? "failed"}`)}`);
+            }
+        },
+        correlating: (pairs) => {
+            if (pairs > 0)
+                console.log(chalk.dim(`Correlating across files... ${pairs} pair(s) flagged.`));
+        },
+        committing: () => {
+            console.log(chalk.dim("Committing..."));
+        },
+    };
+}
+/** Terse summary */
 function renderScanSummary(summary) {
     console.log("");
-    console.log(chalk.bold(`Scanned ${summary.total} file(s)`));
-    console.log(`  ${chalk.green(`${summary.scanned} scanned`)}  ` +
-        `${chalk.cyan(`${summary.replaced} replaced`)}  ` +
-        `${chalk.dim(`${summary.skipped} skipped`)}  ` +
-        `${chalk.yellow(`${summary.needsInput} needs input`)}  ` +
-        `${chalk.red(`${summary.failed} failed`)}`);
+    const headline = `Scanned ${summary.total} file(s) — ` +
+        `${summary.scanned + summary.replaced} ok, ` +
+        `${summary.failed} failed, ` +
+        `${summary.concerns} concern${summary.concerns === 1 ? "" : "s"} flagged`;
+    console.log(chalk.bold(headline));
+    console.log("");
     for (const d of summary.details) {
         const label = d.relPath;
-        switch (d.result.status) {
-            case "scanned":
-                console.log(`  ${chalk.green("✓")} ${label}${d.result.summary ? chalk.dim(` — ${d.result.summary}`) : ""}`);
-                break;
-            case "replaced":
-                console.log(`  ${chalk.cyan("↻")} ${label} (replaces previous records)`);
+        switch (d.status) {
+            case "scanned": {
+                const tag = chalk.dim(`${d.transactions} transactions${d.concerns > 0 ? ` · ${d.concerns} concerns` : ""}`);
+                console.log(`  ${chalk.green("✓")} ${label}  ${tag}`);
                 break;
-            case "skipped":
-                console.log(`  ${chalk.dim("•")} ${label} (already scanned)`);
+            }
+            case "replaced": {
+                const tag = chalk.dim(`${d.transactions} transactions${d.concerns > 0 ? ` · ${d.concerns} concerns` : ""} (replaces prior)`);
+                console.log(`  ${chalk.cyan("↻")} ${label}  ${tag}`);
                 break;
-            case "needs_input":
-                console.log(`  ${chalk.yellow("!")} ${label} (${d.result.pendingQuestions} pending)`);
+            }
+            case "skipped": {
+                console.log(`  ${chalk.dim("•")} ${label}  ${chalk.dim("(already scanned)")}`);
                 break;
-            case "failed":
-                console.log(`  ${chalk.red("✗")} ${label}${d.result.error ? chalk.dim(` — ${d.result.error}`) : ""}`);
+            }
+            case "failed": {
+                console.log(`  ${chalk.red("✗")} ${label}  ${chalk.dim(`— ${d.error ?? "failed"}`)}`);
                 break;
+            }
         }
     }
+    const newlyProcessed = summary.scanned + summary.replaced;
+    if (newlyProcessed > 0) {
+        console.log("");
+        console.log(`${chalk.dim("Next:")} ${chalk.cyan("plasalid review")}${chalk.dim(summary.concerns > 0
+            ? " — to clear the concerns and learn your recurring rhythms."
+            : " — to connect related transactions and learn your recurring rhythms.")}`);
+    }
 }

package/dist/cli/commands/status.js

@@ -1,22 +1,19 @@
 import chalk from "chalk";
 import { getDb } from "../../db/connection.js";
 import { getNetWorth, getPeriodTotals } from "../../db/queries/account_balance.js";
-import { formatCurrencyAmount } from "../../currency.js";
-function fmt(n) {
-    return formatCurrencyAmount(n, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
-}
+import { formatAmount } from "../../currency.js";
 export function showStatus() {
     const db = getDb();
     const nw = getNetWorth(db);
-    console.log(chalk.bold("Net worth: ") + fmt(nw.net_worth));
-    console.log(chalk.dim(`Assets ${fmt(nw.assets)} − Liabilities ${fmt(nw.liabilities)}`));
+    console.log(chalk.bold("Net worth: ") + formatAmount(nw.net_worth));
+    console.log(chalk.dim(`Assets ${formatAmount(nw.assets)} − Liabilities ${formatAmount(nw.liabilities)}`));
     const now = new Date();
     const monthStart = new Date(now.getFullYear(), now.getMonth(), 1).toISOString().slice(0, 10);
     const today = now.toISOString().slice(0, 10);
     const totals = getPeriodTotals(db, monthStart, today);
     console.log("");
     console.log(chalk.bold(`This month (${monthStart} → ${today})`));
-    console.log(`  Income: ${fmt(totals.income)}`);
-    console.log(`  Expenses: ${fmt(totals.expenses)}`);
-    console.log(`  Net: ${fmt(totals.income - totals.expenses)}`);
+    console.log(`  Income: ${formatAmount(totals.income)}`);
+    console.log(`  Expenses: ${formatAmount(totals.expenses)}`);
+    console.log(`  Net: ${formatAmount(totals.income - totals.expenses)}`);
 }

package/dist/cli/commands/transactions.js

@@ -1,15 +1,8 @@
 import chalk from "chalk";
 import { getDb } from "../../db/connection.js";
-import { listJournalLines } from "../../db/queries/journal.js";
-import { formatCurrencyAmount } from "../../currency.js";
-function fmt(n) {
-    return formatCurrencyAmount(n, { minimumFractionDigits: 2, maximumFractionDigits: 2 });
-}
-// eslint-disable-next-line no-control-regex
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-function visibleLength(s) {
-    return s.replace(ANSI_RE, "").length;
-}
+import { listPostings } from "../../db/queries/transactions.js";
+import { visibleLength } from "../format.js";
+import { formatAmount } from "../../currency.js";
 function truncateMiddle(s, max) {
     if (s.length <= max)
         return s;
@@ -22,71 +15,73 @@ function truncateMiddle(s, max) {
 }
 const ACCOUNT_CAP = 32;
 const MEMO_CAP = 40;
-function groupByEntry(lines) {
+function groupByTransaction(postings) {
     const groups = [];
     let current = null;
-    for (const l of lines) {
-        if (!current || current.entry_id !== l.entry_id) {
+    for (const p of postings) {
+        if (!current || current.transaction_id !== p.transaction_id) {
             current = {
-                entry_id: l.entry_id,
-                date: l.entry_date ?? "",
-                description: l.entry_description ?? "",
-                lines: [],
+                transaction_id: p.transaction_id,
+                date: p.transaction_date ?? "",
+                description: p.transaction_description ?? "",
+                merchant: p.merchant_name ?? null,
+                postings: [],
             };
             groups.push(current);
         }
-        current.lines.push(l);
+        current.postings.push(p);
     }
     return groups;
 }
 export function showTransactions(opts) {
     const db = getDb();
-    const lines = listJournalLines(db, {
+    const postings = listPostings(db, {
         account_id: opts.account,
         from: opts.from,
         to: opts.to,
         q: opts.query,
         limit: opts.limit ?? 100,
     });
-    if (lines.length === 0) {
-        console.log(chalk.yellow("No journal lines match those filters."));
+    if (postings.length === 0) {
+        console.log(chalk.yellow("No postings match those filters."));
         return;
     }
     const truncatedAccount = new Map();
     const truncatedMemo = new Map();
-    for (const l of lines) {
-        const acct = l.account_name ?? l.account_id;
-        truncatedAccount.set(l.id, truncateMiddle(acct, ACCOUNT_CAP));
-        if (l.memo)
-            truncatedMemo.set(l.id, truncateMiddle(l.memo, MEMO_CAP));
+    for (const p of postings) {
+        const acct = p.account_name ?? p.account_id;
+        truncatedAccount.set(p.id, truncateMiddle(acct, ACCOUNT_CAP));
+        if (p.memo)
+            truncatedMemo.set(p.id, truncateMiddle(p.memo, MEMO_CAP));
     }
-    const accountWidth = Math.max(...lines.map((l) => truncatedAccount.get(l.id).length));
-    const amountWidth = Math.max(...lines.map((l) => {
-        const side = l.debit > 0 ? "DR" : "CR";
-        const amt = l.debit > 0 ? l.debit : l.credit;
-        return `${side} ${fmt(amt)}`.length;
+    const accountWidth = Math.max(...postings.map((p) => truncatedAccount.get(p.id).length));
+    const amountWidth = Math.max(...postings.map((p) => {
+        const side = p.debit > 0 ? "DR" : "CR";
+        const amt = p.debit > 0 ? p.debit : p.credit;
+        return `${side} ${formatAmount(amt)}`.length;
     }));
     const cols = process.stdout.columns || 100;
     const descMax = Math.max(20, cols - 14);
-    const groups = groupByEntry(lines);
+    const groups = groupByTransaction(postings);
     for (const g of groups) {
         const desc = truncateMiddle(g.description, descMax);
-        console.log(`${chalk.dim(g.date)}  ${chalk.bold(desc)}`);
-        for (const l of g.lines) {
-            const acct = truncatedAccount.get(l.id);
+        const merchant = g.merchant ? chalk.green(`  · ${g.merchant}`) : "";
+        console.log(`${chalk.dim(g.date)}  ${chalk.bold(desc)}${merchant}`);
+        for (const p of g.postings) {
+            const acct = truncatedAccount.get(p.id);
             const acctPadded = acct + " ".repeat(accountWidth - acct.length);
-            const side = l.debit > 0 ? "DR" : "CR";
-            const amt = l.debit > 0 ? l.debit : l.credit;
-            const rawAmount = `${side} ${fmt(amt)}`;
-            const colored = l.debit > 0 ? chalk.cyan(rawAmount) : chalk.magenta(rawAmount);
+            const side = p.debit > 0 ? "DR" : "CR";
+            const amt = p.debit > 0 ? p.debit : p.credit;
+            const rawAmount = `${side} ${formatAmount(amt)}`;
+            const colored = p.debit > 0 ? chalk.cyan(rawAmount) : chalk.magenta(rawAmount);
             const amountPadded = " ".repeat(amountWidth - visibleLength(colored)) + colored;
-            const memo = truncatedMemo.get(l.id);
+            const memo = truncatedMemo.get(p.id);
             const memoStr = memo ? `    ${chalk.dim(memo)}` : "";
             console.log(`    ${acctPadded}  ${amountPadded}${memoStr}`);
         }
     }
     if (groups.length > 1) {
         console.log("");
-        console.log(chalk.dim(`  ${groups.length} entries · ${lines.length} lines`));
+        console.log(chalk.dim(`  ${groups.length} transactions · ${postings.length} postings`));
     }
 }

package/dist/cli/format.d.ts

@@ -1,3 +1,5 @@
+export declare const ANSI_RE: RegExp;
+export declare function visibleLength(s: string): number;
 export declare function formatDuration(ms: number): string;
 export declare function formatError(error: any, context?: string): string;
 export declare function banner(): string;

package/dist/cli/format.js

@@ -1,4 +1,9 @@
 import chalk from "chalk";
+// eslint-disable-next-line no-control-regex
+export const ANSI_RE = /\x1b\[[0-9;]*m/g;
+export function visibleLength(s) {
+    return s.replace(ANSI_RE, "").length;
+}
 export function formatDuration(ms) {
     const s = Math.floor(ms / 1000);
     if (s < 1)
@@ -49,10 +54,10 @@ export function formatError(error, context) {
     return `${chalk.red("✗")} ${context ? context + ": " : ""}${safeMsg}`;
 }
 export function banner() {
-    return chalk.bold("Plasalid") + chalk.dim("  ·  Talk to your money");
+    return chalk.bold("Plasalid") + chalk.dim("  ·  The Harness Layer for Personal Finance");
 }
 function stripAnsi(str) {
-    return str.replace(/\x1b\[[0-9;]*m/g, "");
+    return str.replace(ANSI_RE, "");
 }
 function box(label, lines) {
     const cols = process.stdout.columns || 100;

package/dist/cli/index.js

@@ -15,7 +15,7 @@ function ensureConfigured() {
 }
 program
     .name("plasalid")
-    .description("The local-first data layer for personal finance")
+    .description("The Harness Layer for Personal Finance — local-first")
     .version(version)
     .addHelpCommand(false)
     .showHelpAfterError(`Run ${chalk.cyan("plasalid --help")} for the list of commands.`)
@@ -62,7 +62,7 @@ program
 });
 program
     .command("transactions")
-    .description("List journal lines")
+    .description("List transactions and their postings")
     .option("-a, --account <id>", "Filter by account id")
     .option("--from <date>", "From date YYYY-MM-DD")
     .option("--to <date>", "To date YYYY-MM-DD")
@@ -79,10 +79,19 @@ program
         limit: Number(opts.limit),
     });
 });
+program
+    .command("record <utterance...>")
+    .description("Add a manual entry, account, or balance update from a plain-language line.")
+    .action(async (utteranceTokens) => {
+    ensureConfigured();
+    const { runRecordCommand } = await import("./commands/record.js");
+    await runRecordCommand({ utterance: utteranceTokens.join(" ") });
+});
 program
     .command("scan [regex...]")
     .description("Scan every new PDF under ~/.plasalid/data (optionally filtered by regex)")
     .option("-f, --force", "Re-scan matching files (cascade-deletes prior records)")
+    .option("-p, --parallel <n>", "Number of files to scan concurrently (default 3, max 8). Override env PLASALID_SCAN_CONCURRENCY.", (v) => parseInt(v, 10))
     .action(async (regexes, opts) => {
     ensureConfigured();
     if (regexes.length > 1) {
@@ -96,20 +105,22 @@ program
         console.error(`  ${chalk.cyan("plasalid scan 'KBank|SCB'")}`);
         process.exit(1);
     }
+    const envParallel = parseInt(process.env.PLASALID_SCAN_CONCURRENCY ?? "", 10);
+    const parallel = Number.isFinite(opts.parallel) ? opts.parallel : (Number.isFinite(envParallel) ? envParallel : undefined);
     const { runScanCommand } = await import("./commands/scan.js");
-    await runScanCommand({ regex: regexes[0], force: !!opts.force });
+    await runScanCommand({ regex: regexes[0], force: !!opts.force, parallel });
 });
 program
-    .command("reconcile")
-    .description("Revisit the existing journal: find duplicate entries, similar accounts, and unused accounts; apply fixes after user confirmation")
-    .option("-a, --account <id>", "Limit reconciliation to a single account")
+    .command("review")
+    .description("See the whole picture — connect related transactions across statements, surface recurring patterns, and clear up anything that's still in question.")
+    .option("-a, --account <id>", "Limit review to a single account")
     .option("--from <date>", "Only consider entries on or after this date (YYYY-MM-DD)")
     .option("--to <date>", "Only consider entries on or before this date (YYYY-MM-DD)")
     .option("-d, --dry-run", "Surface findings without applying any change")
     .action(async (opts) => {
     ensureConfigured();
-    const { runReconcileCommand } = await import("./commands/reconcile.js");
-    await runReconcileCommand({
+    const { runReviewCommand } = await import("./commands/review.js");
+    await runReviewCommand({
         accountId: opts.account,
         from: opts.from,
         to: opts.to,
@@ -118,7 +129,7 @@ program
 });
 program
     .command("revert <regex>")
-    .description("Delete scanned files matching <regex> and all their journal entries")
+    .description("Delete scanned files matching <regex> and all their transactions")
     .action(async (regex) => {
     ensureConfigured();
     const { runRevertCommand } = await import("./commands/revert.js");
@@ -138,19 +149,23 @@ program.configureHelp({
         { name: "status", desc: "Show net worth and this-month totals" },
         {
             name: "transactions",
-            desc: "List journal lines (filter by account/date/text)",
+            desc: "List transactions and their postings (filter by account/date/text)",
+        },
+        {
+            name: "record",
+            desc: "Add a manual transaction, account, balance, or merchant from a plain-language line",
         },
         {
             name: "scan",
             desc: "Scan new PDFs (optionally by regex; --force to re-scan)",
         },
         {
-            name: "reconcile",
-            desc: "Review and fix existing journal entries / accounts",
+            name: "review",
+            desc: "Cleanup uncategorized, connect duplicates, learn recurring patterns",
         },
         {
             name: "revert",
-            desc: "Delete scanned files matching <regex> and their journal entries",
+            desc: "Delete scanned files matching <regex> and their transactions",
         },
     ]),
 });

package/dist/cli/ink/scan_dashboard.d.ts

@@ -0,0 +1,38 @@
+export type ScanDashboardEvent = {
+    type: "scan-start";
+    fileName: string;
+} | {
+    type: "scan-progress";
+    fileName: string;
+    step: string;
+} | {
+    type: "scan-end";
+    fileName: string;
+    status: "scanned" | "failed";
+    transactions: number;
+    concerns: number;
+    error?: string;
+};
+/**
+ * Subscribe / publish channel between the pipeline (which knows nothing about
+ * UI) and the dashboard (which knows nothing about the pipeline). The CLI
+ * creates one of these, fans events into it, and hands it to the component.
+ */
+export declare class ScanDashboardController {
+    private subscribers;
+    publish(event: ScanDashboardEvent): void;
+    subscribe(handler: (e: ScanDashboardEvent) => void): () => void;
+}
+interface Props {
+    controller: ScanDashboardController;
+    totalFiles: number;
+    parallel: number;
+}
+/**
+ * Multi-row live dashboard for the scan phase. Rows appear when a file starts
+ * scanning, update as steps flow, and freeze when the agent loop ends. Counts
+ * shown are the in-buffer counts at scan-end; correlation may add concerns
+ * later, which the terse summary reflects.
+ */
+export declare function ScanDashboard({ controller, totalFiles, parallel }: Props): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/cli/ink/scan_dashboard.js

@@ -0,0 +1,62 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+/**
+ * Subscribe / publish channel between the pipeline (which knows nothing about
+ * UI) and the dashboard (which knows nothing about the pipeline). The CLI
+ * creates one of these, fans events into it, and hands it to the component.
+ */
+export class ScanDashboardController {
+    subscribers = [];
+    publish(event) {
+        for (const sub of this.subscribers)
+            sub(event);
+    }
+    subscribe(handler) {
+        this.subscribers.push(handler);
+        return () => {
+            this.subscribers = this.subscribers.filter(s => s !== handler);
+        };
+    }
+}
+/**
+ * Multi-row live dashboard for the scan phase. Rows appear when a file starts
+ * scanning, update as steps flow, and freeze when the agent loop ends. Counts
+ * shown are the in-buffer counts at scan-end; correlation may add concerns
+ * later, which the terse summary reflects.
+ */
+export function ScanDashboard({ controller, totalFiles, parallel }) {
+    const [rows, setRows] = useState(() => new Map());
+    useEffect(() => {
+        return controller.subscribe(event => {
+            setRows(prev => {
+                const next = new Map(prev);
+                switch (event.type) {
+                    case "scan-start":
+                        next.set(event.fileName, { kind: "scanning", step: "starting..." });
+                        break;
+                    case "scan-progress":
+                        next.set(event.fileName, { kind: "scanning", step: event.step });
+                        break;
+                    case "scan-end":
+                        next.set(event.fileName, event.status === "scanned"
+                            ? { kind: "done", transactions: event.transactions, concerns: event.concerns }
+                            : { kind: "failed", error: event.error ?? "failed" });
+                        break;
+                }
+                return next;
+            });
+        });
+    }, [controller]);
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: ["Scanning ", totalFiles, " file(s) (", parallel, " in parallel)"] }), Array.from(rows.entries()).map(([name, state]) => (_jsx(FileRow, { name: name, state: state }, name)))] }));
+}
+function FileRow({ name, state }) {
+    if (state.kind === "scanning") {
+        return (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "yellow", children: _jsx(Spinner, { type: "dots" }) }), " ", name, " ", _jsxs(Text, { dimColor: true, children: ["\u00B7 ", state.step] })] }));
+    }
+    if (state.kind === "done") {
+        return (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "green", children: "\u2713" }), " ", name, " ", _jsxs(Text, { dimColor: true, children: ["(", state.transactions, " transactions, ", state.concerns, " concerns)"] })] }));
+    }
+    return (_jsxs(Text, { children: ["  ", _jsx(Text, { color: "red", children: "\u2717" }), " ", name, " ", _jsxs(Text, { dimColor: true, children: ["\u2014 ", state.error] })] }));
+}

package/dist/cli/setup.d.ts

@@ -1,2 +1 @@
 export declare function runSetup(): Promise<void>;
-export declare function ensureConfigured(): void;

package/dist/cli/setup.js

@@ -2,7 +2,7 @@ import chalk from "chalk";
 import inquirer from "inquirer";
 import { existsSync, mkdirSync } from "fs";
 import { resolve } from "path";
-import { config, saveConfig, getConfigPath, isConfigured, getPlasalidDir, getDataDir, } from "../config.js";
+import { config, saveConfig, getConfigPath, getPlasalidDir, getDataDir, } from "../config.js";
 import { generateKey } from "../db/encryption.js";
 import { createContextTemplate } from "../ai/context.js";
 import { printLogo } from "./logo.js";
@@ -36,7 +36,7 @@ function printSummary(dataDir) {
     console.log("Next steps:");
     console.log(`  1. Run ${chalk.cyan("plasalid data")} to drop your bank/credit card statments PDFs in.`);
     console.log(`  2. Run ${chalk.cyan("plasalid scan")} to allow Plasalid to scan them.`);
-    console.log(`  3. Run ${chalk.cyan("plasalid")} to chat with your financial data.`);
+    console.log(`  3. Run ${chalk.cyan("plasalid")} to query your local ledger.`);
 }
 /**
  * Wraps inquirer's list prompt with a blank line above and below, and inserts
@@ -202,9 +202,3 @@ export async function runSetup() {
     const dataDir = finalizeDataDir(userName || "User");
     printSummary(dataDir);
 }
-export function ensureConfigured() {
-    if (!isConfigured()) {
-        console.error(chalk.red("Plasalid is not configured. Run `plasalid setup` first."));
-        process.exit(1);
-    }
-}

package/dist/cli/ux.d.ts

@@ -1,4 +1,5 @@
 import type { ProgressCallback } from "../ai/agent.js";
+import type { PromptUserFacts } from "../ai/tools/types.js";
 /**
  * Minimal spinner interface so callers don't care whether we're animating in
  * a TTY or just printing plain lines. The same instance can be `pause()`d and
@@ -27,7 +28,7 @@ export declare function statusSpinner(text: string): SpinnerLike;
  * line, pads with blank lines for readability, and always includes a free-text
  * escape on choice prompts ("Type a different answer…").
  */
-export declare function makePromptUser(spinner: SpinnerLike): (prompt: string, options?: string[]) => Promise<string>;
+export declare function makePromptUser(spinner: SpinnerLike): (prompt: string, options?: string[], facts?: PromptUserFacts) => Promise<string>;
 /**
  * Standard agent-progress → spinner-text bridge.
  * - `phase: "tool"` maps the tool name through `TOOL_LABELS`.