skill-bill 0.1.0 → 0.2.1

package/dist/triggers/wake-assets.js

@@ -0,0 +1,67 @@
+/** #721 · 饼干记账 HELP 内容资产：8 份域声明 → 7 域／20 二级组／74 场景的**运行期合并件**。
+ *
+ * 这一件原先是 **962 行生成物**（`scripts/gen-wake-assets.mjs` 从**仓外**事实源
+ * `老技能\饼干记账.html` 的 `<script id="help-data">` payload 逐字生成）；#721 起事实源回到仓内、回到域里：
+ * 每个能力自己持一份手写域声明（`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`），
+ * 本件只做三件事——**引声明 → 按 `order` 排 → 按有无场景分流**。生成器随搬运器一起退役
+ * （搬运当刻与老权威逐字段 0 差异的读数见 `docs/skills/skill-bill/t721-证据.md`）。
+ *
+ * 为什么不留生成物：这个派生物的产出只是「几个数组按序拼起来」——算得不贵、消费者也不要另一种表示；
+ * 它唯一剩下的功能是「证明自己没被手改」，而文件不存在就没东西可手改（判据 2 的鉴别力转由
+ * `test/t721-判据与摘要锁.test.mjs` 的内容摘要锁承担）。
+ *
+ * **导出面与路径一字未改**（消费方零改）：`WAKE_GROUPS`／`WAKE_ASSETS`／`SCENE_BY_ID`／
+ * `WAKE_ASSET_TOTAL`／`HELP_WAKE_WORDS` ＋ 四个类型再转出。
+ *
+ * 两条机械不变式（声明写错时在这里当场报，不留到页面上）：
+ *   · 一个场景 id 只准被一条词条拥有一次；二级组点名的场景必须在本域内；
+ *   · 有场景的声明必须有 `label` 与 `icon`（域元数据随域声明住），无场景的那一份（HELP 位）两者都没有。
+ * 分流（防自指）只写一处：**有场景的声明进目录；没场景的声明的词进 `HELP_WAKE_WORDS`**。
+ */
+import { DECLARATIONS } from './wakeTable.js';
+/** 一个域声明 → 一张 HELP 一级分组的卡（无场景的声明不进目录）。 */
+function toGroup(decl) {
+    if (decl.subgroups.length === 0)
+        return null;
+    if (decl.label === undefined || decl.icon === undefined) {
+        throw new Error('[wake-assets] 有场景的域声明缺 label／icon：' + decl.id);
+    }
+    const scenes = new Map();
+    for (const e of decl.entries) {
+        for (const s of e.scenes) {
+            if (scenes.has(s.id))
+                throw new Error('[wake-assets] 场景被两条词条同时拥有：' + s.id);
+            scenes.set(s.id, {
+                id: s.id, title: s.title, wake_word: e.phrase, status: s.status, prompt_template: s.prompt_template, types: s.types,
+            });
+        }
+    }
+    const subgroups = decl.subgroups.map((sg) => ({
+        id: sg.id,
+        label: sg.label,
+        scenes: sg.scenes.map((id) => {
+            const s = scenes.get(id);
+            if (s === undefined)
+                throw new Error('[wake-assets] 二级组的场景不在本域词条名下：' + sg.id + ' → ' + id);
+            return s;
+        }),
+    }));
+    return { id: decl.id, icon: decl.icon, label: decl.label, subgroups };
+}
+/** 7 域／20 二级组／74 场景（域序＝声明的 `order`，词序＝声明里的书写顺序）。 */
+export const WAKE_GROUPS = DECLARATIONS
+    .map(toGroup)
+    .filter((g) => g !== null);
+/** 扁平 74 条（顺序与 HELP 分组一致；单源派生，不重复落词）。 */
+export const WAKE_ASSETS = WAKE_GROUPS.flatMap((g) => g.subgroups.flatMap((s) => s.scenes));
+/** id → 场景（74/74 唯一）。 */
+export const SCENE_BY_ID = Object.fromEntries(WAKE_ASSETS.map((s) => [s.id, s]));
+/** 资产总数（由 `WAKE_ASSETS` 派生，单源不复写第二遍数；改资产即跟变，测试仍钉 74）。 */
+export const WAKE_ASSET_TOTAL = WAKE_ASSETS.length;
+/** HELP 自身的唤醒词（老实物 `meta_blocks.help_wake_words` 那一块；4 条，不进场景目录）。
+ *
+ * 从**无场景的那份声明**（HELP 位）读——防自指的规则只写一处：有场景的进目录，没场景的进这里。 */
+export const HELP_WAKE_WORDS = DECLARATIONS
+    .filter((d) => d.subgroups.length === 0)
+    .flatMap((d) => d.entries.map((e) => e.phrase));
+//# sourceMappingURL=wake-assets.js.map

