@alphafox/cli 0.3.9 → 0.3.11

package/dist/engine-backtest/coverage-notice.d.ts

@@ -0,0 +1,5 @@
+import type { TapeCoverageIssue, TapeCoverageNotice } from "./types";
+export declare function summarizeTapeCoverageNotice(issues: readonly TapeCoverageIssue[]): TapeCoverageNotice;
+/** Runtime guard: a missing field must not look like a clean tape. */
+export declare function requireTapeCoverageIssues(value: unknown): readonly TapeCoverageIssue[];
+export declare function snapshotCoverageIssues(issues: readonly TapeCoverageIssue[] | undefined): TapeCoverageIssue[] | undefined;

package/dist/engine-backtest/coverage-notice.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.summarizeTapeCoverageNotice = summarizeTapeCoverageNotice;
+exports.requireTapeCoverageIssues = requireTapeCoverageIssues;
+exports.snapshotCoverageIssues = snapshotCoverageIssues;
+const errors_1 = require("./errors");
+function symbolLabel(issue) {
+    const timeframe = issue.timeframe && issue.timeframe !== "*" ? ` ${issue.timeframe}` : "";
+    return `${issue.symbol}${timeframe}`;
+}
+function uniqueIssues(issues) {
+    const seen = new Set();
+    const unique = [];
+    for (const issue of issues) {
+        const key = `${issue.code}\u0000${issue.symbol}\u0000${issue.timeframe}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        unique.push(issue);
+    }
+    return unique;
+}
+function summarizeTapeCoverageNotice(issues) {
+    const prefix = [];
+    const internal = [];
+    const other = [];
+    for (const item of issues) {
+        if (item.code === "prefix_gap") {
+            prefix.push(item);
+        }
+        else if (item.code === "internal_gap") {
+            internal.push(item);
+        }
+        else {
+            other.push(item);
+        }
+    }
+    const uniquePrefix = uniqueIssues(prefix);
+    const uniqueInternal = uniqueIssues(internal);
+    const uniqueOther = uniqueIssues(other);
+    const severity = uniqueInternal.length > 0
+        ? "warning"
+        : uniquePrefix.length + uniqueOther.length > 0
+            ? "notice"
+            : "none";
+    const messages = [];
+    if (uniqueInternal.length > 0) {
+        messages.push(`WARNING: missing mid-range candles (more severe): ${uniqueInternal
+            .map(symbolLabel)
+            .join(", ")}`);
+    }
+    if (uniquePrefix.length > 0) {
+        messages.push(`NOTICE: missing start candles (less severe): ${uniquePrefix
+            .map(symbolLabel)
+            .join(", ")}`);
+    }
+    if (uniqueOther.length > 0) {
+        messages.push(`NOTICE: other soft coverage gaps: ${uniqueOther
+            .map((issue) => `${symbolLabel(issue)} (${issue.code})`)
+            .join(", ")}`);
+    }
+    return {
+        severity,
+        prefix: uniquePrefix,
+        internal: uniqueInternal,
+        other: uniqueOther,
+        messages,
+    };
+}
+/** Must match alphafox-web `engineBacktestPersistedSnapshotSchema.coverageIssues`. */
+const PERSISTED_COVERAGE_ISSUE_CODES = new Set([
+    "market_missing",
+    "ohlcv_missing",
+    "invalid_ohlcv",
+    "non_monotonic",
+    "internal_gap",
+    "prefix_gap",
+    "suffix_gap",
+    "warmup_insufficient",
+    "load_failed",
+    "coverage_insufficient",
+]);
+/** Runtime guard: a missing field must not look like a clean tape. */
+function requireTapeCoverageIssues(value) {
+    if (!Array.isArray(value)) {
+        throw new errors_1.EngineBacktestError({
+            type: "runtime",
+            subtype: "missing_coverage_issues",
+            message: "Tape loader omitted coverageIssues; refusing to treat the tape as clean.",
+        });
+    }
+    return value;
+}
+function snapshotCoverageIssues(issues) {
+    if (!issues || issues.length === 0)
+        return undefined;
+    return issues.map((issue) => {
+        if (!PERSISTED_COVERAGE_ISSUE_CODES.has(issue.code)) {
+            throw new errors_1.EngineBacktestError({
+                type: "runtime",
+                subtype: "invalid_coverage_issue",
+                message: `Cannot persist unknown tape coverage issue code: ${issue.code}`,
+            });
+        }
+        return {
+            code: issue.code,
+            symbol: issue.symbol,
+            timeframe: issue.timeframe,
+            ...(issue.expected === undefined ? {} : { expected: issue.expected }),
+            ...(issue.actual === undefined ? {} : { actual: issue.actual }),
+            ...(issue.timestamp === undefined ? {} : { timestamp: issue.timestamp }),
+            ...(issue.message === undefined ? {} : { message: issue.message }),
+        };
+    });
+}

package/dist/engine-backtest/parse-args.d.ts

@@ -1,4 +1,4 @@
-import type { EngineBacktestRunArgs, EngineBacktestSweepArgs, ExecutionModel, InclusiveUtcDateRange } from "./types";
+import { type EngineBacktestRunArgs, type EngineBacktestSweepArgs, type ExecutionModel, type InclusiveUtcDateRange } from "./types";
 export declare const ENGINE_BACKTEST_RUN_USAGE: string[];
 export declare const ENGINE_BACKTEST_SWEEP_USAGE: string[];
 export declare function parseInclusiveUtcDateRange(rangeStart: string, rangeEnd: string): InclusiveUtcDateRange;

package/dist/engine-backtest/parse-args.js

@@ -9,6 +9,7 @@ exports.parseEngineBacktestSweepArgs = parseEngineBacktestSweepArgs;
 const errors_1 = require("./errors");
 const replay_timeframe_1 = require("./replay-timeframe");
 const sweep_kernel_1 = require("./sweep-kernel");
+const types_1 = require("./types");
 const DAY_MS = 86_400_000;
 const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
 const TIERS = new Set(["free", "pro", "pro_max"]);
@@ -107,7 +108,7 @@ function parseEngineBacktestRunArgs(args) {
     let to;
     let initialEquity;
     let tier;
-    let dataQualityMode = "strict";
+    let dataQualityMode = types_1.DEFAULT_DATA_QUALITY_MODE;
     let configSchemaVersion;
     let executionModelOverride;
     let persist = true;
@@ -343,7 +344,7 @@ function parseEngineBacktestSweepArgs(args) {
         return {
             help: true,
             createExperiment: false,
-            dataQualityMode: "strict",
+            dataQualityMode: types_1.DEFAULT_DATA_QUALITY_MODE,
             persist: true,
             replayTimeframe: replay_timeframe_1.ENGINE_BACKTEST_DEFAULT_REPLAY_TIMEFRAME,
             axesRaw,

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

@@ -1,5 +1,5 @@
 import type { ProfileName } from "../config/profiles";
-import type { CreateRunRequestBody, CreateSweepRequestBody, DataQualityMode, EngineBacktestMetrics, EngineBacktestScenario, EngineBacktestSweepPointRow, ExecutionModel, PersistedSnapshot, SweepMode, SweepSearchMode } from "./types";
+import type { CreateRunRequestBody, CreateSweepRequestBody, DataQualityMode, EngineBacktestMetrics, EngineBacktestScenario, EngineBacktestSweepPointRow, ExecutionModel, PersistedSnapshot, SweepMode, SweepSearchMode, TapeCoverageIssue } from "./types";
 /** Aligned with `@alphafoxai/backtest-runner` DEFAULT_EXECUTION_MODEL. */
 export declare const DEFAULT_EXECUTION_MODEL: ExecutionModel;
 export declare const SNAPSHOT_SCHEMA_VERSION: 1;
@@ -24,6 +24,7 @@ export declare function buildCreateRunRequest(input: {
     readonly dataQualityMode: DataQualityMode;
     readonly engineVersion: string;
     readonly equityCurve?: unknown;
+    readonly coverageIssues?: readonly TapeCoverageIssue[];
 }): CreateRunRequestBody;
 /**
  * Experiment detail URL. Locale prefix (`/zh`, `/en`) is optional — web
@@ -51,6 +52,7 @@ export declare function buildSweepBaseSnapshot(input: {
     readonly initialEquity: number;
     readonly subscriptionTier: PersistedSnapshot["subscriptionTier"];
     readonly dataQualityMode: DataQualityMode;
+    readonly coverageIssues?: readonly TapeCoverageIssue[];
     readonly symbols: readonly string[];
     readonly timeframes: readonly string[];
     readonly baseTimeframe: string;

package/dist/engine-backtest/persist.js

@@ -14,6 +14,7 @@ exports.buildCreateSweepRequest = buildCreateSweepRequest;
 exports.assertSweepCreateRequestSize = assertSweepCreateRequestSize;
 const errors_1 = require("./errors");
 const return_curve_1 = require("./return-curve");
+const coverage_notice_1 = require("./coverage-notice");
 /** Aligned with `@alphafoxai/backtest-runner` DEFAULT_EXECUTION_MODEL. */
 exports.DEFAULT_EXECUTION_MODEL = {
     pricePath: "ohlc_path_4",
@@ -59,6 +60,7 @@ function buildCreateRunRequest(input) {
     }
     const timeframes = uniqueSeriesField(scenario.tape.series, "timeframe");
     const engineVersion = input.engineVersion.trim() || "node-wasm";
+    const coverageIssues = (0, coverage_notice_1.snapshotCoverageIssues)(input.coverageIssues);
     const snapshot = {
         snapshotSchemaVersion: exports.SNAPSHOT_SCHEMA_VERSION,
         strategyDefinitionId: scenario.trader.strategyDefinitionId,
@@ -70,6 +72,7 @@ function buildCreateRunRequest(input) {
         initialEquity: scenario.exchange.initialEquity,
         subscriptionTier: scenario.trader.subscriptionTier,
         dataQualityMode: input.dataQualityMode,
+        ...(coverageIssues ? { coverageIssues } : {}),
         symbols,
         timeframes: timeframes.length > 0 ? timeframes : ["1m"],
         baseTimeframe: scenario.tape.baseTimeframe || "1m",
@@ -141,6 +144,7 @@ function buildSweepBaseSnapshot(input) {
     const timeframes = [
         ...new Set(input.timeframes.map((item) => item.trim()).filter(Boolean)),
     ];
+    const coverageIssues = (0, coverage_notice_1.snapshotCoverageIssues)(input.coverageIssues);
     return {
         snapshotSchemaVersion: exports.SNAPSHOT_SCHEMA_VERSION,
         strategyDefinitionId: input.definitionId,
@@ -152,6 +156,7 @@ function buildSweepBaseSnapshot(input) {
         initialEquity: input.initialEquity,
         subscriptionTier: input.subscriptionTier,
         dataQualityMode: input.dataQualityMode,
+        ...(coverageIssues ? { coverageIssues } : {}),
         symbols,
         timeframes: timeframes.length > 0 ? timeframes : ["1m"],
         baseTimeframe: input.baseTimeframe.trim() || "1m",

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

@@ -9,6 +9,7 @@ const profiles_1 = require("../config/profiles");
 const envelope_1 = require("../envelope");
 const client_1 = require("../http/client");
 const store_1 = require("../keychain/store");
+const coverage_notice_1 = require("./coverage-notice");
 const errors_1 = require("./errors");
 const load_config_1 = require("./load-config");
 const parse_args_1 = require("./parse-args");
@@ -336,6 +337,10 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
                 details: issues ? { issues } : undefined,
             });
         }
+        tapeResult = {
+            ...tapeResult,
+            coverageIssues: (0, coverage_notice_1.requireTapeCoverageIssues)(tapeResult.coverageIssues),
+        };
         const runId = mintId();
         const executionModel = {
             ...(runner.DEFAULT_EXECUTION_MODEL ?? persist_1.DEFAULT_EXECUTION_MODEL),
@@ -400,6 +405,7 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
                 dataQualityMode: args.dataQualityMode,
                 engineVersion,
                 equityCurve: result.equityCurve,
+                coverageIssues: tapeResult.coverageIssues,
             });
             const res = await postJson(api, profile, env, runsPath(experimentId), body, mintId);
             persistedRunId = extractEntityId(res.json);
@@ -419,7 +425,9 @@ async function executeEngineBacktestRun(args, flags, env = process.env, deps = {
             runId: persistedRunId,
             experimentUrl: (0, persist_1.experimentPageUrl)(profile.name, experimentId),
             persisted: Boolean(persistedRunId),
-            coverageWarnings: tapeResult.coverageWarnings ?? [],
+            coverageWarnings: tapeResult.coverageWarnings,
+            coverageIssues: tapeResult.coverageIssues,
+            coverageNotice: (0, coverage_notice_1.summarizeTapeCoverageNotice)(tapeResult.coverageIssues),
         };
     }
     finally {
@@ -441,6 +449,7 @@ function engineBacktestHelpData() {
             "runs.create is write (not high-risk-write); --yes is not required",
             "Do not pass --token; use alphafox auth login",
             "--replay-timeframe defaults to 1m (min 1m). Indicator series still download their native plan timeframes.",
+            "--data-quality defaults to basic: hard tape failures still stop, soft gaps finish the run and appear as coverageNotice (prefix_gap less severe, internal_gap more severe). Use --data-quality strict to fail on any gap.",
         ],
     };
 }

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

@@ -9,6 +9,7 @@ const profiles_1 = require("../config/profiles");
 const client_1 = require("../http/client");
 const paths_1 = require("../cache/paths");
 const store_1 = require("../keychain/store");
+const coverage_notice_1 = require("./coverage-notice");
 const errors_1 = require("./errors");
 const load_config_1 = require("./load-config");
 const parse_axes_1 = require("./parse-axes");
@@ -175,6 +176,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
             },
             buffers: {},
             coverageWarnings: [],
+            coverageIssues: [],
         };
         if (tapePlans.length > 0) {
             try {
@@ -209,6 +211,10 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                     details: issues ? { issues } : undefined,
                 });
             }
+            tapeResult = {
+                ...tapeResult,
+                coverageIssues: (0, coverage_notice_1.requireTapeCoverageIssues)(tapeResult.coverageIssues),
+            };
         }
         emitProgress(flags, writeLine, "tape", 1);
         while (clients.length < concurrency) {
@@ -353,6 +359,7 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
                 initialEquity: args.initialEquity,
                 subscriptionTier,
                 dataQualityMode: args.dataQualityMode,
+                coverageIssues: tapeResult.coverageIssues,
                 symbols: tapeSymbols.length > 0 ? tapeSymbols : coverage.symbols,
                 timeframes: (0, persist_1.uniqueSeriesField)(tapeResult.tape.series, "timeframe"),
                 baseTimeframe: tapeResult.tape.baseTimeframe || args.replayTimeframe,
@@ -417,7 +424,9 @@ async function executeEngineBacktestSweep(args, flags, env = process.env, deps =
             experimentUrl: experimentId
                 ? (0, persist_1.experimentSweepPageUrl)(profile.name, experimentId)
                 : undefined,
-            coverageWarnings: tapeResult.coverageWarnings ?? [],
+            coverageWarnings: tapeResult.coverageWarnings,
+            coverageIssues: tapeResult.coverageIssues,
+            coverageNotice: (0, coverage_notice_1.summarizeTapeCoverageNotice)(tapeResult.coverageIssues),
             axes: coarsePlan.axes,
         };
     }

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

@@ -1,5 +1,23 @@
 export type SubscriptionTier = "free" | "pro" | "pro_max";
 export type DataQualityMode = "strict" | "basic";
+/** New runs default to basic; `--data-quality strict` remains an explicit override. */
+export declare const DEFAULT_DATA_QUALITY_MODE: DataQualityMode;
+export interface TapeCoverageIssue {
+    readonly code: string;
+    readonly symbol: string;
+    readonly timeframe: string;
+    readonly expected?: number;
+    readonly actual?: number;
+    readonly timestamp?: number;
+    readonly message?: string;
+}
+export interface TapeCoverageNotice {
+    readonly severity: "none" | "notice" | "warning";
+    readonly prefix: readonly TapeCoverageIssue[];
+    readonly internal: readonly TapeCoverageIssue[];
+    readonly other: readonly TapeCoverageIssue[];
+    readonly messages: readonly string[];
+}
 export type PricePath = "ohlc_path_4" | "close_only";
 export interface ExecutionModel {
     readonly pricePath: PricePath;
@@ -202,6 +220,7 @@ export interface TapeLoadResult {
     readonly tape: EngineBacktestTapeInput;
     readonly buffers: Record<string, ArrayBuffer>;
     readonly coverageWarnings: readonly string[];
+    readonly coverageIssues: readonly TapeCoverageIssue[];
 }
 export interface BacktestClientLike {
     init(): Promise<string>;
@@ -265,6 +284,7 @@ export interface PersistedSnapshot {
     readonly initialEquity: number;
     readonly subscriptionTier: SubscriptionTier;
     readonly dataQualityMode: DataQualityMode;
+    readonly coverageIssues?: readonly TapeCoverageIssue[];
     readonly symbols: string[];
     readonly timeframes: string[];
     readonly baseTimeframe: string;
@@ -289,6 +309,8 @@ export interface EngineBacktestRunSuccess {
     readonly experimentUrl: string;
     readonly persisted: boolean;
     readonly coverageWarnings: readonly string[];
+    readonly coverageIssues: readonly TapeCoverageIssue[];
+    readonly coverageNotice: TapeCoverageNotice;
 }
 export interface EngineBacktestSweepPointRow {
     readonly coordinate: {
@@ -372,6 +394,8 @@ export interface EngineBacktestSweepSuccess {
     readonly experimentId?: string;
     readonly experimentUrl?: string;
     readonly coverageWarnings: readonly string[];
+    readonly coverageIssues: readonly TapeCoverageIssue[];
+    readonly coverageNotice: TapeCoverageNotice;
     readonly axes: ReadonlyArray<{
         readonly path: readonly string[];
         readonly current: number;

package/dist/engine-backtest/types.js

@@ -1,2 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_DATA_QUALITY_MODE = void 0;
+/** New runs default to basic; `--data-quality strict` remains an explicit override. */
+exports.DEFAULT_DATA_QUALITY_MODE = "basic";

package/dist/skills-manifest.json

@@ -1,153 +1,153 @@
 {
   "schemaVersion": 1,
   "packageName": "@alphafox/cli",
-  "packageVersion": "0.3.9",
+  "packageVersion": "0.3.11",
   "contractVersion": "2026-08-13",
-  "bundleHash": "8693bb9b1b6f0c0bd70f75fe564a09ba829726f6e982d05c90a6595e8c36b715",
+  "bundleHash": "10abd3fc0d5bbd4a260f42a02bff35899e829543419cf0f678077546a7bebcc6",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "cb9f92b75cce3a03d4f2a9492b6ddd564541828bdb74acaf360cb3f2a0aa8447",
-          "size": 4405
+          "sha256": "ebc6138b666514ef543cf5b444d3ff293bd439eae5c39a231fada5b4dae27b11",
+          "size": 4408
         }
       ],
-      "hash": "92b330a3f902405235e2a049ce6c98a7cad705f8aeab6ba3c2062df33b222aec"
+      "hash": "c4c73d98a0ad828e66fccb406294ab3533530b1d003c71eebd9e569895cbf305"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4ea9c43c579ce7b4a4e5dd0e0ca10eeb793d19fc64e1cf8c4760b6d426524bf6",
-          "size": 783
+          "sha256": "714b3f0094a67bc08764ae26f900e3f61463950b2a031f4b46a478a968deea74",
+          "size": 784
         }
       ],
-      "hash": "a94dc7e2e7a958394dbebba5b02e25c7114116b0b1a265be6b544e92f5e4ea65"
+      "hash": "94085eb4ec63d15a217df97878282c7f0c1e59c93dfd34e26279113cdcc7b625"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "6c800c87dd98fc054508ffc179fce19f455cc2da762525accadf2b1fda68e647",
-          "size": 787
+          "sha256": "dcdd0cdd11e6c4160e314766b7150b70fb0b0b6b52b4ad65723853c0ccefdd93",
+          "size": 788
         }
       ],
-      "hash": "534d66e2614677fa7e40d3334f2e6992c632dccffc623c9dfcd963ae49eb66ac"
+      "hash": "38f9a8eff99035a55e40e96bd156d407282aa09adcf0c08b7713b18508c112dc"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "a12ab3e613b26246ef6eb8d1289307c266d3c82861a8d6567856d63dff47cd6d",
-          "size": 2370
+          "sha256": "1cc9b91b9f3994d3f0fde453fba4c08c0ff18849692518c1a73182cfc6267066",
+          "size": 2371
         }
       ],
-      "hash": "e4b6b6f1dc76681e37c1a71ecaa10ab985b4dcc04ca5b2eca8bfcec367076a02"
+      "hash": "f14d148e80c7c25b9306e57039e10b341b04c06fbe8c0602b60d49033436a149"
     },
     {
       "name": "alphafox-cache",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "cceafb6d8d0017090eedb5be82dd13fe2c26963531c5e92f49d1ed7ba948fc5b",
-          "size": 1529
+          "sha256": "292e0075bd55f5036a6bcb3afbc6184f5e010e4840b80c1940bbaa51bf8f2a9e",
+          "size": 1530
         }
       ],
-      "hash": "f858ee9c3e27c56035cede0f7a6929fc5128573a718762802fba67b7c9d6103a"
+      "hash": "4baa604211122515fa189bb5830d4b4b0633a92b585fd91b918879828d221740"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "8751aa7218862c44b4635d72a02a31752e400a67b41adec03aea77678a087c48",
-          "size": 7802
+          "sha256": "a0e00cdd48c4c4da1bbbe0d54f2b08dda273e6b6d7160e5a37485e7002218d05",
+          "size": 8278
         }
       ],
-      "hash": "2bab573fa07f5c5c1d83eb2e66d96d06abbff723e62f6b84a2de30a6ccf42339"
+      "hash": "49f17cdd45fef3c600ee954bb089b239609228dd205f12edad8973c6e2a13fba"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "416999214b3e99a9bbb3653286b2eefadbb7721da00762921e2c702de17f112a",
-          "size": 743
+          "sha256": "e883d53ce237ecec682555c9171519bf16139fee0db968825a47d8cfc4ccb25b",
+          "size": 744
         }
       ],
-      "hash": "988bdad202ba2e522d5d025339ed354063ada77ae56b0d2616963e13df659d83"
+      "hash": "087f26e565876d66709fb303cc6e379648a1b7de6f9f54c4015e973b8398fcb8"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "5181ca01a222ae17c3e8feb711211c4150f59745b1559da5537a5b42ff4439b9",
-          "size": 3078
+          "sha256": "d37df5d1498d201abd9206f5536ffbbf35fa20ec7f47aa20da40f07abcd3f847",
+          "size": 3079
         }
       ],
-      "hash": "29f11a29419e5443593255e07bc6055fe3d15e165ef5e442c550f56845dcb12d"
+      "hash": "dc57e16172f577410f80922436593ab5ac5d1d2ab62402fb2c8ee7d8bac84cbd"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "0f027ae12e13832a2d267bdf276a59882dc42396d45d31e6a43424d514209906",
-          "size": 698
+          "sha256": "0fdcc37a21deaee5195c2576ce563b895dc7aac2af2e269a38b2506860fbb5fc",
+          "size": 699
         }
       ],
-      "hash": "f8aa26444dd99e3374999086ab2956ce82156de2aab4c40a97a654082f899a29"
+      "hash": "c4acd5b245e6c1f21f1d35d96a33ffe8c1a4754c8405c92c54180765f14072ea"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "896e71ca6da5f82b9c857486be8225a623a2e3a01be1a807db4d21d209c69a18",
-          "size": 5385
+          "sha256": "cfd0716870fb6bcadbb20c7cad1999f32f8f237cfebb1fa143f6a49687256568",
+          "size": 5386
         }
       ],
-      "hash": "fc69c60e86b01d917f0a513d20643331d29ed2a7baa15577cd19f049b8f8b24a"
+      "hash": "939e048cd4243a13a341d0405a13f40d82dd6553a2db5e42765d90dae909331d"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "bbdba03e06c56e5fd35700071841e04a45c9b04d43727ba599bfbecf2fd77e1e",
-          "size": 1826
+          "sha256": "be35901e6d5c3766f73274552e5403e172a9c3ce9d560fbfd78cb68fd1c894c1",
+          "size": 1827
         }
       ],
-      "hash": "fb5847c1d8d0229d7b0d3598dbb26e1104be250dfe3a62d1759354c3ecba3e3d"
+      "hash": "e031e199ee2c1013e2bc39d2fc2a72b9f734ede86b3ca93d2a3ca53ace1c65cf"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.9",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "454102427cbb7ec119265c0c38adc9acd822881e23fad725b49f693c32ed19e3",
-          "size": 3122
+          "sha256": "2bac318aae54820edf6454c98e8ce4a16b350fce8e0e29c936ea434a72a0857d",
+          "size": 3123
         }
       ],
-      "hash": "4768ca40fba0d940bf8425dc544f9501c9c5bca5a920fc942247eb7557ec9dcf"
+      "hash": "2da4c6f7a381472f1d82118d5e44e3c52a1a6e7185b2f9e5a16181aa5f1c89bd"
     }
   ]
 }

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.9";
+export declare const CLI_VERSION = "0.3.11";
 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.9";
+exports.CLI_VERSION = "0.3.11";
 var operations_1 = require("./catalog/operations");
 Object.defineProperty(exports, "CLI_CONTRACT_VERSION", { enumerable: true, get: function () { return operations_1.CATALOG_VERSION; } });

package/docs/e2e-staging.md

@@ -10,13 +10,15 @@ Staging CLI issuer: `https://staging.alphafox.app`. Test login (staging-only, ga
 2. Device Flow split (`--no-wait` + `--device-code`)
 3. `whoami` / `auth status --verify`
 4. Readonly: strategy definitions, connectors, traders
-5. Write: create chat with idempotency
-6. Backtest create → watch stream → cancel
+5. ~~Write: create chat with idempotency~~ **historical** — chat is not a CLI surface; do not use `chats.create` as the trader-create path
+6. ~~Backtest create → watch stream → cancel~~ **historical** — web `/api/v1/backtests` is not a CLI surface; use `engine-backtest`
 7. High-risk without `--yes` → exit 10
 8. Logout / revoke
 9. Cross-env token rejection (prod token on staging)
 
-## Evidence (2026-08-13) — vertical slice pass
+## Evidence (2026-08-13) — vertical slice pass (historical chat / web-backtest slice)
+
+The chat and `POST /api/v1/backtests` steps below are a **historical** facade record. They are not the CLI trader-create path. Current create is Engine `trading.traders.create` (`strategyDefinitionId` + `config`). Do not treat this section as a playbook.
 
 Anonymous `GET https://staging.alphafox.app/api/v1/meta` → **HTTP 200**, `environment=staging`, `contractVersion=2026-08-13`, `commitSha=65d1f816007adc7acc09db5e86671931737e0379`, `x-request-id=66511bcf-dda9-4974-9378-3aacd8d938ff`. No 302 to `vercel.com/sso-api`. Vercel Authentication is disabled for the whole `alphafox-web` project (Preview `*.vercel.app` is also public; accepted).
 
@@ -66,7 +68,7 @@ Reused staging Device Flow session `userId=019f3073-307f-76e9-adf1-0203af9ab22b`
 - **Backtest vertical slice:** cannot `create → stream → cancel` until a chat has an integer `strategyId`, and until the facade body matches contracts (`backtestSettings`) or the catalog is updated to `{chatId, strategyId}`.
 - Parent Feishu task and t101364 (production publish / npm `latest` / production OAuth) stay **todo**. Do not merge web PR 448 to production `main` from this evidence.
 
-## Evidence (2026-08-13) — gapfix retest (idempotency + backtests.create)
+## Evidence (2026-08-13) — gapfix retest (historical; idempotency + backtests.create)
 
 Anonymous `GET https://staging.alphafox.app/api/v1/meta` → **HTTP 200**, `environment=staging`, `contractVersion=2026-08-13`, `commitSha=fba21ef4b2c3909c51a5a19e2d2a45b30d1d598c`, `x-request-id=8702a21b-a749-4007-82eb-76ca1dd0caaf`. No SSO redirect. Device Flow `test@local.com`: approve `requestId=77293035-ebfd-4b03-b0e1-0779dce81fdd`, token `requestId=9dcc28c1-c1cc-49fc-9435-687dfdb591c2`, `whoami` `userId=019f3073-307f-76e9-adf1-0203af9ab22b` `requestId=1473f107-d742-42eb-99e7-b60c6b583928`. CLI local `92c8610250b30e7881f79a2fde60b00fe50b4628`, catalog `contractsSha=d1f184e3d72581f155497978880d9ab3029ff858`. Staging llm-gateway image `0a10d8e3a1304b04eff2f21c503922a5b7c11491` (workflow `31683345740` failed after the container was healthy: `/opt/alphafox/images/alphafox-llm-gateway.env` permission denied). Do not merge web PR 448 to production `main`.
 

package/package.json

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