skill-chef 0.3.1 → 0.3.2

package/dist/search/commands.d.ts

@@ -0,0 +1,14 @@
+/** 搜索筛选能力的命令声明（权威源：一条命令的事实只住这里）。
+ *
+ * 本能力即 HELP 一级分组「搜索筛选」。一条命令管一摊：
+ *   · `chef.recipe.search`（查询命令）：查看全部／搜索食谱／搜菜／查食材／筛选菜系／筛选食材／
+ *     筛选口味／筛选季节八句唤醒词都进这一条。
+ * 处理函数仍在老分派层（`src/cli/cmd_read.ts`），本票只立声明不搬实现——行为不变，
+ * 实现下沉由搜索筛选域端到端票接走（本文件不动，后续只加 run）。
+ *
+ * 标题与代表唤醒词取 HELP 现成说法，示例照 `packages/skill-chef/SKILL.md` 同命令行照抄。
+ */
+import type { CommandSpec } from '../shared/command-spec.js';
+/** 搜索筛选能力的声明表：恰好导出一个声明数组（生成器只认这一个）。 */
+export declare const SEARCH_COMMANDS: readonly CommandSpec[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/search/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,uCAAuC;AACvC,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EASjD,CAAC"}

package/dist/search/commands.js

@@ -0,0 +1,22 @@
+/** 搜索筛选能力的命令声明（权威源：一条命令的事实只住这里）。
+ *
+ * 本能力即 HELP 一级分组「搜索筛选」。一条命令管一摊：
+ *   · `chef.recipe.search`（查询命令）：查看全部／搜索食谱／搜菜／查食材／筛选菜系／筛选食材／
+ *     筛选口味／筛选季节八句唤醒词都进这一条。
+ * 处理函数仍在老分派层（`src/cli/cmd_read.ts`），本票只立声明不搬实现——行为不变，
+ * 实现下沉由搜索筛选域端到端票接走（本文件不动，后续只加 run）。
+ *
+ * 标题与代表唤醒词取 HELP 现成说法，示例照 `packages/skill-chef/SKILL.md` 同命令行照抄。
+ */
+/** 搜索筛选能力的声明表：恰好导出一个声明数组（生成器只认这一个）。 */
+export const SEARCH_COMMANDS = [
+    {
+        kind: 'read',
+        key: 'chef.recipe.search',
+        shape: 'list',
+        title: '搜索食谱',
+        wakeWord: '搜索食谱',
+        example: 'chef-cmd-read chef.recipe.search --params \'{"q":"排骨"}\'',
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/search/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/search/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,oBAAoB;QACzB,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,0DAA0D;KACpE;CACF,CAAC"}

package/dist/search/index.d.ts

@@ -0,0 +1,9 @@
+/** 搜索筛选能力门：能力对外只经这里（结构纪律铁律一、铁律五）。
+ *
+ * 对外两件：命令声明表与路由声明表。处理函数与取数实现不在这里，
+ * 本票只立声明；外边要用搜索筛选能力的东西，只经这两个名字。
+ */
+export { SEARCH_COMMANDS } from './commands.js';
+export { SEARCH_ROUTES } from './routes.js';
+export { FILTER_KEYS, buildRecipeSearch, filterRecipes, runRecipeSearch, searchRecipes } from './run.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/search/index.js

@@ -0,0 +1,9 @@
+/** 搜索筛选能力门：能力对外只经这里（结构纪律铁律一、铁律五）。
+ *
+ * 对外两件：命令声明表与路由声明表。处理函数与取数实现不在这里，
+ * 本票只立声明；外边要用搜索筛选能力的东西，只经这两个名字。
+ */
+export { SEARCH_COMMANDS } from './commands.js';
+export { SEARCH_ROUTES } from './routes.js';
+export { FILTER_KEYS, buildRecipeSearch, filterRecipes, runRecipeSearch, searchRecipes } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/search/routes.d.ts

@@ -0,0 +1,11 @@
+/** 搜索筛选能力的路由声明（唤醒词命中哪条命令，声明面唯一一处）。
+ *
+ * 八行对应 `src/policy/wakewords.ts` 里搜索筛选八句唤醒词：查看全部／搜索食谱／搜菜／查食材／
+ * 筛选菜系／筛选食材／筛选口味／筛选季节都进 `chef.recipe.search`。`order` 取唤醒词表 1-based
+ * 下标（12–19），只保证跨域可比；全表级顺序由场景表定，本文件不另立顺序。
+ * 命令行写法照 `packages/skill-chef/SKILL.md` 同命令示例（空库可跑的那一行）。
+ */
+import type { RouteDecl } from '../shared/command-spec.js';
+/** 搜索筛选能力的路由声明表：恰好导出一个声明数组。 */
+export declare const SEARCH_ROUTES: readonly RouteDecl[];
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/search/routes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,+BAA+B;AAC/B,eAAO,MAAM,aAAa,EAAE,SAAS,SAAS,EAiD7C,CAAC"}

package/dist/search/routes.js

@@ -0,0 +1,59 @@
+/** 搜索筛选能力的路由声明（唤醒词命中哪条命令，声明面唯一一处）。
+ *
+ * 八行对应 `src/policy/wakewords.ts` 里搜索筛选八句唤醒词：查看全部／搜索食谱／搜菜／查食材／
+ * 筛选菜系／筛选食材／筛选口味／筛选季节都进 `chef.recipe.search`。`order` 取唤醒词表 1-based
+ * 下标（12–19），只保证跨域可比；全表级顺序由场景表定，本文件不另立顺序。
+ * 命令行写法照 `packages/skill-chef/SKILL.md` 同命令示例（空库可跑的那一行）。
+ */
+/** 搜索筛选能力的路由声明表：恰好导出一个声明数组。 */
+export const SEARCH_ROUTES = [
+    {
+        order: 12,
+        wakeWord: '查看全部',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"kind":"all"}\'',
+    },
+    {
+        order: 13,
+        wakeWord: '搜索食谱',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"q":"排骨"}\'',
+    },
+    {
+        order: 14,
+        wakeWord: '搜菜',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"q":"排骨"}\'',
+    },
+    {
+        order: 15,
+        wakeWord: '查食材',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"q":"排骨"}\'',
+    },
+    {
+        order: 16,
+        wakeWord: '筛选菜系',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"filter":"川菜"}\'',
+    },
+    {
+        order: 17,
+        wakeWord: '筛选食材',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"filter":"川菜"}\'',
+    },
+    {
+        order: 18,
+        wakeWord: '筛选口味',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"filter":"川菜"}\'',
+    },
+    {
+        order: 19,
+        wakeWord: '筛选季节',
+        key: 'chef.recipe.search',
+        cli: 'chef-cmd-read chef.recipe.search --params \'{"filter":"川菜"}\'',
+    },
+];
+//# sourceMappingURL=routes.js.map