package/dist/triggers/wake-assets.js.map

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

package/dist/triggers/wakeTable.d.ts

@@ -0,0 +1,18 @@
+import type { DomainDeclaration, WakeEntry, WakeRoute, WakeScope } from './routeSpec.js';
+/** 8 份域声明（每份一件，恰好一个导出）。**声明的清单只有这一处**——目录投影件也从这里取。 */
+export declare const DECLARATIONS: readonly DomainDeclaration[];
+/** 全量唤醒词表（77 条；HELP 位那 4 条在前，域序照域声明自带的 `order`，词序照声明里 `entries` 的书写顺序）。 */
+export declare const WAKE_TABLE: readonly WakeEntry[];
+/** 自然语言 → 命令名 ＋ 槽位；无命中／缺槽位即抛。 */
+export declare function routeWakeword(text: string, ctx?: Record<string, unknown>): WakeRoute;
+/** 给一条命令算它那些词里「用户只说命令名」的那一条（**代表唤醒词**）。
+ *
+ * 规则：同 `key` 下**第一条不带 `preset` 的词条**（＝通用词：`记一笔`／`改记录`／`查今天`／`查区间`／
+ *  `搜备注`／`查账单详情`——六条迁移过的命令逐条复现今天的代表词）；该 `key` 每条词都带 `preset` 时
+ *  退回第一条词条；**一条词都没有即抛**（US 15：某条命令若一条词都算不出来，当场报「用户到不了它」，
+ *  不是静默给一张空卡）。 */
+export declare function projectWakeWord(scope: WakeScope): string;
+/** 内部型名 → 唤醒词（类型徽章与回执页标题那一支）：认得的型名按 `preset.kind` 算，
+ *  **认不得的型名与空串都给写入域的通用词**（`记一笔`）——与 `src/write/scene.ts` 的兜底同口径。 */
+export declare function wakeWordOfKind(kind: string): string;
+//# sourceMappingURL=wakeTable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wakeTable.d.ts","sourceRoot":"","sources":["../../src/triggers/wakeTable.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAW,iBAAiB,EAAE,SAAS,EAAiB,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEjH,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,SAAS,iBAAiB,EAGpD,CAAC;AA4BF,2EAA2E;AAC3E,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAmD,CAAC;AAiB/F,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,SAAS,CAUxF;AAQD;;;;;kBAKkB;AAClB,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAsBxD;AAED;oEACoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAInD"}

package/dist/triggers/wakeTable.js

