@tradejs/cli 3.1.29-beta.289 → 3.1.29-beta.291

package/dist/scripts/runtimeFeedbackNotify.js

@@ -39,6 +39,9 @@ var import_node_path = __toESM(require("path"));
 var import_args = __toESM(require("args"));
 var import_chalk = __toESM(require("chalk"));
 
+// src/lib/runtimeFeedbackNotification.ts
+var import_userSettings = require("@tradejs/infra/userSettings");
+
 // src/lib/runtimeFeedbackArtifacts.ts
 var runtimeFeedbackArtifacts_exports = {};
 __reExport(runtimeFeedbackArtifacts_exports, require("@tradejs/node/diagnostics"));
@@ -223,11 +226,14 @@ var notifyRuntimeFeedbackBundle = async ({
 }) => {
   const verified = await (0, runtimeFeedbackArtifacts_exports.verifyRuntimeFeedbackReplayBundle)(bundleDir);
   const message = buildRuntimeFeedbackTelegramMessage(verified.replayEvidence);
-  await send(message, { userName: verified.manifest.userName });
+  const settings = await (0, import_userSettings.getUserSettings)(verified.manifest.userName);
+  const sent = settings.NOTIFY_RUNTIME_DEBUG !== false;
+  if (sent) await send(message, { userName: verified.manifest.userName });
   return {
     artifactId: verified.manifest.artifactId,
     userName: verified.manifest.userName,
-    message
+    message,
+    sent
   };
 };
 
@@ -249,7 +255,9 @@ var runtimeFeedbackNotify = async () => {
   }
   const result = await notifyRuntimeFeedbackBundle({ bundleDir });
   console.log(
-    import_chalk.default.green(`Runtime feedback notification sent: ${result.artifactId}`)
+    import_chalk.default.green(
+      `Runtime feedback notification ${result.sent ? "sent" : "disabled"}: ${result.artifactId}`
+    )
   );
 };
 var main = runtimeFeedbackNotify;

package/dist/scripts/runtimeFeedbackReplay.js

@@ -43,6 +43,7 @@ var import_chalk = __toESM(require("chalk"));
 var import_node_child_process = require("child_process");
 var import_promises = __toESM(require("fs/promises"));
 var import_node_path = __toESM(require("path"));
+var import_mcp = require("@tradejs/node/mcp");
 
 // src/lib/runtimeEvidenceDeployment.ts
 var runtimeEvidenceDeployment_exports = {};
