@alphafox/cli 0.3.10 → 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.10",
+  "packageVersion": "0.3.11",
   "contractVersion": "2026-08-13",
-  "bundleHash": "e03966174d892d1205e0f4a5ec69c11d7cd78e9f5bd2f95fc3e145b7dfea14cd",
+  "bundleHash": "10abd3fc0d5bbd4a260f42a02bff35899e829543419cf0f678077546a7bebcc6",
   "skills": [
     {
       "name": "alphafox",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "58466ff1f9d42d6c64b1a4b2d52bafd40857dd7e0ca928f987fc926c358bd850",
-          "size": 4407
+          "sha256": "ebc6138b666514ef543cf5b444d3ff293bd439eae5c39a231fada5b4dae27b11",
+          "size": 4408
         }
       ],
-      "hash": "363bf0b3746b8cd8b291956b58dd9ac3e001bc1bfb80f0fa9c471aec4bf0021d"
+      "hash": "c4c73d98a0ad828e66fccb406294ab3533530b1d003c71eebd9e569895cbf305"
     },
     {
       "name": "alphafox-account",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4fcc7608817c900055dd605e0e71cd5b05e0945516701d0a281ebefb0407fb7b",
+          "sha256": "714b3f0094a67bc08764ae26f900e3f61463950b2a031f4b46a478a968deea74",
           "size": 784
         }
       ],
-      "hash": "273fdb4dd81103fc214b85ab7d59fb9dd65ebf2ec6d5d0d889837573bd8e3dae"
+      "hash": "94085eb4ec63d15a217df97878282c7f0c1e59c93dfd34e26279113cdcc7b625"
     },
     {
       "name": "alphafox-admin",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "0639573e3d59f42d3d718bdf07d719b01d802cbbdc04806c14882ebf8cd7c081",
+          "sha256": "dcdd0cdd11e6c4160e314766b7150b70fb0b0b6b52b4ad65723853c0ccefdd93",
           "size": 788
         }
       ],
-      "hash": "bcd9d41096e65472eebc0981cc9f614c755f28ae307dffdb15117ad8e22c954c"
+      "hash": "38f9a8eff99035a55e40e96bd156d407282aa09adcf0c08b7713b18508c112dc"
     },
     {
       "name": "alphafox-auth",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "d4edec17dd89e9e2e5d1759657837456f60d0b062d0a332334d9e6df6bfe003e",
+          "sha256": "1cc9b91b9f3994d3f0fde453fba4c08c0ff18849692518c1a73182cfc6267066",
           "size": 2371
         }
       ],
-      "hash": "01c80f4fa33736e85b845576e5d026e7ec32869a8c0f806119625d44e43fcbaa"
+      "hash": "f14d148e80c7c25b9306e57039e10b341b04c06fbe8c0602b60d49033436a149"
     },
     {
       "name": "alphafox-cache",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "c7f36174e5bb1ac97ca55e89b6720863d3d05a52a522ff5498a4c5ea4a31adaa",
+          "sha256": "292e0075bd55f5036a6bcb3afbc6184f5e010e4840b80c1940bbaa51bf8f2a9e",
           "size": 1530
         }
       ],
-      "hash": "a5a68c82de33aa8e09b12a65de1c45c522490d1b807c34a9616792cc71a13350"
+      "hash": "4baa604211122515fa189bb5830d4b4b0633a92b585fd91b918879828d221740"
     },
     {
       "name": "alphafox-engine-backtest",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "dbcb6dc047150bdf3988da112691868787be4a51bda95e60c63628269b06a8d7",
-          "size": 7803
+          "sha256": "a0e00cdd48c4c4da1bbbe0d54f2b08dda273e6b6d7160e5a37485e7002218d05",
+          "size": 8278
         }
       ],
-      "hash": "1e85862e3ea104968061a0d778b836a6475b1d676dfbbb80a074851cd4e386fb"
+      "hash": "49f17cdd45fef3c600ee954bb089b239609228dd205f12edad8973c6e2a13fba"
     },
     {
       "name": "alphafox-exchange",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "100f74f3240d86e73531a981585c9a236d3d5fd3ea31ecb54a74074d4e256403",
+          "sha256": "e883d53ce237ecec682555c9171519bf16139fee0db968825a47d8cfc4ccb25b",
           "size": 744
         }
       ],