@@ -0,0 +1,135 @@
+// #721 · 唤醒词表的**汇总件**（触发与路由的机器面）：8 份域声明 → 词表 ＋ 路由 ＋ 三个投影。
+//
+// 一条唤醒词的事实（怎么说／路由到哪条命令／说完看到哪张卡）只住它所属那份域声明
+// （`src/<域>/declaration.ts` ×7 ＋ `src/help/declaration.ts`）；本件是那些声明的**唯一汇总位**：
+//   · `WAKE_TABLE`——77 条词序＝各声明按 `order` 拼接的顺序（与今天逐条同序）；
+//   · `routeWakeword`——最长匹配优先；无命中/缺槽位 throw（逻辑逐字照旧，只换了上游）；
+//   · `projectWakeWord`／`wakeWordOfKind`——「算得出来的不许写」那一半：页面标题、类型徽章、
+//     落点表的场景词都由声明算回，别处不再写第二处字面量（判据见 `test/t721-判据与摘要锁.test.mjs`）。
+//
+// 谁在用（指名）：`src/help/lookup.ts` · `src/write/writeWire.ts` · `src/write/userWording.ts` ·
+//   `src/write/collectFrame.ts` · `src/write/scene-{update,undo,restore}.ts` · `src/query/read.ts`
+//   （#689 第三批：原先经薄转出件 `src/policy/wakewords.ts` 取的三处已直接改指本件，那件与 `policy/` 一并删除）。
+//
+// 域序 fail-closed：8 份声明的 `order` 必须是连续的 0..n-1，缺号／重号即抛（不用中央名单、
+// 也不用目录扫描——扫描出的是字母序，与实物的域序七处全不同）。
+import { BillPolicyError } from '../fetch/errors.js';
+import { ACCOUNT_DECLARATION } from '../account/declaration.js';
+import { ANALYSIS_DECLARATION } from '../analysis/declaration.js';
+import { GOAL_DECLARATION } from '../goal/declaration.js';
+import { HELP_DECLARATION } from '../help/declaration.js';
+import { LINK_DECLARATION } from '../link/declaration.js';
+import { QUERY_DECLARATION } from '../query/declaration.js';
+import { SETUP_DECLARATION } from '../setup/declaration.js';
+import { WRITE_DECLARATION } from '../write/declaration.js';
+/** 8 份域声明（每份一件，恰好一个导出）。**声明的清单只有这一处**——目录投影件也从这里取。 */
+export const DECLARATIONS = [
+    HELP_DECLARATION, WRITE_DECLARATION, QUERY_DECLARATION, ANALYSIS_DECLARATION,
+    GOAL_DECLARATION, ACCOUNT_DECLARATION, LINK_DECLARATION, SETUP_DECLARATION,
+];
+/** 按 `order` 排好；缺号／重号即抛（域序是事实，不许靠猜）。 */
+function ordered(decls) {
+    const sorted = [...decls].sort((a, b) => a.order - b.order);
+    const seen = new Set();
+    for (const d of sorted) {
+        if (!Number.isInteger(d.order) || d.order < 0)
+            throw new Error('[wakeTable] 域声明的 order 不是非负整数：' + d.id + '=' + String(d.order));
+        if (seen.has(d.order))
+            throw new Error('[wakeTable] 域声明的 order 重号：' + d.id + '=' + String(d.order));
+        seen.add(d.order);
+    }
+    for (let i = 0; i < sorted.length; i += 1) {
+        if (!seen.has(i))
+            throw new Error('[wakeTable] 域声明的 order 缺号：没有 ' + String(i) + '（现有 ' + sorted.map((d) => String(d.order)).join('、') + '）');
+    }
+    return sorted;
+}
+const ORDERED = ordered(DECLARATIONS);
+/** 词条（去掉场景那半；词表消费方读到的形状与今天逐字段相同）。 */
+function asEntry(e) {
+    const out = { phrase: e.phrase, key: e.key };
+    if (e.preset !== undefined)
+        out.preset = e.preset;
+    if (e.needs !== undefined)
+        out.needs = e.needs;
+    if (e.carries !== undefined)
+        out.carries = e.carries;
+    return out;
+}
+/** 全量唤醒词表（77 条；HELP 位那 4 条在前，域序照域声明自带的 `order`，词序照声明里 `entries` 的书写顺序）。 */
+export const WAKE_TABLE = ORDERED.flatMap((d) => d.entries.map(asEntry));
+/** 全部词条（含场景归属），按同一顺序摊平——投影只读它。 */
+const ALL_ENTRIES = ORDERED.flatMap((d) => d.entries);
+/** 型名 → 词条（`preset.kind` 认得的那些）：**书写顺序先到者胜**。
+ *  为什么不是「型名唯一」：`reimburse`／`installment` 在写入域是型名、在查询域是过滤条件（同名不同物），
+ *  而写入域的词条排在查询域之前（`order` 1 < 2），先到者胜即写入域那一条——类型徽章要的正是它。 */
+const BY_KIND = new Map();
+for (const e of ALL_ENTRIES) {
+    const k = e.preset === undefined ? undefined : e.preset['kind'];
+    if (typeof k === 'string' && k !== '' && !BY_KIND.has(k))
+        BY_KIND.set(k, e);
+}
+/** 最长匹配优先（“看分类对比”不落入“看分类”，“初始化状态”不落入“初始化”，“报销到账”不落入“记报销”）。 */
+const SORTED = [...WAKE_TABLE].sort((a, b) => b.phrase.length - a.phrase.length);
+/** 自然语言 → 命令名 ＋ 槽位；无命中／缺槽位即抛。 */
+export function routeWakeword(text, ctx = {}) {
+    if (typeof text !== 'string' || text.length === 0)
+        throw new BillPolicyError('POLICY_NO_MATCH', '唤醒词为空');
+    const hit = SORTED.find((e) => text.includes(e.phrase));
+    if (!hit)
+        throw new BillPolicyError('POLICY_NO_MATCH', '无命中唤醒词：' + text);
+    for (const s of hit.needs || []) {
+        if (ctx[s] === undefined || ctx[s] === null || ctx[s] === '') {
+            throw new BillPolicyError('POLICY_MISSING_SLOT', '缺槽位 ' + s + '：' + hit.phrase);
+        }
+    }
+    return { key: hit.key, params: { ...(hit.preset || {}), ...pickCtx(ctx, [...(hit.needs || []), ...(hit.carries || [])]) } };
+}
+function pickCtx(ctx, names) {
+    const o = {};
+    for (const k of names)
+        if (ctx[k] !== undefined)
+            o[k] = ctx[k];
+    return o;
+}
+/** 给一条命令算它那些词里「用户只说命令名」的那一条（**代表唤醒词**）。
+ *
+ * 规则：同 `key` 下**第一条不带 `preset` 的词条**（＝通用词：`记一笔`／`改记录`／`查今天`／`查区间`／
+ *  `搜备注`／`查账单详情`——六条迁移过的命令逐条复现今天的代表词）；该 `key` 每条词都带 `preset` 时
+ *  退回第一条词条；**一条词都没有即抛**（US 15：某条命令若一条词都算不出来，当场报「用户到不了它」，
+ *  不是静默给一张空卡）。 */
+export function projectWakeWord(scope) {
+    const pool = scope.key === undefined ? ALL_ENTRIES : ALL_ENTRIES.filter((e) => e.key === scope.key);
+    if (pool.length === 0) {
+        throw new BillPolicyError('POLICY_NO_MATCH', '这条命令一条唤醒词都没有（用户到不了它）：' + String(scope.key));
+    }
+    const clues = { ...(scope.preset ?? {}) };
+    if (scope.kind !== undefined && scope.kind !== '')
+        clues['kind'] = scope.kind;
+    if (scope.op !== undefined && scope.op !== '')
+        clues['op'] = scope.op;
+    if (Object.keys(clues).length > 0) {
+        // ① preset 命中（最具体者胜）：页面标题那一支＋型名／操作名那一支，走的是同一张 `preset`。
+        const byPreset = pool
+            .filter((e) => e.preset !== undefined && Object.entries(e.preset).every(([k, v]) => clues[k] === v))
+            .sort((a, b) => Object.keys(b.preset ?? {}).length - Object.keys(a.preset ?? {}).length);
+        if (byPreset.length > 0)
+            return byPreset[0].phrase;
+        // ② needs 命中：`查某天`（要 date）／`查区间`（要 start＋end）／`查分类`… 这类词靠必需槽位认。
+        const byNeeds = pool.filter((e) => e.needs !== undefined
+            && e.needs.every((n) => clues[n] !== undefined && clues[n] !== null && clues[n] !== ''));
+        if (byNeeds.length > 0)
+            return byNeeds[0].phrase;
+    }
+    // ③ 通用词（第一条不带 preset 的词条）；都没有就第一条。
+    const generic = pool.find((e) => e.preset === undefined);
+    return (generic ?? pool[0]).phrase;
+}
+/** 内部型名 → 唤醒词（类型徽章与回执页标题那一支）：认得的型名按 `preset.kind` 算，
+ *  **认不得的型名与空串都给写入域的通用词**（`记一笔`）——与 `src/write/scene.ts` 的兜底同口径。 */
+export function wakeWordOfKind(kind) {
+    const k = typeof kind === 'string' ? kind.trim() : '';
+    const hit = k === '' ? undefined : BY_KIND.get(k);
+    return hit !== undefined ? hit.phrase : projectWakeWord({ key: 'bill.record.add' });
+}
+//# sourceMappingURL=wakeTable.js.map

