plasalid 0.8.2 → 0.9.0

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
@@ -119,20 +120,20 @@ program
     await runScanCommand({ regex: regexes[0], force: !!opts.force, parallel });
 });
 program
-    .command("rules")
-    .description("List rules the system has learned")
+    .command("files")
+    .description("Browse scanned files; press d to drop one and cascade-remove its data")
     .action(async () => {
     ensureConfigured();
-    const { showRules } = await import("./commands/rules.js");
-    showRules();
+    const { showFiles } = await import("./commands/files.js");
+    await showFiles();
 });
 program
-    .command("forget <regex>")
-    .description("Delete every learned rule whose id matches <regex> (anchored). Run `plasalid rules` to list ids.")
-    .action(async (regex) => {
+    .command("rules")
+    .description("Browse the rules the system has learned (press d to delete)")
+    .action(async () => {
     ensureConfigured();
-    const { forgetRule } = await import("./commands/rules.js");
-    forgetRule(regex);
+    const { showRules } = await import("./commands/rules.js");
+    await showRules();
 });
 program
     .command("clarify")
@@ -144,6 +145,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 +157,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",
@@ -167,12 +172,12 @@ program.configureHelp({
             desc: "Scan new PDFs (optionally by regex; --force to re-scan)",
         },
         {
-            name: "rules",
-            desc: "List rules the system has learned",
+            name: "files",
+            desc: "Browse scanned files; press d to drop one and cascade-remove its data",
         },
         {
-            name: "forget",
-            desc: "Delete learned rules whose ids match <regex> (anchored)",
+            name: "rules",
+            desc: "Browse the rules the system has learned (press d to delete)",
         },
         {
             name: "clarify",

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

@@ -0,0 +1,7 @@
+import type Database from "libsql";
+import { type ScannedFileRow } from "../../db/queries/files.js";
+export interface FilesBrowserProps {
+    files: ScannedFileRow[];
+    db: Database.Database;
+}
+export declare function FilesBrowser({ files: initialFiles, db }: FilesBrowserProps): import("react/jsx-runtime").JSX.Element;

package/dist/cli/ink/FilesBrowser.js

@@ -0,0 +1,103 @@
+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";
+import { getDataDir } from "../../config.js";
+import { deleteScannedFile, } from "../../db/queries/files.js";
+import { countTransactionsBySourceFile } from "../../db/queries/transactions.js";
+import { countQuestions } from "../../db/queries/questions.js";
+const COL = {
+    status: 9,
+    provenance: 28,
+    scannedAt: 20,
+};
+const MIN_PATH_WIDTH = 16;
+const MAX_PATH_WIDTH = 50;
+const STATUS_COLOR = {
+    scanned: chalk.green,
+    failed: chalk.red,
+    pending: chalk.gray,
+};
+export function FilesBrowser({ files: initialFiles, db }) {
+    const [files, setFiles] = useState(initialFiles);
+    const [confirm, setConfirm] = useState(null);
+    const adapter = useMemo(() => {
+        const commitDelete = () => {
+            if (!confirm)
+                return;
+            deleteScannedFile(db, confirm.fileId);
+            setFiles(prev => prev.filter(f => f.id !== confirm.fileId));
+            setConfirm(null);
+        };
+        const cancelConfirm = () => setConfirm(null);
+        const CONFIRM_KEYS = {
+            y: commitDelete,
+            n: cancelConfirm,
+            escape: cancelConfirm,
+        };
+        const BROWSE_KEYS = {
+            d: (cursorItem) => {
+                if (!cursorItem)
+                    return false;
+                setConfirm({
+                    fileId: cursorItem.id,
+                    path: cursorItem.path,
+                    cascadeTx: countTransactionsBySourceFile(db, cursorItem.id),
+                    // includeDeferred: true so the count matches what ON DELETE CASCADE will actually drop.
+                    cascadeQuestions: countQuestions(db, { file_id: cursorItem.id, includeDeferred: true }),
+                });
+                return true;
+            },
+        };
+        return {
+            title: "Scanned files",
+            items: files,
+            getId: f => f.id,
+            renderRow: (f, ctx) => renderFileRow(f, ctx.isCursor, ctx.cols),
+            matches: (f, needle) => f.path.toLowerCase().includes(needle) ||
+                (f.provider ?? "").toLowerCase().includes(needle) ||
+                (f.model ?? "").toLowerCase().includes(needle),
+            emptyMessage: "No scanned files match the current filter.",
+            summary: confirm ? (_jsx(Text, { color: "yellow", children: `Delete ${truncateMiddle(confirm.path, 60)}? (y/n)  Cascade removes ${confirm.cascadeTx} transaction(s) and ${confirm.cascadeQuestions} question(s).` })) : undefined,
+            onKey: (input, key, { cursorItem }) => {
+                const k = keyOf(input, key).toLowerCase();
+                if (confirm !== null) {
+                    CONFIRM_KEYS[k]?.();
+                    return true;
+                }
+                return BROWSE_KEYS[k]?.(cursorItem) ?? false;
+            },
+        };
+    }, [files, confirm, db]);
+    return _jsx(ListBrowser, { adapter: adapter });
+}
+function renderFileRow(f, isCursor, cols) {
+    const marker = isCursor ? "▸" : " ";
+    const status = STATUS_COLOR[f.status](padRight(f.status, COL.status));
+    const provenanceRaw = f.provider && f.model ? `${f.provider}/${f.model}` : f.status === "failed" ? "(failed)" : "(not stamped)";
+    const provenance = chalk.dim(padRight(truncateMiddle(provenanceRaw, COL.provenance), COL.provenance));
+    const scannedAtRaw = f.scanned_at ?? "—";
+    const scannedAt = chalk.dim(padRight(scannedAtRaw, COL.scannedAt));
+    // Layout: "M status(9)  path(flex)  provenance(28)  scannedAt(20)"
+    const fixedWidth = 1 + 1 + COL.status + 2 + 2 + COL.provenance + 2 + COL.scannedAt;
+    const pathBudget = Math.max(MIN_PATH_WIDTH, Math.min(MAX_PATH_WIDTH, cols - fixedWidth - 2));
+    const pathRaw = truncateMiddle(relativeFromDataDir(f.path), pathBudget);
+    const pathPadded = padRight(pathRaw, pathBudget);
+    const path = isCursor ? chalk.cyan.bold(pathPadded) : pathPadded;
+    return `${marker} ${status}  ${path}  ${provenance}  ${scannedAt}`;
+}
+/** Strip the configured data-dir prefix so the path column shows just the
+ *  meaningful tail (subdirs + filename). Falls back to the absolute path
+ *  for files that somehow live outside the data dir. */
+function relativeFromDataDir(absolutePath) {
+    const dataDir = getDataDir().replace(/\/+$/, "");
+    if (absolutePath === dataDir)
+        return absolutePath;
+    const prefix = dataDir + "/";
+    return absolutePath.startsWith(prefix)
+        ? absolutePath.slice(prefix.length)
+        : absolutePath;
+}

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

@@ -1,7 +1,16 @@
 import { type ReactNode } from "react";
+import { type Key } from "ink";
 export interface ListBrowserAdapter<T> {
-    title: string;
+    /** Title row "{title} · N results · {filterSummary} · cursor/N". Omit to
+     *  hide the title row and its separator rule entirely — useful when the
+     *  adapter supplies its own `headerNode` and the auto-title would be
+     *  redundant (e.g. ScanDashboard). */
+    title?: string;
     filterSummary?: string;
+    /** Optional fixed chrome rendered above the title row. Use this when the
+     *  list needs a multi-line header (e.g. a pipeline status indicator plus
+     *  column labels) that should not scroll with the items. */
+    headerNode?: ReactNode;
     items: T[];
     getId: (item: T) => string;
     /** Returns the row as a single ANSI-colored string for the given context. */
@@ -22,6 +31,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 { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } 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,71 +74,57 @@ 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);
     const visible = filtered.slice(scrollOffset, visibleEnd);
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: adapter.title }), _jsx(Text, { dimColor: true, children: `  ·  ${filtered.length} results` }), adapter.filterSummary ? _jsx(Text, { dimColor: true, children: `  ·  ${adapter.filterSummary}` }) : null, filtered.length > viewportSize ? (_jsx(Text, { dimColor: true, children: `  ·  ${Math.min(cursor + 1, filtered.length)}/${filtered.length}` })) : null] }), _jsx(Text, { dimColor: true, children: "─".repeat(ruleWidth) }), filtered.length === 0 ? (_jsx(Text, { color: "yellow", children: adapter.emptyMessage ?? "No results match the current filter." })) : (_jsx(Box, { flexDirection: "column", children: visible.map((item, i) => {
+    return (_jsxs(Box, { flexDirection: "column", children: [adapter.headerNode, adapter.title ? (_jsxs(_Fragment, { children: [_jsxs(Text, { children: [_jsx(Text, { bold: true, children: adapter.title }), _jsx(Text, { dimColor: true, children: `  ·  ${filtered.length} results` }), adapter.filterSummary ? _jsx(Text, { dimColor: true, children: `  ·  ${adapter.filterSummary}` }) : null, filtered.length > viewportSize ? (_jsx(Text, { dimColor: true, children: `  ·  ${Math.min(cursor + 1, filtered.length)}/${filtered.length}` })) : null] }), _jsx(Text, { dimColor: true, children: "─".repeat(ruleWidth) })] })) : null, filtered.length === 0 ? (_jsx(Text, { color: "yellow", children: adapter.emptyMessage ?? "No results match the current filter." })) : (_jsx(Box, { flexDirection: "column", children: visible.map((item, i) => {
                     const idx = scrollOffset + i;
                     const isCursor = idx === cursor;
                     const id = adapter.getId(item);

package/dist/cli/ink/PromptFrame.js

@@ -7,5 +7,5 @@ export function PromptFrame({ buffer, footerText, showCaret, banner }) {
     const { stdout } = useStdout();
     const cols = stdout?.columns || 80;
     const rule = chalk.dim("─".repeat(cols));
-    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: rule }), _jsx(TextInput, { buffer: buffer, prompt: chalk.dim("❯ "), showCaret: showCaret }), _jsx(Text, { children: rule }), _jsx(Text, { children: chalk.dim(`  ${footerText}`) }), banner ? _jsx(Text, { children: banner }) : null] }));
+    return (_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { children: rule }), _jsx(TextInput, { buffer: buffer, prompt: chalk.dim("❯ "), showCaret: showCaret }), _jsx(Text, { children: rule }), _jsx(Text, { children: `  ${footerText}` }), banner ? _jsx(Text, { children: banner }) : null] }));
 }

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}`;
+}