skill-calorie 0.2.3 → 0.2.4

package/dist/goal/goalHistory.js

@@ -0,0 +1,51 @@
+import { FetchError } from '../fetch/errors.js';
+const round1 = (n) => Math.round(n * 10) / 10;
+export function todayISO() {
+    return new Date().toISOString().slice(0, 10);
+}
+export function shiftISODate(iso, deltaDays) {
+    const t = Date.parse(iso + 'T12:00:00Z');
+    if (Number.isNaN(t))
+        throw new FetchError('日期非法: ' + iso);
+    return new Date(t + deltaDays * 86400000).toISOString().slice(0, 10);
+}
+export function listCompletedGoals(db, days = 30, today = todayISO()) {
+    if (!Number.isInteger(days) || days < 1)
+        throw new FetchError('days 须为正整数: ' + String(days));
+    const end = today;
+    const start = shiftISODate(today, -(days - 1));
+    const goal = db
+        .prepare('SELECT calorie_goal FROM daily_goal WHERE id = 1')
+        .get();
+    const calGoal = goal?.calorie_goal ?? null;
+    const rows = db
+        .prepare('SELECT date, COALESCE(SUM(calories), 0) AS cal FROM food_log WHERE date BETWEEN ? AND ? GROUP BY date')
+        .all(start, end);
+    const actual = new Map(rows.map((r) => [r.date, round1(r.cal)]));
+    const history = [];
+    let completed = 0;
+    let incomplete = 0;
+    for (let i = days - 1; i >= 0; i--) {
+        const d = shiftISODate(today, -i);
+        const cal = actual.get(d);
+        if (cal === undefined) {
+            history.push({ date: d, calorieActual: 0, calorieGoal: calGoal, pct: 0, status: '无记录' });
+            continue;
+        }
+        if (calGoal) {
+            const pct = round1((cal / calGoal) * 100);
+            const status = pct >= 80 && pct <= 120 ? '完成' : '未完成';
+            if (status === '完成')
+                completed += 1;
+            else
+                incomplete += 1;
+            history.push({ date: d, calorieActual: cal, calorieGoal: calGoal, pct, status });
+        }
+        else {
+            incomplete += 1;
+            history.push({ date: d, calorieActual: cal, calorieGoal: calGoal, pct: null, status: '未完成' });
+        }
+    }
+    return { goalHistory: history, completedCount: completed, incompleteCount: incomplete, calorieGoal: calGoal };
+}
+//# sourceMappingURL=goalHistory.js.map

package/dist/goal/goalHistory.js.map

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

package/dist/goal/goalPlate.d.ts

