skill-calorie 0.2.3 → 0.2.5

package/dist/xunji/overlay-plan.d.ts

@@ -0,0 +1,79 @@
+/** 计划叠加：用本仓计划覆盖训记某天的训练（老 `xunji_bridge/overlay.py`，代码新写）。
+ *
+ * 口径（逐条对老）：
+ * - 先拉训记当天 list（只拿 title→localid，不取 start/end），再读本仓当天 sessions，按 title 对账；
+ * - 构造 `res[]`：localid 用训记已有的，start＝end＝0（覆盖＝新建语义，老 `:116-120`）；
+ * - 单次 upsert 推全部（训记单次最多 4 条，老 `:161-174`），幂等键 `overlay_{date}_{uuid8}`；
+ * - `missing` 缺省 `fail`（有缺即报 err 不推，老 `:123-138`），`skip` 只推匹配的（老 `:140-143`）；
+ * - 拉取失败即带 err 回（老 `:66-78`）；`missing=fail` 的 err 走用法错 1（老 `__main__:230-233`），
+ *   拉取／upsert 失败走 `exitMap`（无 KEY→2，401／403→3）。
+ *
+ * 修掉的老缺陷（不照抄）：老 `overlay.py:80` 的推导式 `{t["title"]: t["localid"]}`
+ * 把同 title 的多条压成一条，后面的 localid 静默丢失——新仓按 title 分组收全部 localid，
+ * sessions 按序逐条消耗（同 label 的第 2 个 session 拿第 2 个 localid），耗不完的 title
+ * 留在 `extra_in_xunji`，每条已消耗的 localid 都写在 `matched` 里（逐 session 一项）。
+ */
+import type { FetchOptions, FetchOutcome } from './fetch.js';
+import type { XunjiResItem } from './request.js';
+import type { UpsertOptions, UpsertOutcome } from './upsert.js';
+import type { DayPlanSource } from './planSource.js';
+import type { XunjiFailure } from './retry.js';
+import type { XunjiSubcommand } from './subcommands.js';
+import type { XunjiRun } from './run.js';
+/** `missing` 策略（老 `overlay_day_plan` 签名同名同值）：`fail` 有缺即报／`skip` 跳过只推有的。 */
+export type OverlayMissing = 'fail' | 'skip';
+/** `overlayDayPlan` 的注入缝（测试挡板从这里进；生产全缺省＝真拉取＋真单次 upsert）。 */
+export interface OverlayDeps {
+    /** 取某天 sessions（缺省读卡路里库，见 `planSource.ts`）。 */
+    readonly planSource?: DayPlanSource;
+    /** 拉训记当天（缺省 `fetchTrains(..., includeFullData: true)`：要 localid 全表）。 */
+    readonly fetchDay?: (dateStr: string) => Promise<FetchOutcome>;
+    /** 缺省拉取的透传件（KEY／传输／超时／重试／睡眠）。 */
+    readonly fetchOpts?: FetchOptions;
+    /** 单次 upsert（缺省走 `upsertTrains`；测试给挡板，**不许打真接口**）。 */
+    readonly upsert?: (resList: readonly XunjiResItem[], clientRequestId: string) => Promise<UpsertOutcome>;
+    /** 缺省 upsert 的透传件（KEY／传输／超时／重试／睡眠）。 */
+    readonly upsertOpts?: UpsertOptions;
+    /** 只组请求不调接口（老 `dry_run` 同述；传输 0 次）。 */
+    readonly dryRun?: boolean;
+    /** 缺 title 策略（缺省 `fail`，老签名同值）。 */
+    readonly missing?: OverlayMissing;
+}
+/** title → localid 全表（同 title 多条全留；修老 `overlay.py:80` 推导式丢 localid）。 */
+export declare function groupLocalidsByTitle(trains: readonly {
+    readonly title: unknown;
+    readonly localid: unknown;
+}[]): Map<string, number[]>;
+/** 一条 session 的叠加结果（老单条目改逐条：同 title 多 localid 才写得下）。 */
+export interface OverlayMatch {
+    readonly session_label: string;
+    readonly localid: number;
+    readonly ok: boolean;
+    readonly client_request_id: string;
+    /** 成功时为训记正文／dry-run 摘要；失败时为 `{ err: true, …失败读数 }`。 */
+    readonly resp: unknown;
+}
+/** 一天的叠加读数（老 `overlay_day_plan` 八键 ＋ 失败分类 `failure` 供退出码分流）。 */
+export interface OverlayDayResult {
+    readonly date: string;
+    readonly session_count: number;
+    readonly trains_count: number;
+    readonly matched: readonly OverlayMatch[];
+    readonly missing_in_xunji: readonly string[];
+    /** 还有 localid 没被消耗的 title（含从未匹配的；耗尽的不在内）。 */
+    readonly extra_in_xunji: readonly string[];
+    readonly ok_count: number;
+    readonly fail_count: number;
+    /** 人话失败（null＝成功；`failure` 空＋`err` 有＝用法错那支）。 */
+    readonly err: string | null;
+    readonly note: string | null;
+    /** 拉取／upsert 失败的分类（供 `exitForFailure`；成功与用法错时为 null）。 */
+    readonly failure: XunjiFailure | null;
+}
+/** 叠加一天：拉训记 → 读本仓 → 按 title 对账 → 单次 upsert（调用方保证日期形状）。 */
+export declare function overlayDayPlan(dateStr: string, deps?: OverlayDeps): Promise<OverlayDayResult>;
+type Values = Readonly<Record<string, string | boolean | readonly string[]>>;
+/** `overlay-plan` 子命令的分派（`run.ts` 调；`missing=fail` 的缺 title 走 1）。 */
+export declare function runOverlayPlanCommand(sub: XunjiSubcommand, values: Values, deps?: OverlayDeps): Promise<XunjiRun>;
+export {};
+//# sourceMappingURL=overlay-plan.d.ts.map