@@ -190,44 +191,58 @@ var runLoggedCommand = async ({
   env,
   logHandle
 }) => {
-  await logHandle.write(`
-$ ${[executable, ...command].join(" ")}
-`);
-  await new Promise((resolve, reject) => {
-    let pendingLogWrite = Promise.resolve();
-    const appendLog = (chunk) => {
-      pendingLogWrite = pendingLogWrite.then(async () => {
-        await logHandle.write(chunk);
-      });
-    };
-    const child = (0, import_node_child_process.spawn)(executable, command, {
-      cwd,
-      env,
-      stdio: ["ignore", "pipe", "pipe"]
-    });
-    child.stdout.on("data", (chunk) => {
-      process.stdout.write(chunk);
-      appendLog(chunk);
-    });
-    child.stderr.on("data", (chunk) => {
-      process.stderr.write(chunk);
-      appendLog(chunk);
-    });
+  await logHandle.writeFile(
+    "\n" + (0, import_mcp.formatMcpArtifactLogLine)(`$ ${[executable, ...command].join(" ")}`)
+  );
+  const child = (0, import_node_child_process.spawn)(executable, command, {
+    cwd,
+    env,
+    stdio: ["ignore", "pipe", "pipe"]
+  });
+  const exit = new Promise((resolve, reject) => {
     child.once("error", reject);
     child.once("close", (code, signal) => {
-      void pendingLogWrite.then(() => {
-        if (code === 0) {
-          resolve();
-          return;
-        }
+      if (code === 0) resolve();
+      else {
         reject(
           new Error(
             `Runtime feedback command failed: exit=${String(code)} signal=${String(signal)}`
           )
         );
-      }, reject);
+      }
     });
   });
+  let pendingLogWrite = Promise.resolve();
+  const copyLog = async (input, output) => {
+    const writeLine = async (line) => {
+      const formatted = (0, import_mcp.formatMcpArtifactLogLine)(line);
+      pendingLogWrite = pendingLogWrite.then(
+        () => logHandle.writeFile(formatted)
+      );
+      await pendingLogWrite;
+      output.write(formatted);
+    };
+    let pendingLine = "";
+    try {
+      for await (const chunk of input.setEncoding("utf8")) {
+        const lines = (pendingLine + chunk).split("\n");
+        pendingLine = lines.pop() ?? "";
+        for (const line of lines) await writeLine(line);
+      }
+      if (pendingLine) await writeLine(pendingLine);
+    } catch (error) {
+      child.kill();
+      throw error;
+    }
+  };
+  const results = await Promise.allSettled([
+    copyLog(child.stdout, process.stdout),
+    copyLog(child.stderr, process.stderr),
+    exit
+  ]);
+  for (const result of results) {
+    if (result.status === "rejected") throw result.reason;
+  }
 };
 var runRuntimeFeedbackReplay = async ({
   runtimeEvidencePath,

package/dist/scripts/runtimeParity.js

@@ -159,6 +159,7 @@ var extractRuntimeParityEntries = (trades) => trades.filter(
   direction: trade.direction,
   qty: toFiniteNumberOrNull(trade.qty),
   timestamp: trade.entryTimestamp,
+  ...Number.isFinite(trade.signalTimestamp) ? { signalTimestamp: trade.signalTimestamp } : {},
   price: toFiniteNumberOrNull(trade.entryPrice),
   orderId: trade.orderId,
   signalId: typeof trade.signalId === "string" ? trade.signalId : void 0,

package/dist/scripts/signalsSummary.js

@@ -35,6 +35,7 @@ __export(signalsSummary_exports, {
 });
 module.exports = __toCommonJS(signalsSummary_exports);
 var import_config = require("dotenv/config");
+var import_userSettings = require("@tradejs/infra/userSettings");
 var import_args = __toESM(require("args"));
 var import_logger = require("@tradejs/infra/logger");
 var import_connectors = require("@tradejs/node/connectors");
@@ -1295,6 +1296,7 @@ none`
   };
 };
 var signalsSummary = async () => {
+  const includeDebug = flags.printOnly || (await (0, import_userSettings.getUserSettings)(flags.user)).NOTIFY_RUNTIME_DEBUG !== false;
   const hours = Math.max(
     1,
     Number.parseInt(String(flags.hours ?? 24), 10) || 24
@@ -1415,18 +1417,15 @@ var signalsSummary = async () => {
       content: signalsMessage,
       deploymentId: scope.deploymentId
     });
-    const tradesMessageWithAttachmentSummary = appendReportAttachmentSummary({
+    const tradesMessageWithAttachmentSummary = includeDebug ? appendReportAttachmentSummary({
       message: tradesMessage,
       signalsFilename: signalsAttachment.filename,
       filename: debugAttachment?.filename,
       tradesCount: debugAttachment ? scopeTrades.length : void 0,
       signalsCount: debugAttachment ? debugAttachment.summary?.signals ?? debugSignals.length : void 0,
       evaluationsCount: debugAttachment ? debugAttachment.summary?.evaluations ?? 0 : void 0
-    });
-    const attachments = [
-      signalsAttachment,
-      ...debugAttachment ? [debugAttachment] : []
-    ];
+    }) : tradesMessage;
+    const attachments = includeDebug ? [signalsAttachment, ...debugAttachment ? [debugAttachment] : []] : [];
     if (flags.printOnly) {
       console.log(tradesMessageWithAttachmentSummary);
       console.log("");

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,