skill-calorie 0.2.3 → 0.2.5

package/dist/goal/goalRecommendDoc.js

@@ -0,0 +1,107 @@
+/** #589 · 目标推荐整页装配（`calorie.view.goal-recommend`：按档案与目标方向算的推荐值 ＋ 依据）。
+ *
+ * 改前这条命令走 `src/render/html.ts::renderGoalRecommendHtml` 的旧片段——产物以
+ * `<section class="ilife-page" …>` 起头、**没有文档骨架**（#256 锁票探针第 26 条；本票改前复测
+ * 1968 B，读数与前后对照见 `docs/skills/skill-calorie/t589-推荐页-证据.md` §一／§二）。
+ *
+ * 本件照**目标域同族装配**（`docs/skills/skill-calorie/t290-后半-证据.md` 的 `./resultDocs.ts` 那套：
+ * #561 之后的八样＝页框／页头（唤醒词一行 ＋ 类型徽章）／含本页读数的结论句／页内导航／读数卡与表／
+ * 口径行／复制区双按钮）。**不另起第二套**：`cardOf`／`section`／`tailOf` 三个小件从 `./resultDocs.ts`
+ * 引入（同目录内互相用，按 `docs/agents/structure.md` 铁律五「目录内互相用的不算对外面」，该件的对外
+ * 五个名字不变）；本件只写这一页的版式。
+ *
+ * 取数一行不动：本件只吃 `read.ts` 现算的 `GoalRecommend` 与它现算的 `metrics`（票面「推荐数
+ * （cut：TDEE／2064／141／57／246／2471）与当刻一致」）——`metrics` 只进复制载荷，本件不另算一个数。
+ *
+ * 命令名、路由、`WAKE_TABLE`、HELP 卡片归属一字不动（`src/goal/routes.ts:37` 的 exec 行、
+ * `src/triggers/help-lookup.ts:69`、生成物 `src/triggers/routes.generated.ts` 都不碰）。
+ * 旧片段 `renderGoalRecommendHtml` 按票面留在 `src/render/html.ts:262`——**只出台账不删**（台账见证据 §六）。
+ *
+ * 对外一个名字：`buildGoalRecommendDoc`（本件只给这一页；装配面不出目标目录）。
+ */
+import { renderCaliberLine, renderDataTable, renderDisclosure, renderKpiGrid, renderTocBlock } from 'base-paint/blocks';
+import { assembleDocPage } from '../shared/docPage.js';
+import { humanText } from '../render/trendDocs.js';
+import { cardOf, section, tailOf } from './resultDocs.js';
+/** head 的 `<title>`：与目标域各页同值（`DOC_TITLE` 口径冻结对齐 `cli/keys.ts` 的域标题）。 */
+const DOC_TITLE = '卡路里·目标管理';
+/** 本页命令键：与路由层那条 exec 行逐字同键（复制日志第 4 段要能照抄重跑）。 */
+const CMD_KEY = 'calorie.view.goal-recommend';
+/** 数据来源（复制日志第 3 段后半）：本页只读这三处；#561 起正文不再出页脚来源行，日志里仍留得住。 */
+const COPY_SOURCE = '档案＋体重记录＋营养目标表';
+/** 自洽差值带符号（`+3`／`-3` 一眼看得出方向；差 0 不写符号）。 */
+function signed(v) {
+    return (v > 0 ? '+' : '') + v;
+}
+/** 结论句（§五 第 3 行）：句内只摆本页读得出来的数，不编新日期、不编比率。 */
+function recommendSummary(g) {
+    const r = g.recommend;
+    return '结论：' + r.profileLabel + '档按体重 ' + r.basis.weightKg + ' kg 算出每日热量目标 ' + r.calorieGoal
+        + ' 卡（蛋白 ' + r.proteinGoal + ' g／碳水 ' + r.carbsGoal + ' g／脂肪 ' + r.fatGoal + ' g），饮水推荐 '
+        + r.waterGoal + ' ml，宏量折算 ' + r.selfCheck.calculatedKcal + ' 卡、与热量目标差 '
+        + signed(r.selfCheck.diffKcal) + ' 卡。';
+}
+/** 目标推荐整页：读数卡 ＋ 算法口径表 ＋ 计算依据（数据层原句归一后逐行）＋ 口径与复制尾。
+ *
+ *  `command`＝可照抄重跑的命令原文（由 `read.ts` 按本次 `profile` 现拼）；`metrics`＝同一份信封读数。 */
+export function buildGoalRecommendDoc(g, metrics, command) {
+    const r = g.recommend;
+    const sc = r.selfCheck;
+    const consistent = Math.abs(sc.diffKcal) <= 50;
+    const body = [
+        renderTocBlock({ items: [
+                { id: 'sec-readings', text: '读数' },
+                { id: 'sec-calc', text: '算法口径' },
+                { id: 'sec-basis', text: '计算依据' },
+            ] }),
+        section('sec-readings', renderKpiGrid([
+            { label: '方案', value: r.profileLabel, detail: '按档案与目标方向算' },
+            cardOf('热量目标', r.calorieGoal, '卡', '每周 ' + r.weeklyRateKg + ' kg'),
+            cardOf('蛋白目标', r.proteinGoal, 'g'),
+            cardOf('碳水目标', r.carbsGoal, 'g'),
+            cardOf('脂肪目标', r.fatGoal, 'g'),
+            cardOf('饮水目标', r.waterGoal, 'ml', g.water.basis),
+        ])),
+        section('sec-calc', renderDataTable({
+            columns: [
+                { key: 'item', label: '项目' },
+                { key: 'reading', label: '读数', align: 'right' },
+                { key: 'note', label: '说明' },
+            ],
+            rows: [
+                { item: '基础代谢', reading: r.bmr + ' 卡', note: '按身高／体重／年龄／性别算' },
+                { item: '每日基准消耗', reading: r.tdee + ' 卡', note: '基础代谢 × 活动量系数' },
+                { item: '体重', reading: r.basis.weightKg + ' kg', note: '取最新一条体重记录' },
+                { item: '宏量折算热量', reading: sc.calculatedKcal + ' 卡', note: '蛋白×4 ＋ 碳水×4 ＋ 脂肪×9' },
+                { item: '与热量目标差', reading: signed(sc.diffKcal) + ' 卡', note: consistent ? '50 卡以内算自洽' : '超过 50 卡，建议复核' },
+            ],
+            caption: '这一版推荐是按什么算出来的',
+            emptyText: '暂无口径可印',
+        })),
+        /* 计算依据＝数据层 `planReasons` 原句，上屏归一（`humanText`：英文缩写换人话，见 #160）后逐行；
+           同族先例＝`src/goal/receipt.ts:282`（`r.planReasons.map(renderCaliberLine)`）。 */
+        section('sec-basis', renderDisclosure({
+            title: '计算依据',
+            contentHtml: r.planReasons.map((s) => renderCaliberLine(humanText(s))).join(''),
+            open: true,
+        })),
+        tailOf(CMD_KEY, metrics, command, COPY_SOURCE, [
+            '体重取最新一条记录，身高／年龄／性别取自档案；缺一样先补档案与体重记录，再看这一页。',
+            '这一页只算不写：采纳要走「定营养目标」「定饮水目标」这类写命令，写前还会出一张预检页。',
+            '宏量折算按蛋白 4 卡／碳水 4 卡／脂肪 9 卡，差值在 50 卡以内算自洽。',
+        ]),
+    ].join('');
+    return assembleDocPage({
+        docTitle: DOC_TITLE,
+        /* #566 口径：H1 只留页面名；方案名在下面「方案」那张卡上，不在标题里复读。 */
+        title: '🎯 目标推荐',
+        eyebrow: '',
+        subtitle: null,
+        metaLeft: '看目标推荐 · 目标管理',
+        badge: '目标推荐',
+        summary: recommendSummary(g),
+        content: body,
+        charts: false,
+    });
+}
+//# sourceMappingURL=goalRecommendDoc.js.map