-      "hash": "9230a196316900e2cf6bd15659d2bf47f5332d855663f4dd116744139cfcf968"
+      "hash": "087f26e565876d66709fb303cc6e379648a1b7de6f9f54c4015e973b8398fcb8"
     },
     {
       "name": "alphafox-market",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "e750c23aaad020221a6cfdf2b273886c8367de63ca68df6a95cb31492c447f0d",
+          "sha256": "d37df5d1498d201abd9206f5536ffbbf35fa20ec7f47aa20da40f07abcd3f847",
           "size": 3079
         }
       ],
-      "hash": "34283bcd2403e671ba5dcd4da7d3ad65f73a46ca3a5d29d28c3464038dfb074c"
+      "hash": "dc57e16172f577410f80922436593ab5ac5d1d2ab62402fb2c8ee7d8bac84cbd"
     },
     {
       "name": "alphafox-notification",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4d6e705ff6aff33af729bca184dcb716cd97d31b4fe188173b07423eba0d94d4",
+          "sha256": "0fdcc37a21deaee5195c2576ce563b895dc7aac2af2e269a38b2506860fbb5fc",
           "size": 699
         }
       ],
-      "hash": "a36312725ffa86ed9e629b056375b68ae6955d56a304c5895e4ab24666a53763"
+      "hash": "c4acd5b245e6c1f21f1d35d96a33ffe8c1a4754c8405c92c54180765f14072ea"
     },
     {
       "name": "alphafox-shared",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "4019aba3820aa1cf16dcb49202f251e4074829a130a7608caf6c67c3118a799c",
+          "sha256": "cfd0716870fb6bcadbb20c7cad1999f32f8f237cfebb1fa143f6a49687256568",
           "size": 5386
         }
       ],
-      "hash": "ae7dbd98f00f8f6162d5dc77bd35ca13303895f7d6c91d910af1f46f03d2869e"
+      "hash": "939e048cd4243a13a341d0405a13f40d82dd6553a2db5e42765d90dae909331d"
     },
     {
       "name": "alphafox-strategy",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "85c78855f0a312f5093642668606197cc68569e9203f5b85a6e9c4bd3b9c9c21",
+          "sha256": "be35901e6d5c3766f73274552e5403e172a9c3ce9d560fbfd78cb68fd1c894c1",
           "size": 1827
         }
       ],
