skill-bill 0.1.0 → 0.2.1

package/dist/account/template-update.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-update.js","sourceRoot":"","sources":["../../src/account/template-update.ts"],"names":[],"mappings":"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"}

package/dist/account/write.d.ts

@@ -0,0 +1,14 @@
+import type { BillDb } from '../fetch/index.js';
+import type { WriteOut } from '../shared/commandSpec.js';
+import { ACCOUNT_SLOTS } from './params.js';
+/** `bill.account.write`：账户管理的三支操作，一处分流。 */
+export declare function writeAccount(params: Record<string, unknown>, db: BillDb): WriteOut;
+/** 采集口令那一段的取值为外部测试留的一个口（缺项时页上那条口令照这个形状给）。
+ *  **本件不自己拼文案**：口径住 `./pageParts.js`，这里只是转出去给测试按同一处取。 */
+export { promptOf as accountPromptOf } from './pageParts.js';
+/** 有改动才叫改动（`hasChange` 由 `./params.js` 一处定义；本件不重判一遍）。
+ *  转出去是给测试用的：三支操作「改成什么给了没有」的判据只有一处。 */
+export { hasChange as accountHasChange } from './params.js';
+/** 一条命令要哪些槽位（三支操作各一份；转出给测试与页面同取一处）。 */
+export { ACCOUNT_SLOTS as accountSlots };
+//# sourceMappingURL=write.d.ts.map

package/dist/account/write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.d.ts","sourceRoot":"","sources":["../../src/account/write.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAOzD,OAAO,EACL,aAAa,EACd,MAAM,aAAa,CAAC;AAoFrB,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,QAAQ,CAiElF;AAED;yDACyD;AACzD,OAAO,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE7D;uCACuC;AACvC,OAAO,EAAE,SAAS,IAAI,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE5D,uCAAuC;AACvC,OAAO,EAAE,aAAa,IAAI,YAAY,EAAE,CAAC"}

package/dist/account/write.js

