skill-calorie 0.2.3 → 0.2.4

package/dist/analysis/historyStore.d.ts

@@ -0,0 +1,30 @@
+/** T6 #25 · 取数：近日每日摄入聚合 vs 目标（老家 calorie_history.py 同口径，纯取数不打印）。
+ * 目标值经 T4 getNutritionGoal 单源读取。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+export interface DayIntake {
+    date: string;
+    calories: number;
+    protein: number;
+    carbs: number;
+    fat: number;
+    /** 剩余 = 目标 − 当日；目标未设时为 null */
+    remaining: number | null;
+    /** +N卡 / 达标 / 未设目标（老家同文案） */
+    status: string;
+}
+export interface CalorieHistory {
+    days: number;
+    goal: number | null;
+    rows: DayIntake[];
+}
+/** 最近 N 天每日摄入（food_log 按 date 聚合倒序）；空库返回空 rows，调用方阻断提示，不返“正常空数据”。
+ * #559：默认 `now` 经 `todayISO()` 派生（#250 唯一出处），`CALORIE_TODAY` 钉住时窗口跟钉住；
+ * 未设该变量时按包内 UTC 日口径（与 T3/T4 同；与原来按机器本地日历在午夜边界可能差一天，口径以 UTC 日为准）。显式 `now` 照旧优先。 */
+export declare function getCalorieHistory(db: DatabaseSync, days?: number, now?: Date): CalorieHistory;
+/** 本地体重序列（跨技能合并的上游输入之一；food/weight 双序列对齐的 weight 侧）。 */
+export declare function weightSeries(db: DatabaseSync): {
+    date: string;
+    weight_kg: number;
+}[];
+//# sourceMappingURL=historyStore.d.ts.map

package/dist/analysis/historyStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyStore.d.ts","sourceRoot":"","sources":["../../src/analysis/historyStore.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,+BAA+B;IAC/B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB;AAMD;;kFAEkF;AAClF,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,YAAY,EAAE,IAAI,SAAI,EAAE,GAAG,OAAqC,GAAG,cAAc,CAmBtH;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,EAAE,EAAE,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAAE,CAKpF"}

package/dist/analysis/historyStore.js