package/dist/goal/goalRecommendDoc.js.map

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

package/dist/goal/goalStore.d.ts

@@ -0,0 +1,56 @@
+/** T4 #23 · goal_manager 取数+状态写（对照老家 scripts/goal_manager.py）。
+ *
+ * T3 范式：失败抛 FetchError，不 print（打印归 T11 CLI）。
+ * 一处有意偏离：老家无 daily_goal 行时 UPDATE 0 行后取 row['id'] 直接崩溃；
+ * TS 线先 ensureGoalRow（INSERT OR IGNORE 默认行），崩溃转显式可运行语义。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export interface PausedState {
+    paused: boolean;
+    pausedAt: string | null;
+}
+export interface PauseResult {
+    id: number;
+    updatedAt: string | null;
+    rowsAffected: number;
+    paused: true;
+    note: string;
+    restoreHint: string;
+}
+export interface ResumeResult {
+    id: number;
+    updatedAt: string | null;
+    rowsAffected: number;
+    resumeState: string;
+    resumedAt: string | null;
+}
+/** 单例行兜底（INSERT OR IGNORE，全默认列）。 */
+export declare function ensureGoalRow(db: DatabaseSync): void;
+export declare function getPausedState(db: DatabaseSync): PausedState;
+export declare function pauseAllGoals(db: DatabaseSync): PauseResult;
+export interface SetWeightGoalInput {
+    kg: unknown;
+    deadline?: unknown;
+    startKg?: unknown;
+    startDate?: unknown;
+}
+export interface SetWeightGoalResult {
+    weightGoal: number;
+    deadline: string | null;
+    startKg: number | null;
+    startDate: string | null;
+    updatedAt: string | null;
+    rowsAffected: number;
+    /** #548 · 本次**真进过 SET 列表**的 CLI 参数名（没传的列不进 SQL，故也不在此列）。 */
+    written: string[];
+}
+/** 定体重目标（对照老家 render_goal_weight --live：目标 kg 必填，截止/起点可选；ISO 日期校验）。
+ *
+ * #548 · 未传的列不进 SET 列表（同 #127 给 `calorie.goal.set` 修过的同一类问题）：
+ * 只给 `kg` 时 SQL 里**没有** `goal_deadline`／`start_weight`／`start_date` 三列，三列逐列保持原值——
+ * 改前是无条件四列 SET，没传的列被当成「置空」写进去（`goal_deadline` 一写 null，
+ * 「看即将到期的目标」就 exit 4 缺失阻断）。
+ * 传了空串（`""`／`null`）仍是「清空这一列」：那是 `iso()` 改前就有的口径，本票不改它。 */
+export declare function setWeightGoal(db: DatabaseSync, input: SetWeightGoalInput): SetWeightGoalResult;
+export declare function resumeAllGoals(db: DatabaseSync): ResumeResult;
+//# sourceMappingURL=goalStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goalStore.d.ts","sourceRoot":"","sources":["../../src/goal/goalStore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,IAAI,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAEpD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,WAAW,CAM5D;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,WAAW,CAiB3D;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAaD;;;;;;0DAM0D;AAC1D,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CAgD9F;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,YAAY,CAgB7D"}