@@ -0,0 +1,166 @@
+/** `bill.account.write`（账户管理）的处理体：三支操作（新增／修改／转账）。
+ *
+ * 谁在用（一个调用点，指名）：`src/account/commands.ts` 那条命令声明引本件——
+ *  出口分派 `src/cli/cmd_read.ts` 只查注册表再调域门，不再认这个命令名。
+ *
+ * 两支的分岔口径（照写入域两条写命令的同一套规矩）：
+ *   **有阻断项不再报参数错退出**，改出过程型页（新增／转账出采集页、改账户出确认页），退出码 0、
+ *   `ok:false`、不写库；阻断项＝缺必需槽位、值进不去（金额非正数／两个账户相同／时间形态不认／名字过长／
+ *   「改成什么」没给），**或**账户表那一层的冲突（新增撞重名、改账户找不到那个账户）。
+ *   阻断项清空即写库：新增与改名动 `goals.json` 的账户表（改名连带 `bills.account`），
+ *   转账往 `bills` 落两笔；三支都出结果型回执整页。
+ *
+ * 老侧对应件：`scripts/account/cli.py` 的 `cmd_add`／`cmd_update`／`cmd_transfer`。
+ *  三处行为差异逐条记在 `docs/skills/skill-bill/t691-差异表.md`（其中两处最要紧）：
+ *   ① 老侧「找不到账户／重名」是一句 `ValueError` 直接退出（exit 2／4），新侧出**阻断页**（exit 0、不写库）；
+ *   ② 老侧转账备注写 `#转账 转出至X`／`#转账 转入自Y`，新侧逐字同形（搬迁前那份过渡实现写成
+ *      `#转账（转出）`／`#转账（转入）`，随本票改回老侧原样）。
+ */
+import { loadGoals, resolveGoalsPath, saveGoals } from '../fetch/index.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { totalChanges } from '../shared/writeParts.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { accountsOf, appendAccount, applyAccountUpdate, findAccount, writeTransfer } from './accounts.js';
+import { SOURCE_COLLECT, SOURCE_WRITE } from './pageParts.js';
+import { ACCOUNT_SLOTS, accountBlocked, needAccountName, parseAccountOp, textOf, validateTransfer, } from './params.js';
+import { writeSceneFor } from './scene.js';
+/** 本次执行时刻（本地时钟；页面与回执都读它）。 */
+function nowStamp() {
+    return actionStamp();
+}
+/** 账户表那一层的阻断：新增撞重名（老侧 `cli.py:97-99` 的冲突）、改账户找不到那一个（老侧 `cli.py:148-150`）。 */
+function tableBlockedOf(op, params, accounts) {
+    const name = textOf(params['name']);
+    if (name === '')
+        return [];
+    const hit = findAccount(accounts, name) !== null;
+    if (op === 'add' && hit)
+        return [{ name: 'name', label: '账户名', why: '账户表里已经有这个名字了（要改它就说「改账户」）' }];
+    if (op === 'update' && !hit)
+        return [{ name: 'name', label: '账户', why: '账户表里没有这个账户' }];
+    return [];
+}
+/** 有阻断项时的载荷说明（envelope 的 `message`；也是 stdout 上那句 `data.message`）。 */
+function blockedMessageOf(op, blocked) {
+    const word = projectWakeWord({ key: 'bill.account.write', op });
+    return word + '还差 ' + String(blocked.length) + ' 项：' + blocked.map((b) => b.label).join('、')
+        + '（已出' + (op === 'update' ? '确认页' : '采集页') + '，补齐之后跟助手说一遍）';
+}
+/** 三支操作共用的收口：回执事实 ＋ 回执整页。 */
+function finish(input) {
+    const receipt = {
+        op: input.op,
+        summary: input.summary,
+        affectedRows: affectedRowsOf(input.op, input.db, input.before, input.renamedRows),
+        actionAt: nowStamp(),
+        source: SOURCE_WRITE,
+        noChange: input.noChange,
+        accountCount: input.goalsAccounts.length,
+        renamedRows: input.renamedRows,
+        before: input.beforeRow,
+        after: input.afterRow,
+    };
+    return {
+        data: { ok: true, message: input.summary, receipt },
+        html: input.scene.receipt({
+            key: input.key, params: input.params, receipt, detail: input.detail, accounts: input.goalsAccounts,
+        }),
+    };
+}
+/** 这一次改动落在几处（回执页「改了账本里几处」那一格与复制日志都读它）。
+ *
+ *  **两种口径，按事实源分**（本域的一处特殊情况，写在这里免得后人以为写错了）：
+ *    - 转账：走 SQLite 的 `total_changes()` 前后差（**非自报**，与写入域两条写命令同一口径）——恒 2；
+ *    - 新增／改账户：**自报** 1 ＋ 级联改名的历史流水笔数。理由是**账户表不住 SQLite**：
+ *      它是 `goals.json` 顶层 `accounts` 键（老侧 `db.py:find_db_path` 同款载体），没有计数器可读，
+ *      而把「账户表那一处」漏掉只报流水的话，用户会以为这次没改到账户本身。 */
+function affectedRowsOf(op, db, before, renamedRows) {
+    if (op === 'transfer')
+        return totalChanges(db.db) - before;
+    return 1 + renamedRows;
+}
+/** 账户那一行写成明细表的行（新增与改账户共用；状态按改后的事实写）。 */
+function accountDetail(row) {
+    return [
+        { k: '账户名', v: row.name },
+        { k: '类型', v: row.type.trim() === '' ? '—' : row.type },
+        { k: '状态', v: row.disabled ? '已停用' : '使用中' },
+    ];
+}
+/** `bill.account.write`：账户管理的三支操作，一处分流。 */
+export function writeAccount(params, db) {
+    const key = 'bill.account.write';
+    const op = parseAccountOp(params);
+    const scene = writeSceneFor(op);
+    const goalsPath = resolveGoalsPath();
+    const goals = loadGoals(goalsPath);
+    const accounts = accountsOf(goals);
+    const blocked = [...accountBlocked(op, params), ...tableBlockedOf(op, params, accounts)];
+    if (blocked.length > 0) {
+        return {
+            data: { ok: false, message: blockedMessageOf(op, blocked) },
+            html: scene.collect({
+                key, op, params, blocked, accounts, source: SOURCE_COLLECT, actionAt: nowStamp(),
+            }),
+        };
+    }
+    const before = totalChanges(db.db);
+    if (op === 'add') {
+        const name = needAccountName(params);
+        const type = textOf(params['type']);
+        const row = appendAccount(goals, { name, type, createdAt: nowStamp() });
+        saveGoals(goalsPath, goals);
+        return finish({
+            key, op, params, scene, db, before, goalsAccounts: accountsOf(goals),
+            summary: '已新增账户「' + row.name + '」（账户表现在 ' + String(goals.accounts.length) + ' 个）',
+            detail: accountDetail(row), noChange: false, renamedRows: 0, beforeRow: null, afterRow: row,
+        });
+    }
+    if (op === 'update') {
+        const name = needAccountName(params);
+        const next = textOf(params['new-name']);
+        const applied = applyAccountUpdate(db, goals, {
+            name, newName: next, disable: params['disable'] === true, enable: params['enable'] === true,
+        });
+        saveGoals(goalsPath, goals);
+        const changes = [];
+        if (applied.before.name !== applied.after.name) {
+            changes.push('改名「' + applied.before.name + '」→「' + applied.after.name + '」，连带改了 '
+                + String(applied.renamedRows) + ' 笔历史流水');
+        }
+        if (applied.before.disabled !== applied.after.disabled) {
+            changes.push(applied.after.disabled ? '停用（历史记录保留，不再算进总余额）' : '启用（重新算进总余额）');
+        }
+        if (changes.length === 0)
+            changes.push('没有任何一处真的变了');
+        return finish({
+            key, op, params, scene, db, before, goalsAccounts: accountsOf(goals),
+            summary: '已修改账户「' + applied.after.name + '」：' + changes.join('；'),
+            detail: accountDetail(applied.after),
+            noChange: applied.before.name === applied.after.name && applied.before.type === applied.after.type
+                && applied.before.disabled === applied.after.disabled,
+            renamedRows: applied.renamedRows, beforeRow: applied.before, afterRow: applied.after,
+        });
+    }
+    const { amount, from, to, time } = validateTransfer(params);
+    const at = time ?? nowStamp();
+    const ids = writeTransfer(db, { amount, from, to, time: at });
+    return finish({
+        key, op, params, scene, db, before, goalsAccounts: accounts,
+        summary: '已转账：' + from + ' → ' + to + ' ' + amount.toFixed(2) + ' 元（转出与转入各一笔，不算进收支）',
+        detail: [
+            { k: '转出这一笔（' + from + '）', v: '编号 ' + String(ids.outId) + ' · 支出 ' + amount.toFixed(2) + ' 元 · 分类「转账/转出」· 账本「转账」· 时间 ' + at },
+            { k: '转入这一笔（' + to + '）', v: '编号 ' + String(ids.inId) + ' · 收入 ' + amount.toFixed(2) + ' 元 · 分类「转账/转入」· 账本「转账」· 时间 ' + at },
+        ],
+        noChange: false, renamedRows: 0, beforeRow: null, afterRow: null,
+    });
+}
+/** 采集口令那一段的取值为外部测试留的一个口（缺项时页上那条口令照这个形状给）。
+ *  **本件不自己拼文案**：口径住 `./pageParts.js`，这里只是转出去给测试按同一处取。 */
+export { promptOf as accountPromptOf } from './pageParts.js';
+/** 有改动才叫改动（`hasChange` 由 `./params.js` 一处定义；本件不重判一遍）。
+ *  转出去是给测试用的：三支操作「改成什么给了没有」的判据只有一处。 */
+export { hasChange as accountHasChange } from './params.js';
+/** 一条命令要哪些槽位（三支操作各一份；转出给测试与页面同取一处）。 */
+export { ACCOUNT_SLOTS as accountSlots };
+//# sourceMappingURL=write.js.map