package/dist/triggers/wakeTable.js.map

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

package/dist/write/blockedFold.d.ts

@@ -0,0 +1,10 @@
+import type { BlockedItem } from './blockedSlots.js';
+/** 采集页的缺项阻断块（折叠形）：不给内容（没缺项）＝不出这一块。 */
+export declare function collectBlockedFold(input: {
+    readonly items: readonly BlockedItem[];
+    /** 写库口令原文（补齐后照抄重跑那条）；带尖括号占位符。 */
+    readonly command: string;
+    /** 补齐之后会发生什么（不给＝走共用件那句缺省口径）。 */
+    readonly note?: string;
+}): string;
+//# sourceMappingURL=blockedFold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockedFold.d.ts","sourceRoot":"","sources":["../../src/write/blockedFold.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,MAAM,CAUT"}

package/dist/write/blockedFold.js

@@ -0,0 +1,31 @@
+/** 缺项阻断条的**折叠摆法**（写入域共用件）：共用的阻断条——「还缺什么」错误回执、缺项明示表、
+ *  写库口令原文、置灰的写库按钮——整条收进折叠区，首屏只留缺项标签与进度两处形状承担提示。
+ *  派单的架构级整改要的就是这一条（口令原文块整条可见 → 折叠）。
+ *
+ * **判定与文案仍是 `./blockedSlots.js` 那一份**：本件只把共用件的产出换个位置摆，不另写第二份缺项口径，
+ *  也不改阻断行为（写库那一半照旧由 `src/write/write.ts` 拦）。折叠区里那枚置灰按钮不带 `data-t`，
+ *  折叠与否都点不动（`packages/base-render/src/controls.ts` 的点击委派读到空 `data-t` 即早退）。
+ *
+ * 谁在用（两张模板、两族，指名）：`src/write/template-expense.ts`（记账族五条词：记支出／记收入／
+ *  拍账单／记报销／记一笔）与 `src/write/template-batch.ts`（批量录入）——两张族的采集页同一摆法，
+ *  改一处两族同时改。（另三张模板 `template-{flow,installment,update}.ts` 各有自己的折叠摆法，不指本件。）
+ *
+ * 件史：本件此前是 `src/write/collectBody.ts` 的通用采集页装配体，那件已无任何调用方（场景件都走模板了），
+ *  随票删除；那个装配体里只剩这一个函数还有用，故搬到件名说了它是什么的本件。
+ */
+import { renderDisclosure } from 'base-paint/blocks';
+import { blockedBar } from './blockedSlots.js';
+/** 采集页的缺项阻断块（折叠形）：不给内容（没缺项）＝不出这一块。 */
+export function collectBlockedFold(input) {
+    if (input.items.length === 0)
+        return '';
+    return renderDisclosure({
+        title: '还缺什么，以及补齐后照抄的那条',
+        contentHtml: blockedBar({
+            items: input.items,
+            command: input.command,
+            ...(input.note === undefined ? {} : { note: input.note }),
+        }),
+    });
+}
+//# sourceMappingURL=blockedFold.js.map

