skill-calorie 0.2.2 → 0.2.4

package/dist/xunji/cli.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+/** 训记模块的命令行入口：模块**自己的对外面**（老 `xunji_bridge` 同形的 8 条子命令，读法见 `subcommands.ts`）。
+ *
+ * 用法：`node packages/skill-calorie/dist/xunji/cli.js <子命令> [参数…]`
+ * 产物：stdout 一行 JSON（读数）＋ 退出码（0／1／2／3／4，见 `XUNJI_EXIT_CODES`）。
+ * 定位：本入口是模块对外面的一部分（#597 负责人裁定：对外面与老实现一模一样）；
+ *       卡路里**业务面**的命令仍走 `calorie-cmd-read`（两处不混：这里不做页面、不落库）。
+ */
+import { runXunjiCommand } from './run.js';
+const run = await runXunjiCommand(process.argv.slice(2));
+if (run.stderr !== null)
+    console.error(run.stderr);
+process.stdout.write(JSON.stringify(run.data ?? { message: run.message }, null, 2) + '\n');
+process.exitCode = run.code;
+//# sourceMappingURL=cli.js.map

package/dist/xunji/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/xunji/cli.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,IAAI,GAAG,CAAC,MAAM,KAAK,IAAI;IAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC3F,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC"}

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,77 @@
+/** 回写链读口：拉某天训记实绩（老 `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` 缺省关）；
+ *   开关打开时才看状态文件 `~/.mavis/xunji_bridge_rate.json`（老 `:40` 同路径同键名）；
+ * - 无 KEY 直接失败（老 `:66` 的 `require_key` 抛错位），不调网、不重试；
+ * - `attempts > 1` 才回写（老 `:114-115`）；
+ * - 响应 `gzip` 由运行时自动解（Node 全局 fetch 缺省解压；老 `:89-90` 手工解是 urllib 才要的）。
+ *
+ * KEY 口径暂住 `upsert.ts`（`XUNJI_KEY_ENV`＋`readKeyFromEnv`；实现归 #610 的 `key.ts`）。
+ */
+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` 同路径；与推送侧 `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;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,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,mEAAmE;AACnE,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,CA+DjG;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,160 @@
+/** 回写链读口：拉某天训记实绩（老 `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` 缺省关）；
+ *   开关打开时才看状态文件 `~/.mavis/xunji_bridge_rate.json`（老 `:40` 同路径同键名）；
+ * - 无 KEY 直接失败（老 `:66` 的 `require_key` 抛错位），不调网、不重试；
+ * - `attempts > 1` 才回写（老 `:114-115`）；
+ * - 响应 `gzip` 由运行时自动解（Node 全局 fetch 缺省解压；老 `:89-90` 手工解是 urllib 才要的）。
+ *
+ * KEY 口径暂住 `upsert.ts`（`XUNJI_KEY_ENV`＋`readKeyFromEnv`；实现归 #610 的 `key.ts`）。
+ */
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { classifyStatusBody, classifyThrown, retryWithBackoff, softFailureOf } from './retry.js';
+import { XUNJI_KEY_ENV, readKeyFromEnv } from './upsert.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` 同路径；与推送侧 `xunji_push_rate.json` 分开）。 */
+export function defaultFetchRateLimitPath() {
+    return join(homedir(), '.mavis', '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 ?? readKeyFromEnv)();
+    if (key === null || key === '') {
+        return {
+            ok: false,
+            failure: {
+                error_type: 'auth',
+                message: '未配置训记 KEY（权威名 ' + XUNJI_KEY_ENV.primary + '，兼容名 ' + XUNJI_KEY_ENV.legacy + '；用 key set 设置，归 #610）',
+                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,77 @@
+/** 训记 KEY 管理（老 `xunji_bridge/auth.py:35-55／110-184`，代码新写）。
+ *
+ * 口径（逐条对老）：
+ * - 只读环境变量：`XUNJI_TRAINS_KEY` 优先，空时回退 `XUNJI_API_KEY`（老 `get_key` 同序）；
+ *   **没有密钥文件**（老机器同述）；
+ * - `status` 只回「前 4 字＋末 2 字」预览（老 `auth.py:177`），全串永不进读数／回执／日志；
+ * - `set` 写用户级系统环境：Windows 走 PowerShell 写 `HKCU\Environment`
+ *   （值走 base64 进子进程，无注入风险；老 `winreg` 直写同位），成功后同步当前进程；
+ * - `clear` 删用户级变量（本来没设即幂等成功，老 `clear_key` 同述）；
+ * - 值校验：空拒绝／超 1024 字符拒绝（老 `set_key` 同值）。
+ *
+ * 本件是 KEY 两名＋缺省读法的**唯一定义地**（`upsert.ts`／`fetch.ts` 经由本件，
+ * 前者薄转出保既有引用不断；#607 §八·6／#608 §八·7 的暂住到此收口）。
+ * 短 KEY（< 7 字）不套预览公式（公式会把全串漏出来），只回等长星号。
+ */
+import type { XunjiSubcommand } from './subcommands.js';
+import type { XunjiRun } from './run.js';
+/** KEY 环境变量两名（老 `auth.py:35-36` 同名同序；全模块只此一处）。 */
+export declare const XUNJI_KEY_ENV: {
+    readonly primary: "XUNJI_TRAINS_KEY";
+    readonly legacy: "XUNJI_API_KEY";
+};
+/** 当前生效的 KEY 是从哪个名读到的（null＝都没配）。 */
+export type XunjiKeySource = 'XUNJI_TRAINS_KEY' | 'XUNJI_API_KEY' | null;
+/** KEY 存取的注入缝（测试挡板从这里进；生产全缺省＝真环境＋真 PowerShell）。 */
+export interface KeyStoreDeps {
+    /** 环境表（缺省 `process.env`；测 `set／clear` 的落点时传假表，**不碰真系统**）。 */
+    readonly env?: Record<string, string | undefined>;
+    /** 平台（缺省 `process.platform`；测分发时覆盖）。 */
+    readonly platform?: string;
+    /** 跑一条 PowerShell（缺省真跑；测试给挡板，**不写真系统环境**）。 */
+    readonly execPs?: (command: string) => Promise<void>;
+}
+/** 缺省 KEY 读法（老 `get_key`，`auth.py:47-55`；空串当没配）。 */
+export declare function readKeyFromEnv(env?: Record<string, string | undefined>): string | null;
+/** 当前生效的 KEY 来自哪个名（老 `which`，`auth.py:58-66`；用于提示与状态）。 */
+export declare function whichKey(env?: Record<string, string | undefined>): XunjiKeySource;
+/** 预览：前 4 字＋`...`＋末 2 字（老 `auth.py:177` 原样）；短串只回等长星号，不漏全串。 */
+export declare function previewKey(key: string): string | null;
+/** `status` 的读数（老 `auth.py:166-184` 七键；**无全串位**——全串永不进读数）。 */
+export interface KeyStatus {
+    readonly primary_name: string;
+    readonly legacy_name: string;
+    readonly primary_set: boolean;
+    readonly legacy_set: boolean;
+    readonly active_source: XunjiKeySource;
+    readonly active_key_preview: string | null;
+    readonly recommendation: string;
+}
+/** 状态报告（老 `status`；只读环境，不调网不落盘）。 */
+export declare function keyStatus(deps?: KeyStoreDeps): KeyStatus;
+/** 写入用户级系统环境（老 `set_key`；成功同步当前进程，`set` 完立即可用）。 */
+export declare function setKey(value: string, opts?: {
+    readonly legacy?: boolean;
+}, deps?: KeyStoreDeps): Promise<{
+    readonly ok: true;
+    readonly name: string;
+} | {
+    readonly ok: false;
+    readonly error: string;
+}>;
+/** 删除用户级系统环境变量（老 `clear_key`；本来没设即幂等成功）。 */
+export declare function clearKey(opts?: {
+    readonly legacy?: boolean;
+}, deps?: KeyStoreDeps): Promise<{
+    readonly ok: true;
+    readonly name: string;
+    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, store?: KeyStoreDeps): 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":"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"}