skill-calorie 0.2.3 → 0.2.5

package/dist/xunji/exitMap.d.ts

@@ -0,0 +1,37 @@
+/** 推送链退出码：老自述 0／1／2／3／4 → 新仓 `XUNJI_EXIT_CODES` 的逐位映射（本票点名交付）。
+ *
+ * 老自述（`__main__.py:29-34`）：0 成功／1 一般错误／2 鉴权失败／3 API 报错／4 校验失败。
+ * 新仓现状两处（票面点名 #595 证据件 §六；#606 证据件 §三·2 已把模块内码定成老编号）：
+ * - 模块内码沿老编号：`XUNJI_EXIT_CODES`（`subcommands.ts:17-23`）仍是 0／1／2／3／4；
+ * - 卡路里业务面另有一套（`cli/cmd_read.ts:5`）：0／1／2／3／4／5（1 预检／2 用法／3 key／4 取数），
+ *   本模块**不跟那套**（模块对外面与老实现一模一样是 #597 裁定；两套的对照见证据件）。
+ *
+ * 逐位映射（老自述＋老实况；#595 R2 §四·4.4／§六／§八·2 实测为准，行为以老代码为准）：
+ * - 0：全部 session 成功（含无 session 的空天，老 `push.py:135-143` 同述）；
+ * - 1：用法错（`--json` 二选一违例／JSON 解析失败／非数组／日期形状错／取数口 `found: false`），
+ *   兼收“环境通道缺失”类配置错。老 argparse 用法错退 2（★不照抄：与鉴权码撞车，#606 同例——此条是本表唯一的修正式映射）；
+ * - 2：**本地没配 KEY**（没调网；老 `__main__.py:117-119／:207-209` 同位）。
+ *   自述的“2 鉴权失败”**只覆盖这一支**（#595 §八·2 实测）；
+ * - 3：接口报错——**服务端 401／403**（KEY 不被认；老实况：调用侧只看 `err` 即退 3，
+ *   `__main__.py:211-212`）、`vip_required`／`validation`（400／响应解析失败）／限频耗尽／
+ *   服务端 5xx／超时与网络耗尽／未分类。判据是有没有发生 HTTP：`auth` 且无状态码＝本地缺 KEY→2，
+ *   `auth` 且有状态码＝服务端拒绝→3；
+ * - 4：本链不用（`verify` 专位，#606）；`--dry-run` 成功走 0（老 `:213` 同述）。
+ */
+import type { XunjiFailure } from './retry.js';
+/** 映射表的一行（证据件逐字引用本表，不另抄一份）。 */
+export interface PushExitRow {
+    /** 老码（自述；“实况”列写实测行为，★＝修正式映射）。 */
+    readonly oldCode: number | null;
+    /** 哪件事。 */
+    readonly event: string;
+    /** 新仓推送链退出码。 */
+    readonly code: number;
+    /** 备注（含老 file:line 出处）。 */
+    readonly note: string;
+}
+/** 老 → 新逐位映射表（本表即证据件里的那张表，唯一定义地）。 */
+export declare const PUSH_EXIT_TABLE: readonly PushExitRow[];
+/** 失败 → 退出码：`auth` 且无 HTTP 状态码＝本地缺 KEY→2；其余（含服务端 401／403）一律→3。 */
+export declare function exitForFailure(f: Pick<XunjiFailure, 'error_type' | 'code'>): number;
+//# sourceMappingURL=exitMap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exitMap.d.ts","sourceRoot":"","sources":["../../src/xunji/exitMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,+BAA+B;AAC/B,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW;IACX,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,qCAAqC;AACrC,eAAO,MAAM,eAAe,EAAE,SAAS,WAAW,EAYjD,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAAC,GAAG,MAAM,CAGnF"}

package/dist/xunji/exitMap.js