package/dist/account/write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write.js","sourceRoot":"","sources":["../../src/account/write.ts"],"names":[],"mappings":"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"}

package/dist/analysis/agg.d.ts

@@ -0,0 +1,135 @@
+/** 分析域·取数与通用聚合（**域内共用**；从老侧 `scripts/analysis/cli.py` 的「通用工具」段逐件移植）。
+ *
+ * 谁在用（指名）：本域 25 件场景声明（`./scene-*.ts`）——每件只取它自己要的那几个聚合，
+ *   **不各自再写一份**（同一件事两个算法＝两套口径）。规矩件本身不打印、不拼 HTML、不碰页面。
+ *
+ * 与老侧的**口径差异两条**（逐条留痕，最终表住 `docs/skills/skill-bill/t729-差异表.md`）：
+ *   ① **转账不入收支**：老 `_calc_kpi`／`_agg_expense_by` 把 `#转账` 那两笔也当支出／收入累计；
+ *      新侧一律走 `../shared/kpi.js` 的 `calcKpi`／`isTransfer`（#691 定死的口径：转账是同一笔钱换口袋，
+ *      不入收支统计、余额另计）。故本件所有聚合都跳过转账行。
+ *   ② **「今天」与窗口终点**：老 `_month_series` 的序列终点＝**库里最新一条记录所在的月**（不是今天）；
+ *      新侧照抄这条（`records` 里 `time` 的最大值），但**从记录里算**而不是取 `records[0]`
+ *      （老侧依赖 `fetch_all` 的倒序，新侧 `fetchAll` 是升序——依赖排序的写法会静默算错）。
+ */
+import type { BillDb, BillRow } from '../fetch/db.js';
+/** 收支口径四件（与共用位 `calcKpi` 同一件事的两种说法：这里只给它一个域内名字）。 */
+export type Kpi = {
+    readonly count: number;
+    readonly expense: number;
+    readonly income: number;
+    readonly net: number;
+};
+/** 方向：支出侧按绝对值累计、收入侧按原值；转账两侧都不算。 */
+export type Direction = 'expense' | 'income';
+/** 一条聚合行：键 ＋ 该方向的金额 ＋ 笔数 ＋ 占比（占比＝占这一批**全部**聚合行合计，不是占前 N 名）。 */
+export interface AggRow {
+    readonly key: string;
+    readonly value: number;
+    readonly count: number;
+    readonly pct: number;
+}
+/** 序列里一个月的事实（`count === 0` 即**这个月一条记录都没有**——图表按「缺口」画，不按 0 画）。 */
+export interface MonthPoint {
+    readonly month: string;
+    readonly expense: number;
+    readonly income: number;
+    readonly net: number;
+    readonly count: number;
+}
+/** 对比的一侧（KPI ＋ 期间标签）。 */
+export interface CompareSide extends Kpi {
+    readonly label: string;
+}
+/** 两段对比：两侧事实 ＋ 支出侧的变化（金额差与百分比，老侧同数同向）。 */
+export interface ComparePair {
+    readonly a: CompareSide;
+    readonly b: CompareSide;
+    readonly change: {
+        readonly diff: number;
+        readonly pct: number;
+    };
+}
+/** 取数窗口（老侧各命令自己那一段的落点）：期间标签 ＋ 起止日 ＋ 记录（升序）。 */
+export interface WindowSet {
+    readonly label: string;
+    readonly from: string;
+    readonly to: string;
+    readonly records: readonly BillRow[];
+}
+/** 参数里的时间窗（只有标签与起止，不含记录）。 */
+export interface WindowRead {
+    readonly label: string;
+    readonly from: string;
+    readonly to: string;
+}
+/** **读参数里的时间窗**（域内共用，老侧 25 个 `cmd_*` 各自那段 `if args.from_date ... else month` 的共用位）：
+ *  给了 `start`／`end` 取闭区间；给了 `month` 取整月；都不给＝`fallback`。
+ *  `fallback` 两档：`'this-month'`（缺省，老侧多数命令的缺省）与 `'all-time'`（老侧 `--from/--to` 都不给就全库那几支：
+ *  标签写「全部时间」、起止写 `不限`，调用方据此走「取全库」那一支）。 */
+export declare function readWindow(params: Record<string, unknown>, opts?: {
+    readonly fallback?: 'this-month' | 'all-time';
+}): WindowRead;
+/** **读窗口并取数**（`readWindow` 那一支的「连记录一起拿」写法）：全时间那一档取全库，其余取闭区间。 */
+export declare function windowWithRecords(params: Record<string, unknown>, db: BillDb, opts?: {
+    readonly fallback?: 'this-month' | 'all-time';
+}): WindowRead & {
+    readonly records: readonly BillRow[];
+};
+export declare function round2(n: number): number;
+export declare function round1(n: number): number;
+/** `'YYYY-MM-DD HH:MM:SS'` → `'YYYY-MM'`。 */
+export declare function monthOf(time: string): string;
+/** 一天的日期串（记录时间的前 10 位）。 */
+export declare function dayOf(time: string): string;
+/** 年份窗口：`YYYY-01-01 00:00:00` ~ `YYYY-12-31 23:59:59`。 */
+export declare function yearRange(year: number): {
+    readonly start: string;
+    readonly end: string;
+};
+/** 两个日期之间隔几天（含首尾：`2026-05-01`~`2026-05-31` ＝ 31 天）。日均支出读它。 */
+export declare function daysBetween(from: string, to: string): number;
+/** 本月（当刻时钟所在月）。老侧 `date.today().strftime("%Y-%m")` 的同义写法。
+ *  「当刻」由进程时钟给（测试用 `test/helpers/config-base.mjs` 的 `freezeClock` 钉住），本件不自己造第二个时间源。 */
+export declare function thisMonth(): string;
+/** 今天（`YYYY-MM-DD`）。同口径：时钟来源唯一，测试钉钟即钉住它。 */
+export declare function today(): string;
+/** 上一月（`2026-01` → `2025-12`）。 */
+export declare function prevMonth(month: string): string;
+/** 取一段：[起, 止] 闭区间（老侧 `_fetch(from, to)` 同义）。 */
+export declare function windowRecords(db: BillDb, from: string, to: string): BillRow[];
+/** 全库记录（软删除外）。 */
+export declare function allRecords(db: BillDb): BillRow[];
+/** KPI（转账除外；与共用位同一件）。 */
+export declare function kpiOf(records: readonly BillRow[]): Kpi;
+/** 组合筛选：账户／账本／收支方向／L1 分类前缀。**先剔转账**（转账不是收支，方向筛选也不该带上它）。 */
+export declare function filterOf(records: readonly BillRow[], opts?: {
+    readonly account?: string;
+    readonly ledger?: string;
+    readonly direction?: Direction;
+    readonly categoryL1?: string;
+}): BillRow[];
+/** 按某个键聚合（键由调用方给：分类 L1／账户／账本／星期…）。
+ *  金额按 `direction` 取（支出＝绝对值、收入＝原值）；`pct` ＝ 占**全部聚合行**合计的比例；
+ *  `topN` 给了就只留前 N 名（占比仍按全量算，与老侧同序同数）。 */
+export declare function aggBy(records: readonly BillRow[], keyFn: (r: BillRow) => string, opts?: {
+    readonly topN?: number;
+    readonly direction?: Direction;
+}): AggRow[];
+/** 逐月序列（近 `months` 个月，含没有记录的月——空月的 `count` 为 0，图表据此画缺口）。 */
+export declare function monthSeries(records: readonly BillRow[], months: number): MonthPoint[];
+/** 记录里最晚的时刻（没有记录＝空串）。 */
+export declare function lastTimeOf(records: readonly BillRow[]): string;
+/** 记录里最早的时刻（没有记录＝空串）。 */
+export declare function firstTimeOf(records: readonly BillRow[]): string;
+/** 两段对比（老侧 `_compare_two` 同数同向：差＝A 支出 − B 支出，百分比以 B 为分母、B 为 0 时记 0）。 */
+export declare function compareTwo(a: readonly BillRow[], b: readonly BillRow[], labelA: string, labelB: string): ComparePair;
+/** `#标签` 的记录（精确整词匹配，规则住共用位 `../fetch/db.js` 的 `tagMatch`；本件不重写比对）。 */
+export declare function tagRecords(records: readonly BillRow[], tag: string): BillRow[];
+/** 支出金额最大的前 `limit` 笔（金额绝对值降序，同额按时间晚的在前）。 */
+export declare function expenseTop(records: readonly BillRow[], limit: number): BillRow[];
+/** L1 分类聚合（老侧 `_agg_expense_by(..., lambda r: _l1(r.category))` 的同义写法）。 */
+export declare function aggByL1(records: readonly BillRow[], opts?: {
+    readonly topN?: number;
+    readonly direction?: Direction;
+}): AggRow[];
+//# sourceMappingURL=agg.d.ts.map