package/dist/xunji/overlay-plan.d.ts.map

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

package/dist/xunji/overlay-plan.js

@@ -0,0 +1,145 @@
+/** 计划叠加：用本仓计划覆盖训记某天的训练（老 `xunji_bridge/overlay.py`，代码新写）。
+ *
+ * 口径（逐条对老）：
+ * - 先拉训记当天 list（只拿 title→localid，不取 start/end），再读本仓当天 sessions，按 title 对账；
+ * - 构造 `res[]`：localid 用训记已有的，start＝end＝0（覆盖＝新建语义，老 `:116-120`）；
+ * - 单次 upsert 推全部（训记单次最多 4 条，老 `:161-174`），幂等键 `overlay_{date}_{uuid8}`；
+ * - `missing` 缺省 `fail`（有缺即报 err 不推，老 `:123-138`），`skip` 只推匹配的（老 `:140-143`）；
+ * - 拉取失败即带 err 回（老 `:66-78`）；`missing=fail` 的 err 走用法错 1（老 `__main__:230-233`），
+ *   拉取／upsert 失败走 `exitMap`（无 KEY→2，401／403→3）。
+ *
+ * 修掉的老缺陷（不照抄）：老 `overlay.py:80` 的推导式 `{t["title"]: t["localid"]}`
+ * 把同 title 的多条压成一条，后面的 localid 静默丢失——新仓按 title 分组收全部 localid，
+ * sessions 按序逐条消耗（同 label 的第 2 个 session 拿第 2 个 localid），耗不完的 title
+ * 留在 `extra_in_xunji`，每条已消耗的 localid 都写在 `matched` 里（逐 session 一项）。
+ */
+import { randomUUID } from 'node:crypto';
+import { fetchTrains, parseTrains } from './fetch.js';
+import { sessionToResItem } from './request.js';
+import { upsertTrains } from './upsert.js';
+import { dateProblem, resolveDayPlan } from './planSource.js';
+import { exitForFailure } from './exitMap.js';
+import { XUNJI_EXIT_CODES } from './subcommands.js';
+/** title → localid 全表（同 title 多条全留；修老 `overlay.py:80` 推导式丢 localid）。 */
+export function groupLocalidsByTitle(trains) {
+    const out = new Map();
+    for (const t of trains) {
+        if (typeof t.title !== 'string' || t.title === '')
+            continue;
+        if (typeof t.localid !== 'number' || !Number.isInteger(t.localid))
+            continue;
+        const list = out.get(t.title);
+        if (list !== undefined)
+            list.push(t.localid);
+        else
+            out.set(t.title, [t.localid]);
+    }
+    return out;
+}
+function base(dateStr, sessionCount, trainsCount) {
+    return { date: dateStr, session_count: sessionCount, trains_count: trainsCount };
+}
+/** 叠加一天：拉训记 → 读本仓 → 按 title 对账 → 单次 upsert（调用方保证日期形状）。 */
+export async function overlayDayPlan(dateStr, deps = {}) {
+    const missingOpt = deps.missing ?? 'fail';
+    const fetchDay = deps.fetchDay ?? ((d) => fetchTrains(d, { ...deps.fetchOpts, includeFullData: true }));
+    const outcome = await fetchDay(dateStr);
+    if (!outcome.ok) {
+        const err = '拉取失败（没拉到）：' + outcome.failure.message;
+        return { ...base(dateStr, 0, 0), matched: [], missing_in_xunji: [], extra_in_xunji: [], ok_count: 0, fail_count: 1, err, note: null, failure: outcome.failure };
+    }
+    const trains = parseTrains(outcome.response);
+    const queues = groupLocalidsByTitle(trains);
+    const day = (deps.planSource ?? resolveDayPlan)(dateStr);
+    if (!day.found) {
+        return { ...base(dateStr, 0, trains.length), matched: [], missing_in_xunji: [], extra_in_xunji: [...queues.keys()], ok_count: 0, fail_count: 0, err: day.reason, note: null, failure: null };
+    }
+    const sessions = day.sessions;
+    if (sessions.length === 0) {
+        return {
+            ...base(dateStr, 0, trains.length), matched: [], missing_in_xunji: [], extra_in_xunji: [...queues.keys()],
+            ok_count: 0, fail_count: 0, err: null, note: '卡路里当天无 session（可能休息日或计划未配置），无可覆盖', failure: null,
+        };
+    }
+    const resList = [];
+    const consumed = [];
+    const missingInXunji = [];
+    for (const s of sessions) {
+        const label = s.session_label ?? '';
+        const localid = queues.get(label)?.shift();
+        if (localid === undefined) {
+            missingInXunji.push(label);
+            continue;
+        }
+        resList.push({ ...sessionToResItem(dateStr, s), localid });
+        consumed.push({ session_label: label, localid });
+    }
+    const extra = [...queues.entries()].filter(([, q]) => q.length > 0).map(([t]) => t);
+    if (missingInXunji.length > 0 && missingOpt === 'fail') {
+        return {
+            ...base(dateStr, sessions.length, trains.length), matched: [], missing_in_xunji: missingInXunji, extra_in_xunji: extra,
+            ok_count: 0, fail_count: 0, err: '卡路里有但训记没：' + missingInXunji.join('、') + '（missing=fail 报错退出）', note: null, failure: null,
+        };
+    }
+    if (resList.length === 0) {
+        return {
+            ...base(dateStr, sessions.length, trains.length), matched: [], missing_in_xunji: missingInXunji, extra_in_xunji: extra,
+            ok_count: 0, fail_count: 0, err: null, note: '无可推送的 session（全部 missing 或空）', failure: null,
+        };
+    }
+    const clientRequestId = 'overlay_' + dateStr + '_' + randomUUID().replace(/-/g, '').slice(0, 8);
+    if (deps.dryRun === true) {
+        const matched = consumed.map((c) => ({
+            session_label: c.session_label, localid: c.localid, ok: true, client_request_id: clientRequestId,
+            resp: { dry_run: true, client_request_id: clientRequestId, res_count: resList.length },
+        }));
+        return {
+            ...base(dateStr, sessions.length, trains.length), matched, missing_in_xunji: missingInXunji, extra_in_xunji: extra,
+            ok_count: matched.length, fail_count: 0, err: null, note: null, failure: null,
+        };
+    }
+    const callUpsert = deps.upsert ?? ((list, cid) => upsertTrains(list, { ...deps.upsertOpts, clientRequestId: cid }));
+    const up = await callUpsert(resList, clientRequestId);
+    const resp = up.ok ? up.response : { err: true, ...up.failure, attempts: up.attempts };
+    const matched = consumed.map((c) => ({ session_label: c.session_label, localid: c.localid, ok: up.ok, client_request_id: clientRequestId, resp }));
+    return {
+        ...base(dateStr, sessions.length, trains.length), matched, missing_in_xunji: missingInXunji, extra_in_xunji: extra,
+        ok_count: up.ok ? matched.length : 0, fail_count: up.ok ? 0 : 1, err: null, note: null, failure: up.ok ? null : up.failure,
+    };
+}
+/** `overlay-plan` 子命令的分派（`run.ts` 调；`missing=fail` 的缺 title 走 1）。 */
+export async function runOverlayPlanCommand(sub, values, deps = {}) {
+    const refuse = (why, data) => ({
+        subcommand: 'overlay-plan', code: XUNJI_EXIT_CODES.error, message: why, data, stderr: why + '（用法：' + sub.usage + '）',
+    });
+    const date = values['--date'];
+    if (typeof date !== 'string')
+        return refuse('缺参数：--date', { usage: sub.usage });
+    const bad = dateProblem(date);
+    if (bad !== null)
+        return refuse(bad, { usage: sub.usage });
+    const missingRaw = values['--missing'];
+    if (missingRaw !== undefined && missingRaw !== 'fail' && missingRaw !== 'skip') {
+        return refuse('--missing 只能是 fail|skip（实际：' + String(missingRaw) + '）', { usage: sub.usage });
+    }
+    const result = await overlayDayPlan(date, {
+        ...deps, dryRun: values['--dry-run'] === true, missing: missingRaw === 'skip' ? 'skip' : 'fail',
+    });
+    if (result.failure !== null) {
+        const line = result.err ?? '叠加失败';
+        return { subcommand: 'overlay-plan', code: exitForFailure(result.failure), message: line, data: result, stderr: line };
+    }
+    if (result.err !== null) {
+        return { subcommand: 'overlay-plan', code: XUNJI_EXIT_CODES.error, message: result.err, data: result, stderr: result.err };
+    }
+    if (result.fail_count > 0) {
+        const line = '叠加失败：' + date + ' upsert 未成功';
+        return { subcommand: 'overlay-plan', code: XUNJI_EXIT_CODES.api, message: line, data: result, stderr: line };
+    }
+    return {
+        subcommand: 'overlay-plan', code: XUNJI_EXIT_CODES.ok,
+        message: '叠加成功：' + date + ' ' + result.ok_count + ' 条（训记 ' + result.trains_count + ' 条里对上 ' + result.matched.length + ' 条）',
+        data: result, stderr: null,
+    };
+}
+//# sourceMappingURL=overlay-plan.js.map

