skill-bill 0.1.0 → 0.2.1

package/dist/goal/pageParts.js

@@ -0,0 +1,233 @@
+/** 目标域页内共件：**本域眉标**、**两张页型共用的页框**、**几处取值口径**（金额文本、状态说法、
+ *  进度百分比夹取、字段卡的格子、缺项折叠区、复制区与来源脚注）。
+ *
+ * 谁在用（三个调用点，指名）：
+ *   ① `src/goal/template-form.ts`——设定表单页型（采集页 ＋ 回执页）两个调用点；
+ *   ② `src/goal/template-progress.ts`——进度视图页型（结果型 ⑥）两个调用点（预算／目标各一张）；
+ *   ③ `src/goal/scene-{set-budget,set-saving,budget,saving}.ts`——四件场景件取文案与取值口径。
+ *
+ * 本件**不含块位序列**（那是两份模板件的活），也不碰库与文件：只把普通数据加工成普通数据／
+ *  把公共层区块接成一串。分家理由与写入域、账户域同：块序的变化频率与取值口径不同，抄多份就会改一处漏几处。
+ *
+ * 口径（一处定义，别处不许再写第二份）：
+ *   - **眉标**＝`记账 · 目标域`（`shared/pageShell.ts` 不持「域名 → 取值」表，照 #688 §二 A1「域自报眉标」）；
+ *   - **缺值一律 `—`**（#688 裁定 4；数字 0 是真实读数，照实写 0）；
+ *   - **金额两位小数**（`toFixed(2)`，与查询域／账户域同一口径；老侧的千分位分隔符不照抄——
+ *     数值格式统一由公共层读数卡与表格承载，页面本地不另造一套格式化）；
+ *   - **进度百分比双端夹取 `0 ≤ pct ≤ 100`**（#688 §二 C13：老侧 `budget_view.html:209` 只有上界
+ *     `Math.min(pct,100)`、负值会画负宽度且 `:228` 显示负百分比，而同域 `saving_view.html:208` 是双端——
+ *     **同域两套下界口径，新侧取双端**；公共层读数卡的 `bar.pct` 本来就是 0–100 的闭区间，
+ *     夹取必须在进条之前完成，故这里是唯一一处）；
+ *   - **内部标识不上屏**（#688 裁定 1）：页面上不出现 `bill.`、库文件名、脚本路径、参数名——
+ *     唯一例外是复制载荷区与两处「口令原文」块（复制指令块、缺项折叠里的明文），那两处是给助手照抄的原文。
+ */
+import { renderStatusBadge } from 'base-paint';
+import { renderCaliberLine, renderChips, renderDataTable, renderDisclosure, renderEmptyBlock, renderPreBlock } from 'base-paint/blocks';
+import { copyArea, copyLog } from '../shared/copyArea.js';
+import { DOC_SKILL, DOC_VERSION, sceneKeyOf } from '../shared/pageIdentity.js';
+import { pageShell } from '../shared/pageShell.js';
+import { sourceLine } from '../shared/sourceLine.js';
+import { commandLine } from '../shared/writeParts.js';
+/** 目标域各页的眉标：**只在本域写一次**（共用位不持「域名→取值」表）。 */
+export const EYEBROW = '记账｜目标域';
+/** 本域各页统一走它：补上眉标再转共用位的 `pageShell`；调用点写法 `pageShell({…})` 不变。 */
+export function goalPageShell(input) {
+    return pageShell({ ...input, eyebrow: EYEBROW });
+}
+/** 写命令两页的页面内置 envelope（采集页 `ok:false`、回执页 `ok:true`；两页同一形状 `receipt`）。 */
+export function envelopeOf(key, ok, message) {
+    return { version: DOC_VERSION, skill: DOC_SKILL, shape: 'receipt', key: sceneKeyOf(key), data: { ok, message } };
+}
+/** 读命令那一页的 envelope（形状 `list`，`items` 必有、`total` 可选；判据不许宽过公共层）。 */
+export function listEnvelopeOf(key, data) {
+    return { version: DOC_VERSION, skill: DOC_SKILL, shape: 'list', key: sceneKeyOf(key), data };
+}
+/** 缺值占位（裁定 4）。 */
+export const MISSING = '—';
+/** 金额文本：两位小数。数字照实写（含 0）；不是有限数就写缺值占位。 */
+export function money(n) {
+    if (n === null || n === undefined || !Number.isFinite(n))
+        return MISSING;
+    return n.toFixed(2);
+}
+/** 进度百分比的双端夹取（**唯一定义地**，见件头口径）：条长与上屏的百分数同取一份。 */
+export function clampPct(n) {
+    if (n === null || n === undefined || !Number.isFinite(n))
+        return 0;
+    return Math.min(Math.max(n, 0), 100);
+}
+/** 百分比文本：一位小数（老侧 `fmtPct` 同口径），值已双端夹取。 */
+export function pctText(n) {
+    return clampPct(n).toFixed(1) + '%';
+}
+/** 月底预测那一句（**唯一定义地**；#688 §二 C13 的三态）。
+ *
+ *  三态判据与阈值逐字照老侧 `目标/budget_view.html:214-219`：`diff > 0.01` 预计超、
+ *  `diff < -0.01` 预计省、其间预计持平。**空预测＝空串**（`month_end_proj` 为 `null` 是「这一月没有预测可给」，
+ *  老侧那一支同样是空串——它靠 `b.month_end_proj != null && b.days_elapsed` 两个假值反查，新侧只判一处）。 */
+export function monthEndHintOf(item) {
+    if (item.month_end_proj === null || item.daily_avg === null)
+        return '';
+    const diff = item.month_end_proj - item.amount;
+    const hint = diff > 0.01 ? '预计超 ' + money(diff) + ' 元'
+        : diff < -0.01 ? '预计省 ' + money(Math.abs(diff)) + ' 元' : '预计持平';
+    return '日均 ' + money(item.daily_avg) + ' 元 · 按此节奏月底预计 ' + money(item.month_end_proj) + ' 元（' + hint + '）';
+}
+/** 一个值写成上屏文本：空白串与缺值一律 `—`（不写 `undefined`、不留空）。 */
+export function textOrDash(v) {
+    const s = typeof v === 'string' ? v.trim() : v === null || v === undefined ? '' : String(v);
+    return s === '' ? MISSING : s;
+}
+/** 预算状态的说法（老侧 `budget_view.html:101-105` 的 `STATUS_META` 逐字）。 */
+export const BUDGET_STATUS_META = {
+    ok: { kind: 'ok', label: '预算内' },
+    warn: { kind: 'warn', label: '接近上限' },
+    over: { kind: 'danger', label: '已超支' },
+};
+/** 目标状态的说法（老侧 `saving_view.html:99-104` 的 `STATUS_META` 逐字；档位照老侧 `:220` 的映射）。 */
+export const SAVING_STATUS_META = {
+    done: { kind: 'ok', label: '已达成' },
+    on_track: { kind: 'ok', label: '进行中' },
+    behind: { kind: 'warn', label: '进度落后' },
+    na: { kind: 'empty', label: '暂无进度' },
+};
+/** 类型徽章那一串（唤醒词 ＋ 口径 ＋ 状态徽章 ＋ 下一步动作）：四枚形状各自独立，不拼分隔符串。
+ *  形状照写入域 `../write/typeBadge.js` 与账户域 `../account/pageParts.js` 的同一套，本件只喂目标自己的取值。 */
+export function badgeOf(input) {
+    const items = input.caliber === '' ? [{ text: input.word }] : [{ text: input.word }, { text: input.caliber }];
+    const parts = [renderChips({ items }), renderStatusBadge({ status: input.status, text: input.statusText })];
+    const next = input.next.trim();
+    if (next !== '') {
+        for (const line of next.split('。').map((s) => s.trim()).filter((s) => s !== '')) {
+            parts.push(renderCaliberLine(line + '。'));
+        }
+    }
+    return parts.join('');
+}
+/** 字段卡的格子：一律由 `renderParamForm` 出（标签与控件配对、每格带 `name`）。
+ *  值一律取本次参数——老侧表单页也是把 AI 解析出的字段透传回来回显（`render.py:126-127` 那一类）。 */
+export function slotFieldsOf(params, fields) {
+    return fields.map((f) => {
+        const raw = params[f.name];
+        const value = raw === true ? '是' : raw === false || raw === undefined || raw === null ? '' : String(raw).trim();
+        return {
+            name: f.name,
+            label: f.label,
+            hint: f.hint,
+            ...(f.required ? { required: true } : {}),
+            ...(value === '' ? {} : { value }),
+        };
+    });
+}
+/** 缺项阻断条：**收进折叠区**（点开才看得见），里面是「还缺什么」表 ＋ 只读的口令原文 ＋ 一句口径。
+ *  铁口径（照 #688 裁定 9）：缺项时**不出**可复制的写库指令——页面上那条口令只给看不给复制。 */
+export function blockedFoldOf(input) {
+    if (input.blocked.length === 0)
+        return '';
+    return renderChips({ items: input.blocked.map((b) => ({ text: b.label })) })
+        + renderDisclosure({
+            title: '还缺什么（点开看补齐后照抄的那条）',
+            contentHtml: renderDataTable({
+                columns: [
+                    { key: 'label', label: '还缺哪一项' },
+                    { key: 'why', label: '为什么进不去' },
+                ],
+                rows: input.blocked.map((b) => ({ label: b.label, why: b.why === '没给' ? '这一项没给' : b.why })),
+                caption: '缺一项就先不写进去',
+            }) + renderPreBlock({ command: input.command, label: '口令原文（只给看不给复制）' })
+                + renderCaliberLine('这一页先不写库；补齐之后照上面那句跟助手说一遍才会写。'),
+        });
+}
+/** 复制指令块（过程型页的「照这句跟助手说一遍」）：走公共层 `renderPreBlock` 的自带复制按钮。 */
+export function promptBlockOf(prompt, label = '复制给助手：这一句可以直接复制') {
+    return renderPreBlock({
+        label,
+        command: prompt,
+        actionId: 'ilife-goal-prompt',
+        copyText: prompt,
+        copyLabel: label,
+    });
+}
+/** 复制区（数据位 ＋ 日志位；三格式与双按钮由共用件给）。 */
+export function copyZoneOf(input) {
+    return copyArea({
+        data: { envelope: input.envelope, title: input.title },
+        log: {
+            envelope: input.envelope,
+            copyLog: copyLog({
+                command: commandLine(input.key, input.params),
+                source: input.source,
+                detail: input.detail,
+                actionAt: input.actionAt,
+                version: DOC_VERSION,
+            }),
+        },
+    });
+}
+/** 空态（含「接下来怎么办」那一句）：预算表为空、目标表为空、当月无记录几处共用。 */
+export function emptyOf(input) {
+    return renderEmptyBlock({ ...(input.title === undefined ? {} : { title: input.title }), text: input.text, hint: input.next });
+}
+/** 来源脚注（结果型页恒出，照 #688 §五 5.2 第 26 行）：三样值由调用方给。 */
+export function sourceNoteOf(input) {
+    return sourceLine({ source: input.sourceText, start: input.start, end: input.end, count: input.count });
+}
+/** 缺项时那条口令原文：缺的值留成尖括号占位符，**只给看不给复制**。
+ *  两处与账户域不同：①「确认覆盖」那一格映射成 `true`（它不是用户填的槽位，是「覆盖掉那一条」这个意图）；
+ *  ②其余格按参数名映射。 */
+export function blockedCommandOf(key, params, blocked) {
+    const filled = { ...params };
+    for (const b of blocked) {
+        filled[b.name] = b.name === 'force' ? true : '<' + b.label + '>';
+    }
+    return commandLine(key, filled);
+}
+/** 回执页的状态卡：新设／覆盖了旧的 ＋ 一句写入去向的说明。 */
+export function receiptStatusCard(overwritten) {
+    return statusCard(overwritten ? '覆盖了旧的' : '新设的', overwritten ? '同月同类那一条已按新值改写' : '这一条是这次新加的');
+}
+/** 一格的状态值：值 ＋ 一句说明。 */
+export function statusCard(value, detail) {
+    return { label: '状态', value, detail };
+}
+/** 页尾「对账信息」折叠区：本次写入的**可核对信息**（改了几处／什么时候写的／怎么核对）。 */
+export function reconcileOf(input) {
+    return renderDisclosure({
+        title: '对账信息',
+        contentHtml: renderDataTable({
+            columns: [{ key: 'k', label: '哪一项' }, { key: 'v', label: '记成什么' }],
+            rows: [
+                { k: '改了目标表里几处', v: String(input.changed) + ' 处' },
+                { k: '写入时间', v: input.actionAt },
+                { k: '怎么核对', v: input.note },
+            ],
+        }),
+    });
+}
+/** 采集页／回执页明细表的列（**这一族页型唯一定义地**：表头文本与每格 `data-label` 同源）。 */
+export const DETAIL_COLUMNS = [
+    { key: 'k', label: '哪一项' },
+    { key: 'v', label: '记成什么' },
+];
+/** 明细表的行：普通数据，按面量接口给（`renderDataTable` 收 `Record<string, unknown>`）。 */
+export function detailRows(rows) {
+    return rows.map((r) => ({ ...r }));
+}
+/** 复制日志第 3 段的三句来源：给机器看的那句可带载体名，上屏（来源脚注）的那句只写人话
+ *  （照 #688 裁定 1：库文件名、命令名与脚本路径一律不上屏）。 */
+export const SOURCE_COLLECT = '目标表（只读：这一页先不写库，只采集）';
+export const SOURCE_WRITE = '目标表（写库回执）';
+export const SOURCE_COLLECT_TEXT = '目标表（只读）';
+export const SOURCE_WRITE_TEXT = '目标表（写入）';
+/** 采集页／回执页复制口令那一段（「照这句跟助手说一遍」）：说清是哪条词、每一格填什么。
+ *  空着的格写 `____`（必填）或 `____（选填）`，与老侧复制文本的占位写法同义（老侧写 `__如:3000__`）。 */
+export function promptOf(word, slots, params) {
+    const lines = slots.map((s) => {
+        const raw = params[s.name];
+        const v = raw === true ? '是' : raw === false || raw === undefined || raw === null ? '' : String(raw).trim();
+        const blank = s.required ? '____' : '____（选填）';
+        return '  ' + s.label + ': ' + (v === '' ? blank : v);
+    });
+    return '请加载「饼干记账」技能，帮我' + word + '：\n\n' + lines.join('\n');
+}
+//# sourceMappingURL=pageParts.js.map