package/dist/search/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/search/routes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,+BAA+B;AAC/B,MAAM,CAAC,MAAM,aAAa,GAAyB;IACjD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,8DAA8D;KACpE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,0DAA0D;KAChE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,IAAI;QACd,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,0DAA0D;KAChE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,0DAA0D;KAChE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;IACD;QACE,KAAK,EAAE,EAAE;QACT,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,oBAAoB;QACzB,GAAG,EAAE,+DAA+D;KACrE;CACF,CAAC"}

package/dist/search/run.d.ts

@@ -0,0 +1,22 @@
+/** 搜索筛选能力的命令处理（`chef.recipe.search`）＋ 本域独占的取数与视图装配。
+ *
+ * 老分派层（`src/cli/cmd_read.ts`）分支逐字节下沉：只改 import 出处，判定与装配一字不动。
+ * `searchRecipes`／`filterRecipes`（原 `src/fetch/db.ts`）与 `buildRecipeSearch`
+ * （原 `src/render/views.ts`）只被本域调用，按“写不出的留回域目录”搬入本文件；
+ * 旧址改转出（搬迁债务，见 `src/fetch/index.ts`／`src/render/index.ts`）。
+ */
+import type { ChefDb, RecipeRow } from '../fetch/db.js';
+import type { RecipeItem } from '../render/views.js';
+export declare const FILTER_KEYS: readonly ["cuisine", "season", "method", "flavor", "tag", "meal", "cookware", "difficulty", "status", "maxTime", "filter"];
+/** 按关键词搜菜名／简介／食材名（空查询不返全量，直接拦）。原 `src/fetch/db.ts`，本域独占。 */
+export declare function searchRecipes(h: ChefDb, kw: string): RecipeRow[];
+/** 按维度过滤（维度表只读透传）。原 `src/fetch/db.ts`，本域独占。 */
+export declare function filterRecipes(h: ChefDb, filters?: Record<string, unknown>): RecipeRow[];
+export declare function buildRecipeSearch(kind: string, items: RecipeItem[]): {
+    items: RecipeItem[];
+    total: number;
+    kind: string;
+};
+/** 跑 `chef.recipe.search`：关键词搜／查全部／维度过滤三路（list 形）。空结果缺失阻断，不返空冒充。 */
+export declare function runRecipeSearch(handle: ChefDb, params: Record<string, unknown>): unknown;
+//# sourceMappingURL=run.d.ts.map