@@ -0,0 +1,24 @@
+/** T8 #27 · 目标分析视图数据（目标分析块 + T4 缺 payload key 的消费侧）。
+ *
+ * 数据源：T4 getNutritionGoal（目标四数+饮水）/ listCompletedGoals（80%-120% 完成带）
+ * + T7 buildDeficitData（缺口周汇总，薄壳不自算）+ T7 buildTrendData（摄入趋势）。
+ * 死规矩 2：T4 缺的 payload key 在本票内补（见 fetch/shapes.ts KEYS 新增 9 键），
+ * 本视图 payload 键即用那 9 键中的 nutrition_goal / goal_history（T11 复用同一命名）。
+ * 无目标行即 missing-data（目标分析无目标不返空页）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { NutritionGoalRow } from './nutritionGoal.js';
+import type { GoalHistory } from './goalHistory.js';
+import type { DeficitData } from '../analysis/deficit.js';
+import type { TrendData } from '../analysis/trend.js';
+export interface GoalView {
+    start: string;
+    end: string;
+    nutrition: NutritionGoalRow;
+    history: GoalHistory;
+    deficit: DeficitData;
+    trend: TrendData;
+    completionPct: number | null;
+}
+export declare function buildGoalView(db: DatabaseSync, start: string, end: string): GoalView;
+//# sourceMappingURL=goalPlate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goalPlate.d.ts","sourceRoot":"","sources":["../../src/goal/goalPlate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAItD,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CAqBpF"}

package/dist/goal/goalPlate.js

@@ -0,0 +1,34 @@
+import { getNutritionGoal } from './nutritionGoal.js';
+import { FetchError } from '../fetch/errors.js';
+import { listCompletedGoals } from './goalHistory.js';
+import { buildDeficitData } from '../analysis/deficit.js';
+import { buildTrendData } from '../analysis/trend.js';
+import { round2 } from '../kcal.js';
+import { CalorieRenderError } from '../render/errors.js';
+export function buildGoalView(db, start, end) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(start) || !/^\d{4}-\d{2}-\d{2}$/.test(end)) {
+        throw new CalorieRenderError('bad-input', '起止日期非法: ' + start + ' ~ ' + end);
+    }
+    if (start > end)
+        throw new CalorieRenderError('bad-input', 'start 不得晚于 end');
+    const nutrition = getNutritionGoal(db);
+    if (!nutrition)
+        throw new CalorieRenderError('missing-data', '未设营养目标（daily_goal#1 缺失，先维护目标）');
+    const history = listCompletedGoals(db, 30, end);
+    // #100 · 缺口/趋势空窗的 FetchError 转 missing-data（与 goalPlates.buildGoalProgress 同约）。
+    let deficit;
+    let trend;
+    try {
+        deficit = buildDeficitData(db, start, end);
+        trend = buildTrendData(db, start, end);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('missing-data', e.message);
+        throw e;
+    }
+    const total = history.completedCount + history.incompleteCount;
+    const completionPct = total ? round2((history.completedCount / total) * 100) : null;
+    return { start, end, nutrition, history, deficit, trend, completionPct };
+}
+//# sourceMappingURL=goalPlate.js.map

package/dist/goal/goalPlate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goalPlate.js","sourceRoot":"","sources":["../../src/goal/goalPlate.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAYzD,MAAM,UAAU,aAAa,CAAC,EAAgB,EAAE,KAAa,EAAE,GAAW;IACxE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,GAAG,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,SAAS;QAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;IAChD,gFAAgF;IAChF,IAAI,OAAoB,CAAC;IACzB,IAAI,KAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,gBAAgB,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;QAC3C,KAAK,GAAG,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU;YAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACrF,MAAM,CAAC,CAAC;IACV,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAC/D,MAAM,aAAa,GAAG,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,cAAc,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpF,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAC3E,CAAC"}

package/dist/goal/goalPlates.d.ts

@@ -0,0 +1,66 @@
+/** T9 #28 · 目标盘数据（render_goal_* 对应：config/recommend/weight/progress/status）。
+ *
+ * 数据源全 T4：getNutritionGoal（目标四数+饮水+体重+截止）/ recommendNutritionGoal /
+ * recommendWaterGoal / getPausedState-pause/resume / listCompletedGoals（80%-120% 完成带）。
+ * 趋势缺口为 T7 薄壳（buildDeficitData/buildTrendData，不自算）；数列唯一源 T5
+ * buildSeries（seriesDelta/seriesCount，不自查 food_log/weight_log）。
+ * 无目标行即 missing-data（目标分析无目标不返空页，与 T8 goal 同约）。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { NutriProfile, NutritionGoalRow, RecommendResult } from './nutritionGoal.js';
+import type { GoalHistory } from './goalHistory.js';
+import type { DeficitData } from '../analysis/deficit.js';
+import type { TrendData } from '../analysis/trend.js';
+export interface GoalConfig {
+    nutrition: NutritionGoalRow;
+    paused: boolean;
+    pausedAt: string | null;
+    diffKcal: number;
+    consistent: boolean;
+}
+/** 目标配置盘（goal_config）：当前四数+饮水+暂停态，自洽 diff 回传。 */
+export declare function buildGoalConfig(db: DatabaseSync): GoalConfig;
+export interface GoalRecommend {
+    profile: NutriProfile;
+    recommend: RecommendResult;
+    water: {
+        weightKg: number;
+        season: '夏' | '冬';
+        mlPerKg: number;
+        recommendedWaterMl: number;
+        oldWaterGoal: number | null;
+        basis: string;
+    };
+}
+/** 目标推荐盘（goal_recommend）：纯算式推荐 + 饮水推荐；档案/体重缺项即 missing-data，不编造默认值（#100）。 */
+export declare function buildGoalRecommend(db: DatabaseSync, profile?: string): GoalRecommend;
+export interface GoalWeight {
+    start: string;
+    end: string;
+    weightGoal: number | null;
+    deadline: string | null;
+    latestKg: number | null;
+    deltaKg: number | null;
+    loggedDays: number;
+}
+/** 体重目标盘（goal_weight）：目标体重+截止 vs T5 series 体重数列净变化。 */
+export declare function buildGoalWeight(db: DatabaseSync, start: string, end: string): GoalWeight;
+export interface GoalProgress {
+    start: string;
+    end: string;
+    nutrition: NutritionGoalRow;
+    history: GoalHistory;
+    deficit: DeficitData;
+    trend: TrendData;
+    completionPct: number | null;
+}
+/** 目标进度盘（goal_progress）：T4 目标+历史完成带 + T7 缺口趋势，completionPct 同 T8 口径。 */
+export declare function buildGoalProgress(db: DatabaseSync, start: string, end: string, historyDays?: number): GoalProgress;
+export interface GoalStatus {
+    paused: boolean;
+    pausedAt: string | null;
+    nutrition: NutritionGoalRow;
+}
+/** 目标状态盘（goal_status）：暂停/重启态，无目标行即 missing-data。 */
+export declare function buildGoalStatus(db: DatabaseSync): GoalStatus;
+//# sourceMappingURL=goalPlates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goalPlates.d.ts","sourceRoot":"","sources":["../../src/goal/goalPlates.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAkBtD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,gBAAgB,CAAC;IAC5B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,iDAAiD;AACjD,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAS5D;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzI;AAID,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,EAAE,OAAO,GAAE,MAAc,GAAG,aAAa,CAU3F;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAyBxF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,SAAK,GAAG,YAAY,CAyB9G;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,oDAAoD;AACpD,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,UAAU,CAK5D"}

