skill-bill 0.2.0 → 0.2.1

package/dist/shared/pageShell.js

@@ -1,15 +1,15 @@
 /** 页面模板与页头（每张页都有的第一件，**唯一定义地**）：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。
  *
  * 谁在用（两个能力，指名）：
- *   ① `src/record/`——写入域：过程型采集页（页头 ＋ 九块正文）与结果型回执整页（页头 ＋ 回执块序列）；
+ *   ① `src/write/`——写入域：过程型采集页（页头 ＋ 九块正文）与结果型回执整页（页头 ＋ 回执块序列）；
  *   ② `src/query/`——查询域：通用查询列表页（页头 ＋ KPI 行 ＋ 数据表 ＋ 复制区）同走本件，
- *      眉标给 `domain: 'query'`。
+ *      眉标由该域自报（`src/query/pageParts.ts` 的 `QUERY_EYEBROW`）。
  *  本票实测：本包 `src/` 下真引用本件的就是上面两个域，再无第三处。
  *
  * 分工（三件不要混）：
  *   - `./docPage.ts`＝文档装配那一层（`fillTemplate` 包裹、样式资产注入），本件往下调它，不重写；
- *   - 本件＝页面模板与页头的取值口径（**眉标两域各一句**、标题三件套只出一处；`data-page` 是选页那一枚标记）；
- *   - 页内块序列（表单／摘要行／复制区…）归各域自己，本件不管；类型徽章另立 `./typeBadge.ts`。
+ *   - 本件＝页面模板与页头的取值口径（**眉标由调用方的域自报**、标题三件套只出一处；`data-page` 是选页那一枚标记）；
+ *   - 页内块序列（表单／摘要行／复制区…）归各域自己，本件不管；类型徽章另立 `../write/typeBadge.ts`。
  *
  * 口径出处：`docs/skills/skill-bill/t407-页面块清单-16词.md` 第一节第 1 行。
  * 1.1 节硬口径照旧：`blocksCss()` 拼进 `TemplateAssets.sharedCssText` 再交 `fillTemplate`（住 `./docPage.ts`），
@@ -17,11 +17,6 @@
  */
 import { assembleDocPage } from './docPage.js';
 import { writeSection } from './writeParts.js';