package/dist/xunji/overlay-plan.js.map

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

package/dist/xunji/planSource.d.ts

@@ -0,0 +1,40 @@
+/** `push-plan --date` 的取数口：日期 → 当天的 sessions（读卡路里库，只读）。
+ *
+ * 口径：
+ * - 只读打开（`db/readonly.ts` 的 `openDbReadOnly`：不建表、不迁移；与 `cli/cmd_read.ts:97` 同法）；
+ * - 库路径＝配置里 `db.dir`（空＝数据目录）下的 `db.name`（`paths.ts` 的
+ *   `resolveDbDir`＋`resolveDbFileName`；不用 `resolveDbPath`——它会 `mkdir`，只读口不许有落盘副作用）；
+ * - 日期 →（周，日）走渲染门的 `weekOfDate`（新仓口径；老 `calc_plan_week` 的
+ *   “超总周数循环”不照抄——新仓 `buildPlanView` 同样不过滤循环周，
+ *   对不上就当这天没排练）；
+ * - 会读 `workout_plans` 全表再按（周，日）过滤（`workout` 门的 `getPlan` 只读口；
+ *   R1 收口 #613：跨能力引用一律走能力门 `workout/index.js#getPlan` 与
+ *   `render/index.js#weekOfDate`，不深引对方内部件）；
+ * - 存在性预检：库目录取不到／库文件不在／打开失败一律回 `found: false` 带人话原因，
+ *   不抛错（调用方按退出码 1 报；“失败不许静默吞”）；
+ * - “无任何计划”（无配置且无会话）与“计划缺开始日期”同样回 `found: false`；
+ *   “这天没排练”（休息日／计划未开始／超周）回 `found: true, sessions: []`——调用方按老
+ *   `push.py:135-143` 回 `session_count: 0` ＋ note，退出 0。
+ */
+import type { PushSession } from './push.js';
+/** 取数结局：`found: true` 即有明确答案（含“这天没排练”的空表）；否则看 `reason` 报 1。 */
+export type DayPlan = {
+    readonly found: true;
+    readonly sessions: readonly PushSession[];
+    readonly planWeek: number;
+    readonly dayOfWeek: number;
+} | {
+    readonly found: false;
+    readonly reason: string;
+};
+/** 日期入参的取值面（测试从这里换库文件；不许打生产库）。 */
+export interface ResolveDayPlanOpts {
+    readonly dbFile?: string;
+}
+/** 日期形状检查：`YYYY-MM-DD` 且为真实日历日；null＝通过，否则为人话原因。 */
+export declare function dateProblem(v: string): string | null;
+/** 取某天的 sessions（只读；任何读不出都回 `found: false`，不抛）。 */
+export declare function resolveDayPlan(dateStr: string, opts?: ResolveDayPlanOpts): DayPlan;
+/** 取数口的函数形状（`run.ts` 的注入缝与测试挡板共用这一个类型）。 */
+export type DayPlanSource = (dateStr: string) => DayPlan;
+//# sourceMappingURL=planSource.d.ts.map