package/dist/analysis/agg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg.d.ts","sourceRoot":"","sources":["../../src/analysis/agg.ts"],"names":[],"mappings":"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"}

package/dist/analysis/agg.js

@@ -0,0 +1,196 @@
+import { fetchAll, listRange, tagMatch } from '../fetch/index.js';
+import { l1Of } from '../shared/category.js';
+import { calcKpi, isTransfer } from '../shared/kpi.js';
+import { monthRange } from '../shared/dateRange.js';
+import { needMonth, needRange } from './params.js';
+import { NO_WINDOW, windowLabel } from './pageParts.js';
+/** **读参数里的时间窗**（域内共用，老侧 25 个 `cmd_*` 各自那段 `if args.from_date ... else month` 的共用位）：
+ *  给了 `start`／`end` 取闭区间；给了 `month` 取整月；都不给＝`fallback`。
+ *  `fallback` 两档：`'this-month'`（缺省，老侧多数命令的缺省）与 `'all-time'`（老侧 `--from/--to` 都不给就全库那几支：
+ *  标签写「全部时间」、起止写 `不限`，调用方据此走「取全库」那一支）。 */
+export function readWindow(params, opts = {}) {
+    const fallback = opts.fallback ?? 'this-month';
+    if (params['start'] !== undefined || params['end'] !== undefined) {
+        const { start, end } = needRange(params);
+        return { label: windowLabel(start, end), from: start, to: end };
+    }
+    const raw = params['month'];
+    if (raw === undefined || raw === null || raw === '') {
+        if (fallback === 'all-time')
+            return { label: '全部时间', from: NO_WINDOW, to: NO_WINDOW };
+        const { start, end } = monthRange(thisMonth());
+        return { label: thisMonth(), from: start, to: end };
+    }
+    const month = needMonth(params);
+    const { start, end } = monthRange(month);
+    return { label: month, from: start, to: end };
+}
+/** **读窗口并取数**（`readWindow` 那一支的「连记录一起拿」写法）：全时间那一档取全库，其余取闭区间。 */
+export function windowWithRecords(params, db, opts = {}) {
+    const win = readWindow(params, opts);
+    return { ...win, records: win.from === NO_WINDOW ? allRecords(db) : windowRecords(db, win.from, win.to) };
+}
+export function round2(n) { return Math.round(n * 100) / 100; }
+export function round1(n) { return Math.round(n * 10) / 10; }
+/** `'YYYY-MM-DD HH:MM:SS'` → `'YYYY-MM'`。 */
+export function monthOf(time) { return String(time).slice(0, 7); }
+/** 一天的日期串（记录时间的前 10 位）。 */
+export function dayOf(time) { return String(time).slice(0, 10); }
+/** 年份窗口：`YYYY-01-01 00:00:00` ~ `YYYY-12-31 23:59:59`。 */
+export function yearRange(year) {
+    return { start: year + '-01-01', end: year + '-12-31' };
+}
+/** 两个日期之间隔几天（含首尾：`2026-05-01`~`2026-05-31` ＝ 31 天）。日均支出读它。 */
+export function daysBetween(from, to) {
+    const a = Date.parse(from + 'T00:00:00Z');
+    const b = Date.parse(to + 'T00:00:00Z');
+    if (!Number.isFinite(a) || !Number.isFinite(b) || b < a)
+        return 1;
+    return Math.floor((b - a) / 86400000) + 1;
+}
+/** 本月（当刻时钟所在月）。老侧 `date.today().strftime("%Y-%m")` 的同义写法。
+ *  「当刻」由进程时钟给（测试用 `test/helpers/config-base.mjs` 的 `freezeClock` 钉住），本件不自己造第二个时间源。 */
+export function thisMonth() { return new Date().toISOString().slice(0, 7); }
+/** 今天（`YYYY-MM-DD`）。同口径：时钟来源唯一，测试钉钟即钉住它。 */
+export function today() { return new Date().toISOString().slice(0, 10); }
+/** 上一月（`2026-01` → `2025-12`）。 */
+export function prevMonth(month) {
+    const y = Number(month.slice(0, 4));
+    const m = Number(month.slice(5, 7));
+    return m === 1 ? String(y - 1) + '-12' : String(y) + '-' + String(m - 1).padStart(2, '0');
+}
+/** 取一段：[起, 止] 闭区间（老侧 `_fetch(from, to)` 同义）。 */
+export function windowRecords(db, from, to) {
+    return listRange(db, from, to);
+}
+/** 全库记录（软删除外）。 */
+export function allRecords(db) {
+    return fetchAll(db);
+}
+/** KPI（转账除外；与共用位同一件）。 */
+export function kpiOf(records) {
+    return calcKpi([...records]);
+}
+/** 组合筛选：账户／账本／收支方向／L1 分类前缀。**先剔转账**（转账不是收支，方向筛选也不该带上它）。 */
+export function filterOf(records, opts = {}) {
+    let out = records.filter((r) => !isTransfer(r));
+    if (opts.account !== undefined && opts.account !== '')
+        out = out.filter((r) => r.account === opts.account);
+    if (opts.ledger !== undefined && opts.ledger !== '')
+        out = out.filter((r) => r.ledger === opts.ledger);
+    if (opts.direction === 'expense')
+        out = out.filter((r) => r.amount < 0);
+    else if (opts.direction === 'income')
+        out = out.filter((r) => r.amount > 0);
+    const l1 = opts.categoryL1;
+    if (l1 !== undefined && l1 !== '')
+        out = out.filter((r) => l1Of(r.category) === l1);
+    return out;
+}
+/** 按某个键聚合（键由调用方给：分类 L1／账户／账本／星期…）。
+ *  金额按 `direction` 取（支出＝绝对值、收入＝原值）；`pct` ＝ 占**全部聚合行**合计的比例；
+ *  `topN` 给了就只留前 N 名（占比仍按全量算，与老侧同序同数）。 */
+export function aggBy(records, keyFn, opts = {}) {
+    const direction = opts.direction ?? 'expense';
+    const agg = new Map();
+    for (const r of records) {
+        if (isTransfer(r))
+            continue;
+        if (direction === 'expense' ? r.amount >= 0 : r.amount <= 0)
+            continue;
+        if (keyFn(r) === '')
+            continue;
+        const key = keyFn(r);
+        const it = agg.get(key) ?? { value: 0, count: 0 };
+        it.value += Math.abs(r.amount);
+        it.count += 1;
+        agg.set(key, it);
+    }
+    const total = [...agg.values()].reduce((sum, v) => sum + v.value, 0);
+    const rows = [...agg.entries()]
+        .map(([key, v]) => ({ key, value: round2(v.value), count: v.count, pct: total === 0 ? 0 : round1((v.value / total) * 100) }))
+        .sort((x, y) => y.value - x.value || x.key.localeCompare(y.key));
+    return opts.topN === undefined ? rows : rows.slice(0, opts.topN);
+}
+/** 逐月序列（近 `months` 个月，含没有记录的月——空月的 `count` 为 0，图表据此画缺口）。 */
+export function monthSeries(records, months) {
+    const byMonth = new Map();
+    for (const r of records) {
+        if (isTransfer(r))
+            continue;
+        const m = monthOf(r.time);
+        const it = byMonth.get(m) ?? { expense: 0, income: 0, count: 0 };
+        it.count += 1;
+        if (r.amount < 0)
+            it.expense += -r.amount;
+        else
+            it.income += r.amount;
+        byMonth.set(m, it);
+    }
+    const last = lastTimeOf(records);
+    const end = last === '' ? '' : monthOf(last);
+    const seq = monthBackwards(end === '' ? '' : end, months);
+    return seq.map((m) => {
+        const d = byMonth.get(m);
+        if (d === undefined)
+            return { month: m, expense: 0, income: 0, net: 0, count: 0 };
+        return {
+            month: m,
+            expense: round2(d.expense),
+            income: round2(d.income),
+            net: round2(d.income - d.expense),
+            count: d.count,
+        };
+    });
+}
+/** 从 `end` 这个月往回数 `months` 个月，按时间升序返回月份串（`end` 为空＝从今天起算）。 */
+function monthBackwards(end, months) {
+    const n = Math.max(Math.floor(months), 1);
+    let cur = /^\d{4}-\d{2}$/.test(end) ? end : new Date().toISOString().slice(0, 7);
+    const out = [];
+    for (let i = 0; i < n; i += 1) {
+        out.push(cur);
+        cur = prevMonth(cur);
+    }
+    return out.reverse();
+}
+/** 记录里最晚的时刻（没有记录＝空串）。 */
+export function lastTimeOf(records) {
+    let last = '';
+    for (const r of records)
+        if (r.time > last)
+            last = r.time;
+    return last;
+}
+/** 记录里最早的时刻（没有记录＝空串）。 */
+export function firstTimeOf(records) {
+    let first = '';
+    for (const r of records)
+        if (first === '' || r.time < first)
+            first = r.time;
+    return first;
+}
+/** 两段对比（老侧 `_compare_two` 同数同向：差＝A 支出 − B 支出，百分比以 B 为分母、B 为 0 时记 0）。 */
+export function compareTwo(a, b, labelA, labelB) {
+    const ka = kpiOf(a);
+    const kb = kpiOf(b);
+    const diff = round2(ka.expense - kb.expense);
+    const pct = kb.expense === 0 ? 0 : round1(((ka.expense - kb.expense) / kb.expense) * 100);
+    return { a: { ...ka, label: labelA }, b: { ...kb, label: labelB }, change: { diff, pct } };
+}
+/** `#标签` 的记录（精确整词匹配，规则住共用位 `../fetch/db.js` 的 `tagMatch`；本件不重写比对）。 */
+export function tagRecords(records, tag) {
+    return records.filter((r) => tagMatch(r.note, tag));
+}
+/** 支出金额最大的前 `limit` 笔（金额绝对值降序，同额按时间晚的在前）。 */
+export function expenseTop(records, limit) {
+    return records
+        .filter((r) => r.amount < 0 && !isTransfer(r))
+        .sort((a, b) => a.amount - b.amount || b.time.localeCompare(a.time))
+        .slice(0, limit);
+}
+/** L1 分类聚合（老侧 `_agg_expense_by(..., lambda r: _l1(r.category))` 的同义写法）。 */
+export function aggByL1(records, opts = {}) {
+    return aggBy(records, (r) => l1Of(r.category), opts);
+}
+//# sourceMappingURL=agg.js.map

