skill-calorie 0.1.0

package/dist/render/receipt.js

@@ -0,0 +1,65 @@
+/** T10 #29 · 通用 CRUD 回执 + 失败回执（对照老家 render_crud_receipt.py / render_error_receipt.py）。
+ *
+ * 收据只承载“已执行结果”的呈现数据：调用方先调 T4 fetch 写数（addPhotos/deletePhoto/
+ * updateTag/tagAdd/tagRemove），再把返回值组装进来，本层不写库、不读二进制。
+ * 失败回执对齐老家 build_error：场景/操作/原因/数据文本/建议/修正 prompt。
+ */
+import { CalorieRenderError } from './errors.js';
+function nowStamp() {
+    const d = new Date();
+    const p = (n) => String(n).padStart(2, '0');
+    return d.getFullYear() + '-' + p(d.getMonth() + 1) + '-' + p(d.getDate()) + ' ' + p(d.getHours()) + ':' + p(d.getMinutes()) + ':' + p(d.getSeconds());
+}
+export function buildReceiptMeta(entityType, wakeWord, source) {
+    if (!entityType)
+        throw new CalorieRenderError('bad-input', 'entityType 必填');
+    if (!wakeWord)
+        throw new CalorieRenderError('bad-input', 'wakeWord 必填');
+    return { actionAt: nowStamp(), entityType, wakeWord, source };
+}
+export function buildCrudReceipt(input) {
+    if (!input.scene)
+        throw new CalorieRenderError('bad-input', 'scene 必填');
+    if (!input.summary)
+        throw new CalorieRenderError('bad-input', 'summary 必填（回执无摘要不返空页）');
+    if (input.op !== 'create' && input.op !== 'update' && input.op !== 'delete') {
+        throw new CalorieRenderError('bad-input', 'op 非法：' + String(input.op));
+    }
+    return {
+        scene: input.scene,
+        action: input.action || input.scene,
+        op: input.op,
+        recordId: input.recordId ?? null,
+        summary: input.summary,
+        items: input.items ?? [],
+        tagDiff: input.tagDiff ?? null,
+        distance: input.distance ?? null,
+        noChange: input.noChange ?? false,
+        meta: buildReceiptMeta(input.scene, input.wakeWord, input.source),
+    };
+}
+export function buildErrorReceipt(input) {
+    const sceneName = input.sceneName || '操作失败';
+    let dataText = '—';
+    if (input.data !== undefined && input.data !== null) {
+        try {
+            dataText = typeof input.data === 'string' ? input.data : JSON.stringify(input.data, null, 2);
+        }
+        catch {
+            dataText = String(input.data);
+        }
+    }
+    return {
+        sceneName,
+        op: input.op || '操作未完成',
+        sub: input.sub || '',
+        reason: input.reason || '(未知原因)',
+        dataText,
+        suggestions: input.suggestions && input.suggestions.length > 0
+            ? [...input.suggestions]
+            : ['修正后重试', '更换参数/目标', '联系开发者'],
+        fixPrompt: input.fixPrompt || '// 修正 prompt 未生成',
+        meta: buildReceiptMeta(sceneName, input.wakeWord || sceneName, '错误回执(写库前校验/执行中失败)'),
+    };
+}
+//# sourceMappingURL=receipt.js.map

package/dist/render/receipt.js.map

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

package/dist/render/weightPlate.d.ts

@@ -0,0 +1,54 @@
+/** #41 · 体重系读链 render 数据（体重盘/历史/对比/复核/波动 v2）。
+ *
+ * 数据源全复用既有取数层，不自查 DB 新口径：
+ * 盘=analysis/weight.weightTrend + weight.getWeightGoalInfo；
+ * 历史=fetch/weight.getWeightHistory（旧 weight-history 同义）；
+ * 对比=analysis/weight.weightCompare；
+ * 复核=analysis/weight.weightMilestone（未设目标/无记录即阻断）；
+ * 波动 v2=analysis/volatility.weightVolatilityV2（rolling/goal 双基线）。
+ * 缺失阻断不返空：空窗/无目标一律 CalorieRenderError missing-data；日期非法 bad-input。
+ */
+import type { DatabaseSync } from 'node:sqlite';
+import type { WeightCompare, WeightMilestone, WeightTrend } from '../analysis/weight.js';
+import type { WeightHistory } from '../fetch/weight.js';
+import type { BaselineMode, VolatilityV2 } from '../analysis/volatility.js';
+export interface WeightDashboard {
+    start: string;
+    end: string;
+    trend: WeightTrend;
+    weightGoal: number | null;
+    deadline: string | null;
+    gapKg: number | null;
+}
+export declare function buildWeightDashboard(db: DatabaseSync, start: string, end: string): WeightDashboard;
+export interface WeightHistoryView {
+    range: string;
+    rows: WeightHistory['rows'];
+    change: WeightHistory['change'];
+}
+export declare function buildWeightHistoryView(db: DatabaseSync, opts?: {
+    days?: number;
+    startDate?: string;
+    endDate?: string;
+}): WeightHistoryView;
+export interface WeightCompareView {
+    start: string;
+    end: string;
+    compareStart: string;
+    compareEnd: string;
+    compare: WeightCompare;
+}
+export declare function buildWeightCompareView(db: DatabaseSync, start: string, end: string, compareStart: string, compareEnd: string): WeightCompareView;
+export interface WeightReviewView {
+    today: string;
+    milestone: WeightMilestone;
+}
+export declare function buildWeightReviewView(db: DatabaseSync, today?: string): WeightReviewView;
+export interface VolatilityView {
+    start: string;
+    end: string;
+    baselineMode: BaselineMode;
+    volatility: VolatilityV2;
+}
+export declare function buildVolatilityView(db: DatabaseSync, start: string, end: string | null | undefined, baselineMode?: BaselineMode): VolatilityView;
+//# sourceMappingURL=weightPlate.d.ts.map