package/dist/xunji/planSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planSource.d.ts","sourceRoot":"","sources":["../../src/xunji/planSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GACf;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1H;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,kCAAkC;AAClC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpD;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,kBAAuB,GAAG,OAAO,CAoCtF;AAED,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC"}

package/dist/xunji/planSource.js

@@ -0,0 +1,78 @@
+/** `push-plan --date` 的取数口：日期 → 当天的 sessions（读卡路里库，只读）。
+ *
+ * 口径：
+ * - 只读打开（`db/readonly.ts` 的 `openDbReadOnly`：不建表、不迁移；与 `cli/cmd_read.ts:97` 同法）；
+ * - 库路径＝配置里 `db.dir`（空＝数据目录）下的 `db.name`（`paths.ts` 的
+ *   `resolveDbDir`＋`resolveDbFileName`；不用 `resolveDbPath`——它会 `mkdir`，只读口不许有落盘副作用）；
+ * - 日期 →（周，日）走渲染门的 `weekOfDate`（新仓口径；老 `calc_plan_week` 的
+ *   “超总周数循环”不照抄——新仓 `buildPlanView` 同样不过滤循环周，
+ *   对不上就当这天没排练）；
+ * - 会读 `workout_plans` 全表再按（周，日）过滤（`workout` 门的 `getPlan` 只读口；
+ *   R1 收口 #613：跨能力引用一律走能力门 `workout/index.js#getPlan` 与
+ *   `render/index.js#weekOfDate`，不深引对方内部件）；
+ * - 存在性预检：库目录取不到／库文件不在／打开失败一律回 `found: false` 带人话原因，
+ *   不抛错（调用方按退出码 1 报；“失败不许静默吞”）；
+ * - “无任何计划”（无配置且无会话）与“计划缺开始日期”同样回 `found: false`；
+ *   “这天没排练”（休息日／计划未开始／超周）回 `found: true, sessions: []`——调用方按老
+ *   `push.py:135-143` 回 `session_count: 0` ＋ note，退出 0。
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { resolveDbDir, resolveDbFileName } from '../paths.js';
+import { openDbReadOnly } from '../db/readonly.js';
+import { getPlan } from '../workout/index.js';
+import { weekOfDate } from '../render/index.js';
+/** 日期形状检查：`YYYY-MM-DD` 且为真实日历日；null＝通过，否则为人话原因。 */
+export function dateProblem(v) {
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(v))
+        return '日期须为 YYYY-MM-DD（实际：' + v + '）';
+    const [y, m, d] = v.split('-').map(Number);
+    const dt = new Date(Date.UTC(y, m - 1, d));
+    if (dt.getUTCFullYear() !== y || dt.getUTCMonth() !== m - 1 || dt.getUTCDate() !== d) {
+        return '日期不是真实日历日（实际：' + v + '）';
+    }
+    return null;
+}
+/** 取某天的 sessions（只读；任何读不出都回 `found: false`，不抛）。 */
+export function resolveDayPlan(dateStr, opts = {}) {
+    let dbFile = opts.dbFile;
+    if (dbFile === undefined) {
+        try {
+            dbFile = join(resolveDbDir(), resolveDbFileName());
+        }
+        catch (e) {
+            return { found: false, reason: e instanceof Error ? e.message : String(e) };
+        }
+    }
+    if (!existsSync(dbFile)) {
+        return { found: false, reason: '卡路里库文件不在（' + dbFile + '）：先确认配置项 db.dir 指对（空＝数据目录），再看库在不在' };
+    }
+    let db = null;
+    try {
+        const opened = openDbReadOnly(dbFile);
+        db = opened;
+        const plan = getPlan(opened);
+        if (!plan.config && plan.sessions.length === 0) {
+            return { found: false, reason: '无训练计划（先定训练计划）' };
+        }
+        const start = plan.config?.start_date ?? null;
+        if (!start) {
+            return { found: false, reason: '计划缺开始日期，无法定位周次' };
+        }
+        const { week, dow } = weekOfDate(start, dateStr);
+        const sessions = plan.sessions.filter((s) => s.week_number === week && s.day_of_week === dow);
+        return { found: true, sessions, planWeek: week, dayOfWeek: dow };
+    }
+    catch (e) {
+        return { found: false, reason: '读训练计划失败：' + (e instanceof Error ? e.message : String(e)) };
+    }
+    finally {
+        try {
+            db?.close();
+        }
+        catch {
+            /* 关库失败不掩盖取数结论 */
+        }
+    }
+}
+//# sourceMappingURL=planSource.js.map