package/dist/analysis/agg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agg.js","sourceRoot":"","sources":["../../src/analysis/agg.ts"],"names":[],"mappings":"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"}

package/dist/analysis/cards.d.ts

@@ -0,0 +1,40 @@
+import type { KpiCardInput } from 'base-paint/blocks';
+import type { PageBlock } from '../shared/pageSections.js';
+import type { BarGroup, ChartCard, EmptySpec, FactCard, ListCard, TableCard } from './scene.js';
+/** 一格带导航面与段标题的卡（各族的块清单由它逐张拼出）：锚点与导航条目同源给，标题即那枚 `<h2>`。 */
+export declare function cardBlock(html: string, anchor: string, title: string): PageBlock;
+/** 条卡组（一组占比条）：行即条；零行出这一组自己的空态句。 */
+export declare function barGroupHtml(group: BarGroup): string;
+/** 列表卡：`左 ｜ 主文 ｜ 右`，零行出这一张卡的空态句。 */
+export declare function listCardHtml(card: ListCard): string;
+/** 小表卡：表题走公共层 `caption` 位；零行出 `emptyText`（公共层表格件自己出空态，本件不另写一套）。 */
+export declare function tableCardHtml(card: TableCard): string;
+/** 事实卡：`键 ｜ 值` 两栏（`renderListRows` 的右栏对齐），零行不出（调用方按 `rows.length` 决定要不要这张卡）。 */
+export declare function factCardHtml(card: FactCard): string;
+/** 图卡：kind ＋ 数据 ＋ 标题全交给公共层图表件（技能侧零 SVG 副本）。 */
+export declare function chartCardHtml(card: ChartCard): string;
+/** 对比的一侧（一段期间的四格读数）：卡区标题即这段期间的标签。 */
+export interface CompareSideCard {
+    readonly title: string;
+    readonly kpis: readonly KpiCardInput[];
+}
+/** 对比双卡（并排两段期间；两端都是读数卡区，只有标题不同）。 */
+export declare function compareSidesHtml(sides: readonly CompareSideCard[]): string;
+/** 读数卡区（本域五个族共用的一格）：标题给了就出一枚段标题；零卡＝空串（不产空网格）。 */
+export declare function kpiGridHtml(cards: readonly KpiCardInput[], title?: string): string;
+/** 芯片列：筛选条件／结果计数那一排短词（老侧 `.filter-chip`）。 */
+export declare function chipsHtml(items: readonly string[]): string;
+/** 可见芯片列＝**族槽与结果槽的并集**（去重）。
+ *  两个槽的分工：`page.chips` 是这一族自己要摆在正文里的芯片，`SceneResult.chips` 是这次结果的胶囊；
+ *  四族的模板都只出一排芯片，故取并集——两处写同一个值时不会出双份，只写一处的场景也不会漏掉那一枚。 */
+export declare function mergedChips(family: readonly string[], result: readonly string[]): string;
+/** 空态格（含引导句）：窗口内一条记录也没有时**整页仍完整**，这一格就是那句空态（#688 裁定 4）。 */
+export declare function emptyHtml(spec: EmptySpec): string;
+/** 一段期间的读数（对比页的一侧：期间标签 ＋ 那一侧的读数卡）。 */
+export declare function sideKpisOf(label: string, kpi: {
+    count: number;
+    expense: number;
+    income: number;
+    net: number;
+}, money: (n: number) => string): readonly KpiCardInput[];
+//# sourceMappingURL=cards.d.ts.map

package/dist/analysis/cards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cards.d.ts","sourceRoot":"","sources":["../../src/analysis/cards.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGhG,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAEhF;AAOD,mCAAmC;AACnC,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAKpD;AAED,oCAAoC;AACpC,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAUnD;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAOrD;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAGnD;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAErD;AAED,qCAAqC;AACrC,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,CAAC;CACxC;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,MAAM,CAE1E;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,SAAK,GAAG,MAAM,CAG9E;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE1D;AAED;;wDAEwD;AACxD,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAExF;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAEjD;AAED,sCAAsC;AACtC,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,YAAY,EAAE,CAOrK"}