@@ -0,0 +1,32 @@
+import { getNutritionGoal } from '../goal/nutritionGoal.js';
+import { todayISO } from './utils.js';
+function fmtDate(d) {
+    return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}-${String(d.getDate()).padStart(2, '0')}`;
+}
+/** 最近 N 天每日摄入（food_log 按 date 聚合倒序）；空库返回空 rows，调用方阻断提示，不返“正常空数据”。
+ * #559：默认 `now` 经 `todayISO()` 派生（#250 唯一出处），`CALORIE_TODAY` 钉住时窗口跟钉住；
+ * 未设该变量时按包内 UTC 日口径（与 T3/T4 同；与原来按机器本地日历在午夜边界可能差一天，口径以 UTC 日为准）。显式 `now` 照旧优先。 */
+export function getCalorieHistory(db, days = 7, now = new Date(todayISO() + 'T12:00:00')) {
+    const start = new Date(now);
+    start.setDate(start.getDate() - days);
+    const rows = db
+        .prepare(`SELECT date, SUM(calories) AS calories, SUM(protein) AS protein, SUM(carbs) AS carbs, SUM(fat) AS fat
+       FROM food_log WHERE date >= ? GROUP BY date ORDER BY date DESC`)
+        .all(fmtDate(start));
+    const goal = getNutritionGoal(db)?.calorie_goal ?? null;
+    return {
+        days,
+        goal,
+        rows: rows.map((r) => {
+            if (goal === null)
+                return { ...r, remaining: null, status: '未设目标' };
+            const remaining = Math.round(goal - r.calories);
+            return { ...r, remaining, status: remaining !== 0 ? `${remaining >= 0 ? '+' : ''}${remaining}卡` : '达标' };
+        }),
+    };
+}
+/** 本地体重序列（跨技能合并的上游输入之一；food/weight 双序列对齐的 weight 侧）。 */
+export function weightSeries(db) {
+    return db.prepare('SELECT date, weight_kg FROM weight_log ORDER BY date').all();
+}
+//# sourceMappingURL=historyStore.js.map

package/dist/analysis/historyStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"historyStore.js","sourceRoot":"","sources":["../../src/analysis/historyStore.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAoBtC,SAAS,OAAO,CAAC,CAAO;IACtB,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACnH,CAAC;AAED;;kFAEkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,EAAgB,EAAE,IAAI,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,GAAG,WAAW,CAAC;IACpG,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACtC,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;sEACgE,CACjE;SACA,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAsF,CAAC;IAC5G,MAAM,IAAI,GAAG,gBAAgB,CAAC,EAAE,CAAC,EAAE,YAAY,IAAI,IAAI,CAAC;IACxD,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACnB,IAAI,IAAI,KAAK,IAAI;gBAAE,OAAO,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACpE,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YAChD,OAAO,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3G,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,EAAgB;IAC3C,OAAO,EAAE,CAAC,OAAO,CAAC,sDAAsD,CAAC,CAAC,GAAG,EAG1E,CAAC;AACN,CAAC"}

package/dist/analysis/index.d.ts

@@ -0,0 +1,23 @@
+/** 分析能力对外的门（HELP 场景 10「分析」）：命令分派两件 ＋ 命令声明。
+ *
+ * 对外三件（铁律五「不多于五个」）：
+ *   ① `ANALYSIS_COMMANDS`——命令声明（权威源在 `commands.ts`，这里只是转出）；
+ *   ② `runAnalysisView(key, params, db)`——读命令入口（查不到分析键即抛，不当静默兜底）；
+ *   ③ `runAnalysisWrite(key, params, db)`——写命令入口（同上）。
+ *
+ * 本场景 13 键**全是读命令**（旧链里「定时复盘／训记／营养表／落地」那些划出去不做的词，
+ * 逐字理由住 `routes.ts` 的非执行记录）。写入口照 `src/weight/` 的同款形状保留：
+ * 能力对外形状一致，且日后真出写键时只改 `commands.ts`，门与分派层不动。
+ *
+ * 域内其他件（算式与取数 `series.ts`／`trend.ts`／`deficit.ts`／`dashboard.ts`／`cross.ts`／
+ * `simulate*.ts`／`anomaly/`／`diet.ts`／`exercise*.ts`／`review.ts`／`utils.ts` 等）**不出这个目录**，
+ * 故不在这里转出：它们由 `render/` 侧的视图层直接消费，导入面照旧。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { ViewOut, WriteOut } from '../shared/commandSpec.js';
+export { ANALYSIS_COMMANDS } from './commands.js';
+/** 读命令入口：命中即走它的处理函数；键不属分析（或其实是写键）即抛——**不猜**。 */
+export declare function runAnalysisView(key: string, params: Record<string, unknown>, db: DatabaseSync): ViewOut;
+/** 写命令入口：同上（本场景今天无写键，任何键都抛）。 */
+export declare function runAnalysisWrite(key: string, params: Record<string, unknown>, db: DatabaseSync): WriteOut;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAe,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAG/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQlD,gDAAgD;AAChD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAMvG;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,GAAG,QAAQ,CAMzG"}

package/dist/analysis/index.js

@@ -0,0 +1,23 @@
+import { CalorieRenderError } from '../render/errors.js';
+import { ANALYSIS_COMMANDS } from './commands.js';
+export { ANALYSIS_COMMANDS } from './commands.js';
+/** 声明数组按**声明的类型**收进查表：本场景全是读命令，若让它保持字面量窄化，
+ *  `spec.kind !== 'write'` 会因两个字面量类型无交集而被 `tsc` 判错（TS2367）。 */
+const BY_KEY = new Map(ANALYSIS_COMMANDS.map((c) => [c.key, c]));
+/** 读命令入口：命中即走它的处理函数；键不属分析（或其实是写键）即抛——**不猜**。 */
+export function runAnalysisView(key, params, db) {
+    const spec = BY_KEY.get(key);
+    if (!spec || spec.kind !== 'read') {
+        throw new CalorieRenderError('bad-input', '不是分析的读命令：' + key);
+    }
+    return spec.run(params, db);
+}
+/** 写命令入口：同上（本场景今天无写键，任何键都抛）。 */
+export function runAnalysisWrite(key, params, db) {
+    const spec = BY_KEY.get(key);
+    if (!spec || spec.kind !== 'write') {
+        throw new CalorieRenderError('bad-input', '不是分析的写命令：' + key);
+    }
+    return spec.run(params, db);
+}
+//# sourceMappingURL=index.js.map

package/dist/analysis/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analysis/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;+DAC+D;AAC/D,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAyB,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAChE,CAAC;AAEF,gDAAgD;AAChD,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,MAA+B,EAAE,EAAgB;IAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,MAA+B,EAAE,EAAgB;IAC7F,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,WAAW,GAAG,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/analysis/multiTrend.d.ts

@@ -0,0 +1,67 @@
+/** 多指标趋势取数（子功能＝整体趋势，HELP 下一级；#376 立最小形态，#378 同命令铺开）。
+ *
+ * 口径：数列唯一源 `buildSeries`，不自造 SUM；目标线取库内现值（热量目标走
+ * `daily_goal.calorie_goal`，体重目标走 `daily_goal.weight_goal`，缺行即 null），
+ * 不在这里编数。
+ * 铺开决策（#378，对抗后定）：单命令多形态——`group` 收 `comprehensive`／`g1–g11`
+ *（老链 trend --group 语义，取数仍全指标同图，只作标签与窗口区分，不丢数据），
+ * `compare` 收 `target`／`monthly`／`quarterly`／`yearly`（窗口 90d／60d／180d／730d
+ * 由调用方按冻结表给，周期分段可视化是显示层遗留，不在本票硬塞第二个命令）。
+ * null 口径不变：空窗 `missing-data`，未知值 `bad-input`。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+/** 单日多指标行（≤8 字段）。 */
+export interface MultiTrendDay {
+    readonly date: string;
+    readonly calories: number | null;
+    readonly weightKg: number | null;
+    readonly exerciseKcal: number | null;
+    readonly protein: number | null;
+    readonly deficit: number | null;
+    readonly waterMl: number | null;
+}
+/** 汇总（缺失以 null 明示，投影时由 `nums` 丢弃）。
+ *  #160 返工：本件破例到 9 字段——`compliantDays` 必须与 `complianceRate` **一起**投影。
+ *  比例是 `round2` 过的（730 天窗 11/730 → 0.02），页面拿比例乘窗口天数反解就会算出
+ *  「达标 15 天」，而同页 730 行明细里只有 11 行有热量且全达标 ⇒ 自相矛盾。
+ *  整数天数由本层给出（它就是上面 filter 的计数，不是回算），页面一律直读、不再反解。 */
+export interface MultiTrendSummary {
+    readonly days: number;
+    readonly loggedDays: number;
+    readonly avgCalorie: number | null;
+    readonly weightChange: number | null;
+    readonly avgExercise: number | null;
+    readonly avgProtein: number | null;
+    readonly avgDeficit: number | null;
+    readonly complianceRate: number | null;
+    /** 窗口内达标天数的**整数**（达标＝单日 ≤ 目标×1.05）；无目标即 null（不编数）。 */
+    readonly compliantDays: number | null;
+}
+/** 对照目标（≤8 字段；热量／体重目标缺行即 null，不编数）。 */
+export interface MultiTrendTarget {
+    readonly calorieGoal: number | null;
+    readonly weightGoal: number | null;
+}
+/** 多指标趋势视图（≤8 字段）。 */
+export interface MultiTrendView {
+    readonly start: string;
+    readonly end: string;
+    readonly window: string;
+    readonly group: string;
+    readonly compare: string;
+    readonly days: readonly MultiTrendDay[];
+    readonly summary: MultiTrendSummary;
+    readonly target: MultiTrendTarget;
+}
+/** 取数入参（≤8 字段）。 */
+export interface MultiTrendInput {
+    readonly window?: string;
+    readonly group?: string;
+    readonly compare?: string;
+    readonly today?: string;
+    readonly start?: string;
+    readonly end?: string;
+}
+/** ① 多指标趋势取数：窗口＋目标对照（#376 最小形态）。 */
+export declare function buildMultiTrendView(db: DatabaseSync, input: MultiTrendInput): MultiTrendView;
+//# sourceMappingURL=multiTrend.d.ts.map

package/dist/analysis/multiTrend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiTrend.d.ts","sourceRoot":"","sources":["../../src/analysis/multiTrend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAahD,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;oDAIoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,sDAAsD;IACtD,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,uCAAuC;AACvC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,sBAAsB;AACtB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED,mBAAmB;AACnB,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AA0BD,oCAAoC;AACpC,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,GAAG,cAAc,CAiF5F"}

package/dist/analysis/multiTrend.js

@@ -0,0 +1,106 @@
+import { CalorieRenderError } from '../render/errors.js';
+import { round2 } from '../kcal.js';
+import { buildSeries, resolveWindow, seriesAvg, seriesCount, seriesDelta, } from './series.js';
+import { todayISO } from './utils.js';
+function readCalorieGoal(db) {
+    try {
+        const row = db.prepare('SELECT calorie_goal FROM daily_goal WHERE id = 1').get();
+        const v = row?.calorie_goal;
+        return typeof v === 'number' && Number.isFinite(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+function readWeightGoal(db) {
+    try {
+        const row = db.prepare('SELECT weight_goal FROM daily_goal WHERE id = 1').get();
+        const v = row?.weight_goal;
+        return typeof v === 'number' && Number.isFinite(v) ? v : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** ① 多指标趋势取数：窗口＋目标对照（#376 最小形态）。 */
+export function buildMultiTrendView(db, input) {
+    const today = typeof input.today === 'string' && input.today.length > 0 ? input.today : todayISO();
+    const window = typeof input.window === 'string' && input.window.length > 0 ? input.window : '90d';
+    const group = typeof input.group === 'string' && input.group.length > 0 ? input.group : 'comprehensive';
+    const compare = typeof input.compare === 'string' && input.compare.length > 0 ? input.compare : 'target';
+    if (compare !== 'target' && compare !== 'monthly' && compare !== 'quarterly' && compare !== 'yearly') {
+        throw new CalorieRenderError('bad-input', 'compare 仅支持 target／monthly／quarterly／yearly：' + compare);
+    }
+    if (group !== 'comprehensive' && !/^g([1-9]|10|11)$/.test(group)) {
+        throw new CalorieRenderError('bad-input', 'group 仅支持 comprehensive／g1–g11：' + group);
+    }
+    let start;
+    let end;
+    try {
+        const s = typeof input.start === 'string' ? input.start : null;
+        const e = typeof input.end === 'string' ? input.end : null;
+        if (window === 'custom' && s && e) {
+            start = s;
+            end = e;
+        }
+        else {
+            [start, end] = resolveWindow(window, s, e, today);
+        }
+    }
+    catch (err) {
+        throw new CalorieRenderError('bad-input', err instanceof Error ? err.message : String(err));
+    }
+    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 series = buildSeries(db, start, end);
+    const hasData = series.some((s) => s.calories !== null || s.weightKg !== null || s.exerciseKcal !== null ||
+        s.protein !== null || s.deficit !== null || s.waterMl !== null);
+    if (series.length === 0 || !hasData) {
+        throw new CalorieRenderError('missing-data', '无多指标记录：' + start + ' ~ ' + end);
+    }
+    const calorieGoal = readCalorieGoal(db);
+    const weightGoal = readWeightGoal(db);
+    const compliantDays = calorieGoal === null ? 0 : series.filter((s) => typeof s.calories === 'number' && s.calories <= calorieGoal * 1.05).length;
+    const days = series.map((s) => ({
+        date: s.date,
+        calories: s.calories,
+        weightKg: s.weightKg,
+        exerciseKcal: s.exerciseKcal,
+        protein: s.protein,
+        deficit: s.deficit,
+        waterMl: s.waterMl,
+    }));
+    /* #497：有热量记录的天数（达标率与本页「有记录的 N 天」文案的分母，页面直读）。 */
+    const loggedCalDays = seriesCount(series, 'calories');
+    const summary = {
+        days: series.length,
+        loggedDays: loggedCalDays,
+        avgCalorie: seriesAvg(series, 'calories'),
+        weightChange: seriesDelta(series, 'weightKg'),
+        avgExercise: seriesAvg(series, 'exerciseKcal'),
+        avgProtein: seriesAvg(series, 'protein'),
+        avgDeficit: seriesAvg(series, 'deficit'),
+        /* #497：达标率分母＝有记录的天（旧口径除以窗口天数 series.length，分子本就只数有记录的天；
+         * 90 天窗 11 记录即 11/11 而非 11/90）。与热量趋势页 `ea7cdc9` 口径统一（裁决见 t497 证据 §1）；
+         * 窗内无热量记录回 null，不编数。 */
+        complianceRate: calorieGoal === null ? null : (loggedCalDays > 0
+            ? round2(compliantDays / loggedCalDays) : null),
+        /* #160：整数天数与比例同批投影（页面不许按比例反解，见类型注释）。 */
+        compliantDays: calorieGoal === null ? null : compliantDays,
+    };
+    return {
+        start,
+        end,
+        window,
+        group,
+        compare,
+        days,
+        summary,
+        target: { calorieGoal, weightGoal },
+    };
+}
+//# sourceMappingURL=multiTrend.js.map

package/dist/analysis/multiTrend.js.map

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

package/dist/analysis/multiTrendPage.d.ts

@@ -0,0 +1,4 @@
+import type { MultiTrendView } from './multiTrend.js';
+/** ① 通用分析页最小形态：多指标趋势＋目标线（#376）。A组顶区：中文导航／人话标题／技术进注释／区间一句话／目标线回图内／空态人话。 */
+export declare function buildMultiTrendDoc(v: MultiTrendView): string;
+//# sourceMappingURL=multiTrendPage.d.ts.map

package/dist/analysis/multiTrendPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multiTrendPage.d.ts","sourceRoot":"","sources":["../../src/analysis/multiTrendPage.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAqZtD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,cAAc,GAAG,MAAM,CAqG5D"}