create-tradejs 3.1.22 → 3.1.23

package/dist/skill-bundle/.codex/skills/strategy-release/scripts/release-progress-checkpoint.test.mjs

@@ -0,0 +1,349 @@
+import assert from 'node:assert/strict';
+import { createHash } from 'node:crypto';
+import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { after, test } from 'node:test';
+
+import { evaluateReleaseProgress } from './release-progress-checkpoint.mjs';
+
+const root = mkdtempSync(path.join(os.tmpdir(), 'release-progress-v2-'));
+after(() => rmSync(root, { recursive: true, force: true }));
+
+const fileReference = (name, content) => {
+  const filePath = path.join(root, name);
+  const buffer = Buffer.isBuffer(content) ? content : Buffer.from(content);
+  writeFileSync(filePath, buffer);
+  return {
+    path: filePath,
+    sha256: createHash('sha256').update(buffer).digest('hex'),
+  };
+};
+
+const jsonReference = (name, value) =>
+  fileReference(name, `${JSON.stringify(value, null, 2)}\n`);
+
+const strategy = 'LiquidityTails';
+const lineageId = 'liquidity-tails-release-20260821';
+const objectiveArtifact = jsonReference('objective.json', {
+  schema: 'tradejs-release-objective/v2',
+  strategy,
+  lineageId,
+});
+const trialLedger = jsonReference('trial-ledger.json', {
+  schema: 'tradejs-release-trial-ledger/v2',
+  candidates: [],
+});
+const historyArtifact = jsonReference('history.json', {
+  schema: 'tradejs-strategy-hypothesis-inventory/v1',
+  strategy,
+  entries: [],
+});
+const revalidationArtifact = jsonReference('revalidation.json', {
+  schema: 'tradejs-release-candidate-revalidation/v2',
+  strategy,
+  lineageId,
+  objectiveFingerprint: objectiveArtifact.sha256,
+  historyInventorySha256: historyArtifact.sha256,
+  status: 'complete',
+  priorCandidateCount: 0,
+  candidates: [],
+  unresolved: [],
+  trialLedger,
+});
+const baselineArtifact = jsonReference('baseline.json', {
+  schema: 'tradejs-core-research-result/v1',
+  researchId: 'baseline',
+});
+const opportunityArtifact = jsonReference('opportunity.json', {
+  schema: 'tradejs-release-opportunity-map/v2',
+});
+const portfolioArtifact = jsonReference('portfolio.json', {
+  schema: 'tradejs-release-hypothesis-portfolio/v2',
+});
+const reportArtifact = jsonReference('report.json', { report: 'complete' });
+const chartArtifact = jsonReference('chart.json', { chart: 'complete' });
+
+const roundEvidence = (family, round) => {
+  const researchId = `${family}-round-${round}`;
+  const traceArtifact = fileReference(
+    `${researchId}-trace.jsonl`,
+    `${JSON.stringify({ researchId, event: 'entry' })}\n`,
+  );
+  const manifestArtifact = jsonReference(`${researchId}-manifest.json`, {
+    schema: 'tradejs-core-research-manifest/v1',
+    researchId,
+    status: 'completed',
+  });
+  const resultArtifact = jsonReference(`${researchId}-result.json`, {
+    schema: 'tradejs-core-research-result/v1',
+    researchId,
+    artifactHashes: { trace: traceArtifact.sha256 },
+  });
+  const handoffArtifact = jsonReference(`${researchId}-handoff.json`, {
+    schema: 'tradejs-release-causal-handoff/v1',
+    researchId,
+    round,
+    traceCoverage: 'complete',
+    resultSha256: resultArtifact.sha256,
+  });
+  return {
+    round,
+    researchId,
+    manifestArtifact,
+    resultArtifact,
+    traceArtifacts: [traceArtifact],
+    handoffArtifact,
+  };
+};
+
+const completedFamily = (id) => ({
+  id,
+  status: 'active',
+  roundArtifacts: [1, 2, 3].map((round) => roundEvidence(id, round)),
+});
+
+const completedFamilies = [
+  completedFamily('lifecycle'),
+  completedFamily('geometry'),
+  completedFamily('participation'),
+];
+const rescueArtifact = jsonReference('rescue.json', {
+  schema: 'tradejs-release-rescue-board/v2',
+  strategy,
+  lineageId,
+  objectiveFingerprint: objectiveArtifact.sha256,
+  children: [],
+  missingSlots: [
+    'no distinct cadence seed',
+    'no second distinct cadence seed',
+    'no third distinct cadence seed',
+  ],
+});
+const compositionFingerprint = 'c'.repeat(64);
+const selectedCompositionArtifact = jsonReference('selected.json', {
+  schema: 'tradejs-release-selected-composition/v2',
+  strategy,
+  lineageId,
+  candidateId: 'candidate-1',
+  compositionFingerprint,
+  objectiveFingerprint: objectiveArtifact.sha256,
+  historicalMatrixSha256: 'd'.repeat(64),
+  chartSha256: chartArtifact.sha256,
+});
+
+const input = (overrides = {}) => ({
+  schema: 'tradejs-release-progress-input/v2',
+  strategy,
+  lineageId,
+  objectiveContract: { artifact: objectiveArtifact },
+  historyAudit: { complete: true, artifact: historyArtifact },
+  candidateRevalidation: {
+    required: true,
+    complete: true,
+    artifact: revalidationArtifact,
+  },
+  baseline: {
+    complete: true,
+    reconciled: true,
+    artifact: baselineArtifact,
+  },
+  opportunityMap: { complete: true, artifact: opportunityArtifact },
+  hypothesisPortfolio: { frozen: true, artifact: portfolioArtifact },
+  families: [
+    { id: 'lifecycle', status: 'active', roundArtifacts: [] },
+    { id: 'geometry', status: 'active', roundArtifacts: [] },
+    { id: 'participation', status: 'active', roundArtifacts: [] },
+  ],
+  rescueBoard: { complete: false },
+  directionalParameterCheckpoint: { required: false, complete: false },
+  directionPolicyCheckpoint: { required: false, complete: false },
+  fullAiReport: { complete: false },
+  chart: { complete: false },
+  selectedComposition: null,
+  limitations: [],
+  ...overrides,
+});
+
+test('requires round 1 despite provenance limitations', () => {
+  const result = evaluateReleaseProgress(
+    input({
+      limitations: [
+        'retrospective_current_universe',
+        'missing_effective_dated_membership',
+        'exposed_holdout',
+      ],
+    }),
+  );
+
+  assert.equal(result.nextAction, 'RUN_CORE_ROUND_1');
+  assert.equal(result.evidenceCeiling, 'micro_forward_only');
+  assert.equal(result.verdictAllowed, false);
+});
+
+test('requires historical candidate revalidation before the baseline', () => {
+  const result = evaluateReleaseProgress(
+    input({
+      candidateRevalidation: { required: true, complete: false },
+    }),
+  );
+
+  assert.equal(result.nextAction, 'REVALIDATE_HISTORICAL_CANDIDATES');
+  assert.equal(result.phase, 'history');
+});
+
+test('rejects a zero-candidate revalidation when history contains prior behavior', () => {
+  const populatedHistory = jsonReference('populated-history.json', {
+    schema: 'tradejs-strategy-hypothesis-inventory/v1',
+    strategy,
+    entries: [
+      {
+        status: 'verified-result',
+        behaviorSha256: 'a'.repeat(64),
+      },
+      { status: 'refactor-no-hypothesis' },
+    ],
+  });
+  const incompleteRevalidation = jsonReference('incomplete-revalidation.json', {
+    schema: 'tradejs-release-candidate-revalidation/v2',
+    strategy,
+    lineageId,
+    objectiveFingerprint: objectiveArtifact.sha256,
+    historyInventorySha256: populatedHistory.sha256,
+    status: 'complete',
+    priorCandidateCount: 0,
+    candidates: [],
+    unresolved: [],
+    trialLedger,
+  });
+
+  assert.throws(
+    () =>
+      evaluateReleaseProgress(
+        input({
+          historyAudit: { complete: true, artifact: populatedHistory },
+          candidateRevalidation: {
+            required: true,
+            complete: true,
+            artifact: incompleteRevalidation,
+          },
+        }),
+      ),
+    /every deduplicated prior candidate/,
+  );
+});
+
+test('does not trust a declared roundsCompleted count without artifacts', () => {
+  const result = evaluateReleaseProgress(
+    input({
+      families: [
+        {
+          id: 'lifecycle',
+          status: 'active',
+          roundsCompleted: 3,
+          roundArtifacts: [],
+        },
+        { id: 'geometry', status: 'active', roundArtifacts: [] },
+        { id: 'participation', status: 'active', roundArtifacts: [] },
+      ],
+    }),
+  );
+
+  assert.equal(result.nextAction, 'RUN_CORE_ROUND_1');
+  assert.match(result.reason, /lifecycle/);
+});
+
+test('rejects a round whose result hash is not bound by the handoff', () => {
+  const invalidRound = roundEvidence('invalid', 1);
+  invalidRound.handoffArtifact = jsonReference(
+    'invalid-handoff-rewritten.json',
+    {
+      schema: 'tradejs-release-causal-handoff/v1',
+      researchId: invalidRound.researchId,
+      round: 1,
+      traceCoverage: 'complete',
+      resultSha256: '0'.repeat(64),
+    },
+  );
+
+  assert.throws(
+    () =>
+      evaluateReleaseProgress(
+        input({
+          families: [
+            { id: 'invalid', status: 'active', roundArtifacts: [invalidRound] },
+            { id: 'geometry', status: 'active', roundArtifacts: [] },
+            { id: 'participation', status: 'active', roundArtifacts: [] },
+          ],
+        }),
+      ),
+    /bound to result SHA-256/,
+  );
+});
+
+test('allows a complete artifact-backed limited-provenance contour to decide', () => {
+  const result = evaluateReleaseProgress(
+    input({
+      families: completedFamilies,
+      rescueBoard: { complete: true, artifact: rescueArtifact },
+      fullAiReport: { complete: true, artifact: reportArtifact },
+      chart: { complete: true, artifact: chartArtifact },
+      selectedComposition: {
+        candidateId: 'candidate-1',
+        compositionFingerprint,
+        artifact: selectedCompositionArtifact,
+      },
+      limitations: ['retrospective_current_universe', 'exposed_holdout'],
+    }),
+  );
+
+  assert.equal(result.status, 'complete');
+  assert.equal(result.verdictAllowed, true);
+  assert.equal(result.nextAction, 'DECIDE_PROSPECTIVE_MICRO_FORWARD');
+  assert.equal(result.schema, 'tradejs-release-progress/v2');
+  assert.equal(result.selectedComposition.candidateId, 'candidate-1');
+});
+
+test('requires a selected composition after report and chart', () => {
+  const result = evaluateReleaseProgress(
+    input({
+      families: completedFamilies,
+      rescueBoard: { complete: true, artifact: rescueArtifact },
+      fullAiReport: { complete: true, artifact: reportArtifact },
+      chart: { complete: true, artifact: chartArtifact },
+    }),
+  );
+
+  assert.equal(result.nextAction, 'FREEZE_SELECTED_COMPOSITION');
+  assert.equal(result.verdictAllowed, false);
+});
+
+test('stops the invalid evidence path on causal leakage', () => {
+  const result = evaluateReleaseProgress(
+    input({ limitations: ['causal_leakage'] }),
+  );
+
+  assert.equal(result.nextAction, 'REPAIR_INVALID_EVIDENCE');
+  assert.equal(result.evidenceCeiling, 'invalid_evidence');
+});
+
+test('requires a hashed reason when a family retires before round 3', () => {
+  assert.throws(
+    () =>
+      evaluateReleaseProgress(
+        input({
+          families: [
+            {
+              id: 'lifecycle',
+              status: 'retired',
+              hardStopReason: 'mechanism_falsified',
+              roundArtifacts: [],
+            },
+            { id: 'geometry', status: 'active', roundArtifacts: [] },
+            { id: 'participation', status: 'active', roundArtifacts: [] },
+          ],
+        }),
+      ),
+    /retirementArtifact is required/,
+  );
+});

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