package/dist/write/blockedFold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockedFold.js","sourceRoot":"","sources":["../../src/write/blockedFold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,sCAAsC;AACtC,MAAM,UAAU,kBAAkB,CAAC,KAMlC;IACC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,gBAAgB,CAAC;QACtB,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,UAAU,CAAC;YACtB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1D,CAAC;KACH,CAAC,CAAC;AACL,CAAC"}

package/dist/write/blockedSlots.d.ts

@@ -0,0 +1,39 @@
+/** 一个阻断项：哪个槽位／中文名／为什么挡住。 */
+export interface BlockedItem {
+    readonly name: string;
+    readonly label: string;
+    readonly why: string;
+}
+/** 判定入参：本次参数 ＋ 必需槽位里缺的那些 ＋ 本型（`params.kind`，空串＝本支不判方向）。 */
+interface BlockedProbe {
+    readonly params: Record<string, unknown>;
+    readonly missing: readonly {
+        readonly name: string;
+        readonly label: string;
+    }[];
+    /** 录入路径给这一型（`expense`／`income`）；其余支不给＝本支不管方向。 */
+    readonly kind: string;
+}
+/** 判定：缺的必需槽位 ＋ 方向不符的金额（**方向只服务录入路径**，见件头）。**空数组＝可以往下走写库那一步**。 */
+export declare function blockedItems(input: BlockedProbe): BlockedItem[];
+/** 阻断条那一句文案（**唯一定义地**）：envelope 载荷与采集页副标题都引它（两处各写一遍就会改一处漏一处）。
+ *  两岔：纯缺槽位那一句照旧（与兄弟票同一句，测试逐字钉着）；只有方向不符时说方向。
+ *
+ *  **中文名不进这一句**（本轮整改）：缺项清单写用户看得懂的中文名，库列名只留在字段表那一列的中文标签里
+ *  （照 `docs/skills/skill-bill/t407-文字审查.md` 第 34 条的判法：`还缺 N 项：分类（category）` 里
+ *  `category` 是内部标识，不上屏）。 */
+export declare function blockedMessage(missing: readonly {
+    readonly name: string;
+}[], blocked: readonly BlockedItem[]): string;
+/** 阻断条的入参：判定结果 ＋ 那条「补齐后可重跑」的写库指令原文。 */
+interface BlockedBarInput {
+    readonly items: readonly BlockedItem[];
+    /** 写库指令原文（补齐后照抄重跑那条）；带尖括号占位符。 */
+    readonly command: string;
+    /** 补齐之后会发生什么（缺省一句）。 */
+    readonly note?: string;
+}
+/** 缺项阻断条：错误回执 ＋ 缺项徽章行 ＋ 缺项明示表 ＋ 不可复制的写库指令 ＋ 置灰的写库按钮。空判定＝不出这一段（返回空串）。 */
+export declare function blockedBar(input: BlockedBarInput): string;
+export {};
+//# sourceMappingURL=blockedSlots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blockedSlots.d.ts","sourceRoot":"","sources":["../../src/write/blockedSlots.ts"],"names":[],"mappings":"AA6BA,4BAA4B;AAC5B,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;AAED,2DAA2D;AAC3D,UAAU,YAAY;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/E,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CAW/D;AAED;;;;;6BAK6B;AAC7B,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAC7C,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,MAAM,CAOR;AAED,uCAAuC;AACvC,UAAU,eAAe;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD,wEAAwE;AACxE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA+BzD"}

package/dist/write/blockedSlots.js

