@tradejs/cli 3.1.29-beta.290 → 3.1.29-beta.292

package/dist/scripts/strategyRelease.js

@@ -42,8 +42,40 @@ var import_chalk = __toESM(require("chalk"));
 
 // src/lib/strategyRelease/researchRetention.ts
 var import_promises = __toESM(require("fs/promises"));
-var import_node_path2 = __toESM(require("path"));
+
+// src/lib/researchMetricSnapshot.ts
 var import_node_crypto = require("crypto");
+var import_node_zlib = require("zlib");
+var MAX_BYTES = 256 * 1024 * 1024;
+var hash = (bytes) => (0, import_node_crypto.createHash)("sha256").update(bytes).digest("hex");
+var validatePermanentResearchMetrics = (value) => {
+  if (!value || typeof value !== "object") return;
+  for (const [key, child] of Object.entries(value)) {
+    if (["matchedPairs", "tradeRows", "allProjectedLeaves"].includes(key) && Array.isArray(child) && child.length)
+      throw new Error(`Temporary payload ${key} is not a permanent metric`);
+    if (key === "trades" && Array.isArray(child) && child.some(
+      (row) => row && typeof row === "object" && ("signalId" in row || "entryTimestamp" in row)
+    ))
+      throw new Error("Temporary trade records are not permanent metrics");
+    validatePermanentResearchMetrics(child);
+  }
+};
+var decodeResearchMetricSnapshot = (snapshot) => {
+  if (!snapshot || typeof snapshot !== "object" || !("schema" in snapshot) || snapshot.schema !== "tradejs-metric-snapshot/v1" || !("encoding" in snapshot) || snapshot.encoding !== "gzip+base64" || !("decodedBytes" in snapshot) || typeof snapshot.decodedBytes !== "number" || !Number.isSafeInteger(snapshot.decodedBytes) || snapshot.decodedBytes <= 0 || snapshot.decodedBytes > MAX_BYTES || !("sha256" in snapshot) || typeof snapshot.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(snapshot.sha256) || !("payload" in snapshot) || typeof snapshot.payload !== "string")
+    throw new Error("Invalid metric snapshot envelope");
+  const bytes = (0, import_node_zlib.gunzipSync)(Buffer.from(snapshot.payload, "base64"), {
+    maxOutputLength: snapshot.decodedBytes
+  });
+  if (bytes.length !== snapshot.decodedBytes || hash(bytes) !== snapshot.sha256)
+    throw new Error("Metric snapshot checksum or size mismatch");
+  const metrics = JSON.parse(bytes.toString("utf8"));
+  validatePermanentResearchMetrics(metrics);
+  return metrics;
+};
+
+// src/lib/strategyRelease/researchRetention.ts
+var import_node_path2 = __toESM(require("path"));
+var import_node_crypto2 = require("crypto");
 var import_strategyReleaseEvidence = require("@tradejs/infra/strategyReleaseEvidence");
 
 // src/lib/strategyRelease/researchFileConsumers.ts
@@ -235,7 +267,7 @@ var mapFiles = async (entries, visit) => {
     if (worker.status === "rejected") throw worker.reason;
   return results;
 };