package/dist/goal/pageParts.js.map

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

package/dist/goal/params.d.ts

@@ -0,0 +1,63 @@
+/** 写命令的两支操作（老侧 `goal/cli.py` 的 set-budget／set-saving 两个子命令）。 */
+export type GoalWriteOp = 'set-budget' | 'set-saving';
+/** 读命令的两支操作（老侧 `goal/cli.py` 的 budget／saving 两个子命令）。 */
+export type GoalReadOp = 'budget' | 'saving';
+/** 目标域四支操作的合集（域声明 `preset.op` 的取值面）。 */
+export type GoalOp = GoalWriteOp | GoalReadOp;
+/** 两位小数（金额的每一格都过它：老侧每处 `round(x, 2)` 同一口径）。 */
+export declare function round2(n: number): number;
+/** 本地日期串 `YYYY-MM-DD`（**全仓仅此一处**：目标域的「今天」照老侧 `date.today()` 取本地时区）。 */
+export declare function localDay(now?: Date): string;
+/** 本地月份串 `YYYY-MM`（同上，用于「不填月份＝本月」）。 */
+export declare function localMonth(now?: Date): string;
+/** 写命令的 op 归一：只认两支；缺省／非法一律抛——op 是这一条命令自己的判别式，**不猜**
+ *  （老侧靠子命令名认，两处同口径；与账户域 `parseAccountOp` 同一套判法）。 */
+export declare function parseGoalWriteOp(params: Record<string, unknown>): GoalWriteOp;
+/** 读命令的 op 归一：**缺省＝budget**（照老侧「看预算」是这一域最常读的一支、也是搬迁前
+ *  `cmd_read.ts` 那条 `op === 'budget' || params.op === undefined` 的缺省口径）；两支之外抛。 */
+export declare function parseGoalReadOp(params: Record<string, unknown>): GoalReadOp;
+/** 一个槽位：参数名／中文名／怎么给／是否必需。 */
+export interface GoalSlot {
+    readonly name: string;
+    readonly label: string;
+    readonly hint: string;
+    readonly required: boolean;
+}
+/** 一处阻断：哪一格／中文名／为什么进不去（`没给` 与值不对共用一张表）。 */
+export interface GoalBlocked {
+    readonly name: string;
+    readonly label: string;
+    readonly why: string;
+}
+/** 「确认覆盖」那一格：老侧 `cli.py:143` 的 `--force`。它不是一个用户填的槽位，
+ *  而是「同月同类预算已存在」这件事的出口，故单立一格（同账户域 `CHANGE_SLOT` 的处置）。 */
+export declare const FORCE_SLOT: GoalSlot;
+/** 写命令两支操作的槽位表（**唯一定义地**）：字段卡照它出，缺项探针照它算。
+ *  中文名照老侧表单页的字段题头（`budget_form.html:58-68`／`saving_form.html:57-63`）。 */
+export declare const GOAL_WRITE_SLOTS: Readonly<Record<GoalWriteOp, readonly GoalSlot[]>>;
+/** 一个值算不算「给了」：`undefined`／`null`／`false`／空白串都不算。 */
+export declare function isGiven(v: unknown): boolean;
+/** 一个值写成文本（认字符串与有限数；其余形态一律当没给——不猜）。 */
+export declare function textOf(v: unknown): string;
+/** 数字解析：认数字与非空数字串；解析不了给 `null`（不在这里报错，报错归调用方）。 */
+export declare function numberOf(v: unknown): number | null;
+/** 金额：正数（老侧 `cli.py:133`／`:227` 的「必须 > 0」）。给的是钱，负数与 0 都不成立。 */
+export declare function validateAmount(raw: unknown): number;
+/** 本支写操作当下缺什么、哪一格的值进不去（**空数组＝可以往下走写库那一步**）。
+ *  同月同类预算撞车那一处住 `./write.js` 的 `budgetBlockedOf`——本件只吃参数，不碰库与文件。 */
+export declare function goalBlocked(op: GoalWriteOp, params: Record<string, unknown>): readonly GoalBlocked[];
+/** 设定预算的真值校验（阻断闸门放行之后才会走到这里）：金额为正数、月份归一（不给＝本月）、分类可空。
+ *  `force` 不在这里判——它是不是必需，取决于库里有没有同月同类那一条（住 `./write.js`）。 */
+export declare function validateSetBudget(params: Record<string, unknown>): {
+    month: string;
+    category: string;
+    amount: number;
+    force: boolean;
+};
+/** 设定目标的真值校验：目标名必填、金额为正数、截止日可空（给了就须是真实日期）。 */
+export declare function validateSetSaving(params: Record<string, unknown>): {
+    name: string;
+    amount: number;
+    deadline: string | null;
+};
+//# sourceMappingURL=params.d.ts.map