@@ -1,8 +1,13 @@
 {
   "schema": "tradejs-skill-bundle/v1",
   "source": "TradeJS-Dev/TradeJS:.codex/skills",
-  "bundleSha256": "61f0c85bbb29614ba43d447e808c9321fac85aad391f707ff18f0d51fcaace65",
+  "bundleSha256": "f058077d43fc342e82062908fa7512b74981c2bee878901508dd8d3fdba32e23",
   "skills": [
+    "ai-train-local-research",
+    "backtest-config-redis",
+    "runtime-parity-mismatch-analysis",
+    "save-strategy-config-from-backtest",
+    "strategy-backtest-research",
     "strategy-candidate-report",
     "strategy-candidate-compare",
     "strategy-improvement-plan",
@@ -10,16 +15,52 @@
     "strategy-period-revalidate",
     "strategy-forward-start",
     "strategy-forward-status",
-    "strategy-risk-scale"
+    "strategy-risk-scale",
+    "strategy-release"
   ],
   "files": {
+    ".codex/skills/ai-train-local-research/references/gate-ablation.md": "5bd50a225864b518c1ca3400716c384f289899f8b81dd33df6aee3dc2998ff0b",
+    ".codex/skills/ai-train-local-research/references/reporting.md": "a5a5cc6438a8cc228560e302e944f1ff320f4c963988af83e1ba1443728f7149",
+    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.mjs": "b3a4bceff25219644e96d5309d3c11c59761b9cd7d7096ee701f95654853cfa8",
+    ".codex/skills/ai-train-local-research/scripts/ai-gate-ablation.test.mjs": "dc5128b8743f67cc496a296d52a21ec3cc139308ffc80eac07cf3a77dc4c78bf",
+    ".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",
+    ".codex/skills/runtime-parity-mismatch-analysis/SKILL.md": "289925c0069d1933ec3b09d5d6a020632170716c61aafb7031a0998acf3736f6",
+    ".codex/skills/save-strategy-config-from-backtest/agents/openai.yaml": "ba163f9449562241ed954ca2e0f12e22562390740cdcf0d09d7f99f0ef791741",
+    ".codex/skills/save-strategy-config-from-backtest/SKILL.md": "a73cddc29fb8fa741fe6226c051e19b0f9a19747babf96d336e7f165fb1fd298",
+    ".codex/skills/strategy-backtest-research/references/research-notes.md": "e65eb2124115a11a5be637964efed06961c7a90eff33d95eaf238b521d1f505a",
+    ".codex/skills/strategy-backtest-research/scripts/backtest-run-metrics.mjs": "dbcc6bb7cab4e0108ed11df503b8a0a337d1a01b77c5b56554ce1264a00f5d57",
+    ".codex/skills/strategy-backtest-research/scripts/backtest-run-metrics.test.mjs": "a00d0ae5fb0037cc554282dbe22109a9e34cb64b93d26a6feab69005a2ba637f",
+    ".codex/skills/strategy-backtest-research/scripts/fast-ai-export-metrics.mjs": "1d1747d34269ad15a610dcd687334c3d47ed9460d891285ad1dd851c7658d1af",
+    ".codex/skills/strategy-backtest-research/scripts/fast-ai-export-metrics.test.mjs": "4caab52646504afd2a6f1e4ba9f43d6b07d714baca89d2a2010545fb4210a9da",
+    ".codex/skills/strategy-backtest-research/scripts/research-notes-check.mjs": "435aa6560abcf4e8a60fb86230d8d8de2f2dc9e4c52acc7a272ce30287d40325",
+    ".codex/skills/strategy-backtest-research/SKILL.md": "4acc57b255cfe8b16a2b2bf0af0c8ee50e79e2bcea3f8045d422342007b8a779",
     ".codex/skills/strategy-candidate-compare/SKILL.md": "34dbca2c77ce74836f5c264131cefb751313147128ab1c3f947002f975be051c",
     ".codex/skills/strategy-candidate-report/SKILL.md": "3cad1241ce2107d7e30a5d78eafd6429514a10d1a8e9cf3d0e97ffef9d691ab6",
     ".codex/skills/strategy-forward-start/SKILL.md": "1591bd1c64864283320793b3c0bb4e1677aab960951ef8b487a1101ca7b6f82c",
     ".codex/skills/strategy-forward-status/SKILL.md": "b41f117680259fd7b4d5cbe3c0a1be75a42f08c8cf78f9ad7ccb0d90bfc66269",
     ".codex/skills/strategy-improvement-plan/SKILL.md": "f5f0f390941dd3332890a2f0ffae1248abde4925db2cf49a41c0c0c1b47e7864",
-    ".codex/skills/strategy-improvement-research/SKILL.md": "38fe575954db303dc28763432b2bbc7bc07054adb56196810f15490755a75f76",
+    ".codex/skills/strategy-improvement-research/SKILL.md": "634b6d4d7e9e8e22db9c073bef0410ae90ab1b68d0fc2610d8def48b5fc687c4",
     ".codex/skills/strategy-period-revalidate/SKILL.md": "f367ba1c632506a7d9bf92662a40b61df55f7a56ad04f3600a475b3c365bbbcb",
+    ".codex/skills/strategy-release/agents/openai.yaml": "46ddb09119b08ae3be3b9509121b57492342012e774789b615767b24270dba17",
+    ".codex/skills/strategy-release/references/diagnose-live.md": "dc2effa6eba34e3cfcc1eaf4d2fd1c96d6ccdda971a0edec76c9eed1ec293a3d",
+    ".codex/skills/strategy-release/references/direction-policy.md": "e7635e709dfc7301b94f3dbc1421c6a779c7c39ce4f6066b2eece38e4e600bec",
+    ".codex/skills/strategy-release/references/directional-parameter-split.md": "c303fbd15183b4b8c5662526d5bc762edc0a21a42c45e141d0dc5efdd3b52d8c",
+    ".codex/skills/strategy-release/references/evidence-limitations.md": "523d6541a230b51c2b0b81a6c11c99e3aef69203f22b77e94fda1e3b15321e20",
+    ".codex/skills/strategy-release/references/evidence-retention.md": "8fc5ccbc1003e8dc524f12dd56592eb72839c251245c6f68fd495fd4871e4993",
+    ".codex/skills/strategy-release/references/historical-hypothesis-audit.md": "3c4d579a0c097e974592b855891446060eb70d8bddf8558d765052a92509b516",
+    ".codex/skills/strategy-release/references/professional-research-loop.md": "e440f05dd6b5c803ba20da9f019f745f89477724d46551c53dbb8dab9cffe40f",
+    ".codex/skills/strategy-release/references/release-workflow.md": "aeda374c8b0a5d14629b2a1476a9c6e67e556e7ff7709b566d532334f39863eb",
+    ".codex/skills/strategy-release/references/research-objective.md": "650a29260ff7a2ee5dcac89500f59b4c81c2fbd650d6d247a1c799e45814798a",
+    ".codex/skills/strategy-release/references/verdict-contract.md": "7cd2d0ae8c8264da36319a78ff80d76893d5233cbceba4d076973f32b2bb2fe9",
+    ".codex/skills/strategy-release/scripts/direction-policy-checkpoint.mjs": "739240707323ec80b16191b447e76dd2295e946564c3a67f8472949d6129b3a1",
+    ".codex/skills/strategy-release/scripts/direction-policy-checkpoint.test.mjs": "838465922425be81c011e82b2df4255d136e074f84128124925c0553958a8389",
+    ".codex/skills/strategy-release/scripts/directional-parameter-checkpoint.mjs": "ff276ef75f65f247ed750685ee59225d5bf70e7d5f5fbb1f734efa3becb5e616",
+    ".codex/skills/strategy-release/scripts/directional-parameter-checkpoint.test.mjs": "a4f4433e4b59040a41f392b91e2a36cb2ec821737f77afbebf0cf2c5268dd11f",
+    ".codex/skills/strategy-release/scripts/release-progress-checkpoint.mjs": "28da8715ab51ee7217d633c675d014b8004e5ddda8faf9489ebacacef98f6b9b",
+    ".codex/skills/strategy-release/scripts/release-progress-checkpoint.test.mjs": "d378b0ab87cd3ee7bbf384ec5f5810565b480b56533ad3c6700edf5938286a38",
+    ".codex/skills/strategy-release/SKILL.md": "590948c2c1ad222c7784b050e0fa0a8fea60efa7b0f23d8d355fd56a3e8a1291",
     ".codex/skills/strategy-risk-scale/SKILL.md": "2c07846c9da2fd622ea6f5586c42863fc27b35a7d1d00614d5bbe0719da4d39f"
   }
 }

package/package.json

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