@@ -0,0 +1,42 @@
+/** 推送链退出码：老自述 0／1／2／3／4 → 新仓 `XUNJI_EXIT_CODES` 的逐位映射（本票点名交付）。
+ *
+ * 老自述（`__main__.py:29-34`）：0 成功／1 一般错误／2 鉴权失败／3 API 报错／4 校验失败。
+ * 新仓现状两处（票面点名 #595 证据件 §六；#606 证据件 §三·2 已把模块内码定成老编号）：
+ * - 模块内码沿老编号：`XUNJI_EXIT_CODES`（`subcommands.ts:17-23`）仍是 0／1／2／3／4；
+ * - 卡路里业务面另有一套（`cli/cmd_read.ts:5`）：0／1／2／3／4／5（1 预检／2 用法／3 key／4 取数），
+ *   本模块**不跟那套**（模块对外面与老实现一模一样是 #597 裁定；两套的对照见证据件）。
+ *
+ * 逐位映射（老自述＋老实况；#595 R2 §四·4.4／§六／§八·2 实测为准，行为以老代码为准）：
+ * - 0：全部 session 成功（含无 session 的空天，老 `push.py:135-143` 同述）；
+ * - 1：用法错（`--json` 二选一违例／JSON 解析失败／非数组／日期形状错／取数口 `found: false`），
+ *   兼收“环境通道缺失”类配置错。老 argparse 用法错退 2（★不照抄：与鉴权码撞车，#606 同例——此条是本表唯一的修正式映射）；
+ * - 2：**本地没配 KEY**（没调网；老 `__main__.py:117-119／:207-209` 同位）。
+ *   自述的“2 鉴权失败”**只覆盖这一支**（#595 §八·2 实测）；
+ * - 3：接口报错——**服务端 401／403**（KEY 不被认；老实况：调用侧只看 `err` 即退 3，
+ *   `__main__.py:211-212`）、`vip_required`／`validation`（400／响应解析失败）／限频耗尽／
+ *   服务端 5xx／超时与网络耗尽／未分类。判据是有没有发生 HTTP：`auth` 且无状态码＝本地缺 KEY→2，
+ *   `auth` 且有状态码＝服务端拒绝→3；
+ * - 4：本链不用（`verify` 专位，#606）；`--dry-run` 成功走 0（老 `:213` 同述）。
+ */
+import { XUNJI_EXIT_CODES } from './subcommands.js';
+/** 老 → 新逐位映射表（本表即证据件里的那张表，唯一定义地）。 */
+export const PUSH_EXIT_TABLE = [
+    { oldCode: 0, event: '全部 session 推送成功（含无 session 的空天）', code: XUNJI_EXIT_CODES.ok, note: '老 __main__.py:121-123（fail_count=0 即 0）' },
+    { oldCode: 0, event: '--dry-run 转换成功（未调接口）', code: XUNJI_EXIT_CODES.ok, note: '老 __main__.py:213（无 err 即 0）' },
+    { oldCode: 1, event: '用法错：--json 二选一违例／JSON 解析失败／res[] 非数组', code: XUNJI_EXIT_CODES.error, note: '老 __main__.py:166-181 同位' },
+    { oldCode: 2, event: '用法错：argparse 参数错（缺参／未知参）', code: XUNJI_EXIT_CODES.error, note: '★老 argparse 自身退 2（__main__.py:246）；与鉴权码撞车，新仓一律退 1（#606 同例）' },
+    { oldCode: null, event: '入参／取数失败：日期形状错／计划来源读不出／库文件不在', code: XUNJI_EXIT_CODES.error, note: '新仓新增的明确失败（老直接抛穿，t350 §三·2；“失败不许静默吞”）' },
+    { oldCode: 2, event: '本地没配 KEY', code: XUNJI_EXIT_CODES.auth, note: '老 __main__.py:117-119／207-209 同位；自述 2 只覆盖此支（#595 §八·2）' },
+    { oldCode: 3, event: '服务端 401／403（KEY 不被认）', code: XUNJI_EXIT_CODES.api, note: '老实况退 3（#595 §四·4.4／§六：调用侧只看 err 即 EXIT_API，__main__.py:211-212）；行为以老代码为准' },
+    { oldCode: 3, event: 'vip_required（仅 VIP 可用）', code: XUNJI_EXIT_CODES.api, note: '老 errors.py:270-271 不重试 → __main__.py:211-212 退 3，同位' },
+    { oldCode: 3, event: 'validation（400／响应 JSON 解析失败）', code: XUNJI_EXIT_CODES.api, note: '老 errors.py:273-274 不重试 → 退 3，同位' },
+    { oldCode: 3, event: '限频／服务端 5xx／超时网络／未分类（重试耗尽）', code: XUNJI_EXIT_CODES.api, note: '老 errors.py:275 重试 → upsert.py:136-138 带 err 回 → 退 3，同位' },
+    { oldCode: null, event: '校验位 4', code: XUNJI_EXIT_CODES.invalid, note: '本链不用（verify 专位，#606 §三·2）；推送前不校验动作库' },
+];
+/** 失败 → 退出码：`auth` 且无 HTTP 状态码＝本地缺 KEY→2；其余（含服务端 401／403）一律→3。 */
+export function exitForFailure(f) {
+    if (f.error_type === 'auth' && f.code === null)
+        return XUNJI_EXIT_CODES.auth;
+    return XUNJI_EXIT_CODES.api;
+}
+//# sourceMappingURL=exitMap.js.map

