skill-bill 0.1.0 → 0.2.1

package/dist/help/helpFile.js

@@ -0,0 +1,119 @@
+/** #145 · 「饼干记账help」的交付**内容**：内容资产 ＋ 派生 → 共享 help 模板（`base-paint/help-shell`）全页 HTML。
+ *
+ * 本模块**零 IO、零落盘**：落点与写盘全在 CLI 交付管线（#144：`src/help/helpPaths.ts` ＋ `src/output.ts`）。
+ * 唯一一处会碰盘的是 `helpFileStem()`——它现读配置文件（#726 起文件名主体是可配项 `html.helpStem`）；
+ * 页面装配那条链（`buildHelpFileData`／`renderHelpFileHtml`）仍然全纯。
+ * 逐字对照老口径（只读基线 `D:\2Study\StudyNotes\SKILLS\饼干记账\scripts\render_help.py:build_help_contract`）：
+ *  - `skill_name`／`title`／`contact`／`version` 照老实样（`:197-214`）；
+ *  - `subtitle` 与 `meta_blocks[0]` 同源派生（老 `:194-202` 的 `summary_line` 一处算、两处用）；
+ *  - `groups` 由内容资产直转（`WAKE_GROUPS`，只读引用不 clone）；
+ *  - `init_banner` 文案照老 `INIT_BANNER_TEXT`（`:69-74`），`prompt` 取自 `setup_init_wizard`
+ *    场景的 `prompt_template`（老 `:124-132` 同一个「从汇总里取该场景 prompt」的单源做法）。
+ *
+ * 三块可选键（用户 Q9=B 完整照传；仓内共享 help 模板运行时全量读这些键，TS 类型面只声明 5 键）：
+ *  - `meta_blocks`：两块（`help_summary`／`help_wake_words`），内容全部派生，不写第二份源；
+ *  - `version`：`'2.0'`——老口径 `str(summary.get("version","2.0"))`，语义是**技能数据世代**
+ *    （bill 自己的 `init-status` 也自述「v2.0 特征 deleted_at」），**不是** npm 包版本 `0.1.0`；
+ *  - `init_banner`：显隐由 `hidden` 控。老口径是「未初始化才给这个键」，help模板读的却是 `hidden`
+ *    （`help-template.html` 的 `INIT_BANNER && !INIT_BANNER.hidden`），故新线**键常在、显隐走 `hidden`**：
+ *    payload 形状不随状态变，下游用例能断言同一个键集。初始化状态由调用方传入（本模块零 IO）。
+ */
+import { renderHelpShellHtml } from 'base-paint/help-shell';
+import { HELP_WAKE_WORDS, SCENE_BY_ID, WAKE_ASSETS, WAKE_GROUPS } from '../triggers/wake-assets.js';
+import { BILL_CONFIG_DEFAULTS, loadBillConfig } from '../config.js';
+import { BillRenderError } from '../render/errors.js';
+/** 「饼干记账help」交付文件的文件名主体：配置项 `html.helpStem` 的**具名引用**（默认 `饼干记账_HELP`）。
+ *  对外不接受调用方传入（照 #139 S3-3）——用户改的是配置文件，不是这条命令的参数。 */
+export const HELP_FILE_STEM = BILL_CONFIG_DEFAULTS.html.helpStem;
+/** HELP 文件名主体：配置 `html.helpStem` 非空即用它，空串＝`HELP_FILE_STEM`（#726 起取值走配置文件）。 */
+export function helpFileStem() {
+    const configured = loadBillConfig().values.html.helpStem;
+    return configured !== '' ? configured : HELP_FILE_STEM;
+}
+/** 5 键头（老实物逐字）。 */
+export const HELP_FILE_SKILL_NAME = '饼干记账';
+export const HELP_FILE_TITLE = '饼干记账 · 使用手册(HELP)';
+/** 技能数据世代版本（老口径 `summary.version`，非 npm 包版本）。 */
+export const HELP_FILE_VERSION = '2.0';
+/** 首次使用横幅的 prompt 取自该场景（老 `SETUP_INIT_SCENE_ID`）。 */
+export const HELP_INIT_SCENE_ID = 'setup_init_wizard';
+/** 联系作者三项（老 `render_help.py:59-63` 的 CONTACT ＋ `:206-213` 的 items 组法逐字）。 */
+export const HELP_CONTACT = Object.freeze({
+    items: Object.freeze([
+        Object.freeze({ label: '邮箱', value: '975559549@qq.com' }),
+        Object.freeze({ label: 'GitHub', value: 'https://github.com/FeatherHunter/SKILLS', url: true }),
+        Object.freeze({ label: 'Issues', value: 'https://github.com/FeatherHunter/SKILLS/issues', url: true }),
+    ]),
+    copy_all: true,
+});
+/** 老 `%Y-%m-%d %H:%M` 等价物（本地时区，零填充；非法 Date 即坏参，不返空串）。 */
+export function formatHelpMinute(now) {
+    if (!(now instanceof Date) || Number.isNaN(now.getTime())) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 更新时间须为有效 Date（缺失阻断不返空）。');
+    }
+    const p = (n) => String(n).padStart(2, '0');
+    return String(now.getFullYear()) + '-' + p(now.getMonth() + 1) + '-' + p(now.getDate())
+        + ' ' + p(now.getHours()) + ':' + p(now.getMinutes());
+}
+/** 老 `:194-195` 的 `summary_line`：计数与版本**派生**，不写死 7／74（改资产即跟变）。 */
+export function deriveSummaryLine(now = new Date()) {
+    return String(WAKE_GROUPS.length) + ' 功能域 · ' + String(WAKE_ASSETS.length)
+        + ' 场景 · 版本 ' + HELP_FILE_VERSION + ' · 更新于 ' + formatHelpMinute(now);
+}
+/** 两块 meta：HELP 汇总（＝summaryLine 同源）＋ HELP 唤醒词（＝口径层那 4 条派生）。 */
+export function buildMetaBlocks(summaryLine) {
+    return [
+        { id: 'help_summary', title: 'HELP 汇总', html: '<p>' + summaryLine + '</p>' },
+        { id: 'help_wake_words', title: 'HELP 唤醒词', html: '<p>' + HELP_WAKE_WORDS.join(' / ') + '</p>' },
+    ];
+}
+/** 首次使用横幅：文案照老实样，`prompt` 取自初始化场景的 `prompt_template`（单源）。
+ *  该场景缺位即抛（内容资产被机器生成 ＋ 摘要锁，缺位属真故障，不静默把横幅降级掉）。 */
+export function buildInitBanner(initialized) {
+    const scene = SCENE_BY_ID[HELP_INIT_SCENE_ID];
+    const prompt = scene?.prompt_template;
+    if (typeof prompt !== 'string' || prompt.length === 0) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 首次使用横幅缺 prompt：内容资产无场景 ' + HELP_INIT_SCENE_ID);
+    }
+    return {
+        title: '🚀 第一次用饼干记账?',
+        subtitle: '从「初始化」开始 — 自动检测环境、确认数据目录、建库、验证,全程零决策。完成初始化后,本区域将不再出现。',
+        button_text: '📋 复制初始化 prompt',
+        prompt,
+        closable: true,
+        hidden: initialized === true,
+    };
+}
+/** 内容资产 ＋ 派生 → 全量 HELP JSON（纯函数；`now` 显式传入以保证可复现）。 */
+export function buildHelpFileData(now = new Date(), opts = {}) {
+    if (WAKE_GROUPS.length === 0 || WAKE_ASSETS.length === 0) {
+        throw new BillRenderError('BILL_HELP_MISSING_DATA', 'HELP 内容资产为空（WAKE_GROUPS／WAKE_ASSETS）');
+    }
+    const summaryLine = deriveSummaryLine(now);
+    return {
+        skill_name: HELP_FILE_SKILL_NAME,
+        title: HELP_FILE_TITLE,
+        subtitle: summaryLine,
+        contact: HELP_CONTACT,
+        groups: WAKE_GROUPS,
+        meta_blocks: buildMetaBlocks(summaryLine),
+        version: HELP_FILE_VERSION,
+        init_banner: buildInitBanner(opts.initialized === true),
+    };
+}
+/** 全量 HELP JSON → 全help模板 HTML（模板唯一实现＝共享层 verbatim 老实物；空分组抛 `missing-data`，调用方 exit 5）。 */
+export function renderHelpFileHtml(data) {
+    return renderHelpShellHtml(data);
+}
+export function buildHelpIndex() {
+    let sceneTotal = 0;
+    let subgroupTotal = 0;
+    const items = WAKE_GROUPS.map((g) => {
+        const sceneCount = g.subgroups.reduce((n, s) => n + s.scenes.length, 0);
+        sceneTotal += sceneCount;
+        subgroupTotal += g.subgroups.length;
+        return { id: g.id, icon: g.icon, label: g.label, subgroupCount: g.subgroups.length, sceneCount };
+    });
+    return { items, total: items.length, sceneTotal, subgroupTotal };
+}
+//# sourceMappingURL=helpFile.js.map

