@tradejs/cli 3.1.29-beta.268 → 3.1.29-beta.270

package/dist/cli.js

@@ -1565,7 +1565,7 @@ var init_aiExport2 = __esm({
 });
 
 // src/lib/aiPocketSearchCli.ts
-var DAY_MS, DEFAULT_MIN_SUPPORT, LOW_CADENCE_EVENT_LIMIT, LOW_CADENCE_MAX_EVENT_SHARE, countIndependentEvents, getPeriodDays, clampInt, resolveAiPocketCadenceProfile, AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS, splitAiPocketResearchRowsByTimestamp, sealAiPocketTestPartition, readAiPocketSearchCliOption;
+var DAY_MS, DEFAULT_MIN_SUPPORT, LOW_CADENCE_EVENT_LIMIT, LOW_CADENCE_MAX_EVENT_SHARE, countIndependentEvents, getPeriodDays, clampInt, resolveAiPocketCadenceProfile, AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS, parseAiPocketTestSince, classifyAiPocketLabelHorizon, splitAiPocketResearchRowsByTimestamp, sealAiPocketTestPartition, readAiPocketSearchCliOption;
 var init_aiPocketSearchCli = __esm({
   "src/lib/aiPocketSearchCli.ts"() {
     "use strict";
@@ -1660,7 +1660,70 @@ var init_aiPocketSearchCli = __esm({
       validationSplit: "0",
       testSplit: "0.4"
     };
-    splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
+    parseAiPocketTestSince = (value) => {
+      const text = typeof value === "string" ? value.trim() : "";
+      const numeric = typeof value === "number" || /^\d+$/.test(text);
+      const iso = text.match(
+        /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/
+      );
+      const validCalendar = iso != null && Number(iso[2]) >= 1 && Number(iso[2]) <= 12 && Number(iso[3]) >= 1 && Number(iso[3]) <= new Date(Date.UTC(Number(iso[1]), Number(iso[2]), 0)).getUTCDate() && Number(iso[4]) < 24 && Number(iso[5]) < 60 && Number(iso[6] ?? 0) < 60;
+      const timestamp = numeric ? Number(value) : validCalendar ? Date.parse(text) : NaN;
+      if (!Number.isSafeInteger(timestamp) || timestamp <= 0 || timestamp > 864e13) {
+        throw new Error("--testSince requires a valid UTC timestamp or epoch ms");
+      }
+      return timestamp;
+    };
+    classifyAiPocketLabelHorizon = (decisionTimestamp, exitTimestamp, cutoff) => {
+      if (decisionTimestamp >= cutoff) return null;
+      if (typeof exitTimestamp !== "number" || !Number.isFinite(exitTimestamp)) {
+        return "unknown";
+      }
+      if (exitTimestamp < decisionTimestamp) {
+        throw new Error(
+          "--testSince requires label exitTimestamp >= decision timestamp"
+        );
+      }
+      return exitTimestamp >= cutoff ? "crossing" : null;
+    };
+    splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0, testSince) => {
+      if (testSince != null) {
+        const cutoff = parseAiPocketTestSince(testSince);
+        if (validationSplit !== 0) {
+          throw new Error("--testSince requires --validationSplit 0");
+        }
+        const trainRows = [];
+        const testRows = [];
+        const labelHorizonPurge = {
+          crossing: 0,
+          unknown: 0
+        };
+        for (const row of rows) {
+          if (typeof row.timestamp !== "number" || !Number.isFinite(row.timestamp)) {
+            throw new Error("--testSince requires a finite timestamp on every row");
+          }
+          const purge = classifyAiPocketLabelHorizon(
+            row.timestamp,
+            row.exitTimestamp,
+            cutoff
+          );
+          if (purge) {
+            labelHorizonPurge[purge] += 1;
+            continue;
+          }
+          (row.timestamp < cutoff ? trainRows : testRows).push(row);
+        }
+        if (!trainRows.length || !testRows.length) {
+          throw new Error(
+            "--testSince requires non-empty development and test partitions"
+          );
+        }
+        return {
+          trainRows,
+          validationRows: [],
+          testRows,
+          labelHorizonPurge
+        };
+      }
       const timestamps = [
         ...new Set(
           rows.map((row) => row.timestamp).filter((timestamp) => Number.isFinite(timestamp))
@@ -2043,6 +2106,12 @@ var init_commandOptions = __esm({
       if (sealTest && testSplit <= 0) {
         throw new Error("--sealTest requires a positive --testSplit");
       }
+      const explicitTestSince = hasCliOption2(argv2, "testSince");
+      const testSinceInput = explicitTestSince ? readAiPocketSearchCliOption({ argv: argv2, longName: "testSince" }) : flags35.testSince;
+      const testSince = explicitTestSince || testSinceInput != null && testSinceInput !== "" ? parseAiPocketTestSince(testSinceInput) : null;
+      if (testSince != null && validationSplit !== 0) {
+        throw new Error("--testSince requires --validationSplit 0");
+      }
       const maxEventCountShare = normalizeUnitRatio(
         readAiPocketSearchCliOption({
           argv: argv2,
@@ -2083,6 +2152,7 @@ var init_commandOptions = __esm({
         maxCombinations: normalizePositiveInt(flags35.maxCombinations, 6e4),
         validationSplit,
         testSplit,
+        testSince,
         sealTest,
         explicitMinValidationSupport: normalizeInt(flags35.minValidationSupport, 0),
         explicitMinEvents: normalizeInt(flags35.minEvents, 0),
@@ -4079,6 +4149,19 @@ var init_markdownReport = __esm({
             ["test_rows", run.testRows],
             ["validation_split", formatMdPercent(run.validationSplit)],
             ["test_split", formatMdPercent(run.testSplit)],
+            ["partition_mode", run.partitionMode ?? "timestamp-ratio"],
+            [
+              "purged_development_crossing_labels",
+              run.labelHorizonPurge?.crossing ?? 0
+            ],
+            [
+              "purged_development_unknown_labels",
+              run.labelHorizonPurge?.unknown ?? 0
+            ],
+            [
+              "test_since",
+              run.testSince == null ? "n/a" : new Date(run.testSince).toISOString()
+            ],
             ["test_sealed", run.sealedTest?.sealed ? "yes" : "no"],
             ["sealed_test_rows", run.sealedTest?.rows ?? run.testRows],
             ["sealed_test_events", run.sealedTest?.events ?? "n/a"],
@@ -4855,6 +4938,11 @@ var init_presenter = __esm({
             ["max_combinations", import_chalk4.default.magenta(String(maxCombinations))],
             ["validation_split", import_chalk4.default.magenta(formatRatio(validationSplit))],
             ["test_split", import_chalk4.default.magenta(formatRatio(testSplit))],
+            ["partition_mode", run.partitionMode ?? "timestamp-ratio"],
+            [
+              "test_since",
+              run.testSince == null ? "n/a" : new Date(run.testSince).toISOString()
+            ],
             [
               "test_evidence",
               sealedTest.sealed ? import_chalk4.default.green(
@@ -5248,6 +5336,7 @@ var init_dataset = __esm({
     import_registry = require("@tradejs/node/registry");
     init_aiPocketSearch();
     init_aiTrainDataset();
+    init_aiPocketSearchCli();
     normalizeQuality = (analysis) => {
       const quality = Number(analysis?.quality);
       return Number.isFinite(quality) ? Math.round(quality) : null;
@@ -5412,6 +5501,10 @@ var init_dataset = __esm({
       let failed = 0;
       const errors = [];
       const rows = [];
+      const labelHorizonPurge = {
+        crossing: 0,
+        unknown: 0
+      };
       const excludedFeaturePaths = /* @__PURE__ */ new Map();
       await (0, import_ai4.streamAiDatasetRows)({
         filePaths: prepared.filePaths,
@@ -5422,12 +5515,43 @@ var init_dataset = __esm({
           if (resolvedStrategyName === "unknown" && typeof row.strategyName === "string" && row.strategyName.trim()) {
             resolvedStrategyName = row.strategyName.trim();
           }
+          if (options.testSince != null && (typeof row.timestamp !== "number" || !Number.isFinite(row.timestamp))) {
+            throw new Error(
+              "--testSince requires a finite numeric timestamp on every export row"
+            );
+          }
           const timestamp = getDatasetRowTimestamp(row);
           if (prepared.sinceTimestamp != null && (timestamp == null || timestamp < prepared.sinceTimestamp) || options.untilTimestamp != null && (timestamp == null || timestamp > options.untilTimestamp)) {
             dateSkipped += 1;
             onProgress?.({ symbol: row.symbol, status: "date-skip" });
             return;
           }
+          if (options.testSince != null) {
+            const purge = classifyAiPocketLabelHorizon(
+              timestamp,
+              row.tradeResult?.exitTimestamp,
+              options.testSince
+            );
+            if (purge) {
+              labelHorizonPurge[purge] += 1;
+              return;
+            }
+            if (options.sealTest && timestamp >= options.testSince) {
+              rows.push({
+                signalId: row.signalId,
+                strategy: row.strategyName,
+                symbol: row.symbol,
+                direction: row.direction,
+                timestamp,
+                profit: 0,
+                profitableTrade: false,
+                aiApproved: false,
+                quality: null,
+                features: {}
+              });
+              return;
+            }
+          }
           try {
             const signal = extractSignalFromAiDatasetRow(row);
             const payload = (0, import_ai5.buildAiPayload)(signal);
@@ -5457,6 +5581,7 @@ var init_dataset = __esm({
               symbol: row.symbol,
               direction: row.direction,
               timestamp,
+              ...options.testSince != null ? { exitTimestamp: row.tradeResult?.exitTimestamp } : {},
               profit,
               profitableTrade: profit > 0,
               aiApproved: isAiApproval(row, analysis, options.minQuality),
@@ -5479,6 +5604,7 @@ var init_dataset = __esm({
         }
       });
       return {
+        labelHorizonPurge,
         rows,
         resolvedStrategyName,
         scanned,
@@ -5915,7 +6041,8 @@ var init_research = __esm({
     runAiPocketSearchResearch = ({
       rows,
       options,
-      onProgress
+      onProgress,
+      datasetLabelHorizonPurge
     }) => {
       const {
         direction,
@@ -5923,6 +6050,7 @@ var init_research = __esm({
         qualityThresholds,
         validationSplit,
         testSplit,
+        testSince,
         sealTest,
         cadenceMode,
         explicitMinSupport,
@@ -5947,14 +6075,30 @@ var init_research = __esm({
         coverageMode
       } = options;
       const directionRows = direction ? rows.filter((row) => row.direction === direction) : rows;
-      const scopeRows = resolveScopeRows(directionRows, scope);
-      const fullSplit = splitAiPocketResearchRowsByTimestamp(
+      const calendarSplit = testSince != null ? splitAiPocketResearchRowsByTimestamp(
+        rows,
+        validationSplit,
+        testSplit,
+        testSince
+      ) : null;
+      const inDirection = (row) => !direction || row.direction === direction;
+      const fullSplit = calendarSplit ? {
+        trainRows: calendarSplit.trainRows.filter(inDirection),
+        validationRows: calendarSplit.validationRows.filter(inDirection),
+        testRows: calendarSplit.testRows.filter(inDirection)
+      } : splitAiPocketResearchRowsByTimestamp(
         directionRows,
         validationSplit,
         testSplit
       );
+      if (testSince != null && (!fullSplit.trainRows.length || !fullSplit.testRows.length)) {
+        throw new Error(
+          "--testSince requires non-empty development and test partitions for the selected direction"
+        );
+      }
       const sealedFullSplit = sealAiPocketTestPartition(fullSplit, sealTest);
       const discoveryRows = sealedFullSplit.discoveryRows;
+      const scopeRows = resolveScopeRows(discoveryRows, scope);
       const trainRows = resolveScopeRows(fullSplit.trainRows, scope);
       const validationRows = resolveScopeRows(fullSplit.validationRows, scope);
       const testRows = resolveScopeRows(sealedFullSplit.searchTestRows, scope);
@@ -6107,6 +6251,12 @@ var init_research = __esm({
         }
       }
       return {
+        ...calendarSplit ? {
+          labelHorizonPurge: {
+            crossing: (calendarSplit.labelHorizonPurge?.crossing ?? 0) + (datasetLabelHorizonPurge?.crossing ?? 0),
+            unknown: (calendarSplit.labelHorizonPurge?.unknown ?? 0) + (datasetLabelHorizonPurge?.unknown ?? 0)
+          }
+        } : {},
         scopeRows,
         trainRows,
         validationRows,
@@ -6154,6 +6304,7 @@ var init_command = __esm({
         maxCombinations,
         validationSplit,
         testSplit,
+        testSince,
         maxBatch,
         maxSymbolCountShare,
         objective,
@@ -6201,6 +6352,7 @@ var init_command = __esm({
       const research = runAiPocketSearchResearch({
         rows,
         options,
+        datasetLabelHorizonPurge: evaluatedDataset.labelHorizonPurge,
         onProgress: createAiPocketSearchResearchProgressPresenter()
       });
       const {
@@ -6274,6 +6426,9 @@ var init_command = __esm({
           objective,
           validationSplit,
           testSplit,
+          testSince,
+          partitionMode: testSince == null ? "timestamp-ratio" : "calendar-cutoff",
+          ...research.labelHorizonPurge ? { labelHorizonPurge: research.labelHorizonPurge } : {},
           sealedTest,
           minValidationSupport: search.stats.cadence.minValidationSupport,
           reportPath,
@@ -6423,6 +6578,11 @@ var init_aiPocketSearch2 = __esm({
       "Trailing timestamp-grouped test share; default 0.4 (outer 60/40)",
       AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.testSplit
     );
+    import_args3.default.option(
+      ["z", "testSince"],
+      "Fixed calendar test boundary (UTC ISO or epoch ms); overrides the split ratio and requires validationSplit 0",
+      ""
+    );
     import_args3.default.option(
       ["w", "sealTest"],
       "Reserve test bounds without exposing its rows or economics to discovery",

package/dist/lib/aiPocketSearch.js

@@ -1966,6 +1966,19 @@ var buildAiPocketMarkdownReport = ({
         ["test_rows", run.testRows],
         ["validation_split", formatMdPercent(run.validationSplit)],
         ["test_split", formatMdPercent(run.testSplit)],
+        ["partition_mode", run.partitionMode ?? "timestamp-ratio"],
+        [
+          "purged_development_crossing_labels",
+          run.labelHorizonPurge?.crossing ?? 0
+        ],
+        [
+          "purged_development_unknown_labels",
+          run.labelHorizonPurge?.unknown ?? 0
+        ],
+        [
+          "test_since",
+          run.testSince == null ? "n/a" : new Date(run.testSince).toISOString()
+        ],
         ["test_sealed", run.sealedTest?.sealed ? "yes" : "no"],
         ["sealed_test_rows", run.sealedTest?.rows ?? run.testRows],
         ["sealed_test_events", run.sealedTest?.events ?? "n/a"],

package/dist/lib/aiPocketSearchCli.js

@@ -21,6 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var aiPocketSearchCli_exports = {};
 __export(aiPocketSearchCli_exports, {
   AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS: () => AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS,
+  classifyAiPocketLabelHorizon: () => classifyAiPocketLabelHorizon,
+  parseAiPocketTestSince: () => parseAiPocketTestSince,
   readAiPocketSearchCliOption: () => readAiPocketSearchCliOption,
   resolveAiPocketCadenceProfile: () => resolveAiPocketCadenceProfile,
   sealAiPocketTestPartition: () => sealAiPocketTestPartition,
@@ -119,7 +121,70 @@ var AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS = {
   validationSplit: "0",
   testSplit: "0.4"
 };
-var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
+var parseAiPocketTestSince = (value) => {
+  const text = typeof value === "string" ? value.trim() : "";
+  const numeric = typeof value === "number" || /^\d+$/.test(text);
+  const iso = text.match(
+    /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/
+  );
+  const validCalendar = iso != null && Number(iso[2]) >= 1 && Number(iso[2]) <= 12 && Number(iso[3]) >= 1 && Number(iso[3]) <= new Date(Date.UTC(Number(iso[1]), Number(iso[2]), 0)).getUTCDate() && Number(iso[4]) < 24 && Number(iso[5]) < 60 && Number(iso[6] ?? 0) < 60;
+  const timestamp = numeric ? Number(value) : validCalendar ? Date.parse(text) : NaN;
+  if (!Number.isSafeInteger(timestamp) || timestamp <= 0 || timestamp > 864e13) {
+    throw new Error("--testSince requires a valid UTC timestamp or epoch ms");
+  }
+  return timestamp;
+};
+var classifyAiPocketLabelHorizon = (decisionTimestamp, exitTimestamp, cutoff) => {
+  if (decisionTimestamp >= cutoff) return null;
+  if (typeof exitTimestamp !== "number" || !Number.isFinite(exitTimestamp)) {
+    return "unknown";
+  }
+  if (exitTimestamp < decisionTimestamp) {
+    throw new Error(
+      "--testSince requires label exitTimestamp >= decision timestamp"
+    );
+  }
+  return exitTimestamp >= cutoff ? "crossing" : null;
+};
+var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0, testSince) => {
+  if (testSince != null) {
+    const cutoff = parseAiPocketTestSince(testSince);
+    if (validationSplit !== 0) {
+      throw new Error("--testSince requires --validationSplit 0");
+    }
+    const trainRows = [];
+    const testRows = [];
+    const labelHorizonPurge = {
+      crossing: 0,
+      unknown: 0
+    };
+    for (const row of rows) {
+      if (typeof row.timestamp !== "number" || !Number.isFinite(row.timestamp)) {
+        throw new Error("--testSince requires a finite timestamp on every row");
+      }
+      const purge = classifyAiPocketLabelHorizon(
+        row.timestamp,
+        row.exitTimestamp,
+        cutoff
+      );
+      if (purge) {
+        labelHorizonPurge[purge] += 1;
+        continue;
+      }
+      (row.timestamp < cutoff ? trainRows : testRows).push(row);
+    }
+    if (!trainRows.length || !testRows.length) {
+      throw new Error(
+        "--testSince requires non-empty development and test partitions"
+      );
+    }
+    return {
+      trainRows,
+      validationRows: [],
+      testRows,
+      labelHorizonPurge
+    };
+  }
   const timestamps = [
     ...new Set(
       rows.map((row) => row.timestamp).filter((timestamp) => Number.isFinite(timestamp))
@@ -201,6 +266,8 @@ var readAiPocketSearchCliOption = ({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS,
+  classifyAiPocketLabelHorizon,
+  parseAiPocketTestSince,
   readAiPocketSearchCliOption,
   resolveAiPocketCadenceProfile,
   sealAiPocketTestPartition,

package/dist/scripts/aiPocketSearch.js

@@ -127,7 +127,70 @@ var AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS = {
   validationSplit: "0",
   testSplit: "0.4"
 };
-var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
+var parseAiPocketTestSince = (value) => {
+  const text = typeof value === "string" ? value.trim() : "";
+  const numeric = typeof value === "number" || /^\d+$/.test(text);
+  const iso = text.match(
+    /^(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(?::(\d{2})(?:\.\d{1,3})?)?(?:Z|[+-]\d{2}:\d{2})$/
+  );
+  const validCalendar = iso != null && Number(iso[2]) >= 1 && Number(iso[2]) <= 12 && Number(iso[3]) >= 1 && Number(iso[3]) <= new Date(Date.UTC(Number(iso[1]), Number(iso[2]), 0)).getUTCDate() && Number(iso[4]) < 24 && Number(iso[5]) < 60 && Number(iso[6] ?? 0) < 60;
+  const timestamp = numeric ? Number(value) : validCalendar ? Date.parse(text) : NaN;
+  if (!Number.isSafeInteger(timestamp) || timestamp <= 0 || timestamp > 864e13) {
+    throw new Error("--testSince requires a valid UTC timestamp or epoch ms");
+  }
+  return timestamp;
+};
+var classifyAiPocketLabelHorizon = (decisionTimestamp, exitTimestamp, cutoff) => {
+  if (decisionTimestamp >= cutoff) return null;
+  if (typeof exitTimestamp !== "number" || !Number.isFinite(exitTimestamp)) {
+    return "unknown";
+  }
+  if (exitTimestamp < decisionTimestamp) {
+    throw new Error(
+      "--testSince requires label exitTimestamp >= decision timestamp"
+    );
+  }
+  return exitTimestamp >= cutoff ? "crossing" : null;
+};
+var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0, testSince) => {
+  if (testSince != null) {
+    const cutoff = parseAiPocketTestSince(testSince);
+    if (validationSplit !== 0) {
+      throw new Error("--testSince requires --validationSplit 0");
+    }
+    const trainRows = [];
+    const testRows = [];
+    const labelHorizonPurge = {
+      crossing: 0,
+      unknown: 0
+    };
+    for (const row of rows) {
+      if (typeof row.timestamp !== "number" || !Number.isFinite(row.timestamp)) {
+        throw new Error("--testSince requires a finite timestamp on every row");
+      }
+      const purge = classifyAiPocketLabelHorizon(
+        row.timestamp,
+        row.exitTimestamp,
+        cutoff
+      );
+      if (purge) {
+        labelHorizonPurge[purge] += 1;
+        continue;
+      }
+      (row.timestamp < cutoff ? trainRows : testRows).push(row);
+    }
+    if (!trainRows.length || !testRows.length) {
+      throw new Error(
+        "--testSince requires non-empty development and test partitions"
+      );
+    }
+    return {
+      trainRows,
+      validationRows: [],
+      testRows,
+      labelHorizonPurge
+    };
+  }
   const timestamps = [
     ...new Set(
       rows.map((row) => row.timestamp).filter((timestamp) => Number.isFinite(timestamp))
@@ -445,6 +508,12 @@ var resolveAiPocketSearchCommandOptions = ({
   if (sealTest && testSplit <= 0) {
     throw new Error("--sealTest requires a positive --testSplit");
   }
+  const explicitTestSince = hasCliOption2(argv, "testSince");
+  const testSinceInput = explicitTestSince ? readAiPocketSearchCliOption({ argv, longName: "testSince" }) : flags2.testSince;
+  const testSince = explicitTestSince || testSinceInput != null && testSinceInput !== "" ? parseAiPocketTestSince(testSinceInput) : null;
+  if (testSince != null && validationSplit !== 0) {
+    throw new Error("--testSince requires --validationSplit 0");
+  }
   const maxEventCountShare = normalizeUnitRatio(
     readAiPocketSearchCliOption({
       argv,
@@ -485,6 +554,7 @@ var resolveAiPocketSearchCommandOptions = ({
     maxCombinations: normalizePositiveInt(flags2.maxCombinations, 6e4),
     validationSplit,
     testSplit,
+    testSince,
     sealTest,
     explicitMinValidationSupport: normalizeInt(flags2.minValidationSupport, 0),
     explicitMinEvents: normalizeInt(flags2.minEvents, 0),
@@ -2452,6 +2522,19 @@ var buildAiPocketMarkdownReport = ({
         ["test_rows", run.testRows],
         ["validation_split", formatMdPercent(run.validationSplit)],
         ["test_split", formatMdPercent(run.testSplit)],
+        ["partition_mode", run.partitionMode ?? "timestamp-ratio"],
+        [
+          "purged_development_crossing_labels",
+          run.labelHorizonPurge?.crossing ?? 0
+        ],
+        [
+          "purged_development_unknown_labels",
+          run.labelHorizonPurge?.unknown ?? 0
+        ],
+        [
+          "test_since",
+          run.testSince == null ? "n/a" : new Date(run.testSince).toISOString()
+        ],
         ["test_sealed", run.sealedTest?.sealed ? "yes" : "no"],
         ["sealed_test_rows", run.sealedTest?.rows ?? run.testRows],
         ["sealed_test_events", run.sealedTest?.events ?? "n/a"],
@@ -3204,6 +3287,11 @@ var presentAiPocketSearchResult = ({
         ["max_combinations", import_chalk.default.magenta(String(maxCombinations))],
         ["validation_split", import_chalk.default.magenta(formatRatio(validationSplit))],
         ["test_split", import_chalk.default.magenta(formatRatio(testSplit))],
+        ["partition_mode", run.partitionMode ?? "timestamp-ratio"],
+        [
+          "test_since",
+          run.testSince == null ? "n/a" : new Date(run.testSince).toISOString()
+        ],
         [
           "test_evidence",
           sealedTest.sealed ? import_chalk.default.green(
@@ -3749,6 +3837,10 @@ var evaluateAiPocketSearchDataset = async ({
   let failed = 0;
   const errors = [];
   const rows = [];
+  const labelHorizonPurge = {
+    crossing: 0,
+    unknown: 0
+  };
   const excludedFeaturePaths = /* @__PURE__ */ new Map();
   await (0, import_ai2.streamAiDatasetRows)({
     filePaths: prepared.filePaths,
@@ -3759,12 +3851,43 @@ var evaluateAiPocketSearchDataset = async ({
       if (resolvedStrategyName === "unknown" && typeof row.strategyName === "string" && row.strategyName.trim()) {
         resolvedStrategyName = row.strategyName.trim();
       }
+      if (options.testSince != null && (typeof row.timestamp !== "number" || !Number.isFinite(row.timestamp))) {
+        throw new Error(
+          "--testSince requires a finite numeric timestamp on every export row"
+        );
+      }
       const timestamp = getDatasetRowTimestamp(row);
       if (prepared.sinceTimestamp != null && (timestamp == null || timestamp < prepared.sinceTimestamp) || options.untilTimestamp != null && (timestamp == null || timestamp > options.untilTimestamp)) {
         dateSkipped += 1;
         onProgress?.({ symbol: row.symbol, status: "date-skip" });
         return;
       }
+      if (options.testSince != null) {
+        const purge = classifyAiPocketLabelHorizon(
+          timestamp,
+          row.tradeResult?.exitTimestamp,
+          options.testSince
+        );
+        if (purge) {
+          labelHorizonPurge[purge] += 1;
+          return;
+        }
+        if (options.sealTest && timestamp >= options.testSince) {
+          rows.push({
+            signalId: row.signalId,
+            strategy: row.strategyName,
+            symbol: row.symbol,
+            direction: row.direction,
+            timestamp,
+            profit: 0,
+            profitableTrade: false,
+            aiApproved: false,
+            quality: null,
+            features: {}
+          });
+          return;
+        }
+      }
       try {
         const signal = extractSignalFromAiDatasetRow(row);
         const payload = (0, import_ai3.buildAiPayload)(signal);
@@ -3794,6 +3917,7 @@ var evaluateAiPocketSearchDataset = async ({
           symbol: row.symbol,
           direction: row.direction,
           timestamp,
+          ...options.testSince != null ? { exitTimestamp: row.tradeResult?.exitTimestamp } : {},
           profit,
           profitableTrade: profit > 0,
           aiApproved: isAiApproval(row, analysis, options.minQuality),
@@ -3816,6 +3940,7 @@ var evaluateAiPocketSearchDataset = async ({
     }
   });
   return {
+    labelHorizonPurge,
     rows,
     resolvedStrategyName,
     scanned,
@@ -4182,7 +4307,8 @@ var resolveScopeRows = (rows, scope) => {
 var runAiPocketSearchResearch = ({
   rows,
   options,
-  onProgress
+  onProgress,
+  datasetLabelHorizonPurge
 }) => {
   const {
     direction,
@@ -4190,6 +4316,7 @@ var runAiPocketSearchResearch = ({
     qualityThresholds,
     validationSplit,
     testSplit,
+    testSince,
     sealTest,
     cadenceMode,
     explicitMinSupport,
@@ -4214,14 +4341,30 @@ var runAiPocketSearchResearch = ({
     coverageMode
   } = options;
   const directionRows = direction ? rows.filter((row) => row.direction === direction) : rows;
-  const scopeRows = resolveScopeRows(directionRows, scope);
-  const fullSplit = splitAiPocketResearchRowsByTimestamp(
+  const calendarSplit = testSince != null ? splitAiPocketResearchRowsByTimestamp(
+    rows,
+    validationSplit,
+    testSplit,
+    testSince
+  ) : null;
+  const inDirection = (row) => !direction || row.direction === direction;
+  const fullSplit = calendarSplit ? {
+    trainRows: calendarSplit.trainRows.filter(inDirection),
+    validationRows: calendarSplit.validationRows.filter(inDirection),
+    testRows: calendarSplit.testRows.filter(inDirection)
+  } : splitAiPocketResearchRowsByTimestamp(
     directionRows,
     validationSplit,
     testSplit
   );
+  if (testSince != null && (!fullSplit.trainRows.length || !fullSplit.testRows.length)) {
+    throw new Error(
+      "--testSince requires non-empty development and test partitions for the selected direction"
+    );
+  }
   const sealedFullSplit = sealAiPocketTestPartition(fullSplit, sealTest);
   const discoveryRows = sealedFullSplit.discoveryRows;
+  const scopeRows = resolveScopeRows(discoveryRows, scope);
   const trainRows = resolveScopeRows(fullSplit.trainRows, scope);
   const validationRows = resolveScopeRows(fullSplit.validationRows, scope);
   const testRows = resolveScopeRows(sealedFullSplit.searchTestRows, scope);
@@ -4374,6 +4517,12 @@ var runAiPocketSearchResearch = ({
     }
   }
   return {
+    ...calendarSplit ? {
+      labelHorizonPurge: {
+        crossing: (calendarSplit.labelHorizonPurge?.crossing ?? 0) + (datasetLabelHorizonPurge?.crossing ?? 0),
+        unknown: (calendarSplit.labelHorizonPurge?.unknown ?? 0) + (datasetLabelHorizonPurge?.unknown ?? 0)
+      }
+    } : {},
     scopeRows,
     trainRows,
     validationRows,
@@ -4411,6 +4560,7 @@ var runAiPocketSearchCommand = async ({
     maxCombinations,
     validationSplit,
     testSplit,
+    testSince,
     maxBatch,
     maxSymbolCountShare,
     objective,
@@ -4458,6 +4608,7 @@ var runAiPocketSearchCommand = async ({
   const research = runAiPocketSearchResearch({
     rows,
     options,
+    datasetLabelHorizonPurge: evaluatedDataset.labelHorizonPurge,
     onProgress: createAiPocketSearchResearchProgressPresenter()
   });
   const {
@@ -4531,6 +4682,9 @@ var runAiPocketSearchCommand = async ({
       objective,
       validationSplit,
       testSplit,
+      testSince,
+      partitionMode: testSince == null ? "timestamp-ratio" : "calendar-cutoff",
+      ...research.labelHorizonPurge ? { labelHorizonPurge: research.labelHorizonPurge } : {},
       sealedTest,
       minValidationSupport: search.stats.cadence.minValidationSupport,
       reportPath,
@@ -4667,6 +4821,11 @@ import_args.default.option(
   "Trailing timestamp-grouped test share; default 0.4 (outer 60/40)",
   AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.testSplit
 );
+import_args.default.option(
+  ["z", "testSince"],
+  "Fixed calendar test boundary (UTC ISO or epoch ms); overrides the split ratio and requires validationSplit 0",
+  ""
+);
 import_args.default.option(
   ["w", "sealTest"],
   "Reserve test bounds without exposing its rows or economics to discovery",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/cli",
-  "version": "3.1.29-beta.268",
+  "version": "3.1.29-beta.270",
   "description": "Official CLI for the TradeJS TypeScript framework: infra setup, backtests, signals, bots, and ML workflows.",
   "keywords": [
     "tradejs",
@@ -37,13 +37,13 @@
     "tradejs": "dist/cli.js"
   },
   "dependencies": {
-    "@tradejs/connectors": "^3.1.29-beta.268",
-    "@tradejs/core": "^3.1.29-beta.268",
-    "@tradejs/indicators": "^3.1.29-beta.268",
-    "@tradejs/infra": "^3.1.29-beta.268",
-    "@tradejs/node": "^3.1.29-beta.268",
+    "@tradejs/connectors": "^3.1.29-beta.270",
+    "@tradejs/core": "^3.1.29-beta.270",
+    "@tradejs/indicators": "^3.1.29-beta.270",
+    "@tradejs/infra": "^3.1.29-beta.270",
+    "@tradejs/node": "^3.1.29-beta.270",
     "@tradejs/strategy-kit": "3.0.6",
-    "@tradejs/types": "^3.1.29-beta.268",
+    "@tradejs/types": "^3.1.29-beta.270",
     "args": "^5.0.3",
     "bcryptjs": "^2.4.3",
     "chalk": "4.1.2",