package/dist/goal/goalStore.js

@@ -0,0 +1,111 @@
+import { FetchError } from '../fetch/errors.js';
+/** 单例行兜底（INSERT OR IGNORE，全默认列）。 */
+export function ensureGoalRow(db) {
+    db.prepare('INSERT OR IGNORE INTO daily_goal (id) VALUES (1)').run();
+}
+export function getPausedState(db) {
+    const row = db.prepare('SELECT goal_paused, updated_at FROM daily_goal WHERE id = 1').get();
+    if (!row)
+        return { paused: false, pausedAt: null };
+    return { paused: row.goal_paused === 1, pausedAt: row.updated_at };
+}
+export function pauseAllGoals(db) {
+    ensureGoalRow(db);
+    const upd = db
+        .prepare('UPDATE daily_goal SET goal_paused = 1, updated_at = CURRENT_TIMESTAMP WHERE id = 1')
+        .run();
+    const row = db.prepare('SELECT id, updated_at FROM daily_goal WHERE id = 1').get();
+    if (!row)
+        throw new FetchError('pause 后 daily_goal#1 缺失');
+    return {
+        id: row.id,
+        updatedAt: row.updated_at,
+        rowsAffected: Number(upd.changes),
+        paused: true,
+        note: '记录照常，仅目标暂停（完成度显示不计入暂停期）',
+        restoreHint: '说「重启所有目标」即可恢复',
+    };
+}
+/** #548 · 这一列本次传了吗：`Object.hasOwn` 判「键在不在」，`undefined` 一律当作没传。
+ *  用来分开「没传这一列」（保持原值）与「传了空值」（按空值写：`""`／`null` 是清空，那是 `iso()` 原有的口径）。
+ *  `undefined` 一并算没传，是防调用方把「没传」写成「键在、值 undefined」——JSON 参数里根本没有 `undefined`
+ *  （同 `src/fetch/profile.ts:106-119` 的「`undefined` 不算改动」口径）。 */
+function hasOwnInput(obj, key) {
+    return Object.hasOwn(obj, key) && obj[key] !== undefined;
+}
+/** 定体重目标（对照老家 render_goal_weight --live：目标 kg 必填，截止/起点可选；ISO 日期校验）。
+ *
+ * #548 · 未传的列不进 SET 列表（同 #127 给 `calorie.goal.set` 修过的同一类问题）：
+ * 只给 `kg` 时 SQL 里**没有** `goal_deadline`／`start_weight`／`start_date` 三列，三列逐列保持原值——
+ * 改前是无条件四列 SET，没传的列被当成「置空」写进去（`goal_deadline` 一写 null，
+ * 「看即将到期的目标」就 exit 4 缺失阻断）。
+ * 传了空串（`""`／`null`）仍是「清空这一列」：那是 `iso()` 改前就有的口径，本票不改它。 */
+export function setWeightGoal(db, input) {
+    const kg = typeof input.kg === 'number' ? input.kg : Number(String(input.kg ?? '').trim());
+    if (!Number.isFinite(kg) || kg <= 0 || kg > 500)
+        throw new FetchError('体重目标非法：' + JSON.stringify(input.kg) + '（须 0..500 正数 kg）');
+    const iso = (v, field) => {
+        if (v === undefined || v === null || v === '')
+            return null;
+        const s = String(v);
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(s))
+            throw new FetchError(field + ' 非法（须 YYYY-MM-DD）：' + s);
+        return s;
+    };
+    const deadline = iso(input.deadline, 'deadline');
+    const startDate = iso(input.startDate, 'startDate');
+    let startKg = null;
+    if (input.startKg !== undefined && input.startKg !== null && input.startKg !== '') {
+        startKg = typeof input.startKg === 'number' ? input.startKg : Number(String(input.startKg).trim());
+        if (!Number.isFinite(startKg) || startKg <= 0 || startKg > 500)
+            throw new FetchError('起点体重非法：' + JSON.stringify(input.startKg));
+    }
+    ensureGoalRow(db);
+    // #548 · `kg` 恒写；其余三列按「键在不在」挑列（列名 ↔ 参数名一一对应）。
+    const sets = ['weight_goal = ?'];
+    const vals = [kg];
+    const optional = [
+        ['deadline', 'goal_deadline', deadline],
+        ['startKg', 'start_weight', startKg],
+        ['startDate', 'start_date', startDate],
+    ];
+    const written = ['kg'];
+    for (const [param, column, value] of optional) {
+        if (!hasOwnInput(input, param))
+            continue;
+        sets.push(column + ' = ?');
+        vals.push(value);
+        written.push(param);
+    }
+    const upd = db
+        .prepare('UPDATE daily_goal SET ' + sets.join(', ') + ', updated_at = CURRENT_TIMESTAMP WHERE id = 1')
+        .run(...vals);
+    const row = db.prepare('SELECT updated_at, goal_deadline, start_weight, start_date FROM daily_goal WHERE id = 1').get();
+    // 回读兜底：没进 SET 的列报回库里的原值（不把「没传」谎报成「写成了 null」）。
+    return {
+        weightGoal: kg,
+        deadline: hasOwnInput(input, 'deadline') ? deadline : (row?.goal_deadline ?? null),
+        startKg: hasOwnInput(input, 'startKg') ? startKg : (row?.start_weight ?? null),
+        startDate: hasOwnInput(input, 'startDate') ? startDate : (row?.start_date ?? null),
+        updatedAt: row?.updated_at ?? null,
+        rowsAffected: Number(upd.changes),
+        written,
+    };
+}
+export function resumeAllGoals(db) {
+    ensureGoalRow(db);
+    const upd = db
+        .prepare('UPDATE daily_goal SET goal_paused = 0, updated_at = CURRENT_TIMESTAMP WHERE id = 1')
+        .run();
+    const row = db.prepare('SELECT id, updated_at FROM daily_goal WHERE id = 1').get();
+    if (!row)
+        throw new FetchError('resume 后 daily_goal#1 缺失');
+    return {
+        id: row.id,
+        updatedAt: row.updated_at,
+        rowsAffected: Number(upd.changes),
+        resumeState: '正常（未暂停）',
+        resumedAt: row.updated_at,
+    };
+}
+//# sourceMappingURL=goalStore.js.map

