@alphafox/cli 0.3.18 → 0.3.20

package/dist/catalog/generated/registry.json

@@ -2,7 +2,7 @@
     "source": {
         "package": "@alphafoxai/contracts",
         "export": "public-api",
-        "contractsSha": "c2b17780baea3236ab1b7c0ec982f3f93f1ae08d",
+        "contractsSha": "daa775fc1e61d8416a32bd12c5301233d5ba518b",
         "registryVersion": "3.0.0",
         "contractVersion": "2026-08-31",
         "scannedAt": "2026-08-31",

package/dist/engine-backtest/progress.d.ts

@@ -0,0 +1,9 @@
+export declare const PROGRESS_MILESTONE_COUNT = 10;
+type ProgressFormat = "json" | "jsonl" | "text";
+type WriteLine = (value: unknown) => void;
+/**
+ * Keeps JSONL useful for monitoring long runs without forwarding every
+ * high-frequency runtime callback to stdout.
+ */
+export declare function createProgressEmitter(format: ProgressFormat, writeLine: WriteLine): (stage: string, fraction: number, detail?: string) => void;
+export {};

package/dist/engine-backtest/progress.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROGRESS_MILESTONE_COUNT = void 0;
+exports.createProgressEmitter = createProgressEmitter;
+exports.PROGRESS_MILESTONE_COUNT = 10;
+/**
+ * Keeps JSONL useful for monitoring long runs without forwarding every
+ * high-frequency runtime callback to stdout.
+ */
+function createProgressEmitter(format, writeLine) {
+    const lastMilestoneByStage = new Map();
+    const completedStages = new Set();
+    return (stage, fraction, detail) => {
+        if (format !== "jsonl")
+            return;
+        const milestone = Math.floor(fraction * exports.PROGRESS_MILESTONE_COUNT);
+        const lastMilestone = lastMilestoneByStage.get(stage);
+        const isFirstUpdate = lastMilestone === undefined;
+        const isNewMilestone = !isFirstUpdate && milestone > lastMilestone;
+        const isNewCompletion = fraction === 1 && !completedStages.has(stage);
+        if (!isFirstUpdate && !isNewMilestone && !isNewCompletion)
+            return;
+        lastMilestoneByStage.set(stage, milestone);
+        if (fraction === 1)
+            completedStages.add(stage);
+        writeLine({
+            event: "progress",
+            stage,
+            fraction,
+            ...(detail ? { detail } : {}),
+        });
+    };
+}

package/dist/engine-backtest/run-command.js

@@ -18,6 +18,7 @@ const sweep_command_1 = require("./sweep-command");
 const persist_1 = require("./persist");
 const paths_1 = require("../cache/paths");
 const prepared_tape_1 = require("./prepared-tape");
+const progress_1 = require("./progress");
 const replay_timeframe_1 = require("./replay-timeframe");
 const resolve_packages_1 = require("./resolve-packages");
 var load_config_2 = require("./load-config");
@@ -154,16 +155,6 @@ async function loadAccountSubscriptionTier(api, profile, env) {
     }
     return tier;
 }
-function emitProgress(flags, writeLine, stage, fraction, detail) {
-    if (flags.format !== "jsonl")
-        return;
-    writeLine({
-        event: "progress",
-        stage,
-        fraction,
-        ...(detail ? { detail } : {}),
-    });
-}
 async function executeEngineBacktestRun(args, flags, env = process.env, deps = {}) {
     if (args.help) {
         throw new errors_1.EngineBacktestError({
@@ -189,6 +180,7 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
         ((value) => {
             process.stdout.write(`${JSON.stringify(value)}\n`);
         });
+    const emitProgress = (0, progress_1.createProgressEmitter)(flags.format, writeLine);
     const persist = args.persist && !flags.dryRun;
     const createExperiment = args.createExperiment && !flags.dryRun;
     const needsApi = persist || createExperiment;
@@ -323,7 +315,7 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
                 cacheDir: (0, paths_1.resolveTapeCacheDir)(env),
                 seriesConcurrency: prepared_tape_1.ENGINE_BACKTEST_TAPE_SERIES_CONCURRENCY,
                 onProgress: (progress) => {
-                    emitProgress(flags, writeLine, progress.stage || "tape", progress.fraction, progress.detail);
+                    emitProgress(progress.stage || "tape", progress.fraction, progress.detail);
                 },
             });
         }
@@ -363,7 +355,7 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
         let result;
         try {
             result = (0, prepared_tape_1.requireCompletedPreparedRun)(await client.runPreparedBacktest(prepared.handle, scenario, (fraction) => {
-                emitProgress(flags, writeLine, "wasm", fraction);
+                emitProgress("wasm", fraction);
             }));
         }
         catch (error) {

package/dist/engine-backtest/sweep-command.js

@@ -15,6 +15,7 @@ const web_ui_config_defaults_1 = require("./web-ui-config-defaults");
 const parse_axes_1 = require("./parse-axes");
 const persist_1 = require("./persist");
 const prepared_tape_1 = require("./prepared-tape");
+const progress_1 = require("./progress");
 const replay_timeframe_1 = require("./replay-timeframe");
 const resolve_packages_1 = require("./resolve-packages");
 const sweep_kernel_1 = require("./sweep-kernel");
@@ -69,6 +70,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
         ((value) => {
             process.stdout.write(`${JSON.stringify(value)}\n`);
         });
+    const emitProgress = (0, progress_1.createProgressEmitter)(flags.format, writeLine);
     if (persist) {
         requireAuth(profile, env, tokensFn);
     }
@@ -128,7 +130,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                 status: 400,
             });
         }
