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

package/dist/scripts/strategyRelease.js

@@ -42,40 +42,9 @@ var import_chalk = __toESM(require("chalk"));
 
 // src/lib/strategyRelease/researchRetention.ts
 var import_promises = __toESM(require("fs/promises"));
-
-// 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_researchMetricSnapshot = require("@tradejs/infra/researchMetricSnapshot");
 var import_node_path2 = __toESM(require("path"));
-var import_node_crypto2 = require("crypto");
+var import_node_crypto = require("crypto");
 var import_strategyReleaseEvidence = require("@tradejs/infra/strategyReleaseEvidence");
 
 // src/lib/strategyRelease/researchFileConsumers.ts
@@ -267,7 +236,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_crypto2.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_crypto.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);
@@ -330,7 +299,7 @@ var applyResearchRetention = async (options) => {
             throw new Error(
               "Complete v2 note needs one verified metric snapshot"
             );
-          decodeResearchMetricSnapshot(JSON.parse(blocks[0][1]));
+          (0, import_researchMetricSnapshot.decodeResearchMetricSnapshot)(JSON.parse(blocks[0][1]));
         }
       } finally {
         await handle.close();
@@ -415,7 +384,7 @@ var applyResearchRetention = async (options) => {
 };
 
 // src/lib/strategyRelease.ts
-var import_node_crypto3 = require("crypto");
+var import_node_crypto2 = require("crypto");
 var import_promises2 = __toESM(require("fs/promises"));
 var import_node_path3 = __toESM(require("path"));
 var import_types2 = require("@tradejs/types");
@@ -1585,7 +1554,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_crypto3.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_crypto2.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(

package/dist/scripts/strategyResearch.js

@@ -168,10 +168,10 @@ var init_io = __esm({
     sha256Text = (value) => (0, import_node_crypto.createHash)("sha256").update(value).digest("hex");
     sha256Json = (value) => sha256Text(canonicalJson(value));
     sha256File = async (filePath) => {
-      const hash2 = (0, import_node_crypto.createHash)("sha256");
+      const hash = (0, import_node_crypto.createHash)("sha256");
       const input = (0, import_node_fs2.createReadStream)(filePath);
-      for await (const chunk of input) hash2.update(chunk);
-      return hash2.digest("hex");
+      for await (const chunk of input) hash.update(chunk);
+      return hash.digest("hex");
     };
     assertFinite = (value, name) => {
       assert(typeof value === "number" && Number.isFinite(value), name);
@@ -451,14 +451,14 @@ __export(io_exports, {
   verifyResearchState: () => verifyResearchState,
   withResearchLock: () => withResearchLock
 });
-var import_promises2, import_node_path3, import_node_os, import_node_crypto3, researchDirectory, readJson, boundResearchPath, withResearchLock, verifyResearchState, verifyCompletedResearch, initializeResearchState, isRetainedDeletion;
+var import_promises2, import_node_path3, import_node_os, import_node_crypto2, researchDirectory, readJson, boundResearchPath, withResearchLock, verifyResearchState, verifyCompletedResearch, initializeResearchState, isRetainedDeletion;
 var init_io2 = __esm({
   "src/lib/strategyResearch/io.ts"() {
     "use strict";
     import_promises2 = __toESM(require("fs/promises"));
     import_node_path3 = __toESM(require("path"));
     import_node_os = __toESM(require("os"));
-    import_node_crypto3 = require("crypto");
+    import_node_crypto2 = require("crypto");
     init_io();
     researchDirectory = (projectRoot, spec) => import_node_path3.default.join(projectRoot, "data/research/strategy", spec.core.researchId);
     readJson = async (file) => JSON.parse(await import_promises2.default.readFile(file, "utf8"));
@@ -487,7 +487,7 @@ var init_io2 = __esm({
         "data/research/strategy/.lock"
       );
       await import_promises2.default.mkdir(import_node_path3.default.dirname(file), { recursive: true });
-      const token = (0, import_node_crypto3.randomUUID)();
+      const token = (0, import_node_crypto2.randomUUID)();
       const acquire = () => import_promises2.default.writeFile(
         file,
         JSON.stringify({ pid: process.pid, host: import_node_os.default.hostname(), token }),
@@ -583,15 +583,15 @@ var init_io2 = __esm({
       await writeJsonAtomic(file, state);
       return state;
     };
-    isRetainedDeletion = async (directory, file, hash2) => {
+    isRetainedDeletion = async (directory, file, hash) => {
       try {
         const inventory = await readJson(import_node_path3.default.join(directory, "retention.json"));
         const index = inventory.entries.findIndex(
-          (entry) => entry.path === file && entry.sha256 === hash2
+          (entry) => entry.path === file && entry.sha256 === hash
         );
         if (index < 0) return false;
         const receipt = await readJson(import_node_path3.default.join(directory, "retention", `${index}.json`));
-        return ["applying", "completed"].includes(receipt.status) && receipt.files[0]?.path === file && receipt.files[0]?.sha256 === hash2;
+        return ["applying", "completed"].includes(receipt.status) && receipt.files[0]?.path === file && receipt.files[0]?.sha256 === hash;
       } catch (error) {
         if (error.code === "ENOENT") return false;
         throw error;
@@ -1927,15 +1927,15 @@ var createPocketResult = (rows, predicates, mask, validationRows, testRows, obje
   };
 };
 var hashMask = (mask) => {
-  let hash2 = 2166136261;
+  let hash = 2166136261;
   for (let index = 0; index < mask.length; index += 1) {
     if (mask[index] !== 1) {
       continue;
     }
-    hash2 ^= index + 1;
-    hash2 = Math.imul(hash2, 16777619);
+    hash ^= index + 1;
+    hash = Math.imul(hash, 16777619);
   }
-  return (hash2 >>> 0).toString(36);
+  return (hash >>> 0).toString(36);
 };
 var isBetterRepresentativePocket = (candidate, existing, compare) => candidate.depth < existing.depth || candidate.depth === existing.depth && candidate.condition.length < existing.condition.length || candidate.depth === existing.depth && candidate.condition.length === existing.condition.length && compare(candidate, existing) < 0;
 var estimateCombinationCount = (poolSize, maxDepth, maxCombinations) => {
@@ -2632,51 +2632,7 @@ var policyVariant = (spec, coreId, policy, id, jev) => {
 
 // src/lib/strategyResearch/orchestrator.ts
 var import_promises5 = __toESM(require("fs/promises"));
-
-// src/lib/researchMetricSnapshot.ts
-var import_node_crypto2 = require("crypto");
-var import_node_zlib = require("zlib");
-var MAX_BYTES = 256 * 1024 * 1024;
-var hash = (bytes) => (0, import_node_crypto2.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 encodeResearchMetricSnapshot = (metrics) => {
-  validatePermanentResearchMetrics(metrics);
-  const bytes = Buffer.from(JSON.stringify(metrics));
-  if (bytes.length > MAX_BYTES)
-    throw new Error("Metric snapshot exceeds decoded size limit");
-  return {
-    schema: "tradejs-metric-snapshot/v1",
-    encoding: "gzip+base64",
-    decodedBytes: bytes.length,
-    sha256: hash(bytes),
-    payload: (0, import_node_zlib.gzipSync)(bytes, { level: 9 }).toString("base64")
-  };
-};
-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/strategyResearch/orchestrator.ts
+var import_researchMetricSnapshot2 = require("@tradejs/infra/researchMetricSnapshot");
 var import_node_path7 = __toESM(require("path"));
 
 // src/lib/coreResearch/metrics.ts
@@ -3882,8 +3838,9 @@ var import_node_path6 = __toESM(require("path"));
 
 // src/lib/strategyRelease/researchRetention.ts
 var import_promises3 = __toESM(require("fs/promises"));
+var import_researchMetricSnapshot = require("@tradejs/infra/researchMetricSnapshot");
 var import_node_path5 = __toESM(require("path"));
-var import_node_crypto4 = require("crypto");
+var import_node_crypto3 = require("crypto");
 var import_strategyReleaseEvidence = require("@tradejs/infra/strategyReleaseEvidence");
 
 // src/lib/strategyRelease/researchFileConsumers.ts
@@ -4032,7 +3989,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_crypto4.createHash)("sha256").update(await import_promises3.default.readFile(file)).digest("hex") : (0, import_strategyReleaseEvidence.strategyEvidenceFileSha256)(file);
+var fileSha256 = async (file, bytes) => bytes <= 1024 * 1024 ? (0, import_node_crypto3.createHash)("sha256").update(await import_promises3.default.readFile(file)).digest("hex") : (0, import_strategyReleaseEvidence.strategyEvidenceFileSha256)(file);
 var inside = (root, file) => {
   const relative = import_node_path5.default.relative(root, file);
   return relative !== "" && !relative.startsWith(`..${import_node_path5.default.sep}`) && relative !== ".." && !import_node_path5.default.isAbsolute(relative);
@@ -4095,7 +4052,7 @@ var applyResearchRetention = async (options) => {
             throw new Error(
               "Complete v2 note needs one verified metric snapshot"
             );
-          decodeResearchMetricSnapshot(JSON.parse(blocks[0][1]));
+          (0, import_researchMetricSnapshot.decodeResearchMetricSnapshot)(JSON.parse(blocks[0][1]));
         }
       } finally {
         await handle.close();
@@ -4210,11 +4167,11 @@ var createResearchRetentionInventory = async (projectRoot, directory, spec, stat
   }
   const files = /* @__PURE__ */ new Map();
   for (const stage of Object.values(state.stages)) {
-    for (const [relative, hash2] of Object.entries(stage.artifacts)) {
+    for (const [relative, hash] of Object.entries(stage.artifacts)) {
       const file = await boundResearchPath(directory, relative);
       if (relative.endsWith("/result.json")) {
         const result = await readJson(file);
-        if (result?.dataset) files.set(file, hash2);
+        if (result?.dataset) files.set(file, hash);
       }
       if (relative.endsWith("/sources.json") || relative.endsWith("/payloads.json")) {
         const sources = await readJson(file);
@@ -4231,13 +4188,13 @@ var createResearchRetentionInventory = async (projectRoot, directory, spec, stat
     }
   }
   const entries = [];
-  for (const [file, hash2] of files) {
+  for (const [file, hash] of files) {
     const stat = await import_promises4.default.stat(file);
     entries.push({
       path: file,
       kind: "research_payload",
       researchId: spec.core.researchId,
-      sha256: hash2,
+      sha256: hash,
       bytes: stat.size,
       createdAt: stat.birthtimeMs,
       verified: true,
@@ -4497,7 +4454,7 @@ var runStrategyResearch = async (parameters) => {
       });
       let partitionControl;
       if (spec.testSince === 0) {
-        const control2 = spec.core.variants.find(
+        const control = spec.core.variants.find(
           (variant) => variant.role === "control"
         );
         partitionControl = await stage(
@@ -4514,7 +4471,7 @@ var runStrategyResearch = async (parameters) => {
             }
             return backend.runVariant(
               spec,
-              control2,
+              control,
               folder,
               async (runId) => writeJsonAtomic(import_node_path7.default.join(folder, "native-run.json"), {
                 runId
@@ -4536,9 +4493,6 @@ var runStrategyResearch = async (parameters) => {
       let frozenSelection;
       const raw = {};
       const discovered = [];
-      const control = spec.core.variants.find(
-        (variant) => variant.role === "control"
-      );
       const currentPolicy = {
         schema: "tradejs-research-entry-policy/v1",
         strategy: spec.core.strategy,
@@ -5014,7 +4968,7 @@ ${JSON.stringify(spec, null, 2)}
 ## Metrics snapshot (machine-readable)
 
 \`\`\`json
-${JSON.stringify(encodeResearchMetricSnapshot(compact))}
+${JSON.stringify((0, import_researchMetricSnapshot2.encodeResearchMetricSnapshot)(compact))}
 \`\`\`
 
 ## Reported metrics
@@ -5144,7 +5098,7 @@ var import_registry = require("@tradejs/node/registry");
 var import_connectors = require("@tradejs/node/connectors");
 
 // src/lib/coreResearch/dataset.ts
-var import_node_crypto5 = require("crypto");
+var import_node_crypto4 = require("crypto");
 var import_node_fs3 = require("fs");
 var import_node_path8 = __toESM(require("path"));
 var import_node_readline2 = __toESM(require("readline"));
@@ -5359,8 +5313,8 @@ var readCoreResearchVariant = async (variant) => {
   for (const inputPath of variant.files) {
     const filePath = import_node_path8.default.resolve(inputPath);
     const input = (0, import_node_fs3.createReadStream)(filePath);
-    const hash2 = (0, import_node_crypto5.createHash)("sha256");
-    input.on("data", (chunk) => hash2.update(chunk));
+    const hash = (0, import_node_crypto4.createHash)("sha256");
+    input.on("data", (chunk) => hash.update(chunk));
     const lines = import_node_readline2.default.createInterface({ input, crlfDelay: Infinity });
     const fileTrades = [];
     let lineNumber = 0;
@@ -5410,7 +5364,7 @@ var readCoreResearchVariant = async (variant) => {
       trades.push(trade);
       fileTrades.push(trade);
     }
-    const fileSha2562 = hash2.digest("hex");
+    const fileSha2562 = hash.digest("hex");
     for (const trade of fileTrades) trade.sourceSha256 = fileSha2562;
     sources.push({
       path: filePath,
@@ -5430,7 +5384,7 @@ var readCoreResearchVariant = async (variant) => {
 };
 
 // src/lib/backtest/checkpoint.ts
-var import_node_crypto6 = require("crypto");
+var import_node_crypto5 = require("crypto");
 var import_constants = require("@tradejs/core/constants");
 var import_backtest2 = require("@tradejs/core/backtest");
 var import_redis = require("@tradejs/infra/redis");
@@ -5644,7 +5598,7 @@ init_io2();
 
 // src/lib/aiTrainResearch.ts
 var import_node_child_process2 = require("child_process");
-var import_node_crypto8 = require("crypto");
+var import_node_crypto7 = require("crypto");
 var import_promises7 = __toESM(require("fs/promises"));
 var import_node_path10 = __toESM(require("path"));
 
@@ -5656,7 +5610,7 @@ var import_strategies = require("@tradejs/node/strategies");
 var import_types2 = require("@tradejs/types");
 
 // src/lib/strategyGateFingerprint.ts
-var import_node_crypto7 = require("crypto");
+var import_node_crypto6 = require("crypto");
 var import_node_module = require("module");
 var import_promises6 = __toESM(require("fs/promises"));
 var import_node_path9 = __toESM(require("path"));
@@ -5700,7 +5654,7 @@ var normalizeForStableJson = (value) => {
   }
   return value;
 };
-var fingerprintResearchValue = (value) => (0, import_node_crypto8.createHash)("sha256").update(JSON.stringify(normalizeForStableJson(value))).digest("hex").slice(0, 16);
+var fingerprintResearchValue = (value) => (0, import_node_crypto7.createHash)("sha256").update(JSON.stringify(normalizeForStableJson(value))).digest("hex").slice(0, 16);
 var fingerprintResearchContextEnvironment = (env = process.env) => fingerprintResearchValue(
   Object.fromEntries(
     RESEARCH_CONTEXT_ENV_KEYS.map((key) => [key, env[key] ?? null])
@@ -6667,7 +6621,7 @@ init_io();
 var import_promises11 = __toESM(require("fs/promises"));
 var import_node_path15 = __toESM(require("path"));
 var import_node_child_process4 = require("child_process");
-var import_node_crypto10 = require("crypto");
+var import_node_crypto9 = require("crypto");
 var import_coreResearch2 = require("@tradejs/infra/coreResearch");
 
 // src/lib/coreResearch/artifacts.ts
@@ -6681,7 +6635,7 @@ init_io();
 init_io();
 
 // src/lib/coreResearch/statistics.ts
-var import_node_crypto9 = require("crypto");
+var import_node_crypto8 = require("crypto");
 
 // src/lib/coreResearch/orchestrator.ts
 init_trace();
@@ -6720,7 +6674,7 @@ var createCoreResearchSpecTemplate = (params) => {
         gitSha,
         ...sourceRepository ? { sourceRepository } : {},
         ...dirtyDiff ? {
-          dirtyDiffSha256: (0, import_node_crypto10.createHash)("sha256").update(dirtyDiff).digest("hex")
+          dirtyDiffSha256: (0, import_node_crypto9.createHash)("sha256").update(dirtyDiff).digest("hex")
         } : {}
       };
     } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/cli",
-  "version": "3.1.29-beta.292",
+  "version": "3.1.29-beta.296",
   "description": "Official CLI for the TradeJS TypeScript framework: infra setup, backtests, signals, bots, and ML workflows.",
   "keywords": [
     "tradejs",
@@ -37,13 +37,13 @@
     "tradejs": "dist/cli.js"
   },
   "dependencies": {
-    "@tradejs/connectors": "^3.1.29-beta.292",
-    "@tradejs/core": "^3.1.29-beta.292",
-    "@tradejs/indicators": "^3.1.29-beta.292",
-    "@tradejs/infra": "^3.1.29-beta.292",
-    "@tradejs/node": "^3.1.29-beta.292",
+    "@tradejs/connectors": "^3.1.29-beta.296",
+    "@tradejs/core": "^3.1.29-beta.296",
+    "@tradejs/indicators": "^3.1.29-beta.296",
+    "@tradejs/infra": "^3.1.29-beta.296",
+    "@tradejs/node": "^3.1.29-beta.296",
     "@tradejs/strategy-kit": "3.0.6",
-    "@tradejs/types": "^3.1.29-beta.292",
+    "@tradejs/types": "^3.1.29-beta.296",
     "args": "^5.0.3",
     "bcryptjs": "^2.4.3",
     "chalk": "4.1.2",

package/dist/lib/researchMetricSnapshot.js

@@ -1,74 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/lib/researchMetricSnapshot.ts
-var researchMetricSnapshot_exports = {};
-__export(researchMetricSnapshot_exports, {
-  decodeResearchMetricSnapshot: () => decodeResearchMetricSnapshot,
-  encodeResearchMetricSnapshot: () => encodeResearchMetricSnapshot,
-  validatePermanentResearchMetrics: () => validatePermanentResearchMetrics
-});
-module.exports = __toCommonJS(researchMetricSnapshot_exports);
-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 encodeResearchMetricSnapshot = (metrics) => {
-  validatePermanentResearchMetrics(metrics);
-  const bytes = Buffer.from(JSON.stringify(metrics));
-  if (bytes.length > MAX_BYTES)
-    throw new Error("Metric snapshot exceeds decoded size limit");
-  return {
-    schema: "tradejs-metric-snapshot/v1",
-    encoding: "gzip+base64",
-    decodedBytes: bytes.length,
-    sha256: hash(bytes),
-    payload: (0, import_node_zlib.gzipSync)(bytes, { level: 9 }).toString("base64")
-  };
-};
-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;
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  decodeResearchMetricSnapshot,
-  encodeResearchMetricSnapshot,
-  validatePermanentResearchMetrics
-});