package/dist/goal/goalStore.js.map

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

package/dist/goal/goalWeightDoc.d.ts

@@ -0,0 +1,7 @@
+import type { GoalWeight } from './goalPlates.js';
+/** 结论句（一句话；只用入参已有的起止日期，不编新日期）。
+ * #545（并入 #436）：结论块标题已是「结论」，句首不再加「结论：」前缀。 */
+export declare function goalWeightSummary(g: GoalWeight): string;
+/** 体重目标整页（KPI 四格＋数据表＋复制双钮＋结论；`command` 为可照抄重跑的命令原文）。 */
+export declare function buildGoalWeightDoc(g: GoalWeight, command: string): string;
+//# sourceMappingURL=goalWeightDoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goalWeightDoc.d.ts","sourceRoot":"","sources":["../../src/goal/goalWeightDoc.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAmBlD;6CAC6C;AAC7C,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,CAUvD;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAoEzE"}

package/dist/goal/goalWeightDoc.js

@@ -0,0 +1,107 @@
+import { renderDataTable, renderDisclosure, renderKpiGrid } from 'base-paint/blocks';
+import { assembleDocPage } from '../shared/docPage.js';
+import { copyArea, copyLog } from '../shared/copyArea.js';
+import { pairStrip, weightUiCss, windowStrip } from '../weight/weightUi.js';
+import { nums } from '../shared/params.js';
+import { nowStamp } from '../render/receipt.js';
+/** envelope 头（值冻结对齐 `cli/keys.ts`，与各 `*Docs.ts` 同值；标题取目标管理域）。 */
+const DOC_VERSION = '0.1.0';
+const DOC_SKILL = 'calorie';
+const DOC_TITLE = '卡路里·目标管理';
+const CMD_KEY = 'calorie.view.goal-weight';
+const COPY_SOURCE = 'daily_goal＋weight_log（体重目标查看）';
+const fmtKg = (v) => (v === null ? '—' : String(v) + ' kg');
+const fmtSigned = (v) => (v === null ? '—' : (v >= 0 ? '+' : '') + v + ' kg');
+/** 距目标（双方齐备才有数；缺任一即空态，不编造）。 */
+function gapOf(g) {
+    if (g.weightGoal === null || g.latestKg === null)
+        return null;
+    return Math.round((g.latestKg - g.weightGoal) * 100) / 100;
+}
+/** 结论句（一句话；只用入参已有的起止日期，不编新日期）。
+ * #545（并入 #436）：结论块标题已是「结论」，句首不再加「结论：」前缀。 */
+export function goalWeightSummary(g) {
+    const gap = gapOf(g);
+    const head = '目标 ' + fmtKg(g.weightGoal) + ' vs 最新 ' + fmtKg(g.latestKg);
+    const tail = '（本窗 ' + g.start + ' ~ ' + g.end + ' 净变化 ' + fmtSigned(g.deltaKg) + '，有记录 ' + g.loggedDays + ' 天）';
+    if (gap === null) {
+        if (g.weightGoal === null)
+            return head + '，未定体重目标（先「定体重目标」）' + tail + '。';
+        return head + '，本窗无体重记录' + tail + '。';
+    }
+    if (gap <= 0)
+        return head + '，已达标' + tail + '。';
+    return head + '，还差 ' + gap + ' kg' + tail + '。';
+}
+/** 体重目标整页（KPI 四格＋数据表＋复制双钮＋结论；`command` 为可照抄重跑的命令原文）。 */
+export function buildGoalWeightDoc(g, command) {
+    const gap = gapOf(g);
+    const gapValue = gap === null ? '—' : gap <= 0 ? '已达标' : '还差 ' + gap + ' kg';
+    const gapDetail = gap === null
+        ? (g.weightGoal === null ? '未定体重目标' : '本窗无体重记录')
+        : '目标 ' + g.weightGoal + ' kg';
+    const parts = [
+        // #545（#340 打回批第 ⑧ 项）：副标题那句 `·` 串整行撤，三件事各进形状放正文首件——
+        // 目标与最新走两端值（`pairStrip`，中缝沿原串写 `vs`），窗口走窗口条（`windowStrip`，
+        // 日期块＋箭头、窄卡不断散）。`weightUiCss()` 按口径放 parts 第一项（只读引用，不搬家）。
+        weightUiCss(),
+        pairStrip('目标 ' + fmtKg(g.weightGoal), '最新 ' + fmtKg(g.latestKg), 'vs')
+            + windowStrip(g.start, g.end),
+        renderKpiGrid([
+            {
+                label: '体重目标', value: g.weightGoal === null ? '—' : String(g.weightGoal),
+                ...(g.weightGoal === null ? {} : { unit: 'kg' }),
+                detail: g.deadline ? '截止 ' + g.deadline : '无截止日',
+            },
+            {
+                label: '最新体重', value: g.latestKg === null ? '—' : String(g.latestKg),
+                ...(g.latestKg === null ? {} : { unit: 'kg' }),
+                // #545：窗口已住正文首件 `windowStrip()`，卡片 `detail` 不再复读日期区间（窄卡会从日期中间断开）。
+            },
+            { label: '净变化', value: fmtSigned(g.deltaKg), detail: '有记录 ' + g.loggedDays + ' 天' },
+            { label: '距目标', value: gapValue, detail: gapDetail },
+        ])
+    ];
+    parts.push(renderDataTable({
+        columns: [
+            { key: 'period', label: '期别' },
+            { key: 'range', label: '区间' },
+            { key: 'goal', label: '目标', align: 'right' },
+            { key: 'latest', label: '最新', align: 'right' },
+            { key: 'change', label: '净变化', align: 'right' },
+            { key: 'days', label: '记录天', align: 'right' },
+        ],
+        rows: [{
+                period: '本期', range: g.start + ' ~ ' + g.end,
+                goal: fmtKg(g.weightGoal), latest: fmtKg(g.latestKg),
+                change: fmtSigned(g.deltaKg), days: g.loggedDays + ' 天',
+            }],
+        caption: '体重目标',
+        emptyText: '本窗无体重记录',
+    }));
+    const metrics = nums({
+        weightGoal: g.weightGoal, latestKg: g.latestKg, deltaKg: g.deltaKg, loggedDays: g.loggedDays,
+    });
+    const envelope = {
+        version: DOC_VERSION, skill: DOC_SKILL, shape: 'stat', key: CMD_KEY,
+        data: { metrics },
+    };
+    parts.push(copyArea({
+        data: { envelope },
+        log: {
+            envelope,
+            copyLog: copyLog({ command, source: COPY_SOURCE, actionAt: nowStamp(), version: DOC_VERSION }),
+        },
+    }));
+    parts.push(renderDisclosure({ title: '结论', contentHtml: '<p>' + goalWeightSummary(g) + '</p>', open: true }));
+    return assembleDocPage({
+        docTitle: DOC_TITLE,
+        title: '体重目标',
+        eyebrow: 'calorie.view.goal-weight · 目标管理域',
+        // #545：副标题整行撤（目标／最新／窗口已是正文首件形状，副标题再写一遍是冗余）。传空串即整段省略。
+        subtitle: '',
+        content: parts.join(''),
+        charts: false,
+    });
+}
+//# sourceMappingURL=goalWeightDoc.js.map

