skill-home 0.3.52 → 0.3.54

package/dist/cli/language.js

@@ -0,0 +1,19 @@
+/** #1198 · 出口的语言选择包装：未识别的语言走「预检」那一档（exit 1），不抛原始栈。
+ *
+ *  为什么单立一件：判定住 `base-link-core`（抛 `ConfigError` 是它对外的契约），而「这一档算哪个退出码」
+ *  是出口自己的事。包装放这里，出口件只多一行调用——记账那件正被 #686 棘轮钉着（只许变短）。 */
+import { ConfigError, resolveSkillLanguage } from 'base-link-core';
+import { HOME_CONFIG_STEM, HOME_CONFIG_DEFAULTS, HOME_CONFIG_RETIRED } from '../config.js';
+import { fail } from '../shared/fail.js';
+/** 读配置 ＋ 解语言；未识别的值（argv 或配置文件）＝ exit 1 并原样带出报文（含可用语言）。 */
+export function resolveLanguageOrFail(argv) {
+    try {
+        return resolveSkillLanguage({ stem: HOME_CONFIG_STEM, defaults: HOME_CONFIG_DEFAULTS, retired: HOME_CONFIG_RETIRED, argv });
+    }
+    catch (e) {
+        if (e instanceof ConfigError)
+            fail(1, e.message);
+        throw e;
+    }
+}
+//# sourceMappingURL=language.js.map

package/dist/cli/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","sourceRoot":"","sources":["../../src/cli/language.ts"],"names":[],"mappings":"AAAA;;;uDAGuD;AACvD,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC3F,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,0DAA0D;AAC1D,MAAM,UAAU,qBAAqB,CAAC,IAAuB;IAC3D,IAAI,CAAC;QACH,OAAO,oBAAoB,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,EAAE,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9H,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,WAAW;YAAE,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC"}

package/dist/cli/registry.d.ts