-      "hash": "cb79e63d42a2559d2ec69b684c7d13d3351b49e117ca3256f462f0f04ba7d657"
+      "hash": "e031e199ee2c1013e2bc39d2fc2a72b9f734ede86b3ca93d2a3ca53ace1c65cf"
     },
     {
       "name": "alphafox-trading",
-      "version": "0.3.10",
+      "version": "0.3.11",
       "files": [
         {
           "path": "SKILL.md",
-          "sha256": "b580088309ddaeb0b460b572c9861393fe8d9b1129fca2f9dd2e9caa4b568368",
+          "sha256": "2bac318aae54820edf6454c98e8ce4a16b350fce8e0e29c936ea434a72a0857d",
           "size": 3123
         }
       ],
-      "hash": "c215ba2c61b5d4487046bb7f56145eabdc942c70c6c36f2d79cc2d7da887463f"
+      "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.10";
+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.10";
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alphafox/cli",
-  "version": "0.3.10",
+  "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.10
+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.10
+version: 0.3.11
 ---
 
 # 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. 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.10
+version: 0.3.11
 ---
 
 # AlphaFox
@@ -37,7 +37,7 @@ If several rows apply, load **all** of them (typical: `alphafox-shared` + `alpha
 The CLI may print this on **stderr** at most once every 24 hours:
 
 ```text
-[alphafox] update available: 0.3.9 -> 0.3.10. After the user confirms, run: alphafox update --format json --no-input,
+[alphafox] update available: 0.3.10 -> 0.3.11. After the user confirms, run: alphafox update --format json --no-input,
 ```
 
 If you see that notice (or `updateAvailable: true` from `alphafox update --check`):

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, and public operationIds only.
-version: 0.3.10
+version: 0.3.11
 ---
 
 # 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.10
+version: 0.3.11
 ---
 
 # 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.10
+version: 0.3.11
 ---
 
 # 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.
-version: 0.3.10
+version: 0.3.11
 ---
 
 # Engine Backtest
@@ -52,7 +52,7 @@ alphafox engine-backtest run \
   --format jsonl --no-input
 ```
 
-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 `strict`. `--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.
+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.
 
@@ -92,13 +92,14 @@ Owner isolation and 7-day expiry are enforced by the server. Applying a coordina
 
 1. Edit config JSON.
 2. `engine-backtest run` (reuse `--experiment` after the first create).
-3. Read `data.metrics` / `data.engineVersion` / `data.runId` / `data.experimentUrl`.
+3. Read `data.metrics` / `data.engineVersion` / `data.runId` / `data.experimentUrl`. After the run, also read `data.coverageNotice` (`warning` = mid-range candle gaps; `notice` = start / other soft gaps).
 4. Adjust parameters and run again. Do not invent a token flag if persist returns 401 — `alphafox auth login`.
 5. After a long-range or 1m run, follow `alphafox-cache`: `alphafox cache status`. If `data.tape.large` is true, ask **回测下载的历史数据比较大，要不要我帮你清理本地缓存？** and wait for yes.
 
 ## Safety
 
 - Unauthenticated persist/create fails like `whoami` (HTTP 401, exit 77).
+- Default `basic` data quality: missing market / empty / corrupted tape **stops**; soft gaps complete the run and surface as `coverageNotice`. Do not silently switch to `strict` or hide those notices.
 - `strict` data quality: missing/gapped tape **stops**. Do not retry as `basic` unless the operator asks.
 - `planBacktest` unsupported → fail with the plan reason. Do not degrade to a guessed universe.
 - Catalog `engine_backtest.experiments.byId.update` / `.delete` / `.sweeps.byId.delete` are high-risk-write and are **not** this command's run/sweep path.

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.10
+version: 0.3.11
 ---
 
 # 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.10
+version: 0.3.11
 ---
 
 # Market

package/skills/notification/SKILL.md

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

package/skills/strategy/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: alphafox-strategy
 description: Strategy definitions — list types (grid, dca, copy, …) and validate config. Creating a running strategy is creating a trader; use alphafox-trading for that.
-version: 0.3.10
+version: 0.3.11
 ---
 
 # 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.
-version: 0.3.10
+version: 0.3.11
 ---
 
 # Running strategies (traders)

package/vendor/backtest-runner/README.md

@@ -33,13 +33,13 @@ import {
   assembleScenario,
 } from "@alphafoxai/backtest-runner";
 
-const { tape, buffers, coverageWarnings } = await loadTape({
+const { tape, buffers, coverageWarnings, coverageIssues } = await loadTape({
   exchangeId: "binance_perp_usdt",
   symbols: ["BTC/USDT:USDT"],
   timeframes: ["1m", "1h"],
   fromMs,
   toMs,
-  dataQualityMode: "strict",
+  dataQualityMode: "basic",
 });
 
 const scenario = assembleScenario({
@@ -82,8 +82,8 @@ const scenario = assembleScenario({
 
 ## 数据质量
 
-- `strict`（默认）：任何缺口 / 缺数 / 非法 K 线都抛 `TapeDataUnavailableError`。
-- `basic`：硬失败（缺市场、空序列、非法 K 线、拉数失败）仍抛错；软缺口进入 `coverageWarnings`。
+- `basic`（默认）：硬失败（缺市场、空序列、非法 K 线、拉数失败）仍抛错；软缺口进入 `coverageIssues` 与 `coverageWarnings`。起始缺口（`prefix_gap`）较轻，中间缺口（`internal_gap`）较重。
+- `strict`：任何缺口 / 缺数 / 非法 K 线都抛 `TapeDataUnavailableError`。
 - 禁止 mock 成功或静默降级。
 
 ## 已知限制（相对 alphafox-web）

package/vendor/backtest-runner/index.d.ts

@@ -109,6 +109,7 @@ export function createFileTapeCache(
 export function createDisabledTapeCache(): FileTapeCache;
 
 export type TapeDataQualityMode = "strict" | "basic";
+export const DEFAULT_TAPE_DATA_QUALITY_MODE: TapeDataQualityMode;
 export type TapeDataIssueCode =
   | "market_missing"
   | "ohlcv_missing"
@@ -140,6 +141,17 @@ export function isTapeDataUnavailableError(
   value: unknown
 ): value is TapeDataUnavailableError;
 
+export function summarizeTapeCoverageIssues(issues: readonly TapeDataIssue[]): {
+  readonly prefix: TapeDataIssue[];
+  readonly internal: TapeDataIssue[];
+  readonly other: TapeDataIssue[];
+};
+
+export function formatCoverageSoftWarning(
+  issues: readonly TapeDataIssue[],
+  coverageRatio: number
+): string;
+
 export type EngineBacktestPrecisionMode = "DECIMAL_PLACES" | "TICK_SIZE";
 export type EngineBacktestSubscriptionTier = "free" | "pro" | "pro_max";
 export type EngineBacktestPricePath = "ohlc_path_4" | "close_only";
@@ -334,6 +346,7 @@ export interface TapeLoadResult {
   readonly tape: EngineBacktestTapeInput;
   readonly buffers: Record<string, ArrayBuffer>;
   readonly coverageWarnings: readonly string[];
+  readonly coverageIssues: readonly TapeDataIssue[];
   readonly chartData?: {
     readonly exchangeId: string;
     readonly series: readonly TapeChartSeries[];

package/vendor/backtest-runner/index.mjs

@@ -27,8 +27,11 @@ export {
 export {
   TapeDataUnavailableError,
   isTapeDataUnavailableError,
+  DEFAULT_TAPE_DATA_QUALITY_MODE,
   evaluateOhlcvCoverage,
   analyzeOhlcvCoverage,
+  formatCoverageSoftWarning,
+  summarizeTapeCoverageIssues,
 } from "./lib/coverage.mjs";
 export {
   TIMEFRAME_MS,

package/vendor/backtest-runner/lib/coverage.mjs

@@ -178,6 +178,8 @@ export function analyzeOhlcvCoverage(input) {
   };
 }
 
+export const DEFAULT_TAPE_DATA_QUALITY_MODE = "basic";
+
 export function evaluateOhlcvCoverage(input) {
   const report = analyzeOhlcvCoverage(input);
 
@@ -210,12 +212,45 @@ export function evaluateOhlcvCoverage(input) {
   };
 }
 
+export function summarizeTapeCoverageIssues(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);
+    }
+  }
+  return { prefix, internal, other };
+}
+
 export function formatCoverageSoftWarning(issues, coverageRatio) {
-  const codes = [...new Set(issues.map((item) => item.code))].join(", ");
   const sample = issues[0];
   const symbol = sample?.symbol ?? "unknown";
   const timeframe = sample?.timeframe ?? "*";
-  return `${symbol} ${timeframe}: accepted soft data issues (${codes}) with ${(coverageRatio * 100).toFixed(1)}% replay coverage`;
+  const codes = [...new Set(issues.map((item) => item.code))];
+  const summary = summarizeTapeCoverageIssues(issues);
+  const parts = [];
+  if (summary.prefix.length > 0) {
+    parts.push("missing start candles (less severe)");
+  }
+  if (summary.internal.length > 0) {
+    parts.push("missing mid-range candles (more severe)");
+  }
+  if (summary.other.length > 0) {
+    parts.push(
+      `other soft gaps (${summary.other.map((item) => item.code).join(", ")})`
+    );
+  }
+  const detail =
+    parts.length > 0
+      ? parts.join("; ")
+      : `accepted soft data issues (${codes.join(", ")})`;
+  return `${symbol} ${timeframe}: ${detail} with ${(coverageRatio * 100).toFixed(1)}% replay coverage`;
 }
 
 function issue(input, code, detail = {}) {

package/vendor/backtest-runner/lib/tape-loader.mjs

@@ -5,6 +5,7 @@ import {
   DEFAULT_TAPE_CACHE_DIR,
 } from "./cache.mjs";
 import {
+  DEFAULT_TAPE_DATA_QUALITY_MODE,
   formatCoverageSoftWarning,
   isTapeDataUnavailableError,
   TapeDataUnavailableError,
@@ -187,7 +188,8 @@ export async function loadTape(request, options = {}) {
   const seriesConcurrency = resolveTapeSeriesConcurrency(
     options.seriesConcurrency ?? request.seriesConcurrency
   );
-  const dataQualityMode = request.dataQualityMode ?? "strict";
+  const dataQualityMode =
+    request.dataQualityMode ?? DEFAULT_TAPE_DATA_QUALITY_MODE;
   const baseTimeframe = resolvePlanBaseTimeframe({
     baseTimeframe: request.baseTimeframe,
     timeframes: [
@@ -284,6 +286,7 @@ export async function loadTape(request, options = {}) {
   const totalSeries = seriesJobs.length;
   const dataIssues = [];
   const coverageWarnings = [];
+  const coverageIssues = [];
   const seriesFractions = new Array(totalSeries).fill(0);
   let lastOhlcvDetail = "";
   const reportOhlcv = (index, fraction, detail) => {
@@ -343,6 +346,7 @@ export async function loadTape(request, options = {}) {
       continue;
     }
     if (result.loaded.softIssues.length > 0) {
+      coverageIssues.push(...result.loaded.softIssues);
       coverageWarnings.push(
         formatCoverageSoftWarning(
           result.loaded.softIssues,
@@ -409,6 +413,7 @@ export async function loadTape(request, options = {}) {
     },
     buffers,
     coverageWarnings,
+    coverageIssues,
     chartData: {
       exchangeId: exchangeDefinition.id,
       series: chartSeries,