package/dist/goal/goalWeightDoc.js.map

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

package/dist/goal/index.d.ts

@@ -0,0 +1,13 @@
+/** 目标管理能力对外的门（HELP 场景 06「目标管理」）：只转出命令声明一件。
+ *
+ * #703：门上的读／写命令入口（原 `runGoalView`／`runGoalWrite`）已删——生产一次都不走它们，
+ * 真正分派走生成物 `cli/registry.ts`（`cmd_read.ts`／`write.ts` 查表后直接调声明的 `run`）。
+ *
+ * 对外一件（铁律五「不多于五个」）：
+ *   ① `GOAL_COMMANDS`——命令声明（权威源在 `commands.ts`，这里只是转出）。
+ *
+ * 域内其他件（写前草稿 `set.ts`、预检页 `precheck.ts`、读写入口 `read.ts`／`write.ts`）
+ * **不出这个目录**，故不在这里转出；上级模块仍按原路径导入（搬迁只换住处，调用面不变）。
+ */
+export { GOAL_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/goal/index.js

@@ -0,0 +1,13 @@
+/** 目标管理能力对外的门（HELP 场景 06「目标管理」）：只转出命令声明一件。
+ *
+ * #703：门上的读／写命令入口（原 `runGoalView`／`runGoalWrite`）已删——生产一次都不走它们，
+ * 真正分派走生成物 `cli/registry.ts`（`cmd_read.ts`／`write.ts` 查表后直接调声明的 `run`）。
+ *
+ * 对外一件（铁律五「不多于五个」）：
+ *   ① `GOAL_COMMANDS`——命令声明（权威源在 `commands.ts`，这里只是转出）。
+ *
+ * 域内其他件（写前草稿 `set.ts`、预检页 `precheck.ts`、读写入口 `read.ts`／`write.ts`）
+ * **不出这个目录**，故不在这里转出；上级模块仍按原路径导入（搬迁只换住处，调用面不变）。
+ */
+export { GOAL_COMMANDS } from './commands.js';
+//# sourceMappingURL=index.js.map

package/dist/goal/index.js.map

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

package/dist/goal/nutritionGoal.d.ts

@@ -0,0 +1,115 @@
+/** T4 #23 · nutrition_goal 取数+写数（对照老家 scripts/nutrition_goal.py）。
+ *
+ * 读：getNutritionGoal（无行回 null，老家 Row-or-None 同义）。
+ * 写：setNutritionGoal（4 参必填 + 饮水可选 + 自洽 diff 回传，不 print）。
+ * 算：recommendNutritionGoal / recommendWaterGoal（纯算式对照；activity 系数与
+ * 体重缺省走注入（T5 analysis / T3 weight_log 归属，缺省标记 missing，不静默编造）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export interface NutritionGoalRow {
+    id: number;
+    calorie_goal: number;
+    protein_goal: number | null;
+    carbs_goal: number | null;
+    fat_goal: number | null;
+    weight_goal: number | null;
+    goal_deadline: string | null;
+    water_goal: number | null;
+    updated_at: string | null;
+}
+export interface SetGoalInput {
+    calorie: unknown;
+    protein: unknown;
+    carbs: unknown;
+    fat: unknown;
+    water?: unknown;
+}
+export interface SetGoalResult {
+    calorieGoal: number;
+    proteinGoal: number;
+    carbsGoal: number;
+    fatGoal: number;
+    waterGoal: number | null;
+    diffKcal: number;
+    consistent: boolean;
+}
+export declare function getNutritionGoal(db: DatabaseSync): NutritionGoalRow | null;
+export declare function setNutritionGoal(db: DatabaseSync, input: SetGoalInput): SetGoalResult;
+export declare const NUTRI_PROFILES: {
+    readonly cut: {
+        readonly calorieAdj: -500;
+        readonly proteinGPerKg: 2;
+        readonly waterMlPerKg: 35;
+        readonly fatPct: 0.25;
+    };
+    readonly maintain: {
+        readonly calorieAdj: 0;
+        readonly proteinGPerKg: 1.6;
+        readonly waterMlPerKg: 30;
+        readonly fatPct: 0.3;
+    };
+    readonly bulk: {
+        readonly calorieAdj: 400;
+        readonly proteinGPerKg: 1.8;
+        readonly waterMlPerKg: 30;
+        readonly fatPct: 0.25;
+    };
+};
+export type NutriProfile = keyof typeof NUTRI_PROFILES;
+export declare const NUTRI_PROFILE_LABELS: Record<NutriProfile, string>;
+export declare const NUTRI_PROFILE_WEEKLY_RATE: Record<NutriProfile, number>;
+export interface RecommendInput {
+    profile?: NutriProfile;
+    weightKg?: number | null;
+    heightCm?: number | null;
+    age?: number | null;
+    gender?: string | null;
+    activityFactor?: number | null;
+}
+export interface RecommendResult {
+    profile: NutriProfile;
+    profileLabel: string;
+    tdee: number;
+    bmr: number;
+    calorieGoal: number;
+    proteinGoal: number;
+    carbsGoal: number;
+    fatGoal: number;
+    waterGoal: number;
+    weeklyRateKg: number;
+    basis: {
+        weightKg: number;
+        heightCm: number;
+        age: number;
+        gender: string;
+    };
+    planReasons: string[];
+    missing: string[];
+    selfCheck: {
+        calculatedKcal: number;
+        diffKcal: number;
+    };
+}
+export declare function latestWeightKg(db: DatabaseSync): number | null;
+export declare function recommendNutritionGoal(db: DatabaseSync, opts?: RecommendInput): RecommendResult;
+export interface WaterRecommendInput {
+    weightKg?: number | null;
+    season?: '夏' | '冬' | null;
+    month?: number | null;
+}
+export declare function recommendWaterGoal(db: DatabaseSync, opts?: WaterRecommendInput): {
+    weightKg: number;
+    season: '夏' | '冬';
+    mlPerKg: number;
+    recommendedWaterMl: number;
+    oldWaterGoal: number | null;
+    basis: string;
+};
+export declare function updateWaterGoal(db: DatabaseSync, waterGoal: unknown): {
+    id: number;
+    updatedAt: string | null;
+    rowsAffected: number;
+    oldWaterGoal: number | null;
+    newWaterGoal: number;
+};
+//# sourceMappingURL=nutritionGoal.d.ts.map

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

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