package/dist/search/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/search/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKrD,eAAO,MAAM,WAAW,4HAA6H,CAAC;AAEtJ,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,CAOhE;AAED,+CAA+C;AAC/C,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,SAAS,EAAE,CAoB3F;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAEzH;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CA4BxF"}

package/dist/search/run.js

@@ -0,0 +1,105 @@
+/** 搜索筛选能力的命令处理（`chef.recipe.search`）＋ 本域独占的取数与视图装配。
+ *
+ * 老分派层（`src/cli/cmd_read.ts`）分支逐字节下沉：只改 import 出处，判定与装配一字不动。
+ * `searchRecipes`／`filterRecipes`（原 `src/fetch/db.ts`）与 `buildRecipeSearch`
+ * （原 `src/render/views.ts`）只被本域调用，按“写不出的留回域目录”搬入本文件；
+ * 旧址改转出（搬迁债务，见 `src/fetch/index.ts`／`src/render/index.ts`）。
+ */
+import { ChefFetchError } from '../fetch/errors.js';
+import { listRecipes, qAll, toRecipe } from '../fetch/db.js';
+import { toRecipeItem } from '../render/views.js';
+import { fail } from '../shared/slots.js';
+// #43 F2 一期限制：FILTER 维度只读（recipe.search 透传过滤），本域独占（旧址 `cmd_read.ts`）。
+export const FILTER_KEYS = ['cuisine', 'season', 'method', 'flavor', 'tag', 'meal', 'cookware', 'difficulty', 'status', 'maxTime', 'filter'];
+/** 按关键词搜菜名／简介／食材名（空查询不返全量，直接拦）。原 `src/fetch/db.ts`，本域独占。 */
+export function searchRecipes(h, kw) {
+    if (typeof kw !== 'string' || kw.trim().length === 0) {
+        throw new ChefFetchError('CHEF_BAD_QUERY', '搜索须给关键词（空查询不返全量）');
+    }
+    const k = '%' + kw.trim() + '%';
+    const rows = qAll(h, "SELECT DISTINCT r.* FROM recipes r LEFT JOIN ingredients i ON i.recipe_id = r.id WHERE (r.name LIKE ? OR r.description LIKE ? OR i.name LIKE ?) AND r.status != '已废弃' ORDER BY r.name ASC", [k, k, k]);
+    return rows.map(toRecipe);
+}
+/** 按维度过滤（维度表只读透传）。原 `src/fetch/db.ts`，本域独占。 */
+export function filterRecipes(h, filters = {}) {
+    const conds = ['1=1'];
+    const params = [];
+    if (filters.status !== undefined && filters.status !== '') {
+        conds.push('r.status = ?');
+        params.push(String(filters.status));
+    }
+    else
+        conds.push("r.status != '已废弃'");
+    if (filters.difficulty !== undefined && filters.difficulty !== '') {
+        conds.push('r.difficulty = ?');
+        params.push(String(filters.difficulty));
+    }
+    if (filters.maxTime !== undefined && filters.maxTime !== '') {
+        conds.push('r.total_time_minutes <= ?');
+        params.push(Number(filters.maxTime));
+    }
+    const exists = (table, col, val) => {
+        conds.push('EXISTS (SELECT 1 FROM ' + table + ' t WHERE t.recipe_id = r.id AND t.' + col + ' = ?)');
+        params.push(String(val));
+    };
+    if (filters.cuisine !== undefined && filters.cuisine !== '')
+        exists('recipe_categories', 'cuisine_type', filters.cuisine);
+    if (filters.season !== undefined && filters.season !== '')
+        exists('recipe_seasons', 'season', filters.season);
+    if (filters.method !== undefined && filters.method !== '')
+        exists('recipe_cooking_methods', 'method', filters.method);
+    if (filters.flavor !== undefined && filters.flavor !== '')
+        exists('recipe_flavors', 'flavor', filters.flavor);
+    if (filters.tag !== undefined && filters.tag !== '')
+        exists('recipe_diet_tags', 'tag', filters.tag);
+    if (filters.meal !== undefined && filters.meal !== '')
+        exists('recipe_meal_types', 'meal_type', filters.meal);
+    if (filters.cookware !== undefined && filters.cookware !== '')
+        exists('cookware', 'name', filters.cookware);
+    const rows = qAll(h, 'SELECT DISTINCT r.* FROM recipes r WHERE ' + conds.join(' AND ') + ' ORDER BY r.name ASC', params);
+    return rows.map(toRecipe);
+}
+// 搜菜/筛菜/全部：items + total + kind。原 `src/render/views.ts`，本域独占。
+export function buildRecipeSearch(kind, items) {
+    return { items, total: items.length, kind };
+}
+/** 跑 `chef.recipe.search`：关键词搜／查全部／维度过滤三路（list 形）。空结果缺失阻断，不返空冒充。 */
+export function runRecipeSearch(handle, params) {
+    const q = params.q;
+    let rows;
+    let kind;
+    if (typeof q === 'string' && q.trim()) {
+        rows = searchRecipes(handle, q.trim());
+        kind = 'search:' + q.trim();
+    }
+    else if (params.kind === 'all') {
+        rows = listRecipes(handle);
+        kind = 'all';
+    }
+    else {
+        const present = FILTER_KEYS.filter((k) => params[k] !== undefined && params[k] !== '');
+        if (!present.length)
+            fail(2, 'search 须给 q、kind=all，或过滤条件（cuisine/season/method/flavor/tag/meal/cookware/difficulty/status/maxTime/filter）');
+        const f = {};
+        for (const k of ['cuisine', 'season', 'method', 'flavor', 'tag', 'meal', 'cookware', 'difficulty', 'status', 'maxTime']) {
+            const v = params[k];
+            if (v !== undefined && v !== '')
+                f[k] = typeof v === 'string' ? v.trim() : v;
+        }
+        // 别名：filter=通用筛选（川菜类示例按菜系走，与 HELP 示例对齐）；time_max/time=最大用时别名。
+        if (f.cuisine === undefined && typeof params.filter === 'string' && params.filter.trim())
+            f.cuisine = params.filter.trim();
+        if (f.maxTime === undefined && params.time_max !== undefined && params.time_max !== '')
+            f.maxTime = params.time_max;
+        if (f.maxTime === undefined && params.time !== undefined && params.time !== '')
+            f.maxTime = params.time;
+        if (!Object.keys(f).length)
+            fail(2, 'search 过滤条件为空（须给 cuisine/season/method/flavor/tag/meal/cookware/difficulty/status/maxTime/filter 之一）');
+        rows = filterRecipes(handle, f);
+        kind = 'filter:' + Object.keys(f).sort().join(',');
+    }
+    if (!rows.length)
+        throw new ChefFetchError('CHEF_EMPTY_RESULT', '搜菜无结果（缺失阻断，不返空冒充）');
+    return buildRecipeSearch(kind, rows.map(toRecipeItem));
+}
+//# sourceMappingURL=run.js.map