@@ -0,0 +1,108 @@
+/** 缺项阻断条（缺口块之一，**唯一定义地**）：缺哪些槽位就明示，并把写库按钮置灰——真阻断，不是提示。
+ *
+ * 谁在用（两个调用点，指名）：
+ *   ① `src/write/collect.ts`——过程型采集页：判定 ＋ 阻断条都在这里出；
+ *   ② `src/write/write.ts`——两条写命令的处理体：判定为「有阻断项」时不进写库那一步（拿 `blockedItems` 的空／非空当闸门）。
+ *  第二个消费者：`src/query/`（随兄弟图 #403 的查询域一起到位，同一套采集页／回执页／复制区要同一条判定）。
+ *  本票实测：本包 `src/` 下真引用本件的就是上面两个调用点，再无第三处。
+ *
+ * 真阻断**怎么真**（三处，缺一处就是提示而不是阻断）：
+ *   ① 写库那一半由 `src/write/write.ts` 拦：判定非空即不进 `addBill`／`updateBill`，库里行数一行不变；
+ *   ② 页上不给可复制的写库指令：`renderPreBlock` 只给 `command`、**不给** `copyText`（本仓复制按钮靠元素自带
+ *      `data-t` 才拷得走，不给就是拷不走）；
+ *   ③ 写库那枚按钮置灰（`kind: 'ghost'`）且**不带** `data-t`——base 的点击委派读到 `data-t` 为空即早退
+ *      （`packages/base-render/src/controls.ts` 的 `onClick`：`text === null` 直接 return），点了既不复制也不写库。
+ *
+ * 判定两件事（都住本件，一处定义）：**槽位没给** ＋ **金额符号与这一型的方向不符**（记支出要负数、记收入要正数）。
+ *  分类三级未填＝`category` 没给，已含在第一件里；方向不符那种「值给了但方向反了」不算缺槽位，故单列一件。
+ *
+ * **方向判定只服务录入路径**（`bill.record.add`；记支出／记收入这两条命令的采集页）：
+ *  调用方只在录入那一支传 `kind`；`bill.record.update` 的改字段／撤销／恢复三支**不传**方向（`write.ts:178`）。
+ *  带 `kind`＋`amount` 的撤销／恢复本来也可能被这条判定拦下、改出采集页，收窄后不再管它们。
+ *  方向那句话的取值（要负数／要正数）不在这里另写一份：走 `./summaryRow.ts` 的 `directionOf`。
+ */
+import { renderActionBar } from 'base-paint';
+import { renderCaliberLine, renderDataTable, renderPreBlock } from 'base-paint/blocks';
+import { directionOf, money2 } from './summaryRow.js';
+import { errorReceipt } from './errorReceipt.js';
+import { fieldLabelOf } from './userWording.js';
+/** 金额解析：认数字与非空数字串；解析不了就不在这里判方向（那是 `src/shared/category.ts` 的活，报错不静默）。 */
+function amountOf(raw) {
+    const n = typeof raw === 'string' && raw.trim() !== '' ? Number(raw.trim()) : raw;
+    if (typeof n !== 'number' || !Number.isFinite(n))
+        return null;
+    return n;
+}
+/** 判定：缺的必需槽位 ＋ 方向不符的金额（**方向只服务录入路径**，见件头）。**空数组＝可以往下走写库那一步**。 */
+export function blockedItems(input) {
+    const items = input.missing.map((s) => ({ name: s.name, label: s.label, why: '没给' }));
+    const d = directionOf(input.kind);
+    const amount = amountOf(input.params['amount']);
+    if (d !== undefined && amount !== null && amount !== 0 && Math.sign(amount) !== d.sign) {
+        items.push({
+            name: 'amount', label: '金额',
+            why: '方向和这一型对不上：' + d.require + '，给的是 ' + money2(amount),
+        });
+    }
+    return items;
+}
+/** 阻断条那一句文案（**唯一定义地**）：envelope 载荷与采集页副标题都引它（两处各写一遍就会改一处漏一处）。
+ *  两岔：纯缺槽位那一句照旧（与兄弟票同一句，测试逐字钉着）；只有方向不符时说方向。
+ *
+ *  **中文名不进这一句**（本轮整改）：缺项清单写用户看得懂的中文名，库列名只留在字段表那一列的中文标签里
+ *  （照 `docs/skills/skill-bill/t407-文字审查.md` 第 34 条的判法：`还缺 N 项：分类（category）` 里
+ *  `category` 是内部标识，不上屏）。 */
+export function blockedMessage(missing, blocked) {
+    if (missing.length > 0) {
+        return '缺必需槽位：' + missing.map((m) => fieldLabelOf(m.name)).join('、')
+            + '（已出采集页，补齐之后跟助手说一遍）';
+    }
+    return '写库已阻断：' + blocked.map((i) => fieldLabelOf(i.name) + '（' + i.why + '）').join('、')
+        + '（已出采集页，改好之后跟助手说一遍）';
+}
+/** 遮断条那几块（**唯一定义地**）：错误回执 ＋ 还缺什么表 ＋ 补齐后照说那句话 ＋ 置灰的写库按钮。
+ *  空判定＝不出这一段（返回空串）。
+ *
+ *  本轮整改把内部话换成用户说法（逐条见 `docs/skills/skill-bill/t407-文字审查.md` 第 34、35、36、37、67 条）：
+ *   ① 标题 `缺项阻断条（写库已阻断）` → `还缺什么`（括号里那句是实现自指，删）；
+ *   ② 一句 `❌ 写库已阻断 · 还缺 N 项：分类（category）` → `❌ 还缺 N 项，补齐再记：分类`（列名不上屏）；
+ *   ③ `补齐后重跑同一条命令` → `补齐后照这句跟助手说一遍`（用户没有「同一条命令」可跑，那句话是给机器看的）；
+ *   ④ 置灰按钮那句 `⛔ 先补齐（N 项）` 保留（照实报缺几项）；
+ *   ⑤ 表头 `缺的槽位／是什么／为什么挡住` 与格值 `没给` → `还缺哪一项／是什么／为什么写不进去／这一项没给`；
+ *   ⑥ 写库指令块的标题 `写库指令（补齐前不给复制按钮）` 保留口令原文的**只读**身份（不给复制按钮，
+ *      用户不会照抄一条带占位符的 JSON），但那句括号里的实现说明删掉——它说的是页面怎么做，不是用户要做什么。
+ */
+const BLOCKED_WRITE_ACTION = 'ilife-blocked-write';
+/** 缺项阻断条：错误回执 ＋ 缺项徽章行 ＋ 缺项明示表 ＋ 不可复制的写库指令 ＋ 置灰的写库按钮。空判定＝不出这一段（返回空串）。 */
+export function blockedBar(input) {
+    const n = input.items.length;
+    if (n === 0)
+        return '';
+    return errorReceipt({
+        title: '还缺什么',
+        // t728：改前这里是把缺项名 `join('、')` 接在句尾（`还缺 3 项，补齐再记：分类、金额、向谁借`）——
+        //   用户逐字点名的那类写法（拿顿号当日志排版，一段文本里塞 ≥3 件并列的事）。
+        //   现在事由只说「还缺几项」，**缺的是哪几项由下面那行徽章出形状**（每项一枚胶囊，与整页标签同一形状）。
+        message: '还缺 ' + n + ' 项，补齐再记',
+        retryPrompt: '补齐了，说一遍试试',
+    }) + renderDataTable({
+        columns: [
+            { key: 'slot', label: '还缺哪一项' },
+            { key: 'label', label: '是什么' },
+            { key: 'why', label: '为什么写不进去' },
+        ],
+        rows: input.items.map((i) => ({
+            slot: fieldLabelOf(i.name), label: i.label,
+            why: i.why === '没给' ? '这一项没给' : i.why,
+        })),
+        caption: '缺一项就先不写库',
+    }) + renderPreBlock({
+        command: input.command,
+        label: '口令原文（照上面那句跟助手说）',
+    }) + renderActionBar({
+        buttons: [{ label: '⛔ 先补齐（' + n + ' 项）', kind: 'ghost', actionId: BLOCKED_WRITE_ACTION }],
+    }) + renderCaliberLine(input.note === undefined || input.note === ''
+        ? '这一页先不写库。补齐之后照上面那句跟助手说一遍才会写。'
+        : input.note);
+}
+//# sourceMappingURL=blockedSlots.js.map