package/dist/xunji/exitMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exitMap.js","sourceRoot":"","sources":["../../src/xunji/exitMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAepD,qCAAqC;AACrC,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,yCAAyC,EAAE;IACpI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,8BAA8B,EAAE;IAC9G,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,0BAA0B,EAAE;IAC7H,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,4DAA4D,EAAE;IACnJ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,6BAA6B,EAAE,IAAI,EAAE,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,sCAAsC,EAAE;IACnI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,wDAAwD,EAAE;IAC9H,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,0EAA0E,EAAE;IAC3J,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,sDAAsD,EAAE;IACzI,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,kCAAkC,EAAE;IAC3H,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,2BAA2B,EAAE,IAAI,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,yDAAyD,EAAE;IAC/I,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,qCAAqC,EAAE;CAC/G,CAAC;AAEF,kEAAkE;AAClE,MAAM,UAAU,cAAc,CAAC,CAA4C;IACzE,IAAI,CAAC,CAAC,UAAU,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC;IAC7E,OAAO,gBAAgB,CAAC,GAAG,CAAC;AAC9B,CAAC"}

package/dist/xunji/fetch.d.ts

@@ -0,0 +1,76 @@
+/** 回写链读口：拉某天训记实绩（老 `xunji_bridge/fetch.py`，代码新写；只读，不改库）。
+ *
+ * 口径（逐条对老）：
+ * - 接口 `POST https://trains.xunjiapp.cn/api_trains_for_llm_v2`（老 `fetch.py:43-44`）；
+ * - 包体三键 `schema_version／datestr／include_full_data`（老 `:68-72`），`datestr` 原样送；
+ * - 超时缺省 30 秒（老 `:47` 的 `timeout=30`），超时走 `network` 进重试（老 `:107-110`）；
+ * - 重试 `max_retries=2`（老 `:113`），分类与退避走 `retry.ts`（软错误同判，老 `:94-101`）；
+ * - 限频档 `full=30s／light=15s`（老 `auth.py:42-44`），缺省**不守**（老 `:47` 缺省关）；
+ *   开关打开时才看状态文件 `<状态目录>/xunji_bridge_rate.json`（老 `:40` 同件名；目录＝配置 `xunji.stateDir`）；
+ * - 无 KEY 直接失败（老 `:66` 的 `require_key` 抛错位），不调网、不重试；
+ * - `attempts > 1` 才回写（老 `:114-115`）；
+ * - 响应 `gzip` 由运行时自动解（Node 全局 fetch 缺省解压；老 `:89-90` 手工解是 urllib 才要的）。
+ *
+ * #676 · KEY 口径住 `key.ts`（配置文件里的 `xunji.key`；环境变量读取已删）。 */
+import type { XunjiCallOutcome } from './retry.js';
+import type { UpsertTransport } from './upsert.js';
+/** 拉取接口地址（老 `fetch.py:43-44` 同值；全模块只此一处）。 */
+export declare const XUNJI_FETCH_ENDPOINT = "https://trains.xunjiapp.cn/api_trains_for_llm_v2";
+/** 拉取限频两档（秒；老 `auth.py:42-44` 同值；全模块只此一处，别处引用）。 */
+export declare const FETCH_RATE_LIMIT_SECONDS: {
+    readonly full: 30;
+    readonly light: 15;
+};
+/** 缺省限频状态文件（老 `auth.py:40` 同件名，目录＝`xunjiStateDir()`；与推送侧 `xunji_push_rate.json` 分开）。 */
+export declare function defaultFetchRateLimitPath(): string;
+/** `fetchTrains` 的可注入件（测试挡板从这里进；生产全缺省）。 */
+export interface FetchOptions {
+    /** 回写恒 true（要 `done` 标记，老 `backfill.py:76`）；`fetch` 子命令按 `--full` 走。 */
+    readonly includeFullData?: boolean;
+    /** 显式 KEY（给了就不用 `readKey`）。 */
+    readonly key?: string | null;
+    /** KEY 来源（缺省读环境变量；#610 后改走能力门）。 */
+    readonly readKey?: () => string | null;
+    /** 传输（缺省全局 fetch；与推送侧同形状）。 */
+    readonly transport?: UpsertTransport;
+    /** 超时毫秒（缺省 30000，老 `:47` 的 `timeout=30`）。 */
+    readonly timeoutMs?: number;
+    /** 重试次数（缺省 2，老 `:113`）。 */
+    readonly maxRetries?: number;
+    /** 睡眠（缺省真实 sleep；重试退避与限频等待共用）。 */
+    readonly sleep?: (ms: number) => Promise<void>;
+    /** 打开限频等待（缺省 false，老缺省关；回写链经本开关显式打开）。 */
+    readonly respectRateLimit?: boolean;
+    /** 现在（毫秒；限频门用；缺省 `Date.now`）。 */
+    readonly now?: () => number;
+    /** 限频状态文件（缺省 `defaultFetchRateLimitPath()`；传 null 即不守不记）。 */
+    readonly rateLimitPath?: string | null;
+}
+/** `fetchTrains` 的结局（成功透传训记正文；失败带结构化读数）。 */
+export type FetchOutcome = XunjiCallOutcome;
+/** 拉某天（`dateStr` 原样进包体，不做任何换算；调用方保证形状）。 */
+export declare function fetchTrains(dateStr: string, opts?: FetchOptions): Promise<FetchOutcome>;
+/** 可读 set（老 `parse_trains`，`fetch.py:130-136` 五键；回写不用它，用 `rows.ts`）。 */
+export interface FetchTrainSet {
+    readonly index: unknown;
+    readonly done: unknown;
+    readonly weight: unknown;
+    readonly unit: unknown;
+    readonly reps: unknown;
+}
+/** 可读 movement（老 `:137-140` 两键）。 */
+export interface FetchTrainMovement {
+    readonly name: unknown;
+    readonly sets: readonly FetchTrainSet[];
+}
+/** 可读训练（老 `:141-147` 五键）。 */
+export interface FetchTrain {
+    readonly localid: unknown;
+    readonly title: unknown;
+    readonly datestr: unknown;
+    readonly difficulty: unknown;
+    readonly movements: readonly FetchTrainMovement[];
+}
+/** 训记响应 → 可读训练列表（每条 session 一项；形状不对即空表，不抛）。 */
+export declare function parseTrains(response: unknown): FetchTrain[];
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/xunji/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;2DAa2D;AAK3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,6CAA6C;AAC7C,eAAO,MAAM,oBAAoB,qDAAqD,CAAC;AAEvF,mDAAmD;AACnD,eAAO,MAAM,wBAAwB;;;CAAmC,CAAC;AAEzE,wFAAwF;AACxF,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,+BAA+B;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACvC,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,eAAe,CAAC;IACrC,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,yCAAyC;IACzC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,4CAA4C;AAC5C,MAAM,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAqC5C,2CAA2C;AAC3C,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8DjG;AAYD,wEAAwE;AACxE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;CACzC;AAED,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD;AAUD,+CAA+C;AAC/C,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,GAAG,UAAU,EAAE,CAc3D"}

