plasalid 0.3.0 → 0.3.3

package/README.md

@@ -11,13 +11,13 @@
 
 <br />
 
-Plasalid lets you actually *talk* to your money. Drop the bank and credit-card statements you already receive into a folder; Plasalid scans them into a queryable, double-entry database on your own machine. Then chat with it — an AI partner that has read every line and tells you, sharply and proactively, what's going on with your money. Local, private, yours.
+Plasalid lets you actually *talk* to your money. Drop your bank and credit-card statement PDFs into a folder. Plasalid scans every transaction, every balance, every late fee into a double-entry database on your own machine. Then you chat with it — an AI that's read every line and tells you, sharply and proactively, what's going on. Local, private, yours.
 
-Plasalid exists because in markets like Thailand there's no Plaid: bank data is locked behind statement PDFs, and most people can't afford a real financial advisor either. Plasalid closes both gaps. Your statements become a database, and an AI that knows that database becomes the money coach you'd otherwise have to hire. Your machine, your encryption key, your data.
+Plasalid exists because in markets like Thailand there's no Plaid. In the US, a single API gives apps a live view of every balance and transaction across all your accounts — one complete picture of your money. In Thailand, knowing where you stand means logging into five different bank apps in sequence and opening password-protected statement PDFs one by one. Most people just don't bother. And most people can't afford a financial advisor to do it for them either.
 
-In Thailand, personal finance isn't taught in school. Fee-based advisors are out of reach for most households. The loudest "advice" channels are bank salespeople pitching their employer's products. Over 5 million people are already flagged as non-performing borrowers, and a generation that wants to manage money better has nowhere accessible to learn how. Plasalid's bet is that capable AI changes this — the same intelligence that can read a statement can also explain what the numbers mean, surface what's about to go wrong, and coach someone through real decisions about debt, budget, and savings. At zero marginal cost, in your language, on your own machine.
+Personal finance isn't taught well in Thai schools. Fee-based advisors are out of reach for most households. The loudest "advice" channels are bank salespeople pitching their employer's products. The result: over **5 million Thais** are already flagged as non-performing borrowers, and a generation that wants to manage money better has nowhere accessible to learn how. Plasalid's bet is that capable AI changes that. The same intelligence that reads your statements can explain what the numbers mean. It flags what's about to go wrong. It coaches you through real decisions — debt, budget, savings.
 
-Plasalid can also scales upward in case financial survival isn't your question — help you setup a goal for vacation trip, building an emergency fund, choosing investments, planning a down payment or retirement, working toward the freedom to walk away from a bad job. From getting out of debt to financial freedom, Plasalid grows with you.
+And when survival isn't the question anymore, the same Plasalid can scales up with you. Saving for a trip. Building an emergency fund. Choosing investments. Planning a down payment or retirement. Working toward the freedom to walk away from a bad job. From getting out of debt to financial freedom, Plasalid grows with you.
 
 ## Features
 

package/dist/cli/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { Command } from "commander";
 import { createRequire } from "module";
+import chalk from "chalk";
 import { config, isConfigured } from "../config.js";
 import { helpScreen } from "./format.js";
 const require = createRequire(import.meta.url);
@@ -17,6 +18,7 @@ program
     .description("The local-first data layer for personal finance")
     .version(version)
     .addHelpCommand(false)
+    .showHelpAfterError(`Run ${chalk.cyan("plasalid --help")} for the list of commands.`)
     .action(async () => {
     if (!isConfigured()) {
         console.log("Plasalid is not configured yet. Running setup...\n");
@@ -36,6 +38,7 @@ program
 });
 program
     .command("data")
+    .alias("open")
     .description("Open the Plasalid data folder in your OS file explorer")
     .action(async () => {
     const { runDataCommand } = await import("./commands/data.js");
@@ -77,13 +80,24 @@ program
     });
 });
 program