package/dist/xunji/planSource.js.map

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

package/dist/xunji/push.d.ts

@@ -0,0 +1,55 @@
+/** 推一天的训练计划（老 `xunji_bridge/push.py:push_day_plan`，`:113-197`，代码新写）。
+ *
+ * 行为（逐条对老）：
+ * - 入参是**日期 ＋ 当天的 sessions**（读库取天是 `planSource.ts` 的活；本件只转＋推）；
+ * - 无 session 即回 `session_count: 0` ＋ `note`（老 `:135-143`），不算失败；
+ * - 每个 session 一个 `client_request_id`：`{date}_{label}_{uuid8}`（老 `:151-153`，
+ *   语义前缀便查日志、短 uuid 防训记去重）；
+ * - 逐个 upsert，每次调用前过 45 秒限频门（`rateLimit.ts`；老 `:156-158` 的“睡够再调”保留，
+ *   跨段／跨天一视同仁是本票修掉的那条，见该件决议）；
+ * - 汇总 `{date, session_count, results, ok_count, fail_count, verify_note}`（老 `:187-197`）；
+ * - `verified` 只在响应里真看得到 train 才 true（训记 v2 响应缺陷，老 `:173-184` 同述，
+ *   真值以 `fetch --full` 为准，归 #608）；
+ * - 失败不吞：每条结果带原响应／结构化失败，`fail_count` 进退出码（见 `exitMap.ts`；
+ *   老 `sync_plan.py:337-339` “只打印不进退出码”是缺陷，不照抄）。
+ */
+import type { XunjiResItem } from './request.js';
+import type { RateLimiterDeps } from './rateLimit.js';
+import type { UpsertOptions, UpsertOutcome } from './upsert.js';
+import type { PlanSessionRow } from '../workout/index.js';
+/** `pushDayPlan` 要的 session 形状（`planSource.ts` 给的就是这形；`movements` 缺时当空表）。 */
+export type PushSession = Pick<PlanSessionRow, 'session_label' | 'movements'>;
+/** 一个 session 的推送结果（老 `:179-185` 五键；`resp` 失败时为结构化失败，不吞）。 */
+export interface PushSessionResult {
+    readonly session_label: string;
+    readonly client_request_id: string;
+    readonly ok: boolean;
+    /** 响应里真看得到 train（老 `:183`）；dry-run 时为 false（没调接口，不断言写入）。 */
+    readonly verified: boolean;
+    /** 成功时为训记正文／dry-run 摘要；失败时为 `{ err: true, …失败读数 }`。 */
+    readonly resp: unknown;
+}
+/** 一天的推送汇总（老 `:187-197`；`note` 只在无 session 时出现）。 */
+export interface PushDaySummary {
+    readonly date: string;
+    readonly session_count: number;
+    readonly results: readonly PushSessionResult[];
+    readonly ok_count: number;
+    readonly fail_count: number;
+    readonly verify_note: string;
+    readonly note?: string;
+}
+/** `pushDayPlan` 的可注入件（测试挡板从这里进；生产全缺省）。 */
+export interface PushDayDeps {
+    /** 只转不调（仍过转换与汇总；不限频、不记限频，老 `push.py:156` 同述）。 */
+    readonly dryRun?: boolean;
+    /** upsert 调用（缺省走 `upsertTrains`；测试给挡板，**不许打真接口**）。 */
+    readonly upsert?: (resItem: XunjiResItem, clientRequestId: string) => Promise<UpsertOutcome>;
+    /** upsert 缺省路径的透传件（`key／transport／timeoutMs／maxRetries／sleep`，见 `UpsertOptions`）。 */
+    readonly upsertOpts?: UpsertOptions;
+    /** 限频门的可注入件（时钟／睡眠／状态文件，见 `RateLimiterDeps`）。 */
+    readonly rateLimit?: RateLimiterDeps;
+}
+/** 推一天（`dateStr` 原样进 `res[].datestr` 与幂等键前缀，不做任何日期换算）。 */
+export declare function pushDayPlan(dateStr: string, sessions: readonly PushSession[], deps?: PushDayDeps): Promise<PushDaySummary>;
+//# sourceMappingURL=push.d.ts.map

