skill-bill 0.1.0 → 0.2.1

package/dist/fetch/paths.d.ts

@@ -1,8 +1,20 @@
-export declare const DB_FILENAME = "biscuit_accountant.db";
-export declare const GOALS_FILENAME = "goals.json";
+/** 库文件名（老常量）：默认值表里那一项就是唯一定义地，本常量是它的**具名引用**，不是第二份。 */
+export declare const DB_FILENAME: string;
+/** 第二份库（`goals.json`）文件名：同上，具名引用。 */
+export declare const GOALS_FILENAME: string;
+/** 库文件名：配置 `db.name` 非空即用它，空串＝`DB_FILENAME`。 */
+export declare function dbFilename(): string;
+/** 第二份库文件名：配置 `db.goals` 非空即用它，空串＝`GOALS_FILENAME`。 */
+export declare function goalsFilename(): string;
+/** 库目录：配置 `db.dir` 非空即用它，空串＝配置数据目录（默认 `~/.ilife/data/`）。 */
 export declare function resolveDbDir(): string;
+/** 库文件完整路径（目录不存在即建，`mkdir -p` 语义）。 */
 export declare function resolveDbPath(filename?: string, dir?: string): string;
+/** 第二份库完整路径（与库同目录，建目录语义同 `resolveDbPath`）。 */
 export declare function resolveGoalsPath(dir?: string): string;
-/** 测试隔离守卫：非 tmp 路径写库须 BILL_FORCE_PROD=1（卡路里哨兵语义的饼干版）。 */
-export declare function assertWritablePath(dbPath: string): void;
+/** 备份目录：配置 `backup.dir` 非空即按它解（`resolve()`，相对当刻工作目录），空串＝库目录下的 `backups`。
+ *  「不自动建」是体检那条判据的口径（`health.ts:467`）——本函数只算路径，建目录归调用方。 */
+export declare function resolveBackupDir(dbDir?: string): string;
+/** 备份文件名：`<backup.stem><stamp>.db`（主体默认 `biscuit_` ⇒ 与老口径 `biscuit_<stamp>.db` 逐字相同）。 */
+export declare function backupFileName(stamp: string): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/fetch/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,wBAAgB,YAAY,IAAI,MAAM,CASrC;AAED,wBAAgB,aAAa,CAAC,QAAQ,SAAc,EAAE,GAAG,SAAiB,GAAG,MAAM,CAGlF;AAED,wBAAgB,gBAAgB,CAAC,GAAG,SAAiB,GAAG,MAAM,CAG7D;AAED,yDAAyD;AACzD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAYvD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAyBA,sDAAsD;AACtD,eAAO,MAAM,WAAW,QAA+B,CAAC;AAExD,qCAAqC;AACrC,eAAO,MAAM,cAAc,QAAgC,CAAC;AAE5D,gDAAgD;AAChD,wBAAgB,UAAU,IAAI,MAAM,CAGnC;AAED,uDAAuD;AACvD,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,4DAA4D;AAC5D,wBAAgB,YAAY,IAAI,MAAM,CAIrC;AAED,sCAAsC;AACtC,wBAAgB,aAAa,CAAC,QAAQ,SAAe,EAAE,GAAG,SAAiB,GAAG,MAAM,CAGnF;AAED,8CAA8C;AAC9C,wBAAgB,gBAAgB,CAAC,GAAG,SAAiB,GAAG,MAAM,CAG7D;AAED;0DAC0D;AAC1D,wBAAgB,gBAAgB,CAAC,KAAK,SAAiB,GAAG,MAAM,CAG/D;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/fetch/paths.js