-var fileSha256 = async (file, bytes) => bytes <= 1024 * 1024 ? (0, import_node_crypto.createHash)("sha256").update(await import_promises.default.readFile(file)).digest("hex") : (0, import_strategyReleaseEvidence.strategyEvidenceFileSha256)(file);
+var fileSha256 = async (file, bytes) => bytes <= 1024 * 1024 ? (0, import_node_crypto2.createHash)("sha256").update(await import_promises.default.readFile(file)).digest("hex") : (0, import_strategyReleaseEvidence.strategyEvidenceFileSha256)(file);
 var inside = (root, file) => {
   const relative = import_node_path2.default.relative(root, file);
   return relative !== "" && !relative.startsWith(`..${import_node_path2.default.sep}`) && relative !== ".." && !import_node_path2.default.isAbsolute(relative);
@@ -279,13 +311,27 @@ var applyResearchRetention = async (options) => {
         const header = Buffer.alloc(4096);
         const { bytesRead } = await handle.read(header, 0, header.length, 0);
         const frontmatter = header.subarray(0, bytesRead).toString("utf8").match(/^---\r?\n([\s\S]*?)\r?\n---/);
-        if (!frontmatter || !/^schema:\s*tradejs-research\/v1\s*$/m.test(frontmatter[1]) || !(retired ? /^reproduction:\s*(?:complete|partial|blocked|legacy-partial)\s*$/m.test(
+        if (!frontmatter || !/^schema:\s*tradejs-research\/v[12]\s*$/m.test(frontmatter[1]) || !(retired ? /^reproduction:\s*(?:complete|partial|blocked|legacy-partial)\s*$/m.test(
           frontmatter[1]
         ) : /^reproduction:\s*complete\s*$/m.test(frontmatter[1]))) {
           throw new Error(
             `Research note must have reproduction: complete: ${file}`
           );
         }
+        if (!retired && /^schema:\s*tradejs-research\/v2\s*$/m.test(frontmatter[1])) {
+          if ((await import_promises.default.stat(file)).size > 8 * 1024 * 1024)
+            throw new Error("Compact permanent note exceeds 8 MiB");
+          const content = await import_promises.default.readFile(file, "utf8");
+          const section = content.split("## Metrics snapshot (machine-readable)")[1]?.split("## Reported metrics")[0] ?? "";
+          const blocks = [
+            ...section.matchAll(/```json\r?\n([\s\S]*?)\r?\n```/g)
+          ];
+          if (blocks.length !== 1)
+            throw new Error(
+              "Complete v2 note needs one verified metric snapshot"
+            );
+          decodeResearchMetricSnapshot(JSON.parse(blocks[0][1]));
+        }
       } finally {
         await handle.close();
       }
@@ -369,7 +415,7 @@ var applyResearchRetention = async (options) => {
 };
 
 // src/lib/strategyRelease.ts
-var import_node_crypto2 = require("crypto");
+var import_node_crypto3 = require("crypto");
 var import_promises2 = __toESM(require("fs/promises"));
 var import_node_path3 = __toESM(require("path"));
 var import_types2 = require("@tradejs/types");
@@ -1539,7 +1585,7 @@ var verifyCompletedCoreResearchBundle = async ({
   const artifactHashes = manifest.artifactHashes != null && typeof manifest.artifactHashes === "object" && !Array.isArray(manifest.artifactHashes) ? manifest.artifactHashes : null;
   const parsedSpec = JSON.parse(specBytes.toString("utf8"));
   assert2(
-    manifest.schema === "tradejs-core-research-manifest/v1" && manifest.status === "completed" && manifest.researchId === researchId && manifest.specSha256 === specSha256 && artifactHashes?.["result.json"] === resultSha256 && (0, import_node_crypto2.createHash)("sha256").update(canonicalStrategyReleaseJson(parsedSpec)).digest("hex") === specSha256,
+    manifest.schema === "tradejs-core-research-manifest/v1" && manifest.status === "completed" && manifest.researchId === researchId && manifest.specSha256 === specSha256 && artifactHashes?.["result.json"] === resultSha256 && (0, import_node_crypto3.createHash)("sha256").update(canonicalStrategyReleaseJson(parsedSpec)).digest("hex") === specSha256,
     "core result is not bound by its completed core research manifest"
   );
   for (const [relativePath, expectedSha256] of Object.entries(
@@ -1587,12 +1633,18 @@ async function collectReleaseEvidenceReferences(references) {
       }
       const nested = (value) => value != null && typeof value === "object" && !Array.isArray(value) ? value : null;
       const array = (value) => Array.isArray(value) ? value : [];
-      const semanticallyValid = reference.kind === "core_research" ? artifact.schema === "tradejs-core-research-result/v1" || artifact.schema === "tradejs-core-research-manifest/v1" && artifact.status === "completed" : reference.kind === "ai_gate" ? nested(artifact.run)?.mode === "local-deterministic" && nested(artifact.research)?.lineage != null && nested(artifact.outcome) != null : reference.kind === "runtime_parity" ? artifact.reportType === "replay-runtime-evidence" && nested(nested(artifact.replay)?.runtimeComparison) != null : reference.kind === "execution_calibration" ? artifact.reportType === "execution-calibration" && nested(artifact.summary) != null : reference.kind === "runtime_evidence" ? artifact.reportType === "runtime-evidence" : artifact.reportType === "runtime-scorecard";
+      const semanticallyValid = reference.kind === "core_research" ? [
+        "tradejs-core-research-result/v1",
+        "tradejs-core-research-result/v2"
+      ].includes(String(artifact.schema)) || artifact.schema === "tradejs-core-research-manifest/v1" && artifact.status === "completed" : reference.kind === "ai_gate" ? nested(artifact.run)?.mode === "local-deterministic" && nested(artifact.research)?.lineage != null && nested(artifact.outcome) != null : reference.kind === "runtime_parity" ? artifact.reportType === "replay-runtime-evidence" && nested(nested(artifact.replay)?.runtimeComparison) != null : reference.kind === "execution_calibration" ? artifact.reportType === "execution-calibration" && nested(artifact.summary) != null : reference.kind === "runtime_evidence" ? artifact.reportType === "runtime-evidence" : artifact.reportType === "runtime-scorecard";
       assert2(
         semanticallyValid,
         `evidence ${reference.artifactId} does not match ${reference.kind}`
       );
-      if (reference.kind === "core_research" && artifact.schema === "tradejs-core-research-result/v1") {
+      if (reference.kind === "core_research" && [
+        "tradejs-core-research-result/v1",
+        "tradejs-core-research-result/v2"
+      ].includes(String(artifact.schema))) {
         await verifyCompletedCoreResearchBundle({
           artifact,
           resultPath: reference.path,