package/dist/goal/goalPlates.js

@@ -0,0 +1,114 @@
+import { getNutritionGoal, recommendNutritionGoal, recommendWaterGoal } from './nutritionGoal.js';
+import { getPausedState } from './goalStore.js';
+import { listCompletedGoals } from './goalHistory.js';
+import { buildDeficitData } from '../analysis/deficit.js';
+import { buildTrendData } from '../analysis/trend.js';
+import { buildSeries, seriesCount, seriesDelta } from '../analysis/series.js';
+import { FetchError } from '../fetch/errors.js';
+import { round2 } from '../kcal.js';
+import { CalorieRenderError } from '../render/errors.js';
+function assertDate(s) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(s) || Number.isNaN(Date.parse(s + 'T12:00:00Z'))) {
+        throw new CalorieRenderError('bad-input', '日期非法: ' + String(s));
+    }
+}
+function assertRange(start, end) {
+    assertDate(start);
+    assertDate(end);
+    if (start > end)
+        throw new CalorieRenderError('bad-input', 'start 不得晚于 end');
+}
+/** 目标配置盘（goal_config）：当前四数+饮水+暂停态，自洽 diff 回传。 */
+export function buildGoalConfig(db) {
+    const nutrition = getNutritionGoal(db);
+    if (!nutrition)
+        throw new CalorieRenderError('missing-data', '未设营养目标（daily_goal#1 缺失，先维护目标）');
+    const paused = getPausedState(db);
+    const pro = nutrition.protein_goal ?? 0;
+    const cb = nutrition.carbs_goal ?? 0;
+    const fat = nutrition.fat_goal ?? 0;
+    const diffKcal = pro * 4 + cb * 4 + fat * 9 - nutrition.calorie_goal;
+    return { nutrition, paused: paused.paused, pausedAt: paused.pausedAt, diffKcal, consistent: Math.abs(diffKcal) <= 50 };
+}
+const PROFILES = ['cut', 'maintain', 'bulk'];
+/** 目标推荐盘（goal_recommend）：纯算式推荐 + 饮水推荐；档案/体重缺项即 missing-data，不编造默认值（#100）。 */
+export function buildGoalRecommend(db, profile = 'cut') {
+    if (!PROFILES.includes(profile))
+        throw new CalorieRenderError('bad-input', 'profile 非法（cut/maintain/bulk）: ' + String(profile));
+    const p = profile;
+    const recommend = recommendNutritionGoal(db, { profile: p });
+    // #100 · 空库阻断：缺档案/体重时不返 weightKg=70 等合成数字，明示缺失（exit 4）。
+    if (recommend.missing.length > 0) {
+        throw new CalorieRenderError('missing-data', '目标推荐缺必要输入（' + recommend.missing.join('、') + '缺失，不编造默认值，先补档案与体重记录）');
+    }
+    const water = recommendWaterGoal(db, {});
+    return { profile: p, recommend, water };
+}
+/** 体重目标盘（goal_weight）：目标体重+截止 vs T5 series 体重数列净变化。 */
+export function buildGoalWeight(db, start, end) {
+    assertRange(start, end);
+    const nutrition = getNutritionGoal(db);
+    const series = buildSeries(db, start, end);
+    const loggedDays = seriesCount(series, 'weightKg');
+    if ((nutrition?.weight_goal === null || nutrition?.weight_goal === undefined) && loggedDays === 0) {
+        throw new CalorieRenderError('missing-data', '无体重目标且窗口无体重记录（' + start + ' ~ ' + end + '）');
+    }
+    let latestKg = null;
+    for (let i = series.length - 1; i >= 0; i--) {
+        const v = series[i].weightKg;
+        if (typeof v === 'number') {
+            latestKg = v;
+            break;
+        }
+    }
+    return {
+        start,
+        end,
+        weightGoal: nutrition?.weight_goal ?? null,
+        deadline: nutrition?.goal_deadline ?? null,
+        latestKg,
+        deltaKg: seriesDelta(series, 'weightKg'),
+        loggedDays,
+    };
+}
+/** 目标进度盘（goal_progress）：T4 目标+历史完成带 + T7 缺口趋势，completionPct 同 T8 口径。 */
+export function buildGoalProgress(db, start, end, historyDays = 30) {
+    assertRange(start, end);
+    if (!Number.isInteger(historyDays) || historyDays < 1 || historyDays > 365) {
+        throw new CalorieRenderError('bad-input', 'historyDays 须为 1..365 整数');
+    }
+    const nutrition = getNutritionGoal(db);
+    if (!nutrition)
+        throw new CalorieRenderError('missing-data', '未设营养目标（daily_goal#1 缺失，先维护目标）');
+    let history;
+    try {
+        history = listCompletedGoals(db, historyDays, end);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('missing-data', e.message);
+        throw e;
+    }
+    let deficit;
+    let trend;
+    try {
+        deficit = buildDeficitData(db, start, end);
+        trend = buildTrendData(db, start, end);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('missing-data', e.message);
+        throw e;
+    }
+    const total = history.completedCount + history.incompleteCount;
+    return { start, end, nutrition, history, deficit, trend, completionPct: total ? round2((history.completedCount / total) * 100) : null };
+}
+/** 目标状态盘（goal_status）：暂停/重启态，无目标行即 missing-data。 */
+export function buildGoalStatus(db) {
+    const nutrition = getNutritionGoal(db);
+    if (!nutrition)
+        throw new CalorieRenderError('missing-data', '未设营养目标（daily_goal#1 缺失，先维护目标）');
+    const paused = getPausedState(db);
+    return { paused: paused.paused, pausedAt: paused.pausedAt, nutrition };
+}
+//# sourceMappingURL=goalPlates.js.map

package/dist/goal/goalPlates.js.map

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

package/dist/goal/goalRecommendDoc.d.ts

@@ -0,0 +1,6 @@
+import type { GoalRecommend } from './goalPlates.js';
+/** 目标推荐整页：读数卡 ＋ 算法口径表 ＋ 计算依据（数据层原句归一后逐行）＋ 口径与复制尾。
+ *
+ *  `command`＝可照抄重跑的命令原文（由 `read.ts` 按本次 `profile` 现拼）；`metrics`＝同一份信封读数。 */
+export declare function buildGoalRecommendDoc(g: GoalRecommend, metrics: Record<string, number>, command: string): string;
+//# sourceMappingURL=goalRecommendDoc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"goalRecommendDoc.d.ts","sourceRoot":"","sources":["../../src/goal/goalRecommendDoc.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAwBrD;;4EAE4E;AAC5E,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA2DhH"}

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