@tradejs/cli 2.0.19 → 2.0.20

package/dist/scripts/aiPocketSearch.js

@@ -414,6 +414,7 @@ var resolveAiTrainRecentLimit = ({
 var DAY_MS2 = 24 * 60 * 60 * 1e3;
 var DAYS_PER_WEEK2 = 7;
 var DAYS_PER_MONTH2 = 30.4375;
+var PRODUCTION_CANDIDATE_MIN_EVENTS = 25;
 var OUTCOME_SEGMENTS = /* @__PURE__ */ new Set([
   "actual",
   "aiapproved",
@@ -499,6 +500,146 @@ var METADATA_LEAVES = /* @__PURE__ */ new Set([
   "targetsymbol",
   "universe"
 ]);
+var normalizeFeaturePath = (path2) => (Array.isArray(path2) ? path2 : path2.split(".")).filter(Boolean).map((segment) => segment.toLowerCase());
+var classifyAiPocketCoverageFeaturePath = (path2) => {
+  const segments = normalizeFeaturePath(path2);
+  const normalizedPath = segments.join(".");
+  if (segments.some(
+    (segment) => segment.includes("cmc") || segment.includes("coinmarketcap")
+  )) {
+    return "cmc";
+  }
+  if (segments.some(
+    (segment) => segment.includes("derivative") || segment.includes("coinalyze")
+  ) || /(?:^|\.)(?:funding|openinterest|oi(?:change|acceleration|divergence)|priceoi|liq(?:long|short|total|imbalance|spike)|liquidation)/.test(
+    normalizedPath
+  )) {
+    return "coinalyze";
+  }
+  return null;
+};
+var hasUsableContextPrimitive = (value) => {
+  if (Array.isArray(value) || value == null) {
+    return false;
+  }
+  if (isFeaturePrimitive(value)) {
+    return typeof value !== "string" || value.toLowerCase() !== "unknown";
+  }
+  if (!isPlainRecord(value)) {
+    return false;
+  }
+  return Object.entries(value).some(([key, child]) => {
+    const normalizedKey = key.toLowerCase();
+    if (DATA_QUALITY_LEAVES.has(normalizedKey) || METADATA_LEAVES.has(normalizedKey) || normalizedKey === "riskflags" || normalizedKey.endsWith("timestamp") || normalizedKey.endsWith("agems")) {
+      return false;
+    }
+    return hasUsableContextPrimitive(child);
+  });
+};
+var isUsableCmcContext = (value) => isPlainRecord(value) && value.available !== false && value.stale !== true && hasUsableContextPrimitive(value);
+var hasUsableCmcContext = (baseContext) => {
+  const relative = isPlainRecord(baseContext?.relative) ? baseContext.relative : null;
+  return Boolean(
+    relative && Object.entries(relative).some(
+      ([key, value]) => key.toLowerCase().startsWith("cmc") && isUsableCmcContext(value)
+    )
+  );
+};
+var isUsableDerivativesContext = (context) => {
+  if (!context) {
+    return false;
+  }
+  const summary = isPlainRecord(context.summary) ? context.summary : null;
+  const riskFlags = Array.isArray(summary?.riskFlags) ? summary.riskFlags.filter(
+    (flag) => typeof flag === "string"
+  ) : [];
+  if (riskFlags.includes("missing_derivatives") || riskFlags.includes("stale_derivatives")) {
+    return false;
+  }
+  const intervals = isPlainRecord(context.intervals) ? context.intervals : null;
+  return Boolean(
+    intervals && Object.values(intervals).some(
+      (interval) => isPlainRecord(interval) && interval.stale !== true && hasUsableContextPrimitive(interval)
+    )
+  );
+};
+var hasUsableCoinalyzeContext = (baseContext) => {
+  const derivatives = isPlainRecord(baseContext?.derivatives) ? baseContext.derivatives : null;
+  if (!derivatives) {
+    return false;
+  }
+  if (isUsableDerivativesContext(derivatives)) {
+    return true;
+  }
+  const targetContext = isPlainRecord(derivatives.targetContext) ? derivatives.targetContext : null;
+  if (isUsableDerivativesContext(targetContext)) {
+    return true;
+  }
+  const referenceContexts = isPlainRecord(derivatives.referenceContexts) ? derivatives.referenceContexts : null;
+  return Boolean(
+    referenceContexts && Object.values(referenceContexts).some(
+      (context) => isUsableDerivativesContext(isPlainRecord(context) ? context : null)
+    )
+  );
+};
+var resolveAiPocketFeatureCoverage = (payload) => {
+  const additionalIndicators = isPlainRecord(payload.additionalIndicators) ? payload.additionalIndicators : null;
+  const baseContext = isPlainRecord(additionalIndicators?.baseContext) ? additionalIndicators.baseContext : null;
+  return {
+    cmc: hasUsableCmcContext(baseContext),
+    coinalyze: hasUsableCoinalyzeContext(baseContext)
+  };
+};
+var isAiPocketCoverageFeatureUsable = ({
+  payload,
+  segments,
+  family,
+  familyCoverage
+}) => {
+  const additionalIndicators = isPlainRecord(payload.additionalIndicators) ? payload.additionalIndicators : null;
+  const baseContext = isPlainRecord(additionalIndicators?.baseContext) ? additionalIndicators.baseContext : null;
+  const baseContextIndex = segments.findIndex(
+    (segment) => segment.toLowerCase() === "basecontext"
+  );
+  if (family === "cmc") {
+    const relative = isPlainRecord(baseContext?.relative) ? baseContext.relative : null;
+    if (relative && baseContextIndex >= 0 && segments[baseContextIndex + 1]?.toLowerCase() === "relative") {
+      const contextKey = segments[baseContextIndex + 2];
+      if (contextKey?.toLowerCase().startsWith("cmc")) {
+        return isUsableCmcContext(relative[contextKey]);
+      }
+    }
+    return familyCoverage.cmc;
+  }
+  const derivatives = isPlainRecord(baseContext?.derivatives) ? baseContext.derivatives : null;
+  if (!derivatives || baseContextIndex < 0 || segments[baseContextIndex + 1]?.toLowerCase() !== "derivatives") {
+    return isUsableDerivativesContext(derivatives);
+  }
+  const branch = segments[baseContextIndex + 2]?.toLowerCase();
+  if (branch == null) {
+    return familyCoverage.coinalyze;
+  }
+  if (branch === "referencecontexts") {
+    const referenceContexts = isPlainRecord(derivatives.referenceContexts) ? derivatives.referenceContexts : null;
+    const symbol = segments[baseContextIndex + 3];
+    if (!symbol) {
+      return Boolean(
+        referenceContexts && Object.values(referenceContexts).some(
+          (context) => isUsableDerivativesContext(isPlainRecord(context) ? context : null)
+        )
+      );
+    }
+    return isUsableDerivativesContext(
+      symbol && referenceContexts && isPlainRecord(referenceContexts[symbol]) ? referenceContexts[symbol] : null
+    );
+  }
+  if (branch === "targetcontext" || branch === "targetderived") {
+    return isUsableDerivativesContext(
+      isPlainRecord(derivatives.targetContext) ? derivatives.targetContext : null
+    );
+  }
+  return isUsableDerivativesContext(derivatives);
+};
 var DERIVED_POLICY_FRAGMENTS = [
   "approval",
   "decisionhint",
@@ -837,7 +978,7 @@ var addSignalRiskDistanceFeatures = ({
     features["derived.takeProfitDistanceBps"] = Math.abs(takeProfitPrice - currentPrice) / Math.abs(currentPrice) * 1e4;
   }
 };
-var collectAiPocketFeatures = ({
+var collectAiPocketFeatureSnapshot = ({
   payload,
   gateContext,
   includeSymbol = false,
@@ -847,6 +988,7 @@ var collectAiPocketFeatures = ({
   onFeatureExcluded
 }) => {
   const features = {};
+  const featureCoverage = resolveAiPocketFeatureCoverage(payload);
   const signal = payload.signal ?? {};
   const source = {
     signal: {
@@ -865,6 +1007,19 @@ var collectAiPocketFeatures = ({
     segments: [],
     maxDepth: 8,
     shouldSkipPath: (segments) => {
+      const coverageFamily = classifyAiPocketCoverageFeaturePath(segments);
+      if (featurePolicy === "causal-stationary" && coverageFamily != null && !isAiPocketCoverageFeatureUsable({
+        payload,
+        segments,
+        family: coverageFamily,
+        familyCoverage: featureCoverage
+      })) {
+        onFeatureExcluded?.({
+          path: segments.join("."),
+          classification: "data-quality"
+        });
+        return true;
+      }
       if (featureProfile === "compact" && isCompactFeaturePathSkipped(segments)) {
         return true;
       }
@@ -895,7 +1050,7 @@ var collectAiPocketFeatures = ({
   }
   addSignalRiskDistanceFeatures({ features, signal });
   addDirectionalDerivedFeatures(features);
-  return features;
+  return { features, featureCoverage };
 };
 var formatNumber = (value) => {
   if (Number.isInteger(value)) {
@@ -1162,6 +1317,37 @@ var summarizeRowIndexes = (rows, rowIndexes) => {
   return finalizeAiPocketSummary({ rows, accumulator });
 };
 var summarizeAiPocketRows = (rows) => summarizeSelectedRows(rows, rows);
+var summarizeAiPocketFeatureCoverage = (rows, family) => {
+  const coveredRows = rows.filter(
+    (row) => row.featureCoverage?.[family] === true
+  );
+  const allEvents = /* @__PURE__ */ new Set();
+  const coveredEvents = /* @__PURE__ */ new Set();
+  let minTimestamp = null;
+  let maxTimestamp = null;
+  for (const row of rows) {
+    if (isFiniteNumber(row.timestamp)) {
+      allEvents.add(row.timestamp);
+    }
+  }
+  for (const row of coveredRows) {
+    if (!isFiniteNumber(row.timestamp)) {
+      continue;
+    }
+    coveredEvents.add(row.timestamp);
+    minTimestamp = minTimestamp == null ? row.timestamp : Math.min(minTimestamp, row.timestamp);
+    maxTimestamp = maxTimestamp == null ? row.timestamp : Math.max(maxTimestamp, row.timestamp);
+  }
+  return {
+    family,
+    rows: coveredRows.length,
+    rowRatio: rows.length > 0 ? coveredRows.length / rows.length : 0,
+    events: coveredEvents.size,
+    eventRatio: allEvents.size > 0 ? coveredEvents.size / allEvents.size : 0,
+    minTimestamp,
+    maxTimestamp
+  };
+};
 var matchesPredicate = (value, predicate) => {
   if (predicate.kind === "numeric") {
     if (!isFiniteNumber(value)) {
@@ -1474,6 +1660,19 @@ var createPocketResult = (rows, predicates, mask, validationRows, testRows, obje
   const condition = publicPredicates.map((predicate) => predicate.label).join(" AND ");
   const validationScore = validationSummary == null || validationObjectiveSummary == null ? void 0 : validationSummary.support > 0 ? scorePositivePocket(validationObjectiveSummary) - (objective === "standalone" ? 0 : scorePositivePocket(validationObjectiveBaseline)) : Number.NEGATIVE_INFINITY;
   const testScore = testSummary == null || testObjectiveSummary == null ? void 0 : testSummary.support > 0 ? scorePositivePocket(testObjectiveSummary) - (objective === "standalone" ? 0 : scorePositivePocket(testObjectiveBaseline)) : Number.NEGATIVE_INFINITY;
+  const readinessReasons = [];
+  if (summary.events < PRODUCTION_CANDIDATE_MIN_EVENTS) {
+    readinessReasons.push(
+      `train events ${summary.events} < ${PRODUCTION_CANDIDATE_MIN_EVENTS}`
+    );
+  }
+  if (testSummary == null) {
+    readinessReasons.push("untouched test missing");
+  } else if (testSummary.events < PRODUCTION_CANDIDATE_MIN_EVENTS) {
+    readinessReasons.push(
+      `test events ${testSummary.events} < ${PRODUCTION_CANDIDATE_MIN_EVENTS}`
+    );
+  }
   return {
     id: publicPredicates.map((predicate) => predicate.id).join("&&"),
     depth: publicPredicates.length,
@@ -1487,6 +1686,8 @@ var createPocketResult = (rows, predicates, mask, validationRows, testRows, obje
     ...objective !== "standalone" && testObjectiveSummary ? { testObjectiveSummary } : {},
     ...validationScore != null ? { validationScore } : {},
     ...testScore != null ? { testScore } : {},
+    readiness: readinessReasons.length === 0 ? "production-candidate" : "research-only",
+    readinessReasons,
     score: scorePositivePocket(objectiveSummary) - (objective === "standalone" ? 0 : scorePositivePocket(objectiveBaseline))
   };
 };
@@ -1581,6 +1782,43 @@ var diversifyPredicatePool = (predicates, maximum) => {
   }
   return selected;
 };
+var prioritizeRequiredFeatureFamilyPredicates = ({
+  selected,
+  predicates,
+  requiredFeatureFamilies,
+  maximum
+}) => {
+  if (!requiredFeatureFamilies.length) {
+    return selected;
+  }
+  const perFamilyLimit = Math.max(
+    6,
+    Math.floor(maximum * 0.2 / requiredFeatureFamilies.length)
+  );
+  const prioritized = /* @__PURE__ */ new Map();
+  for (const family of requiredFeatureFamilies) {
+    const familyPredicates = predicates.filter(
+      (predicate) => classifyAiPocketCoverageFeaturePath(predicate.featureKey) === family
+    );
+    const positive = [...familyPredicates].sort(
+      (left, right) => scorePositivePocket(right.atomSummary) - scorePositivePocket(left.atomSummary)
+    ).slice(0, Math.ceil(perFamilyLimit * 0.5));
+    const negative = [...familyPredicates].sort(
+      (left, right) => scoreNegativePocket(right.atomSummary) - scoreNegativePocket(left.atomSummary)
+    ).slice(0, Math.ceil(perFamilyLimit * 0.3));
+    const broad = [...familyPredicates].sort((left, right) => right.support - left.support).slice(0, Math.ceil(perFamilyLimit * 0.2));
+    for (const predicate of [...positive, ...negative, ...broad]) {
+      if (prioritized.size >= perFamilyLimit * requiredFeatureFamilies.length) {
+        break;
+      }
+      prioritized.set(predicate.id, predicate);
+    }
+  }
+  for (const predicate of selected) {
+    prioritized.set(predicate.id, predicate);
+  }
+  return [...prioritized.values()].slice(0, maximum);
+};
 var canCombinePredicate = (chosen, candidate) => {
   const sameFeature = chosen.filter(
     (predicate) => predicate.featureKey === candidate.featureKey
@@ -1596,7 +1834,11 @@ var canCombinePredicate = (chosen, candidate) => {
   return lower <= upper;
 };
 var searchAiPockets = (rows, options = {}) => {
-  const minSupport = Math.max(1, Math.trunc(options.minSupport ?? 20));
+  const cadenceProfileOption = options.cadenceProfile;
+  const minSupport = Math.max(
+    1,
+    Math.trunc(cadenceProfileOption?.minSupport ?? options.minSupport ?? 20)
+  );
   const minProfitFactor = Math.max(0, options.minProfitFactor ?? 1.2);
   const minTotalProfit = options.minTotalProfit ?? 0;
   const minWinRate = Math.max(0, options.minWinRate ?? 0);
@@ -1614,17 +1856,27 @@ var searchAiPockets = (rows, options = {}) => {
   const testRows = options.testRows ?? [];
   const minValidationSupport = Math.max(
     0,
-    Math.trunc(options.minValidationSupport ?? 0)
+    Math.trunc(
+      cadenceProfileOption?.minValidationSupport ?? options.minValidationSupport ?? 0
+    )
+  );
+  const minEvents = Math.max(
+    1,
+    Math.trunc(cadenceProfileOption?.minEvents ?? options.minEvents ?? 1)
   );
-  const minEvents = Math.max(1, Math.trunc(options.minEvents ?? 1));
   const minValidationEvents = Math.max(
     0,
-    Math.trunc(options.minValidationEvents ?? 0)
+    Math.trunc(
+      cadenceProfileOption?.minValidationEvents ?? options.minValidationEvents ?? 0
+    )
   );
   const maxBatch = Math.max(1, options.maxBatch ?? Number.POSITIVE_INFINITY);
   const maxEventCountShare = Math.max(
     0,
-    Math.min(1, options.maxEventCountShare ?? 1)
+    Math.min(
+      1,
+      cadenceProfileOption?.maxEventCountShare ?? options.maxEventCountShare ?? 1
+    )
   );
   const maxSymbolCountShare = Math.max(
     0,
@@ -1642,18 +1894,59 @@ var searchAiPockets = (rows, options = {}) => {
   const allowRiskRegression = options.allowRiskRegression === true;
   const requireValidationEligibility = options.requireValidationEligibility === true;
   const dedupeEquivalentSelections = options.dedupeEquivalentSelections !== false;
+  const requiredFeatureFamilies = [
+    ...new Set(options.requiredFeatureFamilies ?? [])
+  ];
+  const excludedFeatureFamilies = [
+    ...new Set(options.excludedFeatureFamilies ?? [])
+  ];
   const progressInterval = Math.max(
     1,
     Math.trunc(options.progressInterval ?? 500)
   );
   const onProgress = options.onProgress;
+  const summarizePartition = (partitionRows) => {
+    const summary = summarizeAiPocketRows(partitionRows);
+    const periodDays = getPeriodDays(partitionRows);
+    return {
+      rows: partitionRows.length,
+      events: summary.events,
+      periodDays,
+      eventsPerDay: periodDays == null ? null : summary.events / periodDays
+    };
+  };
+  const trainPartition = summarizePartition(rows);
+  const validationPartition = summarizePartition(validationRows);
+  const testPartition = summarizePartition(testRows);
+  const cadenceProfile = cadenceProfileOption ?? {
+    mode: "fixed",
+    lowCadence: false,
+    sparseSample: false,
+    adaptiveThresholds: false,
+    trainRows: trainPartition.rows,
+    trainEvents: trainPartition.events,
+    trainPeriodDays: trainPartition.periodDays,
+    trainEventsPerDay: trainPartition.eventsPerDay,
+    validationRows: validationPartition.rows,
+    validationEvents: validationPartition.events,
+    testRows: testPartition.rows,
+    testEvents: testPartition.events,
+    minSupport,
+    minEvents,
+    minValidationSupport,
+    minValidationEvents,
+    maxEventCountShare
+  };
   const predicateResult = buildAiPocketPredicateResult(rows, {
     minSupport,
     maxCategories: options.maxCategories,
     progressInterval,
     onProgress
   });
-  const { predicates } = predicateResult;
+  const predicates = predicateResult.predicates.filter((predicate) => {
+    const family = classifyAiPocketCoverageFeaturePath(predicate.featureKey);
+    return family == null || !excludedFeatureFamilies.includes(family);
+  });
   let lastMaskProgress = 0;
   const emitMaskProgress = (current, done = false) => {
     if (!onProgress) {
@@ -1685,10 +1978,15 @@ var searchAiPockets = (rows, options = {}) => {
   [...predicatePool, ...negativePool, ...supportPool].forEach((predicate) => {
     predicatePoolById.set(predicate.id, predicate);
   });
-  const diversifiedPredicates = diversifyPredicatePool(
-    [...predicatePoolById.values()],
-    maxAtomicPredicates
-  );
+  const diversifiedPredicates = prioritizeRequiredFeatureFamilyPredicates({
+    selected: diversifyPredicatePool(
+      [...predicatePoolById.values()],
+      maxAtomicPredicates
+    ),
+    predicates: scoredPredicates,
+    requiredFeatureFamilies,
+    maximum: maxAtomicPredicates
+  });
   const selectedPredicatePool = diversifiedPredicates.map(
     (predicate) => {
       const { mask, support } = buildMask(rows, predicate);
@@ -1729,6 +2027,13 @@ var searchAiPockets = (rows, options = {}) => {
     });
   };
   const addPocket = (pocketPredicates, mask) => {
+    if (requiredFeatureFamilies.some(
+      (family) => !pocketPredicates.some(
+        (predicate) => classifyAiPocketCoverageFeaturePath(predicate.featureKey) === family
+      )
+    )) {
+      return;
+    }
     const pocket = createPocketResult(
       rows,
       pocketPredicates,
@@ -1846,7 +2151,7 @@ var searchAiPockets = (rows, options = {}) => {
     negativePockets: [...negativePockets.values()].sort(compareNegativePockets).slice(0, top),
     stats: {
       rows: rows.length,
-      featureKeys: predicateResult.featureKeys,
+      featureKeys: new Set(predicates.map((predicate) => predicate.featureKey)).size,
       predicates: predicates.length,
       atomicPredicatesUsed: selectedPredicatePool.length,
       estimatedCombinations,
@@ -1861,6 +2166,9 @@ var searchAiPockets = (rows, options = {}) => {
           )
         )
       ],
+      requiredFeatureFamilies,
+      excludedFeatureFamilies,
+      cadence: cadenceProfile,
       truncated
     }
   };
@@ -1922,16 +2230,20 @@ var pocketRows = (pockets) => pockets.map((pocket, index) => [
   pocket.objectiveSummary ? formatMdNumber(pocket.objectiveSummary.totalProfit) : "n/a",
   formatMdNumber(pocket.summary.maxDrawdown),
   pocket.validationSummary?.support ?? "n/a",
+  pocket.validationSummary?.events ?? "n/a",
   pocket.validationSummary ? formatMdPercent(pocket.validationSummary.winRate) : "n/a",
   pocket.validationSummary ? formatMdNumber(pocket.validationSummary.profitFactor) : "n/a",
   pocket.validationSummary ? formatMdNumber(pocket.validationSummary.totalProfit) : "n/a",
   pocket.testSummary?.support ?? "n/a",
+  pocket.testSummary?.events ?? "n/a",
   pocket.testSummary ? formatMdNumber(pocket.testSummary.profitFactor) : "n/a",
   pocket.testSummary ? formatMdNumber(pocket.testSummary.totalProfit) : "n/a",
   pocket.testObjectiveSummary ? formatMdNumber(pocket.testObjectiveSummary.totalProfit) : "n/a",
   formatMdNumber(pocket.summary.avgTradesPerDay),
   pocket.summary.losingMonths,
   formatMdNumber(pocket.score),
+  pocket.readiness,
+  pocket.readinessReasons.join("; ") || "none",
   pocket.condition
 ]);
 var buildAiPocketMarkdownReport = ({
@@ -1939,6 +2251,7 @@ var buildAiPocketMarkdownReport = ({
   run,
   currentGate,
   pocketSearch,
+  coverageSearches = [],
   errors
 }) => {
   const generatedIso = new Date(generatedAt).toISOString();
@@ -1949,6 +2262,34 @@ var buildAiPocketMarkdownReport = ({
     audit?.paths ?? 0,
     audit?.samples.join(", ") ?? ""
   ]);
+  const pocketTableHeaders = [
+    "#",
+    "N",
+    "Events",
+    "Max batch",
+    "Support",
+    "WR",
+    "PF",
+    "PNL",
+    "Objective PNL",
+    "Max DD",
+    "Val N",
+    "Val Events",
+    "Val WR",
+    "Val PF",
+    "Val PNL",
+    "Test N",
+    "Test Events",
+    "Test PF",
+    "Test PNL",
+    "Test objective PNL",
+    "Trades/Day",
+    "Losing Months",
+    "Score",
+    "Readiness",
+    "Readiness reasons",
+    "Pocket"
+  ];
   const lines = [
     "# AI Pocket Search Report",
     "",
@@ -1972,6 +2313,17 @@ var buildAiPocketMarkdownReport = ({
         ["test_rows", run.testRows],
         ["validation_split", formatMdPercent(run.validationSplit)],
         ["test_split", formatMdPercent(run.testSplit)],
+        ["test_sealed", run.sealedTest?.sealed ? "yes" : "no"],
+        ["sealed_test_rows", run.sealedTest?.rows ?? run.testRows],
+        ["sealed_test_events", run.sealedTest?.events ?? "n/a"],
+        [
+          "sealed_test_start",
+          run.sealedTest?.startTimestamp == null ? "n/a" : new Date(run.sealedTest.startTimestamp).toISOString()
+        ],
+        [
+          "sealed_test_end",
+          run.sealedTest?.endTimestamp == null ? "n/a" : new Date(run.sealedTest.endTimestamp).toISOString()
+        ],
         ["min_validation_support", run.minValidationSupport],
         ["failed", run.failed],
         ["recent", run.recent === 0 ? "all" : run.recent],
@@ -2013,6 +2365,22 @@ var buildAiPocketMarkdownReport = ({
         ["include_gate_context", run.includeGateContext ? "on" : "off"],
         ["feature_profile", run.featureProfile ?? "all"],
         ["feature_policy", run.featurePolicy ?? "all"],
+        ["coverage_mode", run.coverageMode ?? "full"],
+        ["cadence_mode", run.cadenceMode ?? "fixed"],
+        ["low_cadence", pocketSearch.stats.cadence.lowCadence ? "yes" : "no"],
+        [
+          "sparse_sample",
+          pocketSearch.stats.cadence.sparseSample ? "yes" : "no"
+        ],
+        [
+          "adaptive_thresholds",
+          pocketSearch.stats.cadence.adaptiveThresholds ? "on" : "off"
+        ],
+        ["train_events", pocketSearch.stats.cadence.trainEvents],
+        [
+          "train_events_per_day",
+          formatMdNumber(pocketSearch.stats.cadence.trainEventsPerDay, 4)
+        ],
         ["report_path", run.reportPath]
       ]
     ),
@@ -2098,10 +2466,32 @@ var buildAiPocketMarkdownReport = ({
         ["predicates", pocketSearch.stats.predicates],
         ["atomic_used", pocketSearch.stats.atomicPredicatesUsed],
         ["feature_families", pocketSearch.stats.featureFamiliesUsed.join(", ")],
+        [
+          "required_feature_families",
+          pocketSearch.stats.requiredFeatureFamilies.join(", ") || "none"
+        ],
+        [
+          "excluded_feature_families",
+          pocketSearch.stats.excludedFeatureFamilies.join(", ") || "none"
+        ],
         ["estimated_combinations", pocketSearch.stats.estimatedCombinations],
         ["combinations_evaluated", pocketSearch.stats.combinationsEvaluated],
         ["validation_rows", pocketSearch.stats.validationRows],
         ["test_rows", pocketSearch.stats.testRows],
+        ["effective_min_support", pocketSearch.stats.cadence.minSupport],
+        ["effective_min_events", pocketSearch.stats.cadence.minEvents],
+        [
+          "effective_min_validation_support",
+          pocketSearch.stats.cadence.minValidationSupport
+        ],
+        [
+          "effective_min_validation_events",
+          pocketSearch.stats.cadence.minValidationEvents
+        ],
+        [
+          "effective_max_event_count_share",
+          formatMdPercent(pocketSearch.stats.cadence.maxEventCountShare)
+        ],
         [
           "duplicate_pockets_skipped",
           pocketSearch.stats.duplicatePocketsSkipped
@@ -2112,65 +2502,98 @@ var buildAiPocketMarkdownReport = ({
     "",
     "## Top Positive Pockets",
     "",
-    markdownTable(
-      [
-        "#",
-        "N",
-        "Events",
-        "Max batch",
-        "Support",
-        "WR",
-        "PF",
-        "PNL",
-        "Objective PNL",
-        "Max DD",
-        "Val N",
-        "Val WR",
-        "Val PF",
-        "Val PNL",
-        "Test N",
-        "Test PF",
-        "Test PNL",
-        "Test objective PNL",
-        "Trades/Day",
-        "Losing Months",
-        "Score",
-        "Pocket"
-      ],
-      pocketRows(pocketSearch.positivePockets)
-    ),
+    markdownTable(pocketTableHeaders, pocketRows(pocketSearch.positivePockets)),
     "",
     "## Top Loss Pockets",
     "",
-    markdownTable(
-      [
-        "#",
-        "N",
-        "Events",
-        "Max batch",
-        "Support",
-        "WR",
-        "PF",
-        "PNL",
-        "Objective PNL",
-        "Max DD",
-        "Val N",
-        "Val WR",
-        "Val PF",
-        "Val PNL",
-        "Test N",
-        "Test PF",
-        "Test PNL",
-        "Test objective PNL",
-        "Trades/Day",
-        "Losing Months",
-        "Score",
-        "Pocket"
-      ],
-      pocketRows(pocketSearch.negativePockets)
-    ),
+    markdownTable(pocketTableHeaders, pocketRows(pocketSearch.negativePockets)),
     ""
   ];
+  for (const cohort of coverageSearches) {
+    const title = cohort.family === "cmc" ? "CMC" : "Coinalyze";
+    lines.push(
+      `## Coverage Cohort: ${title}`,
+      "",
+      markdownTable(
+        ["Field", "Value"],
+        [
+          ["coverage_rows", cohort.coverage.rows],
+          ["coverage_row_ratio", formatMdPercent(cohort.coverage.rowRatio)],
+          ["coverage_events", cohort.coverage.events],
+          ["coverage_event_ratio", formatMdPercent(cohort.coverage.eventRatio)],
+          [
+            "coverage_from",
+            cohort.coverage.minTimestamp == null ? "n/a" : new Date(cohort.coverage.minTimestamp).toISOString()
+          ],
+          [
+            "coverage_to",
+            cohort.coverage.maxTimestamp == null ? "n/a" : new Date(cohort.coverage.maxTimestamp).toISOString()
+          ],
+          ["scope_rows", cohort.scopeRows],
+          ["train_rows", cohort.trainRows],
+          ["validation_rows", cohort.validationRows],
+          ["test_rows", cohort.testRows],
+          [
+            "low_cadence",
+            cohort.search.stats.cadence.lowCadence ? "yes" : "no"
+          ],
+          [
+            "sparse_sample",
+            cohort.search.stats.cadence.sparseSample ? "yes" : "no"
+          ],
+          [
+            "adaptive_thresholds",
+            cohort.search.stats.cadence.adaptiveThresholds ? "on" : "off"
+          ],
+          ["train_events", cohort.search.stats.cadence.trainEvents],
+          [
+            "train_events_per_day",
+            formatMdNumber(cohort.search.stats.cadence.trainEventsPerDay, 4)
+          ],
+          ["effective_min_support", cohort.search.stats.cadence.minSupport],
+          ["effective_min_events", cohort.search.stats.cadence.minEvents],
+          [
+            "effective_min_validation_support",
+            cohort.search.stats.cadence.minValidationSupport
+          ],
+          [
+            "effective_min_validation_events",
+            cohort.search.stats.cadence.minValidationEvents
+          ],
+          [
+            "effective_max_event_count_share",
+            formatMdPercent(cohort.search.stats.cadence.maxEventCountShare)
+          ],
+          [
+            "required_feature_families",
+            cohort.search.stats.requiredFeatureFamilies.join(", ") || "none"
+          ]
+        ]
+      ),
+      "",
+      `### ${title} Train Baseline`,
+      "",
+      markdownTable(
+        ["Metric", "Value"],
+        summaryMetricRows(cohort.search.baseline)
+      ),
+      "",
+      `### ${title} Top Positive Pockets`,
+      "",
+      markdownTable(
+        pocketTableHeaders,
+        pocketRows(cohort.search.positivePockets)
+      ),
+      "",
+      `### ${title} Top Loss Pockets`,
+      "",
+      markdownTable(
+        pocketTableHeaders,
+        pocketRows(cohort.search.negativePockets)
+      ),
+      ""
+    );
+  }
   if (errors.length) {
     lines.push("## Errors", "", ...errors.map((error) => `- ${error}`), "");
   }
@@ -2179,6 +2602,90 @@ var buildAiPocketMarkdownReport = ({
 };
 
 // src/lib/aiPocketSearchCli.ts
+var DAY_MS3 = 24 * 60 * 60 * 1e3;
+var DEFAULT_MIN_SUPPORT = 20;
+var LOW_CADENCE_EVENT_LIMIT = 200;
+var LOW_CADENCE_MAX_EVENT_SHARE = 1 / 3;
+var countIndependentEvents = (rows) => {
+  const timestampEvents = /* @__PURE__ */ new Set();
+  let rowsWithoutTimestamp = 0;
+  for (const row of rows) {
+    if (typeof row.timestamp === "number" && Number.isFinite(row.timestamp)) {
+      timestampEvents.add(row.timestamp);
+    } else {
+      rowsWithoutTimestamp += 1;
+    }
+  }
+  return timestampEvents.size + rowsWithoutTimestamp;
+};
+var getPeriodDays2 = (rows) => {
+  let minTimestamp = null;
+  let maxTimestamp = null;
+  for (const row of rows) {
+    const timestamp = row.timestamp;
+    if (typeof timestamp !== "number" || !Number.isFinite(timestamp)) {
+      continue;
+    }
+    minTimestamp = minTimestamp == null ? timestamp : Math.min(minTimestamp, timestamp);
+    maxTimestamp = maxTimestamp == null ? timestamp : Math.max(maxTimestamp, timestamp);
+  }
+  if (minTimestamp == null || maxTimestamp == null) {
+    return null;
+  }
+  return Math.max((maxTimestamp - minTimestamp) / DAY_MS3, 1);
+};
+var clampInt = (value, minimum, maximum) => Math.max(minimum, Math.min(maximum, Math.ceil(value)));
+var resolveAiPocketCadenceProfile = ({
+  trainRows,
+  validationRows = [],
+  testRows = [],
+  mode = "auto",
+  validationSplit = 0.25,
+  minSupport,
+  minEvents,
+  minValidationSupport,
+  minValidationEvents,
+  maxEventCountShare = 0.25,
+  explicitMaxEventCountShare = false
+}) => {
+  const trainEvents = countIndependentEvents(trainRows);
+  const validationEvents = countIndependentEvents(validationRows);
+  const testEvents = countIndependentEvents(testRows);
+  const trainPeriodDays = getPeriodDays2(trainRows);
+  const trainEventsPerDay = trainPeriodDays == null ? null : trainEvents / trainPeriodDays;
+  const sparseSample = trainEvents < LOW_CADENCE_EVENT_LIMIT;
+  const lowCadence = trainEventsPerDay != null && trainEventsPerDay < 0.25;
+  const adaptiveSample = mode === "auto" && sparseSample;
+  const adaptiveThresholds = adaptiveSample && (minSupport == null || minEvents == null || validationRows.length > 0 && (minValidationSupport == null || minValidationEvents == null) || !explicitMaxEventCountShare);
+  const resolvedMinSupport = minSupport ?? (adaptiveSample ? clampInt(trainEvents * 0.1, 3, DEFAULT_MIN_SUPPORT) : DEFAULT_MIN_SUPPORT);
+  const resolvedMinEvents = minEvents ?? (minSupport != null || !adaptiveSample ? Math.max(5, Math.ceil(resolvedMinSupport * 0.5)) : clampInt(resolvedMinSupport * 0.5, 3, 10));
+  const hasValidation = validationRows.length > 0;
+  const resolvedMinValidationSupport = minValidationSupport ?? (hasValidation ? Math.max(3, Math.ceil(resolvedMinSupport * validationSplit * 0.5)) : 0);
+  const resolvedMinValidationEvents = minValidationEvents ?? (hasValidation ? Math.max(
+    adaptiveSample ? 3 : 2,
+    Math.ceil(resolvedMinEvents * validationSplit * 0.5)
+  ) : 0);
+  const resolvedMaxEventCountShare = adaptiveSample && !explicitMaxEventCountShare ? Math.max(maxEventCountShare, LOW_CADENCE_MAX_EVENT_SHARE) : maxEventCountShare;
+  return {
+    mode,
+    lowCadence,
+    sparseSample,
+    adaptiveThresholds,
+    trainRows: trainRows.length,
+    trainEvents,
+    trainPeriodDays,
+    trainEventsPerDay,
+    validationRows: validationRows.length,
+    validationEvents,
+    testRows: testRows.length,
+    testEvents,
+    minSupport: resolvedMinSupport,
+    minEvents: resolvedMinEvents,
+    minValidationSupport: resolvedMinValidationSupport,
+    minValidationEvents: resolvedMinValidationEvents,
+    maxEventCountShare: resolvedMaxEventCountShare
+  };
+};
 var AI_POCKET_SEARCH_CLI_DECIMAL_DEFAULTS = {
   minProfitFactor: "1.2",
   minWinRate: "0",
@@ -2225,6 +2732,29 @@ 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 {
+    discoveryRows: [
+      ...split.trainRows,
+      ...split.validationRows,
+      ...sealed ? [] : split.testRows
+    ],
+    searchTestRows: sealed ? [] : split.testRows,
+    evidence: {
+      sealed,
+      rows: split.testRows.length,
+      events: countIndependentEvents(split.testRows),
+      startTimestamp: finiteTimestamps.length ? Math.min(...finiteTimestamps) : null,
+      endTimestamp: finiteTimestamps.length ? Math.max(...finiteTimestamps) : null
+    }
+  };
+};
 var readAiPocketSearchCliOption = ({
   argv,
   longName,
@@ -2298,7 +2828,11 @@ import_args.default.option(
   ""
 );
 import_args.default.option(["d", "maxDepth"], "Maximum predicate-combination depth", 2);
-import_args.default.option(["m", "minSupport"], "Minimum rows required for a pocket", 20);
+import_args.default.option(
+  ["m", "minSupport"],
+  "Minimum rows override; cadence auto derives it when omitted",
+  20
+);
 import_args.default.option(
   ["F", "minProfitFactor"],
   "Minimum profit factor required for positive pockets",
@@ -2334,6 +2868,11 @@ import_args.default.option(
   "Trailing timestamp-grouped scope share withheld as untouched test",
   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
+);
 import_args.default.option(
   ["N", "minValidationSupport"],
   "Minimum validation rows required for positive pockets (0 = auto)",
@@ -2401,6 +2940,16 @@ import_args.default.option(
   "Feature policy: causal-stationary or all",
   "causal-stationary"
 );
+import_args.default.option(
+  ["Q", "coverageMode"],
+  "Coverage-aware search mode: auto or full",
+  "auto"
+);
+import_args.default.option(
+  ["c", "cadenceMode"],
+  "Cadence thresholds: auto adapts discovery support, fixed keeps legacy defaults",
+  "auto"
+);
 import_args.default.option(
   ["r", "reportDir"],
   "Directory for generated Markdown reports",
@@ -2522,6 +3071,24 @@ var normalizeFeaturePolicy = (value) => {
   }
   return normalized;
 };
+var normalizeCoverageMode = (value) => {
+  const normalized = String(value || "auto").trim().toLowerCase();
+  if (!["auto", "full"].includes(normalized)) {
+    throw new Error(
+      `Unsupported --coverageMode "${normalized}". Use auto or full.`
+    );
+  }
+  return normalized;
+};
+var normalizeCadenceMode = (value) => {
+  const normalized = String(value || "auto").trim().toLowerCase();
+  if (!["auto", "fixed"].includes(normalized)) {
+    throw new Error(
+      `Unsupported --cadenceMode "${normalized}". Use auto or fixed.`
+    );
+  }
+  return normalized;
+};
 var normalizeObjective = (value, scope) => {
   const normalized = String(value || "auto").trim().toLowerCase();
   if (normalized === "auto") {
@@ -2749,16 +3316,20 @@ var buildPocketRows = (pockets) => pockets.map((pocket, index) => [
   pocket.objectiveSummary ? colorizeProfit(pocket.objectiveSummary.totalProfit) : import_chalk.default.gray("n/a"),
   colorizeProfit(-pocket.summary.maxDrawdown),
   pocket.validationSummary ? import_chalk.default.cyan(String(pocket.validationSummary.support)) : import_chalk.default.gray("n/a"),
+  pocket.validationSummary ? import_chalk.default.cyan(String(pocket.validationSummary.events)) : import_chalk.default.gray("n/a"),
   pocket.validationSummary ? colorizeRatio(pocket.validationSummary.winRate) : import_chalk.default.gray("n/a"),
   pocket.validationSummary ? colorizeNumber(pocket.validationSummary.profitFactor) : import_chalk.default.gray("n/a"),
   pocket.validationSummary ? colorizeProfit(pocket.validationSummary.totalProfit) : import_chalk.default.gray("n/a"),
   pocket.testSummary ? import_chalk.default.cyan(String(pocket.testSummary.support)) : import_chalk.default.gray("n/a"),
+  pocket.testSummary ? import_chalk.default.cyan(String(pocket.testSummary.events)) : import_chalk.default.gray("n/a"),
   pocket.testSummary ? colorizeNumber(pocket.testSummary.profitFactor) : import_chalk.default.gray("n/a"),
   pocket.testSummary ? colorizeProfit(pocket.testSummary.totalProfit) : import_chalk.default.gray("n/a"),
   pocket.testObjectiveSummary ? colorizeProfit(pocket.testObjectiveSummary.totalProfit) : import_chalk.default.gray("n/a"),
   colorizeNumber(pocket.summary.avgTradesPerDay),
   import_chalk.default.yellow(String(pocket.summary.losingMonths)),
   colorizeNumber(pocket.score),
+  pocket.readiness === "production-candidate" ? import_chalk.default.green(pocket.readiness) : import_chalk.default.yellow(pocket.readiness),
+  pocket.readinessReasons.length ? import_chalk.default.yellow(pocket.readinessReasons.join("; ")) : import_chalk.default.gray("none"),
   pocket.condition
 ]);
 var buildQualityRows = (qualityThresholds) => qualityThresholds.map(({ label, summary }) => [
@@ -2818,7 +3389,7 @@ var main = async () => {
     );
   }
   const maxDepth = normalizePositiveInt(flags.maxDepth, 2);
-  const minSupport = normalizePositiveInt(flags.minSupport, 20);
+  const explicitMinSupport = hasCliOption2("minSupport", "m") ? normalizePositiveInt(flags.minSupport, 20) : void 0;
   const minProfitFactor = normalizeNonNegativeNumber(
     readAiPocketSearchCliOption({
       argv: process.argv,
@@ -2862,6 +3433,10 @@ var main = async () => {
     }) ?? flags.testSplit,
     0
   ) : 0;
+  const sealTest = Boolean(flags.sealTest);
+  if (sealTest && testSplit <= 0) {
+    throw new Error("--sealTest requires a positive --testSplit");
+  }
   const explicitMinValidationSupport = normalizeInt(
     flags.minValidationSupport,
     0
@@ -2899,6 +3474,8 @@ var main = async () => {
   const includeGateContext = Boolean(flags.includeGateContext);
   const featureProfile = normalizeFeatureProfile(flags.featureProfile);
   const featurePolicy = normalizeFeaturePolicy(flags.featurePolicy);
+  const coverageMode = normalizeCoverageMode(flags.coverageMode);
+  const cadenceMode = normalizeCadenceMode(flags.cadenceMode);
   const jsonOutput = Boolean(flags.json);
   const outputPath = String(flags.output || "").trim();
   const reportDir = String(flags.reportDir || "data/ai/output").trim();
@@ -2992,6 +3569,19 @@ var main = async () => {
         const modelDirection = typeof analysis.direction === "string" && analysis.direction.trim() ? analysis.direction : null;
         const modelDirectionMatches = modelDirection === row.direction;
         const profit = Number(row.profit);
+        const featureSnapshot = collectAiPocketFeatureSnapshot({
+          payload,
+          gateContext,
+          includeSymbol,
+          includeGateContext,
+          featureProfile,
+          featurePolicy,
+          onFeatureExcluded: ({ path: featurePath, classification }) => {
+            const paths = excludedFeaturePaths.get(classification) ?? /* @__PURE__ */ new Set();
+            paths.add(featurePath);
+            excludedFeaturePaths.set(classification, paths);
+          }
+        });
         rows.push({
           signalId: row.signalId,
           strategy: row.strategyName,
@@ -3004,19 +3594,8 @@ var main = async () => {
           quality,
           modelDirectionMatches,
           modelCandidate: getDeterministicModelCandidate(signal),
-          features: collectAiPocketFeatures({
-            payload,
-            gateContext,
-            includeSymbol,
-            includeGateContext,
-            featureProfile,
-            featurePolicy,
-            onFeatureExcluded: ({ path: featurePath, classification }) => {
-              const paths = excludedFeaturePaths.get(classification) ?? /* @__PURE__ */ new Set();
-              paths.add(featurePath);
-              excludedFeaturePaths.set(classification, paths);
-            }
-          })
+          features: featureSnapshot.features,
+          featureCoverage: featureSnapshot.featureCoverage
         });
         bar?.tick(1, {
           symbol: import_chalk.default.gray(row.symbol),
@@ -3038,86 +3617,188 @@ var main = async () => {
   });
   const directionRows = direction ? rows.filter((row) => row.direction === direction) : rows;
   const scopeRows = resolveScopeRows(directionRows, scope);
-  const split = splitAiPocketResearchRowsByTimestamp(
+  const fullSplit = splitAiPocketResearchRowsByTimestamp(
     directionRows,
     validationSplit,
     testSplit
   );
-  const trainRows = resolveScopeRows(split.trainRows, scope);
-  const validationRows = resolveScopeRows(split.validationRows, scope);
-  const testRows = resolveScopeRows(split.testRows, scope);
-  const baselineRows = split.trainRows.filter((row) => row.aiApproved);
-  const validationBaselineRows = split.validationRows.filter(
+  const sealedFullSplit = sealAiPocketTestPartition(fullSplit, sealTest);
+  const discoveryRows = sealedFullSplit.discoveryRows;
+  const trainRows = resolveScopeRows(fullSplit.trainRows, scope);
+  const validationRows = resolveScopeRows(fullSplit.validationRows, scope);
+  const testRows = resolveScopeRows(sealedFullSplit.searchTestRows, scope);
+  const baselineRows = fullSplit.trainRows.filter((row) => row.aiApproved);
+  const validationBaselineRows = fullSplit.validationRows.filter(
     (row) => row.aiApproved
   );
-  const testBaselineRows = split.testRows.filter((row) => row.aiApproved);
-  const minValidationSupport = explicitMinValidationSupport > 0 ? explicitMinValidationSupport : validationRows.length ? Math.max(3, Math.ceil(minSupport * validationSplit * 0.5)) : 0;
-  const minEvents = explicitMinEvents > 0 ? explicitMinEvents : Math.max(5, Math.ceil(minSupport * 0.5));
-  const minValidationEvents = explicitMinValidationEvents > 0 ? explicitMinValidationEvents : validationRows.length ? Math.max(2, Math.ceil(minEvents * validationSplit * 0.5)) : 0;
-  const currentGateSummary = summarizeAiTrainEvaluations(rows);
-  const currentGateQualityThresholds = summarizeAiTrainEvaluationsByQualityThreshold(rows, qualityThresholds);
-  let searchBar = null;
-  let searchBarPhase = null;
-  const search = searchAiPockets(trainRows, {
-    minSupport,
-    minProfitFactor,
-    minTotalProfit,
-    minWinRate,
-    maxDepth,
-    maxAtomicPredicates,
-    maxCombinations,
-    top,
-    validationRows,
-    testRows,
-    minValidationSupport,
-    minEvents,
-    minValidationEvents,
-    ...maxBatch > 0 ? { maxBatch } : {},
-    maxEventCountShare,
-    maxSymbolCountShare,
-    objective,
-    baselineRows,
-    validationBaselineRows,
-    testBaselineRows,
-    allowRiskRegression,
-    requireValidationEligibility,
-    dedupeEquivalentSelections,
-    progressInterval: 250,
-    onProgress: (progress) => {
-      if (searchBar && searchBarPhase !== progress.phase) {
-        tickProgressBarTo(searchBar, searchBar.total, {
-          status: import_chalk.default.gray("done")
+  const testBaselineRows = sealedFullSplit.searchTestRows.filter(
+    (row) => row.aiApproved
+  );
+  const currentGateSummary = summarizeAiTrainEvaluations(discoveryRows);
+  const currentGateQualityThresholds = summarizeAiTrainEvaluationsByQualityThreshold(
+    discoveryRows,
+    qualityThresholds
+  );
+  const runSearch = ({
+    label,
+    train,
+    validation,
+    test,
+    trainBaseline,
+    validationBaseline,
+    testBaseline,
+    requiredFeatureFamilies = [],
+    excludedFeatureFamilies = []
+  }) => {
+    const cadenceProfile = resolveAiPocketCadenceProfile({
+      trainRows: train,
+      validationRows: validation,
+      testRows: test,
+      mode: cadenceMode,
+      validationSplit,
+      ...explicitMinSupport != null ? { minSupport: explicitMinSupport } : {},
+      ...explicitMinEvents > 0 ? { minEvents: explicitMinEvents } : {},
+      ...explicitMinValidationSupport > 0 ? { minValidationSupport: explicitMinValidationSupport } : {},
+      ...explicitMinValidationEvents > 0 ? { minValidationEvents: explicitMinValidationEvents } : {},
+      maxEventCountShare,
+      explicitMaxEventCountShare: hasCliOption2("maxEventCountShare", "U")
+    });
+    let searchBar = null;
+    let searchBarPhase = null;
+    return searchAiPockets(train, {
+      minSupport: cadenceProfile.minSupport,
+      minProfitFactor,
+      minTotalProfit,
+      minWinRate,
+      maxDepth,
+      maxAtomicPredicates,
+      maxCombinations,
+      top,
+      validationRows: validation,
+      testRows: test,
+      minValidationSupport: cadenceProfile.minValidationSupport,
+      minEvents: cadenceProfile.minEvents,
+      minValidationEvents: cadenceProfile.minValidationEvents,
+      ...maxBatch > 0 ? { maxBatch } : {},
+      maxEventCountShare: cadenceProfile.maxEventCountShare,
+      maxSymbolCountShare,
+      objective,
+      baselineRows: trainBaseline,
+      validationBaselineRows: validationBaseline,
+      testBaselineRows: testBaseline,
+      allowRiskRegression,
+      requireValidationEligibility,
+      dedupeEquivalentSelections,
+      requiredFeatureFamilies,
+      excludedFeatureFamilies,
+      cadenceProfile,
+      progressInterval: 250,
+      onProgress: (progress) => {
+        if (searchBar && searchBarPhase !== progress.phase) {
+          tickProgressBarTo(searchBar, searchBar.total, {
+            status: import_chalk.default.gray("done")
+          });
+          searchBar = null;
+        }
+        if (!searchBar) {
+          searchBarPhase = progress.phase;
+          const phaseLabel = searchPhaseLabels[progress.phase].padEnd(8, " ");
+          console.error(
+            import_chalk.default.gray(
+              `stage: ${label}/${searchPhaseLabels[progress.phase]} (${progress.total})`
+            )
+          );
+          searchBar = new import_progress.default(
+            `${phaseLabel} :current/:total [:bar] :percent :status`,
+            {
+              total: Math.max(progress.total, 1),
+              width: 20,
+              stream: process.stderr
+            }
+          );
+        }
+        tickProgressBarTo(searchBar, progress.current, {
+          status: progress.truncated ? import_chalk.default.yellow("truncated") : "running"
         });
-        searchBar = null;
-      }
-      if (!searchBar) {
-        searchBarPhase = progress.phase;
-        const label = searchPhaseLabels[progress.phase].padEnd(8, " ");
-        console.error(
-          import_chalk.default.gray(
-            `stage: ${searchPhaseLabels[progress.phase]} (${progress.total})`
-          )
-        );
-        searchBar = new import_progress.default(
-          `${label} :current/:total [:bar] :percent :status`,
-          {
-            total: Math.max(progress.total, 1),
-            width: 20,
-            stream: process.stderr
-          }
-        );
+        if (progress.done) {
+          tickProgressBarTo(searchBar, searchBar.total, {
+            status: progress.truncated ? import_chalk.default.yellow("truncated") : "done"
+          });
+          searchBar = null;
+        }
       }
-      tickProgressBarTo(searchBar, progress.current, {
-        status: progress.truncated ? import_chalk.default.yellow("truncated") : "running"
+    });
+  };
+  const search = runSearch({
+    label: "full",
+    train: trainRows,
+    validation: validationRows,
+    test: testRows,
+    trainBaseline: baselineRows,
+    validationBaseline: validationBaselineRows,
+    testBaseline: testBaselineRows,
+    ...coverageMode === "auto" ? {
+      excludedFeatureFamilies: [
+        "cmc",
+        "coinalyze"
+      ]
+    } : {}
+  });
+  const coverageSearches = [];
+  if (coverageMode === "auto") {
+    for (const family of ["cmc", "coinalyze"]) {
+      const cohortSplit = splitAiPocketCoverageRowsByTimestamp(
+        directionRows,
+        family,
+        validationSplit,
+        testSplit
+      );
+      const sealedCohortSplit = sealAiPocketTestPartition(
+        cohortSplit,
+        sealTest
+      );
+      const cohortTrainRows = resolveScopeRows(cohortSplit.trainRows, scope);
+      const cohortValidationRows = resolveScopeRows(
+        cohortSplit.validationRows,
+        scope
+      );
+      const cohortTestRows = resolveScopeRows(
+        sealedCohortSplit.searchTestRows,
+        scope
+      );
+      const cohortSearch = runSearch({
+        label: family,
+        train: cohortTrainRows,
+        validation: cohortValidationRows,
+        test: cohortTestRows,
+        trainBaseline: cohortSplit.trainRows.filter((row) => row.aiApproved),
+        validationBaseline: cohortSplit.validationRows.filter(
+          (row) => row.aiApproved
+        ),
+        testBaseline: sealedCohortSplit.searchTestRows.filter(
+          (row) => row.aiApproved
+        ),
+        requiredFeatureFamilies: [family]
+      });
+      coverageSearches.push({
+        family,
+        coverage: summarizeAiPocketFeatureCoverage(
+          sealedCohortSplit.discoveryRows,
+          family
+        ),
+        scopeRows: resolveScopeRows(
+          sealedCohortSplit.discoveryRows.filter(
+            (row) => row.featureCoverage?.[family] === true
+          ),
+          scope
+        ).length,
+        trainRows: cohortTrainRows.length,
+        validationRows: cohortValidationRows.length,
+        testRows: cohortTestRows.length,
+        search: cohortSearch
       });
-      if (progress.done) {
-        tickProgressBarTo(searchBar, searchBar.total, {
-          status: progress.truncated ? import_chalk.default.yellow("truncated") : "done"
-        });
-        searchBar = null;
-      }
     }
-  });
+  }
   const result = {
     generatedAt,
     run: {
@@ -3146,6 +3827,25 @@ var main = async () => {
       includeGateContext,
       featureProfile,
       featurePolicy,
+      coverageMode,
+      cadenceMode,
+      coverageSearches: coverageSearches.map(
+        ({
+          family,
+          coverage,
+          scopeRows: scopeRows2,
+          trainRows: trainRows2,
+          validationRows: validationRows2,
+          testRows: testRows2
+        }) => ({
+          family,
+          coverage,
+          scopeRows: scopeRows2,
+          trainRows: trainRows2,
+          validationRows: validationRows2,
+          testRows: testRows2
+        })
+      ),
       featurePolicyAudit: Object.fromEntries(
         [...excludedFeaturePaths.entries()].map(([classification, paths]) => [
           classification,
@@ -3158,26 +3858,27 @@ var main = async () => {
       objective,
       validationSplit,
       testSplit,
-      minValidationSupport,
+      sealedTest: sealedFullSplit.evidence,
+      minValidationSupport: search.stats.cadence.minValidationSupport,
       reportPath,
       search: {
         maxDepth,
-        minSupport,
+        minSupport: search.stats.cadence.minSupport,
         minProfitFactor,
         minWinRate,
         minTotalProfit,
         maxAtomicPredicates,
         maxCombinations,
-        minEvents,
-        minValidationEvents,
+        minEvents: search.stats.cadence.minEvents,
+        minValidationEvents: search.stats.cadence.minValidationEvents,
         ...maxBatch > 0 ? { maxBatch } : {},
-        maxEventCountShare,
+        maxEventCountShare: search.stats.cadence.maxEventCountShare,
         maxSymbolCountShare,
         allowRiskRegression,
         requireValidationEligibility,
+        cadence: search.stats.cadence,
         validationSplit,
         testSplit,
-        minValidationSupport,
         dedupeEquivalentSelections,
         top
       }
@@ -3187,6 +3888,7 @@ var main = async () => {
       qualityThresholds: currentGateQualityThresholds
     },
     pocketSearch: search,
+    coverageSearches,
     errors
   };
   const markdownReport = buildAiPocketMarkdownReport(result);
@@ -3246,17 +3948,53 @@ var main = async () => {
         ],
         ["min_quality", import_chalk.default.magenta(String(minQuality))],
         ["max_depth", import_chalk.default.magenta(String(maxDepth))],
-        ["min_support", import_chalk.default.magenta(String(minSupport))],
-        ["min_events", import_chalk.default.magenta(String(minEvents))],
-        ["min_validation_events", import_chalk.default.magenta(String(minValidationEvents))],
+        ["cadence_mode", import_chalk.default.magenta(cadenceMode)],
+        [
+          "low_cadence",
+          search.stats.cadence.lowCadence ? import_chalk.default.yellow("yes") : import_chalk.default.green("no")
+        ],
+        [
+          "sparse_sample",
+          search.stats.cadence.sparseSample ? import_chalk.default.yellow("yes") : import_chalk.default.green("no")
+        ],
+        [
+          "adaptive_thresholds",
+          search.stats.cadence.adaptiveThresholds ? import_chalk.default.yellow("on") : import_chalk.default.gray("off")
+        ],
+        [
+          "train_events",
+          import_chalk.default.magenta(String(search.stats.cadence.trainEvents))
+        ],
+        [
+          "train_events_per_day",
+          import_chalk.default.magenta(formatNumber2(search.stats.cadence.trainEventsPerDay))
+        ],
+        ["min_support", import_chalk.default.magenta(String(search.stats.cadence.minSupport))],
+        ["min_events", import_chalk.default.magenta(String(search.stats.cadence.minEvents))],
+        [
+          "min_validation_events",
+          import_chalk.default.magenta(String(search.stats.cadence.minValidationEvents))
+        ],
         ["max_batch", import_chalk.default.magenta(maxBatch > 0 ? String(maxBatch) : "off")],
-        ["max_event_share", import_chalk.default.magenta(formatRatio(maxEventCountShare))],
+        [
+          "max_event_share",
+          import_chalk.default.magenta(formatRatio(search.stats.cadence.maxEventCountShare))
+        ],
         ["max_symbol_share", import_chalk.default.magenta(formatRatio(maxSymbolCountShare))],
         ["max_atomic_predicates", import_chalk.default.magenta(String(maxAtomicPredicates))],
         ["max_combinations", import_chalk.default.magenta(String(maxCombinations))],
         ["validation_split", import_chalk.default.magenta(formatRatio(validationSplit))],
         ["test_split", import_chalk.default.magenta(formatRatio(testSplit))],
-        ["min_validation_support", import_chalk.default.magenta(String(minValidationSupport))],
+        [
+          "test_evidence",
+          sealedFullSplit.evidence.sealed ? import_chalk.default.green(
+            `sealed (${sealedFullSplit.evidence.rows} rows / ${sealedFullSplit.evidence.events} events)`
+          ) : import_chalk.default.yellow("open")
+        ],
+        [
+          "min_validation_support",
+          import_chalk.default.magenta(String(search.stats.cadence.minValidationSupport))
+        ],
         [
           "dedupe_equivalent",
           dedupeEquivalentSelections ? import_chalk.default.green("on") : import_chalk.default.gray("off")
@@ -3271,6 +4009,7 @@ var main = async () => {
         ],
         ["feature_profile", import_chalk.default.magenta(featureProfile)],
         ["feature_policy", import_chalk.default.magenta(featurePolicy)],
+        ["coverage_mode", import_chalk.default.magenta(coverageMode)],
         [
           "allow_risk_regression",
           allowRiskRegression ? import_chalk.default.yellow("on") : import_chalk.default.green("off")
@@ -3346,6 +4085,14 @@ var main = async () => {
           "feature_families",
           import_chalk.default.cyan(search.stats.featureFamiliesUsed.join(", "))
         ],
+        [
+          "required_feature_families",
+          import_chalk.default.cyan(search.stats.requiredFeatureFamilies.join(", ") || "none")
+        ],
+        [
+          "excluded_feature_families",
+          import_chalk.default.cyan(search.stats.excludedFeatureFamilies.join(", ") || "none")
+        ],
         [
           "estimated_combinations",
           import_chalk.default.cyan(String(search.stats.estimatedCombinations))
@@ -3356,6 +4103,27 @@ var main = async () => {
         ],
         ["validation_rows", import_chalk.default.cyan(String(search.stats.validationRows))],
         ["test_rows", import_chalk.default.cyan(String(search.stats.testRows))],
+        ["train_events", import_chalk.default.cyan(String(search.stats.cadence.trainEvents))],
+        [
+          "train_events_per_day",
+          import_chalk.default.cyan(formatNumber2(search.stats.cadence.trainEventsPerDay))
+        ],
+        [
+          "effective_min_support",
+          import_chalk.default.cyan(String(search.stats.cadence.minSupport))
+        ],
+        [
+          "effective_min_events",
+          import_chalk.default.cyan(String(search.stats.cadence.minEvents))
+        ],
+        [
+          "effective_min_validation_support",
+          import_chalk.default.cyan(String(search.stats.cadence.minValidationSupport))
+        ],
+        [
+          "effective_min_validation_events",
+          import_chalk.default.cyan(String(search.stats.cadence.minValidationEvents))
+        ],
         [
           "duplicate_pockets_skipped",
           import_chalk.default.cyan(String(search.stats.duplicatePocketsSkipped))
@@ -3382,16 +4150,20 @@ var main = async () => {
         import_chalk.default.gray("OBJ_PNL"),
         import_chalk.default.gray("MAX_DD"),
         import_chalk.default.gray("VAL_N"),
+        import_chalk.default.gray("VAL_EVENTS"),
         import_chalk.default.gray("VAL_WR"),
         import_chalk.default.gray("VAL_PF"),
         import_chalk.default.gray("VAL_PNL"),
         import_chalk.default.gray("TEST_N"),
+        import_chalk.default.gray("TEST_EVENTS"),
         import_chalk.default.gray("TEST_PF"),
         import_chalk.default.gray("TEST_PNL"),
         import_chalk.default.gray("TEST_OBJ"),
         import_chalk.default.gray("TR/D"),
         import_chalk.default.gray("LOSS_M"),
         import_chalk.default.gray("SCORE"),
+        import_chalk.default.gray("READINESS"),
+        import_chalk.default.gray("REASONS"),
         import_chalk.default.gray("POCKET")
       ],
       buildPocketRows(search.positivePockets)
@@ -3412,21 +4184,155 @@ var main = async () => {
         import_chalk.default.gray("OBJ_PNL"),
         import_chalk.default.gray("MAX_DD"),
         import_chalk.default.gray("VAL_N"),
+        import_chalk.default.gray("VAL_EVENTS"),
         import_chalk.default.gray("VAL_WR"),
         import_chalk.default.gray("VAL_PF"),
         import_chalk.default.gray("VAL_PNL"),
         import_chalk.default.gray("TEST_N"),
+        import_chalk.default.gray("TEST_EVENTS"),
         import_chalk.default.gray("TEST_PF"),
         import_chalk.default.gray("TEST_PNL"),
         import_chalk.default.gray("TEST_OBJ"),
         import_chalk.default.gray("TR/D"),
         import_chalk.default.gray("LOSS_M"),
         import_chalk.default.gray("SCORE"),
+        import_chalk.default.gray("READINESS"),
+        import_chalk.default.gray("REASONS"),
         import_chalk.default.gray("POCKET")
       ],
       buildPocketRows(search.negativePockets)
     )
   );
+  for (const cohort of coverageSearches) {
+    const title = cohort.family === "cmc" ? "CMC" : "COINALYZE";
+    printSection(
+      `${title} COVERAGE COHORT`,
+      createTable(
+        [import_chalk.default.gray("FIELD"), import_chalk.default.gray("VALUE")],
+        [
+          ["coverage_rows", import_chalk.default.cyan(String(cohort.coverage.rows))],
+          ["coverage_ratio", import_chalk.default.cyan(formatRatio(cohort.coverage.rowRatio))],
+          ["coverage_events", import_chalk.default.cyan(String(cohort.coverage.events))],
+          ["event_ratio", import_chalk.default.cyan(formatRatio(cohort.coverage.eventRatio))],
+          [
+            "coverage_from",
+            cohort.coverage.minTimestamp == null ? import_chalk.default.gray("n/a") : import_chalk.default.gray(
+              new Date(cohort.coverage.minTimestamp).toISOString()
+            )
+          ],
+          [
+            "coverage_to",
+            cohort.coverage.maxTimestamp == null ? import_chalk.default.gray("n/a") : import_chalk.default.gray(
+              new Date(cohort.coverage.maxTimestamp).toISOString()
+            )
+          ],
+          ["scope_rows", import_chalk.default.cyan(String(cohort.scopeRows))],
+          ["train_rows", import_chalk.default.cyan(String(cohort.trainRows))],
+          ["validation_rows", import_chalk.default.cyan(String(cohort.validationRows))],
+          ["test_rows", import_chalk.default.cyan(String(cohort.testRows))],
+          [
+            "low_cadence",
+            cohort.search.stats.cadence.lowCadence ? import_chalk.default.yellow("yes") : import_chalk.default.green("no")
+          ],
+          [
+            "sparse_sample",
+            cohort.search.stats.cadence.sparseSample ? import_chalk.default.yellow("yes") : import_chalk.default.green("no")
+          ],
+          [
+            "adaptive_thresholds",
+            cohort.search.stats.cadence.adaptiveThresholds ? import_chalk.default.yellow("on") : import_chalk.default.gray("off")
+          ],
+          [
+            "train_events",
+            import_chalk.default.cyan(String(cohort.search.stats.cadence.trainEvents))
+          ],
+          [
+            "effective_min_support",
+            import_chalk.default.cyan(String(cohort.search.stats.cadence.minSupport))
+          ],
+          [
+            "effective_min_events",
+            import_chalk.default.cyan(String(cohort.search.stats.cadence.minEvents))
+          ]
+        ]
+      )
+    );
+    printSection(
+      `${title} TRAIN BASELINE`,
+      createTable(
+        [import_chalk.default.gray("METRIC"), import_chalk.default.gray("VALUE")],
+        buildSummaryRows(cohort.search.baseline)
+      )
+    );
+    printSection(
+      `${title} TOP POSITIVE POCKETS`,
+      createTable(
+        [
+          import_chalk.default.gray("#"),
+          import_chalk.default.gray("N"),
+          import_chalk.default.gray("EVENTS"),
+          import_chalk.default.gray("MAX_B"),
+          import_chalk.default.gray("SUP"),
+          import_chalk.default.gray("WR"),
+          import_chalk.default.gray("PF"),
+          import_chalk.default.gray("PNL"),
+          import_chalk.default.gray("OBJ_PNL"),
+          import_chalk.default.gray("MAX_DD"),
+          import_chalk.default.gray("VAL_N"),
+          import_chalk.default.gray("VAL_EVENTS"),
+          import_chalk.default.gray("VAL_WR"),
+          import_chalk.default.gray("VAL_PF"),
+          import_chalk.default.gray("VAL_PNL"),
+          import_chalk.default.gray("TEST_N"),
+          import_chalk.default.gray("TEST_EVENTS"),
+          import_chalk.default.gray("TEST_PF"),
+          import_chalk.default.gray("TEST_PNL"),
+          import_chalk.default.gray("TEST_OBJ"),
+          import_chalk.default.gray("TR/D"),
+          import_chalk.default.gray("LOSS_M"),
+          import_chalk.default.gray("SCORE"),
+          import_chalk.default.gray("READINESS"),
+          import_chalk.default.gray("REASONS"),
+          import_chalk.default.gray("POCKET")
+        ],
+        buildPocketRows(cohort.search.positivePockets)
+      )
+    );
+    printSection(
+      `${title} TOP LOSS POCKETS`,
+      createTable(
+        [
+          import_chalk.default.gray("#"),
+          import_chalk.default.gray("N"),
+          import_chalk.default.gray("EVENTS"),
+          import_chalk.default.gray("MAX_B"),
+          import_chalk.default.gray("SUP"),
+          import_chalk.default.gray("WR"),
+          import_chalk.default.gray("PF"),
+          import_chalk.default.gray("PNL"),
+          import_chalk.default.gray("OBJ_PNL"),
+          import_chalk.default.gray("MAX_DD"),
+          import_chalk.default.gray("VAL_N"),
+          import_chalk.default.gray("VAL_EVENTS"),
+          import_chalk.default.gray("VAL_WR"),
+          import_chalk.default.gray("VAL_PF"),
+          import_chalk.default.gray("VAL_PNL"),
+          import_chalk.default.gray("TEST_N"),
+          import_chalk.default.gray("TEST_EVENTS"),
+          import_chalk.default.gray("TEST_PF"),
+          import_chalk.default.gray("TEST_PNL"),
+          import_chalk.default.gray("TEST_OBJ"),
+          import_chalk.default.gray("TR/D"),
+          import_chalk.default.gray("LOSS_M"),
+          import_chalk.default.gray("SCORE"),
+          import_chalk.default.gray("READINESS"),
+          import_chalk.default.gray("REASONS"),
+          import_chalk.default.gray("POCKET")
+        ],
+        buildPocketRows(cohort.search.negativePockets)
+      )
+    );
+  }
   if (errors.length) {
     console.log(import_chalk.default.yellow("Errors:"));
     errors.forEach((error) => console.log(import_chalk.default.yellow(`- ${error}`)));