-        emitProgress(flags, writeLine, "planning", 0);
+        emitProgress("planning", 0);
         const plannedByKey = new Map();
         const tapePlans = [];
         for (const [index, coordinate] of standardPlan.coordinates.entries()) {
@@ -144,7 +146,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
             if ("plan" in planned) {
                 tapePlans.push(planned.plan);
             }
-            emitProgress(flags, writeLine, "planning", (index + 1) / standardPlan.coordinates.length);
+            emitProgress("planning", (index + 1) / standardPlan.coordinates.length);
         }
         let exchange;
         try {
@@ -165,7 +167,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
             seriesRequirements: coverage.seriesRequirements,
             symbols: coverage.symbols,
         });
-        emitProgress(flags, writeLine, "tape", 0);
+        emitProgress("tape", 0);
         let tapeResult = {
             tape: {
                 from: "",
@@ -195,7 +197,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                     cacheDir: (0, paths_1.resolveTapeCacheDir)(env),
                     seriesConcurrency: prepared_tape_1.ENGINE_BACKTEST_TAPE_SERIES_CONCURRENCY,
                     onProgress: (progress) => {
-                        emitProgress(flags, writeLine, progress.stage || "tape", progress.fraction, progress.detail);
+                        emitProgress(progress.stage || "tape", progress.fraction, progress.detail);
                     },
                 });
             }
@@ -217,7 +219,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                 coverageIssues: (0, coverage_notice_1.requireTapeCoverageIssues)(tapeResult.coverageIssues),
             };
         }
-        emitProgress(flags, writeLine, "tape", 1);
+        emitProgress("tape", 1);
         while (clients.length < concurrency) {
             const extra = wasm.createNodeBacktestClient();
             clients.push(extra);
@@ -274,10 +276,10 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
             ? standardPlan.coordinates.length
             : coarsePlan.coordinates.length;
         let sweepPoints = [];
-        emitProgress(flags, writeLine, "sweep", 0);
+        emitProgress("sweep", 0);
         const coarsePoints = await runPrepared(coarsePlan.coordinates, (done, points) => {
             sweepPoints = points;
-            emitProgress(flags, writeLine, "sweep", done / Math.max(exactTotalEstimate, 1));
+            emitProgress("sweep", done / Math.max(exactTotalEstimate, 1));
         });
         sweepPoints = coarsePoints;
         let refinement = [];
@@ -294,12 +296,12 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
         if (refinement.length > 0) {
             const refinementPoints = await runPrepared(refinement, (done, points) => {
                 sweepPoints = [...coarsePoints, ...points];
-                emitProgress(flags, writeLine, "sweep", (coarsePlan.coordinates.length + done) /
+                emitProgress("sweep", (coarsePlan.coordinates.length + done) /
                     (coarsePlan.coordinates.length + refinement.length));
             });
             sweepPoints = [...coarsePoints, ...refinementPoints];
         }
-        emitProgress(flags, writeLine, "sweep", 1);
+        emitProgress("sweep", 1);
         const engineVersion = (typeof client.version === "function"
             ? (await client.version()).trim()
             : "") || "node-wasm";
@@ -317,7 +319,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
         let clientSweepId;
         let persisted = false;
         if (persist && completed) {
-            emitProgress(flags, writeLine, "persist", 0);
+            emitProgress("persist", 0);
             if (createExperiment) {
                 const created = await postJson(api, profile, env, CREATE_EXPERIMENT_PATH, {
                     name: args.name,
@@ -397,7 +399,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                 });
             }
             persisted = true;
-            emitProgress(flags, writeLine, "persist", 1);
+            emitProgress("persist", 1);
         }
         return {
             persisted,
@@ -767,13 +769,3 @@ function asConfigRecord(value) {
 function coordinateKey(coordinate) {
     return coordinate.values.join("\u0000");
 }
-function emitProgress(flags, writeLine, stage, fraction, detail) {
-    if (flags.format !== "jsonl")
-        return;
-    writeLine({
-        event: "progress",
-        stage,
-        fraction,
-        ...(detail ? { detail } : {}),
-    });
-}

package/dist/engine-backtest/types.d.ts

@@ -115,6 +115,7 @@ export interface EngineBacktestMetrics {
     readonly winRatePct: number;
     readonly feesPaid: number;
     readonly slippagePaid: number;
+    readonly maxLeverage?: number;
     readonly liquidated: boolean;
 }
 export interface EngineBacktestResult {

package/dist/skills-manifest.json

@@ -1,153 +1,153 @@
 {
   "schemaVersion": 1,
   "packageName": "@alphafox/cli",
-  "packageVersion": "0.3.18",
+  "packageVersion": "0.3.20",
   "contractVersion": "2026-08-31",
-  "bundleHash": "19730c49321abe676e32d1200bff86533131ed4aa2922fdaf73fbd4e45165faf",
+  "bundleHash": "ca170c6f023704493568335720fd82f73cd7b7a34dab795e39f3920cfa4d47d5",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "d7c507cd954fd5a5a206aadcf52d3ae1341197c300d60203f9ac9940aba9605a",
+          "sha256": "87bfa86a0be66a6737282286b3def88cc15485dac3245ea26d462334a03cc686",
           "size": 7950
         }
       ],
-      "hash": "2225c66bbcadadc0c6cc2dda5681372289a8108ce91e0a5468f8c13f42c39781"
+      "hash": "1717e3a193ebc73813d7029dc700d735bdded791a628a8d42a40245912b7effc"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4118b32ae62329dde57de75ca1ca65a417f83c13261636977a352c8d1d378b5c",
+          "sha256": "cda48226d5c00160a5373a457f813f9fe9b44fe8e17a1ff9e267e507b586227a",
           "size": 784
         }
       ],
-      "hash": "d144efc2cc5883ddd11ec63fd67438472f20cb2b11da8ad005736f08e1b70c25"
+      "hash": "271fad09bfdabbea108182f32e03ee660e30f8f69b176c128b67491c3cb95bea"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "1d5dab09efc36ddccead76ce4ca0a3ba734b977800c351ae2e71f9ca7c8709c6",
-          "size": 1930
+          "sha256": "87c7141e1a4eb23f62ef5091a1d329d4d63926c7ffecd9f36fe2363c5ae77baa",
+          "size": 2078
         }
       ],
