create-tradejs 3.1.28-beta.254 → 3.1.28-beta.256

package/dist/skill-bundle/.codex/skills/ai-train-local-research/references/gate-ablation.md

@@ -120,6 +120,16 @@ JSON reports include timestamp-grouped cumulative `equity` arrays for the
 current-gate baseline and every variant. Use these checksum-bound arrays for
 final-composition charts instead of reconstructing curves by hand.
 
+JSON reports also include `approvedSignals` for the baseline and every variant
+at `run.minQuality`. Each entry records the source row `sequence`, `signalId`,
+timestamp, symbol, direction, and profit. The trace uses the same selector as
+the metrics, after the common half-open window, direction rule, placebo, and
+optional capacity limit. Use these identities to join approval decisions to
+the frozen export for loss localization and overlapping-position analysis.
+Do not reconstruct a second gate or infer individual approvals from equity
+points. The trace describes historical gate decisions, not submitted or filled
+runtime orders.
+
 For a deterministic timestamp-local portfolio limit, a JSON spec variant may
 also define `selection`. The tool first evaluates the gate, then keeps the
 highest-ranked rows independently inside each decision timestamp. Missing rank

package/dist/skill-bundle/.codex/skills/ai-train-local-research/references/pocket-feature-exclusion.md

@@ -0,0 +1,43 @@
+# Excluding features before pocket search
+
+`ai-pocket-search --excludeFeaturePattern <regex>` (short form `-x`) applies an
+optional JavaScript regular expression to dot-separated feature paths before
+feature buckets and atomic predicates are ranked. The expression is case
+sensitive, without slash delimiters or flags. An invalid expression fails during
+option normalization, before loading a dataset or strategy. Omission or an empty
+string preserves the existing search behavior.
+
+Use this option when the research protocol excludes a provenance family that the
+general `causal-stationary` classification permits. For example:
+
+```bash
+yarn ai-pocket-search --strategy AdaptiveMomentumRibbon --file <exact-export.jsonl> \
+  -n 0 --featurePolicy causal-stationary --featureProfile all \
+  --excludeFeaturePattern 'marketBreadths|(^|\.)cmc|referenceContexts\.(?!BTCUSDT(\.|$))'
+```
+
+Freeze the actual expression with the experiment before inspecting pocket
+outcomes. This example is only a provenance filter; it is not a complete feature
+policy or evidence of profitability. Audit the remaining feature paths against
+the protocol, including source metadata and clock fields. A symbol-specific
+exception requires a fixed benchmark established in the protocol.
+
+Matching a source branch skips its descendants. Filtering takes place before
+derived features are calculated, so an excluded source value cannot populate a
+derived alias. Generated feature paths are also filtered before search. Existing
+outcome, coverage, and stationarity exclusions remain in force; this option can
+only remove features. Removing a source field can also remove a derived feature
+that depended on it.
+
+The JSON run metadata records `excludeFeaturePattern`. JSON
+`featurePolicyAudit["operator-excluded"]` reports the number of distinct excluded
+paths and up to five sample paths. These are research policy exclusions, not
+missing-data or data-quality failures. A matched branch counts once, rather than
+counting its unvisited descendant leaves. Text and Markdown reports also record
+the expression. Preserve the expression, report, source revision, exact dataset,
+and checksums together.
+
+A post-search filter does not provide the same contract: prohibited predicates
+may have already consumed the atomic ranking budget and displaced allowed ones.
+This option does not change trade labels, PnL, gate decisions, or execution, and
+does not automatically impose the same expression on a separate gate replay.

package/dist/skill-bundle/.codex/skills/ai-train-local-research/scripts/ai-gate-ablation.mjs

@@ -4089,7 +4089,17 @@ export const buildAblationReport = ({
       : {}),
   };
   const baselineSelector = (row) => baselineSelectedAt(row, minQuality);