package/dist/search/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/search/run.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,sEAAsE;AACtE,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAEtJ,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,EAAU;IACjD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,cAAc,CAAC,gBAAgB,EAAE,kBAAkB,CAAC,CAAC;IACjE,CAAC;IACD,MAAM,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC;IAChC,MAAM,IAAI,GAAG,IAAI,CAA0B,CAAC,EAAE,2LAA2L,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtP,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,UAAmC,EAAE;IAC5E,MAAM,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAAC,CAAC;;QAC1H,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,EAAE,EAAE,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;IAAC,CAAC;IAC/I,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;IAAC,CAAC;IAC/I,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,GAAW,EAAE,GAAY,EAAQ,EAAE;QAChE,KAAK,CAAC,IAAI,CAAC,wBAAwB,GAAG,KAAK,GAAG,oCAAoC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC;QACpG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,CAAC,CAAC;IACF,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,OAAO,KAAK,EAAE;QAAE,MAAM,CAAC,mBAAmB,EAAE,cAAc,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1H,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9G,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,CAAC,wBAAwB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACtH,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,EAAE;QAAE,MAAM,CAAC,gBAAgB,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9G,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,EAAE;QAAE,MAAM,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACpG,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,EAAE;QAAE,MAAM,CAAC,mBAAmB,EAAE,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9G,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,QAAQ,KAAK,EAAE;QAAE,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5G,MAAM,IAAI,GAAG,IAAI,CAA0B,CAAC,EAAE,2CAA2C,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAClJ,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC5B,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,KAAmB;IACjE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,MAA+B;IAC7E,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;IACnB,IAAI,IAAiB,CAAC;IACtB,IAAI,IAAY,CAAC;IACjB,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,GAAG,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACjC,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAC3B,IAAI,GAAG,KAAK,CAAC;IACf,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACvF,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,CAAC,EAAE,6GAA6G,CAAC,CAAC;QAC5I,MAAM,CAAC,GAA4B,EAAE,CAAC;QACtC,KAAK,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAU,EAAE,CAAC;YACjI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;gBAAE,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/E,CAAC;QACD,8DAA8D;QAC9D,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC3H,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,EAAE;YAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC;QACpH,IAAI,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,KAAK,EAAE;YAAE,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC;QACxG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;YAAE,IAAI,CAAC,CAAC,EAAE,sGAAsG,CAAC,CAAC;QAC5I,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAChC,IAAI,GAAG,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,cAAc,CAAC,mBAAmB,EAAE,mBAAmB,CAAC,CAAC;IACrF,OAAO,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/setup/commands.d.ts