-      "hash": "3a85d8a09b9ac2caa62b150191083348c0e1ddea353541227af261bdcf8af1c7"
+      "hash": "af6a0f2e8438578ba047e5f95bb69e7ce0919f5d947634203bdd0a1aea963e39"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4f35d76c147b151281bfcb9bb9bf601a521b7b35bd004c73e7a32a28b4b25802",
+          "sha256": "285ff81745bb8336af4b0d68ae1d6fb212120d357b0b70f1a090815d4b3038b2",
           "size": 2371
         }
       ],
-      "hash": "3685595477e95a2c84bcd380e6c6de9f8e9c006613be983ebd23b099e8da2910"
+      "hash": "f2dcab96b60491f9a3c18bcbd7e4a855ee645c144e2178351091b3c0d72d5830"
     },
     {
       "name": "alphafox-cache",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "9221dd3f1873080db447b7e2378fc6d8f12d70cc9a3720587a26fd853fa92cfb",
+          "sha256": "1bfd3487e1d155f8c250d6f1f96b555f56ca267f99691845656e60026bf98db8",
           "size": 1530
         }
       ],
-      "hash": "7356774b2d336cad0b4a50c4f36575da13f75bdcc8e1daca43416d72770d93b5"
+      "hash": "a3e23a1ec43760757473b54604aa8e6535cf4c9329884ff5e408365e77baf9e1"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "03dc3eb53d0c908c1612e2bcb400e36eb83485c5edf1a78c40138f5dad082812",
-          "size": 9229
+          "sha256": "074c54274b962267101b8b2e6d51c7054345c5d79c841299fa8ccd084e134a9d",
+          "size": 9360
         }
       ],
-      "hash": "76ad525091726105fe5136f9baaae5da2d428b12eb83ee48d473c314abde2930"
+      "hash": "d43d2be349a3c4e97c45d3dd560bcaccbffcd6c3dafae9795b7bdd641352b291"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "c128bd2e17e690829ff0ac31f6614b3bf5c7e28cdd0041458ec12dc658e3ad52",
+          "sha256": "46ee8cd0b8a4cebce8f15dfa1faec604880ea3547f2c9647b4b820e6d40f2a0a",
           "size": 744
         }
       ],
-      "hash": "2a863c1f64e104d16db3aa56f85e27ff4dcb93f6a2ef3bdaa646f4f37559c6bf"
+      "hash": "03373a84634e21bcc1325f6d2caa000063e9a6e49794c6f8368b0a1aab28b064"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "646c4e0bedf21cab44403c7f39ec99e7ebd437773f1813fc5b65e969a5264fde",
+          "sha256": "41ded9162c51d32c1bd4b03eaa59fa3a32fb799a27828f1ccdf16d49e449b187",
           "size": 3079
         }
       ],
-      "hash": "081ed543a65a936a941845eff3db03e1485071d49f260a5e7fe77484b0784911"
+      "hash": "5e54514b833faa00b906424c967dee34c302ea44377c8b6cde43457e358b4a4a"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "2b4c37b6b629f8f526b72ff2079039de5a99e168381191345101c85921b05832",
+          "sha256": "ec3682d888512bd5ce3937ca691ce66d1c6ab71bcb834bc26fa65b74baa8f7b1",
           "size": 699
         }
       ],
-      "hash": "146cff2bd50aba4d69f07124d8c04acf5b7198b7e32cb9130442d629eedc77a5"
+      "hash": "f3fecdd9069200c456c3e809679d6d6bf01638aadf1be08861d4dff2fd13309b"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "397cd48bed1fc583e421906e696104e26fbb56de34407dda7c1336e50c72cb41",
+          "sha256": "41284bfad66f187a3ee57a9134f9cbf341beb1ce20581dcdf5981f2a0af581af",
           "size": 6920
         }
       ],
-      "hash": "213e118edd8de0144972b3fee9cb3e3b6d915ee969cb6645f8a9d6bf07c6c904"
+      "hash": "1595fdcb3095ad7ed55af5b2a79e043a389a06c48cb806e2e3e04dd0ab305830"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "2f7fcee652edaf36770501cb6d5854bfcd193c90f4af9d17de0c319b263bbb50",
+          "sha256": "6d889ac8c1dde1f2581133975cc23f25b8e2793ee4c90b7c3ccc85ffbe2e01d8",
           "size": 4862
         }
       ],
-      "hash": "ad7f6dc8b1ebce16a4d52a8c7edf69f9a4bb21b7f22c58fcc7721b2ac16e51a8"
+      "hash": "148851ac3cc355de419b1dafe08f684fa8d7ea98967f14c0b01d83ea0ef800b8"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.18",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "48177ed0dbb65eb812ad18dd8667b107437f01dd79050186331da4ba000b59fa",
+          "sha256": "bef37f59c7511127794ba8edbbdde3f56bde543d0051b6dbfe5f0360168a2698",
           "size": 4493
         }
       ],