+  const approvedSignalTrace = (selector) =>
+    selectRows(rows, selector).map((row) => ({
+      sequence: row.sequence ?? null,
+      signalId: row.signalId ?? null,
+      timestamp: row.timestamp,
+      symbol: row.symbol,
+      direction: row.direction,
+      profit: row.profit,
+    }));
   const baseline = {
+    approvedSignals: approvedSignalTrace(baselineSelector),
     equity: buildEquitySeries(
       rows,
       baselineSelector,
@@ -4152,6 +4162,7 @@ export const buildAblationReport = ({
       expression: variant.expression,
       selection: variant.selection ?? null,
       placebo: variant.placebo ?? null,
+      approvedSignals: approvedSignalTrace(candidateSelector),
       equity: buildEquitySeries(
         rows,
         candidateSelector,

package/dist/skill-bundle/.codex/skills/ai-train-local-research/scripts/ai-gate-ablation.test.mjs

@@ -1016,6 +1016,60 @@ test('applies variant capacity before every report slice', () => {
   assert.equal(report.variants[0].periods.full.totalProfit, 5);
   assert.equal(report.variants[0].train.trades, 2);
   assert.deepEqual(report.variants[0].selection, variant.selection);
+  assert.deepEqual(
+    report.variants[0].approvedSignals.map((row) => row.sequence),
+    [1, 2],
+  );
+});
+
+test('traces the exact approved signals without replaying the gate', () => {
+  const start = Date.UTC(2026, 0, 1);
+  const rows = [4, 3, 5, 4].map((quality, sequence) => ({
+    timestamp: start + sequence * 900000,
+    signalId: `signal-${sequence}`,
+    sequence,
+    symbol: 'A',
+    direction: 'LONG',
+    directionMatches: sequence !== 2,
+    quality,
+    profit: sequence - 1,
+    variantMatches: [sequence === 1],
+  }));
+  const report = buildAblationReport({
+    rows,
+    variants: [parseVariant('replacement::replace@4::true')],
+    minQuality: 4,
+    qualityThresholds: [4],
+    terminalWindows: [7],
+    validationSplit: 0,
+    filePaths: ['fixture.jsonl'],
+    windowStart: start,
+    windowEnd: start + 3 * 900000,
+  });
+  assert.deepEqual(report.baseline.approvedSignals, [
+    {
+      sequence: 0,
+      signalId: 'signal-0',
+      timestamp: start,
+      symbol: 'A',
+      direction: 'LONG',
+      profit: -1,
+    },
+  ]);
+  assert.deepEqual(
+    report.variants[0].approvedSignals.map((row) => row.signalId),
+    ['signal-1'],
+  );
+  for (const composition of [report.baseline, ...report.variants]) {
+    assert.equal(
+      composition.approvedSignals.length,
+      composition.periods.full.trades,
+    );
+    assert.equal(
+      composition.approvedSignals.reduce((sum, row) => sum + row.profit, 0),
+      composition.periods.full.totalProfit,
+    );
+  }
 });
 
 test('uses common half-open comparison bounds for sparse gate exports', () => {
@@ -1068,6 +1122,8 @@ test('uses common half-open comparison bounds for sparse gate exports', () => {
   });
   assert.equal(empty.variants[0].periods.full.trades, 0);
   assert.equal(empty.variants[0].periods.full.totalProfit, 0);
+  assert.deepEqual(empty.baseline.approvedSignals, []);
+  assert.deepEqual(empty.variants[0].approvedSignals, []);
   const parsed = parseCliArgs([
     '--windowStart',
     String(start),

package/dist/skill-bundle/.codex/skills/strategy-improvement-research/references/final-composition-board.md

@@ -115,6 +115,16 @@ of the same SVG. Link or display both charts in the final answer and immutable
 research note. Store the complete board spec and summary in Project-owned
 evidence; paths alone do not replace the note's machine-readable metrics.
 
+For these research comparison charts, use continuous straight segments between
+the recorded equity samples by default, not staircase corners. This matches the
+preferred presentation without averaging returns or rounding away drawdowns.
+Keep the observed endpoints and extrema; do not use moving averages or splines
+that invent peaks or troughs. The connecting line is a visual interpolation,
+not a claim about account value between events or an intratrade mark-to-market
+path. Record `rendering.equityInterpolation = linear` in the chart summary.
+For presentation-only updates, render to a new output directory and retain the
+frozen reports, equity arrays, metrics, selections, and original chart files.
+
 ## Spec shape
 
 ```json

package/dist/skill-bundle/.codex/skills/strategy-improvement-research/scripts/final-composition-board.mjs

@@ -551,23 +551,40 @@ const dashboardSvg = (board) => {
     const x = sx(dd);
     return `<line x1="${scatter.x}" x2="${scatter.x + scatter.width}" y1="${y}" y2="${y}" class="grid"/><text x="${scatter.x - 12}" y="${y + 5}" text-anchor="end" class="axis">${escapeXml(formatCompact(pnl))}</text><line x1="${x}" x2="${x}" y1="${scatter.y}" y2="${scatter.y + scatter.height}" class="grid faint"/><text x="${x}" y="${scatter.y + scatter.height + 28}" text-anchor="middle" class="axis">${escapeXml(formatCompact(dd))}</text>`;
   }).join('');
+  const pointGroups = new Map();
   const points = board.candidates
     .map((candidate, index) => {
       const x = sx(candidate.metrics.maxDrawdown);
       const y = sy(candidate.metrics.pnl);
       const selectedPoint = candidate.id === selected.id;
-      const labelY = y + 5;
+      const key = stableStringify([
+        candidate.metrics.maxDrawdown,
+        candidate.metrics.pnl,
+      ]);
+      const group = pointGroups.get(key) ?? [];
+      group.push({ candidate, index, x, y });
+      pointGroups.set(key, group);
+      return `${selectedPoint ? `<circle cx="${x}" cy="${y}" r="24" fill="${candidate.color}" opacity="0.18"/>` : ''}<circle data-scatter-point="${escapeXml(candidate.id)}" cx="${x}" cy="${y}" r="${selectedPoint ? 12 : 9}" fill="${candidate.color}" stroke="${selectedPoint ? '#7a321b' : '#ffffff'}" stroke-width="${selectedPoint ? 3 : 2}"/>`;
+    })
+    .join('');
+  const pointLabels = [...pointGroups.values()]
+    .map((group) => {
+      const { candidate, x, y } =
+        group.find((point) => point.candidate.id === selected.id) ?? group[0];
       const labelOnLeft = x > scatter.x + scatter.width * 0.66;
-      const labelX = x + (labelOnLeft ? -14 : 14);
-      const anchor = labelOnLeft ? 'end' : 'start';
-      return `${selectedPoint ? `<circle cx="${x}" cy="${y}" r="24" fill="${candidate.color}" opacity="0.18"/>` : ''}<circle cx="${x}" cy="${y}" r="${selectedPoint ? 12 : 9}" fill="${candidate.color}" stroke="${selectedPoint ? '#7a321b' : '#ffffff'}" stroke-width="${selectedPoint ? 3 : 2}"/><text x="${labelX}" y="${labelY}" text-anchor="${anchor}" class="pointLabel" fill="${selectedPoint ? candidate.color : '#24302a'}">${index === 0 ? '0' : String.fromCharCode(64 + index)}</text>`;
+      const label = group
+        .map(({ index }) =>
+          index === 0 ? '0' : String.fromCharCode(64 + index),
+        )
+        .join(' / ');
+      return `<text data-point-label-ids="${escapeXml(group.map(({ candidate }) => candidate.id).join(','))}" x="${x + (labelOnLeft ? -14 : 14)}" y="${y + 5}" text-anchor="${labelOnLeft ? 'end' : 'start'}" class="pointLabel" fill="${candidate.id === selected.id ? candidate.color : '#24302a'}">${label}</text>`;
     })
     .join('');
 
   const limitations = board.limitations.length
     ? `Limitations: ${board.limitations.join(' · ')}`
     : 'Limitations: none recorded';
-  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(board.strategy)} final composition dashboard"><style>.bg{fill:#f5f4ef}.panel{fill:#fff;stroke:#ddd9d0;stroke-width:2}.title{font:500 42px Arial,sans-serif;fill:#17211d}.subtitle{font:22px Arial,sans-serif;fill:#38433e}.cardLabel{font:21px Arial,sans-serif;fill:#303a35}.cardValue{font:500 44px Arial,sans-serif}.cardDetail{font:18px Arial,sans-serif;fill:#303a35}.section{font:500 27px Arial,sans-serif;fill:#17211d}.muted{font:18px Arial,sans-serif;fill:#45514a}.axis{font:15px Arial,sans-serif;fill:#58645e}.grid{stroke:#d9ddd9;stroke-width:1.5}.faint{opacity:.5}.barValue{font:16px Arial,sans-serif;fill:#24302a}.windowLabel{font:20px Arial,sans-serif;fill:#24302a}.windowCount{font:15px Arial,sans-serif;fill:#45514a}.pointLabel{font:16px Arial,sans-serif}.footer{font:18px Arial,sans-serif;fill:#6b4b1f}</style><rect width="100%" height="100%" class="bg"/><text x="72" y="70" class="title">${escapeXml(board.strategy)} · ${escapeXml(selected.label)}</text><text x="72" y="108" class="subtitle">${escapeXml(board.subtitle)}</text>${cardsMarkup}<rect x="72" y="330" width="1040" height="650" rx="20" class="panel"/><text x="100" y="380" class="section">PnL in terminal windows</text>${terminalLegend}<rect x="1145" y="330" width="585" height="650" rx="20" class="panel"/><text x="1180" y="380" class="section">Final compositions: PnL ↔ drawdown</text><text x="1180" y="412" class="muted">Higher and farther left is preferable</text><g>${barGrid}<line x1="${bar.x}" x2="${bar.x + bar.width}" y1="${zeroY}" y2="${zeroY}" stroke="#8f9994" stroke-width="1.5"/>${bars}</g><g>${scatterGrid}${points}<text x="${scatter.x + scatter.width / 2}" y="${scatter.y + scatter.height + 65}" text-anchor="middle" class="muted">MaxDD (trade stream)</text></g><g><rect x="72" y="1020" width="1658" height="112" rx="16" fill="#fff5dd" stroke="#efd79c" stroke-width="2"/>${svgTextLines({ lines: [truncate(limitations, 155), `Risk normalization: MAX_LOSS_VALUE=${board.normalization.maxLossValue} · ${board.normalization.pnlUnit} · ${board.researchId}`], x: 98, y: 1062, lineHeight: 30, className: 'footer' })}</g></svg>`;
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(board.strategy)} final composition dashboard"><style>.bg{fill:#f5f4ef}.panel{fill:#fff;stroke:#ddd9d0;stroke-width:2}.title{font:500 42px Arial,sans-serif;fill:#17211d}.subtitle{font:22px Arial,sans-serif;fill:#38433e}.cardLabel{font:21px Arial,sans-serif;fill:#303a35}.cardValue{font:500 44px Arial,sans-serif}.cardDetail{font:18px Arial,sans-serif;fill:#303a35}.section{font:500 27px Arial,sans-serif;fill:#17211d}.muted{font:18px Arial,sans-serif;fill:#45514a}.axis{font:15px Arial,sans-serif;fill:#58645e}.grid{stroke:#d9ddd9;stroke-width:1.5}.faint{opacity:.5}.barValue{font:16px Arial,sans-serif;fill:#24302a}.windowLabel{font:20px Arial,sans-serif;fill:#24302a}.windowCount{font:15px Arial,sans-serif;fill:#45514a}.pointLabel{font:16px Arial,sans-serif}.footer{font:18px Arial,sans-serif;fill:#6b4b1f}</style><rect width="100%" height="100%" class="bg"/><text x="72" y="70" class="title">${escapeXml(board.strategy)} · ${escapeXml(selected.label)}</text><text x="72" y="108" class="subtitle">${escapeXml(board.subtitle)}</text>${cardsMarkup}<rect x="72" y="330" width="1040" height="650" rx="20" class="panel"/><text x="100" y="380" class="section">PnL in terminal windows</text>${terminalLegend}<rect x="1145" y="330" width="585" height="650" rx="20" class="panel"/><text x="1180" y="380" class="section">Final compositions: PnL ↔ drawdown</text><text x="1180" y="412" class="muted">Higher and farther left is preferable</text><g>${barGrid}<line x1="${bar.x}" x2="${bar.x + bar.width}" y1="${zeroY}" y2="${zeroY}" stroke="#8f9994" stroke-width="1.5"/>${bars}</g><g>${scatterGrid}${points}${pointLabels}<text x="${scatter.x + scatter.width / 2}" y="${scatter.y + scatter.height + 65}" text-anchor="middle" class="muted">MaxDD (trade stream)</text></g><g><rect x="72" y="1020" width="1658" height="112" rx="16" fill="#fff5dd" stroke="#efd79c" stroke-width="2"/>${svgTextLines({ lines: [truncate(limitations, 155), `Risk normalization: MAX_LOSS_VALUE=${board.normalization.maxLossValue} · ${board.normalization.pnlUnit} · ${board.researchId}`], x: 98, y: 1062, lineHeight: 30, className: 'footer' })}</g></svg>`;
 };
 
 const downsample = (points, maxPoints = 1200) => {
@@ -598,13 +615,17 @@ const downsample = (points, maxPoints = 1200) => {
 
 const equitySvg = (board) => {
   const width = 1800;
-  const height = 1200;
   const left = 110;
   const right = 70;
   const top = 150;
-  const bottom = 300;
+  const columns = 3;
+  const legendRows = Math.ceil(board.candidates.length / columns);
+  const legendTop = 110;
+  const legendRowHeight = 58;
+  const bottom = Math.max(300, legendTop + legendRows * legendRowHeight + 32);
+  const plotHeight = 750;
+  const height = top + plotHeight + bottom;
   const plotWidth = width - left - right;
-  const plotHeight = height - top - bottom;
   const minTime = board.comparisonWindow.start;
   const maxTime = board.comparisonWindow.end - 1;
   const values = board.candidates.flatMap(({ equity }) =>
@@ -648,9 +669,6 @@ const equitySvg = (board) => {
   const curves = board.candidates
     .map((candidate) => {
       const points = downsample(candidate.equity)
-        .flatMap((point, index, series) =>
-          index === 0 ? [point] : [[point[0], series[index - 1][1]], point],
-        )
         .map(
           ([timestamp, pnl]) =>
             `${x(timestamp).toFixed(1)},${y(pnl).toFixed(1)}`,
@@ -660,15 +678,14 @@ const equitySvg = (board) => {
       return `<polyline points="${points}" fill="none" stroke="${candidate.color}" stroke-width="${selected ? 4.5 : 3}" opacity="${selected ? 1 : 0.82}" stroke-linejoin="round" stroke-linecap="round"/>`;
     })
     .join('');
-  const columns = 3;
   const legendWidth = (width - left - right) / columns;
   const legend = board.candidates
     .map((candidate, index) => {
       const column = index % columns;
       const row = Math.floor(index / columns);
       const lx = left + column * legendWidth;
-      const ly = height - bottom + 110 + row * 58;
-      return `<g transform="translate(${lx},${ly})"><rect width="18" height="18" rx="3" fill="${candidate.color}"/><text x="28" y="15" class="legendLabel">${index === 0 ? '0' : String.fromCharCode(64 + index)} · ${escapeXml(truncate(candidate.label, 35))}</text><text x="28" y="37" class="legendMetric">N=${candidate.metrics.trades} · PnL=${formatNumber(candidate.metrics.pnl, 1)} · DD=${formatNumber(candidate.metrics.maxDrawdown, 1)}</text></g>`;
+      const ly = height - bottom + legendTop + row * legendRowHeight;
+      return `<g data-equity-legend="${escapeXml(candidate.id)}" transform="translate(${lx},${ly})"><rect width="18" height="18" rx="3" fill="${candidate.color}"/><text x="28" y="15" class="legendLabel">${index === 0 ? '0' : String.fromCharCode(64 + index)} · ${escapeXml(truncate(candidate.label, 35))}</text><text x="28" y="37" class="legendMetric">N=${candidate.metrics.trades} · PnL=${formatNumber(candidate.metrics.pnl, 1)} · DD=${formatNumber(candidate.metrics.maxDrawdown, 1)}</text></g>`;
     })
     .join('');
   const selected = board.candidates.find(({ id }) => id === board.selectedId);
@@ -768,6 +785,12 @@ export const generateFinalCompositionBoard = async ({
     terminalComparisonIds: board.terminalComparisonIds,
     comparisonWindow: board.comparisonWindow,
     normalization: board.normalization,
+    rendering: {
+      equityInterpolation: 'linear',
+      meaning:
+        'Lines connect event samples; not an intratrade or mark-to-market path.',
+      metricInputsChanged: false,
+    },
     limitations: board.limitations,
     candidates: board.candidates.map((candidate) => ({
       id: candidate.id,

package/dist/skill-bundle/.codex/skills/strategy-improvement-research/scripts/final-composition-board.test.mjs

@@ -183,18 +183,83 @@ test('verifies candidate artifacts and renders the dashboard and equity board',
     const points = coordinates
       .split(' ')
       .map((point) => point.split(',').map(Number));
-    for (let index = 1; index < points.length; index += 1) {
-      assert.ok(
-        points[index][0] === points[index - 1][0] ||
-          points[index][1] === points[index - 1][1],
-        'Cumulative PnL must not interpolate gains between trade events',
-      );
-    }
+    assert.equal(points.length, 2, 'Do not insert synthetic step corners');
+    assert.ok(points[1][0] > points[0][0]);
+    assert.ok(points[1][1] < points[0][1], 'Join event samples directly');
   }
+  assert.equal(summary.rendering.equityInterpolation, 'linear');
+  assert.equal(summary.rendering.metricInputsChanged, false);
   assert.match(equity, /Nov 2023/u);
   assert.match(equity, /Mar 2024/u);
 });
 
+test('linear presentation preserves flat samples, peaks, troughs and frozen metrics', async () => {
+  const root = await mkdtemp(path.join(os.tmpdir(), 'tradejs-final-board-'));
+  const contents = 'immutable-evidence\n';
+  const spec = makeSpec(hash(contents));
+  spec.candidates[0].equity = [
+    [1_700_000_000_000, 0],
+    [1_701_000_000_000, 0],
+    [1_703_000_000_000, 180],
+    [1_706_000_000_000, -20],
+    [1_710_000_000_000, 100],
+  ];
+  spec.candidates[0].metrics.maxDrawdown = 200;
+  const frozenSpec = structuredClone(spec);
+  for (const candidate of spec.candidates) {
+    for (const key of [
+      'coreResult',
+      'coreExport',
+      'gateReport',
+      'gateAuthority',
+    ]) {
+      const reference = candidate.composition[key];
+      if (reference) await writeFile(path.join(root, reference.path), contents);
+    }
+  }
+  const { summary } = await generateFinalCompositionBoard({
+    spec,
+    artifactRoot: root,
+    outDir: path.join(root, 'charts'),
+    png: false,
+  });
+  const svg = await readFile(
+    path.join(root, 'charts', 'final-composition-equity.svg'),
+    'utf8',
+  );
+  const points = /<polyline points="([^"]+)"/u
+    .exec(svg)[1]
+    .split(' ')
+    .map((point) => point.split(',').map(Number));
+  assert.equal(points.length, frozenSpec.candidates[0].equity.length);
+  assert.equal(
+    points[0][1],
+    points[1][1],
+    'A flat observed interval stays flat',
+  );
+  assert.equal(
+    Math.min(...points.map((p) => p[1])),
+    points[2][1],
+    'Keep the observed peak',
+  );
+  assert.equal(
+    Math.max(...points.map((p) => p[1])),
+    points[3][1],
+    'Keep the observed trough',
+  );
+  for (let i = 1; i < points.length; i++)
+    assert.ok(points[i][0] > points[i - 1][0]);
+  assert.deepEqual(spec, frozenSpec, 'Rendering must not mutate evidence');
+  assert.deepEqual(
+    summary.candidates.map((c) => c.metrics),
+    spec.candidates.map((c) => c.metrics),
+  );
+  assert.deepEqual(
+    summary.candidates.map((c) => c.terminal),
+    spec.candidates.map((c) => c.terminal),
+  );
+});
+
 test('renders an additional terminal comparison without changing selectedId', async () => {
   const root = await mkdtemp(path.join(os.tmpdir(), 'tradejs-final-board-'));
   const contents = 'immutable-evidence\n';
@@ -238,3 +303,103 @@ test('renders an additional terminal comparison without changing selectedId', as
   assert.match(dashboard, /data-terminal-series="transition"/u);
   assert.match(dashboard, /Transition breakout \+ own gate/u);
 });
+
+for (const candidateCount of [14, 20]) {
+  test(`keeps every legend row visible for ${candidateCount} compositions and groups coincident point labels`, async () => {
+    const root = await mkdtemp(path.join(os.tmpdir(), 'tradejs-final-board-'));
+    const contents = 'immutable-evidence\n';
+    const artifactSha = hash(contents);
+    const spec = makeSpec(artifactSha);
+    for (let index = 2; index < candidateCount; index += 1) {
+      spec.candidates.push(
+        makeCandidate({
+          id: `candidate-${index}`,
+          role: 'candidate',
+          label: `Composition ${index}`,
+          color: '#315f7d',
+          pnl: index < 4 ? 160 : index * 30,
+          trades: 28,
+          drawdown: index < 4 ? 26 : index * 7,
+          artifactSha,
+        }),
+      );
+    }
+    for (const candidate of spec.candidates) {
+      for (const artifact of [
+        'coreResult',
+        'coreExport',
+        'gateReport',
+        'gateAuthority',
+      ]) {
+        const reference = candidate.composition[artifact];
+        if (reference)
+          await writeFile(path.join(root, reference.path), contents);
+      }
+    }
+    const { summary } = await generateFinalCompositionBoard({
+      spec,
+      artifactRoot: root,
+      outDir: path.join(root, 'charts'),
+    });
+    assert.deepEqual(
+      summary.candidates.map(({ metrics }) => metrics),
+      spec.candidates.map(({ metrics }) => metrics),
+    );
+    const equity = await readFile(
+      path.join(root, 'charts', 'final-composition-equity.svg'),
+      'utf8',
+    );
+    const height = Number(/<svg[^>]* height="(\d+)"/u.exec(equity)[1]);
+    const legends = [
+      ...equity.matchAll(
+        /data-equity-legend="([^"]+)" transform="translate\([^,]+,([\d.]+)\)"/gu,
+      ),
+    ];
+    assert.equal(legends.length, candidateCount);
+    for (const [, id, top] of legends) {
+      assert.ok(
+        Number(top) + 42 < height - 24,
+        `${id}: legend label and metrics must fit with bottom margin`,
+      );
+    }
+    const { default: sharp } = await import('sharp');
+    const image = sharp(
+      await readFile(path.join(root, 'charts', 'final-composition-equity.png')),
+    );
+    assert.equal((await image.metadata()).height, height);
+    const lastRowTop = Number(legends.at(-1)[2]);
+    const pixels = await image
+      .extract({ left: 110, top: lastRowTop, width: 500, height: 42 })
+      .stats();
+    assert.ok(
+      pixels.channels.some(({ min }) => min < 200),
+      'Last legend row must be painted inside the PNG',
+    );
+    const dashboard = await readFile(
+      path.join(root, 'charts', 'final-composition-dashboard.svg'),
+      'utf8',
+    );
+    const points = [
+      ...dashboard.matchAll(
+        /data-scatter-point="([^"]+)" cx="([^"]+)" cy="([^"]+)"/gu,
+      ),
+    ];
+    assert.equal(points.length, candidateCount);
+    const coincident = points.filter(([, id]) =>
+      ['candidate', 'candidate-2', 'candidate-3'].includes(id),
+    );
+    assert.equal(
+      new Set(coincident.map(([, , x, y]) => `${x},${y}`)).size,
+      1,
+      'Coincident data points must not be jittered',
+    );
+    assert.match(
+      dashboard,
+      /data-point-label-ids="candidate,candidate-2,candidate-3"[^>]*>A \/ B \/ C<\/text>/u,
+    );
+    assert.equal(
+      [...dashboard.matchAll(/data-point-label-ids=/gu)].length,
+      candidateCount - 2,
+    );
+  });
+}

package/dist/skill-bundle/.codex/tradejs-skill-bundle.json

@@ -1,7 +1,7 @@
 {
   "schema": "tradejs-skill-bundle/v1",
   "source": "TradeJS-Dev/TradeJS:.codex/skills",
-  "bundleSha256": "be995341ae9459133ad1bb60da5c8fac01c5ffbe6d72309c1d68448abbe03c0e",
+  "bundleSha256": "f31f221397fa300534800c147d1ea57e549627083723acc7c97b75364d31da11",
   "skills": [
     "ai-train-local-research",
     "backtest-config-redis",
@@ -19,10 +19,11 @@
     "strategy-release"
   ],
   "files": {
-    ".codex/skills/ai-train-local-research/references/gate-ablation.md": "a32ca7272a74678aca97dfce6b098ed15ca41fc385b936f25492f47bce4ec621",
+    ".codex/skills/ai-train-local-research/references/gate-ablation.md": "afc8334de0282fd0fac3886f467a1fca8e67c624a48cb5de66351635a039421e",
+    ".codex/skills/ai-train-local-research/references/pocket-feature-exclusion.md": "c7af65fcfcd404d5324f0222678126d5e166fb77c4c27afea96369ef427f4bb0",
     ".codex/skills/ai-train-local-research/references/reporting.md": "a5a5cc6438a8cc228560e302e944f1ff320f4c963988af83e1ba1443728f7149",
-    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.mjs": "4275088307342ef35d848f1bdd39528c22d2c66cf41aa7d3ed26f851c2fe803b",
-    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.test.mjs": "f9adcb02a779fb1da23e9c0aa99dead6152c5f45464138dd1de4283ece4ed363",
+    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.mjs": "f68a1a7c898f4c2f46860709a52cabd3abd4cc8cd14443de2b5f827d261be935",
+    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.test.mjs": "f13d2284a4c04a5220588652be81d104d2acde9650481cf569fa0efe56118f08",
     ".codex/skills/ai-train-local-research/SKILL.md": "479e44aad9cb6ab6b5c8931c807c63cf2a1938a59d01f553c20f44645716a23a",
     ".codex/skills/backtest-config-redis/scripts/get_backtest_config.sh": "833e950d6348c5b7a4bd3f00d25af60f6394190bff744bd5ab64db9e43d826d5",
     ".codex/skills/backtest-config-redis/SKILL.md": "85e7b1fa425aa23dfa7950de05c1d3ce046d044dc3872f3665705e9e2f2a1977",
@@ -41,11 +42,11 @@
     ".codex/skills/strategy-forward-start/SKILL.md": "a86311aeb4c5b46e43011806ffa0f665c4ec0fddce8d7f8c1232184e4a14bfa7",
     ".codex/skills/strategy-forward-status/SKILL.md": "b41f117680259fd7b4d5cbe3c0a1be75a42f08c8cf78f9ad7ccb0d90bfc66269",
     ".codex/skills/strategy-improvement-plan/SKILL.md": "f5f0f390941dd3332890a2f0ffae1248abde4925db2cf49a41c0c0c1b47e7864",
-    ".codex/skills/strategy-improvement-research/references/final-composition-board.md": "05b49ea4aba85792ccea0aeaf4ee2637b808157962f0a38631d6468c342349d6",
+    ".codex/skills/strategy-improvement-research/references/final-composition-board.md": "bc88878e088744ff933f06b54f73af96231d1f22dc162a44c9eb2e81d6cb51aa",
     ".codex/skills/strategy-improvement-research/scripts/build-final-composition-spec.mjs": "b51873691fafbcf2dd70d8c9a6da842fec5f8358346c632cfe79211db08b18ba",
     ".codex/skills/strategy-improvement-research/scripts/build-final-composition-spec.test.mjs": "85d06b8fe09ee7611a3fb989173c361ba32f0e9364422925ff221bfe127b2bfa",
-    ".codex/skills/strategy-improvement-research/scripts/final-composition-board.mjs": "b00f0160823a25c31afbcab66ce0c16fc70055928463a5741b3ffe8063ee8a81",
-    ".codex/skills/strategy-improvement-research/scripts/final-composition-board.test.mjs": "a40e8b395ed1c758dc9862b44887e71e8cb9352ce26443d244397f76af891b62",
+    ".codex/skills/strategy-improvement-research/scripts/final-composition-board.mjs": "c7834c9d567d3f02c39fcca2b0116a0097bc0384891a5185edbcafa23eeea1db",
+    ".codex/skills/strategy-improvement-research/scripts/final-composition-board.test.mjs": "14572bbb8083f83b7e05b6dad2a9c93a88c212425b09cc31ee15ab7a684ea8c5",
     ".codex/skills/strategy-improvement-research/scripts/freeze-gate-variants.mjs": "17b3c868880ddd5b326d309e6e42eaeef1ea22d625a5db947997ac73b221ad6d",
     ".codex/skills/strategy-improvement-research/scripts/freeze-gate-variants.test.mjs": "963e1c64ab3deef11fd48a96e10f3827af38036dfe2eb28daf7849f19dd414d8",
     ".codex/skills/strategy-improvement-research/SKILL.md": "6964eb154e40b0b775aa2735b2ebbe998984479f46333ed03eab88d2ee150d48",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-tradejs",
-  "version": "3.1.28-beta.254",
+  "version": "3.1.28-beta.256",
   "description": "Create a ready-to-run TradeJS project with local infrastructure and the Web UI.",
   "keywords": [
     "tradejs",