package/dist/render/weightPlate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightPlate.d.ts","sourceRoot":"","sources":["../../src/render/weightPlate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAiB5E,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,CAgBlG;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CACjC;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GACjE,iBAAiB,CAuBnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAcnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAQxF;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,YAAY,CAAC;IAC3B,UAAU,EAAE,YAAY,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,YAAY,EAChB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC9B,YAAY,GAAE,YAAwB,GACrC,cAAc,CAiBhB"}

package/dist/render/weightPlate.js

@@ -0,0 +1,110 @@
+import { getWeightGoalInfo, weightCompare, weightMilestone, weightTrend } from '../analysis/weight.js';
+import { getWeightHistory } from '../fetch/weight.js';
+import { weightVolatilityV2 } from '../analysis/volatility.js';
+import { FetchError } from '../fetch/errors.js';
+import { CalorieRenderError } from './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');
+}
+export function buildWeightDashboard(db, start, end) {
+    assertRange(start, end);
+    let trendRes;
+    try {
+        trendRes = weightTrend(db, start, end);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('missing-data', e.message);
+        throw e;
+    }
+    if (trendRes.status !== 'ok' || !trendRes.data) {
+        throw new CalorieRenderError('missing-data', trendRes.message || ('无体重记录（' + start + ' ~ ' + end + '）'));
+    }
+    const info = getWeightGoalInfo(db);
+    const latest = trendRes.data.lastWeight;
+    const gapKg = info && typeof latest === 'number' ? Math.round((latest - info.weightGoal) * 10) / 10 : null;
+    return { start, end, trend: trendRes.data, weightGoal: info?.weightGoal ?? null, deadline: info?.deadline ?? null, gapKg };
+}
+export function buildWeightHistoryView(db, opts = {}) {
+    const { days = 30, startDate, endDate } = opts;
+    try {
+        if (startDate && endDate) {
+            assertRange(startDate, endDate);
+            const h = getWeightHistory(db, { startDate, endDate });
+            return { range: h.range, rows: h.rows, change: h.change };
+        }
+        if (startDate && !endDate) {
+            assertDate(startDate);
+            const h = getWeightHistory(db, { startDate });
+            return { range: h.range, rows: h.rows, change: h.change };
+        }
+        if (!Number.isInteger(days) || days < 1 || days > 365) {
+            throw new CalorieRenderError('bad-input', 'days 须为 1..365 整数');
+        }
+        const h = getWeightHistory(db, { days });
+        return { range: h.range, rows: h.rows, change: h.change };
+    }
+    catch (e) {
+        if (e instanceof CalorieRenderError)
+            throw e;
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('missing-data', e.message);
+        throw e;
+    }
+}
+export function buildWeightCompareView(db, start, end, compareStart, compareEnd) {
+    assertRange(start, end);
+    assertRange(compareStart, compareEnd);
+    let res;
+    try {
+        res = weightCompare(db, start, end, compareStart, compareEnd);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('bad-input', e.message);
+        throw e;
+    }
+    if (res.status !== 'ok' || !res.data) {
+        throw new CalorieRenderError('missing-data', res.message || '对比时间段内无体重记录，无法对比');
+    }
+    return { start, end, compareStart, compareEnd, compare: res.data };
+}
+export function buildWeightReviewView(db, today) {
+    const t = today ?? new Date().toISOString().slice(0, 10);
+    assertDate(t);
+    const res = weightMilestone(db, t);
+    if (res.status !== 'ok' || !res.data) {
+        throw new CalorieRenderError('missing-data', res.message || '无体重目标或无体重记录');
+    }
+    return { today: t, milestone: res.data };
+}
+export function buildVolatilityView(db, start, end, baselineMode = 'rolling') {
+    assertDate(start);
+    if (end !== null && end !== undefined)
+        assertDate(end);
+    if (baselineMode !== 'rolling' && baselineMode !== 'goal') {
+        throw new CalorieRenderError('bad-input', 'baselineMode 非法（rolling/goal）：' + String(baselineMode));
+    }
+    let res;
+    try {
+        res = weightVolatilityV2(db, start, end ?? null, baselineMode);
+    }
+    catch (e) {
+        if (e instanceof FetchError)
+            throw new CalorieRenderError('bad-input', e.message);
+        throw e;
+    }
+    if (res.status !== 'ok' || !res.data) {
+        throw new CalorieRenderError('missing-data', res.message || ('记录不足（' + start + ' ~ ' + (end ?? start) + '），需要至少2条记录'));
+    }
+    return { start, end: end ?? start, baselineMode, volatility: res.data };
+}
+//# sourceMappingURL=weightPlate.js.map

