@tradejs/cli 3.1.29-beta.261 → 3.1.29-beta.262

package/README.md

@@ -102,8 +102,10 @@ yarn exec tradejs backtest -c TrendFollow:base -d 30 --cacheOnly --jev --jevReco
 Without `--jev`, ordinary backtests do not evaluate Jev, even if a configuration
 contains `JEV`. Use `--ai --jev` to save completed trades with Jev features for
 AI training. `--jev` alone records Jev assessments without enabling AI export.
-Jev can ask eight independent questions: trend, swing, current participation,
-setup participation, entry extension, confirmation, setup strength, and geometry.
+Jev uses one current set of nine questions: directional agreement, correction
+containment, current volume expansion, setup volume contraction, entry proximity,
+entry candle conviction, impulse persistence, boundary regularity, and overall
+signal strength.
 It asks each question only when the corresponding signal-time facts exist and
 marks missing facts explicitly. The shared projection
 selects a few signal-time trend, swing, volume, delta, entry-distance and
@@ -114,6 +116,38 @@ which is available to the strategy's AI gate and AI export. Jev scores do not
 approve or reject entries. Backtests do not apply the AI gate; `ai-train`
 evaluates it on exported outcomes, while runtime follows `AI_MODE`.
 
+`--jev` and runtime `JEV` always use the current compact nine-question set.
+There is no question-set selector or fallback to older rubrics. The recorded
+`micro-v3` marker and question hash identify the current meanings; old or
+unversioned recordings and local models are rejected. Use a new recording
+directory for the new backtest and retrain local models from current answers.
+
+The first eight questions describe separate signal-time facts. The ninth asks
+how strong and actionable the signal is: do the available facts support opening
+a trade now? It weighs direction, setup, confirmation, placement and the
+stop/target plan together. Essential missing facts and unresolved conflicts
+reduce support. All eligible questions share the same compact state in one
+request; outcomes and other Jev answers are excluded.
+
+Its ten rubric levels appear as
+`additionalIndicators.jev.scores.signalStrength`, from **1 to 10** (decimal
+expected scores are retained). Confidence remains 0–1. The API returns a
+zero-based 0–9 score; recordings and local teacher models normalize it to 0–1,
+and AI features convert it to 1–10. This is an entry assessment, not a calibrated
+probability of profit, and never automatically approves or blocks a trade.
+
+```bash
+yarn exec tradejs backtest -c <Strategy>:<config> -d 365 --cacheOnly --ai --jev \
+  --jevRecordsDir data/ai/jev/<new-study>
+```
+
+Use `--ai` to retain completed outcomes for comparing the score with realized
+PnL. Freeze score thresholds on the first 60% with three internal stability
+blocks before checking the last 40%. Compare with the current gate and ordinary
+features on the same rows, include independent event support and costs, and do
+not choose thresholds on the outer test. A fresh run does not make previously
+inspected historical outcomes untouched.
+
 Any strategy can optionally attach `jevEvidence` through its `StrategyAPI.entry`
 `additionalIndicators` with a version, `knownAt` timestamp, up to 16 scalar
 setup facts and 16 scalar geometry facts:
@@ -147,9 +181,12 @@ Provider responses and decisions are saved under `data/ai/jev`, or the directory
 selected with `--jevRecordsDir`. Input, selected question version and provider
 identity determine each signal record. Equivalent facts reuse one provider
 response even when signal timestamps or symbols differ. Input v4 records
-explicitly store missing facts and their sources. The changed question hash
-prevents older four-question recordings and local models from being replayed as
-answers to the new questions.
+explicitly store missing facts and their sources. Paid state groups fact paths
+by namespace and retains exact values, units and missing reasons; signal identity,
+internal versions and source metadata remain local. The current questions use
+short rubrics with explicit thresholds and unknown-data rules. Recordings and
+local models must match the current question marker and hash. Older versions
+are not migrated or used as substitutes for missing current answers.
 `--jevRecorded` requires the same signal-time input facts, question set and
 provider as the recording run. A shorter backtest may warm up indicators from
 a different history or reach the same date with a different trade state, so its
@@ -179,9 +216,11 @@ path for each run.
 
 Training fits shallow trees to Jev scores, without trade outcomes as features or
 labels. It requires at least 30 samples across 10 distinct signal times, selects