package/dist/goal/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/goal/params.ts"],"names":[],"mappings":"AA2BA,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC;AAEtD,wDAAwD;AACxD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE7C,wCAAwC;AACxC,MAAM,MAAM,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;AAE9C,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,uEAAuE;AACvE,wBAAgB,QAAQ,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAGvD;AAED,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,GAAG,GAAE,IAAiB,GAAG,MAAM,CAEzD;AAED;oDACoD;AACpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,CAI7E;AAED;kFACkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAK3E;AAED,6BAA6B;AAC7B,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAMD;yDACyD;AACzD,eAAO,MAAM,UAAU,EAAE,QAAiE,CAAC;AAE3F;yEACyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,QAAQ,EAAE,CAAC,CAW/E,CAAC;AAEF,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG3C;AAED,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGzC;AAED,kDAAkD;AAClD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMlD;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMnD;AAED;oEACoE;AACpE,wBAAgB,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,WAAW,EAAE,CAqBpG;AAYD;6DAC6D;AAC7D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAMtI;AAED,8CAA8C;AAC9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAS5H"}

package/dist/goal/params.js

@@ -0,0 +1,164 @@
+/** 目标域·命令参数与槽位表（**唯一定义地**）：写命令的两支操作（设定预算／设定目标）、
+ *  读命令的两支操作（看预算／看目标）、每支要哪些槽位、缺项与「值不对」怎么报。
+ *
+ * 谁在用（四个调用点，指名）：
+ *   ① `src/goal/write.ts`——写命令处理体：拿 `goalBlocked` 当闸门（非空即出采集页、不写库），
+ *      闸门放行之后才调 `validateSetBudget`／`validateSetSaving` 做真值校验；
+ *   ② `src/goal/read.ts`——读命令处理体：`parseGoalReadOp` 认哪一支（预算执行／目标进度）；
+ *   ③ `src/goal/scene-set-{budget,saving}.ts`——写命令两件场景件按 `GOAL_WRITE_SLOTS[op]` 出字段卡、
+ *      按 `goalBlocked` 出缺项标签；
+ *   ④ `src/goal/template-form.ts`——采集页的缺项标签与口令原文读同一份阻断表。
+ *
+ * 老侧对应件：`scripts/goal/cli.py`（四支的真值校验）与 `scripts/goal/render.py`（四张页的字段与文案）。
+ *  口径按本文重摆，三处与老侧不同（逐条进 `docs/skills/skill-bill/t730-差异表.md`）：
+ *   - **缺失与「值不对」分开**：老侧两种情况都是 `raise ValueError` 一句话（`cli.py:133-137`／`:226-236`），
+ *     页上看不出缺哪一格；新侧按 #688 裁定 9 出**缺项阻断条**，逐项点名（`why` 说清为什么进不去）。
+ *   - **同月同类预算撞车**：老侧 `cli.py:143-147` 在 CLI 里回一句「确认覆盖请加 --force」；
+ *     新侧提进阻断表（`force` 那一格），采集页当场把「已存在哪一条」摊开——老侧表单页
+ *     `budget_form.html:129-134` 本来就画这条冲突提示，新侧只是把它接到同一条阻断路径上（裁定 9）。
+ *   - **月份与截止日的归一**：取 `../shared/dateRange.js` 的 `normalizeMonth`／`normalizeDate`（真源一处）；
+ *     老侧那两条正则（`cli.py:46-47`）在归一这一层与之一致（月份 `YYYY-MM`、日期 `YYYY-MM-DD` 且真实日期）。
+ *
+ * 「今天／本月」按**本地时钟**取（老侧 `date.today()` 同口径）：本件给 `localDay`／`localMonth` 两件，
+ *  域内别处不许再各写一份本地日期算式（`new Date().toISOString()` 是 UTC 日，跨零点会差一天）。
+ */
+import { BillPolicyError } from '../fetch/errors.js';
+import { MONTH_RE, normalizeDate, normalizeMonth } from '../shared/dateRange.js';
+/** 两位小数（金额的每一格都过它：老侧每处 `round(x, 2)` 同一口径）。 */
+export function round2(n) {
+    return Math.round(n * 100) / 100;
+}
+/** 本地日期串 `YYYY-MM-DD`（**全仓仅此一处**：目标域的「今天」照老侧 `date.today()` 取本地时区）。 */
+export function localDay(now = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return String(now.getFullYear()) + '-' + pad(now.getMonth() + 1) + '-' + pad(now.getDate());
+}
+/** 本地月份串 `YYYY-MM`（同上，用于「不填月份＝本月」）。 */
+export function localMonth(now = new Date()) {
+    return localDay(now).slice(0, 7);
+}
+/** 写命令的 op 归一：只认两支；缺省／非法一律抛——op 是这一条命令自己的判别式，**不猜**
+ *  （老侧靠子命令名认，两处同口径；与账户域 `parseAccountOp` 同一套判法）。 */
+export function parseGoalWriteOp(params) {
+    const op = params['op'];
+    if (op === 'set-budget' || op === 'set-saving')
+        return op;
+    throw new BillPolicyError('POLICY_BAD_INPUT', 'op 非法（只认 set-budget／set-saving）：' + JSON.stringify(op));
+}
+/** 读命令的 op 归一：**缺省＝budget**（照老侧「看预算」是这一域最常读的一支、也是搬迁前
+ *  `cmd_read.ts` 那条 `op === 'budget' || params.op === undefined` 的缺省口径）；两支之外抛。 */
+export function parseGoalReadOp(params) {
+    const op = params['op'];
+    if (op === undefined || op === null || op === '')
+        return 'budget';
+    if (op === 'budget' || op === 'saving')
+        return op;
+    throw new BillPolicyError('POLICY_BAD_INPUT', 'op 非法（只认 budget／saving）：' + JSON.stringify(op));
+}
+function slot(name, label, hint, required) {
+    return { name, label, hint, required };
+}
+/** 「确认覆盖」那一格：老侧 `cli.py:143` 的 `--force`。它不是一个用户填的槽位，
+ *  而是「同月同类预算已存在」这件事的出口，故单立一格（同账户域 `CHANGE_SLOT` 的处置）。 */
+export const FORCE_SLOT = slot('force', '确认覆盖', '已经有同月同类的预算时，要覆盖它就把这一格给上', true);
+/** 写命令两支操作的槽位表（**唯一定义地**）：字段卡照它出，缺项探针照它算。
+ *  中文名照老侧表单页的字段题头（`budget_form.html:58-68`／`saving_form.html:57-63`）。 */
+export const GOAL_WRITE_SLOTS = {
+    'set-budget': [
+        slot('amount', '金额', '每月的预算上限，写正数，如 3000', true),
+        slot('month', '月份', '选填，如 2026-09；不填就是本月起', false),
+        slot('category', '分类', '选填，如 餐饮；不填 = 全月总预算', false),
+    ],
+    'set-saving': [
+        slot('name', '目标', '想存钱买什么，一句话说清，如 换手机', true),
+        slot('amount', '金额', '目标总额，写正数，如 10000', true),
+        slot('deadline', '截止日期', '选填，如 2026-12-31；不填 = 无截止日期', false),
+    ],
+};
+/** 一个值算不算「给了」：`undefined`／`null`／`false`／空白串都不算。 */
+export function isGiven(v) {
+    if (v === undefined || v === null || v === false)
+        return false;
+    return !(typeof v === 'string' && v.trim() === '');
+}
+/** 一个值写成文本（认字符串与有限数；其余形态一律当没给——不猜）。 */
+export function textOf(v) {
+    if (typeof v === 'string')
+        return v.trim();
+    return typeof v === 'number' && Number.isFinite(v) ? String(v) : '';
+}
+/** 数字解析：认数字与非空数字串；解析不了给 `null`（不在这里报错，报错归调用方）。 */
+export function numberOf(v) {
+    if (v === undefined || v === null || typeof v === 'boolean')
+        return null;
+    const raw = typeof v === 'string' ? v.trim() : v;
+    if (raw === '')
+        return null;
+    const n = typeof raw === 'number' ? raw : Number(raw);
+    return Number.isFinite(n) ? n : null;
+}
+/** 金额：正数（老侧 `cli.py:133`／`:227` 的「必须 > 0」）。给的是钱，负数与 0 都不成立。 */
+export function validateAmount(raw) {
+    const n = numberOf(raw);
+    if (n === null || n <= 0) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '金额须为正数：' + JSON.stringify(raw));
+    }
+    return round2(n);
+}
+/** 本支写操作当下缺什么、哪一格的值进不去（**空数组＝可以往下走写库那一步**）。
+ *  同月同类预算撞车那一处住 `./write.js` 的 `budgetBlockedOf`——本件只吃参数，不碰库与文件。 */
+export function goalBlocked(op, params) {
+    const out = [];
+    for (const s of GOAL_WRITE_SLOTS[op]) {
+        if (s.required && !isGiven(params[s.name]))
+            out.push({ name: s.name, label: s.label, why: '没给' });
+    }
+    if (isGiven(params['amount'])) {
+        const n = numberOf(params['amount']);
+        if (n === null || n <= 0)
+            out.push({ name: 'amount', label: '金额', why: '要写正数（如 3000）' });
+    }
+    if (op === 'set-budget') {
+        const month = textOf(params['month']);
+        if (month !== '' && !MONTH_RE.test(month)) {
+            out.push({ name: 'month', label: '月份', why: '要写成 2026-09 这样（年-月），不填就是本月' });
+        }
+        return out;
+    }
+    const deadline = textOf(params['deadline']);
+    if (deadline !== '' && !isRealDate(deadline)) {
+        out.push({ name: 'deadline', label: '截止日期', why: '要写成 2026-12-31 这样（年-月-日）' });
+    }
+    return out;
+}
+/** 一个日期串是不是真实日期（老侧 `cli.py:232-236` 的 `strptime` 同口径：2 月 30 这类要挡住）。 */
+function isRealDate(s) {
+    try {
+        normalizeDate(s, 'deadline');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** 设定预算的真值校验（阻断闸门放行之后才会走到这里）：金额为正数、月份归一（不给＝本月）、分类可空。
+ *  `force` 不在这里判——它是不是必需，取决于库里有没有同月同类那一条（住 `./write.js`）。 */
+export function validateSetBudget(params) {
+    const amount = validateAmount(params['amount']);
+    const month = params['month'] === undefined || params['month'] === null || params['month'] === ''
+        ? localMonth() : normalizeMonth(params['month']);
+    const category = typeof params['category'] === 'string' ? params['category'].trim() : '';
+    return { month, category, amount, force: params['force'] === true };
+}
+/** 设定目标的真值校验：目标名必填、金额为正数、截止日可空（给了就须是真实日期）。 */
+export function validateSetSaving(params) {
+    const raw = params['name'];
+    if (typeof raw !== 'string' || raw.trim() === '') {
+        throw new BillPolicyError('POLICY_MISSING_SLOT', '缺槽位 name（储蓄目标名）');
+    }
+    const amount = validateAmount(params['amount']);
+    const deadline = params['deadline'] === undefined || params['deadline'] === null || params['deadline'] === ''
+        ? null : normalizeDate(params['deadline'], 'deadline');
+    return { name: raw.trim(), amount, deadline };
+}
+//# sourceMappingURL=params.js.map

package/dist/goal/params.js.map

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

package/dist/goal/query.d.ts

@@ -0,0 +1,12 @@
+/** 目标域·查询载荷装配件（#689 结构搬迁第三批：从 `src/render/views.ts` 的 `buildGoalQuery` 来）。
+ *  一件事实：`bill.goal.query` 的 list 载荷 `{ items, total, op }`——预算执行与目标进度两行的
+ *  `spent／remaining／rate／saved／pct` 由调用方实算装配，本件只管载荷形状与条数。
+ *
+ *  谁在用（指名）：`src/cli/cmd_read.ts` 的 goal.query 分支（未迁移命令的分派，经 `./index.js` 门取）——
+ *    命令搬进本域后由本域处理体消费。 */
+export declare function buildGoalQuery(op: string, items: Record<string, unknown>[]): {
+    items: Record<string, unknown>[];
+    total: number;
+    op: string;
+};
+//# sourceMappingURL=query.d.ts.map

package/dist/goal/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/goal/query.ts"],"names":[],"mappings":"AAAA;;;;;yBAKyB;AACzB,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAE5I"}

package/dist/goal/query.js

@@ -0,0 +1,10 @@
+/** 目标域·查询载荷装配件（#689 结构搬迁第三批：从 `src/render/views.ts` 的 `buildGoalQuery` 来）。
+ *  一件事实：`bill.goal.query` 的 list 载荷 `{ items, total, op }`——预算执行与目标进度两行的
+ *  `spent／remaining／rate／saved／pct` 由调用方实算装配，本件只管载荷形状与条数。
+ *
+ *  谁在用（指名）：`src/cli/cmd_read.ts` 的 goal.query 分支（未迁移命令的分派，经 `./index.js` 门取）——
+ *    命令搬进本域后由本域处理体消费。 */
+export function buildGoalQuery(op, items) {
+    return { items, total: items.length, op };
+}
+//# sourceMappingURL=query.js.map

package/dist/goal/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/goal/query.ts"],"names":[],"mappings":"AAAA;;;;;yBAKyB;AACzB,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAgC;IACzE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;AAC5C,CAAC"}

package/dist/goal/read.d.ts

@@ -0,0 +1,5 @@
+import type { BillDb } from '../fetch/index.js';
+import type { ViewOut } from '../shared/commandSpec.js';
+/** `bill.goal.query`：看预算执行与目标进度（两支操作，只读）。 */
+export declare function viewGoal(params: Record<string, unknown>, db: BillDb): ViewOut;
+//# sourceMappingURL=read.d.ts.map

package/dist/goal/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/goal/read.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAkBxD,6CAA6C;AAC7C,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CA2C7E"}

package/dist/goal/read.js

@@ -0,0 +1,79 @@
+/** `bill.goal.query`（看预算／看目标）的处理体：两支操作，一处分流。
+ *
+ * 谁在用（一个调用点，指名）：`src/goal/commands.ts` 那条读命令声明引本件——
+ *  出口分派 `src/cli/cmd_read.ts` 只查注册表再调声明里的 `run`。
+ *
+ * 一页一件事：**预算表 ＋ 账本**两份事实合成「预算执行」那一页（老 `目标/budget_view.html`）、
+ *  **目标表 ＋ 账本**合成「目标进度」那一页（老 `目标/saving_view.html`）。出口载荷（stdout 那份）
+ *  与页面**同源不同形**：载荷给机器（`items`／`total`／`totals` 等窗口事实），页面给人。
+ *
+ * 老侧对应件：`scripts/goal/cli.py` 的 `cmd_budget` ＋ `cmd_saving`（老 `render.py:144-182` 把 CLI 的
+ *  JSON 再包一层交给模板）。老侧那条链是**子进程调用**（渲染器另起一次 CLI 取数），新侧一次调用内取数。
+ *
+ * 红线（照查询域／账户域同一套语义，本件不发明新的）：这两页**只读**——不建列、不写文件、不改库；
+ *  一条记录都没有时照出完整页（标题 ＋ 空态句 ＋ 引导句 ＋ 来源脚注），不当故障。
+ *
+ * 载荷的两处口径（差异表逐条记）：
+ *   - `items` 是 `list` 形必填的那一格（老侧那两支的键名分别是 `budgets`／`savings`，形状换名不换物）；
+ *   - `total` ＝ 这一页几条（老侧写 `count`，两个键在新侧都留着）。
+ */
+import { loadGoals, resolveGoalsPath } from '../fetch/index.js';
+import { actionStamp } from '../shared/copyArea.js';
+import { MONTH_RE, monthRange } from '../shared/dateRange.js';
+import { projectWakeWord } from '../triggers/wakeTable.js';
+import { budgetExecution, savingProgress } from './goalData.js';
+import { localDay, localMonth, parseGoalReadOp, textOf } from './params.js';
+import { readSceneFor } from './scene.js';
+/** 没有记录可算窗口时，来源脚注的起止位写这两个字（留空会读成缺值）。 */
+const NO_WINDOW = '不限';
+/** 这一页看的是哪个月（参数给的月份归一不了就按本月——与写命令那一支同一处口径）。 */
+function monthOf(params) {
+    const raw = textOf(params['month']);
+    return MONTH_RE.test(raw) ? raw : localMonth();
+}
+/** `bill.goal.query`：看预算执行与目标进度（两支操作，只读）。 */
+export function viewGoal(params, db) {
+    const key = 'bill.goal.query';
+    const op = parseGoalReadOp(params);
+    const scene = readSceneFor(op);
+    const goals = loadGoals(resolveGoalsPath());
+    const wakeWord = projectWakeWord({ key, op });
+    const actionAt = actionStamp();
+    if (op === 'budget') {
+        const month = monthOf(params);
+        const execution = budgetExecution(db, goals, month, textOf(params['category']));
+        const data = {
+            items: [...execution.budgets],
+            total: execution.count,
+            op,
+            month: execution.month,
+            count: execution.count,
+            budgets: [...execution.budgets],
+            totals: execution.totals,
+            records: execution.records,
+        };
+        const { start, end } = monthRange(month);
+        return { data, html: scene.view({ key, params, wakeWord, budget: execution, saving: null, data, windowStart: start, windowEnd: end, actionAt }) };
+    }
+    const progress = savingProgress(db, goals, textOf(params['name']));
+    const data = {
+        items: [...progress.savings],
+        total: progress.count,
+        op,
+        count: progress.count,
+        done_count: progress.done_count,
+        savings: [...progress.savings],
+        records: progress.records,
+    };
+    const first = progress.savings.reduce((min, s) => (min === '' || s.start_month < min ? s.start_month : min), '');
+    return {
+        data,
+        html: scene.view({
+            key, params, wakeWord, budget: null, saving: progress, data,
+            windowStart: first === '' ? NO_WINDOW : monthRange(first).start,
+            windowEnd: progress.savings.length === 0 ? NO_WINDOW : localDay(),
+            actionAt,
+        }),
+    };
+}
+//# sourceMappingURL=read.js.map

package/dist/goal/read.js.map

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