financy 0.1.0

package/dist/bin.js

@@ -0,0 +1,750 @@
+#!/usr/bin/env node
+import {
+  CliError,
+  EXIT,
+  STALE_THRESHOLD_DAYS,
+  VERSION,
+  fetchAccount,
+  fetchAccounts,
+  fetchBranches,
+  fetchCategories,
+  fetchConnection,
+  fetchConnections,
+  fetchProviders,
+  fetchRefresh,
+  fetchStatus,
+  fetchTransaction,
+  fetchTransactions,
+  getConnections,
+  loadConfig,
+  mintToken,
+  readCredentialsFile,
+  resolveEndpoints,
+  writeCredentialsFile
+} from "./chunk-JZO2ARNB.js";
+
+// src/run.ts
+import { Command, CommanderError } from "commander";
+
+// src/commands/status.ts
+async function statusCommand(ctx) {
+  const { data, staleThresholdDays, connections } = await fetchStatus(ctx.config, ctx.now);
+  if (ctx.json) {
+    ctx.out(JSON.stringify({ data, staleThresholdDays }, null, 2));
+    return 0;
+  }
+  ctx.out(renderTable(connections, ctx.now));
+  return 0;
+}
+function daysAgo(dataDate, now) {
+  if (!dataDate) return null;
+  const [y, m, d] = dataDate.split("-").map(Number);
+  if (y === void 0 || m === void 0 || d === void 0) return null;
+  const dataMidnight = Date.UTC(y, m - 1, d);
+  const nowMidnight = Date.UTC(now.getUTCFullYear(), now.getUTCMonth(), now.getUTCDate());
+  return Math.round((nowMidnight - dataMidnight) / 864e5);
+}
+function formatError(err) {
+  if (!err || typeof err !== "object") return err ? String(err) : null;
+  const e = err;
+  const code = e.code ?? e.type ?? e.errorCode;
+  const message = e.message ?? e.description ?? e.reason;
+  if (code || message) return `${code ?? "error"}: ${message ?? ""}`.trim();
+  return JSON.stringify(err);
+}
+function classify(c, days) {
+  if (c.status !== "ACTIVE") return { symbol: `\u2717 ${c.status}`, needsAttention: true };
+  if (days === null) return { symbol: "\u25CF no data yet", needsAttention: true };
+  if (days > STALE_THRESHOLD_DAYS) return { symbol: "\u25CF stale", needsAttention: true };
+  return { symbol: "\u2713 fresh", needsAttention: false };
+}
+function renderTable(items, now) {
+  const today = now.toISOString().slice(0, 10);
+  const lines = [
+    `Connections (data date vs today ${today}, stale > ${STALE_THRESHOLD_DAYS}d)`,
+    ""
+  ];
+  if (items.length === 0) {
+    lines.push("  No connections yet. Connect a bank in the Financy app.", "");
+    return lines.join("\n") + "\n";
+  }
+  let attention = 0;
+  const markWidth = Math.max(
+    ...items.map((c) => classify(c, daysAgo(c.lastFetchedDataDate, now)).symbol.length)
+  );
+  for (const c of items) {
+    const days = daysAgo(c.lastFetchedDataDate, now);
+    const mark = classify(c, days);
+    if (mark.needsAttention) attention++;
+    const provider = (c.providerId ?? "(pending)").padEnd(14);
+    const through = c.lastFetchedDataDate && days !== null ? `data through ${c.lastFetchedDataDate} (${days}d ago)` : "no data fetched yet";
+    const expires = c.expiryDate ? ` \xB7 consent expires ${c.expiryDate}` : "";
+    lines.push(`  ${mark.symbol.padEnd(markWidth)}  ${provider} ${through}${expires}`);
+    const errText = formatError(c.error);
+    if (errText) lines.push(`     ${errText}`);
+  }
+  lines.push("");
+  if (attention > 0) {
+    const noun = attention === 1 ? "connection needs" : "connections need";
+    lines.push(
+      `${attention} ${noun} attention. Run financy refresh to fetch now (20 credits).`
+    );
+  } else {
+    lines.push("All connections are fresh.");
+  }
+  return lines.join("\n") + "\n";
+}
+
+// src/commands/setup.ts
+import { join } from "path";
+var CREDENTIALS_GUIDE = "financy needs your Financy API credentials: clientId, clientSecret, and userId.\nFind them in the Financy app \u2192 Settings \u2192 API.\nThis requires a registered Financy account on a paid plan (Starter or Pro) \u2014\nthe data API is not available on the free plan. Sign up at https://open-finance.ai\n\n";
+async function setupCommand(ctx) {
+  if (!ctx.noInput) ctx.out(CREDENTIALS_GUIDE);
+  const credentials = ctx.noInput ? credentialsFromEnv(ctx.env) : await credentialsFromPrompts(ctx.prompt);
+  const endpoints = resolveEndpoints(ctx.env);
+  const config = { ...credentials, ...endpoints };
+  ctx.out("Validating\u2026\n");
+  try {
+    const token = await mintToken(config);
+    await getConnections(config, token);
+  } catch (error) {
+    if (error instanceof CliError && error.code === "NOT_AVAILABLE_ON_PLAN") {
+      await writeCredentialsFile(endpoints.configDir, credentials);
+    }
+    throw error;
+  }
+  await writeCredentialsFile(endpoints.configDir, credentials);
+  ctx.out(
+    `\u2713 Saved to ${join(endpoints.configDir, "config.json")} (permissions 600)
+
+Try: financy status
+`
+  );
+  return EXIT.OK;
+}
+function credentialsFromEnv(env) {
+  const clientId = env.FINANCY_CLIENT_ID;
+  const clientSecret = env.FINANCY_CLIENT_SECRET;
+  const userId = env.FINANCY_USER_ID;
+  if (!clientId || !clientSecret || !userId) {
+    throw new CliError(
+      EXIT.USAGE,
+      "NOT_CONFIGURED",
+      "--no-input requires FINANCY_CLIENT_ID, FINANCY_CLIENT_SECRET, and FINANCY_USER_ID"
+    );
+  }
+  return { clientId, clientSecret, userId };
+}
+async function credentialsFromPrompts(prompt) {
+  const clientId = await prompt({ label: "Client ID" });
+  const clientSecret = await prompt({ label: "Client secret", secret: true });
+  const userId = await prompt({ label: "User ID" });
+  return { clientId, clientSecret, userId };
+}
+
+// src/commands/config.ts
+function maskId(v) {
+  if (!v) return "(unset)";
+  return v.length <= 8 ? "****" : `${v.slice(0, 4)}\u2026${v.slice(-4)}`;
+}
+async function configCommand(ctx) {
+  const endpoints = resolveEndpoints(ctx.env);
+  const file = await readCredentialsFile(endpoints.configDir) ?? {};
+  const resolve = (envKey, fileVal) => {
+    const envVal = ctx.env[envKey];
+    if (envVal) return { value: envVal, source: "env" };
+    if (fileVal) return { value: fileVal, source: "file" };
+    return { source: "unset" };
+  };
+  const clientId = resolve("FINANCY_CLIENT_ID", file.clientId);
+  const clientSecret = resolve("FINANCY_CLIENT_SECRET", file.clientSecret);
+  const userId = resolve("FINANCY_USER_ID", file.userId);
+  if (ctx.json) {
+    ctx.out(
+      JSON.stringify(
+        {
+          configDir: endpoints.configDir,
+          authTokenUrl: endpoints.authTokenUrl,
+          apiBaseUrl: endpoints.apiBaseUrl,
+          chatBaseUrl: endpoints.chatBaseUrl,
+          clientId: clientId.value ? maskId(clientId.value) : null,
+          clientIdSource: clientId.source,
+          clientSecretSet: clientSecret.source !== "unset",
+          clientSecretSource: clientSecret.source,
+          userId: userId.value ?? null,
+          userIdSource: userId.source
+        },
+        null,
+        2
+      )
+    );
+    return EXIT.OK;
+  }
+  const lines = [
+    "financy configuration",
+    "",
+    `  config dir     ${endpoints.configDir}`,
+    `  auth url       ${endpoints.authTokenUrl}`,
+    `  api url        ${endpoints.apiBaseUrl}`,
+    `  chat url       ${endpoints.chatBaseUrl}`,
+    "",
+    `  clientId       ${maskId(clientId.value)}  (${clientId.source})`,
+    `  clientSecret   ${clientSecret.source !== "unset" ? "\u2022\u2022\u2022\u2022\u2022\u2022\u2022\u2022 (set)" : "(unset)"}  (${clientSecret.source})`,
+    `  userId         ${userId.value ?? "(unset)"}  (${userId.source})`
+  ];
+  ctx.out(lines.join("\n") + "\n");
+  return EXIT.OK;
+}
+
+// src/commands/refresh.ts
+function renderHuman(result) {
+  if (result.status === "already_running") {
+    return "A refresh is already in flight \u2014 watch it with financy status\n";
+  }
+  const scope = typeof result.connections === "number" ? `${result.connections} connection${result.connections === 1 ? "" : "s"}` : "your connections";
+  return `Refresh started for ${scope} (20 credits)
+  Data lands in a few minutes \u2014 check financy status
+`;
+}
+async function refreshCommand(ctx) {
+  const { data } = await fetchRefresh(ctx.config, ctx.now);
+  ctx.out(ctx.json ? JSON.stringify({ data }) : renderHuman(data));
+  return EXIT.OK;
+}
+
+// src/render.ts
+function displayWidth(str) {
+  let width = 0;
+  for (const ch of str) {
+    const cp2 = ch.codePointAt(0);
+    if (isZeroWidth(cp2)) continue;
+    width += isWide(cp2) ? 2 : 1;
+  }
+  return width;
+}
+function isZeroWidth(cp2) {
+  return cp2 === 8203 || // zero-width space
+  cp2 >= 8204 && cp2 <= 8207 || // ZWNJ/ZWJ/LRM/RLM
+  cp2 === 65279 || // BOM / zero-width no-break space
+  // Combining marks
+  cp2 >= 768 && cp2 <= 879 || // combining diacritics
+  cp2 >= 1425 && cp2 <= 1469 || // Hebrew accents & niqqud
+  cp2 === 1471 || cp2 >= 1473 && cp2 <= 1474 || cp2 >= 1476 && cp2 <= 1477 || cp2 === 1479 || cp2 >= 1552 && cp2 <= 1562 || // Arabic marks
+  cp2 >= 1611 && cp2 <= 1631 || cp2 === 1648 || cp2 >= 6832 && cp2 <= 6911 || cp2 >= 7616 && cp2 <= 7679 || cp2 >= 8400 && cp2 <= 8447 || cp2 >= 65056 && cp2 <= 65071;
+}
+function isWide(cp2) {
+  return cp2 >= 4352 && cp2 <= 4447 || // Hangul Jamo
+  cp2 >= 11904 && cp2 <= 12350 || // CJK radicals, Kangxi
+  cp2 >= 12353 && cp2 <= 13311 || // Hiragana … CJK symbols
+  cp2 >= 13312 && cp2 <= 19903 || // CJK Ext A
+  cp2 >= 19968 && cp2 <= 40959 || // CJK Unified
+  cp2 >= 40960 && cp2 <= 42191 || // Yi
+  cp2 >= 44032 && cp2 <= 55203 || // Hangul syllables
+  cp2 >= 63744 && cp2 <= 64255 || // CJK compatibility
+  cp2 >= 65072 && cp2 <= 65103 || // CJK compatibility forms
+  cp2 >= 65280 && cp2 <= 65376 || // Fullwidth forms
+  cp2 >= 65504 && cp2 <= 65510 || cp2 >= 127744 && cp2 <= 129791 || // emoji & pictographs
+  cp2 >= 131072 && cp2 <= 262141;
+}
+var GAP = "  ";
+function cell(col, row) {
+  const v = col.value(row);
+  return v == null ? "" : String(v);
+}
+function padDisplay(str, width) {
+  return str + " ".repeat(Math.max(0, width - displayWidth(str)));
+}
+function renderTable2(rows, columns) {
+  const widths = columns.map(
+    (col) => Math.max(displayWidth(col.header), ...rows.map((r) => displayWidth(cell(col, r))))
+  );
+  const line = (cells) => cells.map((c, i) => padDisplay(c, widths[i])).join(GAP).trimEnd();
+  const lines = [
+    line(columns.map((c) => c.header)),
+    ...rows.map((r) => line(columns.map((c) => cell(c, r))))
+  ];
+  return lines.join("\n") + "\n";
+}
+
+// src/commands/resources.ts
+function renderList(ctx, envelope, columns) {
+  if (ctx.json) {
+    ctx.out(
+      JSON.stringify(
+        { data: envelope.data, count: envelope.count, nextPage: envelope.nextPage },
+        null,
+        2
+      )
+    );
+  } else {
+    ctx.out(renderTable2(envelope.data, columns));
+  }
+  return EXIT.OK;
+}
+function renderGet(ctx, envelope) {
+  if (ctx.json) {
+    ctx.out(JSON.stringify({ data: envelope.data }, null, 2));
+  } else {
+    ctx.out(JSON.stringify(envelope.data, null, 2) + "\n");
+  }
+  return EXIT.OK;
+}
+
+// src/commands/read-commands.ts
+async function loadOrThrow(env) {
+  const result = await loadConfig(env);
+  if (!result.ok) {
+    throw new CliError(
+      EXIT.AUTH,
+      "NOT_CONFIGURED",
+      `missing ${result.missing.join(", ")} \u2014 run financy setup`
+    );
+  }
+  return result.config;
+}
+var ils = (n) => {
+  const num = typeof n === "number" ? n : Number(n);
+  return typeof n !== "number" && typeof n !== "string" ? "\u2014" : !Number.isFinite(num) ? "\u2014" : (num < 0 ? "-" : "") + "\u20AA" + Math.abs(num).toLocaleString("en-US", { minimumFractionDigits: 2 });
+};
+var dash = (v) => v == null || typeof v === "object" ? "\u2014" : String(v);
+function accountBalance(a) {
+  const b = a.balances?.find((x) => x.balanceType === "closingBooked") ?? a.balances?.[0];
+  return b?.balanceAmount?.amount;
+}
+function txnAmount(t) {
+  const charged = t.amount?.chargedAmount?.amount;
+  const chargedNum = Number(charged);
+  if (charged !== "" && charged != null && Number.isFinite(chargedNum)) return charged;
+  return t.amount?.originalAmount?.amount;
+}
+var CONNECTION_COLUMNS = [
+  { header: "ID", value: (c) => c.id },
+  { header: "PROVIDER", value: (c) => dash(c.providerId) },
+  { header: "STATUS", value: (c) => c.status },
+  { header: "DATA THROUGH", value: (c) => dash(c.lastFetchedDataDate) },
+  { header: "EXPIRES", value: (c) => dash(c.expiryDate) },
+  { header: "TXNS", value: (c) => dash(c.transactions) }
+];
+var ACCOUNT_COLUMNS = [
+  { header: "ID", value: (a) => a.id },
+  { header: "TYPE", value: (a) => dash(a.accountType) },
+  { header: "NAME", value: (a) => dash(a.product ?? a.accountNumber) },
+  { header: "PROVIDER", value: (a) => dash(a.providerId) },
+  { header: "BALANCE", value: (a) => ils(accountBalance(a)) }
+];
+var TRANSACTION_COLUMNS = [
+  { header: "DATE", value: (t) => dash(t.date?.transactionDate) },
+  { header: "AMOUNT", value: (t) => ils(txnAmount(t)) },
+  { header: "DESCRIPTION", value: (t) => dash(t.merchantName ?? t.description?.description) },
+  { header: "CATEGORY", value: (t) => `${dash(t.category?.main)}/${dash(t.category?.sub)}` },
+  { header: "TYPE", value: (t) => dash(t.type) },
+  { header: "ID", value: (t) => t.id }
+];
+var PROVIDER_COLUMNS = [
+  { header: "ID", value: (p) => dash(p.providerFriendlyId ?? p.id) },
+  { header: "NAME", value: (p) => dash(p.name) },
+  { header: "NATIVE", value: (p) => dash(p.nameNativeLanguage) },
+  { header: "MODE", value: (p) => dash(p.mode) }
+];
+var BRANCH_COLUMNS = [
+  { header: "BANK", value: (b) => dash(b.bankCode) },
+  { header: "BRANCH", value: (b) => dash(b.branchCode ?? b.id) },
+  { header: "NAME", value: (b) => dash(b.branchName ?? b.name) },
+  { header: "CITY", value: (b) => dash(b.city) }
+];
+function registerReadCommands(program, base, setExit) {
+  const ctx = { json: base.json, out: base.out };
+  const connections = program.command("connections").description("Bank/card connections and their fetch state");
+  connections.command("list").option("--limit <n>", "page size").option("--cursor <token>", "resume from a nextPage cursor").option("--all", "auto-paginate to the end").option("--json", "machine-readable output").action(async (opts) => {
+    const config = await loadOrThrow(base.env);
+    const envelope = await fetchConnections(config, base.now, opts);
+    setExit(renderList(ctx, envelope, CONNECTION_COLUMNS));
+  });
+  connections.command("get <id>").option("--json", "machine-readable output").action(async (id) => {
+    const config = await loadOrThrow(base.env);
+    setExit(renderGet(ctx, await fetchConnection(config, base.now, id)));
+  });
+  const accounts = program.command("accounts").description("Accounts with balances");
+  accounts.command("list").option("--type <type>", "CHECKING|CARD|LOAN|SAVINGS|SECURITY").option("--connection <id>", "filter by connection").option("--limit <n>", "page size").option("--cursor <token>", "resume from a nextPage cursor").option("--all", "auto-paginate to the end").option("--json", "machine-readable output").action(async (opts) => {
+    const config = await loadOrThrow(base.env);
+    const envelope = await fetchAccounts(config, base.now, opts);
+    setExit(renderList(ctx, envelope, ACCOUNT_COLUMNS));
+  });
+  accounts.command("get <id>").option("--json", "machine-readable output").action(async (id) => {
+    const config = await loadOrThrow(base.env);
+    setExit(renderGet(ctx, await fetchAccount(config, base.now, id)));
+  });
+  const transactions = program.command("transactions").description("Transactions with filters");
+  transactions.command("list").option("--from <date>", "earliest transaction date (YYYY-MM-DD)").option("--to <date>", "latest transaction date (YYYY-MM-DD)").option("--account <id>", "filter by account").option("--connection <id>", "filter by connection").option("--type <type>", "BANK|CARD").option("--limit <n>", "page size").option("--cursor <token>", "resume from a nextPage cursor").option("--all", "auto-paginate to the end").option("--json", "machine-readable output").action(async (opts) => {
+    const config = await loadOrThrow(base.env);
+    const envelope = await fetchTransactions(config, base.now, opts);
+    setExit(renderList(ctx, envelope, TRANSACTION_COLUMNS));
+  });
+  transactions.command("get <id>").option("--json", "machine-readable output").action(async (id) => {
+    const config = await loadOrThrow(base.env);
+    setExit(renderGet(ctx, await fetchTransaction(config, base.now, id)));
+  });
+  program.command("categories").description("The category taxonomy (English + Hebrew)").option("--json", "machine-readable output").action(async () => {
+    const config = await loadOrThrow(base.env);
+    const data = await fetchCategories(config, base.now);
+    base.out(
+      base.json ? JSON.stringify({ data }, null, 2) : JSON.stringify(data, null, 2) + "\n"
+    );
+    setExit(EXIT.OK);
+  });
+  const providers = program.command("providers").description("Reference data: banks and branches");
+  providers.command("list").option("--json", "machine-readable output").action(async () => {
+    const config = await loadOrThrow(base.env);
+    setExit(renderList(ctx, await fetchProviders(config, base.now), PROVIDER_COLUMNS));
+  });
+  providers.command("branches").description("Bank branch reference data (no paging)").option("--json", "machine-readable output").action(async () => {
+    const config = await loadOrThrow(base.env);
+    setExit(renderList(ctx, await fetchBranches(config, base.now), BRANCH_COLUMNS));
+  });
+}
+
+// src/commands/skills.ts
+import { existsSync } from "fs";
+import { cp, readFile, readdir, stat } from "fs/promises";
+import { dirname, join as join2 } from "path";
+import { fileURLToPath } from "url";
+var INSTALL_SUBPATH = join2(".claude", "skills");
+function resolveSkillsRoot(moduleDir = dirname(fileURLToPath(import.meta.url))) {
+  let dir = moduleDir;
+  for (let depth = 0; depth < 4; depth++) {
+    dir = join2(dir, "..");
+    const candidate = join2(dir, "skills");
+    if (existsSync(candidate)) return candidate;
+  }
+  return join2(moduleDir, "..", "skills");
+}
+function parseFrontmatter(source) {
+  const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(source);
+  if (!match?.[1]) return {};
+  const result = {};
+  const lines = match[1].split(/\r?\n/);
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i] ?? "";
+    const kv = /^([A-Za-z_][\w-]*):\s*(.*)$/.exec(line);
+    if (!kv?.[1]) continue;
+    const [, key, rest = ""] = kv;
+    if (rest === ">" || rest === "|" || rest === ">-" || rest === "|-") {
+      const block = [];
+      while (i + 1 < lines.length && /^\s+\S/.test(lines[i + 1] ?? "")) {
+        block.push((lines[++i] ?? "").trim());
+      }
+      result[key] = block.join(" ");
+    } else {
+      result[key] = rest.replace(/^["']|["']$/g, "");
+    }
+  }
+  return result;
+}
+async function listSkills(skillsRoot) {
+  let entries;
+  try {
+    entries = (await readdir(skillsRoot, { withFileTypes: true })).filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  } catch {
+    return [];
+  }
+  const skills = [];
+  for (const name of entries) {
+    const file = join2(skillsRoot, name, "SKILL.md");
+    try {
+      const front = parseFrontmatter(await readFile(file, "utf8"));
+      skills.push({ name: front.name ?? name, description: front.description ?? "" });
+    } catch {
+    }
+  }
+  return skills;
+}
+async function skillsListCommand(ctx) {
+  const skills = await listSkills(ctx.skillsRoot);
+  if (ctx.json) {
+    ctx.out(JSON.stringify({ data: skills, count: skills.length }, null, 2));
+    return EXIT.OK;
+  }
+  if (skills.length === 0) {
+    ctx.out("No skills are bundled with this build.\n");
+    return EXIT.OK;
+  }
+  const lines = ["Skills bundled with financy:", ""];
+  const width = Math.max(...skills.map((s) => s.name.length));
+  for (const skill of skills) {
+    lines.push(`  ${skill.name.padEnd(width)}  ${firstSentence(skill.description)}`);
+  }
+  lines.push("", `Install them with: financy skills install --all`);
+  ctx.out(lines.join("\n") + "\n");
+  return EXIT.OK;
+}
+function firstSentence(description) {
+  const sentence = description.split(/\.\s/)[0] ?? description;
+  return sentence.length > 96 ? sentence.slice(0, 93) + "\u2026" : sentence;
+}
+async function skillsInstallCommand(ctx) {
+  const available = await listSkills(ctx.skillsRoot);
+  if (available.length === 0) {
+    throw new CliError(EXIT.UNEXPECTED, "NO_SKILLS", "no skills are bundled with this build");
+  }
+  if (!ctx.all && ctx.names.length === 0) {
+    throw new CliError(
+      EXIT.USAGE,
+      "USAGE",
+      `name a skill or pass --all (available: ${available.map((s) => s.name).join(", ")})`
+    );
+  }
+  const wanted = ctx.all ? available.map((s) => s.name) : ctx.names;
+  const unknown = wanted.filter((name) => !available.some((s) => s.name === name));
+  if (unknown.length > 0) {
+    throw new CliError(
+      EXIT.NOT_FOUND,
+      "NOT_FOUND",
+      `unknown skill${unknown.length === 1 ? "" : "s"}: ${unknown.join(", ")} (available: ${available.map((s) => s.name).join(", ")})`
+    );
+  }
+  const destRoot = join2(ctx.targetDir, INSTALL_SUBPATH);
+  const installed = [];
+  for (const name of wanted) {
+    const dest = join2(destRoot, name);
+    const replaced = await exists(dest);
+    await cp(join2(ctx.skillsRoot, name), dest, { recursive: true, force: true });
+    installed.push({ name, path: dest, replaced });
+  }
+  if (ctx.json) {
+    ctx.out(JSON.stringify({ data: installed, count: installed.length }, null, 2));
+    return EXIT.OK;
+  }
+  const lines = [];
+  for (const item of installed) {
+    lines.push(`\u2713 ${item.name}${item.replaced ? " (updated)" : ""} \u2192 ${item.path}`);
+  }
+  lines.push("", "Restart Claude Code (or your agent) to pick them up.");
+  ctx.out(lines.join("\n") + "\n");
+  return EXIT.OK;
+}
+async function exists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// src/prompt.ts
+import { createInterface } from "readline";
+function createDefaultPrompt() {
+  return ({ label, secret }) => new Promise((resolve) => {
+    const rl = createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      terminal: true
+    });
+    if (secret) {
+      const mutable = rl;
+      mutable._writeToOutput = (s) => {
+        if (s.includes(label) || s === "\n" || s === "\r\n") process.stdout.write(s);
+      };
+    }
+    rl.question(`${label}: `, (answer) => {
+      rl.close();
+      if (secret) process.stdout.write("\n");
+      resolve(answer.trim());
+    });
+  });
+}
+
+// src/run.ts
+import { fileURLToPath as fileURLToPath2 } from "url";
+import { dirname as dirname2 } from "path";
+
+// src/update.ts
+import { spawn } from "child_process";
+var MIN_NODE_MAJOR = 20;
+function detectInstallMode(signals) {
+  const dir = signals.moduleDir;
+  if (dir.includes("/_npx/") || /(?:^|\s)npx\//.test(signals.userAgent ?? "")) {
+    return "npx";
+  }
+  const nm = dir.lastIndexOf("/node_modules/");
+  if (nm >= 0) {
+    const projectRoot = dir.slice(0, nm);
+    if (signals.cwd === projectRoot || signals.cwd.startsWith(projectRoot + "/")) {
+      return "local";
+    }
+  }
+  return "global";
+}
+function unsupportedNode(nodeVersion, min = MIN_NODE_MAJOR) {
+  const major = Number(nodeVersion.replace(/^v/, "").split(".")[0]);
+  if (Number.isNaN(major)) return null;
+  if (major < min) {
+    return `financy requires Node ${min}+ (you have ${nodeVersion}). Please upgrade Node and try again.`;
+  }
+  return null;
+}
+var PACKAGE = "financy";
+async function updateCommand(ctx) {
+  switch (ctx.mode) {
+    case "npx":
+      ctx.out("npx always runs the latest \u2014 nothing to update.\n");
+      return 0;
+    case "local":
+      ctx.out(
+        `financy is a project dependency \u2014 update it in your project (e.g. npm update ${PACKAGE}).
+`
+      );
+      return 0;
+    case "global": {
+      ctx.out("Updating financy to the latest version\u2026\n");
+      const code = await ctx.exec("npm", ["install", "-g", `${PACKAGE}@latest`]);
+      if (code !== 0) {
+        ctx.err(`update failed \u2014 try running: npm install -g ${PACKAGE}@latest
+`);
+        return 1;
+      }
+      ctx.out("financy is now up to date.\n");
+      return 0;
+    }
+  }
+}
+function spawnExec(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: "inherit" });
+    child.on("close", (code) => resolve(code ?? 1));
+    child.on("error", () => resolve(1));
+  });
+}
+
+// src/run.ts
+async function run(argv, io = {}) {
+  const out = io.stdout ?? ((chunk) => void process.stdout.write(chunk));
+  const err = io.stderr ?? ((chunk) => void process.stderr.write(chunk));
+  const env = io.env ?? process.env;
+  const now = io.now ?? /* @__PURE__ */ new Date();
+  const prompt = io.prompt ?? createDefaultPrompt();
+  const json = argv.includes("--json");
+  const nodeError = unsupportedNode(io.nodeVersion ?? process.versions.node);
+  if (nodeError) {
+    err(`error: ${nodeError}
+`);
+    return EXIT.UNEXPECTED;
+  }
+  const program = new Command();
+  program.name("financy").description("financy \u2014 your Open-Finance data, in the terminal").version(VERSION, "-v, --version", "print the version").configureOutput({ writeOut: out, writeErr: err }).exitOverride().showSuggestionAfterError(false);
+  let exitCode = EXIT.OK;
+  program.command("status").description("Are my connections fresh? One-line-per-bank rollup").option("--json", "machine-readable output (stable schema, errors as JSON on stderr)").action(async () => {
+    const result = await loadConfig(env);
+    if (!result.ok) {
+      throw new CliError(
+        EXIT.AUTH,
+        "NOT_CONFIGURED",
+        `missing ${result.missing.join(", ")} \u2014 run financy setup`
+      );
+    }
+    exitCode = await statusCommand({ config: result.config, json, now, out, err });
+  });
+  program.command("setup").description("Save your API credentials (Financy \u2192 Settings \u2192 API; requires a paid plan)").option("--no-input", "read credentials from FINANCY_* env vars (for agents/CI)").action(async (opts) => {
+    exitCode = await setupCommand({
+      env,
+      noInput: opts.input === false,
+      prompt,
+      out,
+      err
+    });
+  });
+  program.command("refresh").description("Trigger an on-demand refresh of all connections (20 credits)").option("--json", "machine-readable output").action(async () => {
+    const result = await loadConfig(env);
+    if (!result.ok) {
+      throw new CliError(
+        EXIT.AUTH,
+        "NOT_CONFIGURED",
+        `missing ${result.missing.join(", ")} \u2014 run financy setup`
+      );
+    }
+    exitCode = await refreshCommand({ config: result.config, json, now, out });
+  });
+  program.command("config").description("Show the resolved endpoints and credential sources (secret masked)").option("--json", "machine-readable output").action(async () => {
+    exitCode = await configCommand({ env, json, out });
+  });
+  program.command("mcp").description("Run the embedded MCP server (stdio) exposing the CLI as agent tools").action(async () => {
+    const { startMcpServer } = await import("./server-SIRWJMXP.js");
+    await startMcpServer(env);
+  });
+  const skills = program.command("skills").description("Agent skills bundled with financy (Claude Code and other agents)");
+  skills.command("list").description("List the bundled skills").option("--json", "machine-readable output").action(async () => {
+    exitCode = await skillsListCommand({
+      skillsRoot: io.skillsRoot ?? resolveSkillsRoot(),
+      targetDir: io.cwd ?? process.cwd(),
+      json,
+      out
+    });
+  });
+  skills.command("install").argument("[names...]", "skills to install (omit with --all for every skill)").description("Copy skills into this project's .claude/skills/ directory").option("--all", "install every bundled skill").option("--dir <path>", "install under this directory instead of the current one").option("--json", "machine-readable output").action(async (names, opts) => {
+    exitCode = await skillsInstallCommand({
+      skillsRoot: io.skillsRoot ?? resolveSkillsRoot(),
+      targetDir: opts.dir ?? io.cwd ?? process.cwd(),
+      names,
+      all: opts.all === true,
+      json,
+      out
+    });
+  });
+  program.command("update").description("Update the CLI to the latest version").action(async () => {
+    const mode = detectInstallMode({
+      moduleDir: dirname2(fileURLToPath2(import.meta.url)),
+      cwd: process.cwd(),
+      userAgent: env.npm_config_user_agent
+    });
+    exitCode = await updateCommand({ mode, exec: io.exec ?? spawnExec, out, err });
+  });
+  registerReadCommands(program, { env, now, json, out }, (code) => {
+    exitCode = code;
+  });
+  if (argv.length === 0) {
+    program.outputHelp();
+    return EXIT.OK;
+  }
+  try {
+    await program.parseAsync(argv, { from: "user" });
+    return exitCode;
+  } catch (error) {
+    if (error instanceof CommanderError) {
+      return mapCommanderError(error);
+    }
+    return emitError({ err, json }, error);
+  }
+}
+function mapCommanderError(error) {
+  switch (error.code) {
+    case "commander.helpDisplayed":
+    case "commander.help":
+    case "commander.version":
+      return EXIT.OK;
+    default:
+      return EXIT.USAGE;
+  }
+}
+function emitError(io, error) {
+  const cliError = error instanceof CliError ? error : new CliError(EXIT.UNEXPECTED, "UNEXPECTED", String(error?.message ?? error));
+  if (io.json) {
+    io.err(
+      JSON.stringify({
+        error: { code: cliError.code, message: cliError.message, ...cliError.extra }
+      })
+    );
+  } else {
+    io.err(`error ${cliError.code}: ${cliError.message}
+`);
+  }
+  return cliError.exitCode;
+}
+
+// src/bin.ts
+run(process.argv.slice(2)).then((code) => {
+  process.exitCode = code;
+}).catch((error) => {
+  process.stderr.write(`error UNEXPECTED: ${String(error?.message ?? error)}
+`);
+  process.exitCode = 1;
+});