-one strategy and one teacher/provider lineage, and separates train/validation/test
-chronologically as 60/20/20. Three additional expanding-window folds check later
-periods with independently fitted trees. The report measures teacher agreement, score error
+one strategy and one teacher/provider lineage, and splits timestamp groups
+chronologically into 60% development and 40% test. Three expanding-window folds
+fit earlier development data and check later development data, entirely inside
+the first 60%. The final teacher model uses the full development partition.
+The outer test never fits or selects the model. The report measures teacher agreement, score error
 and matched-outcome economics. These summaries are not sequential portfolio
 backtests and do not establish profitability. Validate a frozen gate on a later
 period with `--jevModelFile` before runtime use. Studies are bounded to 20,000

package/dist/cli.js

@@ -1564,7 +1564,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, splitAiPocketCoverageRowsByTimestamp, 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, splitAiPocketResearchRowsByTimestamp, sealAiPocketTestPartition, readAiPocketSearchCliOption;
 var init_aiPocketSearchCli = __esm({
   "src/lib/aiPocketSearchCli.ts"() {
     "use strict";
@@ -1606,7 +1606,7 @@ var init_aiPocketSearchCli = __esm({
       validationRows = [],
       testRows = [],
       mode = "auto",
-      validationSplit = 0.25,
+      validationSplit = 0,
       minSupport,
       minEvents,
       minValidationSupport,
@@ -1656,8 +1656,8 @@ var init_aiPocketSearchCli = __esm({
       minProfitFactor: "1.2",
       minWinRate: "0",
       minTotalProfit: "0",
-      validationSplit: "0.25",
-      testSplit: "0"
+      validationSplit: "0",
+      testSplit: "0.4"
     };
     splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
       const timestamps = [
@@ -1698,11 +1698,6 @@ var init_aiPocketSearchCli = __esm({
         testRows: rows.filter((row) => isIn(testTimestamps, row.timestamp))
       };
     };
-    splitAiPocketCoverageRowsByTimestamp = (rows, family, validationSplit, testSplit = 0) => splitAiPocketResearchRowsByTimestamp(
-      rows.filter((row) => row.featureCoverage?.[family] === true),
-      validationSplit,
-      testSplit
-    );
     sealAiPocketTestPartition = (split, sealed) => {
       const finiteTimestamps = split.testRows.map((row) => row.timestamp).filter((timestamp) => Number.isFinite(timestamp));
       return {
@@ -2033,17 +2028,17 @@ var init_commandOptions = __esm({
           longName: "validationSplit",
           shortName: "V"
         }) ?? flags35.validationSplit,
-        0.25
-      ) : 0.25;
+        0
+      ) : 0;
       const testSplit = hasCliOption2(argv2, "testSplit", "T") ? normalizeRatio(
         readAiPocketSearchCliOption({
           argv: argv2,
           longName: "testSplit",
           shortName: "T"
         }) ?? flags35.testSplit,
-        0
-      ) : 0;
-      const sealTest = Boolean(flags35.sealTest);
+        0.4
+      ) : 0.4;
+      const sealTest = flags35.sealTest == null ? true : Boolean(flags35.sealTest);
       if (sealTest && testSplit <= 0) {
         throw new Error("--sealTest requires a positive --testSplit");
       }
@@ -4275,6 +4270,22 @@ var init_markdownReport = __esm({
         "",
         markdownTable(pocketTableHeaders, pocketRows(pocketSearch.positivePockets)),
         "",
+        "## Development Stability (inside discovery, not independent validation)",
+        "",
+        markdownTable(
+          ["Condition", "Status", "Block", "Events", "PnL", "PF"],
+          pocketSearch.positivePockets.flatMap(
+            (pocket) => (pocket.stability?.folds ?? []).map((fold, index) => [
+              pocket.condition,
+              pocket.stability?.status,
+              index + 1,
+              fold.summary.events,
+              formatMdNumber(fold.summary.totalProfit),
+              formatMdNumber(fold.summary.profitFactor)
+            ])
+          )
+        ),
+        "",
         "## Top Loss Pockets",
         "",
         markdownTable(pocketTableHeaders, pocketRows(pocketSearch.negativePockets)),
@@ -5815,6 +5826,70 @@ var init_aiTrainMetrics = __esm({
   }
 });
 
+// src/lib/aiPocketSearch/stability.ts
+var assessDevelopmentStability;
+var init_stability = __esm({
+  "src/lib/aiPocketSearch/stability.ts"() {
+    "use strict";
+    init_predicates();
+    init_summary();
+    assessDevelopmentStability = (result, options) => {
+      const minEvents = options.minEventsPerFold ?? 5;
+      const timestamps = [...new Set(options.timestamps)].sort((a, b) => a - b);
+      const boundaries = [0, 1, 2, 3].map(
+        (index) => index === 3 ? timestamps.at(-1) == null ? Number.POSITIVE_INFINITY : timestamps.at(-1) + 1 : timestamps[Math.floor(timestamps.length * index / 3)] ?? Number.POSITIVE_INFINITY
+      );
+      const blocks = [0, 1, 2].map((index) => ({
+        start: boundaries[index],
+        end: boundaries[index + 1],
+        rows: options.developmentRows.filter(
+          (row) => row.timestamp != null && row.timestamp >= boundaries[index] && row.timestamp < boundaries[index + 1]
+        ),
+        baseline: options.baselineRows.filter(
+          (row) => row.timestamp != null && row.timestamp >= boundaries[index] && row.timestamp < boundaries[index + 1]
+        )
+      }));
+      for (const pocket of result.positivePockets) {
+        const folds = blocks.map((block) => {
+          const mask = buildPredicateListMask(block.rows, pocket.predicates).mask;
+          const selected = block.rows.filter((_3, index) => mask[index] === 1);
+          const summary = summarizeAiPocketRows(selected);
+          const baseline = summarizeAiPocketRows(block.baseline);
+          const objectiveSummary = result.objective === "add-to-gate" ? summarizeAiPocketRows([
+            .../* @__PURE__ */ new Set([...block.baseline, ...selected])
+          ]) : summary;
+          return {
+            startTimestamp: Number.isFinite(block.start) ? block.start : null,
+            endTimestamp: Number.isFinite(block.end) ? block.end : null,
+            summary,
+            objectiveSummary,
+            baseline
+          };
+        });
+        const supported = folds.filter((fold) => fold.summary.events >= minEvents);
+        const unstable = supported.some(
+          (fold) => fold.objectiveSummary.totalProfit < (result.objective === "add-to-gate" ? fold.baseline.totalProfit : 0) || (fold.objectiveSummary.profitFactor ?? (fold.objectiveSummary.grossLoss === 0 ? Infinity : 0)) < 1
+        );
+        const status = unstable ? "unstable" : supported.length < 3 ? "insufficient-support" : "stable";
+        pocket.stability = {
+          status,
+          role: "development-only diagnostic",
+          minEventsPerFold: minEvents,
+          folds
+        };
+        if (status !== "stable") {
+          pocket.readiness = "research-only";
+          pocket.readinessReasons.push(`development stability: ${status}`);
+        }
+      }
+      const rank = { stable: 0, "insufficient-support": 1, unstable: 2 };
+      result.positivePockets.sort(
+        (a, b) => rank[a.stability.status] - rank[b.stability.status]
+      );
+    };
+  }
+});
+
 // src/lib/aiPocketSearch/research.ts
 var resolveScopeRows, runAiPocketSearchResearch;
 var init_research = __esm({
@@ -5823,6 +5898,7 @@ var init_research = __esm({
     init_aiTrainMetrics();
     init_aiPocketSearch();
     init_aiPocketSearchCli();
+    init_stability();
     resolveScopeRows = (rows, scope) => {
       if (scope === "approved") {
         return rows.filter((row) => row.aiApproved);
@@ -5917,7 +5993,7 @@ var init_research = __esm({
           maxEventCountShare,
           explicitMaxEventCountShare
         });
-        return searchAiPockets(train, {
+        const result = searchAiPockets(train, {
           minSupport: cadenceProfile.minSupport,
           minProfitFactor,
           minTotalProfit,
@@ -5947,6 +6023,17 @@ var init_research = __esm({
           progressInterval: 250,
           onProgress: (progress) => onProgress?.({ label, progress })
         });
+        assessDevelopmentStability(result, {
+          developmentRows: [...train, ...validation],
+          baselineRows: [...trainBaseline, ...validationBaseline],
+          // Every provider/scope uses the same outer development timestamps.
+          timestamps: [
+            ...new Set(
+              fullSplit.trainRows.concat(fullSplit.validationRows).map((row) => row.timestamp)
+            )
+          ].sort((a, b) => a - b)
+        });
+        return result;
       };
       const search = runSearch({
         label: "full",
@@ -5966,12 +6053,12 @@ var init_research = __esm({
       const coverageSearches = [];
       if (coverageMode === "auto") {
         for (const family of ["cmc", "coinalyze"]) {
-          const cohortSplit = splitAiPocketCoverageRowsByTimestamp(
-            directionRows,
-            family,
-            validationSplit,
-            testSplit
-          );
+          const covered = (row) => row.featureCoverage?.[family] === true;
+          const cohortSplit = {
+            trainRows: fullSplit.trainRows.filter(covered),
+            validationRows: fullSplit.validationRows.filter(covered),
+            testRows: fullSplit.testRows.filter(covered)
+          };
           const sealedCohortSplit = sealAiPocketTestPartition(
             cohortSplit,
             sealTest
@@ -6327,18 +6414,18 @@ var init_aiPocketSearch2 = __esm({
     );
     import_args3.default.option(
       ["V", "validationSplit"],
-      "Trailing time-ordered scope share reserved for validation (0 disables)",
+      "Optional legacy tuning share; default 0, stability is checked inside development",
       AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.validationSplit
     );
     import_args3.default.option(
       ["T", "testSplit"],
-      "Trailing timestamp-grouped scope share withheld as untouched test",
+      "Trailing timestamp-grouped test share; default 0.4 (outer 60/40)",
       AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.testSplit
     );
     import_args3.default.option(
       ["w", "sealTest"],
       "Reserve test bounds without exposing its rows or economics to discovery",
-      false
+      true
     );
     import_args3.default.option(
       ["N", "minValidationSupport"],
@@ -8823,6 +8910,17 @@ var init_jevResearch = __esm({
             throw new Error(
               "Export exceeds 20000 samples; select a bounded recording directory"
             );
+          await (0, import_jev2.evaluateJevInput)({
+            input: record.input,
+            config: {
+              source: "recorded",
+              mode: "observe",
+              provider: record.provider,
+              recordsDir: options.recordsDir
+            },
+            userName: options.userName,
+            projectRoot: options.projectRoot
+          });
           const outcome = byRecord.get(record.id);
           rows2.push({
             schema: "tradejs-jev-study/v4",
@@ -8942,6 +9040,10 @@ var init_jevOptions = __esm({
     import_jev5 = require("@tradejs/node/jev");
     resolveBacktestAiExportEnabled = (flags35) => Boolean(flags35.ai);
     resolveBacktestJev = async (flags35, userName3, projectRoot18) => {
+      if (flags35.jevQuestionSet != null)
+        throw new Error(
+          "--jevQuestionSet was removed; --jev always uses the current nine-question set"
+        );
       if (!flags35.jev) {
         if (flags35.jevRecorded || flags35.jevModelFile)
           throw new Error("Jev options require --jev");

package/dist/lib/aiPocketSearch.js

@@ -2158,6 +2158,22 @@ var buildAiPocketMarkdownReport = ({
     "",
     markdownTable(pocketTableHeaders, pocketRows(pocketSearch.positivePockets)),
     "",
+    "## Development Stability (inside discovery, not independent validation)",
+    "",
+    markdownTable(
+      ["Condition", "Status", "Block", "Events", "PnL", "PF"],
+      pocketSearch.positivePockets.flatMap(
+        (pocket) => (pocket.stability?.folds ?? []).map((fold, index) => [
+          pocket.condition,
+          pocket.stability?.status,
+          index + 1,
+          fold.summary.events,
+          formatMdNumber(fold.summary.totalProfit),
+          formatMdNumber(fold.summary.profitFactor)
+        ])
+      )
+    ),
+    "",
     "## Top Loss Pockets",
     "",
     markdownTable(pocketTableHeaders, pocketRows(pocketSearch.negativePockets)),

package/dist/lib/aiPocketSearchCli.js

@@ -66,7 +66,7 @@ var resolveAiPocketCadenceProfile = ({
   validationRows = [],
   testRows = [],
   mode = "auto",
-  validationSplit = 0.25,
+  validationSplit = 0,
   minSupport,
   minEvents,
   minValidationSupport,
@@ -116,8 +116,8 @@ var AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS = {
   minProfitFactor: "1.2",
   minWinRate: "0",
   minTotalProfit: "0",
-  validationSplit: "0.25",
-  testSplit: "0"
+  validationSplit: "0",
+  testSplit: "0.4"
 };
 var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
   const timestamps = [

package/dist/lib/jevMicroReferences.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/jevMicroReferences.ts
+var jevMicroReferences_exports = {};
+__export(jevMicroReferences_exports, {
+  microReferenceFeatures: () => microReferenceFeatures
+});
+module.exports = __toCommonJS(jevMicroReferences_exports);
+var microReferenceFeatures = (input) => {
+  const number = (...keys) => {
+    for (const key of keys) {
+      const value = input.features[key];
+      if (typeof value === "number" && Number.isFinite(value)) return value;
+    }
+    return null;
+  };
+  const bands = (value, cuts) => {
+    if (value == null || value < 0) return null;
+    const level = cuts.filter((cut) => value >= cut).length;
+    return level / 4;
+  };
+  const ratio = number("setup.retracementRatio");
+  const contraction = number(
+    "setup.consolidationToImpulseVolumeRatio",
+    "setup.flagToPoleVolumeRatio"
+  );
+  const extension = number("setup.breakoutDistanceAtr");
+  const efficiency = number(
+    "setup.impulseEfficiencyRatio",
+    "setup.poleEfficiencyRatio"
+  );
+  const body = number("entry.directionalBodyAtr");
+  const close = number("entry.directionalCloseLocation");
+  const upper = number("geometry.upperR2"), lower = number("geometry.lowerR2"), divergence = number("geometry.slopeDivergenceRatio");
+  const fit = upper != null && lower != null ? Math.min(upper, lower) : null;
+  const bias = (key) => {
+    const value = input.features[key];
+    if (!["bull", "bear"].includes(String(value))) return 0;
+    return value === (input.direction === "LONG" ? "bull" : "bear") ? 1 : -1;
+  };
+  const trend = bias("market.trendBias"), swing = bias("market.swingBias");
+  return {
+    directionalAgreement: input.features["market.trendBias"] == null && input.features["market.swingBias"] == null ? null : (trend + swing + 2) / 4,
+    correctionContainment: ratio == null || ratio < 0 ? null : (ratio <= 0.2 ? 4 : ratio <= 0.4 ? 3 : ratio <= 0.65 ? 2 : ratio <= 1 ? 1 : 0) / 4,
+    volumeExpansion: bands(number("market.volumeRel20"), [0.5, 0.8, 1.2, 2]),
+    volumeContraction: contraction == null || contraction < 0 ? null : (contraction <= 0.4 ? 4 : contraction <= 0.7 ? 3 : contraction <= 0.9 ? 2 : contraction <= 1.2 ? 1 : 0) / 4,
+    entryProximity: extension == null || extension < 0 ? null : (extension <= 0.2 ? 4 : extension <= 0.5 ? 3 : extension <= 1 ? 2 : extension <= 2 ? 1 : 0) / 4,
+    entryConviction: body == null || close == null || close < 0 || close > 1 ? null : (body < 0 && close < 0.25 ? 0 : body < 0 || close < 0.5 ? 1 : body < 0.2 ? 2 : body >= 0.5 && close >= 0.75 ? 4 : 3) / 4,
+    impulsePersistence: efficiency == null || efficiency > 1 ? null : bands(efficiency, [0.2, 0.4, 0.6, 0.8]),
+    boundaryRegularity: fit == null || divergence == null || fit < 0 || fit > 1 || divergence < 0 ? null : (fit < 0.5 || divergence > 0.5 ? 0 : fit < 0.7 || divergence > 0.3 ? 1 : fit < 0.85 || divergence > 0.15 ? 2 : fit >= 0.95 && divergence <= 0.05 ? 4 : 3) / 4
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  microReferenceFeatures
+});

package/dist/lib/jevResearch.js

@@ -170,6 +170,17 @@ var runJevResearch = async (options) => {
         throw new Error(
           "Export exceeds 20000 samples; select a bounded recording directory"
         );
+      await (0, import_jev2.evaluateJevInput)({
+        input: record.input,
+        config: {
+          source: "recorded",
+          mode: "observe",
+          provider: record.provider,
+          recordsDir: options.recordsDir
+        },
+        userName: options.userName,
+        projectRoot: options.projectRoot
+      });
       const outcome = byRecord.get(record.id);
       rows2.push({
         schema: "tradejs-jev-study/v4",

package/dist/scripts/aiPocketSearch.js

@@ -74,7 +74,7 @@ var resolveAiPocketCadenceProfile = ({
   validationRows = [],
   testRows = [],
   mode = "auto",
-  validationSplit = 0.25,
+  validationSplit = 0,
   minSupport,
   minEvents,
   minValidationSupport,
@@ -124,8 +124,8 @@ var AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS = {
   minProfitFactor: "1.2",
   minWinRate: "0",
   minTotalProfit: "0",
-  validationSplit: "0.25",
-  testSplit: "0"
+  validationSplit: "0",
+  testSplit: "0.4"
 };
 var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0) => {
   const timestamps = [
@@ -166,11 +166,6 @@ var splitAiPocketResearchRowsByTimestamp = (rows, validationSplit, testSplit = 0
     testRows: rows.filter((row) => isIn(testTimestamps, row.timestamp))
   };
 };
-var splitAiPocketCoverageRowsByTimestamp = (rows, family, validationSplit, testSplit = 0) => splitAiPocketResearchRowsByTimestamp(
-  rows.filter((row) => row.featureCoverage?.[family] === true),
-  validationSplit,
-  testSplit
-);
 var sealAiPocketTestPartition = (split, sealed) => {
   const finiteTimestamps = split.testRows.map((row) => row.timestamp).filter((timestamp) => Number.isFinite(timestamp));
   return {
@@ -436,17 +431,17 @@ var resolveAiPocketSearchCommandOptions = ({
       longName: "validationSplit",
       shortName: "V"
     }) ?? flags2.validationSplit,
-    0.25
-  ) : 0.25;
+    0
+  ) : 0;
   const testSplit = hasCliOption2(argv, "testSplit", "T") ? normalizeRatio(
     readAiPocketSearchCliOption({
       argv,
       longName: "testSplit",
       shortName: "T"
     }) ?? flags2.testSplit,
-    0
-  ) : 0;
-  const sealTest = Boolean(flags2.sealTest);
+    0.4
+  ) : 0.4;
+  const sealTest = flags2.sealTest == null ? true : Boolean(flags2.sealTest);
   if (sealTest && testSplit <= 0) {
     throw new Error("--sealTest requires a positive --testSplit");
   }
@@ -2649,6 +2644,22 @@ var buildAiPocketMarkdownReport = ({
     "",
     markdownTable(pocketTableHeaders, pocketRows(pocketSearch.positivePockets)),
     "",
+    "## Development Stability (inside discovery, not independent validation)",
+    "",
+    markdownTable(
+      ["Condition", "Status", "Block", "Events", "PnL", "PF"],
+      pocketSearch.positivePockets.flatMap(
+        (pocket) => (pocket.stability?.folds ?? []).map((fold, index) => [
+          pocket.condition,
+          pocket.stability?.status,
+          index + 1,
+          fold.summary.events,
+          formatMdNumber(fold.summary.totalProfit),
+          formatMdNumber(fold.summary.profitFactor)
+        ])
+      )
+    ),
+    "",
     "## Top Loss Pockets",
     "",
     markdownTable(pocketTableHeaders, pocketRows(pocketSearch.negativePockets)),
@@ -4099,6 +4110,62 @@ var summarizeAiTrainEvaluationsByQualityThreshold = (evaluations, thresholds = [
   )
 }));
 
+// src/lib/aiPocketSearch/stability.ts
+var assessDevelopmentStability = (result, options) => {
+  const minEvents = options.minEventsPerFold ?? 5;
+  const timestamps = [...new Set(options.timestamps)].sort((a, b) => a - b);
+  const boundaries = [0, 1, 2, 3].map(
+    (index) => index === 3 ? timestamps.at(-1) == null ? Number.POSITIVE_INFINITY : timestamps.at(-1) + 1 : timestamps[Math.floor(timestamps.length * index / 3)] ?? Number.POSITIVE_INFINITY
+  );
+  const blocks = [0, 1, 2].map((index) => ({
+    start: boundaries[index],
+    end: boundaries[index + 1],
+    rows: options.developmentRows.filter(
+      (row) => row.timestamp != null && row.timestamp >= boundaries[index] && row.timestamp < boundaries[index + 1]
+    ),
+    baseline: options.baselineRows.filter(
+      (row) => row.timestamp != null && row.timestamp >= boundaries[index] && row.timestamp < boundaries[index + 1]
+    )
+  }));
+  for (const pocket of result.positivePockets) {
+    const folds = blocks.map((block) => {
+      const mask = buildPredicateListMask(block.rows, pocket.predicates).mask;
+      const selected = block.rows.filter((_, index) => mask[index] === 1);
+      const summary = summarizeAiPocketRows(selected);
+      const baseline = summarizeAiPocketRows(block.baseline);
+      const objectiveSummary = result.objective === "add-to-gate" ? summarizeAiPocketRows([
+        .../* @__PURE__ */ new Set([...block.baseline, ...selected])
+      ]) : summary;
+      return {
+        startTimestamp: Number.isFinite(block.start) ? block.start : null,
+        endTimestamp: Number.isFinite(block.end) ? block.end : null,
+        summary,
+        objectiveSummary,
+        baseline
+      };
+    });
+    const supported = folds.filter((fold) => fold.summary.events >= minEvents);
+    const unstable = supported.some(
+      (fold) => fold.objectiveSummary.totalProfit < (result.objective === "add-to-gate" ? fold.baseline.totalProfit : 0) || (fold.objectiveSummary.profitFactor ?? (fold.objectiveSummary.grossLoss === 0 ? Infinity : 0)) < 1
+    );
+    const status = unstable ? "unstable" : supported.length < 3 ? "insufficient-support" : "stable";
+    pocket.stability = {
+      status,
+      role: "development-only diagnostic",
+      minEventsPerFold: minEvents,
+      folds
+    };
+    if (status !== "stable") {
+      pocket.readiness = "research-only";
+      pocket.readinessReasons.push(`development stability: ${status}`);
+    }
+  }
+  const rank = { stable: 0, "insufficient-support": 1, unstable: 2 };
+  result.positivePockets.sort(
+    (a, b) => rank[a.stability.status] - rank[b.stability.status]
+  );
+};
+
 // src/lib/aiPocketSearch/research.ts
 var resolveScopeRows = (rows, scope) => {
   if (scope === "approved") {
@@ -4194,7 +4261,7 @@ var runAiPocketSearchResearch = ({
       maxEventCountShare,
       explicitMaxEventCountShare
     });
-    return searchAiPockets(train, {
+    const result = searchAiPockets(train, {
       minSupport: cadenceProfile.minSupport,
       minProfitFactor,
       minTotalProfit,
@@ -4224,6 +4291,17 @@ var runAiPocketSearchResearch = ({
       progressInterval: 250,
       onProgress: (progress) => onProgress?.({ label, progress })
     });
+    assessDevelopmentStability(result, {
+      developmentRows: [...train, ...validation],
+      baselineRows: [...trainBaseline, ...validationBaseline],
+      // Every provider/scope uses the same outer development timestamps.
+      timestamps: [
+        ...new Set(
+          fullSplit.trainRows.concat(fullSplit.validationRows).map((row) => row.timestamp)
+        )
+      ].sort((a, b) => a - b)
+    });
+    return result;
   };
   const search = runSearch({
     label: "full",
@@ -4243,12 +4321,12 @@ var runAiPocketSearchResearch = ({
   const coverageSearches = [];
   if (coverageMode === "auto") {
     for (const family of ["cmc", "coinalyze"]) {
-      const cohortSplit = splitAiPocketCoverageRowsByTimestamp(
-        directionRows,
-        family,
-        validationSplit,
-        testSplit
-      );
+      const covered = (row) => row.featureCoverage?.[family] === true;
+      const cohortSplit = {
+        trainRows: fullSplit.trainRows.filter(covered),
+        validationRows: fullSplit.validationRows.filter(covered),
+        testRows: fullSplit.testRows.filter(covered)
+      };
       const sealedCohortSplit = sealAiPocketTestPartition(
         cohortSplit,
         sealTest
@@ -4581,18 +4659,18 @@ import_args.default.option(
 );
 import_args.default.option(
   ["V", "validationSplit"],
-  "Trailing time-ordered scope share reserved for validation (0 disables)",
+  "Optional legacy tuning share; default 0, stability is checked inside development",
   AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.validationSplit
 );
 import_args.default.option(
   ["T", "testSplit"],
-  "Trailing timestamp-grouped scope share withheld as untouched test",
+  "Trailing timestamp-grouped test share; default 0.4 (outer 60/40)",
   AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS.testSplit
 );
 import_args.default.option(
   ["w", "sealTest"],
   "Reserve test bounds without exposing its rows or economics to discovery",
-  false
+  true
 );
 import_args.default.option(
   ["N", "minValidationSupport"],

package/dist/scripts/backtest.js

@@ -74,6 +74,10 @@ var import_userSettings = require("@tradejs/infra/userSettings");
 var import_jev3 = require("@tradejs/node/jev");
 var resolveBacktestAiExportEnabled = (flags2) => Boolean(flags2.ai);
 var resolveBacktestJev = async (flags2, userName2, projectRoot2) => {
+  if (flags2.jevQuestionSet != null)
+    throw new Error(
+      "--jevQuestionSet was removed; --jev always uses the current nine-question set"
+    );
   if (!flags2.jev) {
     if (flags2.jevRecorded || flags2.jevModelFile)
       throw new Error("Jev options require --jev");

package/dist/scripts/jev.js

@@ -172,6 +172,17 @@ var runJevResearch = async (options) => {
         throw new Error(
           "Export exceeds 20000 samples; select a bounded recording directory"
         );
+      await (0, import_jev2.evaluateJevInput)({
+        input: record.input,
+        config: {
+          source: "recorded",
+          mode: "observe",
+          provider: record.provider,
+          recordsDir: options.recordsDir
+        },
+        userName: options.userName,
+        projectRoot: options.projectRoot
+      });
       const outcome = byRecord.get(record.id);
       rows2.push({
         schema: "tradejs-jev-study/v4",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/cli",
-  "version": "3.1.29-beta.261",
+  "version": "3.1.29-beta.262",
   "description": "Official CLI for the TradeJS TypeScript framework: infra setup, backtests, signals, bots, and ML workflows.",
   "keywords": [
     "tradejs",
@@ -16,7 +16,8 @@
     "coinbase",
     "ai",
     "claude",
-    "codex"
+    "codex",
+    "jev"
   ],
   "homepage": "https://tradejs.dev",
   "repository": {
@@ -36,13 +37,13 @@
     "tradejs": "dist/cli.js"
   },
   "dependencies": {
-    "@tradejs/connectors": "^3.1.29-beta.261",
-    "@tradejs/core": "^3.1.29-beta.261",
-    "@tradejs/indicators": "^3.1.29-beta.261",
-    "@tradejs/infra": "^3.1.29-beta.261",
-    "@tradejs/node": "^3.1.29-beta.261",
+    "@tradejs/connectors": "^3.1.29-beta.262",
+    "@tradejs/core": "^3.1.29-beta.262",
+    "@tradejs/indicators": "^3.1.29-beta.262",
+    "@tradejs/infra": "^3.1.29-beta.262",
+    "@tradejs/node": "^3.1.29-beta.262",
     "@tradejs/strategy-kit": "3.0.6",
-    "@tradejs/types": "^3.1.29-beta.261",
+    "@tradejs/types": "^3.1.29-beta.262",
     "args": "^5.0.3",
     "bcryptjs": "^2.4.3",
     "chalk": "4.1.2",