package/dist/write/blockedSlots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockedSlots.js","sourceRoot":"","sources":["../../src/write/blockedSlots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiBhD,yEAAyE;AACzE,SAAS,QAAQ,CAAC,GAAY;IAC5B,MAAM,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IAClF,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,MAAM,KAAK,GAAkB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACrG,MAAM,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI;YAC3B,GAAG,EAAE,YAAY,GAAG,CAAC,CAAC,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;6BAK6B;AAC7B,MAAM,UAAU,cAAc,CAC5B,OAA6C,EAC7C,OAA+B;IAE/B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;cAChE,oBAAoB,CAAC;IAC3B,CAAC;IACD,OAAO,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;UACpF,oBAAoB,CAAC;AAC3B,CAAC;AAWD;;;;;;;;;;;GAWG;AACH,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEnD,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,KAAsB;IAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACvB,OAAO,YAAY,CAAC;QAClB,KAAK,EAAE,MAAM;QACb,6DAA6D;QAC7D,2CAA2C;QAC3C,yDAAyD;QACzD,OAAO,EAAE,KAAK,GAAG,CAAC,GAAG,SAAS;QAC9B,WAAW,EAAE,WAAW;KACzB,CAAC,GAAG,eAAe,CAAC;QACnB,OAAO,EAAE;YACP,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE;YAC/B,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE;YAC9B,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;SACjC;QACD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK;YAC1C,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG;SACtC,CAAC,CAAC;QACH,OAAO,EAAE,UAAU;KACpB,CAAC,GAAG,cAAc,CAAC;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,iBAAiB;KACzB,CAAC,GAAG,eAAe,CAAC;QACnB,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,GAAG,CAAC,GAAG,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC;KAC1F,CAAC,GAAG,iBAAiB,CACpB,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE;QAC3C,CAAC,CAAC,6BAA6B;QAC/B,CAAC,CAAC,KAAK,CAAC,IAAI,CACf,CAAC;AACJ,CAAC"}

