plasalid 0.8.2 → 0.8.3

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

@@ -1,4 +1 @@
-export interface ShowAccountsOptions {
-    noInteractive?: boolean;
-}
-export declare function showAccounts(opts?: ShowAccountsOptions): Promise<void>;
+export declare function showAccounts(): Promise<void>;

package/dist/cli/commands/accounts.js

@@ -1,113 +1,24 @@
 import chalk from "chalk";
 import { getDb } from "../../db/connection.js";
 import { getAccountBalances } from "../../db/queries/account-balance.js";
-import { visibleLength } from "../format.js";
-import { formatSignedAmount } from "../../currency.js";
-const TYPE_TAG = {
-    asset: "asset",
-    liability: "liab",
-    income: "income",
-    expense: "expense",
-    equity: "equity",
-};
-const TYPE_TAG_WIDTH = 8;
-const TYPE_RANK = {
-    asset: 0,
-    liability: 1,
-    income: 2,
-    expense: 3,
-    equity: 4,
-};
-export async function showAccounts(opts = {}) {
+export async function showAccounts() {
     const db = getDb();
     const accounts = getAccountBalances(db);
     if (accounts.length === 0) {
         console.log(chalk.yellow("No accounts yet. Drop your bank/credit card statements into ~/.plasalid/data/ and run `plasalid scan`."));
         return;
     }
-    const interactive = !opts.noInteractive && Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
-    if (interactive) {
-        const [{ runBrowser }, { AccountsBrowser }, { createElement }, { listPostings },] = await Promise.all([
-            import("../ink/runBrowser.js"),
-            import("../ink/AccountsBrowser.js"),
-            import("react"),
-            import("../../db/queries/transactions.js"),
-        ]);
-        const recentTransactionsByAccount = new Map();
-        for (const a of accounts) {
-            const rows = listPostings(db, { account_id: a.id, limit: 10 });
-            if (rows.length > 0)
-                recentTransactionsByAccount.set(a.id, rows);
-        }
-        await runBrowser(createElement(AccountsBrowser, { accounts, recentTransactionsByAccount }));
-        return;
-    }
-    printAccountsPlain(accounts);
-}
-function printAccountsPlain(raw) {
-    const byId = new Map(raw.map((a) => [a.id, a]));
-    const depthCache = new Map();
-    const depthOf = (id) => {
-        if (depthCache.has(id))
-            return depthCache.get(id);
-        const node = byId.get(id);
-        if (!node || !node.parent_id) {
-            depthCache.set(id, 0);
-            return 0;
-        }
-        const d = depthOf(node.parent_id) + 1;
-        depthCache.set(id, d);
-        return d;
-    };
-    const accounts = [...raw].sort((a, b) => {
-        const t = TYPE_RANK[a.type] - TYPE_RANK[b.type];
-        if (t !== 0)
-            return t;
-        return a.id.localeCompare(b.id);
-    });
-    const balanceWidth = Math.max(...accounts.map((a) => formatSignedAmount(a.balance).length));
-    const nameWidth = Math.max(...accounts.map((a) => a.name.length + depthOf(a.id) * 2));
+    const [{ runBrowser }, { AccountsBrowser }, { createElement }, { listPostings },] = await Promise.all([
+        import("../ink/runBrowser.js"),
+        import("../ink/AccountsBrowser.js"),
+        import("react"),
+        import("../../db/queries/transactions.js"),
+    ]);
+    const recentTransactionsByAccount = new Map();
     for (const a of accounts) {
-        const tag = chalk.dim(TYPE_TAG[a.type].padEnd(TYPE_TAG_WIDTH));
-        const indent = "  ".repeat(depthOf(a.id));
-        const displayName = indent + a.name;
-        const name = chalk.bold(displayName) + " ".repeat(nameWidth - displayName.length);
-        const rawBalance = formatSignedAmount(a.balance);
-        const coloredBalance = a.balance < 0 ? chalk.red(rawBalance) : rawBalance;
-        const paddedBalance = " ".repeat(balanceWidth - visibleLength(coloredBalance)) + coloredBalance;
-        const meta = compactMeta(a);
-        const metaStr = meta.length ? `   ${chalk.dim(meta.join(" · "))}` : "";
-        console.log(`  ${tag}  ${name}   ${paddedBalance}${metaStr}`);
+        const rows = listPostings(db, { account_id: a.id, limit: 10 });
+        if (rows.length > 0)
+            recentTransactionsByAccount.set(a.id, rows);
     }
-    let assets = 0, liabilities = 0;
-    for (const a of accounts) {
-        if (a.type === "asset")
-            assets += a.balance;
-        else if (a.type === "liability")
-            liabilities += a.balance;
-    }
-    const netWorth = assets - liabilities;
-    console.log("");
-    console.log("  " +
-        chalk.dim(`Assets ${formatSignedAmount(assets)}`) +
-        chalk.dim("   ·   ") +
-        chalk.dim(`Liabilities ${formatSignedAmount(liabilities)}`) +
-        chalk.dim("   ·   ") +
-        chalk.bold(`Net worth ${formatSignedAmount(netWorth)}`));
-}
-function compactMeta(a) {
-    const meta = [];
-    if (a.bank_name)
-        meta.push(a.bank_name);
-    if (a.due_day)
-        meta.push(`due ${a.due_day}`);
-    if (a.statement_day)
-        meta.push(`stmt ${a.statement_day}`);
-    if (a.points_balance)
-        meta.push(`${a.points_balance.toLocaleString()} pts`);
-    if (a.currency && a.currency !== "THB")
-        meta.push(a.currency);
-    if (meta.length === 0 && a.subtype)
-        meta.push(a.subtype);
-    return meta;
+    await runBrowser(createElement(AccountsBrowser, { accounts, recentTransactionsByAccount }));
 }

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

@@ -1,16 +1,8 @@
 import type Database from "libsql";
-export interface ForgetMatch {
+export interface RuleEntry {
     displayId: string;
     text: string;
+    forget(db: Database.Database): void;
 }
-export type ForgetOutcome = {
-    ok: true;
-    matched: ForgetMatch[];
-} | {
-    ok: false;
-    error: string;
-};
-export declare function renderRules(db: Database.Database): string;
-export declare function forgetRules(db: Database.Database, pattern: string): ForgetOutcome;
-export declare function showRules(): void;
-export declare function forgetRule(pattern: string): void;
+export declare function collectRules(db: Database.Database): RuleEntry[];
+export declare function showRules(): Promise<void>;

package/dist/cli/commands/rules.js

@@ -2,7 +2,7 @@ import chalk from "chalk";
 import { getDb } from "../../db/connection.js";
 import { getMemories, deleteMemory } from "../../ai/memory.js";
 import { listMerchants, clearMerchantDefaultAccount, } from "../../db/queries/merchants.js";
-function collectRules(db) {
+export function collectRules(db) {
     const out = [];
     for (const m of getMemories(db)) {
         out.push({
@@ -25,55 +25,18 @@ function collectRules(db) {
     });
     return out;
 }
-export function renderRules(db) {
+export async function showRules() {
+    const db = getDb();
     const rules = collectRules(db);
     if (rules.length === 0) {
-        return ("No rules yet.\n\n" +
+        console.log("No rules yet.\n\n" +
             chalk.dim("Rules accumulate as you clarify questions. Run `plasalid clarify` after a scan."));
-    }
-    const width = Math.max(...rules.map((r) => r.displayId.length));
-    const lines = [chalk.bold(`Rules (${rules.length}):`)];
-    for (const r of rules) {
-        lines.push(`  ${chalk.cyan(r.displayId.padEnd(width))}  ${r.text}`);
-    }
-    lines.push("");
-    lines.push(chalk.dim("To remove: plasalid forget <regex>"));
-    return lines.join("\n");
-}
-export function forgetRules(db, pattern) {
-    let re;
-    try {
-        re = new RegExp(`^${pattern}$`);
-    }
-    catch (err) {
-        return { ok: false, error: `Invalid regex /${pattern}/: ${err instanceof Error ? err.message : String(err)}` };
-    }
-    const snapshot = collectRules(db);
-    const hits = snapshot.filter((r) => re.test(r.displayId));
-    if (!hits.length) {
-        return {
-            ok: false,
-            error: `No rule matches /${pattern}/. Run \`plasalid rules\` to list ids.`,
-        };
-    }
-    const matched = hits.map((r) => {
-        r.forget(db);
-        return { displayId: r.displayId, text: r.text };
-    });
-    return { ok: true, matched };
-}
-export function showRules() {
-    console.log(renderRules(getDb()));
-}
-export function forgetRule(pattern) {
-    const outcome = forgetRules(getDb(), pattern);
-    if (!outcome.ok) {
-        console.error(chalk.red(outcome.error));
-        process.exitCode = 1;
         return;
     }
-    const width = Math.max(...outcome.matched.map((m) => m.displayId.length));
-    for (const m of outcome.matched) {
-        console.log(`Forgot ${chalk.cyan(m.displayId.padEnd(width))}  ${m.text}`);
-    }
+    const [{ runBrowser }, { RulesBrowser }, { createElement }] = await Promise.all([
+        import("../ink/runBrowser.js"),
+        import("../ink/RulesBrowser.js"),
+        import("react"),
+    ]);
+    await runBrowser(createElement(RulesBrowser, { rules, db }));
 }

package/dist/cli/commands/scan.js

@@ -69,10 +69,12 @@ async function buildTtyHooks(signal) {
     let inkInstance = null;
     let unsubscribeProgress = null;
     const chunkLookup = new Map();
-    // Surface cancellation through Ink's controller, not raw stdout — writing
-    // to stdout while Ink is rendering corrupts its frame tracking and leaves
-    // a phantom copy of the header in scrollback. once:true so the listener
-    // self-removes without leaking past the scan run.
+    /**
+     * Surface cancellation through Ink's controller, not raw stdout — writing
+     * to stdout while Ink is rendering corrupts its frame tracking and leaves
+     * a phantom copy of the header in scrollback. once:true so the listener
+     * self-removes without leaking past the scan run.
+     */
     const onAbortEvt = () => {
         controller.publish({ type: "phase-set", phase: "cancelling" });
     };
@@ -86,11 +88,6 @@ async function buildTtyHooks(signal) {
             }
             console.log(chalk.dim(`Decrypted ${s.decrypted.length}, skipped ${s.skipped.length}, failed ${s.failed.length}.`));
         },
-        afterChunk: (s) => {
-            if (s.chunks.length === 0)
-                return;
-            console.log(chalk.dim(`Chunked into ${s.chunks.length} page(s). Mounting dashboard…`));
-        },
         beforeParse: (s) => {
             for (const c of s.chunks)
                 chunkLookup.set(c.chunkId, {

package/dist/cli/commands/status.js

@@ -8,10 +8,13 @@ import { countQuestions } from "../../db/queries/questions.js";
 import { countMemories } from "../../ai/memory.js";
 import { config, getActiveModel } from "../../config.js";
 import { formatAmount } from "../../currency.js";
-import { visibleLength } from "../format.js";
+import { banner, visibleLength } from "../format.js";
 const LABEL_WIDTH = 18;
 export function showStatus() {
     const db = getDb();
+    console.log("");
+    console.log(banner());
+    console.log("");
     printSection("Financial", financialRows(db));
     console.log("");
     printSection("System", systemRows(db));
@@ -83,8 +86,7 @@ function modelRows() {
 }
 function printSection(title, rows, opts) {
     const align = opts?.align ?? "right";
-    console.log(chalk.bold(title));
-    console.log(chalk.dim("─".repeat(title.length)));
+    console.log(chalk.bold.yellow(title));
     const valueWidth = Math.max(0, ...rows.map((r) => visibleLength(r.value)));
     for (const row of rows) {
         const label = row.label.padEnd(LABEL_WIDTH);

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

@@ -4,7 +4,5 @@ export interface ShowTransactionsOptions {
     to?: string;
     query?: string;
     limit?: number;
-    /** Force the plain-print path even when stdout is a TTY. */
-    noInteractive?: boolean;
 }
 export declare function showTransactions(opts: ShowTransactionsOptions): Promise<void>;

package/dist/cli/commands/transactions.js

@@ -1,39 +1,27 @@
 import chalk from "chalk";
 import { getDb } from "../../db/connection.js";
-import { groupByTransaction, listPostings, } from "../../db/queries/transactions.js";
-import { visibleLength } from "../format.js";
-import { formatAmount } from "../../currency.js";
-import { truncateMiddle } from "../helper.js";
-const ACCOUNT_CAP = 32;
-const MEMO_CAP = 40;
-const INTERACTIVE_LIMIT = 1000;
-const RECURRING_MARKER = "[R]";
+import { listPostings } from "../../db/queries/transactions.js";
+const DEFAULT_LIMIT = 1000;
 export async function showTransactions(opts) {
     const db = getDb();
-    const interactive = !opts.noInteractive && Boolean(process.stdout.isTTY) && Boolean(process.stdin.isTTY);
-    const requestedLimit = opts.limit ?? (interactive ? INTERACTIVE_LIMIT : 100);
     const postings = listPostings(db, {
         account_id: opts.account,
         from: opts.from,
         to: opts.to,
         q: opts.query,
-        limit: requestedLimit,
+        limit: opts.limit ?? DEFAULT_LIMIT,
     });
     if (postings.length === 0) {
         console.log(chalk.yellow("No postings match those filters."));
         return;
     }
-    if (interactive) {
-        const filterSummary = buildFilterSummary(opts);
-        const [{ runBrowser }, { TransactionsBrowser }, { createElement }] = await Promise.all([
-            import("../ink/runBrowser.js"),
-            import("../ink/TransactionsBrowser.js"),
-            import("react"),
-        ]);
-        await runBrowser(createElement(TransactionsBrowser, { postings, filterSummary }));
-        return;
-    }
-    printTransactionsPlain(postings);
+    const filterSummary = buildFilterSummary(opts);
+    const [{ runBrowser }, { TransactionsBrowser }, { createElement }] = await Promise.all([
+        import("../ink/runBrowser.js"),
+        import("../ink/TransactionsBrowser.js"),
+        import("react"),
+    ]);
+    await runBrowser(createElement(TransactionsBrowser, { postings, filterSummary }));
 }
 function buildFilterSummary(opts) {
     const parts = [];
@@ -47,44 +35,3 @@ function buildFilterSummary(opts) {
         parts.push(`query="${opts.query}"`);
     return parts.join(" · ");
 }
-function printTransactionsPlain(postings) {
-    const truncatedAccount = new Map();
-    const truncatedMemo = new Map();
-    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(...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, p.currency)}`.length;
-    }));
-    const cols = process.stdout.columns || 100;
-    const descMax = Math.max(20, cols - 14);
-    const groups = groupByTransaction(postings);
-    for (const g of groups) {
-        const desc = truncateMiddle(g.description, descMax);
-        const merchant = g.merchant ? chalk.green(`  · ${g.merchant}`) : "";
-        const recurring = g.recurrence_id ? chalk.dim(`  ${RECURRING_MARKER}`) : "";
-        console.log(`${chalk.dim(g.date)}  ${chalk.bold(desc)}${merchant}${recurring}`);
-        for (const p of g.postings) {
-            const acct = truncatedAccount.get(p.id);
-            const acctPadded = acct + " ".repeat(accountWidth - acct.length);
-            const side = p.debit > 0 ? "DR" : "CR";
-            const amt = p.debit > 0 ? p.debit : p.credit;
-            const rawAmount = `${side} ${formatAmount(amt, p.currency)}`;
-            const colored = p.debit > 0 ? chalk.cyan(rawAmount) : chalk.magenta(rawAmount);
-            const amountPadded = " ".repeat(amountWidth - visibleLength(colored)) + colored;
-            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} transactions · ${postings.length} postings`));
-    }
-}

package/dist/cli/format.js

@@ -58,43 +58,33 @@ export function banner() {
         chalk.bold("Plasalid") +
         chalk.dim("  ·  The Harness Layer for Personal Finance"));
 }
-function stripAnsi(str) {
-    return str.replace(ANSI_RE, "");
-}
-function box(label, lines) {
-    const cols = process.stdout.columns || 100;
-    const inner = cols - 4;
-    const top = `┌─── ${label} ${"─".repeat(Math.max(0, inner - label.length - 5))}┐`;
-    const bot = `└${"─".repeat(inner + 2)}┘`;
-    const pad = `│${" ".repeat(inner + 2)}│`;
-    const body = lines.map((l) => {
-        const vis = stripAnsi(l).length;
-        return `│  ${l}${" ".repeat(Math.max(0, inner - vis))}│`;
-    });
-    return [top, pad, ...body, pad, bot].join("\n");
-}
 const DISCLAIMER = "Plasalid is an assistant, not a financial advisor. It only summarizes financial statements — verify amounts against your statements before relying on them.";
+function section(label, lines) {
+    return [chalk.bold.yellow(label), ...lines.map((l) => `  ${l}`)].join("\n");
+}
 export function helpScreen(commands) {
-    const sections = [
+    const options = [
+        { name: "--version", desc: "Show the version and exit" },
+        { name: "--help", desc: "Show this help screen" },
+    ];
+    const nameWidth = Math.max(...commands.map((c) => c.name.length), ...options.map((o) => o.name.length));
+    const row = (name, desc) => `${chalk.cyan(name.padEnd(nameWidth))}    ${chalk.dim(desc)}`;
+    const usageLines = [
+        `${chalk.cyan("plasalid")} ${chalk.dim("<command> [OPTIONS]")}`,
+        row("plasalid", "Start the chat session"),
+    ];
+    return [
+        "",
         banner(),
         "",
-        box("Usage", [
-            "plasalid <command> [OPTIONS]",
-            "plasalid                       Start the chat session",
-        ]),
+        section("Usage", usageLines),
         "",
-    ];
-    const nameWidth = Math.max(...commands.map((c) => c.name.length));
-    const cmdLines = commands.map((c) => `${chalk.white(c.name.padEnd(nameWidth))}    ${chalk.dim(c.desc)}`);
-    sections.push(box("Commands", cmdLines));
-    sections.push("");
-    sections.push(box("Options", [
-        `${chalk.white("--version".padEnd(nameWidth))}    ${chalk.dim("Show the version and exit")}`,
-        `${chalk.white("--help".padEnd(nameWidth))}    ${chalk.dim("Show this help screen")}`,
-    ]));
-    sections.push("");
-    sections.push(chalk.dim(DISCLAIMER));
-    return sections.join("\n");
+        section("Commands", commands.map((c) => row(c.name, c.desc))),
+        "",
+        section("Options", options.map((o) => row(o.name, o.desc))),
+        "",
+        chalk.dim(DISCLAIMER),
+    ].join("\n");
 }
 export function formatResponse(text) {
     return text

package/dist/cli/index.js

@@ -13,13 +13,7 @@ function ensureConfigured() {
         process.exit(1);
     }
 }
-program
-    .name("plasalid")
-    .description("The Harness Layer for Personal Finance")
-    .version(version)
-    .addHelpCommand(false)
-    .showHelpAfterError(`Run ${chalk.cyan("plasalid --help")} for the list of commands.`)
-    .action(async () => {
+async function runChatOrSetup() {
     if (!isConfigured()) {
         console.log("Plasalid is not configured yet. Running setup...\n");
         const { runSetup } = await import("./setup.js");
@@ -28,7 +22,18 @@ program
     }
     const { startChat } = await import("./chat.js");
     await startChat();
-});
+}
+program
+    .name("plasalid")
+    .description("The Harness Layer for Personal Finance")
+    .version(version)
+    .addHelpCommand(false)
+    .showHelpAfterError(`Run ${chalk.cyan("plasalid --help")} for the list of commands.`)
+    .action(runChatOrSetup);
+program
+    .command("chat")
+    .description("Open the chat TUI (the default action when running `plasalid`)")
+    .action(runChatOrSetup);
 program
     .command("setup")
     .description("Configure Plasalid (API key, encryption, data directory)")
@@ -46,12 +51,11 @@ program
 });
 program
     .command("accounts")
-    .description("Browse the chart of accounts with balances (interactive TTY) or print them (piped)")
-    .option("--no-interactive", "Force plain-print output instead of the Ink browser")
-    .action(async (opts) => {
+    .description("Browse the chart of accounts with balances")
+    .action(async () => {
     ensureConfigured();
     const { showAccounts } = await import("./commands/accounts.js");
-    await showAccounts({ noInteractive: opts.interactive === false });
+    await showAccounts();
 });
 program
     .command("status")
@@ -63,13 +67,12 @@ program
 });
 program
     .command("transactions")
-    .description("Browse transactions (interactive TTY) or print them (piped)")
+    .description("Browse transactions")
     .option("-a, --account <id>", "Filter by account id")
     .option("--from <date>", "From date YYYY-MM-DD")
     .option("--to <date>", "To date YYYY-MM-DD")
     .option("-q, --query <text>", "Free-text search on description / memo")
-    .option("-n, --limit <number>", "Max results (default 1000 interactive, 100 piped)")
-    .option("--no-interactive", "Force plain-print output instead of the Ink browser")
+    .option("-n, --limit <number>", "Max results (default 1000)")
     .action(async (opts) => {
     ensureConfigured();
     const { showTransactions } = await import("./commands/transactions.js");
@@ -79,8 +82,6 @@ program
         to: opts.to,
         query: opts.query,
         limit: opts.limit != null ? Number(opts.limit) : undefined,
-        // commander inverts --no-foo to `opts.foo = false`
-        noInteractive: opts.interactive === false,
     });
 });
 program
@@ -120,19 +121,11 @@ program
 });
 program
     .command("rules")
-    .description("List rules the system has learned")
+    .description("Browse the rules the system has learned (press d to delete)")
     .action(async () => {
     ensureConfigured();
     const { showRules } = await import("./commands/rules.js");
-    showRules();
-});
-program
-    .command("forget <regex>")
-    .description("Delete every learned rule whose id matches <regex> (anchored). Run `plasalid rules` to list ids.")
-    .action(async (regex) => {
-    ensureConfigured();
-    const { forgetRule } = await import("./commands/rules.js");
-    forgetRule(regex);
+    await showRules();
 });
 program
     .command("clarify")
@@ -144,6 +137,10 @@ program
 });
 program.configureHelp({
     formatHelp: () => helpScreen([
+        {
+            name: "chat",
+            desc: "Open the chat TUI (default when running `plasalid`)",
+        },
         {
             name: "setup",
             desc: "Configure Plasalid (API key, encryption, data dir)",
@@ -152,11 +149,11 @@ program.configureHelp({
             name: "data",
             desc: "Open the data folder in your OS file explorer (alias: open)",
         },
-        { name: "accounts", desc: "Browse the chart of accounts (interactive TTY) or list them (piped)" },
+        { name: "accounts", desc: "Browse the chart of accounts with balances" },
         { name: "status", desc: "Show financial and system status (net worth, recurring, questions)" },
         {
             name: "transactions",
-            desc: "Browse transactions (interactive TTY) or list them (piped/--no-interactive)",
+            desc: "Browse transactions (with optional filters)",
         },
         {
             name: "record",
@@ -168,11 +165,7 @@ program.configureHelp({
         },
         {
             name: "rules",
-            desc: "List rules the system has learned",
-        },
-        {
-            name: "forget",
-            desc: "Delete learned rules whose ids match <regex> (anchored)",
+            desc: "Browse the rules the system has learned (press d to delete)",
         },
         {
             name: "clarify",

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

@@ -1,4 +1,5 @@
 import { type ReactNode } from "react";
+import { type Key } from "ink";
 export interface ListBrowserAdapter<T> {
     title: string;
     filterSummary?: string;
@@ -22,6 +23,12 @@ export interface ListBrowserAdapter<T> {
     summary?: ReactNode;
     /** Optional override for the "no results" empty state. */
     emptyMessage?: string;
+    /** Adapter-owned key handler. Runs after search-mode and before built-in
+     *  navigation; return true to mark the key consumed so default handling
+     *  (q/arrows/g/G/return/etc.) is skipped. */
+    onKey?: (input: string, key: Key, ctx: {
+        cursorItem: T | null;
+    }) => boolean;
 }
 /**
  * Alternate-screen list browser shell. The type-specific behavior lives in the

package/dist/cli/ink/ListBrowser.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { memo, useEffect, useMemo, useState } from "react";
 import { Box, Text, useApp, useInput, useStdout } from "ink";
+import { keyOf } from "./keys.js";
 const HEADER_LINES = 2; // title + rule
 const FOOTER_LINES = 2; // rule + hint
 const SUMMARY_LINES = 1; // optional aggregate footer
@@ -73,66 +74,52 @@ export function ListBrowser({ adapter }) {
         });
     }, [cursor, effectiveViewportSize, filtered.length]);
     useInput((input, key) => {
+        const k = keyOf(input, key);
+        const last = Math.max(0, filtered.length - 1);
         if (searchMode) {
-            if (key.return || key.escape) {
-                setSearchMode(false);
-                return;
-            }
-            if (key.backspace || key.delete) {
-                setSearch(prev => prev.slice(0, -1));
+            const SEARCH_KEYS = {
+                return: () => setSearchMode(false),
+                escape: () => setSearchMode(false),
+                backspace: () => setSearch(prev => prev.slice(0, -1)),
+                delete: () => setSearch(prev => prev.slice(0, -1)),
+            };
+            const handler = SEARCH_KEYS[k];
+            if (handler) {
+                handler();
                 return;
             }
             if (input && !key.ctrl && !key.meta)
                 setSearch(prev => prev + input);
             return;
         }
-        if (input === "q" || key.escape) {
-            exit();
+        if (adapter.onKey?.(input, key, { cursorItem: filtered[cursor] ?? null }))
             return;
-        }
-        if (input === "/") {
-            setSearchMode(true);
-            return;
-        }
-        const last = Math.max(0, filtered.length - 1);
         const move = (delta) => {
             setExpandedId(null);
             setCursor(c => Math.max(0, Math.min(last, c + delta)));
         };
-        if (key.upArrow || input === "k") {
-            move(-1);
-            return;
-        }
-        if (key.downArrow || input === "j") {
-            move(1);
-            return;
-        }
-        if (key.pageUp) {
-            move(-viewportSize);
-            return;
-        }
-        if (key.pageDown) {
-            move(viewportSize);
-            return;
-        }
-        if (input === "g") {
-            setExpandedId(null);
-            setCursor(0);
-            return;
-        }
-        if (input === "G") {
-            setExpandedId(null);
-            setCursor(last);
-            return;
-        }
-        if (key.return) {
+        const toggleExpand = () => {
             const item = filtered[cursor];
-            if (item) {
-                const id = adapter.getId(item);
-                setExpandedId(prev => prev === id ? null : id);
-            }
-            return;
-        }
+            if (!item)
+                return;
+            const id = adapter.getId(item);
+            setExpandedId(prev => prev === id ? null : id);
+        };
+        const NAV_KEYS = {
+            q: exit,
+            escape: exit,
+            "/": () => setSearchMode(true),
+            k: () => move(-1),
+            upArrow: () => move(-1),
+            j: () => move(1),
+            downArrow: () => move(1),
+            pageUp: () => move(-viewportSize),
+            pageDown: () => move(viewportSize),
+            g: () => { setExpandedId(null); setCursor(0); },
+            G: () => { setExpandedId(null); setCursor(last); },
+            return: toggleExpand,
+        };
+        NAV_KEYS[k]?.();
     });
     const ruleWidth = Math.min(cols, 120);
     const visibleEnd = Math.min(filtered.length, scrollOffset + effectiveViewportSize);

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

@@ -0,0 +1,7 @@
+import type Database from "libsql";
+import type { RuleEntry } from "../commands/rules.js";
+export interface RulesBrowserProps {
+    rules: RuleEntry[];
+    db: Database.Database;
+}
+export declare function RulesBrowser({ rules: initialRules, db }: RulesBrowserProps): import("react/jsx-runtime").JSX.Element;

package/dist/cli/ink/RulesBrowser.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useMemo, useState } from "react";
+import { Text } from "ink";
+import chalk from "chalk";
+import { padRight, truncateMiddle } from "../helper.js";
+import { ListBrowser } from "./ListBrowser.js";
+import { keyOf } from "./keys.js";
+const MIN_TEXT_WIDTH = 16;
+export function RulesBrowser({ rules: initialRules, db }) {
+    const [rules, setRules] = useState(initialRules);
+    const [confirmId, setConfirmId] = useState(null);
+    const idWidth = useMemo(() => (rules.length === 0 ? 0 : Math.max(...rules.map((r) => r.displayId.length))), [rules]);
+    const adapter = useMemo(() => {
+        const commitDelete = () => {
+            const target = rules.find((r) => r.displayId === confirmId);
+            if (target) {
+                target.forget(db);
+                setRules((prev) => prev.filter((r) => r.displayId !== confirmId));
+            }
+            setConfirmId(null);
+        };
+        const cancelConfirm = () => setConfirmId(null);
+        const CONFIRM_KEYS = {
+            y: commitDelete,
+            n: cancelConfirm,
+            escape: cancelConfirm,
+        };
+        const BROWSE_KEYS = {
+            d: (cursorItem) => {
+                if (!cursorItem)
+                    return false;
+                setConfirmId(cursorItem.displayId);
+                return true;
+            },
+        };
+        return {
+            title: "Rules",
+            items: rules,
+            getId: (r) => r.displayId,
+            renderRow: (r, ctx) => renderRuleRow(r, ctx.isCursor, ctx.cols, idWidth),
+            matches: (r, needle) => r.displayId.toLowerCase().includes(needle) ||
+                r.text.toLowerCase().includes(needle),
+            emptyMessage: "No rules yet. Rules accumulate as you clarify questions. Run `plasalid clarify` after a scan.",
+            summary: confirmId ? (_jsx(Text, { color: "yellow", children: `Delete ${confirmId}? (y/n)` })) : undefined,
+            onKey: (input, key, { cursorItem }) => {
+                const k = keyOf(input, key).toLowerCase();
+                if (confirmId !== null) {
+                    CONFIRM_KEYS[k]?.();
+                    return true; // confirm mode swallows everything else
+                }
+                return BROWSE_KEYS[k]?.(cursorItem) ?? false;
+            },
+        };
+    }, [rules, idWidth, confirmId, db]);
+    return _jsx(ListBrowser, { adapter: adapter });
+}
+function renderRuleRow(r, isCursor, cols, idWidth) {
+    const marker = isCursor ? "▸" : " ";
+    const idPadded = padRight(r.displayId, idWidth);
+    const id = isCursor ? chalk.cyan.bold(idPadded) : chalk.cyan(idPadded);
+    // Layout: "M idPadded  text" → marker(1) + space + idPadded + 2 + text
+    const fixedWidth = 1 + 1 + idWidth + 2;
+    const textBudget = Math.max(MIN_TEXT_WIDTH, cols - fixedWidth - 2);
+    const textRaw = truncateMiddle(r.text, textBudget);
+    const text = isCursor ? chalk.bold(textRaw) : textRaw;
+    return `${marker} ${id}  ${text}`;
+}

package/dist/cli/ink/ScanDashboard.js

@@ -37,7 +37,7 @@ export function ScanDashboard(props) {
     return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Header, { phase: phase }), _jsx(AttachmentLine, { info: props.attachment }), _jsx(Box, { marginTop: 1, children: _jsx(ColumnHeader, {}) }), _jsx(Divider, { width: ruleWidth }), Array.from(rows.entries()).map(([fileId, group]) => (_jsx(FileGroupView, { group: group }, fileId))), _jsx(Divider, { width: ruleWidth }), phase !== "done" && _jsx(Footnote, {})] }));
 }
 function Footnote() {
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "output accuracy depends on the model's VL capability." }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "we also provide " }), _jsx(Text, { color: "cyan", children: "clarify" }), _jsx(Text, { dimColor: true, children: ", " }), _jsx(Text, { color: "cyan", children: "record" }), _jsx(Text, { dimColor: true, children: ", and " }), _jsx(Text, { color: "cyan", children: "chat" }), _jsx(Text, { dimColor: true, children: " to rectify the data later." })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "output accuracy depends on the model's vision capability." }), _jsxs(Text, { children: [_jsx(Text, { dimColor: true, children: "by the way, user can run" }), _jsx(Text, { color: "cyan", children: "clarify" }), _jsx(Text, { dimColor: true, children: ", " }), _jsx(Text, { color: "cyan", children: "record" }), _jsx(Text, { dimColor: true, children: ", and " }), _jsx(Text, { color: "cyan", children: "chat" }), _jsx(Text, { dimColor: true, children: " to correct the data later." })] })] }));
 }
 function AttachmentLine({ info }) {
     const detail = info.format === "pdf" ? "pdf (native)" : "png (rasterized)";
@@ -81,9 +81,6 @@ function phaseStateOf(label, current) {
     return "pending";
 }
 function Header({ phase }) {
-    // Cancellation collapses the parse/clarify segments — neither is still
-    // running once the user hits Ctrl+C, and showing them as "pending" would
-    // be misleading. The single "cancelling…" label communicates the wind-down.
     if (phase === "cancelling") {
         return (_jsxs(Text, { children: [_jsx(Text, { bold: true, children: "Scanner" }), _jsx(Text, { dimColor: true, children: "  ·  " }), _jsx(Text, { color: "green", children: "\u2713 decrypt" }), _jsx(Text, { dimColor: true, children: " -> " }), _jsx(Text, { color: "green", children: "\u2713 chunk" }), _jsx(Text, { dimColor: true, children: " -> " }), _jsxs(Text, { color: "red", children: [_jsx(Spinner, { type: "dots" }), " cancelling\u2026"] })] }));
     }

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

@@ -0,0 +1,2 @@
+import type { Key } from "ink";
+export declare function keyOf(input: string, key: Key): string;

package/dist/cli/ink/keys.js

@@ -0,0 +1,19 @@
+const SPECIAL = [
+    [(k) => k.escape, "escape"],
+    [(k) => k.return, "return"],
+    [(k) => k.backspace, "backspace"],
+    [(k) => k.delete, "delete"],
+    [(k) => k.upArrow, "upArrow"],
+    [(k) => k.downArrow, "downArrow"],
+    [(k) => k.leftArrow, "leftArrow"],
+    [(k) => k.rightArrow, "rightArrow"],
+    [(k) => k.pageUp, "pageUp"],
+    [(k) => k.pageDown, "pageDown"],
+    [(k) => k.tab, "tab"],
+];
+export function keyOf(input, key) {
+    for (const [pred, name] of SPECIAL)
+        if (pred(key))
+            return name;
+    return input;
+}

package/dist/scanner/parse.js

@@ -43,10 +43,12 @@ export async function parsePhase(db, state, hooks) {
                 error: errorMessage(r.error),
             });
     }
-    // Only flip files to "scanned" for groups that actually completed. On abort
-    // the pool leaves later groups unclaimed (their settled slot is undefined);
-    // those rows stay `pending` so a future re-scan can pick them up. Partial
-    // transactions already committed during the run stay (scanner is DB-direct).
+    /**
+     * Only flip files to "scanned" for groups that actually completed. On abort
+     * the pool leaves later groups unclaimed (their settled slot is undefined);
+     * those rows stay `pending` so a future re-scan can pick them up. Partial
+     * transactions already committed during the run stay (scanner is DB-direct).
+     */
     for (let i = 0; i < fileGroups.length; i++) {
         if (!settled[i])
             continue;

package/dist/scanner/worker.js

@@ -43,8 +43,10 @@ export async function runScanWorker(deps, hooks) {
     }));
     hooks.onWorkerEnd?.(workerId, deps.chunk, outcome.ok);
     if (!outcome.ok) {
-        // A worker whose in-flight call was cancelled by Ctrl+C is not a real
-        // failure — don't pollute the questions table with chunk_failed rows.
+        /**
+         * A worker whose in-flight call was cancelled by Ctrl+C is not a real
+         * failure — don't pollute the questions table with chunk_failed rows.
+         */
         if (deps.signal.aborted)
             return;
         recordChunkFailure(deps, outcome.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plasalid",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Plasalid — The Harness Layer for Personal Finance",
   "keywords": [
     "finance",