-      "hash": "dde92790169c72b6e9ffe685af5d94b0d32b84d4dd2d27be0c2492e346a5eb90"
+      "hash": "538a934c5e807af73da35c7ae85cd3921ee92a00f34648484a1c7e3eeb0fbc52"
     }
   ]
 }

package/dist/version.d.ts

@@ -1,4 +1,4 @@
 export declare const CLI_NAME = "alphafox";
 export declare const CLI_PACKAGE = "@alphafox/cli";
-export declare const CLI_VERSION = "0.3.18";
+export declare const CLI_VERSION = "0.3.20";
 export { CATALOG_VERSION as CLI_CONTRACT_VERSION } from "./catalog/operations";

package/dist/version.js

@@ -3,6 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CLI_CONTRACT_VERSION = exports.CLI_VERSION = exports.CLI_PACKAGE = exports.CLI_NAME = void 0;
 exports.CLI_NAME = "alphafox";
 exports.CLI_PACKAGE = "@alphafox/cli";
-exports.CLI_VERSION = "0.3.18";
+exports.CLI_VERSION = "0.3.20";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/docs/agents/issue-tracker.md

@@ -1,156 +1,45 @@
-# Issue tracker: Feishu Tasks
+# Issue tracker: GitHub
 
-Issues and specs for this repo live as tasks in the **AlphaFox-Issues** Feishu (Lark) tasklist. Use the `lark-cli` CLI ([`@larksuite/cli`](https://github.com/larksuite/cli)) for all operations, always with `--as user` — a task created by the bot identity is invisible in the human's task centre.
-
-List: <https://applink.feishu.cn/client/todo/task_list?guid=6d628d79-cdfe-47cc-98f7-35561944494b>
-
-## Identifiers
-
-An issue's identity is its **task GUID** — a UUID. There is no usable short number: the `t101420`-style id the Feishu UI shows (`task_id`, `suite_entity_num`) is **display-only** and every API rejects it, so a bare `#42` or `t101420` cannot be looked up directly.
-
-- Prefer the task **URL** (`https://applink.feishu.cn/client/todo/detail?guid=<GUID>`) — the GUID is the `guid` query param. Every write command below also accepts the URL in place of the GUID.
-- Given only a `t1014xx` number or a title fragment, resolve it with `lark-cli task +search --query "<title words>" --as user` and match on `summary`. Search spans **all** the user's tasks, not just this tasklist, so confirm the match before writing.
-- When narrating to the human, refer to an issue by its **title**, not its GUID.
-
-## Setup values
-
-- **Tasklist GUID**: `6d628d79-cdfe-47cc-98f7-35561944494b`
-- **`Type` field GUID**: `227d69e7-e535-40f0-b64f-4e90247149e2`
-
-Triage roles are **sections** — a task sits in exactly one, so the state machine can't be violated. `待分类` is the default section, so anything created without a section lands there as untriaged.
-
-| Canonical role | Section | Section GUID |
-| -------------- | ------- | ------------ |
-| _(untriaged)_ | `待分类` (default) | `4ca8fd68-9a08-5794-1598-8e5a394e8638` |
-| `needs-triage` | `待评估` | `44e58692-1ced-462b-99bb-bf082a745ef3` |
-| `needs-info` | `待补充信息` | `0cff4cf9-00b9-42bd-b482-5cd06a51b99b` |
-| `ready-for-agent` | `可交给 Agent` | `1ce586d5-7953-4d68-b41a-d4b2851f5806` |
-| `ready-for-human` | `需人工处理` | `8713387c-e758-4730-9de8-0b30859674ff` |
-| `wontfix` | `不予处理` | `00d4b874-1a4a-43d8-b0cf-fcb52460f9bf` |
-| _(wayfinder — outside the triage queue)_ | `探路图` | `bab88abf-0bf9-407d-806b-680901a86dd7` |
-
-Every other label is an option on the single-select `Type` field. Address an option by its GUID, never by name — the skills' canonical labels use a colon (`wayfinder:map`) while the Feishu options are named with a hyphen (`wayfinder-map`), so this table is the only mapping between them:
-
-| Label | Option GUID |
-| ----- | ----------- |
-| `bug` | `0eb51704-bead-4e8e-93be-dd8d02c1d20c` |
-| `enhancement` | `ebd05bc8-ab6c-4a56-8628-6c3284d9f1f9` |
-| `spec` | `399a640f-5d51-4dab-a4f3-da3df638ec8a` |
-| `ticket` | `3bb7ca44-ac8c-4b75-8925-96fc457fb974` |
-| `wayfinder:map` | `8cd13987-010e-46f0-808f-a8f289791cf5` |
-| `wayfinder:research` | `f18b808a-d978-41cb-9bef-cd0708fecf0c` |
-| `wayfinder:prototype` | `49126969-48dc-4297-96d4-36d176ffb8bb` |
-| `wayfinder:grilling` | `265feb46-9ac8-4c03-afa8-9400296defe4` |
-| `wayfinder:task` | `ed48b848-01d0-406b-ac7d-a96ce66cee0d` |
+Issues and specs for this repo live as GitHub issues. Use the `gh` CLI for all operations.
 
 ## Conventions
 
-- **Shared-list title** — prefix every issue/task title with `[alphafox-cli]` so the repository remains identifiable on the shared board.
-- **Tracker boundary** — Matt Skills issues, specs, tickets, triage items, and wayfinder maps belong in `AlphaFox-Issues`, not a quarterly execution list. If quarterly planning initiated the work, link its absolute Feishu task URL instead of duplicating workflow state.
-
-- **Create an issue** — one call sets body, section (triage role) and `Type`:
-
-  ```bash
-  lark-cli task tasks create --as user --params '{"user_id_type":"open_id"}' --data '{
-    "summary": "<title>",
-    "description": "<body>",
-    "tasklists": [{"tasklist_guid": "6d628d79-cdfe-47cc-98f7-35561944494b", "section_guid": "<SECTION_GUID>"}],
-    "custom_fields": [{"guid": "227d69e7-e535-40f0-b64f-4e90247149e2", "single_select_value": "<OPTION_GUID>"}]
-  }'
-  ```
-
-  For an untriaged issue with no label, `lark-cli task +create --tasklist-id 6d628d79-cdfe-47cc-98f7-35561944494b --summary "..." --description "..." --as user` is enough — it lands in `待分类`.
-
-- **Read an issue** — the body and the comments are two calls:
-
-  ```bash
-  lark-cli task tasks get --as user --params '{"task_guid": "<GUID>", "user_id_type": "open_id"}'
-  lark-cli api GET /open-apis/task/v2/comments --as user \
-    --params '{"resource_type": "task", "resource_id": "<GUID>", "page_size": 50, "user_id_type": "open_id"}'
-  ```
-
-  `tasks get` returns `description` (the body), `custom_fields` (the `Type` label), `tasklists[].section_guid` (the triage role), `members` (assignees), `status` (`todo`/`done`), `dependencies` (blockers) and `parent_task_guid`. Comments are **not** exposed by `lark-cli task`; the raw `api` call above is the only way to read them.
-
-- **List a triage bucket** — one call per section, and this is the cheap path:
-
-  ```bash
-  lark-cli task sections tasks --as user --params '{"section_guid": "<SECTION_GUID>", "completed": false, "page_size": 100}'
-  ```
-
-  Returns a brief per task — `guid`, `summary`, `completed_at`, `subtask_count` — which is all a queue listing needs. Pass `created_from`/`created_to` to window by age; results come oldest-first. Reading a task's `Type` or assignees means a `tasks get` per task, so don't do it while building a queue listing.
-
-- **List every issue**: `lark-cli task tasklists tasks --as user --params '{"tasklist_guid": "6d628d79-cdfe-47cc-98f7-35561944494b", "completed": false, "page_size": 100}'`.
+- **Create an issue**: `gh issue create --title "..." --body "..."`. Use a heredoc for multi-line bodies.
+- **Read an issue**: `gh issue view <number> --comments`, filtering comments by `jq` and also fetching labels.
+- **List issues**: `gh issue list --state open --json number,title,body,labels,comments --jq '[.[] | {number, title, body, labels: [.labels[].name], comments: [.comments[].body]}]'` with appropriate `--label` and `--state` filters.
+- **Comment on an issue**: `gh issue comment <number> --body "..."`
+- **Apply / remove labels**: `gh issue edit <number> --add-label "..."` / `--remove-label "..."`
+- **Close**: `gh issue close <number> --comment "..."`
 
-- **Comment on an issue**: `lark-cli task +comment --task-id <GUID> --content "..." --as user`. Plain text — Feishu renders no markdown in comments, so keep formatting light.
-
-- **Apply a triage role** — move the task to that role's section. Re-adding an existing task with a new `--section-guid` moves it; there is no separate "remove from old section" step:
-
-  ```bash
-  lark-cli task +tasklist-task-add --tasklist-id 6d628d79-cdfe-47cc-98f7-35561944494b --task-id <GUID> --section-guid <SECTION_GUID> --as user
-  ```
-
-- **Apply a `Type` label** — patch the custom field. This replaces the previous value, since the field is single-select:
-
-  ```bash
-  lark-cli task tasks patch --as user --params '{"task_guid": "<GUID>"}' --data '{
-    "task": {"custom_fields": [{"guid": "227d69e7-e535-40f0-b64f-4e90247149e2", "single_select_value": "<OPTION_GUID>"}]},
-    "update_fields": ["custom_fields"]
-  }'
-  ```
-
-- **Edit the body**: same shape, with `{"task": {"description": "..."}, "update_fields": ["description"]}`. A patch **replaces** the description, so read it first and re-send the whole text.
-
-- **Every markdown link in a body needs a real absolute URL.** Feishu parses `[text](target)` in `description` and validates the target, rejecting the entire write with `Invalid Param 'description', url in description is invalid` when it isn't one. A placeholder `(link)`, an empty `()`, and a repo-relative `(./src/foo.ts)` all fail. Link to an absolute `https://` URL, or drop the link syntax and name the thing in plain text. Headings, lists, bold, bare URLs and task GUIDs are all fine.
-
-- **Close**: `lark-cli task +complete --task-id <GUID> --as user`. It takes no closing comment, so post the explanation with `+comment` first, then complete. Reopen with `lark-cli task +reopen --task-id <GUID> --as user`.
-
-- **Assign**: `lark-cli task +assign --task-id <GUID> --add <open_id> --as user` (`--remove` to unassign). Get your own `open_id` from `lark-cli auth status --jq '.identities.user.openId'`.
+Infer the repo from `git remote -v`; `gh` does this automatically when run inside a clone.
 
 ## Pull requests as a triage surface
 
 **PRs as a request surface: no.** _(Set to `yes` if this repo treats external PRs as feature requests; `/triage` reads this flag.)_
 
-Feishu Tasks holds no code, so PRs live on the GitHub remote. When this flag is `yes`, triage reads a PR and its diff with `gh pr view` / `gh pr list` / `gh pr diff` while the roles and states stay here in the tasklist: a PR under triage gets a task in this list whose body links the PR. Numbering never collides, because a task GUID and a `#42` are different shapes.
+When set to `yes`, PRs run through the same labels and states as issues, using the `gh pr` equivalents:
+
+- **Read a PR**: `gh pr view <number> --comments` and `gh pr diff <number>` for the diff.
+- **List external PRs for triage**: `gh pr list --state open --json number,title,body,labels,author,authorAssociation,comments` then keep only `authorAssociation` of `CONTRIBUTOR`, `FIRST_TIME_CONTRIBUTOR`, or `NONE` (drop `OWNER`/`MEMBER`/`COLLABORATOR`).
+- **Comment / label / close**: `gh pr comment`, `gh pr edit --add-label`/`--remove-label`, `gh pr close`.
+
+GitHub shares one number space across issues and PRs, so a bare `#42` may be either: resolve with `gh pr view 42` and fall back to `gh issue view 42`.
 
 ## When a skill says "publish to the issue tracker"
 
-Create a task in this tasklist. Put the whole document in `description`, set `Type`, and place it in the section matching its triage role.
+Create a GitHub issue.
 
 ## When a skill says "fetch the relevant ticket"
 
-Run `tasks get` for the body plus the raw `comments` call for the history — an agent brief or a resolution lives in one or the other.
+Run `gh issue view <number> --comments`.
 
 ## Wayfinding operations
 
-Used by `/wayfinder`. The **map** is a task; its tickets are **subtasks** of it.
-
-- **Map**: a task with `Type` = `wayfinder:map`, in `探路图`, holding the Destination / Notes / Decisions-so-far / Fog body in `description`.
-- **Child ticket**: create the task, then parent it — `lark-cli task +set-ancestor --task-id <CHILD_GUID> --ancestor-id <MAP_GUID> --as user`. Parenting **keeps** the child's tasklist and section membership, so tickets stay visible in `探路图`. Label each with `Type` = `wayfinder:<type>`.
-- **Blocking**: Feishu's **native task dependencies** — the canonical, UI-visible representation. `type: "prev"` means "blocks this task", so a child blocked by another records the blocker as `prev`:
-
-  ```bash
-  lark-cli api POST /open-apis/task/v2/tasks/<CHILD_GUID>/add_dependencies --as user \
-    --data '{"dependencies": [{"task_guid": "<BLOCKER_GUID>", "type": "prev"}]}'
-  ```
-
-  The reciprocal `next` edge appears on the blocker automatically. Drop an edge with `--data '{"dependencies": [{"task_guid": "<BLOCKER_GUID>"}]}'` against `.../remove_dependencies`. Dependencies are **not** settable through `tasks create` or `tasks patch` — the raw `api` call is the only route, so tickets must exist before they can be wired, which is why charting creates first and wires second.
-
-- **Frontier query** — one call, because `subtasks list` returns *full* task objects rather than briefs:
-
-  ```bash
-  lark-cli task subtasks list --as user --params '{"task_guid": "<MAP_GUID>", "page_size": 100, "user_id_type": "open_id"}'
-  ```
-
-  Each child carries `status`, `members`, `dependencies` and `description`. Filter locally: keep `status` of `todo`, drop any with a `members` entry whose `role` is `assignee` (claimed), and drop any whose `prev` dependencies include a task still `todo` (blocked). Blockers that are siblings on the same map are already in this response; resolve any others with `tasks get`. First in map order wins.
-
-- **Claim**: `lark-cli task +assign --task-id <GUID> --add <your open_id> --as user` — the session's first write.
-- **Resolve**: `+comment` with the answer, then `+complete`, then patch the map's `description` to append a context pointer to Decisions-so-far. That pointer's link must be the ticket's full applink URL — a Decisions-so-far line written as `[title](link)` is rejected by the description's URL validation, taking the whole map update with it.
-
-## Re-reading the setup values
-
-```bash
-lark-cli task sections list --as user --params '{"resource_type": "tasklist", "resource_id": "6d628d79-cdfe-47cc-98f7-35561944494b", "page_size": 50}'
-lark-cli task custom_fields list --as user --params '{"resource_type": "tasklist", "resource_id": "6d628d79-cdfe-47cc-98f7-35561944494b", "page_size": 50}'
-```
+Used by `/wayfinder`. The **map** is a single issue with **child** issues as tickets.
 
-`custom_fields list` returns each option's `guid` alongside its `name`, which is what the `Type` table above records.
+- **Map**: a single issue labelled `wayfinder:map`, holding the Notes / Decisions-so-far / Fog body. `gh issue create --label wayfinder:map`.
+- **Child ticket**: an issue linked to the map as a GitHub sub-issue (`gh api` on the sub-issues endpoint). Where sub-issues aren't enabled, add the child to a task list in the map body and put `Part of #<map>` at the top of the child body. Labels: `wayfinder:<type>` (`research`/`prototype`/`grilling`/`task`). Once claimed, the ticket is assigned to the driving dev.
+- **Blocking**: GitHub's **native issue dependencies**, the canonical, UI-visible representation. Add an edge with `gh api --method POST repos/<owner>/<repo>/issues/<child>/dependencies/blocked_by -F issue_id=<blocker-db-id>`, where `<blocker-db-id>` is the blocker's numeric **database id** (`gh api repos/<owner>/<repo>/issues/<n> --jq .id`, _not_ the `#number` or `node_id`). GitHub reports `issue_dependencies_summary.blocked_by` (open blockers only, the live gate). Where dependencies aren't available, fall back to a `Blocked by: #<n>, #<n>` line at the top of the child body. A ticket is unblocked when every blocker is closed.
+- **Frontier query**: list the map's open children (`gh issue list --state open`, scoped to the map's sub-issues / task list), drop any with an open blocker (`issue_dependencies_summary.blocked_by > 0`, or an open issue in the `Blocked by` line) or an assignee; first in map order wins.
+- **Claim**: `gh issue edit <n> --add-assignee @me`, the session's first write.
+- **Resolve**: `gh issue comment <n> --body "<answer>"`, then `gh issue close <n>`, then append a context pointer (gist + link) to the map's Decisions-so-far.

package/docs/agents/triage-labels.md

@@ -1,18 +1,15 @@
 # Triage Labels
 
-The skills speak in terms of five canonical triage roles. On this repo's tracker (Feishu Tasks) a role is not a label but a **section** of the AlphaFox-Issues tasklist — a task sits in exactly one, so the state machine can't be violated. `issue-tracker.md` holds the section GUIDs and the command that moves a task between them.
+The skills speak in terms of five canonical triage roles. This file maps those roles to the actual label strings used in this repo's issue tracker.
 
-| Label in mattpocock/skills | Section in our tracker | Meaning                                  |
-| -------------------------- | ---------------------- | ---------------------------------------- |
-| _(no label yet)_           | `待分类`               | Never triaged — the default section       |
-| `needs-triage`             | `待评估`               | Maintainer needs to evaluate this issue  |
-| `needs-info`               | `待补充信息`           | Waiting on reporter for more information |
-| `ready-for-agent`          | `可交给 Agent`         | Fully specified, ready for an AFK agent  |
-| `ready-for-human`          | `需人工处理`           | Requires human implementation            |
-| `wontfix`                  | `不予处理`             | Will not be actioned                     |
+| Label in mattpocock/skills | Label in our tracker | Meaning                                  |
+| -------------------------- | -------------------- | ---------------------------------------- |
+| `needs-triage`             | `needs-triage`       | Maintainer needs to evaluate this issue  |
+| `needs-info`               | `needs-info`         | Waiting on reporter for more information |
+| `ready-for-agent`          | `ready-for-agent`    | Fully specified, ready for an AFK agent  |
+| `ready-for-human`          | `ready-for-human`    | Requires human implementation            |
+| `wontfix`                  | `wontfix`            | Will not be actioned                     |
 
-When a skill mentions a role (e.g. "apply the AFK-ready triage label"), move the task to the corresponding section from this table.
+When a skill mentions a role (e.g. "apply the AFK-ready triage label"), use the corresponding label string from this table.
 
-The remaining labels — the `bug` / `enhancement` categories and wayfinder's `wayfinder:<type>` — are **not** sections. They are options on the single-select `Type` field, because they coexist with a triage role rather than replacing it. `issue-tracker.md` holds their option GUIDs.
-
-Editing the right-hand column here is not enough on its own: rename a section in Feishu and its GUID stays the same, so update this table and leave `issue-tracker.md`'s GUIDs alone. Adding or removing a section is the case that changes GUIDs, and then both files need re-syncing.
+Edit the right-hand column to match whatever vocabulary you actually use.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "AlphaFox CLI — Agent/Human entry for the public Application API.",
   "type": "commonjs",
   "bin": {

package/skills/account/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-account
 description: Account, wallet, and subscription read paths.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Account / wallet

package/skills/admin/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-admin
 description: Admin-only operations reusing Web role authorization.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Admin
@@ -16,7 +16,7 @@ High-risk cataloged admin writes: `alphafox schema <operationId>` first, then `-
 
 ## Passivbot paper acceptance
 
-This Stage 1 endpoint is intentionally absent from the public Operation Registry and typed CLI catalog. The only allowed uncataloged admin path is the exact direct route below. Its JSON body is strict: `name`, `exchangeConnectorId`, and `config` are required; `configSchemaVersion` may only be `1`; `autoStart` is optional and defaults to `true`. Do not add server-owned fields.
+This Stage 1 endpoint is intentionally absent from the public Operation Registry and typed CLI catalog. The only allowed uncataloged admin path is the exact direct route below. Its JSON body is strict: `name`, `exchangeConnectorId`, and `config` are required; `configSchemaVersion` accepts only `1` and `2`; `autoStart` is optional and defaults to `true`. Use `2` for new acceptance traders and `1` only when replaying an existing v1 config. The `config` object must match the selected version. Do not add server-owned fields.
 
 Preview the exact raw request first. The unknown/high-risk gate must return `confirmation_required`; show the requested action and risk to the operator, wait for explicit confirmation, then rerun the same command with `--yes`.
 
@@ -31,7 +31,7 @@ The config file shape is:
 {
   "name": "Passivbot paper acceptance",
   "exchangeConnectorId": "<internal-paper-connector-id>",
-  "configSchemaVersion": 1,
+  "configSchemaVersion": 2,
   "config": {},
   "autoStart": true
 }

package/skills/alphafox/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox
 description: AlphaFox CLI entry router. Use for any AlphaFox request — install, update, login, whoami, 回测, engine backtest, 清理回测缓存 / 历史数据, strategy definitions, create/list/start/stop a running strategy (trader), ticker/标的 resolve (美股 or crypto), market data, exchange connectors, wallet, subscriptions, notifications, or admin. After 回测 or 运行策略, include the dashboard URL from the domain skill. When the user asks 排行榜, include https://www.alphafox.app/zh/dashboard/leaderboard. After a successful install and login, present the 新人引导 in this file (Lite square 带单员 + classic strategies). If a CLI command prints `[alphafox] update available`, ask the user「检测到新的版本，是否需要我帮你升级？」and only then run `alphafox update --format json --no-input`. After a large backtest, if tape cache is large, ask「回测下载的历史数据比较大，要不要我帮你清理本地缓存？」then open `alphafox-cache`. Start here, then open the routed domain skill. Do not guess alphafox-engine-backtest vs alphafox-strategy vs alphafox-trading from memory.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # AlphaFox

package/skills/alphafox-shared/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-shared
 description: Shared AlphaFox CLI rules for Agents — auth, profiles, envelopes, risk gates, public operationIds, and dashboard links after 回测 / 运行策略 / 排行榜.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # AlphaFox shared Agent contract

package/skills/auth/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-auth
 description: Login, status, logout, whoami, and environment isolation for AlphaFox CLI.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Auth Skill

package/skills/cache/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-cache
 description: Inspect and clean local Engine backtest caches (downloaded OHLCV tape and wasm runtime). Use when the user asks to 清理缓存, free disk, or after a large historical backtest.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Cache

package/skills/engine-backtest/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-engine-backtest
 description: Local Engine WASM backtest (alphafox engine-backtest run|sweep) vs catalog experiment CRUD. After a persisted run, include https://www.alphafox.app/zh/dashboard/traders/backtest/{experimentId}.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Engine Backtest
@@ -56,7 +56,7 @@ alphafox engine-backtest run \
 
 Also valid: `--from` / `--to` instead of `--range`. `--create-experiment --name "..."` when there is no `--experiment` (needs `strategyDefinitionId` + `strategyDefinitionDisplay` `{zh,en}`; pass `--definition-label-zh` / `--definition-label-en` or the CLI falls back to the definition id). Persisted runs use the account tier from `subscriptions.me.get`; if `--tier` is supplied, it must match. With `--no-persist`, `runs.create` is skipped and `--tier` may simulate `free|pro|pro_max` (default `pro`). `--data-quality` defaults to `basic` (soft gaps finish the run and appear as `coverageNotice`; `prefix_gap` is less severe than `internal_gap`). `--data-quality strict` still fails on any gap. `--replay-timeframe` defaults to `1m` (allowed `1m|3m|5m|15m|30m|1h|4h`); this is the replay/download bar and is merged with plan indicator timeframes so a 4h RSI grid still replays on 1m. `runs.create` is `write`, not `high-risk-write` — do not add `--yes`. Do not update or delete experiments through this command.
 
-`--format jsonl` writes one JSON object per progress line (`{event:"progress",stage,fraction}`), then a final `{ok:true,data:{...}}` envelope.
+`--format jsonl` writes compact progress milestones (`{event:"progress",stage,fraction}`; first update, each 10%, and completion per stage), then a final `{ok:true,data:{...}}` envelope. Use `--format json` when only the final envelope is needed.
 
 ## Local sweep
 
@@ -78,7 +78,7 @@ alphafox engine-backtest sweep \
 
 `--mode` is `neighborhood|range`. `--search-mode` is `standard|fast`. `--concurrency` is 1–8; Free is always serial. After every local coordinate finishes, the command POSTs **one** `engine_backtest.experiments.byId.sweeps.create` summary (4 MiB / point-error caps). It never calls `runs.create` per coordinate and never writes Tape, curves, or full configs. `--no-persist` stays zero-write. A cancelled or incomplete search is not persisted. The same `clientSweepId` is reused if you rebuild the create body for retry; unknown write results (no Sweep id) fail instead of reporting `persisted: true`.
 
-`--format jsonl` includes `planning`, `tape`, `sweep`, and `persist` stages. The final envelope includes counts, `elapsedMs`, best coordinate/config, `sweepId`, `persisted`, and an Experiment URL with `?tab=sweep`. After persist, include that dashboard URL in the reply (`https://www.alphafox.app/zh/dashboard/traders/backtest/{experimentId}?tab=sweep`).
+`--format jsonl` includes compact 10% milestones for `planning`, `tape`, `sweep`, and `persist` stages. The final envelope includes counts, `elapsedMs`, best coordinate/config, `sweepId`, `persisted`, and an Experiment URL with `?tab=sweep`. After persist, include that dashboard URL in the reply (`https://www.alphafox.app/zh/dashboard/traders/backtest/{experimentId}?tab=sweep`).
 
 Read / delete history through typed catalog commands. Delete is high-risk-write:
 

package/skills/exchange/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-exchange
 description: Exchange connectors list and connection management via Public API.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Exchange connectors

package/skills/market/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-market
 description: Market data and ticker resolution for US equity perps, RWAs, and crypto on the same perp catalog. Use when the user names 美股, NVDA, AAPL, BTC, or any 标的. Keep the operator's asset class via symbolMetadata — do not rewrite NVDA into a crypto coin.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Market

package/skills/notification/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-notification
 description: Notification channels and subscriptions.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Notification

package/skills/strategy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-strategy
 description: Strategy definitions — list types, read a definition's contract, and validate config. Creating a running strategy is creating a trader; use alphafox-trading for that. Local Engine backtest is alphafox-engine-backtest.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Strategy definitions

package/skills/trading/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-trading
 description: Running strategies (traders) — create, list, start, and stop. A trader is a live or paper strategy instance (grid, dca, copy, …), not a person. Default Engine create uses autoStart true (创建即开始). Use autoStart false only when the user asks to create without starting. After create or start, include https://www.alphafox.app/zh/dashboard/traders/{traderId}.
-version: 0.3.18
+version: 0.3.20
 ---
 
 # Running strategies (traders)