package/dist/xunji/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/xunji/push.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,EAAE,eAAe,GAAG,WAAW,CAAC,CAAC;AAE9E,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7F,qFAAqF;IACrF,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;IACpC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;CACtC;AAeD,0DAA0D;AAC1D,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoCpI"}

package/dist/xunji/push.js

@@ -0,0 +1,69 @@
+/** 推一天的训练计划（老 `xunji_bridge/push.py:push_day_plan`，`:113-197`，代码新写）。
+ *
+ * 行为（逐条对老）：
+ * - 入参是**日期 ＋ 当天的 sessions**（读库取天是 `planSource.ts` 的活；本件只转＋推）；
+ * - 无 session 即回 `session_count: 0` ＋ `note`（老 `:135-143`），不算失败；
+ * - 每个 session 一个 `client_request_id`：`{date}_{label}_{uuid8}`（老 `:151-153`，
+ *   语义前缀便查日志、短 uuid 防训记去重）；
+ * - 逐个 upsert，每次调用前过 45 秒限频门（`rateLimit.ts`；老 `:156-158` 的“睡够再调”保留，
+ *   跨段／跨天一视同仁是本票修掉的那条，见该件决议）；
+ * - 汇总 `{date, session_count, results, ok_count, fail_count, verify_note}`（老 `:187-197`）；
+ * - `verified` 只在响应里真看得到 train 才 true（训记 v2 响应缺陷，老 `:173-184` 同述，
+ *   真值以 `fetch --full` 为准，归 #608）；
+ * - 失败不吞：每条结果带原响应／结构化失败，`fail_count` 进退出码（见 `exitMap.ts`；
+ *   老 `sync_plan.py:337-339` “只打印不进退出码”是缺陷，不照抄）。
+ */
+import { randomUUID } from 'node:crypto';
+import { sessionToResItem } from './request.js';
+import { createRateLimiter } from './rateLimit.js';
+import { upsertTrains } from './upsert.js';
+/** 响应里有没有 train（老 `:176-184`：`res.trains` 非空数组才算强证据）。 */
+function hasTrains(response) {
+    if (typeof response !== 'object' || response === null)
+        return false;
+    const res = response.res;
+    if (typeof res !== 'object' || res === null)
+        return false;
+    const trains = res.trains;
+    return Array.isArray(trains) && trains.length > 0;
+}
+const VERIFY_NOTE = '响应里 verified=True 的表示训记已显式回执；verified=False 的实际可能已写入，' +
+    '但训记 v2 接口响应缺陷导致 trains 为空——用 fetch --full 二次确认（归 #608）';
+/** 推一天（`dateStr` 原样进 `res[].datestr` 与幂等键前缀，不做任何日期换算）。 */
+export async function pushDayPlan(dateStr, sessions, deps = {}) {
+    const dryRun = deps.dryRun ?? false;
+    if (sessions.length === 0) {
+        return {
+            date: dateStr,
+            session_count: 0,
+            results: [],
+            ok_count: 0,
+            fail_count: 0,
+            verify_note: VERIFY_NOTE,
+            note: '无 session（可能休息日或计划未配置）',
+        };
+    }
+    const limiter = createRateLimiter(deps.rateLimit ?? {});
+    const callUpsert = deps.upsert ??
+        ((resItem, clientRequestId) => upsertTrains([resItem], { ...deps.upsertOpts, clientRequestId, dryRun }));
+    const results = [];
+    let ok = 0;
+    let fail = 0;
+    for (const s of sessions) {
+        const label = s.session_label ?? '';
+        const clientRequestId = dateStr + '_' + label + '_' + randomUUID().replace(/-/g, '').slice(0, 8);
+        await limiter.guard(dryRun);
+        const resItem = sessionToResItem(dateStr, s);
+        const outcome = await callUpsert(resItem, clientRequestId);
+        if (outcome.ok) {
+            ok += 1;
+            results.push({ session_label: label, client_request_id: clientRequestId, ok: true, verified: dryRun ? false : hasTrains(outcome.response), resp: outcome.response });
+        }
+        else {
+            fail += 1;
+            results.push({ session_label: label, client_request_id: clientRequestId, ok: false, verified: false, resp: { err: true, ...outcome.failure, attempts: outcome.attempts } });
+        }
+    }
+    return { date: dateStr, session_count: sessions.length, results, ok_count: ok, fail_count: fail, verify_note: VERIFY_NOTE };
+}
+//# sourceMappingURL=push.js.map

