@alphafox/cli 0.3.19 → 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.19",
+  "packageVersion": "0.3.20",
   "contractVersion": "2026-08-31",
-  "bundleHash": "2107a1df1f931d2c6401aaa647851da86929ab2bce6c9956aa812c19522fac5a",
+  "bundleHash": "ca170c6f023704493568335720fd82f73cd7b7a34dab795e39f3920cfa4d47d5",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "1d8a69ae5d693ffa3a18317515aaf22a333fee0f77083e8b8c6916b1ce6bc0da",
+          "sha256": "87bfa86a0be66a6737282286b3def88cc15485dac3245ea26d462334a03cc686",
           "size": 7950
         }
       ],
-      "hash": "a1dd0a8c3729819753add3d36b6d4aebae03fdb97bbf52273910c106530649cf"
+      "hash": "1717e3a193ebc73813d7029dc700d735bdded791a628a8d42a40245912b7effc"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "fd097fe41f1279920a25bb13b82c8dffe58bdc209f6c211ecfc09fd5bdc849a8",
+          "sha256": "cda48226d5c00160a5373a457f813f9fe9b44fe8e17a1ff9e267e507b586227a",
           "size": 784
         }
       ],
-      "hash": "59783023fdc832f44ab6d452aab6f608f7e072b087a83f9d582e420621a94aae"
+      "hash": "271fad09bfdabbea108182f32e03ee660e30f8f69b176c128b67491c3cb95bea"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "32df381f1f0373c42e496f0d7fd0b9cc6833263559c8657d1491b37a5af49fb4",
+          "sha256": "87c7141e1a4eb23f62ef5091a1d329d4d63926c7ffecd9f36fe2363c5ae77baa",
           "size": 2078
         }
       ],
-      "hash": "b326c9379bc7eef507099726269e63d57169c9c305d8bf677f9dd36c38378462"
+      "hash": "af6a0f2e8438578ba047e5f95bb69e7ce0919f5d947634203bdd0a1aea963e39"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "21842ddad8d3aa0c9042e8c10faac916f592fef844d4d9dcd60821a54e4b4f0c",
+          "sha256": "285ff81745bb8336af4b0d68ae1d6fb212120d357b0b70f1a090815d4b3038b2",
           "size": 2371
         }
       ],
-      "hash": "185f1ab61724affe0f8cd2e5cd3fe7db09dc17f94b760c96a84a9cfbd32e6c59"
+      "hash": "f2dcab96b60491f9a3c18bcbd7e4a855ee645c144e2178351091b3c0d72d5830"
     },
     {
       "name": "alphafox-cache",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "000b91d67f72553f1739b8eb55f0b40532ad55829757cfcc8e1e424b46cc92f6",
+          "sha256": "1bfd3487e1d155f8c250d6f1f96b555f56ca267f99691845656e60026bf98db8",
           "size": 1530
         }
       ],
-      "hash": "b32cdd6e6239647fc93c3027a8a0879a800ffd5140e6738a542771e92c9d3f8e"
+      "hash": "a3e23a1ec43760757473b54604aa8e6535cf4c9329884ff5e408365e77baf9e1"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "c4671d8cdf5894698fe4883462673b068d3df9c8c86d9de2afa0b925d6055a2d",
-          "size": 9229
+          "sha256": "074c54274b962267101b8b2e6d51c7054345c5d79c841299fa8ccd084e134a9d",
+          "size": 9360
         }
       ],
-      "hash": "a07b1b029d4c353204d1a6b2a3aad58287b4c7cf576a84652b479b396a24604a"
+      "hash": "d43d2be349a3c4e97c45d3dd560bcaccbffcd6c3dafae9795b7bdd641352b291"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "9987bec5a1a99dca1896f85a5dbcb74bfb53f17db184c11d9eb5f5dc59906b82",
+          "sha256": "46ee8cd0b8a4cebce8f15dfa1faec604880ea3547f2c9647b4b820e6d40f2a0a",
           "size": 744
         }
       ],
-      "hash": "ba8844128b256f7f4d32b969e865598bc3992fb4a17c37452f5f57f685df5157"
+      "hash": "03373a84634e21bcc1325f6d2caa000063e9a6e49794c6f8368b0a1aab28b064"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "ec5faeca5ed02b9b3ce9d9477f3a2b0c4ff70c994a754dfbe166f7569867efbc",
+          "sha256": "41ded9162c51d32c1bd4b03eaa59fa3a32fb799a27828f1ccdf16d49e449b187",
           "size": 3079
         }
       ],
-      "hash": "7caf11ff0dba5d2fb630d5b43f4e2d3d40453908cf0401886a73e3aab00f89ba"
+      "hash": "5e54514b833faa00b906424c967dee34c302ea44377c8b6cde43457e358b4a4a"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "5980c926f71cff2d990c7c672c26947d34cab0fdaac94503d09a7ede80ac6e2b",
+          "sha256": "ec3682d888512bd5ce3937ca691ce66d1c6ab71bcb834bc26fa65b74baa8f7b1",
           "size": 699
         }
       ],
-      "hash": "c0bf37eaaf27abd3a18c2cf11d91bc58bdb67817e5b17116ff96570be7d43612"
+      "hash": "f3fecdd9069200c456c3e809679d6d6bf01638aadf1be08861d4dff2fd13309b"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4dc5689ede3c8877217f38e4894ed4ca5c76ad2db7d7a3d6f3245e917e7f7864",
+          "sha256": "41284bfad66f187a3ee57a9134f9cbf341beb1ce20581dcdf5981f2a0af581af",
           "size": 6920
         }
       ],
-      "hash": "8fc7ea7232796dbd268b04afd28d0b3ef17aeae06e1c83cb1cf1c9e6f4edb9fc"
+      "hash": "1595fdcb3095ad7ed55af5b2a79e043a389a06c48cb806e2e3e04dd0ab305830"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "df4e53e1bbda4323795cc9946520476303aa5e77deaee5fd3e7c6d543ec201eb",
+          "sha256": "6d889ac8c1dde1f2581133975cc23f25b8e2793ee4c90b7c3ccc85ffbe2e01d8",
           "size": 4862
         }
       ],
-      "hash": "644611a9c283692cd77555986da7614c87c38118a83519656c3165968bc65a7a"
+      "hash": "148851ac3cc355de419b1dafe08f684fa8d7ea98967f14c0b01d83ea0ef800b8"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.19",
+      "version": "0.3.20",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "5df4e36c54379bc6389c5c9822c8ebc7817b8728103577eb219ccea707743966",
+          "sha256": "bef37f59c7511127794ba8edbbdde3f56bde543d0051b6dbfe5f0360168a2698",
           "size": 4493
         }
       ],
-      "hash": "340c1014ce0b0df03d1b98a1f6d0e5c44b9960dafa94accfefdb7fbeb4ab9f87"
+      "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.19";
+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.19";
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.19",
+  "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.19
+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.19
+version: 0.3.20
 ---
 
 # Admin

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.19
+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.19
+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.19
+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.19
+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.19
+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.19
+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.19
+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.19
+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.19
+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.19
+version: 0.3.20
 ---
 
 # Running strategies (traders)