package/dist/xunji/fetch.js

@@ -0,0 +1,159 @@
+/** 回写链读口：拉某天训记实绩（老 `xunji_bridge/fetch.py`，代码新写；只读，不改库）。
+ *
+ * 口径（逐条对老）：
+ * - 接口 `POST https://trains.xunjiapp.cn/api_trains_for_llm_v2`（老 `fetch.py:43-44`）；
+ * - 包体三键 `schema_version／datestr／include_full_data`（老 `:68-72`），`datestr` 原样送；
+ * - 超时缺省 30 秒（老 `:47` 的 `timeout=30`），超时走 `network` 进重试（老 `:107-110`）；
+ * - 重试 `max_retries=2`（老 `:113`），分类与退避走 `retry.ts`（软错误同判，老 `:94-101`）；
+ * - 限频档 `full=30s／light=15s`（老 `auth.py:42-44`），缺省**不守**（老 `:47` 缺省关）；
+ *   开关打开时才看状态文件 `<状态目录>/xunji_bridge_rate.json`（老 `:40` 同件名；目录＝配置 `xunji.stateDir`）；
+ * - 无 KEY 直接失败（老 `:66` 的 `require_key` 抛错位），不调网、不重试；
+ * - `attempts > 1` 才回写（老 `:114-115`）；
+ * - 响应 `gzip` 由运行时自动解（Node 全局 fetch 缺省解压；老 `:89-90` 手工解是 urllib 才要的）。
+ *
+ * #676 · KEY 口径住 `key.ts`（配置文件里的 `xunji.key`；环境变量读取已删）。 */
+import { dirname, join } from 'node:path';
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { classifyStatusBody, classifyThrown, retryWithBackoff, softFailureOf } from './retry.js';
+import { xunjiStateDir } from './rateLimit.js';
+import { readKey } from './key.js';
+/** 拉取接口地址（老 `fetch.py:43-44` 同值；全模块只此一处）。 */
+export const XUNJI_FETCH_ENDPOINT = 'https://trains.xunjiapp.cn/api_trains_for_llm_v2';
+/** 拉取限频两档（秒；老 `auth.py:42-44` 同值；全模块只此一处，别处引用）。 */
+export const FETCH_RATE_LIMIT_SECONDS = { full: 30, light: 15 };
+/** 缺省限频状态文件（老 `auth.py:40` 同件名，目录＝`xunjiStateDir()`；与推送侧 `xunji_push_rate.json` 分开）。 */
+export function defaultFetchRateLimitPath() {
+    return join(xunjiStateDir(), 'xunji_bridge_rate.json');
+}
+function readRateState(statePath) {
+    try {
+        return JSON.parse(readFileSync(statePath, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+function secondsSince(statePath, full, nowMs) {
+    const key = full ? 'last_full_call_iso' : 'last_light_call_iso';
+    const iso = readRateState(statePath)[key];
+    if (typeof iso !== 'string' || iso === '')
+        return null;
+    const ms = Date.parse(iso);
+    return Number.isFinite(ms) ? (nowMs - ms) / 1000 : null;
+}
+function stampCall(statePath, full, nowMs) {
+    try {
+        const prev = readRateState(statePath);
+        const key = full ? 'last_full_call_iso' : 'last_light_call_iso';
+        mkdirSync(dirname(statePath), { recursive: true });
+        const tmp = statePath + '.tmp';
+        writeFileSync(tmp, JSON.stringify({ ...prev, [key]: new Date(nowMs).toISOString() }, null, 2), 'utf8');
+        renameSync(tmp, statePath);
+    }
+    catch {
+        /* 状态写坏不许堵死拉取（坏文件当无历史，老 `auth.py:207-212` 同口径） */
+    }
+}
+/** 拉某天（`dateStr` 原样进包体，不做任何换算；调用方保证形状）。 */
+export async function fetchTrains(dateStr, opts = {}) {
+    const full = opts.includeFullData ?? false;
+    const sleep = opts.sleep ?? ((ms) => new Promise((resolve) => { setTimeout(resolve, ms); }));
+    const now = opts.now ?? Date.now;
+    const statePath = opts.rateLimitPath === undefined ? defaultFetchRateLimitPath() : opts.rateLimitPath;
+    if (opts.respectRateLimit === true && statePath !== null) {
+        const threshold = full ? FETCH_RATE_LIMIT_SECONDS.full : FETCH_RATE_LIMIT_SECONDS.light;
+        const since = secondsSince(statePath, full, now());
+        if (since !== null && since < threshold)
+            await sleep((threshold - since) * 1000);
+    }
+    const key = opts.key !== undefined && opts.key !== null && opts.key !== '' ? opts.key : (opts.readKey ?? readKey)();
+    if (key === null || key === '') {
+        return {
+            ok: false,
+            failure: {
+                error_type: 'auth',
+                message: '未配置训记 KEY（配置文件里的 xunji.key；用 key set <KEY> 写进去）',
+                retry_after: null,
+                raw_body: null,
+                code: null,
+            },
+            attempts: 0,
+        };
+    }
+    const transport = opts.transport ?? defaultTransport;
+    const timeoutMs = opts.timeoutMs ?? 30000;
+    const payload = JSON.stringify({ schema_version: 'train_open_api_v2', datestr: dateStr, include_full_data: full });
+    const once = async () => {
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+        try {
+            const resp = await transport(XUNJI_FETCH_ENDPOINT, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' + key },
+                body: payload,
+                signal: ctrl.signal,
+            });
+            const text = await resp.bodyText();
+            if (opts.respectRateLimit === true && statePath !== null)
+                stampCall(statePath, full, now());
+            let parsed = text;
+            try {
+                parsed = JSON.parse(text);
+            }
+            catch {
+                return {
+                    ok: false,
+                    failure: { error_type: 'validation', message: '响应 JSON 解析失败', retry_after: null, raw_body: text.slice(0, 200), code: resp.status },
+                    attempts: 1,
+                };
+            }
+            if (resp.status >= 200 && resp.status < 300) {
+                const soft = softFailureOf(parsed);
+                if (soft !== null)
+                    return { ok: false, failure: soft, attempts: 1 };
+                return { ok: true, response: parsed, attempts: 1 };
+            }
+            return { ok: false, failure: classifyStatusBody(resp.status, parsed, text.slice(0, 2000)), attempts: 1 };
+        }
+        catch (e) {
+            return { ok: false, failure: classifyThrown(e), attempts: 1 };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    };
+    return retryWithBackoff(once, opts.maxRetries ?? 2, 5000, sleep);
+}
+/** 缺省传输（全局 fetch；缺失即明确失败，不静默）。 */
+const defaultTransport = (url, init) => {
+    const f = globalThis.fetch;
+    if (typeof f !== 'function')
+        return Promise.reject(new Error('HTTP 通道不可用：全局 fetch 缺失'));
+    return f(url, init).then((r) => ({
+        status: r.status,
+        bodyText: () => r.text(),
+    }));
+};
+function asRecord(v) {
+    return typeof v === 'object' && v !== null ? v : {};
+}
+function asList(v) {
+    return Array.isArray(v) ? v : [];
+}
+/** 训记响应 → 可读训练列表（每条 session 一项；形状不对即空表，不抛）。 */
+export function parseTrains(response) {
+    const trains = asList(asRecord(asRecord(response).res).trains);
+    return trains.map((t) => {
+        const train = asRecord(t);
+        const movements = asList(train.movements).map((m) => {
+            const move = asRecord(m);
+            const sets = asList(move.sets).map((s) => {
+                const set = asRecord(s);
+                return { index: set.index, done: set.done, weight: set.weight, unit: set.unit, reps: set.reps };
+            });
+            return { name: move.name, sets };
+        });
+        return { localid: train.localid, title: train.title, datestr: train.datestr, difficulty: train.difficulty, movements };
+    });
+}
+//# sourceMappingURL=fetch.js.map

package/dist/xunji/fetch.js.map

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

package/dist/xunji/index.d.ts

@@ -0,0 +1,21 @@
+/** 卡路里 · **训记模块**的能力门（#606 骨架票）。
+ *
+ * 对外给**五件**（别的能力或命令用它，只经这五件）：
+ *   ① `XUNJI_SUBCOMMANDS` —— 8 条子命令的对外面（名字／用法／参数／退出码／实现状态／归属票，唯一定义地）；
+ *   ② `XUNJI_CATALOG` —— 动作库路径两档（包内预置快照＝默认；老的机器路径＝只作显式覆盖）；
+ *   ③ `readMovementCatalog` —— 读库（读到什么／为什么读不到，缺文件不抛错）；
+ *   ④ `verifyMovements` —— 动作名校验（老三态 valid／false／null ＋ 库缺失的明确读数）；
+ *   ⑤ `runXunjiCommand` —— 按声明分派一条子命令（本票只有 `verify` 真跑）。
+ *
+ * 目录名与 HELP 一级分组无关：这是**负责人 2026-09-16 的显式例外**（#597 决议：单开 `src/xunji/`，不挂
+ * `workout/`），展示名仍用「训记」；依据是 R1／R2／R3 三张研究票 ＋ 本票票面。
+ * 模块内部件（`subcommands.ts`／`catalog.ts`／`run.ts`／`cli.ts`）与数据件（`data/训记官方动作.json`）
+ * **不许被别的目录深引**。
+ */
+export { XUNJI_SUBCOMMANDS } from './subcommands.js';
+export type { XunjiSubcommand, XunjiArg } from './subcommands.js';
+export { XUNJI_CATALOG, readMovementCatalog, verifyMovements } from './catalog.js';
+export type { CatalogRead, MovementVerifyReport } from './catalog.js';
+export { runXunjiCommand } from './run.js';
+export type { XunjiRun } from './run.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xunji/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACnF,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,YAAY,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC"}

package/dist/xunji/index.js

@@ -0,0 +1,18 @@
+/** 卡路里 · **训记模块**的能力门（#606 骨架票）。
+ *
+ * 对外给**五件**（别的能力或命令用它，只经这五件）：
+ *   ① `XUNJI_SUBCOMMANDS` —— 8 条子命令的对外面（名字／用法／参数／退出码／实现状态／归属票，唯一定义地）；
+ *   ② `XUNJI_CATALOG` —— 动作库路径两档（包内预置快照＝默认；老的机器路径＝只作显式覆盖）；
+ *   ③ `readMovementCatalog` —— 读库（读到什么／为什么读不到，缺文件不抛错）；
+ *   ④ `verifyMovements` —— 动作名校验（老三态 valid／false／null ＋ 库缺失的明确读数）；
+ *   ⑤ `runXunjiCommand` —— 按声明分派一条子命令（本票只有 `verify` 真跑）。
+ *
+ * 目录名与 HELP 一级分组无关：这是**负责人 2026-09-16 的显式例外**（#597 决议：单开 `src/xunji/`，不挂
+ * `workout/`），展示名仍用「训记」；依据是 R1／R2／R3 三张研究票 ＋ 本票票面。
+ * 模块内部件（`subcommands.ts`／`catalog.ts`／`run.ts`／`cli.ts`）与数据件（`data/训记官方动作.json`）
+ * **不许被别的目录深引**。
+ */
+export { XUNJI_SUBCOMMANDS } from './subcommands.js';
+export { XUNJI_CATALOG, readMovementCatalog, verifyMovements } from './catalog.js';
+export { runXunjiCommand } from './run.js';
+//# sourceMappingURL=index.js.map

package/dist/xunji/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/xunji/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEnF,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/xunji/key.d.ts

@@ -0,0 +1,37 @@
+import type { XunjiSubcommand } from './subcommands.js';
+import type { XunjiRun } from './run.js';
+/** KEY 在配置文件里的落点（全模块只此一处；设置页的行名与它同源）。 */
+export declare const XUNJI_KEY_FIELD = "xunji.key";
+/** 当前生效的 KEY（配置文件里的那一项，空串当没配）。 */
+export declare function readKey(): string | null;
+/** 预览：前 4 字＋`...`＋末 2 字（老 `auth.py:177` 原样）；短串只回等长星号，不漏全串。 */
+export declare function previewKey(key: string): string | null;
+/** `status` 的读数（**无全串位**——全串永不进读数）。 */
+export interface KeyStatus {
+    readonly key_field: string;
+    readonly configured: boolean;
+    readonly active_key_preview: string | null;
+    readonly recommendation: string;
+}
+/** 状态报告（老 `status`；只读配置，不调网不落盘）。 */
+export declare function keyStatus(): KeyStatus;
+/** 设置 KEY（空／超长拒绝；成功即写盘，下次调用（含子进程）生效）。 */
+export declare function setKey(value: string): {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+/** 删除 KEY（写回空串；本来没配即幂等成功）。 */
+export declare function clearKey(): {
+    readonly ok: true;
+    readonly had: boolean;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+type Values = Readonly<Record<string, string | boolean | readonly string[]>>;
+/** `key` 子命令的分派（`run.ts` 调；`status` 无 KEY 退 2，`set／clear` 走 0／1）。 */
+export declare function runKeyCommand(sub: XunjiSubcommand, values: Values): Promise<XunjiRun>;
+export {};
+//# sourceMappingURL=key.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/xunji/key.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,yCAAyC;AACzC,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,kCAAkC;AAClC,wBAAgB,OAAO,IAAI,MAAM,GAAG,IAAI,CAGvC;AAED,8DAA8D;AAC9D,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrD;AAED,uCAAuC;AACvC,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,oCAAoC;AACpC,wBAAgB,SAAS,IAAI,SAAS,CAUrC;AAcD,yCAAyC;AACzC,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,GACZ;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAKxE;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,IAAI;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAIxH;AAED,KAAK,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;AAE7E,qEAAqE;AACrE,wBAAsB,aAAa,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAsC3F"}

package/dist/xunji/key.js

@@ -0,0 +1,100 @@
+import { loadCalorieConfig, saveCalorieConfig } from '../config.js';
+import { XUNJI_EXIT_CODES } from './subcommands.js';
+/** KEY 在配置文件里的落点（全模块只此一处；设置页的行名与它同源）。 */
+export const XUNJI_KEY_FIELD = 'xunji.key';
+/** 当前生效的 KEY（配置文件里的那一项，空串当没配）。 */
+export function readKey() {
+    const value = loadCalorieConfig().values.xunji.key.trim();
+    return value !== '' ? value : null;
+}
+/** 预览：前 4 字＋`...`＋末 2 字（老 `auth.py:177` 原样）；短串只回等长星号，不漏全串。 */
+export function previewKey(key) {
+    if (key === '')
+        return null;
+    if (key.length < 7)
+        return '*'.repeat(key.length);
+    return key.slice(0, 4) + '...' + key.slice(-2);
+}
+/** 状态报告（老 `status`；只读配置，不调网不落盘）。 */
+export function keyStatus() {
+    const active = readKey();
+    return {
+        key_field: XUNJI_KEY_FIELD,
+        configured: active !== null,
+        active_key_preview: active === null ? null : previewKey(active),
+        recommendation: active !== null
+            ? 'OK'
+            : '未配置，请在卡路里设置页里填「训记 KEY」，或用 key set <KEY> 写进配置文件',
+    };
+}
+/** 把 KEY 写进配置文件（写给的是**完整一份**：没给的项由配置件按默认值补齐）。 */
+function writeKey(value) {
+    try {
+        const values = loadCalorieConfig().values;
+        const next = { ...values, xunji: { ...values.xunji, key: value } };
+        saveCalorieConfig(next);
+        return { ok: true };
+    }
+    catch (e) {
+        return { ok: false, error: '写配置文件失败：' + (e instanceof Error ? e.message : String(e)) };
+    }
+}
+/** 设置 KEY（空／超长拒绝；成功即写盘，下次调用（含子进程）生效）。 */
+export function setKey(value) {
+    const trimmed = (value ?? '').trim();
+    if (trimmed === '')
+        return { ok: false, error: 'KEY 不能为空' };
+    if (trimmed.length > 1024)
+        return { ok: false, error: 'KEY 过长（> 1024 字符），疑似输入错误' };
+    return writeKey(trimmed);
+}
+/** 删除 KEY（写回空串；本来没配即幂等成功）。 */
+export function clearKey() {
+    const had = readKey() !== null;
+    const r = writeKey('');
+    return r.ok ? { ok: true, had } : r;
+}
+/** `key` 子命令的分派（`run.ts` 调；`status` 无 KEY 退 2，`set／clear` 走 0／1）。 */
+export async function runKeyCommand(sub, values) {
+    const refuse = (why, data) => ({
+        subcommand: 'key', code: XUNJI_EXIT_CODES.error, message: why, data, stderr: why + '（用法：' + sub.usage + '）',
+    });
+    const action = values['<子动作>'];
+    if (action !== 'status' && action !== 'set' && action !== 'clear') {
+        return refuse('用法：key 的子动作只能是 status|set|clear（实际：' + String(action ?? '缺失') + '）', { usage: sub.usage });
+    }
+    if (action === 'status') {
+        const s = keyStatus();
+        if (!s.configured) {
+            const line = '未配置训记 KEY（配置项 ' + s.key_field + '；用 key set <KEY> 或设置页写进配置文件）';
+            return { subcommand: 'key', code: XUNJI_EXIT_CODES.auth, message: line, data: s, stderr: line };
+        }
+        return {
+            subcommand: 'key', code: XUNJI_EXIT_CODES.ok,
+            message: 'KEY 已配置（' + s.key_field + '，预览 ' + String(s.active_key_preview) + '）',
+            data: s, stderr: null,
+        };
+    }
+    if (action === 'set') {
+        const v = values['<KEY 值>'];
+        if (typeof v !== 'string')
+            return refuse('用法：key set <KEY 值>（KEY 值缺失；KEY 值不回显、不进仓）', { usage: sub.usage });
+        const r = setKey(v);
+        if (!r.ok)
+            return { subcommand: 'key', code: XUNJI_EXIT_CODES.error, message: r.error, data: { error: r.error }, stderr: r.error };
+        return {
+            subcommand: 'key', code: XUNJI_EXIT_CODES.ok,
+            message: '已写入配置文件（' + XUNJI_KEY_FIELD + '）：下次调用即生效',
+            data: { key_field: XUNJI_KEY_FIELD }, stderr: null,
+        };
+    }
+    const r = clearKey();
+    if (!r.ok)
+        return { subcommand: 'key', code: XUNJI_EXIT_CODES.error, message: r.error, data: { error: r.error }, stderr: r.error };
+    return {
+        subcommand: 'key', code: XUNJI_EXIT_CODES.ok,
+        message: r.had ? '已删除配置里的 KEY' : 'KEY 未配置，无需删除',
+        data: { key_field: XUNJI_KEY_FIELD, had: r.had }, stderr: null,
+    };
+}
+//# sourceMappingURL=key.js.map

package/dist/xunji/key.js.map

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