package/dist/xunji/push.js.map

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

package/dist/xunji/rateLimit.d.ts

@@ -0,0 +1,49 @@
+/** 推送限频：45 秒常量（唯一定义地）＋ 窗口判定 ＋ 跨进程节流器。
+ *
+ * 老口径（只读参照 `xunji_bridge/push.py:29`、`push.py:156-158`、`run_sync.py:178-190`）：
+ * - 常量 `RATE_LIMIT_SECONDS = 45`（老 `push.py:29`，注释“训记写 API 限频要求（应用层策略）”）；
+ * - 老实现只守“同一天内第 2 个 session 起”（`push.py:156-158` 的 `if i > 0`），跨天不守
+ *   （`run-sync` 逐天起子进程，天与天之间无 sleep）、`--dry-run` 不守、`overlay` 不守。
+ *
+ * 本票决议（票面点名“本票内定并写进口径”）：
+ * - **按段逐个守**：每次 upsert 调用前都看“距上次 upsert 过去了多久”，窗口内先睡够再调
+ *   （老行为“睡够再调”保留，见 `push.py:157-158`；`--dry-run` 仍不守不记，老 `:156` 同述）；
+ * - **跨天／跨进程也守**（把“跨天不守”当缺陷修掉）：上次调用时刻落在盘上状态文件里，
+ *   不同进程的两次 `push-plan` 照样排开（老读侧已有同法先例：`auth.py:40` 的
+ *   `~/.mavis/xunji_bridge_rate.json` 跨进程状态）；
+ * - 时钟／睡眠／状态文件**全可注入**：生产走真实时间与 `<状态目录>/xunji_push_rate.json`
+ *   （状态目录＝配置 `xunji.stateDir`，空＝`~/.mavis`；见 `xunjiStateDir()`），
+ *   测试一律注入（不许睡真 45 秒，更不许碰真机状态文件）。
+ */
+/** 训记写接口限频窗口（秒）。老 `push.py:29` 同值；全模块只此一处，别处引用。 */
+export declare const RATE_LIMIT_SECONDS = 45;
+/** 状态文件目录的**唯一定义地**（读侧限频／写侧限频／同步状态三份状态文件都落这儿）：
+ *  配置里 `xunji.stateDir` 非空即用它，空串＝老落点 `~/.mavis`（老 `auth.py:40`／`run_sync.py:32` 同路径）。
+ *  #676：这里原先各自硬写 `join(homedir(), '.mavis')`，三处同式；收成一处，配置也只读一处。 */
+export declare function xunjiStateDir(): string;
+/** 缺省状态文件：状态目录下与读侧分开的一份（读侧是 `xunji_bridge_rate.json`，`auth.py:40`）。 */
+export declare function defaultRateLimitPath(): string;
+/** 窗口内还差多少毫秒（纯函数）：无历史／已出窗返 0，窗内返剩余量（>0）。 */
+export declare function rateLimitWaitMs(lastCallMs: number | null, nowMs: number, windowSeconds?: number): number;
+/** 节流器的可注入件（测试挡板从这里进；生产缺省见 `createRateLimiter`）。 */
+export interface RateLimiterDeps {
+    /** 现在（毫秒，缺省 `Date.now`）。 */
+    readonly now?: () => number;
+    /** 睡眠（毫秒，缺省真实 sleep）。 */
+    readonly sleep?: (ms: number) => Promise<void>;
+    /** 状态文件路径（缺省 `defaultRateLimitPath()`；传 null 即只记内存、不落盘）。 */
+    readonly statePath?: string | null;
+}
+/** 一次 upsert 调用前的限频门：窗内先睡够（返回睡了多少毫秒），并记下本次时刻。 */
+export interface RateLimiter {
+    /** 睡够再走；`dryRun` 时直接返 0（不睡不记，老 `push.py:156` 同述）。 */
+    guard(dryRun: boolean): Promise<{
+        waitedMs: number;
+        stateSaved: boolean;
+    }>;
+}
+/** 建节流器（`windowSeconds` 只供测试加速窗口换算；生产一律缺省 45 秒）。 */
+export declare function createRateLimiter(deps?: RateLimiterDeps, windowSeconds?: number): RateLimiter;
+/** 状态文件是否存在（测试断言“落盘了没有”用；生产不用它做判定）。 */
+export declare function rateLimitStateExists(statePath: string): boolean;
+//# sourceMappingURL=rateLimit.d.ts.map

package/dist/xunji/rateLimit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimit.d.ts","sourceRoot":"","sources":["../../src/xunji/rateLimit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,KAAK,CAAC;AAErC;;mEAEmE;AACnE,wBAAgB,aAAa,IAAI,MAAM,CAGtC;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,GAAE,MAA2B,GAAG,MAAM,CAI5H;AAED,oDAAoD;AACpD,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAkCD,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC5E;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,eAAoB,EAAE,aAAa,GAAE,MAA2B,GAAG,WAAW,CAyBrH;AAED,uCAAuC;AACvC,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE/D"}