package/dist/help/helpFile.js.map

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

package/dist/help/helpPaths.d.ts

@@ -0,0 +1,11 @@
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`）：配置项 `html.dir` 的具名引用。 */
+export declare const HELP_HTML_DIR_NAME: string;
+/** 「速查／现找」那一支的产物名主体：与 HELP 文件**分名**（照 #139 判法：别让用户按一个名字
+ *  打开到另一个东西）。老技能没有这一支，故无老名可循；取「饼干记账_速查表」与 HELP 并列。
+ *  ＝配置项 `html.quickRefStem` 的具名引用。 */
+export declare const LOOKUP_FILE_STEM: string;
+/** 产物目录名：配置 `html.dir` 非空即用它，空串＝`HELP_HTML_DIR_NAME`。 */
+export declare function htmlDirName(): string;
+/** 速查表文件名主体：配置 `html.quickRefStem` 非空即用它，空串＝`LOOKUP_FILE_STEM`。 */
+export declare function lookupFileStem(): string;
+//# sourceMappingURL=helpPaths.d.ts.map

package/dist/help/helpPaths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.d.ts","sourceRoot":"","sources":["../../src/help/helpPaths.ts"],"names":[],"mappings":"AAoBA,uEAAuE;AACvE,eAAO,MAAM,kBAAkB,QAAgC,CAAC;AAEhE;;sCAEsC;AACtC,eAAO,MAAM,gBAAgB,QAAyC,CAAC;AAEvE,yDAAyD;AACzD,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED,mEAAmE;AACnE,wBAAgB,cAAc,IAAI,MAAM,CAGvC"}

package/dist/help/helpPaths.js

@@ -0,0 +1,36 @@
+/** #144 · 「饼干记账help」的**落点值**（目录名与两个文件名主体）。
+ *
+ * #237 改判（**就地改正上一轮 #147 的结论**）：#147 曾记「走 **(b) bill 自持一份最小管线**，不上移
+ * `base-paint`（那是被 #96 主动冻结的渲染包，落盘是 IO、主题错位）」——该结论**已被维护者 2026-09-12
+ * 裁决 8 推翻**，原话「不应该是一个独立的 base 包，放在 `base-paint` 吧，**是绘制出 html 后的相关操作**」
+ * （地图 #208 的 Q7 同轮裁「乙」＝把命名与落盘收成共用位）。故时间戳格式 `YYYYMMDD_HHMMSS`（本地时间）与
+ * 通式 `〈文件名主体〉_<stamp>[_N].html` **不再住这里**：唯一定义地是共用件 `base-paint/save-html` 的
+ * `saveHtmlFile`（`packages/base-render/src/output/saveHtml.ts`），本模块只剩「本技能自己的值」。
+ *
+ * #726 起这三处取值也改读配置文件（`html.dir`／`html.quickRefStem`），与 `src/fetch/paths.ts` 同形：
+ *   - **常量＝默认值表那一项的具名引用**（不是第二份定义地，改默认值表即跟变）；
+ *   - **函数＝「配置非空即用它、空串＝默认」**那条通则（空串不是「没配」，是「按老落点」，老产物不会看起来丢了）。
+ * 落点算式与 `src/health.ts:418` 的体检报告同源：**产物目录 = `join(库目录, htmlDirName())`**。
+ *
+ * 老命名规则复刻（只读基线 `SKILLS\饼干记账\scripts\html_paths.py` ＋ 实物目录
+ * `D:\2Study\StudyNotes\.db\biscuit_accountant_html\` 的四个 HELP 文件）：产物目录
+ * `<库目录>/biscuit_accountant_html/`，文件名主体 `饼干记账_HELP`（老 `COMMAND_NAMES["help"]`）。
+ */
+import { BILL_CONFIG_DEFAULTS, loadBillConfig } from '../config.js';
+/** HELP 产物子目录名（老 `SKILL_HTML_NAME + "_html"`）：配置项 `html.dir` 的具名引用。 */
+export const HELP_HTML_DIR_NAME = BILL_CONFIG_DEFAULTS.html.dir;
+/** 「速查／现找」那一支的产物名主体：与 HELP 文件**分名**（照 #139 判法：别让用户按一个名字
+ *  打开到另一个东西）。老技能没有这一支，故无老名可循；取「饼干记账_速查表」与 HELP 并列。
+ *  ＝配置项 `html.quickRefStem` 的具名引用。 */
+export const LOOKUP_FILE_STEM = BILL_CONFIG_DEFAULTS.html.quickRefStem;
+/** 产物目录名：配置 `html.dir` 非空即用它，空串＝`HELP_HTML_DIR_NAME`。 */
+export function htmlDirName() {
+    const configured = loadBillConfig().values.html.dir;
+    return configured !== '' ? configured : HELP_HTML_DIR_NAME;
+}
+/** 速查表文件名主体：配置 `html.quickRefStem` 非空即用它，空串＝`LOOKUP_FILE_STEM`。 */
+export function lookupFileStem() {
+    const configured = loadBillConfig().values.html.quickRefStem;
+    return configured !== '' ? configured : LOOKUP_FILE_STEM;
+}
+//# sourceMappingURL=helpPaths.js.map

package/dist/help/helpPaths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpPaths.js","sourceRoot":"","sources":["../../src/help/helpPaths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpE,uEAAuE;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC;AAEhE;;sCAEsC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC,IAAI,CAAC,YAAY,CAAC;AAEvE,yDAAyD;AACzD,MAAM,UAAU,WAAW;IACzB,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;IACpD,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC;AAC7D,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc;IAC5B,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC;IAC7D,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC;AAC3D,CAAC"}

package/dist/help/index.d.ts

@@ -1,2 +1,4 @@
 export { buildHelpLookup, lookupWake, type HelpHit } from './lookup.js';
+export { buildHelpItems, type HelpItem } from './items.js';
+export { WRITE_WORDS, buildWriteWire } from '../write/writeWire.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/help/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/help/index.js

@@ -1,2 +1,4 @@
 export { buildHelpLookup, lookupWake } from './lookup.js';
+export { buildHelpItems } from './items.js';
+export { WRITE_WORDS, buildWriteWire } from '../write/writeWire.js';
 //# sourceMappingURL=index.js.map

package/dist/help/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/help/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,UAAU,EAAgB,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAiB,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/help/items.d.ts

@@ -0,0 +1,17 @@
+/** HELP 交付面·现找条目（#689 结构搬迁第三批：从 `src/render/views.ts` 拆来）。
+ *  一件事实：`bill.help.lookup` 的 list 载荷 `{ items, total }`——短语→key／shape／cli／一句话的快照
+ *  由 `./lookup.js` 构建期注入 SKILL.md，本件只做运行时的按需过滤（`q` 空即全量）。
+ *
+ *  谁在用（指名）：`src/cli/cmd_read.ts` 的 `dispatchHelp`（HELP 交付，经 `./index.js` 门取）。 */
+export interface HelpItem {
+    phrase: string;
+    key: string;
+    shape: string;
+    cli: string;
+    desc: string;
+}
+export declare function buildHelpItems(all: HelpItem[], q?: string): {
+    items: HelpItem[];
+    total: number;
+};
+//# sourceMappingURL=items.d.ts.map

package/dist/help/items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.d.ts","sourceRoot":"","sources":["../../src/help/items.ts"],"names":[],"mappings":"AAAA;;;;iFAIiF;AACjF,MAAM,WAAW,QAAQ;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAEpG,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAGhG"}

package/dist/help/items.js

@@ -0,0 +1,5 @@
+export function buildHelpItems(all, q) {
+    const items = !q || !q.trim() ? all : all.filter((h) => q.includes(h.phrase) || h.phrase.includes(q.trim()));
+    return { items, total: items.length };
+}
+//# sourceMappingURL=items.js.map

package/dist/help/items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"items.js","sourceRoot":"","sources":["../../src/help/items.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,cAAc,CAAC,GAAe,EAAE,CAAU;IACxD,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAE,CAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrI,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/help/lookup.d.ts

@@ -1,4 +1,4 @@
-import { type BillKey } from '../policy/index.js';
+import type { BillKey } from '../triggers/routeSpec.js';
 export interface HelpHit {
     phrase: string;
     key: BillKey;

package/dist/help/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/help/lookup.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAG9D,MAAM,WAAW,OAAO;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAqCpG,wBAAgB,eAAe,IAAI,OAAO,EAAE,CAQ3C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAEnE"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../../src/help/lookup.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAGxD,MAAM,WAAW,OAAO;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;CAAE;AAsCpG,wBAAgB,eAAe,IAAI,OAAO,EAAE,CAQ3C;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAEnE"}

package/dist/help/lookup.js

@@ -1,9 +1,9 @@
-// HELP 速查：WAKE_TABLE 唯一上游；短语→key/cli/一句话。构建期注入 SKILL.md（scripts/build-help.mjs）。
-import { WAKE_TABLE } from '../policy/index.js';
+// HELP 速查：WAKE_TABLE 唯一上游（`src/triggers/wakeTable.ts`）；短语→key/cli/一句话。构建期注入 SKILL.md（scripts/build-help.mjs）。
+import { WAKE_TABLE } from '../triggers/wakeTable.js';
 import { BILL_KEY_SHAPES } from '../render/index.js';
 function exampleParams(key, e) {
     const p = { ...(e.preset || {}) };
-    // B2：record.add 示例须可直跑——补最小槽位 category/amount/note（kind preset 仅路由提示，校验忽略未知键）。
+    // B2：record.add 示例须可直跑——补最小槽位 category/amount/note（kind preset 仅路由提示，校验忽略未认的名字）。
     if (key === 'bill.record.add') {
         if (p.category === undefined)
             p.category = '餐饮';
@@ -12,7 +12,8 @@ function exampleParams(key, e) {
         if (p.note === undefined)
             p.note = '午饭';
     }
-    for (const n of e.needs || []) {
+    // `carries` 与 `needs` 一样进示例：改记录／撤销／恢复的 `id` 不拦，但示例里要给出「这一格填哪」那一眼。
+    for (const n of [...(e.needs || []), ...(e.carries || [])]) {
         if (p[n] === undefined)
             p[n] = n === 'id' ? 1 : n === 'date' ? '2026-09-06' : n === 'start' || n === 'end' ? '2026-09-01' : n === 'month' ? '2026-09' : n === 'amount' ? 35 : n === 'q' ? '午饭' : n === 'tag' ? '旅行' : n === 'category' ? '餐饮' : n === 'account' ? '支付宝' : n === 'ledger' ? '生活' : n === 'name' ? '招行卡' : n === 'from' ? '支付宝' : n === 'to' ? '招行卡' : n === 'file' ? 'bills.csv' : '<值>';
     }

package/dist/help/lookup.js.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/help/lookup.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"lookup.js","sourceRoot":"","sources":["../../src/help/lookup.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAIrD,SAAS,aAAa,CAAC,GAAY,EAAE,CAAoI;IACvK,MAAM,CAAC,GAA4B,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,CAAC;IAC3D,iFAAiF;IACjF,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;YAAE,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC;QAChD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS;YAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;YAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;IAC1C,CAAC;IACD,kEAAkE;IAClE,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;IAC1Y,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,KAAK,GAA2B;IACpC,iBAAiB,EAAE,0DAA0D;IAC7E,oBAAoB,EAAE,mBAAmB;IACzC,mBAAmB,EAAE,kBAAkB;IACvC,mBAAmB,EAAE,kBAAkB;IACvC,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,aAAa;IACnC,wBAAwB,EAAE,6BAA6B;IACvD,uBAAuB,EAAE,iBAAiB;IAC1C,qBAAqB,EAAE,mCAAmC;IAC1D,iBAAiB,EAAE,sBAAsB;IACzC,iBAAiB,EAAE,YAAY;IAC/B,oBAAoB,EAAE,mBAAmB;IACzC,oBAAoB,EAAE,aAAa;IACnC,kBAAkB,EAAE,iCAAiC;IACrD,gBAAgB,EAAE,8BAA8B;IAChD,kBAAkB,EAAE,cAAc;CACnC,CAAC;AAEF,sCAAsC;AACtC,MAAM,UAAU,eAAe;IAC7B,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI;QACrC,GAAG,EAAE,gBAAgB,GAAG,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACvD,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE;KACzB,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAe,EAAE,IAAY;IACtD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export * from './fetch/index.js';
-export * from './policy/index.js';
 export * from './render/index.js';
 export * from './help/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,5 +1,9 @@
+// 记账技能（bill）对外的包门。**只许收窄**（#683 §六 守卫⑤：导出名集只许变短）。
+// #689 结构搬迁第三批：原第二行 `export * from './policy/index.js'` 随 `src/policy/` 的拆散与删除**整条拿掉**——
+// 那 7 件的名字按归属律散回各自的家（`shared/category.ts`／`shared/dateRange.ts`／`shared/params.ts`／
+// `shared/kpi.ts`／`write/`／`analysis/`／`goal/`／`account/`／`help/`／`triggers/`），包门**不**把它们照抄出来：
+// 包外的消费方（含本包测试）直接取新家；要走的对外面是下面这三扇门。
 export * from './fetch/index.js';
-export * from './policy/index.js';
 export * from './render/index.js';
 export * from './help/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,yFAAyF;AACzF,oFAAoF;AACpF,+FAA+F;AAC/F,oCAAoC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC"}

package/dist/link/declaration.d.ts

@@ -0,0 +1,9 @@
+/** #721 · 联动域的**域声明**（手写、唯一事实源）。
+ *
+ * 一条唤醒词的字面量只准住在这里（判据＝`test/t721-判据与摘要锁.test.mjs` 扫非声明件）；
+ * 场景的 `wake_word` 是投影、不写——词条拥有它；二级组按场景 id 指回词条名下的场景。
+ * 合并方：`src/triggers/wakeTable.ts`（词表＋路由＋派生）与 `src/triggers/wake-assets.ts`（HELP 目录）。
+ */
+import type { DomainDeclaration } from '../triggers/routeSpec.js';
+export declare const LINK_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

package/dist/link/declaration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/link/declaration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,gBAAgB,EAAE,iBAsC9B,CAAC"}

package/dist/link/declaration.js

@@ -0,0 +1,40 @@
+export const LINK_DECLARATION = {
+    id: 'link',
+    label: '联动',
+    icon: '🔗',
+    order: 6,
+    entries: [
+        {
+            phrase: '买东西',
+            key: 'bill.link.submit',
+            preset: { scene: 'purchase' },
+            scenes: [
+                {
+                    id: 'link_purchase',
+                    title: '买东西联动(记账 + 录物品)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我记一笔买东西的账并联动录入(唤醒词:买东西):\n\n  金  额: ____\n  物  品: ____ (如:空气炸锅)\n  分  类: ____ (选填,默认居家/家电)\n',
+                    types: ['采集'],
+                },
+            ],
+        },
+        {
+            phrase: '吃饭',
+            key: 'bill.link.submit',
+            preset: { scene: 'meal' },
+            scenes: [
+                {
+                    id: 'link_meal',
+                    title: '吃饭联动(记账 + 记卡路里)',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我记一笔吃饭的账并联动卡路里(唤醒词:吃饭):\n\n  金  额: ____\n  吃  了: ____ (如:午饭 鸡腿饭)\n  分  类: ____ (选填,默认餐饮)\n',
+                    types: ['采集'],
+                },
+            ],
+        },
+    ],
+    subgroups: [
+        { id: 'link_1', label: '联动', scenes: ['link_purchase', 'link_meal'] },
+    ],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/link/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/link/declaration.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,EAAE,EAAE,MAAM;IACV,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,CAAC;IACR,OAAO,EAAE;QACP;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE;YAC7B,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,eAAe;oBACnB,KAAK,EAAE,iBAAiB;oBACxB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,2GAA2G;oBAC5H,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,IAAI;YACZ,GAAG,EAAE,kBAAkB;YACvB,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;YACzB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,WAAW;oBACf,KAAK,EAAE,iBAAiB;oBACxB,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,yGAAyG;oBAC1H,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;KACF;IACD,SAAS,EAAE;QACT,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,eAAe,EAAE,WAAW,CAAC,EAAE;KACtE;CACF,CAAC"}

package/dist/output.d.ts

@@ -0,0 +1,21 @@
+import { type HtmlLanding, type HtmlReceipt } from 'base-paint/save-html';
+/** 交付结果（`file` 态唯一；`path` 必为绝对路径）。＝共用件回执的形状，别名指向它，不另立第二份定义。 */
+export type HtmlDelivery = HtmlReceipt;
+/** 落点**意图**（缺省交付用）：`dir` 落哪个目录、`stem` 文件名主体——时间戳格式与同秒递补由共用件钉死。
+ *  ＝共用件自己的形状，转出去给出口用（本件不另立定义）。 */
+export type { HtmlLanding };
+/** 交付一次 HTML 产物（**唯一交付入口**）：
+ *  - `explicit`（`--html <路径>`，用户逐字指定）→ **覆盖写**（共用件 `onExists:'overwrite'` ＋ `file`：落点逐字）；
+ *  - `target`（本次产物按通式算出的落点意图）→ **独占创建 ＋ 递补**（共用件缺省 `succession` ＋ `stem`：文件名主体）；
+ *  - `target` ＋ `reuseMs`（>0）→ **窗口内复用**（共用件 `{reuse:{byAge}}`）：已有那份不超龄就返回它、不新建；
+ *  - 两者都给时 `explicit` 优先（用户指定胜过默认落点）。**`explicit` 不吃复用**——逐字落点是「说哪落哪」。
+ *  `stem` 与 `file` 是共用件上两个正交的口子：#237 之前本件把 `basename(abs)` 当 `stem` 传、
+ *  靠 `overwrite` 态把主体解释成完整文件名，一个参数背两个语义；现改为 `file` 走确切文件名。
+ *  `reuseMs` 的取值口径（含「几小时＝多少毫秒」）在共用件 `reuseWindowOfHours`，本件不自己算。 */
+export declare function deliverHtml(input: {
+    explicit?: string;
+    target?: HtmlLanding;
+    html: string;
+    reuseMs?: number;
+}): HtmlDelivery;
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAgB,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExF,+DAA+D;AAC/D,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC;AAEvC;kCACkC;AAClC,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;oEAOoE;AACpE,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,YAAY,CAcf"}

package/dist/output.js

@@ -0,0 +1,48 @@
+/** #144 · HTML 产物的**交付入口**（`explicit` 覆盖写／`target` 独占创建 ＋ 绝对路径回执）。
+ *
+ * #237 改判（维护者 2026-09-12 裁决 8「不应该是一个独立的 base 包，放在 `base-paint` 吧，是绘制出 html 后的
+ * 相关操作」；地图 #208 的 Q7 同轮裁「乙」＝把「命名与落盘」收成共用位）：落盘与命名收进共用件
+ * `base-paint/save-html` 的 `saveHtmlFile`，本件不再自持 `nextExclusiveCandidate`／
+ * `writeFileExclusiveWithRetry`——那两份与 `skill-calorie/src/output.ts` 的对应件逐行等价（30 行 vs 29 行，
+ * 只差两处字面量），正是铁律二禁止的「同一件事两份实现」。
+ *
+ * #128 的因果（照抄保留，别重演）：默认落点曾是「`readdirSync` 计数选名 → `writeFileSync`（`w` 覆盖）」
+ * 两步，两步之间无独占性；多进程并发同秒都选同一路径 → 后写覆盖先写，用户按回执路径可能打开另一次调用的
+ * 产物。修法（现住共用件）：`flag:'wx'` 独占创建，`EEXIST` 时递增 `_N` 重试（原子，无需锁）。
+ *  - 串行语义不变：首选仍是通式初候选，首试即中 → 文件名与老版逐字一致；
+ *  - 大小写不敏感（Windows `normcase`）由 `wx` 天然覆盖：`.HTML` 占位同样 `EEXIST`；
+ *  - **仅** `EEXIST` 递补，其余错误原样抛出（不把权限／路径错伪装成「换个名再写一次」）。
+ *
+ * #83 返修 R-1 的教训：回执路径必须归一为**绝对路径**——`SKILLS_DB_PATH` 本身可以是相对路径，产物已写盘却
+ * 把相对串回传给调用方，下游按它打开就会找不到（或找到别处的同名文件）。共用件回执的 `path` 恒绝对。
+ *
+ * 有意**不**做（对抗式取舍）：照 caloric 的只读回退（`EACCES`／`EROFS` → inline 交付）在本线
+ * **不引入**——本图的目的地是「明确拿到文件」，写不进去就是真失败，应当 exit 5 ＋ 结构化失败回执，
+ * 不静默降级成另一种交付形态（也就少一整套 inline 语义要维护）。
+ */
+import { basename, dirname, resolve } from 'node:path';
+import { saveHtmlFile } from 'base-paint/save-html';
+/** 交付一次 HTML 产物（**唯一交付入口**）：
+ *  - `explicit`（`--html <路径>`，用户逐字指定）→ **覆盖写**（共用件 `onExists:'overwrite'` ＋ `file`：落点逐字）；
+ *  - `target`（本次产物按通式算出的落点意图）→ **独占创建 ＋ 递补**（共用件缺省 `succession` ＋ `stem`：文件名主体）；
+ *  - `target` ＋ `reuseMs`（>0）→ **窗口内复用**（共用件 `{reuse:{byAge}}`）：已有那份不超龄就返回它、不新建；
+ *  - 两者都给时 `explicit` 优先（用户指定胜过默认落点）。**`explicit` 不吃复用**——逐字落点是「说哪落哪」。
+ *  `stem` 与 `file` 是共用件上两个正交的口子：#237 之前本件把 `basename(abs)` 当 `stem` 传、
+ *  靠 `overwrite` 态把主体解释成完整文件名，一个参数背两个语义；现改为 `file` 走确切文件名。
+ *  `reuseMs` 的取值口径（含「几小时＝多少毫秒」）在共用件 `reuseWindowOfHours`，本件不自己算。 */
+export function deliverHtml(input) {
+    if (input.explicit !== undefined && input.explicit.length > 0) {
+        const abs = resolve(input.explicit);
+        return saveHtmlFile({ dir: dirname(abs), file: basename(abs), html: input.html, onExists: 'overwrite' });
+    }
+    if (input.target === undefined) {
+        throw new Error('[skill-bill] deliverHtml 缺落点（`explicit` 与 `target` 至少给一个）');
+    }
+    return saveHtmlFile({
+        dir: input.target.dir,
+        stem: input.target.stem,
+        html: input.html,
+        ...(input.reuseMs === undefined ? {} : { onExists: { reuse: { byAge: input.reuseMs } } }),
+    });
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,YAAY,EAAsC,MAAM,sBAAsB,CAAC;AASxF;;;;;;;oEAOoE;AACpE,MAAM,UAAU,WAAW,CAAC,KAK3B;IACC,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACpC,OAAO,YAAY,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3G,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,YAAY,CAAC;QAClB,GAAG,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG;QACrB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;QACvB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;KAC1F,CAAC,CAAC;AACL,CAAC"}

package/dist/query/commands.d.ts

@@ -0,0 +1,17 @@
+import { viewRecordDetail, viewRecordToday } from './read.js';
+export declare const QUERY_COMMANDS: ({
+    kind: "read";
+    key: string;
+    shape: "list";
+    title: string;
+    example: string;
+    run: typeof viewRecordToday;
+} | {
+    kind: "read";
+    key: string;
+    shape: "detail";
+    title: string;
+    example: string;
+    run: typeof viewRecordDetail;
+})[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/query/commands.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,gBAAgB,EAAqC,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjG,eAAO,MAAM,cAAc;;;;;;;;;;;;;;IAiCO,CAAC"}

package/dist/query/commands.js

@@ -0,0 +1,36 @@
+import { viewRecordDetail, viewRecordRange, viewRecordSearch, viewRecordToday } from './read.js';
+export const QUERY_COMMANDS = [
+    {
+        kind: 'read',
+        key: 'bill.record.today',
+        shape: 'list',
+        title: '查今天',
+        example: 'bill-cmd-read bill.record.today --params \'{"date":"2026-09-06"}\'',
+        run: viewRecordToday,
+    },
+    {
+        kind: 'read',
+        key: 'bill.record.range',
+        shape: 'list',
+        title: '查区间',
+        example: 'bill-cmd-read bill.record.range --params \'{"start":"2026-09-01","end":"2026-09-30"}\'',
+        run: viewRecordRange,
+    },
+    {
+        kind: 'read',
+        key: 'bill.record.search',
+        shape: 'list',
+        title: '搜备注',
+        example: 'bill-cmd-read bill.record.search --params \'{"q":"午饭"}\'',
+        run: viewRecordSearch,
+    },
+    {
+        kind: 'read',
+        key: 'bill.record.detail',
+        shape: 'detail',
+        title: '查账单详情',
+        example: 'bill-cmd-read bill.record.detail --params \'{"id":1}\'',
+        run: viewRecordDetail,
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/query/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/query/commands.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAEjG,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,oEAAoE;QAC7E,GAAG,EAAE,eAAe;KACrB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,mBAAmB;QACxB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,wFAAwF;QACjG,GAAG,EAAE,eAAe;KACrB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,0DAA0D;QACnE,GAAG,EAAE,gBAAgB;KACtB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,wDAAwD;QACjE,GAAG,EAAE,gBAAgB;KACtB;CAC+B,CAAC"}

package/dist/query/declaration.d.ts

@@ -0,0 +1,9 @@
+/** #721 · 查询域的**域声明**（手写、唯一事实源）。
+ *
+ * 一条唤醒词的字面量只准住在这里（判据＝`test/t721-判据与摘要锁.test.mjs` 扫非声明件）；
+ * 场景的 `wake_word` 是投影、不写——词条拥有它；二级组按场景 id 指回词条名下的场景。
+ * 合并方：`src/triggers/wakeTable.ts`（词表＋路由＋派生）与 `src/triggers/wake-assets.ts`（HELP 目录）。
+ */
+import type { DomainDeclaration } from '../triggers/routeSpec.js';
+export declare const QUERY_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.d.ts","sourceRoot":"","sources":["../../src/query/declaration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,iBAyP/B,CAAC"}