@@ -0,0 +1,4 @@
+import type { HomeCommandSpec } from '../shared/commandSpec.js';
+export declare const REGISTRY: Record<string, HomeCommandSpec>;
+export declare const REGISTRY_KEYS: string[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA+BhE,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAkB,CAAC;AACxE,eAAO,MAAM,aAAa,UAA+B,CAAC"}

package/dist/cli/registry.js

@@ -0,0 +1,32 @@
+import { DATA_COMMANDS } from '../data/index.js';
+import { EXPRESS_COMMANDS } from '../express/index.js';
+import { FAMILY_COMMANDS } from '../family/index.js';
+import { ITEM_COMMANDS } from '../items/index.js';
+import { OUTFIT_COMMANDS } from '../outfit/index.js';
+import { RECEIPT_COMMANDS } from '../receipt/index.js';
+import { SPACE_COMMANDS } from '../space/index.js';
+import { STATS_COMMANDS } from '../stats/index.js';
+const SOURCES = [
+    DATA_COMMANDS,
+    EXPRESS_COMMANDS,
+    FAMILY_COMMANDS,
+    ITEM_COMMANDS,
+    OUTFIT_COMMANDS,
+    RECEIPT_COMMANDS,
+    SPACE_COMMANDS,
+    STATS_COMMANDS,
+];
+/** 汇总各家声明；同键两个人声明即抛（生成期已先拦一道）。 */
+function build(sources) {
+    const out = {};
+    for (const list of sources)
+        for (const spec of list) {
+            if (out[spec.key])
+                throw new Error('同键两处声明（运行期）：' + spec.key);
+            out[spec.key] = spec;
+        }
+    return out;
+}
+export const REGISTRY = build(SOURCES);
+export const REGISTRY_KEYS = Object.keys(REGISTRY).sort();
+//# sourceMappingURL=registry.js.map

package/dist/cli/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,MAAM,OAAO,GAA4C;IACvD,aAAa;IACb,gBAAgB;IAChB,eAAe;IACf,aAAa;IACb,eAAe;IACf,gBAAgB;IAChB,cAAc;IACd,cAAc;CACf,CAAC;AAEF,kCAAkC;AAClC,SAAS,KAAK,CAAC,OAAgD;IAC7D,MAAM,GAAG,GAAoC,EAAE,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACpD,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QACvB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAoC,KAAK,CAAC,OAAO,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,66 @@
+import type { ConfigRecord, ResolvedLanguage } from 'base-link-core';
+/** 配置文件主体名：`<配置目录>/home.yaml`。 */
+export declare const HOME_CONFIG_STEM: "home";
+/** 居家管家那份配置表：键即设置页的行，一层嵌套（子集支持范围见 base-link-core README）。 */
+export declare const HOME_CONFIG_DEFAULTS: {
+    db: {
+        dir: string;
+        name: string;
+    };
+    html: {
+        dir: string;
+    };
+    key: {
+        file: string;
+    };
+    backup: {
+        dir: string;
+    };
+    language: {
+        text: string;
+        format: string;
+    };
+};
+/** **已退休键**（#762 过渡件）：我们自己删过、老配置文件里必然还留着的键的叶子全路径。命中的键跳过校验、
+ *  不进取值、也不会被写回（任何一次保存／重置天然抹掉它）。名单**只许写已经删掉的键**——键还在默认值表里
+ *  就写进清单＝在护栏上开洞，`base-link-core` 收到清单时当场拒。
+ *  `files.help`／`files.lookup`（#793 定稿）删于本票 #794：两个产物文件名主体回到代码常量
+ *  （`src/help/manifest.ts` 的 `HELP_FILE_STEM` 与 `LOOKUP_FILE_STEM`）。
+ *  退出条件：下一个大版本删掉这张清单。 */
+export declare const HOME_CONFIG_RETIRED: readonly string[];
+/** #1198 · 本技能的语言选择入口：读这份配置 ＋ 解语言（text／format 两条链）。
+ *
+ *  唯一实现住 `base-link-core` 的 `config/language`（铁律一）；本件只把「哪份表、哪个主体名」喂进去。
+ *  argv 覆盖 ＞ 配置文件 `language.*` ＞ 调用方偏好 ＞ `zh`；未识别的值抛 `ConfigError`（报文列出可用语言）。
+ *  本轮只接线与校验：不设语言时行为与产物逐字节不变（渲染消费方随词条层 #1200 落地后接）。 */
+export declare function resolveHomeLanguage(options?: {
+    readonly argv?: readonly string[] | undefined;
+    readonly caller?: string | undefined;
+}): ResolvedLanguage;
+/** 取值形状由默认值表派生（同一件事只有一个定义地）。 */
+export type HomeConfigValues = typeof HOME_CONFIG_DEFAULTS;
+/** 读回来的一份配置：文件路径（人话报错要指它）＋数据目录＋取值。 */
+export interface LoadedHomeConfig {
+    readonly path: string;
+    readonly dataDir: string;
+    readonly created: boolean;
+    readonly values: HomeConfigValues;
+}
+/** 读一份配置（文件不存在即按默认值落一份并把配置目录／数据目录建出来）。
+ *
+ *  读回来的 `values` 是**文件里那份 ⊕ 默认值**（文件里写空串则仍是空串＝按默认落点）；
+ *  首次落文件时写下去的是 `writableDefaults()`（可改落点＝绝对路径）。 */
+export declare function loadHomeConfig(): LoadedHomeConfig;
+/** 写一份配置（写出去的是完整一份：没给的项按默认值补齐）。写完清记忆，同进程后续读也现取。 */
+export declare function saveHomeConfig(values: ConfigRecord): {
+    path: string;
+};
+/** 重置为默认（先另存 `<配置目录>/home.yaml.bak`）。 */
+export declare function resetHomeConfig(): {
+    path: string;
+    backupPath: string | null;
+};
+/** 把配置里的相对段串拆成段（`home_manager_html` → `['home_manager_html']`；`\` 与 `/` 都认，
+ *  空段丢弃——Windows 用户手写路径时两种分隔符都会用）。段数由值决定，故「几段」这件事配置形状能表达。 */
+export declare function splitDirSegments(value: string): string[];
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAErE,kCAAkC;AAClC,eAAO,MAAM,gBAAgB,EAAG,MAAe,CAAC;AAEhD,6DAA6D;AAC7D,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAOhC,CAAC;AAEF;;;;;yBAKyB;AACzB,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EAAmC,CAAC;AAErF;;;;sDAIsD;AACtD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAAG,gBAAgB,CAE3J;AACD,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,OAAO,oBAAoB,CAAC;AAoC3D,sCAAsC;AACtC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAQD;;;mDAGmD;AACnD,wBAAgB,cAAc,IAAI,gBAAgB,CAiBjD;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAIrE;AAED,yCAAyC;AACzC,wBAAgB,eAAe,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAI7E;AAED;6DAC6D;AAC7D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/config.js

@@ -0,0 +1,132 @@
+/** 居家管家自己的配置面：那份默认值表 ＋ 读／写／重置三个薄转调。
+ *
+ * 口径出处（「配置的存与生效口径裁定」#675 的解决评论，本票 #695 落地）：**每个技能一份 YAML 配置文件，
+ * 配置文件是唯一真相，环境变量不参与配置**。默认落点 `~/.ilife/home.yaml`（由 `os.homedir()` 派生，
+ * 平台无关，只此一处）；数据目录默认 `~/.ilife/data/`，
+ * 首次读时自动建；「重置为默认」先另存 `<配置目录>/home.yaml.bak`。
+ *
+ * 读写实现（受限 YAML 子集解析、键表与类型校验、备份、建目录）住 `base-link-core` 的 `src/config/`
+ * ——#694 已交付，本件只做「居家管家的那份表 ＋ 转调」，一份实现不抄第二处（结构纪律铁律一）。
+ *
+ * 默认值逐项等于改造前的代码常量（对照读数见 `docs/skills/skill-home/t695-证据.md`）：
+ *   · `db.dir`＝`''`（空串＝按默认落点：数据目录 `~/.ilife/data/`，由取用处算——见 `src/fetch/paths.ts`）；
+ *   · `db.name`＝`home.db`（原 `src/fetch/paths.ts` 的 `DB_FILENAME`）；
+ *   · `html.dir`＝`home_manager_html`（原 `src/help/manifest.ts` 的 `HELP_HTML_DIR_NAME`——家是**一段**目录，
+ *     配置形状是字符串、段间用 `/` 或 `\` 分隔，因为受限子集不收数组；见 `base-link-core/README.md` §支持范围）；
+ *   · `key.file`＝`.master.key`（#794 新增：主密钥文件，绝对优先、否则数据目录下）；
+ *   · `backup.dir`＝`backups`（原 `src/fetch/backup.ts` 的 `BACKUP_DIR_NAME`，老家 `ops.py:26` 同值）。
+ * `files.help`／`files.lookup`（原 `manifest.ts` 的两个主体名）已于 #794 出表，
+ * 文件名回到代码常量（见 `src/help/manifest.ts` 的 `HELP_FILE_STEM`／`LOOKUP_FILE_STEM`）。
+ * 用法上一处约定：**空串＝按默认落点**——`db.dir` 空即用数据目录，由取用处算，
+ * 所以空串不是「没配」，老数据不会看起来丢了。
+ * #794 起这条约定的**两半分头**（照记账 #749 样板）：**读**认空串；**写**（首次落文件／保存／重置）
+ * 把面板上可改的那一格（`db.dir`）落成算出来的绝对路径——见下面 `writableDefaults()` 的注释。
+ */
+import { configPaths, loadConfig, resetConfig, saveConfig, resolveSkillLanguage } from 'base-link-core';
+/** 配置文件主体名：`<配置目录>/home.yaml`。 */
+export const HOME_CONFIG_STEM = 'home';
+/** 居家管家那份配置表：键即设置页的行，一层嵌套（子集支持范围见 base-link-core README）。 */
+export const HOME_CONFIG_DEFAULTS = {
+    db: { dir: '', name: 'home.db' },
+    html: { dir: 'home_manager_html' },
+    key: { file: '.master.key' },
+    backup: { dir: 'backups' },
+    // #1198 语言选择：空串＝跟随调用方，最终回退 zh（判定住 base-link-core 的 config/language）。
+    language: { text: '', format: '' },
+};
+/** **已退休键**（#762 过渡件）：我们自己删过、老配置文件里必然还留着的键的叶子全路径。命中的键跳过校验、
+ *  不进取值、也不会被写回（任何一次保存／重置天然抹掉它）。名单**只许写已经删掉的键**——键还在默认值表里
+ *  就写进清单＝在护栏上开洞，`base-link-core` 收到清单时当场拒。
+ *  `files.help`／`files.lookup`（#793 定稿）删于本票 #794：两个产物文件名主体回到代码常量
+ *  （`src/help/manifest.ts` 的 `HELP_FILE_STEM` 与 `LOOKUP_FILE_STEM`）。
+ *  退出条件：下一个大版本删掉这张清单。 */
+export const HOME_CONFIG_RETIRED = ['files.help', 'files.lookup'];
+/** #1198 · 本技能的语言选择入口：读这份配置 ＋ 解语言（text／format 两条链）。
+ *
+ *  唯一实现住 `base-link-core` 的 `config/language`（铁律一）；本件只把「哪份表、哪个主体名」喂进去。
+ *  argv 覆盖 ＞ 配置文件 `language.*` ＞ 调用方偏好 ＞ `zh`；未识别的值抛 `ConfigError`（报文列出可用语言）。
+ *  本轮只接线与校验：不设语言时行为与产物逐字节不变（渲染消费方随词条层 #1200 落地后接）。 */
+export function resolveHomeLanguage(options = {}) {
+    return resolveSkillLanguage({ stem: HOME_CONFIG_STEM, defaults: HOME_CONFIG_DEFAULTS, retired: HOME_CONFIG_RETIRED, argv: options.argv, caller: options.caller });
+}
+/** 写盘那一份用的默认值表：**可改落点**（`db.dir`）写成算出来的绝对路径（#746 总口径回灌，本票 #794 落地，
+ *  照记账 #749 样板）。
+ *
+ * 为什么写绝对路径：面板上「数据目录」那一格显示的是从配置文件算出的生效值，而空串的语义是「按默认落点」
+ * ——默认落点由 `os.homedir()` 派生，换机器／改用户名就会漂到别处；写死了才是「这一格写的是什么就是什么」。
+ * **代价**（维护者已确认接受）：换机器后 yaml 指向不存在的目录。**只读落点保持相对**（`backup.dir` 与
+ * `key.file` 的值是「库目录／数据目录下的哪个位置」，绝对化＝改语义）。
+ *
+ * 口径的两半：**读**仍认空串（＝按默认落点，老文件一份不用动，也不与 #762 的退休键过渡打架）；
+ * **写**（首次落文件／保存／重置）一律落绝对路径。那一格不自己拼路径——直接用 `configPaths(stem).dataDir`，
+ * 今天算数据目录只有这一处算法（`base-link-core/src/config/dirs.ts`）。 */
+function writableDefaults() {
+    return {
+        ...HOME_CONFIG_DEFAULTS,
+        db: { ...HOME_CONFIG_DEFAULTS.db, dir: configPaths(HOME_CONFIG_STEM).dataDir },
+    };
+}
+/** 写盘前把可改落点那一格的**空白值**去掉：空串＝按默认落点，而写的时候那个落点要落成绝对路径
+ *  （见 `writableDefaults`）——去掉这一格，`base-link-core` 的 `fillDefaults` 自会补上写盘用的默认值。
+ *  组里一个子项都不剩时连组一起去掉（空组写出去解析不回来）。 */
+function withoutBlankEditableDir(values) {
+    const group = values['db'];
+    if (typeof group !== 'object' || group === null || Array.isArray(group))
+        return values;
+    const dir = group['dir'];
+    if (typeof dir !== 'string' || dir !== '')
+        return values;
+    const next = { ...group };
+    delete next['dir'];
+    const out = { ...values };
+    if (Object.keys(next).length === 0)
+        delete out['db'];
+    else
+        out['db'] = next;
+    return out;
+}
+/** 每进程按**配置文件路径**记一份（#915 就地摆正：与五家兄弟件同形，`skill-bill/src/config.ts` 的
+ *  理由逐字相同——「记忆位不绑『进程』而绑『配置文件路径』，是为了不让换目录后的读落到上一份的缓存上」：
+ *  测试逐用例换临时家目录、同一进程里连读几份配置，绑进程就会把第二份读成第一份）。
+ *  「保存即生效」仍由写路径清记忆保证（见 `saveHomeConfig`／`resetHomeConfig`），不靠长连接。 */
+let memo = null;
+/** 读一份配置（文件不存在即按默认值落一份并把配置目录／数据目录建出来）。
+ *
+ *  读回来的 `values` 是**文件里那份 ⊕ 默认值**（文件里写空串则仍是空串＝按默认落点）；
+ *  首次落文件时写下去的是 `writableDefaults()`（可改落点＝绝对路径）。 */
+export function loadHomeConfig() {
+    const file = configPaths(HOME_CONFIG_STEM).configFile;
+    if (memo === null || memo.file !== file) {
+        const loaded = loadConfig(HOME_CONFIG_STEM, writableDefaults(), HOME_CONFIG_RETIRED);
+        // base-link-core 读回来时已经过了「键齐 ＋ 类型对」两道校验（不认识的键、类型不符一律抛），
+        // 故这一处从宽松记录到形状记录的转换是有依据的投影，不是猜测。
+        memo = {
+            file,
+            loaded: {
+                path: loaded.path,
+                dataDir: loaded.dataDir,
+                created: loaded.created,
+                values: loaded.values,
+            },
+        };
+    }
+    return memo.loaded;
+}
+/** 写一份配置（写出去的是完整一份：没给的项按默认值补齐）。写完清记忆，同进程后续读也现取。 */
+export function saveHomeConfig(values) {
+    const r = saveConfig(HOME_CONFIG_STEM, writableDefaults(), withoutBlankEditableDir(values), HOME_CONFIG_RETIRED);
+    memo = null;
+    return r;
+}
+/** 重置为默认（先另存 `<配置目录>/home.yaml.bak`）。 */
+export function resetHomeConfig() {
+    const r = resetConfig(HOME_CONFIG_STEM, writableDefaults(), HOME_CONFIG_RETIRED);
+    memo = null;
+    return r;
+}
+/** 把配置里的相对段串拆成段（`home_manager_html` → `['home_manager_html']`；`\` 与 `/` 都认，
+ *  空段丢弃——Windows 用户手写路径时两种分隔符都会用）。段数由值决定，故「几段」这件事配置形状能表达。 */
+export function splitDirSegments(value) {
+    return value.split(/[\\/]+/).filter((s) => s.length > 0);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/data/commands.d.ts

@@ -0,0 +1,11 @@
+import { runDataSchema } from './schema.js';
+export declare const DATA_COMMANDS: {
+    kind: "read";
+    key: string;
+    shape: string;
+    title: string;
+    surface: "program";
+    run: typeof runDataSchema;
+    example: string;
+}[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/data/commands.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,eAAO,MAAM,aAAa;;;;;;;;GAGY,CAAC"}

package/dist/data/commands.js

@@ -0,0 +1,7 @@
+import { runDataSchema } from './schema.js';
+import { runDataQuery } from './query.js';
+export const DATA_COMMANDS = [
+    { kind: 'read', key: 'home.data.schema', shape: 'resultset', title: '数据目录', surface: 'program', run: runDataSchema, example: 'home-cmd-read home.data.schema' },
+    { kind: 'read', key: 'home.data.query', shape: 'resultset', title: '数据查询', surface: 'program', run: runDataQuery, example: 'home-cmd-read home.data.query --params \'{"queries":[{"from":"items","select":["name"],"orderBy":[{"field":"name","dir":"asc"}]}]}\'' },
+];
+//# sourceMappingURL=commands.js.map

package/dist/data/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/data/commands.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,gCAAgC,EAAE;IAC/J,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,sIAAsI,EAAE;CAC/N,CAAC"}

package/dist/data/index.d.ts

@@ -0,0 +1,3 @@
+export { DATA_COMMANDS } from './commands.js';
+export { DATA_ROUTES } from './routes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/data/index.js

@@ -0,0 +1,4 @@
+// 数据能力门：对外只给声明（跨能力调用只走这道门）。
+export { DATA_COMMANDS } from './commands.js';
+export { DATA_ROUTES } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/data/index.ts"],"names":[],"mappings":"AAAA,4BAA4B;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/data/query.d.ts

@@ -0,0 +1,23 @@
+/** #962 · 居家管家引擎命令的实现：`home.data.query` 的 `run`。
+ *
+ * 干什么：把整份 `--params`（`{ queries: [...] }`）经公共层引擎件
+ * （`executeDataQueries`：查询单解析、目录校验、结果集装配）跑成
+ * `shape: resultset` 的结果集（与请求同序对应；坏项按项拒，好项照常）。
+ * 单表（选字段、条件、排序）＋显式 `on` 两表连接（`join` 长度只许 1，
+ * 结果字段可来自两表；`via` 预定义关联路径只留语法位，出现即按项拒）＋
+ * 单表分组聚合（`groupBy`＋`agg` 成对出现，聚合列按 `as` 起名；`select` 与
+ * `agg` 不可同存，`join` 与 `agg` 组合另票）＋分页续取（`page.size／page.next`，
+ * 行走游标、聚合走偏移）＋批量（`queries` 同序容器，坏项按项拒）。
+ *
+ * 不产任何文件：回数据对象（出口层对数据键走文本态直回 envelope，不进 HTML 交付链）；
+ * 库以只读方式打开（出口层对数据键走只读打开，不建表、不迁移）。
+ * 请求级非法（不是对象／`queries` 不是非空数组）抛 `HomePolicyError`
+ * （出口层归 exit 2，与卡路里 `bad-input` 同档）；单项问题不出错码，
+ * 走项里的 `{ ok: false, error }`（exit 0）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { HomeDb } from '../fetch/db.js';
+export declare function runDataQuery(params: Record<string, unknown>, handle: HomeDb | DatabaseSync): {
+    results: unknown[];
+};
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/data/query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAI7C,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,GAAG,YAAY,GAC5B;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAYxB"}

package/dist/data/query.js

@@ -0,0 +1,19 @@
+import { executeDataQueries, LinkCoreError } from 'base-link-core';
+import { HomePolicyError } from '../fetch/errors.js';
+import { HOME_DATA_TABLES } from './tables.js';
+export function runDataQuery(params, handle) {
+    const db = handle.db ?? handle;
+    let results;
+    try {
+        results = executeDataQueries(db, HOME_DATA_TABLES, params);
+    }
+    catch (e) {
+        if (e instanceof LinkCoreError)
+            throw new HomePolicyError('POLICY_BAD_INPUT', e.message);
+        throw e;
+    }
+    return {
+        results,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/data/query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.js","sourceRoot":"","sources":["../../src/data/query.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,YAAY,CAC1B,MAA+B,EAC/B,MAA6B;IAE7B,MAAM,EAAE,GAAI,MAAiB,CAAC,EAAE,IAAK,MAAuB,CAAC;IAC7D,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,kBAAkB,CAAC,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,aAAa;YAAE,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACzF,MAAM,CAAC,CAAC;IACV,CAAC;IACD,OAAO;QACL,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/data/routes.d.ts

@@ -0,0 +1,3 @@
+import type { HomeRouteSpec } from '../shared/commandSpec.js';
+export declare const DATA_ROUTES: readonly HomeRouteSpec[];
+//# sourceMappingURL=routes.d.ts.map

package/dist/data/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/data/routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,eAAO,MAAM,WAAW,EAAE,SAAS,aAAa,EAAO,CAAC"}

package/dist/data/routes.js

@@ -0,0 +1,2 @@
+export const DATA_ROUTES = [];
+//# sourceMappingURL=routes.js.map

package/dist/data/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/data/routes.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,WAAW,GAA6B,EAAE,CAAC"}

package/dist/data/schema.d.ts

@@ -0,0 +1,15 @@
+/** #962 · 居家管家目录命令的实现：`home.data.schema` 的 `run`。
+ *
+ * 干什么：用允许清单（`./tables.ts`）经公共层目录读取件（`readDataSchema`）
+ * 现读各表的列与类型，装成 `shape: resultset` 的一份结果（单项，`{ ok: true, tables }`）。
+ * 校验用的目录与返回的目录是同一份——后续引擎命令复用同一件做目录校验。
+ *
+ * 不产任何文件：回数据对象（出口层对数据键走文本态直回 envelope，不进 HTML 交付链）；
+ * 不读参数（目录无参数）；库以只读方式打开（出口层对数据键走只读打开，不建表、不迁移）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { HomeDb } from '../fetch/db.js';
+export declare function runDataSchema(_params: Record<string, unknown>, handle: HomeDb | DatabaseSync): {
+    results: unknown[];
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/data/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/data/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,MAAM,EAAE,MAAM,GAAG,YAAY,GAC5B;IAAE,OAAO,EAAE,OAAO,EAAE,CAAA;CAAE,CAcxB"}

package/dist/data/schema.js

@@ -0,0 +1,18 @@
+import { readDataSchema } from 'base-link-core';
+import { HOME_DATA_TABLES } from './tables.js';
+export function runDataSchema(_params, handle) {
+    const db = handle.db ?? handle;
+    const tables = readDataSchema(db, HOME_DATA_TABLES);
+    return {
+        results: [
+            {
+                ok: true,
+                tables: tables.map((t) => ({
+                    table: t.table,
+                    fields: t.fields.map((f) => ({ name: f.name, type: f.type })),
+                })),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/data/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/data/schema.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,UAAU,aAAa,CAC3B,OAAgC,EAChC,MAA6B;IAE7B,MAAM,EAAE,GAAI,MAAiB,CAAC,EAAE,IAAK,MAAuB,CAAC;IAC7D,MAAM,MAAM,GAAG,cAAc,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IACpD,OAAO;QACL,OAAO,EAAE;YACP;gBACE,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACzB,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;iBAC9D,CAAC,CAAC;aACJ;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/data/tables.d.ts

@@ -0,0 +1,48 @@
+/** #962 · 居家管家数据族允许清单（显式声明）：目录命令允许暴露哪些表。
+ *
+ * 出处：`docs/agents/数据族-规格.md` §五——表清单必须显式，不能“库里有什么就给什么”。
+ * 本家库里有 16 张表（见 `src/fetch/db.ts` 的 `openHomeDb` 建表序），是六家里最多的一家。
+ * 允许清单只列其中 15 张；列目录不另存第二份，运行时 `PRAGMA table_info` 现读
+ * （公共层 `readDataSchema`，校验用的目录与返回的目录是同一份）。
+ *
+ * 逐表点名（16 张全到，顺序即建表序）：
+ * - items：物品主体，允许。
+ * - item_locations：物品位置与数量，允许。
+ * - item_tags：物品标签，允许。
+ * - categories：分类树，允许（含内部列 `seed_key`：种子标识，程序面可读，模型不可见；
+ *   按 PRAGMA 现读无法隐列，卡路里样板对 `is_deleted` 等内部列同口径容忍）。
+ * - accounts：**不允许**（见 `HOME_DATA_DENIED`：含 `encrypted_password` 加密口令列，
+ *   配套主密钥文件 `.master.key`；视图层 `listAccounts` 已主动不回该列，数据族无法隐列故整表不暴露）。
+ * - purchase_records：购买记录，允许。
+ * - warranties：保修记录，允许。
+ * - service_events：维修事件，允许。
+ * - certificates：证件记录，允许（视图层对人显示时脱敏为 `number_masked`，
+ *   数据族面只给程序用〈`surface: program`，模型不可见〉，故程序可读原文；口径见本件头）。
+ * - family_members：家人，允许。
+ * - borrow_records：借用记录，允许。
+ * - shopping_items：购物清单，允许。
+ * - stock_thresholds：库存阈值，允许。
+ * - item_events：物品事件审计，允许。
+ * - inventory_records：盘点记录，允许。
+ * - location_nodes：位置节点索引，允许。
+ *
+ * 顺序即目录命令返回的顺序（确定性可比，判据按此逐条断言）。
+ */
+export declare const HOME_DATA_TABLES: readonly ["items", "item_locations", "item_tags", "categories", "purchase_records", "warranties", "service_events", "certificates", "family_members", "borrow_records", "shopping_items", "stock_thresholds", "item_events", "inventory_records", "location_nodes"];
+export type HomeDataTable = (typeof HOME_DATA_TABLES)[number];
+/** 本家不允许暴露的表（逐条登记并留说明；将来各家表清单裁定的样板）。
+ *
+ * - accounts：含 `encrypted_password` 加密口令列，配套主密钥文件 `.master.key`
+ *   （`src/fetch/paths.ts` 的 `keyFileOf`／`src/fetch/masterKey.ts` 的 `loadMasterKey`；
+ *   口令不经调用参数传，只落磁盘一处）。视图层 `listAccounts` 只回
+ *   `platform／username／type` 三列、从不回密文；数据族按 `PRAGMA` 现读无法隐列，
+ *   一旦允许即把密文交给程序消费，故整表不暴露。`accounts` 行的增删改查仍走既有
+ *   票据读写键（视图族／写族），不在本族。
+ */
+export declare const HOME_DATA_DENIED: readonly [{
+    readonly table: "accounts";
+    readonly reason: "含 encrypted_password 加密口令列，配套主密钥文件 .master.key；视图层 listAccounts 已主动不回该列，数据族按 PRAGMA 现读无法隐列，故整表不暴露";
+}];
+/** 本家库内 16 张表的全集（允许 15 ＋ 不允许 1）：判据用它断“逐表点名无遗漏”。 */
+export declare const HOME_DATA_ALL_TABLES: readonly ["items", "item_locations", "item_tags", "categories", "accounts", "purchase_records", "warranties", "service_events", "certificates", "family_members", "borrow_records", "shopping_items", "stock_thresholds", "item_events", "inventory_records", "location_nodes"];
+//# sourceMappingURL=tables.d.ts.map

package/dist/data/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../src/data/tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,gBAAgB,qQAgBnB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;;;EAMnB,CAAC;AAEX,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,iRAiBvB,CAAC"}

package/dist/data/tables.js

@@ -0,0 +1,82 @@
+/** #962 · 居家管家数据族允许清单（显式声明）：目录命令允许暴露哪些表。
+ *
+ * 出处：`docs/agents/数据族-规格.md` §五——表清单必须显式，不能“库里有什么就给什么”。
+ * 本家库里有 16 张表（见 `src/fetch/db.ts` 的 `openHomeDb` 建表序），是六家里最多的一家。
+ * 允许清单只列其中 15 张；列目录不另存第二份，运行时 `PRAGMA table_info` 现读
+ * （公共层 `readDataSchema`，校验用的目录与返回的目录是同一份）。
+ *
+ * 逐表点名（16 张全到，顺序即建表序）：
+ * - items：物品主体，允许。
+ * - item_locations：物品位置与数量，允许。
+ * - item_tags：物品标签，允许。
+ * - categories：分类树，允许（含内部列 `seed_key`：种子标识，程序面可读，模型不可见；
+ *   按 PRAGMA 现读无法隐列，卡路里样板对 `is_deleted` 等内部列同口径容忍）。
+ * - accounts：**不允许**（见 `HOME_DATA_DENIED`：含 `encrypted_password` 加密口令列，
+ *   配套主密钥文件 `.master.key`；视图层 `listAccounts` 已主动不回该列，数据族无法隐列故整表不暴露）。
+ * - purchase_records：购买记录，允许。
+ * - warranties：保修记录，允许。
+ * - service_events：维修事件，允许。
+ * - certificates：证件记录，允许（视图层对人显示时脱敏为 `number_masked`，
+ *   数据族面只给程序用〈`surface: program`，模型不可见〉，故程序可读原文；口径见本件头）。
+ * - family_members：家人，允许。
+ * - borrow_records：借用记录，允许。
+ * - shopping_items：购物清单，允许。
+ * - stock_thresholds：库存阈值，允许。
+ * - item_events：物品事件审计，允许。
+ * - inventory_records：盘点记录，允许。
+ * - location_nodes：位置节点索引，允许。
+ *
+ * 顺序即目录命令返回的顺序（确定性可比，判据按此逐条断言）。
+ */
+export const HOME_DATA_TABLES = [
+    'items',
+    'item_locations',
+    'item_tags',
+    'categories',
+    'purchase_records',
+    'warranties',
+    'service_events',
+    'certificates',
+    'family_members',
+    'borrow_records',
+    'shopping_items',
+    'stock_thresholds',
+    'item_events',
+    'inventory_records',
+    'location_nodes',
+];
+/** 本家不允许暴露的表（逐条登记并留说明；将来各家表清单裁定的样板）。
+ *
+ * - accounts：含 `encrypted_password` 加密口令列，配套主密钥文件 `.master.key`
+ *   （`src/fetch/paths.ts` 的 `keyFileOf`／`src/fetch/masterKey.ts` 的 `loadMasterKey`；
+ *   口令不经调用参数传，只落磁盘一处）。视图层 `listAccounts` 只回
+ *   `platform／username／type` 三列、从不回密文；数据族按 `PRAGMA` 现读无法隐列，
+ *   一旦允许即把密文交给程序消费，故整表不暴露。`accounts` 行的增删改查仍走既有
+ *   票据读写键（视图族／写族），不在本族。
+ */
+export const HOME_DATA_DENIED = [
+    {
+        table: 'accounts',
+        reason: '含 encrypted_password 加密口令列，配套主密钥文件 .master.key；视图层 listAccounts 已主动不回该列，数据族按 PRAGMA 现读无法隐列，故整表不暴露',
+    },
+];
+/** 本家库内 16 张表的全集（允许 15 ＋ 不允许 1）：判据用它断“逐表点名无遗漏”。 */
+export const HOME_DATA_ALL_TABLES = [
+    'items',
+    'item_locations',
+    'item_tags',
+    'categories',
+    'accounts',
+    'purchase_records',
+    'warranties',
+    'service_events',
+    'certificates',
+    'family_members',
+    'borrow_records',
+    'shopping_items',
+    'stock_thresholds',
+    'item_events',
+    'inventory_records',
+    'location_nodes',
+];
+//# sourceMappingURL=tables.js.map

package/dist/data/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../src/data/tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;IACP,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,gBAAgB;CACR,CAAC;AAIX;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B;QACE,KAAK,EAAE,UAAU;QACjB,MAAM,EACJ,mGAAmG;KACtG;CACO,CAAC;AAEX,mDAAmD;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO;IACP,gBAAgB;IAChB,WAAW;IACX,YAAY;IACZ,UAAU;IACV,kBAAkB;IAClB,YAAY;IACZ,gBAAgB;IAChB,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,gBAAgB;IAChB,kBAAkB;IAClB,aAAa;IACb,mBAAmB;IACnB,gBAAgB;CACR,CAAC"}

package/dist/express/commands.d.ts

@@ -0,0 +1,3 @@
+import type { HomeCommandSpec } from '../shared/commandSpec.js';
+export declare const EXPRESS_COMMANDS: readonly HomeCommandSpec[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/express/commands.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE,eAAO,MAAM,gBAAgB,EAAE,SAAS,eAAe,EAGtD,CAAC"}

package/dist/express/commands.js

@@ -0,0 +1,6 @@
+import { runShoppingQuery, runShoppingWrite } from './shopping.js';
+export const EXPRESS_COMMANDS = [
+    { kind: 'read', key: 'home.shopping.query', shape: 'list', title: '查快递', wakeWord: '查快递', example: 'home-cmd-read home.shopping.query --params \'{"kind":"express"}\'', run: runShoppingQuery },
+    { kind: 'write', key: 'home.shopping.write', title: '改购物清单', wakeWord: '改购物清单', example: 'home-cmd-read home.shopping.write --params \'{"op":"list-add","name":"鸡蛋","quantity":2}\'', run: runShoppingWrite },
+];
+//# sourceMappingURL=commands.js.map

package/dist/express/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/express/commands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEnE,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,mEAAmE,EAAE,GAAG,EAAE,gBAAgB,EAAE;IAC/L,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,2FAA2F,EAAE,GAAG,EAAE,gBAAgB,EAAE;CAC9M,CAAC"}

package/dist/express/index.d.ts

@@ -0,0 +1,3 @@
+export { EXPRESS_COMMANDS } from './commands.js';
+export { EXPRESS_ROUTES } from './routes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/express/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}