@@ -0,0 +1,10 @@
+/** 开始使用能力的命令声明（空）：本域暂无 key。
+ *
+ * 本能力即 HELP 一级分组「开始使用」。`首次使用`短语在 #767 资产里去向为 `tbd`
+ * （不可路由）——运行时无 key、无实现。空数组仍是「恰好一个声明数组」（生成器认它为一域，
+ * 来源域名单里有 `setup`），开始使用端到端票接入 key 时再填。
+ */
+import type { CommandSpec } from '../shared/command-spec.js';
+/** 开始使用能力的声明表：恰好导出一个声明数组（生成器只认这一个；本域暂空）。 */
+export declare const SETUP_COMMANDS: readonly CommandSpec[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,4CAA4C;AAC5C,eAAO,MAAM,cAAc,EAAE,SAAS,WAAW,EAAO,CAAC"}

package/dist/setup/commands.js

@@ -0,0 +1,9 @@
+/** 开始使用能力的命令声明（空）：本域暂无 key。
+ *
+ * 本能力即 HELP 一级分组「开始使用」。`首次使用`短语在 #767 资产里去向为 `tbd`
+ * （不可路由）——运行时无 key、无实现。空数组仍是「恰好一个声明数组」（生成器认它为一域，
+ * 来源域名单里有 `setup`），开始使用端到端票接入 key 时再填。
+ */
+/** 开始使用能力的声明表：恰好导出一个声明数组（生成器只认这一个；本域暂空）。 */
+export const SETUP_COMMANDS = [];
+//# sourceMappingURL=commands.js.map

package/dist/setup/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/setup/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,cAAc,GAA2B,EAAE,CAAC"}

package/dist/setup/index.d.ts

@@ -0,0 +1,8 @@
+/** 开始使用能力门：能力对外只经这里（结构纪律铁律一、铁律五）。
+ *
+ * 对外两件：命令声明表（暂空）与路由声明表（全 tbd）。处理函数与取数实现不在这里，
+ * 本票只立声明；外边要用开始使用能力的东西，只经这两个名字。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+export { SETUP_ROUTES } from './routes.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/setup/index.js

@@ -0,0 +1,8 @@
+/** 开始使用能力门：能力对外只经这里（结构纪律铁律一、铁律五）。
+ *
+ * 对外两件：命令声明表（暂空）与路由声明表（全 tbd）。处理函数与取数实现不在这里，
+ * 本票只立声明；外边要用开始使用能力的东西，只经这两个名字。
+ */
+export { SETUP_COMMANDS } from './commands.js';
+export { SETUP_ROUTES } from './routes.js';
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/setup/routes.d.ts

@@ -0,0 +1,10 @@
+/** 开始使用能力的路由声明（占位）：`首次使用`暂无 key。
+ *
+ * 一行对应 #767 资产里开始使用的一组短语，`key: 'tbd'`、`order: 0`（未入 `WAKE_TABLE`，
+ * 运行时唤醒词未命中）。`cli` 为空串——无可跑命令行，占位等域票接入。
+ * 对账脚本认 `key: 'tbd'` 行为 tbd 行（仅 relation/setup 允许出现）。
+ */
+import type { RouteDecl } from '../shared/command-spec.js';
+/** 开始使用能力的路由声明表：恰好导出一个声明数组（全 tbd，域票接入时填实）。 */
+export declare const SETUP_ROUTES: readonly RouteDecl[];
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/setup/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,8CAA8C;AAC9C,eAAO,MAAM,YAAY,EAAE,SAAS,SAAS,EAO5C,CAAC"}

package/dist/setup/routes.js

@@ -0,0 +1,16 @@
+/** 开始使用能力的路由声明（占位）：`首次使用`暂无 key。
+ *
+ * 一行对应 #767 资产里开始使用的一组短语，`key: 'tbd'`、`order: 0`（未入 `WAKE_TABLE`，
+ * 运行时唤醒词未命中）。`cli` 为空串——无可跑命令行，占位等域票接入。
+ * 对账脚本认 `key: 'tbd'` 行为 tbd 行（仅 relation/setup 允许出现）。
+ */
+/** 开始使用能力的路由声明表：恰好导出一个声明数组（全 tbd，域票接入时填实）。 */
+export const SETUP_ROUTES = [
+    {
+        order: 0,
+        wakeWord: '首次使用',
+        key: 'tbd',
+        cli: '',
+    },
+];
+//# sourceMappingURL=routes.js.map

package/dist/setup/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/setup/routes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,YAAY,GAAyB;IAChD;QACE,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,KAAK;QACV,GAAG,EAAE,EAAE;KACR;CACF,CAAC"}

package/dist/shared/command-spec.d.ts

@@ -0,0 +1,42 @@
+/** 整包命令声明与路由声明的形状唯一定义地（#839 整包落位票统一；票 1 试点时各域本地最小定义，见 t766-形状.md）。
+ *
+ * 为什么住这儿：9 个新域的 `commands.ts`／`routes.ts` 是同一件事实的九处落点，
+ * 行形状（六字段／四字段）若各写一份，迟早走散（铁律二）。本件只定形状、不断言内容：
+ * 内容的权威仍是各域自己的声明数组；生成器（`scripts/gen-cli.mjs`）读源码文本，
+ * 与类型名无关，加本件不影响派生链。历史域两件（票 1 试点）按本票报备的“零改动一字不动”
+ * 保留本地同形类型（形状一致、生成器无感），后续域票顺手摆正，不在本票动它。
+ *
+ * 字段口径照命令登记纪律形状一：会改数据库的命令不写 `shape`（一律回执形，
+ * 那件事实的唯一定义地是生成器合成的 `src/cli/keys.ts`）；查询命令写 `shape`。
+ * 代表唤醒词与可执行示例须是真词真串：代表词进 `src/policy/wakewords.ts` 的那张表即命中同命令，
+ * 示例照 `packages/skill-chef/SKILL.md` 的同命令行照抄。
+ */
+import type { EnvelopeShape } from 'base-link-core';
+/** 一条命令的声明行形状（各域 `commands.ts` 数组元素的形状）。 */
+export type CommandSpec = {
+    readonly kind: 'read';
+    readonly key: string;
+    readonly shape: EnvelopeShape;
+    readonly title: string;
+    readonly wakeWord?: string;
+    readonly example: string;
+} | {
+    readonly kind: 'write';
+    readonly key: string;
+    readonly title: string;
+    readonly wakeWord?: string;
+    readonly example: string;
+};
+/** 一条路由的声明行形状（各域 `routes.ts` 数组元素的形状）。
+ *
+ * `order` 取 `WAKE_TABLE` 的 1-based 下标（跨域可比，全表级顺序由场景表定）；
+ * 暂未入表的短语（`备份`／派生三组／`首次使用`）取 `order: 0` 并在行注释写明待接入，
+ * 对账脚本认 `order: 0` 为 tbd 行（`key: 'tbd'` 或注释点名去向）。
+ */
+export interface RouteDecl {
+    readonly order: number;
+    readonly wakeWord: string;
+    readonly key: string;
+    readonly cli: string;
+}
+//# sourceMappingURL=command-spec.d.ts.map

package/dist/shared/command-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.d.ts","sourceRoot":"","sources":["../../src/shared/command-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GACnB;IACE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB"}

package/dist/shared/command-spec.js

@@ -0,0 +1,15 @@
+/** 整包命令声明与路由声明的形状唯一定义地（#839 整包落位票统一；票 1 试点时各域本地最小定义，见 t766-形状.md）。
+ *
+ * 为什么住这儿：9 个新域的 `commands.ts`／`routes.ts` 是同一件事实的九处落点，
+ * 行形状（六字段／四字段）若各写一份，迟早走散（铁律二）。本件只定形状、不断言内容：
+ * 内容的权威仍是各域自己的声明数组；生成器（`scripts/gen-cli.mjs`）读源码文本，
+ * 与类型名无关，加本件不影响派生链。历史域两件（票 1 试点）按本票报备的“零改动一字不动”
+ * 保留本地同形类型（形状一致、生成器无感），后续域票顺手摆正，不在本票动它。
+ *
+ * 字段口径照命令登记纪律形状一：会改数据库的命令不写 `shape`（一律回执形，
+ * 那件事实的唯一定义地是生成器合成的 `src/cli/keys.ts`）；查询命令写 `shape`。
+ * 代表唤醒词与可执行示例须是真词真串：代表词进 `src/policy/wakewords.ts` 的那张表即命中同命令，
+ * 示例照 `packages/skill-chef/SKILL.md` 的同命令行照抄。
+ */
+export {};
+//# sourceMappingURL=command-spec.js.map

package/dist/shared/command-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.js","sourceRoot":"","sources":["../../src/shared/command-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/shared/slots.d.ts

@@ -0,0 +1,24 @@
+/** 分派层共享的槽位与参数原语（#839 整包落位票下沉）。
+ *
+ * 住这儿的都是**至少两个域的处理函数在调**的东西（具名用户见各函数注释）：
+ * 按“共用位是从第二个用法里长出来的”长在这里。入口（`src/cli/cmd_read.ts`）的同名 local 已删，
+ * 改为引用这里——`fail` 只有一个定义地（`src/cli/config.ts` 既有的那份 local 不动，不在本票范围）。
+ *
+ * 逐字节等价说明：`fail` 仍是 `console.error + process.exit`（直退，不经 catch），
+ * 与搬迁前各分支调的同一函数同一语义；`resolveNameOrId` 的任务口径（缺失走取数错 exit 4）
+ * 与 `policy/needNameOrId` 的口径差异原样保留（注释随函数一起搬下来）。
+ */
+import type { ChefDb } from '../fetch/db.js';
+/** 入口失败原语：stderr 一行＋按码退出（直退，不抛）。用户：入口参数解析／预检＋各域 run。 */
+export declare function fail(code: number, msg: string): never;
+/** 入口备注原语：stderr 一行 NOTE（不退出）。用户：注册表开库提示＋采购分支的库存提示。 */
+export declare function note(msg: string): void;
+export declare function resolveNameOrId(params: Record<string, unknown>): string;
+export declare function resolveRecipeId(handle: ChefDb, params: Record<string, unknown>): string;
+/** 取字符串参数（直给，非串即 undefined）。用户：add／update 两域的 run-write（补丁字段拾取）。 */
+export declare function pickStr(params: Record<string, unknown>, key: string): string | undefined;
+/** 取数字参数（数字或数字串，非数即 undefined）。用户：add／update 两域的 run-write（补丁字段拾取）。 */
+export declare function pickNum(params: Record<string, unknown>, key: string): number | undefined;
+/** 取份数参数（servings 未给即 undefined；非法直退 exit 2）。用户：cook／shopping 两域的 run（份数放大）。 */
+export declare function needServings(params: Record<string, unknown>): number | undefined;
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/shared/slots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAG7C,wDAAwD;AACxD,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAAmE;AAEzH,uDAAuD;AACvD,wBAAgB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAmC;AAI1E,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAOvE;AAID,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAMvF;AAED,oEAAoE;AACpE,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGxF;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxF;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAKhF"}

package/dist/shared/slots.js

@@ -0,0 +1,63 @@
+/** 分派层共享的槽位与参数原语（#839 整包落位票下沉）。
+ *
+ * 住这儿的都是**至少两个域的处理函数在调**的东西（具名用户见各函数注释）：
+ * 按“共用位是从第二个用法里长出来的”长在这里。入口（`src/cli/cmd_read.ts`）的同名 local 已删，
+ * 改为引用这里——`fail` 只有一个定义地（`src/cli/config.ts` 既有的那份 local 不动，不在本票范围）。
+ *
+ * 逐字节等价说明：`fail` 仍是 `console.error + process.exit`（直退，不经 catch），
+ * 与搬迁前各分支调的同一函数同一语义；`resolveNameOrId` 的任务口径（缺失走取数错 exit 4）
+ * 与 `policy/needNameOrId` 的口径差异原样保留（注释随函数一起搬下来）。
+ */
+import { ChefFetchError, ChefPolicyError } from '../fetch/errors.js';
+import { getRecipeDetail } from '../fetch/db.js';
+/** 入口失败原语：stderr 一行＋按码退出（直退，不抛）。用户：入口参数解析／预检＋各域 run。 */
+export function fail(code, msg) { console.error('ERR ' + code + ': ' + msg); process.exit(code); }
+/** 入口备注原语：stderr 一行 NOTE（不退出）。用户：注册表开库提示＋采购分支的库存提示。 */
+export function note(msg) { console.error('NOTE: ' + msg); }
+// 查看定位：nameOrId（任务口径）兼容 name/id（policy needNameOrId 口径）；缺失走取数错 exit4（任务要求缺失抛4）。
+// 用户：view／cook／update／history／add 五个域的 run（定位一道菜）。
+export function resolveNameOrId(params) {
+    const cands = [params.nameOrId, params.name, params.id];
+    for (const c of cands) {
+        if (typeof c === 'string' && c.trim())
+            return c.trim();
+        if (typeof c === 'number' && Number.isFinite(c))
+            return String(c);
+    }
+    throw new ChefFetchError('CHEF_BAD_QUERY', '须给 nameOrId（菜名或 id，缺失阻断）');
+}
+// recipe_id 定位：recipe_id 直给，或 recipe_name 解析；缺失阻断。
+// 用户：add／update 两域的 run-write（加食材／加步骤定位母菜）。
+export function resolveRecipeId(handle, params) {
+    const rid = params.recipe_id;
+    if (typeof rid === 'string' && rid.trim())
+        return rid.trim();
+    const rn = params.recipe_name;
+    if (typeof rn === 'string' && rn.trim())
+        return getRecipeDetail(handle, rn.trim()).recipe.id;
+    throw new ChefPolicyError('POLICY_MISSING_SLOT', '须给 recipe_id（或 recipe_name 解析）');
+}
+/** 取字符串参数（直给，非串即 undefined）。用户：add／update 两域的 run-write（补丁字段拾取）。 */
+export function pickStr(params, key) {
+    const v = params[key];
+    return typeof v === 'string' ? v : undefined;
+}
+/** 取数字参数（数字或数字串，非数即 undefined）。用户：add／update 两域的 run-write（补丁字段拾取）。 */
+export function pickNum(params, key) {
+    const v = params[key];
+    if (typeof v === 'number' && Number.isFinite(v))
+        return v;
+    if (typeof v === 'string' && v.trim() !== '' && Number.isFinite(Number(v.trim())))
+        return Number(v.trim());
+    return undefined;
+}
+/** 取份数参数（servings 未给即 undefined；非法直退 exit 2）。用户：cook／shopping 两域的 run（份数放大）。 */
+export function needServings(params) {
+    if (params.servings === undefined)
+        return undefined;
+    const n = typeof params.servings === 'string' ? Number(params.servings.trim()) : params.servings;
+    if (!Number.isInteger(n) || n <= 0)
+        fail(2, 'servings 须为正整数');
+    return n;
+}
+//# sourceMappingURL=slots.js.map

package/dist/shared/slots.js.map

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

package/dist/shopping/commands.d.ts

@@ -0,0 +1,13 @@
+/** 采购能力的命令声明（权威源：一条命令的事实只住这里）。
+ *
+ * 本能力即 HELP 一级分组「采购」。一条命令管一摊：
+ *   · `chef.shopping.query`（查询命令）：生成清单／排除可选／查清单／清空清单四句唤醒词都进这一条。
+ * 处理函数仍在老分派层（`src/cli/cmd_read.ts`），本票只立声明不搬实现——行为不变，
+ * 实现下沉由小域合并票接走（本文件不动，后续只加 run）。
+ *
+ * 标题与代表唤醒词取 HELP 现成说法，示例照 `packages/skill-chef/SKILL.md` 同命令行照抄。
+ */
+import type { CommandSpec } from '../shared/command-spec.js';
+/** 采购能力的声明表：恰好导出一个声明数组（生成器只认这一个）。 */
+export declare const SHOPPING_COMMANDS: readonly CommandSpec[];
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/shopping/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,qCAAqC;AACrC,eAAO,MAAM,iBAAiB,EAAE,SAAS,WAAW,EASnD,CAAC"}

package/dist/shopping/commands.js

@@ -0,0 +1,21 @@
+/** 采购能力的命令声明（权威源：一条命令的事实只住这里）。
+ *
+ * 本能力即 HELP 一级分组「采购」。一条命令管一摊：
+ *   · `chef.shopping.query`（查询命令）：生成清单／排除可选／查清单／清空清单四句唤醒词都进这一条。
+ * 处理函数仍在老分派层（`src/cli/cmd_read.ts`），本票只立声明不搬实现——行为不变，
+ * 实现下沉由小域合并票接走（本文件不动，后续只加 run）。
+ *
+ * 标题与代表唤醒词取 HELP 现成说法，示例照 `packages/skill-chef/SKILL.md` 同命令行照抄。
+ */
+/** 采购能力的声明表：恰好导出一个声明数组（生成器只认这一个）。 */
+export const SHOPPING_COMMANDS = [
+    {
+        kind: 'read',
+        key: 'chef.shopping.query',
+        shape: 'list',
+        title: '生成清单',
+        wakeWord: '生成清单',
+        example: 'chef-cmd-read chef.shopping.query --params \'{"names":["宫保虾球","鱼香肉丝"]}\'',
+    },
+];
+//# sourceMappingURL=commands.js.map

package/dist/shopping/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/shopping/commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,qCAAqC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAA2B;IACvD;QACE,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,qBAAqB;QAC1B,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,MAAM;QAChB,OAAO,EAAE,0EAA0E;KACpF;CACF,CAAC"}