package/dist/write/candidatePick.d.ts

@@ -0,0 +1,50 @@
+/** 一个候选：哪条记录 ＋ 一眼认得出的摘要 ＋ 为什么是它。 */
+export interface CandidateItem {
+    /** 记录编号（写进选项与复制指令的就是它）。 */
+    readonly id: number;
+    /** 一眼认得出的摘要（如「餐饮/外卖/午餐 · 支付宝」）。 */
+    readonly label: string;
+    /** 金额（已格式化好的串，本件不重算）。 */
+    readonly amount: string;
+    /** 发生时间。 */
+    readonly time: string;
+    /** 为什么是它（**必填**：写不出依据的候选，用户没法判断该不该选）。 */
+    readonly why: string;
+}
+/** 候选单选的入参。 */
+interface CandidatePickInput {
+    /** 这一格槽位的参数名（如 `id`／`source_id`），单选控件的 `name` 就是它。 */
+    readonly name: string;
+    /** 这一格的中文名。 */
+    readonly label: string;
+    readonly candidates: readonly CandidateItem[];
+    /** 本次已经认准的那条（不给＝不预选；**不拿第一条兜底**）。 */
+    readonly selectedId?: number | null;
+    /** 这一格想让人做什么（缺省一句）。 */
+    readonly hint?: string;
+}
+/** 候选为空那一格：不拿最近一笔兜底，直接反问用户要哪一条。
+ *
+ *  **本轮返工（真 bug，一处救三页）**：`what` 收的是场景件那句**整句「这一格要的是…」**（就是传进来的 `hint` 原句），
+ *  改前本件又给它加了一遍「这一格要的是」前缀，于是三页同一行同时出两处硬伤——
+ *  「这一格要的是这一格要的是…」（模板串重复）与句尾「。，列表里一条都没有。」（标点粘连）。
+ *  现在按整句收：本件**不再加前缀**，只在句尾缺句号时补一个；
+ *  `；` 缀着的后一句（「拿不准就让助手先查…」）从正文里挪出来并进「下一步」那一格——
+ *  正文只说「要的是哪一类」与「一条都没有」，两句各自成句，不再串在一行里。
+ *  `what` 没给时才退回本件自己那一句。 */
+export declare function candidateEmpty(input: {
+    readonly label: string;
+    readonly what?: string;
+}): string;
+/** 记录列表（含依据徽标）：一条候选一行，零行返回空串（空态由 `candidatePick` 出）。
+ *  表头 `资金`（金额）与列名照用户说法。「为什么是它」只出下面的依据徽标（带候选编号），
+ *  不再另占表的一列——同页同句印两遍，且五列表在手机端被压成单字串（t410 终审 n29）。 */
+export declare function candidateRows(items: readonly CandidateItem[]): string;
+/** 候选单选整块：单选格 ＋ 记录列表 ＋「为什么是它」徽标 ＋ 一行口径；候选为空则只出空态。
+ *
+ *  **已经认准的那条不再进那张表**（本轮整改）：认准之后同页的只读回显表已经把这一条逐项列全，
+ *  候选表再列一遍就是同一句话在页上印两遍（机审判成重复句那一处就是它）。
+ *  没认准的形态照旧：全量候选铺开供挑。 */
+export declare function candidatePick(input: CandidatePickInput): string;
+export {};
+//# sourceMappingURL=candidatePick.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidatePick.d.ts","sourceRoot":"","sources":["../../src/write/candidatePick.ts"],"names":[],"mappings":"AAyBA,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yBAAyB;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,eAAe;AACf,UAAU,kBAAkB;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,qCAAqC;IACrC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,uBAAuB;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AA8BD;;;;;;;;4BAQ4B;AAC5B,wBAAgB,cAAc,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAWhG;AAED;;qDAEqD;AACrD,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAYrE;AAED;;;;yBAIyB;AACzB,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM,CAuB/D"}