@@ -1,36 +1,66 @@
-// DB 路径解析与隔离守卫：SKILLS_DB_PATH 必设，无默认值（铁律缺失阻断）。
-// 老家 db.py _fallback_db_dir（D:/.db）TS 线有意不继承：拒绝隐式写生产。
+/** T1 #20 · 库、第二份库与备份的**落点解析**（对照老家 db.find_db_path ＋ cwd 哨兵）。
+ *
+ * #726 起落点的唯一真相是配置文件（`src/config.ts` 的 `BILL_CONFIG_DEFAULTS` ＋ `loadBillConfig()`），
+ * 环境变量读取已按「配置的存与生效口径裁定」（#675）全部删除：
+ *   - 库目录：`db.dir` 非空即用它；**空串＝按默认落点**（`loadBillConfig().dataDir`，默认 `~/.ilife/data/`，
+ *     `ILIFE_CONFIG_DIR` 可整体改基座）；
+ *   - 库文件名：`db.name`（默认 `biscuit_accountant.db`）；第二份库：`db.goals`（默认 `goals.json`）；
+ *   - 备份目录：`backup.dir` 非空即按它解（相对当刻工作目录），空串＝**库目录下的 `backups`**；
+ *     备份文件名主体：`backup.stem`（默认 `biscuit_`）。
+ * 与老家的一处有意偏离保留：老家缺 `SKILLS_DB_PATH` 时静默落 `D:/.db`；TS 线改成「配置缺项即按默认落点落」，
+ * 绝不静默写到真实生产库里那个老路径。
+ *
+ * **写库开关已退役（#726）**：`BILL_FORCE_PROD=1` 那个「往非临时目录写库须先被显式打开」的哨兵随 #675 的
+ * 「环境变量全部删掉」一并删除，口径从「不安全就不写」改成**照写**——落点由配置文件唯一决定，
+ * 生产往自己配的目录写库是正常路径，不再是需要 opt-in 的例外。替代护栏是**测试隔离基座**
+ * （`base-link-core` 的 `ILIFE_CONFIG_DIR`：跑在 `node --test` 里却没设它即抛 `CONFIG_TEST_ISOLATION_MISSING`），
+ * 把「忘了配」从静默写真实库变成响亮失败。处置与 #695 四家同形（那四家删掉的是同一族的哨兵）。
+ *
+ * 落点算式与 `src/health.ts` 的体检报告**同源**（体检报的就是这几个落点，两处不许走散）：
+ * 数据目录 `:361`／库文件 `:381`／第二份库 `:443`／产物目录 `:418`／备份目录 `:469`。
+ */
 import { mkdirSync } from 'node:fs';
-import { tmpdir } from 'node:os';
 import { join, resolve } from 'node:path';
-export const DB_FILENAME = 'biscuit_accountant.db';
-export const GOALS_FILENAME = 'goals.json';
+import { BILL_CONFIG_DEFAULTS, loadBillConfig } from '../config.js';
+/** 库文件名（老常量）：默认值表里那一项就是唯一定义地，本常量是它的**具名引用**，不是第二份。 */
+export const DB_FILENAME = BILL_CONFIG_DEFAULTS.db.name;
+/** 第二份库（`goals.json`）文件名：同上，具名引用。 */
+export const GOALS_FILENAME = BILL_CONFIG_DEFAULTS.db.goals;
+/** 库文件名：配置 `db.name` 非空即用它，空串＝`DB_FILENAME`。 */
+export function dbFilename() {
+    const name = loadBillConfig().values.db.name;
+    return name !== '' ? name : DB_FILENAME;
+}
+/** 第二份库文件名：配置 `db.goals` 非空即用它，空串＝`GOALS_FILENAME`。 */
+export function goalsFilename() {
+    const name = loadBillConfig().values.db.goals;
+    return name !== '' ? name : GOALS_FILENAME;
+}
+/** 库目录：配置 `db.dir` 非空即用它，空串＝配置数据目录（默认 `~/.ilife/data/`）。 */
 export function resolveDbDir() {
-    const env = process.env.SKILLS_DB_PATH;
-    if (!env) {
-        throw new Error('[skill-bill] SKILLS_DB_PATH 未设置：拒绝隐式落盘。' +
-            '生产请设置 SKILLS_DB_PATH；测试请传显式 tmp 路径。');
-    }
-    return env;
+    const cfg = loadBillConfig();
+    const configured = cfg.values.db.dir;
+    return configured !== '' ? configured : cfg.dataDir;
 }