package/dist/render/weightPlate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"weightPlate.js","sourceRoot":"","sources":["../../src/render/weightPlate.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEvG,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAa,EAAE,GAAW;IAC7C,UAAU,CAAC,KAAK,CAAC,CAAC;IAClB,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,IAAI,KAAK,GAAG,GAAG;QAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAC/E,CAAC;AAWD,MAAM,UAAU,oBAAoB,CAAC,EAAgB,EAAE,KAAa,EAAE,GAAW;IAC/E,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxB,IAAI,QAAqC,CAAC;IAC1C,IAAI,CAAC;QACH,QAAQ,GAAG,WAAW,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,IAAI,QAAQ,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,EAAE,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;IACxC,MAAM,KAAK,GAAG,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3G,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7H,CAAC;AAQD,MAAM,UAAU,sBAAsB,CACpC,EAAgB,EAChB,OAAgE,EAAE;IAElE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;YACzB,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,SAAS,IAAI,CAAC,OAAO,EAAE,CAAC;YAC1B,UAAU,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC9C,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAC5D,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG,EAAE,CAAC;YACtD,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,CAAC,GAAG,gBAAgB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,kBAAkB;YAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,UAAU;YAAE,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACrF,MAAM,CAAC,CAAC;IACV,CAAC;AACH,CAAC;AAUD,MAAM,UAAU,sBAAsB,CACpC,EAAgB,EAChB,KAAa,EACb,GAAW,EACX,YAAoB,EACpB,UAAkB;IAElB,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACxB,WAAW,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IACtC,IAAI,GAAkC,CAAC;IACvC,IAAI,CAAC;QACH,GAAG,GAAG,aAAa,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU;YAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,IAAI,kBAAkB,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AACrE,CAAC;AAOD,MAAM,UAAU,qBAAqB,CAAC,EAAgB,EAAE,KAAc;IACpE,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACzD,UAAU,CAAC,CAAC,CAAC,CAAC;IACd,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACnC,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,IAAI,aAAa,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AASD,MAAM,UAAU,mBAAmB,CACjC,EAAgB,EAChB,KAAa,EACb,GAA8B,EAC9B,eAA6B,SAAS;IAEtC,UAAU,CAAC,KAAK,CAAC,CAAC;IAClB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IACvD,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC1D,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,gCAAgC,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IACrG,CAAC;IACD,IAAI,GAAiC,CAAC;IACtC,IAAI,CAAC;QACH,GAAG,GAAG,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,EAAE,YAAY,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU;YAAE,MAAM,IAAI,kBAAkB,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAClF,MAAM,CAAC,CAAC;IACV,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,IAAI,kBAAkB,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IACzH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;AAC1E,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,25 @@
+/** T1 #20 · 卡路里 13 表 TS 化与迁移史收敛单线（对照老家 scripts/db.py 688 行）。
+ *
+ * 收敛决策（相对老家的增量史）：
+ * - 新库直接建终态 11 张持久表；老家的 body_composition_new / body_composition_mig
+ *   只是历史重建过程的临时表，TS 线永不创建，残留则清理（见 MIGRATION cleanup-strays）。
+ * - 老迁移史收敛为一条有序幂等 MIGRATIONS：PRAGMA 列检查 / IF NOT EXISTS /
+ *   条件回填，重复运行不报错（老家 apply_migrations 语义的超集）。
+ * - intensity 列（中文低中高）终态已删除；老库残留则做一次性 difficulty 回填后保留列
+ *   （SQLite 不便删列，读路径统一用 difficulty）。
+ * - 真实 DB 只读不迁：本模块默认只开显式传入路径；见 paths.assertWritablePath。
+ */
+import { DatabaseSync } from 'node:sqlite';
+export declare const SCHEMA_VERSION = 1;
+/** 终态 DDL：11 张持久表（老家 13 表 − 2 张历史临时表）。 */
+export declare const TABLE_DDLS: Record<string, string>;
+export declare const INDEX_SQLS: string[];
+export declare const TRIGGER_SQLS: string[];
+/** 收敛单线：有序幂等迁移。老库（py 建）与新库统一走同一入口。 */
+export declare function applyMigrations(db: DatabaseSync): void;
+/** 建库入口：终态 DDL + 收敛迁移（幂等，可重入）。 */
+export declare function initDb(db: DatabaseSync): void;
+/** 开库：仅显式路径（测试传 tmp；生产见 paths.resolveDbPath）。 */
+export declare function openDb(dbPath: string): DatabaseSync;
+export declare function listUserTables(db: DatabaseSync): string[];
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,eAAO,MAAM,cAAc,IAAI,CAAC;AAIhC,0CAA0C;AAC1C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA8F7C,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,MAAM,EAe9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,EAoBhC,CAAC;AAuBF,sCAAsC;AACtC,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAyGtD;AAED,kCAAkC;AAClC,wBAAgB,MAAM,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAG7C;AAED,iDAAiD;AACjD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAInD;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,YAAY,GAAG,MAAM,EAAE,CAKzD"}

package/dist/schema.js

@@ -0,0 +1,281 @@
+/** T1 #20 · 卡路里 13 表 TS 化与迁移史收敛单线（对照老家 scripts/db.py 688 行）。
+ *
+ * 收敛决策（相对老家的增量史）：
+ * - 新库直接建终态 11 张持久表；老家的 body_composition_new / body_composition_mig
+ *   只是历史重建过程的临时表，TS 线永不创建，残留则清理（见 MIGRATION cleanup-strays）。
+ * - 老迁移史收敛为一条有序幂等 MIGRATIONS：PRAGMA 列检查 / IF NOT EXISTS /
+ *   条件回填，重复运行不报错（老家 apply_migrations 语义的超集）。
+ * - intensity 列（中文低中高）终态已删除；老库残留则做一次性 difficulty 回填后保留列
+ *   （SQLite 不便删列，读路径统一用 difficulty）。
+ * - 真实 DB 只读不迁：本模块默认只开显式传入路径；见 paths.assertWritablePath。
+ */
+import { DatabaseSync } from 'node:sqlite';
+import { SOURCE_CHOICES } from './kcal.js';
+export const SCHEMA_VERSION = 1;
+const SOURCE_IN = SOURCE_CHOICES.map((s) => `'${s}'`).join(', ');
+/** 终态 DDL：11 张持久表（老家 13 表 − 2 张历史临时表）。 */
+export const TABLE_DDLS = {
+    food_log: `CREATE TABLE IF NOT EXISTS food_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    date TEXT NOT NULL, time TEXT, food_name TEXT NOT NULL,
+    grams INTEGER NOT NULL, calories INTEGER NOT NULL,
+    protein INTEGER DEFAULT 0, carbs INTEGER DEFAULT 0, fat INTEGER DEFAULT 0,
+    sodium_mg REAL, sugar_g REAL, fiber_g REAL,
+    note TEXT DEFAULT '', created_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    daily_goal: `CREATE TABLE IF NOT EXISTS daily_goal (
+    id INTEGER PRIMARY KEY CHECK (id = 1),
+    calorie_goal INTEGER NOT NULL DEFAULT 1800,
+    protein_goal INTEGER DEFAULT 150, carbs_goal INTEGER DEFAULT 200, fat_goal INTEGER DEFAULT 60,
+    weight_goal REAL, goal_deadline TEXT, water_goal INTEGER DEFAULT 2000,
+    goal_paused INTEGER DEFAULT 0, exercise_goal INTEGER,
+    start_weight REAL, start_date TEXT,
+    updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    exercise_log: `CREATE TABLE IF NOT EXISTS exercise_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    date TEXT NOT NULL, time TEXT, exercise_type TEXT NOT NULL,
+    duration_minutes INTEGER, calories_burned INTEGER NOT NULL,
+    category TEXT, difficulty TEXT, distance_km REAL, avg_heart_rate INTEGER,
+    set_index INTEGER, load_kg REAL, reps INTEGER, updated_at TEXT,
+    steps INTEGER, max_heart_rate INTEGER,
+    is_deleted INTEGER DEFAULT 0, is_backfill INTEGER DEFAULT 0,
+    xunji_localid TEXT, xunji_title TEXT,
+    note TEXT DEFAULT '', created_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    weight_log: `CREATE TABLE IF NOT EXISTS weight_log (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    date TEXT NOT NULL, time TEXT, weight_kg REAL NOT NULL,
+    height_cm REAL, bmi REAL, note TEXT DEFAULT '',
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    nutrition_products: `CREATE TABLE IF NOT EXISTS nutrition_products (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    product_name TEXT NOT NULL, brand TEXT,
+    calories REAL NOT NULL, protein REAL NOT NULL, fat REAL NOT NULL,
+    saturated_fat REAL, carbohydrates REAL NOT NULL, sugar REAL,
+    dietary_fiber REAL, sodium REAL NOT NULL,
+    source TEXT NOT NULL DEFAULT '未知', is_deprecated INTEGER NOT NULL DEFAULT 0,
+    category TEXT DEFAULT '', note TEXT DEFAULT '',
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    workout_plan_config: `CREATE TABLE IF NOT EXISTS workout_plan_config (
+    id INTEGER PRIMARY KEY CHECK (id = 1),
+    title TEXT NOT NULL, version TEXT, description TEXT,
+    total_weeks INTEGER NOT NULL, start_date TEXT NOT NULL,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    workout_plans: `CREATE TABLE IF NOT EXISTS workout_plans (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    week_number INTEGER NOT NULL, day_of_week INTEGER NOT NULL,
+    session_index INTEGER NOT NULL DEFAULT 1, session_label TEXT NOT NULL,
+    time_start TEXT, time_end TEXT, is_rest_day INTEGER DEFAULT 0,
+    total_sets INTEGER, movements TEXT NOT NULL DEFAULT '[]',
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP,
+    UNIQUE(week_number, day_of_week, session_index))`,
+    body_photos: `CREATE TABLE IF NOT EXISTS body_photos (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    date TEXT NOT NULL, time TEXT NOT NULL, photo_path TEXT NOT NULL,
+    tag TEXT NOT NULL, note TEXT NOT NULL,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    user_profile: `CREATE TABLE IF NOT EXISTS user_profile (
+    id INTEGER PRIMARY KEY CHECK (id = 1),
+    age INTEGER, gender TEXT, height_cm REAL, note TEXT DEFAULT '',
+    activity_level TEXT DEFAULT 'moderate',
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    body_composition: `CREATE TABLE IF NOT EXISTS body_composition (
+    id INTEGER PRIMARY KEY AUTOINCREMENT,
+    date TEXT NOT NULL, source TEXT NOT NULL CHECK (source IN (${SOURCE_IN})),
+    age INTEGER, sex TEXT CHECK (sex IN ('male', 'female')),
+    caliper_chest_mm REAL CHECK (caliper_chest_mm > 0 AND caliper_chest_mm < 100),
+    caliper_abdominal_mm REAL CHECK (caliper_abdominal_mm > 0 AND caliper_abdominal_mm < 100),
+    caliper_thigh_mm REAL CHECK (caliper_thigh_mm > 0 AND caliper_thigh_mm < 100),
+    caliper_tricep_mm REAL CHECK (caliper_tricep_mm > 0 AND caliper_tricep_mm < 100),
+    caliper_subscapular_mm REAL CHECK (caliper_subscapular_mm > 0 AND caliper_subscapular_mm < 100),
+    caliper_suprailiac_mm REAL CHECK (caliper_suprailiac_mm > 0 AND caliper_suprailiac_mm < 100),
+    caliper_midaxillary_mm REAL CHECK (caliper_midaxillary_mm > 0 AND caliper_midaxillary_mm < 100),
+    body_fat_pct REAL NOT NULL CHECK (body_fat_pct >= 0 AND body_fat_pct <= 60),
+    calculated_at TEXT, note TEXT DEFAULT '', is_deprecated INTEGER DEFAULT 0,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+    body_measurements: `CREATE TABLE IF NOT EXISTS body_measurements (
+    id INTEGER PRIMARY KEY AUTOINCREMENT, date TEXT NOT NULL,
+    chest_cm REAL CHECK (chest_cm IS NULL OR (chest_cm > 20 AND chest_cm < 200)),
+    waist_cm REAL CHECK (waist_cm IS NULL OR (waist_cm > 20 AND waist_cm < 200)),
+    abdomen_cm REAL CHECK (abdomen_cm IS NULL OR (abdomen_cm > 20 AND abdomen_cm < 200)),
+    hip_cm REAL CHECK (hip_cm IS NULL OR (hip_cm > 20 AND hip_cm < 200)),
+    left_thigh_cm REAL CHECK (left_thigh_cm IS NULL OR (left_thigh_cm > 10 AND left_thigh_cm < 100)),
+    right_thigh_cm REAL CHECK (right_thigh_cm IS NULL OR (right_thigh_cm > 10 AND right_thigh_cm < 100)),
+    left_calf_cm REAL CHECK (left_calf_cm IS NULL OR (left_calf_cm > 10 AND left_calf_cm < 80)),
+    right_calf_cm REAL CHECK (right_calf_cm IS NULL OR (right_calf_cm > 10 AND right_calf_cm < 80)),
+    left_arm_cm REAL CHECK (left_arm_cm IS NULL OR (left_arm_cm > 10 AND left_arm_cm < 60)),
+    right_arm_cm REAL CHECK (right_arm_cm IS NULL OR (right_arm_cm > 10 AND right_arm_cm < 60)),
+    left_forearm_cm REAL CHECK (left_forearm_cm IS NULL OR (left_forearm_cm > 10 AND left_forearm_cm < 50)),
+    right_forearm_cm REAL CHECK (right_forearm_cm IS NULL OR (right_forearm_cm > 10 AND right_forearm_cm < 50)),
+    shoulder_cm REAL CHECK (shoulder_cm IS NULL OR (shoulder_cm > 20 AND shoulder_cm < 200)),
+    note TEXT DEFAULT '', is_deprecated INTEGER DEFAULT 0,
+    created_at TEXT DEFAULT CURRENT_TIMESTAMP, updated_at TEXT DEFAULT CURRENT_TIMESTAMP)`,
+};
+export const INDEX_SQLS = [
+    'CREATE INDEX IF NOT EXISTS idx_food_log_date ON food_log(date)',
+    'CREATE INDEX IF NOT EXISTS idx_weight_date ON weight_log(date)',
+    'CREATE INDEX IF NOT EXISTS idx_exercise_date ON exercise_log(date)',
+    'CREATE INDEX IF NOT EXISTS idx_exercise_category ON exercise_log(category)',
+    'CREATE INDEX IF NOT EXISTS idx_exercise_type ON exercise_log(exercise_type)',
+    'CREATE INDEX IF NOT EXISTS idx_exercise_xunji_localid ON exercise_log(xunji_localid)',
+    'CREATE INDEX IF NOT EXISTS idx_product_name ON nutrition_products(product_name)',
+    'CREATE INDEX IF NOT EXISTS idx_product_source ON nutrition_products(source)',
+    'CREATE INDEX IF NOT EXISTS idx_wp_week_day ON workout_plans(week_number, day_of_week)',
+    'CREATE INDEX IF NOT EXISTS idx_body_photos_date ON body_photos(date)',
+    'CREATE INDEX IF NOT EXISTS idx_body_photos_tag ON body_photos(tag)',
+    'CREATE INDEX IF NOT EXISTS idx_body_composition_date ON body_composition(date)',
+    'CREATE INDEX IF NOT EXISTS idx_body_composition_source ON body_composition(source)',
+    'CREATE INDEX IF NOT EXISTS idx_body_measurements_date ON body_measurements(date)',
+];
+export const TRIGGER_SQLS = [
+    `CREATE TRIGGER IF NOT EXISTS user_profile_activity_level_check
+   BEFORE INSERT ON user_profile
+   WHEN (NEW.activity_level IS NOT NULL AND NEW.activity_level NOT IN
+     ('sedentary', 'light', 'moderate', 'active', 'very_active'))
+   BEGIN SELECT RAISE(ABORT, 'activity_level 必须是 sedentary/light/moderate/active/very_active 之一'); END`,
+    `CREATE TRIGGER IF NOT EXISTS user_profile_activity_level_check_update
+   BEFORE UPDATE OF activity_level ON user_profile
+   WHEN (NEW.activity_level IS NOT NULL AND NEW.activity_level NOT IN
+     ('sedentary', 'light', 'moderate', 'active', 'very_active'))
+   BEGIN SELECT RAISE(ABORT, 'activity_level 必须是 sedentary/light/moderate/active/very_active 之一'); END`,
+    `CREATE TRIGGER IF NOT EXISTS body_measurements_require_metric
+   BEFORE INSERT ON body_measurements
+   WHEN (NEW.chest_cm IS NULL AND NEW.waist_cm IS NULL AND NEW.abdomen_cm IS NULL
+     AND NEW.hip_cm IS NULL AND NEW.left_thigh_cm IS NULL AND NEW.right_thigh_cm IS NULL
+     AND NEW.left_calf_cm IS NULL AND NEW.right_calf_cm IS NULL
+     AND NEW.left_arm_cm IS NULL AND NEW.right_arm_cm IS NULL
+     AND NEW.left_forearm_cm IS NULL AND NEW.right_forearm_cm IS NULL
+     AND NEW.shoulder_cm IS NULL)
+   BEGIN SELECT RAISE(ABORT, 'body_measurements 需要 date + 至少 1 个围度'); END`,
+];
+function tableColumns(db, table) {
+    const rows = db.prepare(`PRAGMA table_info(${table})`).all();
+    return new Set(rows.map((r) => r.name));
+}
+function tableSql(db, table) {
+    const row = db
+        .prepare("SELECT sql FROM sqlite_master WHERE type='table' AND name=?")
+        .get(table);
+    return row?.sql ?? '';
+}
+function tableExists(db, table) {
+    return tableSql(db, table) !== '';
+}
+const CALIPERS = [
+    'caliper_chest_mm', 'caliper_abdominal_mm', 'caliper_thigh_mm', 'caliper_tricep_mm',
+    'caliper_subscapular_mm', 'caliper_suprailiac_mm', 'caliper_midaxillary_mm',
+];
+/** 收敛单线：有序幂等迁移。老库（py 建）与新库统一走同一入口。 */
+export function applyMigrations(db) {
+    // M1 遗留表清理：entries 合并 → food_log；sleep_records / fitness_goals 删除。
+    const tables = new Set(db.prepare("SELECT name FROM sqlite_master WHERE type='table'").all().map((r) => r.name));
+    if (tables.has('entries') && !tables.has('food_log')) {
+        db.exec('ALTER TABLE entries RENAME TO food_log');
+    }
+    else if (tables.has('entries') && tables.has('food_log')) {
+        db.exec('INSERT OR IGNORE INTO food_log (date, time, food_name, grams, calories, protein, carbs, fat, note, created_at) ' +
+            'SELECT date, time, food_name, grams, calories, protein, carbs, fat, note, created_at FROM entries');
+        db.exec('DROP TABLE entries');
+    }
+    for (const dead of ['sleep_records', 'fitness_goals', 'body_composition_new', 'body_composition_mig']) {
+        db.exec(`DROP TABLE IF EXISTS ${dead}`);
+    }
+    // M2 food_log 钠糖纤维列 + 回填（老家 2026-08-02 ticket #10）。
+    const foodCols = tableColumns(db, 'food_log');
+    for (const [col, type] of [['sodium_mg', 'REAL'], ['sugar_g', 'REAL'], ['fiber_g', 'REAL']]) {
+        if (!foodCols.has(col))
+            db.exec(`ALTER TABLE food_log ADD COLUMN ${col} ${type}`);
+    }
+    db.exec(`UPDATE food_log SET
+    sodium_mg = ROUND((SELECT n.sodium FROM nutrition_products n
+      WHERE n.product_name = food_log.food_name AND n.is_deprecated = 0
+      ORDER BY n.id DESC LIMIT 1) * food_log.grams / 100.0, 1),
+    sugar_g = ROUND((SELECT n.sugar FROM nutrition_products n
+      WHERE n.product_name = food_log.food_name AND n.is_deprecated = 0
+      ORDER BY n.id DESC LIMIT 1) * food_log.grams / 100.0, 1),
+    fiber_g = ROUND((SELECT n.dietary_fiber FROM nutrition_products n
+      WHERE n.product_name = food_log.food_name AND n.is_deprecated = 0
+      ORDER BY n.id DESC LIMIT 1) * food_log.grams / 100.0, 1)
+    WHERE food_log.sodium_mg IS NULL OR food_log.sugar_g IS NULL OR food_log.fiber_g IS NULL`);
+    // M3 daily_goal 增量列（PRAGMA 守卫，老家 try/except 语义）。
+    const goalCols = tableColumns(db, 'daily_goal');
+    for (const [col, type] of [
+        ['weight_goal', 'REAL'], ['goal_deadline', 'TEXT'], ['water_goal', 'INTEGER DEFAULT 2000'],
+        ['goal_paused', 'INTEGER DEFAULT 0'], ['exercise_goal', 'INTEGER'],
+        ['start_weight', 'REAL'], ['start_date', 'TEXT'],
+    ]) {
+        if (!goalCols.has(col))
+            db.exec(`ALTER TABLE daily_goal ADD COLUMN ${col} ${type}`);
+    }
+    // M4 nutrition_products 扩展列 + [已废弃] 回填。
+    const prodCols = tableColumns(db, 'nutrition_products');
+    for (const [col, type] of [
+        ['source', "TEXT DEFAULT '未知'"], ['is_deprecated', 'INTEGER DEFAULT 0'],
+        ['category', "TEXT DEFAULT ''"],
+    ]) {
+        if (!prodCols.has(col))
+            db.exec(`ALTER TABLE nutrition_products ADD COLUMN ${col} ${type}`);
+    }
+    db.exec(`UPDATE nutrition_products SET is_deprecated = 1 WHERE is_deprecated = 0 AND (
+    note LIKE '%[已废弃]%' OR product_name LIKE '%[已废弃]%' OR brand LIKE '%[已废弃]%')`);
+    // M5 exercise_log 扩展列 + intensity→difficulty 数据迁移 + xunji 关联列。
+    const exCols = tableColumns(db, 'exercise_log');
+    for (const [col, type] of [
+        ['category', 'TEXT'], ['difficulty', 'TEXT'], ['distance_km', 'REAL'],
+        ['avg_heart_rate', 'INTEGER'], ['set_index', 'INTEGER'], ['load_kg', 'REAL'],
+        ['reps', 'INTEGER'], ['updated_at', 'TEXT'], ['steps', 'INTEGER'],
+        ['max_heart_rate', 'INTEGER'], ['is_deleted', 'INTEGER DEFAULT 0'],
+        ['is_backfill', 'INTEGER DEFAULT 0'],
+        ['xunji_localid', 'TEXT'], ['xunji_title', 'TEXT'],
+    ]) {
+        if (!exCols.has(col))
+            db.exec(`ALTER TABLE exercise_log ADD COLUMN ${col} ${type}`);
+    }
+    if (exCols.has('intensity')) {
+        db.exec(`UPDATE exercise_log SET difficulty = CASE intensity
+      WHEN '低' THEN 'easy' WHEN '中' THEN 'normal' WHEN '高' THEN 'hard' ELSE NULL END
+      WHERE difficulty IS NULL AND intensity IS NOT NULL`);
+    }
+    // M6 user_profile.activity_level + 回填。
+    if (!tableColumns(db, 'user_profile').has('activity_level')) {
+        db.exec("ALTER TABLE user_profile ADD COLUMN activity_level TEXT DEFAULT 'moderate'");
+        db.exec("UPDATE user_profile SET activity_level = 'moderate' WHERE activity_level IS NULL");
+    }
+    // M7 body_composition 重建收敛：旧 CHECK（无 gym）或皮褶 NOT NULL → 一次重建为终态。
+    if (tableExists(db, 'body_composition')) {
+        const sql = tableSql(db, 'body_composition');
+        const info = db.prepare('PRAGMA table_info(body_composition)').all();
+        const notnullBy = new Map(info.map((c) => [c.name, c.notnull]));
+        const needsRebuild = !SOURCE_CHOICES.every((s) => sql.includes(`'${s}'`)) ||
+            CALIPERS.some((c) => (notnullBy.get(c) ?? 0) === 1);
+        if (needsRebuild) {
+            const cols = info.map((c) => c.name);
+            const colList = cols.map((c) => `"${c}"`).join(', ');
+            db.exec(TABLE_DDLS.body_composition.replace('body_composition (', 'body_composition_ts ('));
+            db.exec(`INSERT INTO body_composition_ts (${colList}) SELECT ${colList} FROM body_composition`);
+            db.exec('DROP TABLE body_composition');
+            db.exec('ALTER TABLE body_composition_ts RENAME TO body_composition');
+        }
+    }
+    for (const sql of INDEX_SQLS)
+        db.exec(sql);
+    for (const sql of TRIGGER_SQLS)
+        db.exec(sql);
+}
+/** 建库入口：终态 DDL + 收敛迁移（幂等，可重入）。 */
+export function initDb(db) {
+    for (const ddl of Object.values(TABLE_DDLS))
+        db.exec(ddl);
+    applyMigrations(db);
+}
+/** 开库：仅显式路径（测试传 tmp；生产见 paths.resolveDbPath）。 */
+export function openDb(dbPath) {
+    const db = new DatabaseSync(dbPath);
+    initDb(db);
+    return db;
+}
+export function listUserTables(db) {
+    const rows = db
+        .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%' ORDER BY name")
+        .all();
+    return rows.map((r) => r.name);
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

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

package/dist/triggers/help-lookup.d.ts

@@ -0,0 +1,28 @@
+/** HELP 唤醒词速查台：wake_word/alias → 命中（公共组件 help_template 注入上游口径）。
+ * C2 #43 · 记早餐/记午餐/记晚餐别名同走 calorie.diet.add（SoT 零改动，别名唯一上游为本文件 WAKE_TABLE；buildHelpLookup/searchHelp 双注入）。
+ * C3 #43 · 去legacy首命中：可执行键（calorie-cmd-read calorie.*）排前，legacy python/mmx 排后；知名高频词用 HELP_EXEC_OVERRIDES + 合成首条保可执行。
+ */
+import type { HelpHit, Trigger } from './types.js';
+/** 分类 → 场景编号（复盘并入 10-分析；食品库/综合在 SoT 中为空） */
+export declare const CATEGORY_SCENE: Record<string, string>;
+/** 全量速查表：主唤醒词与其 aliases 同指同一命中；记身材照一词三命中（按 key 区分）。 */
+export declare function buildHelpLookup(triggers: Trigger[]): Record<string, HelpHit[]>;
+export declare function lookupWake(map: Record<string, HelpHit[]>, word: string): HelpHit[];
+/** C2 #43 · 餐别别名 WAKE_TABLE（SoT 不动：TRIGGERS 原文零改动，别名唯一上游为本表；buildHelpLookup/searchHelp 双注入）。 */
+export declare const WAKE_TABLE: Array<{
+    phrase: string;
+    key: string;
+    cli: string;
+}>;
+export declare function routeWakeword(phrase: string): {
+    key: string;
+    cli: string;
+} | null;
+/** C3 #43 · cli 是否可执行（唯一出口 calorie-cmd-read）。 */
+export declare function isExecCli(cli: string): boolean;
+/** C3 #43 · legacy 内部 key → 可执行 cli 映射（SoT 原文不动，呈现层替换首命中）。 */
+export declare const HELP_EXEC_OVERRIDES: Record<string, string>;
+export declare function execCliFor(internalKey: string | null, fallbackCli: string): string;
+/** C3 #43 · 别名感知 + 可执行排前 + 知名高频词合成首条（唯一搜索入口，cmd_read 同逻辑）。 */
+export declare function searchHelp(triggers: Trigger[], q: string): HelpHit[];
+//# sourceMappingURL=help-lookup.d.ts.map

package/dist/triggers/help-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-lookup.d.ts","sourceRoot":"","sources":["../../src/triggers/help-lookup.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAEnD,4CAA4C;AAC5C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAYjD,CAAC;AAUF,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAmB9E;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,EAAE,CAElF;AAED,gGAAgG;AAChG,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAI1E,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGjF;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwBtD,CAAC;AAEF,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAIlF;AAOD,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,EAAE,CAgEpE"}