-/** 眉标（正文标题上方那一行）：每域一句，**取值只在本件**，别处不得再写这些字面量。 */
-const PAGE_EYEBROW = {
-    write: '记账 · 写入域',
-    query: '记账 · 查询域',
-};
 /** 页面模板与页头：`<section>` 段 ＋ 标题三件套 ＋ 整页装配。一页只调一次。 */
 export function pageShell(input) {
     const body = writeSection({
@@ -34,7 +29,7 @@ export function pageShell(input) {
     return assembleDocPage({
         docTitle: input.docTitle,
         title: input.title,
-        eyebrow: PAGE_EYEBROW[input.domain ?? 'write'],
+        eyebrow: input.eyebrow,
         subtitle: input.subtitle,
         content: body,
     });

package/dist/shared/pageShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"pageShell.js","sourceRoot":"","sources":["../../src/shared/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,iDAAiD;AACjD,MAAM,YAAY,GAAgD;IAChE,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,UAAU;CAClB,CAAC;AAwBF,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC;QAC9C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"pageShell.js","sourceRoot":"","sources":["../../src/shared/pageShell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAwB/C,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,IAAI,GAAG,YAAY,CAAC;QACxB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC;IACH,OAAO,eAAe,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/shared/params.d.ts

@@ -0,0 +1,11 @@
+/** 写命令的操作名（`bill.record.add` 的 add／`bill.record.update` 的三支）。 */
+export type RecordOp = 'add' | 'update' | 'undo' | 'restore';
+/** `id` 槽位守卫：须给正整数（改记录／撤销／恢复／查详情同一句口径，别处不再写第二份）。 */
+export declare function needId(params: Record<string, unknown>): number;
+/** 一个值算不算「给了」：`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;
+//# sourceMappingURL=params.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../src/shared/params.ts"],"names":[],"mappings":"AAoBA,iEAAiE;AACjE,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7D,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAM9D;AAaD,oDAAoD;AACpD,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAG3C;AAED,uCAAuC;AACvC,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAGzC;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAMlD"}

package/dist/shared/params.js

@@ -0,0 +1,60 @@
+/** 共用位·跨域参数槽位口径（#689 结构搬迁第三批新建）：从 `src/policy/record.ts` 里被**两个域**同时取用的那两件来——
+ *   ① `RecordOp`——写命令 `op` 的取值集（`parseRecordOp` 认的就是它）；形状事实的取值面同时被
+ *      `src/shared/writeParts.ts` 的 `BillReceipt.op` 与 `src/shared/commandSpec.ts` 的写出口取；
+ *   ② `needId`——`id` 槽位的正整数守卫（改记录／撤销／恢复与查账单详情四处同一句校验）。
+ *
+ *  为什么新建这一件、而不是留在某一域里（#689 按「谁在用」判，逐条记在这里）：
+ *   · `needId` 的消费者是**两个域**——写域 `src/write/record.ts`（`validateUpdateInput`）与
+ *     查询域 `src/query/read.ts`（查账单详情）⇒ 归属律 2「说得出两个域在用 ⇒ 共用位」。
+ *     塞进任一域都会让另一个域伸手进对方内部件（或经对方门反向依赖），故上浮共用位。
+ *   · `RecordOp` 的消费者是写域 ＋ **两个共用件**（`writeParts.ts`／`commandSpec.ts`）。
+ *     它若留在 `src/write/record.ts`，共用件就得 import 域目录 —— 撞守卫③a
+ *     （共用位不 import 任何域目录）。故与 `needId` 同住本件；`src/write/record.ts` 转出它，
+ *     写域内部的消费方（`write.ts`）照旧只认自己域那一件。
+ *
+ *  谁在用（指名）：`src/write/record.ts`（两件都取，并转出 `RecordOp`）·
+ *    `src/write/write.ts`（经 `./record.js` 取 `RecordOp`）· `src/query/read.ts`（`needId`）·
+ *    `src/shared/writeParts.ts` 与 `src/shared/commandSpec.ts`（`RecordOp` 作字段类型）。
+ *  形状照兄弟件 `packages/skill-calorie/src/shared/params.ts`：跨域参数口径住共用位，域内不各写一份。 */
+import { BillPolicyError } from '../fetch/errors.js';
+/** `id` 槽位守卫：须给正整数（改记录／撤销／恢复／查详情同一句口径，别处不再写第二份）。 */
+export function needId(params) {
+    const id = params.id;
+    if (!Number.isInteger(id) || id <= 0) {
+        throw new BillPolicyError('POLICY_BAD_INPUT', '须给正整数 id');
+    }
+    return id;
+}
+/* ── 值的三种读法（#731 上浮共用位）────────────────────────────────────────────────────────
+ *
+ * 三件从 `src/account/params.ts` **原样上移**（行为一字不改）：账户域第一处写、开始使用域（#731）
+ * 第二处要用，按「共用件是从第二个用法里长出来的」上浮；`src/account/params.ts` 改为转出这三件，
+ * 域内调用点写法不变。
+ *
+ * **本件不是「全仓唯一一份值读法」**：写入域若干件各有一份**私有**同名函数（`collect.ts`／`diffTable.ts`／
+ * `template-*.ts`／`recentPicks.ts`，其中 `recentPicks.ts` 那份的 `NaN` 归「`NaN` 字面」、
+ * 与下面这份「`NaN` 归空」不同义）——那是搬迁前的既有债务，不属本票写集，就地摆正留给写入域自己的票。
+ */
+/** 一个值算不算「给了」：`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;
+}
+//# sourceMappingURL=params.js.map

package/dist/shared/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/shared/params.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;+EAiB+E;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAKrD,oDAAoD;AACpD,MAAM,UAAU,MAAM,CAAC,MAA+B;IACpD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;IACrB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAK,EAAa,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,EAAY,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AAEH,oDAAoD;AACpD,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACrD,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,MAAM,CAAC,CAAU;IAC/B,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC"}

package/dist/shared/sourceLine.d.ts

@@ -0,0 +1,19 @@
+/** 来源脚注的三个事实（全部由调用方算好；空串来源＝不写来源那一段）。 */
+export interface SourceLineFacts {
+    /** 人话来源（如「记账库（只读）」）；空串＝这一页不报来源，只印窗口与条数。 */
+    readonly source: string;
+    /** 窗口起点（日期或「不限」）。 */
+    readonly start: string;
+    /** 窗口终点（日期或「不限」）。 */
+    readonly end: string;
+    /** 本窗条数（非负整数）。 */
+    readonly count: number;
+}
+/** 来源脚注：`数据来源 <来源> ｜ <窗口> ｜ 共 N 条`（分隔由版式出，字符不进可见文本）。
+ *
+ *  t728 改法：改前是先 `join(' · ')` 拼成一整串再交给口径行，于是公共层的拆段器认不出它
+ *  （它只认并列分隔符）⇒ 那 32 行 `·` 串原样上屏，正是用户点名的那类「用符号简化 UI」。
+ *  现在改成：本件只说「这是三段并列」，`｜` 交给 `renderCaliberLine` 拆成逐段 `<span>`，
+ *  段间那条细竖线由公共层 CSS 出（与全仓口径行同一条机制、同一处定义）。 */
+export declare function sourceLine(facts: SourceLineFacts): string;
+//# sourceMappingURL=sourceLine.d.ts.map

package/dist/shared/sourceLine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.d.ts","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAoBA,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kBAAkB;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAkBD;;;;;4CAK4C;AAC5C,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAOzD"}

package/dist/shared/sourceLine.js

@@ -0,0 +1,52 @@
+/** 来源脚注（技能层共用件）：结果型每张页**恒出**的一句
+ *  「数据来源 · <来源> · 起 → 止 · 共 N 条」。
+ *
+ * 出处：`docs/skills/skill-bill/688-融合基准.md` §四 裁定 2（结果型页恒出三条之一：
+ *  页内导航 ＋ 口径说明行 ＋ 来源脚注）与 §八 A5（**新建共用位件**，落第一张用它的页面票；
+ *  形状照卡路里 `packages/skill-calorie/src/shared/sourceLine.ts:24`）。本件即 §八 A5 那一行。
+ *
+ * 老侧反面**不照抄**（裁定 1）：老页脚把源脚本路径印成字面（`query_view.html:217` 恒印
+ *  `scripts/record_bill.py {type} --json`，`分析/analysis_view.html:254` 恒印 `scripts/analysis/cli.py`），
+ *  既与实际分域路由对不上（缺陷 D6／D16），对用户也无意义——所以来源那一段写**人话**，
+ *  由调用方给（本件不认库名、不认命令名，不把内部标识符带上屏）。
+ *
+ * 版面：走公共层 #420 的口径说明行 `renderCaliberLine`（`ilife-block-caliber`，12px `--fg2`）；
+ *  本件不写色、不写字号、不写断点——版面单源住 `packages/base-render/`（裁定 7）。
+ *
+ * 分工：本件是**纯排版**，不做校验、不查库、不算窗口。三分不符即算不清：条数由取数处给、
+ *  窗口由参数解析处给、来源那句话由调用方按域给（照本包 `shared/` 既有件的分工：装配件不校验）。
+ */
+import { renderCaliberLine } from 'base-paint/blocks';
+/** 并列段之间那条分隔：**公共层的并列分隔符**（`base-paint` 的 `renderCaliberLine` 认的就是它）。
+ *  本件给的是「这句脚注有几段并列」，怎么把并列画出来由公共层定——页侧一个分隔符字符都不写。 */
+const SEG = '｜';
+/** 窗口那一格：起止同值时只说一次（本域回执记的是**一笔**，不是一段）。
+ *  「不限」那两端（没给窗口）改说人话，不再印 `— → —`（改前空窗口页逐页印这串）。 */
+function windowText(start, end) {
+    const s = start.trim();
+    const e = end.trim();
+    const blank = (v) => v === '' || v === '—' || v === '-';
+    if (blank(s) && blank(e))
+        return '时间不限';
+    if (blank(e))
+        return '从 ' + s + ' 起';
+    if (blank(s))
+        return '到 ' + e + ' 止';
+    return s === e ? '时间 ' + s : '时间 ' + s + ' 到 ' + e;
+}
+/** 来源脚注：`数据来源 <来源> ｜ <窗口> ｜ 共 N 条`（分隔由版式出，字符不进可见文本）。
+ *
+ *  t728 改法：改前是先 `join(' · ')` 拼成一整串再交给口径行，于是公共层的拆段器认不出它
+ *  （它只认并列分隔符）⇒ 那 32 行 `·` 串原样上屏，正是用户点名的那类「用符号简化 UI」。
+ *  现在改成：本件只说「这是三段并列」，`｜` 交给 `renderCaliberLine` 拆成逐段 `<span>`，
+ *  段间那条细竖线由公共层 CSS 出（与全仓口径行同一条机制、同一处定义）。 */
+export function sourceLine(facts) {
+    const parts = [];
+    const source = facts.source.trim();
+    if (source !== '')
+        parts.push('数据来源 ' + source);
+    parts.push(windowText(facts.start, facts.end));
+    parts.push('共 ' + String(facts.count) + ' 条');
+    return renderCaliberLine(parts.join(SEG));
+}
+//# sourceMappingURL=sourceLine.js.map

package/dist/shared/sourceLine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceLine.js","sourceRoot":"","sources":["../../src/shared/sourceLine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AActD;oDACoD;AACpD,MAAM,GAAG,GAAG,GAAG,CAAC;AAEhB;kDACkD;AAClD,SAAS,UAAU,CAAC,KAAa,EAAE,GAAW;IAC5C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACvB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACrB,MAAM,KAAK,GAAG,CAAC,CAAS,EAAW,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC;IACzE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;;;4CAK4C;AAC5C,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,MAAM,KAAK,EAAE;QAAE,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/shared/writeParts.d.ts

@@ -1,9 +1,11 @@
 /** 写命令回执的共用件（**唯一定义地**）：回执事实的形状（`BillReceipt`）＋ 影响行数口径（`totalChanges`）
  *  ＋ 页面的 `<section>` 段（`writeSection`）＋ 命令原文（`commandLine`）。**对外五件**；三字符转义（`esc`）只在本件内部
  *  给 `writeSection` 用，不转出去（铁律五：接口小、里面厚）。
+ *  回执事实里 `op` 的取值集 `RecordOp` 住共用位 `./params.js`（#689 起：它与 `id` 槽位守卫同住一件，
+ *  两边都是跨域参数口径）——本件只把它取来当 `BillReceipt.op` 的类型，不另立一份取值面。
  *
  * 谁在用（两个能力，指名）：
- *   ① `src/record/`——写入域：两条写命令的处理体（影响行数取前后差、回执事实在这里装配、命令原文在这里拼），
+ *   ① `src/write/`——写入域：两条写命令的处理体（影响行数取前后差、回执事实在这里装配、命令原文在这里拼），
  *      过程型采集页与结果型回执整页的 `<section>` 段；
  *   ② `src/query/`——查询域：四条读命令的处理体用 `commandLine` 拼复制载荷与日志的命令原文，
  *      通用查询列表页的 `<section>` 段同走 `writeSection`（槽位 `list`）。
@@ -16,11 +18,11 @@
  *   - 回执 `<section>` 的槽位取值照卡路里同件的 `ilife:<技能>:<槽位>` 形状。
  *
  * 转义口径（**不得与公共层 `escapeHtml` 互换**）：本件 `esc` 只转 `&`／`<`／`>` 三字符；
- *   公共层 `escapeHtml`（`base-paint`）与 `src/render/html.ts:7` 的那份都转五字符（多 `"`／`'`）。
+ *   公共层那一份（`base-paint` 的 `escapeHtml`，`src/render/html.ts` 也改引它）转五字符（多 `"`／`'`）。
  *   两者混用会静默改产物（`docs/skills/skill-bill/t406-共用件依赖与提升改造清单.md` 第二节 `esc` 行）。
  */
 import type { DatabaseSync } from 'node:sqlite';
-import type { RecordOp } from '../policy/record.js';
+import type { RecordOp } from './params.js';
 /** 一次写库的事实（回执页与复制日志都读它）。
  *  形状照卡路里同件的收据对象，只留饼干用得上的：操作／记录号／摘要／影响行数／写入字段／有无改动／来源／时刻。
  *  `noChange` 承接「值与改前一致」那一格，一页只出现这一处。 */

package/dist/shared/writeParts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeParts.d.ts","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;yCAEyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mCAAmC;AACnC,eAAO,MAAM,cAAc,2CAAa,CAAC;AAOzC,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAGrD;AAED;+DAC+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhF;AAUD;;;;;;;;gFAQgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAIT"}
+{"version":3,"file":"writeParts.d.ts","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5C;;yCAEyC;AACzC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,mCAAmC;AACnC,eAAO,MAAM,cAAc,2CAAa,CAAC;AAOzC,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,CAGrD;AAED;+DAC+D;AAC/D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAEhF;AAUD;;;;;;;;gFAQgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,CAIT"}

package/dist/shared/writeParts.js.map

@@ -1 +1 @@
-{"version":3,"file":"writeParts.js","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,mFAAmF;AACnF,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAAgC,CAAC;IAC1F,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAA+B;IACtE,OAAO,gBAAgB,GAAG,GAAG,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;gEACgE;AAChE,MAAM,aAAa,GAA6D;IAC9E,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;;;;gFAQgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAM5B;IACC,OAAO,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,GAAG,SAAS,GAAG,0BAA0B,GAAG,KAAK,CAAC,IAAI;UAC1H,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI;UACvH,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC;AACnC,CAAC"}
+{"version":3,"file":"writeParts.js","sourceRoot":"","sources":["../../src/shared/writeParts.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkB1D,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AAEzC,mFAAmF;AACnF,SAAS,GAAG,CAAC,CAAU;IACrB,OAAO,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC5F,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,GAAG,EAAgC,CAAC;IAC1F,OAAO,GAAG,IAAI,OAAO,GAAG,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;+DAC+D;AAC/D,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAA+B;IACtE,OAAO,gBAAgB,GAAG,GAAG,GAAG,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC;AAC/E,CAAC;AAED;gEACgE;AAChE,MAAM,aAAa,GAA6D;IAC9E,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF;;;;;;;;gFAQgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAM5B;IACC,OAAO,kBAAkB,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,gBAAgB,GAAG,SAAS,GAAG,0BAA0B,GAAG,KAAK,CAAC,IAAI;UAC1H,eAAe,GAAG,KAAK,CAAC,IAAI,GAAG,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI;UACvH,KAAK,CAAC,OAAO,GAAG,YAAY,CAAC;AACnC,CAAC"}

package/dist/triggers/routeSpec.d.ts

@@ -0,0 +1,109 @@
+/** #721 · 路由与声明的**形状**（类型唯一处）。
+ *
+ * 本件只放类型与形状，**不含任何记录数据、不含任何逻辑**：
+ *   - 三个路由类型（`BillKey` 键联合／`WakeEntry` 路由项／`WakeRoute` 路由结果）——今天的行为逐字不变；
+ *   - 四份**声明形状**（`DomainDeclaration` / `WakeEntryDecl` / `WakeSubgroupDecl` / `WakeSceneDecl`）——
+ *     各域 `declaration.ts` 写出的形状，比运行时记录多一个「场景归谁所有」的位置；
+ *   - 三个**投影形状**（`WakeSceneAsset` / `WakeSubgroupAsset` / `WakeGroupAsset`）——HELP 目录那一面
+ *     （`src/triggers/wake-assets.ts` 转出，路径与导出面照旧）。
+ *
+ * 顺序权威：词的顺序＝**域声明里 `entries` 的书写顺序**（词表由各声明按 `order` 拼接得出，
+ * 不打乱、不重排）；域的顺序＝`DomainDeclaration.order`（缺号／重号 fail-closed）。
+ * 谁在写声明：`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`（无场景的那一份）。
+ *
+ * 口径出处：形状照兄弟件 `packages/skill-calorie/src/triggers/routeSpec.ts`（照结构，不照文件）——
+ * 「类型唯一处、声明件只写记录」是同一条分工；住处由 [规格] 目标 src/ 形状（#720）归入
+ * 「外壳与机器面」里的触发与路由机器面。
+ */
+/** 记账的 16 个命令名（跨技能契约，冻结不动；`bill.record.*` 六条属写入域与查询域两域共用同一前缀）。 */
+export type BillKey = 'bill.record.add' | 'bill.record.update' | 'bill.record.today' | 'bill.record.range' | 'bill.record.search' | 'bill.record.detail' | 'bill.analysis.overview' | 'bill.analysis.compare' | 'bill.analysis.trend' | 'bill.goal.write' | 'bill.goal.query' | 'bill.account.write' | 'bill.account.query' | 'bill.link.submit' | 'bill.setup.run' | 'bill.help.lookup';
+/** 路由结果：命中哪条命令 ＋ 随命令带下去的槽位。 */
+export interface WakeRoute {
+    readonly key: BillKey;
+    readonly params: Record<string, unknown>;
+}
+/** 路由项（＝域声明里去掉场景的那半）；`needs`＝必需槽位（给不出就在路由层报错）；
+ *  `carries`＝**不拦**、上下文里给了就带下去的槽位（改记录／撤销／恢复三条词的 `id` 住这里）。
+ *  分两格的理由见本件的 `WakeEntry`（逐字保留自旧的 `src/policy/wakewords.ts`——那件已随 #689 第三批删掉）。 */
+export interface WakeEntry {
+    readonly phrase: string;
+    readonly key: BillKey;
+    readonly preset?: Readonly<Record<string, unknown>>;
+    readonly needs?: readonly string[];
+    readonly carries?: readonly string[];
+}
+/** 徽章类型词（老实物用到的全集；共享 help 模板 `TYPE_DEFAULT` 认得这些词，缺席即配色表要改）。 */
+export type WakeSceneType = '采集' | '查看' | '选择' | '向导' | '回执';
+/** 一条场景（老 HELP 卡的内容面）。**不写 `wake_word`**——那是拥有它的词条的**投影**。 */
+export interface WakeSceneDecl {
+    readonly id: string;
+    readonly title: string;
+    /** 老实物 71/71 为空串（可用）；`【待开发】` 为本仓预留态。 */
+    readonly status: string;
+    /** 「复制指令」按钮按出来的正文，逐字保留。 */
+    readonly prompt_template: string;
+    readonly types: readonly WakeSceneType[];
+}
+/** 一条词条：这个词怎么说、路由到哪条命令、说完看到哪几张卡（`scenes` ×0..n）。 */
+export interface WakeEntryDecl {
+    readonly phrase: string;
+    readonly key: BillKey;
+    readonly preset?: Readonly<Record<string, unknown>>;
+    readonly needs?: readonly string[];
+    readonly carries?: readonly string[];
+    readonly scenes: readonly WakeSceneDecl[];
+}
+/** 一个二级组：名字 ＋ 它按序排的场景 id（场景本身住词条名下，不在这里再抄一遍）。 */
+export interface WakeSubgroupDecl {
+    readonly id: string;
+    readonly label: string;
+    readonly scenes: readonly string[];
+}
+/** 一份**域声明**（手写、唯一事实源）。
+ *
+ * 机械不变式（合并件与判据都按这几条判）：
+ *   - `order` 在 8 份声明里唯一且连续，从 0 起（0＝HELP 自身位，排在所有域之前，保住今天的词序）；
+ *   - 有场景的声明（`subgroups` 非空）必须有 `label` 与 `icon`；无场景的那一份（HELP 位）两者都不给；
+ *   - 一个场景 id 只准被一条词条拥有一次；二级组点名的场景必须在本域内（否则合并期即抛）。 */
+export interface DomainDeclaration {
+    readonly id: string;
+    readonly label?: string;
+    readonly icon?: string;
+    readonly order: number;
+    readonly entries: readonly WakeEntryDecl[];
+    readonly subgroups: readonly WakeSubgroupDecl[];
+}
+/** 投影面：一条场景卡（HELP 页读的那一层；`wake_word` 由拥有它的词条算出）。 */
+export interface WakeSceneAsset {
+    readonly id: string;
+    readonly title: string;
+    readonly wake_word: string;
+    readonly status: string;
+    readonly prompt_template: string;
+    readonly types: readonly WakeSceneType[];
+}
+/** 投影面：一个二级组（`scenes` 已是场景卡）。 */
+export interface WakeSubgroupAsset {
+    readonly id: string;
+    readonly label: string;
+    readonly scenes: readonly WakeSceneAsset[];
+}
+/** 投影面：一个域（HELP 一级分组）。 */
+export interface WakeGroupAsset {
+    readonly id: string;
+    readonly icon: string;
+    readonly label: string;
+    readonly subgroups: readonly WakeSubgroupAsset[];
+}
+/** 投影的线索（调用方知道自己手里的哪几件事，就给哪几件）。 */
+export interface WakeScope {
+    /** 命令名（缺省＝在全部词条里找）。 */
+    readonly key?: BillKey;
+    /** 内部型名（`expense`／`lend`…）：按词条的 `preset.kind` 认。 */
+    readonly kind?: string;
+    /** 操作名（`undo`／`restore`…）：按词条的 `preset.op` 认。 */
+    readonly op?: string;
+    /** 命令的入参原样（页面标题那一支：按 preset 子集与 needs 命中）。 */
+    readonly preset?: Readonly<Record<string, unknown>>;
+}
+//# sourceMappingURL=routeSpec.d.ts.map

package/dist/triggers/routeSpec.d.ts.map

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

package/dist/triggers/routeSpec.js

@@ -0,0 +1,19 @@
+/** #721 · 路由与声明的**形状**（类型唯一处）。
+ *
+ * 本件只放类型与形状，**不含任何记录数据、不含任何逻辑**：
+ *   - 三个路由类型（`BillKey` 键联合／`WakeEntry` 路由项／`WakeRoute` 路由结果）——今天的行为逐字不变；
+ *   - 四份**声明形状**（`DomainDeclaration` / `WakeEntryDecl` / `WakeSubgroupDecl` / `WakeSceneDecl`）——
+ *     各域 `declaration.ts` 写出的形状，比运行时记录多一个「场景归谁所有」的位置；
+ *   - 三个**投影形状**（`WakeSceneAsset` / `WakeSubgroupAsset` / `WakeGroupAsset`）——HELP 目录那一面
+ *     （`src/triggers/wake-assets.ts` 转出，路径与导出面照旧）。
+ *
+ * 顺序权威：词的顺序＝**域声明里 `entries` 的书写顺序**（词表由各声明按 `order` 拼接得出，
+ * 不打乱、不重排）；域的顺序＝`DomainDeclaration.order`（缺号／重号 fail-closed）。
+ * 谁在写声明：`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`（无场景的那一份）。
+ *
+ * 口径出处：形状照兄弟件 `packages/skill-calorie/src/triggers/routeSpec.ts`（照结构，不照文件）——
+ * 「类型唯一处、声明件只写记录」是同一条分工；住处由 [规格] 目标 src/ 形状（#720）归入
+ * 「外壳与机器面」里的触发与路由机器面。
+ */
+export {};
+//# sourceMappingURL=routeSpec.js.map

package/dist/triggers/routeSpec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routeSpec.js","sourceRoot":"","sources":["../../src/triggers/routeSpec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG"}

package/dist/triggers/wake-assets.d.ts

@@ -1,27 +1,6 @@
-/** 徽章类型词（老实物用到的全集；共享 help 模板 `TYPE_DEFAULT` 认得这些词，缺席即配色表要改）。 */
-export type WakeSceneType = '采集' | '查看' | '选择' | '向导' | '回执';
-export interface WakeSceneAsset {
-    readonly id: string;
-    readonly title: string;
-    readonly wake_word: string;
-    /** 老实物 71/71 为空串（可用）；`【待开发】` 为本仓预留态。 */
-    readonly status: string;
-    /** 「复制指令」按钮按出来的正文，逐字保留。 */
-    readonly prompt_template: string;
-    readonly types: readonly WakeSceneType[];
-}
-export interface WakeSubgroupAsset {
-    readonly id: string;
-    readonly label: string;
-    readonly scenes: readonly WakeSceneAsset[];
-}
-export interface WakeGroupAsset {
-    readonly id: string;
-    readonly icon: string;
-    readonly label: string;
-    readonly subgroups: readonly WakeSubgroupAsset[];
-}
-/** 7 域／20 二级组／74 场景（老 71 逐字 ＋ 新增 3 条接在对应二级组末尾）。 */
+import type { WakeGroupAsset, WakeSceneAsset } from './routeSpec.js';
+export type { WakeSceneType, WakeSceneAsset, WakeSubgroupAsset, WakeGroupAsset } from './routeSpec.js';
+/** 7 域／20 二级组／74 场景（域序＝声明的 `order`，词序＝声明里的书写顺序）。 */
 export declare const WAKE_GROUPS: readonly WakeGroupAsset[];
 /** 扁平 74 条（顺序与 HELP 分组一致；单源派生，不重复落词）。 */
 export declare const WAKE_ASSETS: readonly WakeSceneAsset[];
@@ -31,7 +10,6 @@ export declare const SCENE_BY_ID: Readonly<Record<string, WakeSceneAsset>>;
 export declare const WAKE_ASSET_TOTAL: number;
 /** HELP 自身的唤醒词（老实物 `meta_blocks.help_wake_words` 那一块；4 条，不进场景目录）。
  *
- * 从口径层 `WAKE_TABLE` **派生**而非复写：口径层是唤醒词的单一事实源，本文件只投影。
- * （老实物写的是「饼干记账 帮助」（带空格），现表口径为「饼干记账帮助」——以现表为准。） */
+ * 从**无场景的那份声明**（HELP 位）读——防自指的规则只写一处：有场景的进目录，没场景的进这里。 */
 export declare const HELP_WAKE_WORDS: readonly string[];
 //# sourceMappingURL=wake-assets.d.ts.map

package/dist/triggers/wake-assets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wake-assets.d.ts","sourceRoot":"","sources":["../../src/triggers/wake-assets.ts"],"names":[],"mappings":"AA0BA,gEAAgE;AAChE,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAClD;AAED,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EA84BhD,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEhD,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEhE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAA2B,CAAC;AAE3D;;;kDAGkD;AAClD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAEtB,CAAC"}
+{"version":3,"file":"wake-assets.d.ts","sourceRoot":"","sources":["../../src/triggers/wake-assets.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAqB,cAAc,EAAE,cAAc,EAAqB,MAAM,gBAAgB,CAAC;AAE3G,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA6BvG,oDAAoD;AACpD,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEA,CAAC;AAElD,yCAAyC;AACzC,eAAO,MAAM,WAAW,EAAE,SAAS,cAAc,EAEhD,CAAC;AAEF,yBAAyB;AACzB,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAEhE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,gBAAgB,EAAE,MAA2B,CAAC;AAE3D;;yDAEyD;AACzD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAEI,CAAC"}