-export function resolveDbPath(filename = DB_FILENAME, dir = resolveDbDir()) {
+/** 库文件完整路径（目录不存在即建，`mkdir -p` 语义）。 */
+export function resolveDbPath(filename = dbFilename(), dir = resolveDbDir()) {
     mkdirSync(dir, { recursive: true });
     return join(dir, filename);
 }
+/** 第二份库完整路径（与库同目录，建目录语义同 `resolveDbPath`）。 */
 export function resolveGoalsPath(dir = resolveDbDir()) {
     mkdirSync(dir, { recursive: true });
-    return join(dir, GOALS_FILENAME);
+    return join(dir, goalsFilename());
+}
+/** 备份目录：配置 `backup.dir` 非空即按它解（`resolve()`，相对当刻工作目录），空串＝库目录下的 `backups`。
+ *  「不自动建」是体检那条判据的口径（`health.ts:467`）——本函数只算路径，建目录归调用方。 */
+export function resolveBackupDir(dbDir = resolveDbDir()) {
+    const configured = loadBillConfig().values.backup.dir;
+    return configured !== '' ? resolve(configured) : join(dbDir, 'backups');
 }
-/** 测试隔离守卫：非 tmp 路径写库须 BILL_FORCE_PROD=1（卡路里哨兵语义的饼干版）。 */
-export function assertWritablePath(dbPath) {
-    const forceProd = process.env.BILL_FORCE_PROD === '1';
-    const underTmp = resolve(dbPath).startsWith(resolve(tmpdir()));
-    if (!underTmp && !forceProd) {
-        throw new Error('[skill-bill] 拒绝写入非 tmp 路径 ' + dbPath + '：测试隔离守卫。' +
-            '如确需生产写，请设置 BILL_FORCE_PROD=1（opt-in 可见）。');
-    }
-    if (!underTmp && forceProd) {
-        console.error('[skill-bill] BILL_FORCE_PROD=1: 写入 ' + dbPath);
-    }
+/** 备份文件名：`<backup.stem><stamp>.db`（主体默认 `biscuit_` ⇒ 与老口径 `biscuit_<stamp>.db` 逐字相同）。 */
+export function backupFileName(stamp) {
+    const stem = loadBillConfig().values.backup.stem;
+    return (stem !== '' ? stem : BILL_CONFIG_DEFAULTS.backup.stem) + stamp + '.db';
 }
 //# sourceMappingURL=paths.js.map

package/dist/fetch/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,sDAAsD;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE1C,MAAM,CAAC,MAAM,WAAW,GAAG,uBAAuB,CAAC;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC;AAE3C,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACvC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,yCAAyC;YACvC,qCAAqC,CACxC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,WAAW,EAAE,GAAG,GAAG,YAAY,EAAE;IACxE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAG,GAAG,YAAY,EAAE;IACnD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;AACnC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,4BAA4B,GAAG,MAAM,GAAG,UAAU;YAChD,0CAA0C,CAC7C,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAC;QAC3B,OAAO,CAAC,KAAK,CAAC,qCAAqC,GAAG,MAAM,CAAC,CAAC;IAChE,CAAC;AACH,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/fetch/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEpE,sDAAsD;AACtD,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC,EAAE,CAAC,IAAI,CAAC;AAExD,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,oBAAoB,CAAC,EAAE,CAAC,KAAK,CAAC;AAE5D,gDAAgD;AAChD,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC;IAC7C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;AAC1C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,aAAa;IAC3B,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC;IAC9C,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC;AAC7C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC;IACrC,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC;AACtD,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,aAAa,CAAC,QAAQ,GAAG,UAAU,EAAE,EAAE,GAAG,GAAG,YAAY,EAAE;IACzE,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,gBAAgB,CAAC,GAAG,GAAG,YAAY,EAAE;IACnD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,OAAO,IAAI,CAAC,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC;AACpC,CAAC;AAED;0DAC0D;AAC1D,MAAM,UAAU,gBAAgB,CAAC,KAAK,GAAG,YAAY,EAAE;IACrD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC;IACtD,OAAO,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAC1E,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,IAAI,GAAG,cAAc,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACjD,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;AACjF,CAAC"}

package/dist/goal/commands.d.ts

@@ -0,0 +1,18 @@
+import { viewGoal } from './read.js';
+import { writeGoal } from './write.js';
+export declare const GOAL_COMMANDS: ({
+    kind: "write";
+    key: string;
+    shape: "receipt";
+    title: string;
+    example: string;
+    run: typeof writeGoal;
+} | {
+    kind: "read";
+    key: string;
+    shape: "list";
+    title: string;
+    example: string;
+    run: typeof viewGoal;
+})[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/goal/commands.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,eAAO,MAAM,aAAa;;;;;;;;;;;;;;IAiBQ,CAAC"}

package/dist/goal/commands.js

@@ -0,0 +1,21 @@
+import { viewGoal } from './read.js';
+import { writeGoal } from './write.js';
+export const GOAL_COMMANDS = [
+    {
+        kind: 'write',
+        key: 'bill.goal.write',
+        shape: 'receipt',
+        title: '设定预算与目标',
+        example: 'bill-cmd-read bill.goal.write --params \'{"op":"set-budget","month":"2026-09","amount":3000}\'',
+        run: writeGoal,
+    },
+    {
+        kind: 'read',
+        key: 'bill.goal.query',
+        shape: 'list',
+        title: '预算与目标进度',
+        example: 'bill-cmd-read bill.goal.query --params \'{"op":"budget","month":"2026-09"}\'',
+        run: viewGoal,
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/goal/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/goal/commands.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B;QACE,IAAI,EAAE,OAAO;QACb,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,gGAAgG;QACzG,GAAG,EAAE,SAAS;KACf;IACD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,iBAAiB;QACtB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,8EAA8E;QACvF,GAAG,EAAE,QAAQ;KACd;CAC+B,CAAC"}

package/dist/goal/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 GOAL_DECLARATION: DomainDeclaration;
+//# sourceMappingURL=declaration.d.ts.map

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

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

package/dist/goal/declaration.js

@@ -0,0 +1,71 @@
+export const GOAL_DECLARATION = {
+    id: 'goal',
+    label: '目标',
+    icon: '🎯',
+    order: 4,
+    entries: [
+        {
+            phrase: '设定预算',
+            key: 'bill.goal.write',
+            preset: { op: 'set-budget' },
+            needs: ['amount'],
+            scenes: [
+                {
+                    id: 'goal_set_budget',
+                    title: '设定月度预算',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我设定月度预算(唤醒词:设定预算):\n\n  金  额: ____ (如:3000)\n  月  份: ____ (选填,如:本月 / 8月;默认本月起)\n  分  类: ____ (选填,如:餐饮;不填 = 总预算)\n',
+                    types: ['采集'],
+                },
+            ],
+        },
+        {
+            phrase: '设定目标',
+            key: 'bill.goal.write',
+            preset: { op: 'set-saving' },
+            needs: ['name', 'amount'],
+            scenes: [
+                {
+                    id: 'goal_set_saving',
+                    title: '设定储蓄目标',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我设定储蓄目标(唤醒词:设定目标):\n\n  目  标: ____ (如:换手机 / 旅行基金)\n  金  额: ____ (如:10000)\n  截止日期: ____ (选填,如:12月底)\n',
+                    types: ['采集'],
+                },
+            ],
+        },
+        {
+            phrase: '看预算',
+            key: 'bill.goal.query',
+            preset: { op: 'budget' },
+            scenes: [
+                {
+                    id: 'goal_budget_status',
+                    title: '查看预算执行',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看预算执行情况(唤醒词:看预算):\n\n  月  份: ____ (选填,如:本月 / 8月)\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+        {
+            phrase: '看目标',
+            key: 'bill.goal.query',
+            preset: { op: 'saving' },
+            scenes: [
+                {
+                    id: 'goal_saving_status',
+                    title: '查看目标进度',
+                    status: '',
+                    prompt_template: '请加载「饼干记账」技能,帮我看储蓄目标进度(唤醒词:看目标):\n',
+                    types: ['查看'],
+                },
+            ],
+        },
+    ],
+    subgroups: [
+        { id: 'goal_1', label: '预算', scenes: ['goal_set_budget', 'goal_budget_status'] },
+        { id: 'goal_2', label: '目标', scenes: ['goal_set_saving', 'goal_saving_status'] },
+    ],
+};
+//# sourceMappingURL=declaration.js.map

package/dist/goal/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/goal/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,MAAM;YACd,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE;YAC5B,KAAK,EAAE,CAAC,QAAQ,CAAC;YACjB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,iBAAiB;oBACrB,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,gIAAgI;oBACjJ,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,MAAM;YACd,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE;YAC5B,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;YACzB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,iBAAiB;oBACrB,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,oHAAoH;oBACrI,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,oBAAoB;oBACxB,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,kEAAkE;oBACnF,KAAK,EAAE,CAAC,IAAI,CAAC;iBACd;aACF;SACF;QACD;YACE,MAAM,EAAE,KAAK;YACb,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;YACxB,MAAM,EAAE;gBACN;oBACE,EAAE,EAAE,oBAAoB;oBACxB,KAAK,EAAE,QAAQ;oBACf,MAAM,EAAE,EAAE;oBACV,eAAe,EAAE,mCAAmC;oBACpD,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,iBAAiB,EAAE,oBAAoB,CAAC,EAAE;QAChF,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,EAAE;KACjF;CACF,CAAC"}

package/dist/goal/goalData.d.ts

@@ -0,0 +1,126 @@
+import type { BillDb, BillGoals } from '../fetch/index.js';
+/** 预算表的一行（`goals.json.budgets[]` 的元素）。 */
+export interface GoalBudgetRow {
+    readonly id: number;
+    /** 归属月份 `YYYY-MM`。 */
+    readonly month: string;
+    /** 分类（空串＝全月总预算）。 */
+    readonly category: string;
+    readonly amount: number;
+    readonly created_at: string;
+}
+/** 目标表的一行（`goals.json.savings[]` 的元素）。 */
+export interface GoalSavingRow {
+    readonly id: number;
+    readonly name: string;
+    readonly amount: number;
+    /** 截止日 `YYYY-MM-DD`；`null`＝无截止日期。 */
+    readonly deadline: string | null;
+    readonly created_at: string;
+}
+/** 预算执行的三档状态（老侧 `cli.py:183-188` 的 ok／warn／over）。 */
+export type GoalBudgetStatus = 'ok' | 'warn' | 'over';
+/** 目标进度的四档状态（老侧 `cli.py:303-310` 的 done／na／behind／on_track）。 */
+export type GoalSavingStatus = 'done' | 'na' | 'behind' | 'on_track';
+/** 月底预测的三态（照老侧三态口径：`month_end_proj` 为空＝这一月没有预测可给）。 */
+export interface MonthProjection {
+    /** 日均（过去月＝实际／当月天数）；无预测＝`null`。 */
+    readonly daily_avg: number | null;
+    /** 月底预计（过去月＝实际）；无预测＝`null`。 */
+    readonly month_end_proj: number | null;
+    /** 已过天数（过去月＝当月天数）；无预测＝0。 */
+    readonly days_elapsed: number;
+}
+/** 一条预算的执行读数（老侧 `cmd_budget` 的 `items[]` 逐键）。 */
+export interface BudgetItem {
+    readonly id: number;
+    readonly month: string;
+    readonly category: string;
+    /** 上屏的分类名（空分类写「总预算」，老侧 `cli.py:193`）。 */
+    readonly category_cn: string;
+    readonly amount: number;
+    readonly actual: number;
+    readonly count: number;
+    readonly remaining: number;
+    readonly pct: number;
+    readonly status: GoalBudgetStatus;
+    readonly daily_avg: number | null;
+    readonly month_end_proj: number | null;
+    readonly days_elapsed: number;
+}
+/** 预算执行的合计（老侧 `cli.py:204-212` 两支）。 */
+export interface BudgetTotals {
+    readonly budget: number;
+    readonly actual: number;
+    readonly remaining: number;
+    readonly over_count: number;
+}
+/** 预算执行的一整页事实（出口载荷与页面同一份）。 */
+export interface BudgetExecution {
+    readonly month: string;
+    readonly budgets: readonly BudgetItem[];
+    readonly totals: BudgetTotals;
+    readonly count: number;
+    /** 这一页看了当月几条记录（来源脚注的条数那一格）。 */
+    readonly records: number;
+}
+/** 一个目标的进度读数（老侧 `_saving_progress` 的返回逐键）。 */
+export interface SavingItem {
+    readonly id: number;
+    readonly name: string;
+    readonly amount: number;
+    readonly deadline: string | null;
+    readonly created_at: string;
+    /** 目标期的起始月（创建当月的 `YYYY-MM`）。 */
+    readonly start_month: string;
+    readonly saved: number;
+    readonly remaining: number;
+    readonly pct: number;
+    readonly monthly_avg: number;
+    /** 预计达成月（`YYYY-MM`）；已达成或算不出＝`null`。 */
+    readonly eta: string | null;
+    readonly status: GoalSavingStatus;
+    /** 截止日前达标还需每月存多少；无截止日或已达成＝`null`。 */
+    readonly needed_monthly: number | null;
+}
+/** 目标进度的一整页事实。 */
+export interface SavingProgress {
+    readonly savings: readonly SavingItem[];
+    readonly count: number;
+    readonly done_count: number;
+    /** 这一页看了期内几条记录（来源脚注的条数那一格）。 */
+    readonly records: number;
+}
+/** 预算表：把 `goals.budgets` 的原始行归一成本域认识的形状（认不得的键丢掉，缺的给安全缺省）。 */
+export declare function budgetsOf(goals: BillGoals): GoalBudgetRow[];
+/** 目标表：同上。 */
+export declare function savingsOf(goals: BillGoals): GoalSavingRow[];
+/** 按「同月 ＋ 同类」找那一条预算（空分类＝总预算，也要按空串对；找不到给 `null`，不抛）。 */
+export declare function findBudget(rows: readonly GoalBudgetRow[], month: string, category: string): GoalBudgetRow | null;
+/** 落一条预算（**覆盖＝删旧加新**，老侧 `cli.py:149-153` 逐字同形：新的一条拿新编号）。
+ *  返回写进去的那一行，调用方拿它做回执。 */
+export declare function appendBudget(goals: BillGoals, input: {
+    readonly month: string;
+    readonly category: string;
+    readonly amount: number;
+    readonly createdAt: string;
+}): GoalBudgetRow;
+/** 落一个储蓄目标（老侧 `cmd_set_saving` 只追加，不查重）。 */
+export declare function appendSaving(goals: BillGoals, input: {
+    readonly name: string;
+    readonly amount: number;
+    readonly deadline: string | null;
+    readonly createdAt: string;
+}): GoalSavingRow;
+/** 当月支出与笔数（老侧 `_month_expense`）：分类给了就按 L1 前缀收窄，只数负数记录。 */
+export declare function monthExpense(db: BillDb, month: string, category?: string): {
+    readonly total: number;
+    readonly count: number;
+};
+/** 月底预测（老侧 `_month_projection`）：过去月＝预测即实际、未来月＝无预测、当月＝按已过天数外推。 */
+export declare function monthProjection(month: string, actual: number, now?: Date): MonthProjection;
+/** 预算执行（老侧 `cmd_budget` 整支）：当月预算逐条算执行 ＋ 合计。 */
+export declare function budgetExecution(db: BillDb, goals: BillGoals, month: string, categoryFilter?: string, now?: Date): BudgetExecution;
+/** 目标进度（老侧 `cmd_saving` 整支）：按名字子串收窄，逐条算进度，顺序＝目标表登记序。 */
+export declare function savingProgress(db: BillDb, goals: BillGoals, nameFilter?: string, now?: Date): SavingProgress;
+//# sourceMappingURL=goalData.d.ts.map

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

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