-    .command("scan [regex]")
+    .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)")
-    .action(async (regex, opts) => {
+    .action(async (regexes, opts) => {
     ensureConfigured();
+    if (regexes.length > 1) {
+        console.error(chalk.red(`scan takes a single regex (or none). got ${regexes.length} arguments — your shell likely expanded a glob like '*' to filenames.`));
+        console.error("");
+        console.error("To scan everything in the data dir:");
+        console.error(`  ${chalk.cyan("plasalid scan")}`);
+        console.error("");
+        console.error("To filter with a regex, quote it:");
+        console.error(`  ${chalk.cyan("plasalid scan '.*'")}`);
+        console.error(`  ${chalk.cyan("plasalid scan 'KBank|SCB'")}`);
+        process.exit(1);
+    }
     const { runScanCommand } = await import("./commands/scan.js");
-    await runScanCommand({ regex, force: !!opts.force });
+    await runScanCommand({ regex: regexes[0], force: !!opts.force });
 });
 program
     .command("reconcile")
@@ -112,14 +126,32 @@ program
 });
 program.configureHelp({
     formatHelp: () => helpScreen([
-        { name: "setup", desc: "Configure Plasalid (API key, encryption, data dir)" },
-        { name: "data", desc: "Open the data folder in your OS file explorer" },
+        {
+            name: "setup",
+            desc: "Configure Plasalid (API key, encryption, data dir)",
+        },
+        {
+            name: "data",
+            desc: "Open the data folder in your OS file explorer (alias: open)",
+        },
         { name: "accounts", desc: "Show the chart of accounts with balances" },
         { name: "status", desc: "Show net worth and this-month totals" },
-        { name: "transactions", desc: "List journal lines (filter by account/date/text)" },
-        { name: "scan", desc: "Scan new PDFs (optionally by regex; --force to re-scan)" },
-        { name: "reconcile", desc: "Review and fix existing journal entries / accounts" },
-        { name: "revert", desc: "Delete scanned files matching <regex> and their journal entries" },
+        {
+            name: "transactions",
+            desc: "List journal lines (filter by account/date/text)",
+        },
+        {
+            name: "scan",
+            desc: "Scan new PDFs (optionally by regex; --force to re-scan)",
+        },
+        {
+            name: "reconcile",
+            desc: "Review and fix existing journal entries / accounts",
+        },
+        {
+            name: "revert",
+            desc: "Delete scanned files matching <regex> and their journal entries",
+        },
     ]),
 });
 void config; // keep config import live so dotenv loads

package/dist/scanner/state-machine.d.ts

@@ -4,7 +4,7 @@ import type { StoredPassword } from "./password-store.js";
  * (mupdf calls, prompts, DB reads) live in the orchestrator; this module only
  * encodes the transition logic so it can be exhaustively unit-tested.
  */
-export declare const MAX_PASSWORD_ATTEMPTS = 3;
+export declare const MAX_PASSWORD_ATTEMPTS = 10;
 export type UnlockOutcome = {
     kind: "plaintext";
 } | {

package/dist/scanner/state-machine.js

@@ -3,7 +3,7 @@
  * (mupdf calls, prompts, DB reads) live in the orchestrator; this module only
  * encodes the transition logic so it can be exhaustively unit-tested.
  */
-export const MAX_PASSWORD_ATTEMPTS = 3;
+export const MAX_PASSWORD_ATTEMPTS = 10;
 export function isTerminal(state) {
     return state.kind === "done" || state.kind === "failed";
 }

package/dist/scanner/unlock.js

@@ -3,7 +3,7 @@ import { basename } from "path";
 import { config } from "../config.js";
 import { statusSpinner } from "../cli/ux.js";
 import { findCandidates, savePassword, recordUse, suggestPattern, } from "./password-store.js";
-import { transition, isTerminal, } from "./state-machine.js";
+import { transition, isTerminal, MAX_PASSWORD_ATTEMPTS, } from "./state-machine.js";
 import { isEncrypted, unlock } from "./pdf-unlock.js";
 /**
  * Drive the pure unlock state machine to a terminal state, returning the
@@ -59,7 +59,7 @@ async function stepUnlock(state, ctx) {
                 spinner.succeed("Decrypted.");
                 return { kind: "UNLOCK_OK", decrypted: result.decrypted, password };
             }
-            spinner.fail(`Incorrect password (attempt ${state.attempt}/3).`);
+            spinner.fail(`Incorrect password (attempt ${state.attempt}/${MAX_PASSWORD_ATTEMPTS}).`);
             return { kind: "UNLOCK_FAIL" };
         }
         default:
@@ -90,7 +90,7 @@ async function tryStoredPasswords(bytes, candidates) {
 async function promptForPassword(fileName, attempt) {
     const message = attempt === 1
         ? `This PDF is encrypted. Password for ${fileName}:`
-        : `Password for ${fileName} (attempt ${attempt}/3):`;
+        : `Password for ${fileName} (attempt ${attempt}/${MAX_PASSWORD_ATTEMPTS}):`;
     const { password } = await inquirer.prompt([
         { type: "password", name: "password", mask: "*", message },
     ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plasalid",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "A local-first AI that reads every line of your transactions and coaches you the best move.",
   "keywords": [
     "finance",