@tradejs/cli 3.1.27-beta.249 → 3.1.27-beta.250

package/dist/scripts/signalsDaemon.js

@@ -49,7 +49,7 @@ var import_constants3 = require("@tradejs/core/constants");
 var import_time3 = require("@tradejs/core/time");
 var import_logger4 = require("@tradejs/infra/logger");
 var import_runtimeHeartbeats = require("@tradejs/infra/runtimeHeartbeats");
-var import_runtimeStrategies2 = require("@tradejs/node/runtimeStrategies");
+var import_runtimeStrategies3 = require("@tradejs/node/runtimeStrategies");
 
 // src/lib/marketData/windows.ts
 var import_indicators = require("@tradejs/core/indicators");
@@ -2148,27 +2148,27 @@ var createCoinMarketCapFetchStats = () => ({
   totalCredits: 0,
   byPath: /* @__PURE__ */ new Map()
 });
-var getCoinMarketCapPathLabel = (path) => {
-  if (path.includes("global-metrics")) return "global";
-  if (path.includes("cryptocurrency/quotes")) return "reference";
-  if (path.includes("exchange/quotes")) return "exchangeLiquidity";
-  if (path.includes("fear-and-greed")) return "fearGreed";
-  if (path.includes("cmc100")) return "cmc100";
-  if (path.includes("cmc20")) return "cmc20";
-  return path;
-};
-var recordCoinMarketCapFetchStats = (stats, path, creditCount) => {
+var getCoinMarketCapPathLabel = (path3) => {
+  if (path3.includes("global-metrics")) return "global";
+  if (path3.includes("cryptocurrency/quotes")) return "reference";
+  if (path3.includes("exchange/quotes")) return "exchangeLiquidity";
+  if (path3.includes("fear-and-greed")) return "fearGreed";
+  if (path3.includes("cmc100")) return "cmc100";
+  if (path3.includes("cmc20")) return "cmc20";
+  return path3;
+};
+var recordCoinMarketCapFetchStats = (stats, path3, creditCount) => {
   if (!stats) return;
-  const existing = stats.byPath.get(path) ?? { requests: 0, credits: 0 };
+  const existing = stats.byPath.get(path3) ?? { requests: 0, credits: 0 };
   existing.requests += 1;
   existing.credits += creditCount ?? 0;
   stats.requests += 1;
   stats.totalCredits += creditCount ?? 0;
-  stats.byPath.set(path, existing);
+  stats.byPath.set(path3, existing);
 };
 var formatCoinMarketCapFetchStats = (stats) => {
   const byPath = [...stats.byPath.entries()].map(
-    ([path, item]) => `${getCoinMarketCapPathLabel(path)}=${item.requests}req/${item.credits}cr`
+    ([path3, item]) => `${getCoinMarketCapPathLabel(path3)}=${item.requests}req/${item.credits}cr`
   ).join(" ");
   return `apiRequests=${stats.requests} apiCredits=${stats.totalCredits}${byPath ? ` ${byPath}` : ""}`;
 };
@@ -4929,6 +4929,368 @@ var buildConfiguredSignalsScopes = ({
   }));
 };
 
+// src/lib/runtimeEvidenceCompositionSnapshots.ts
+var import_node_crypto3 = require("crypto");
+var import_promises2 = __toESM(require("fs/promises"));
+var import_node_path2 = __toESM(require("path"));
+
+// src/lib/runtimeEvidenceDeployment.ts
+var import_runtimeStrategies2 = require("@tradejs/node/runtimeStrategies");
+var isRecord = (value) => value != null && typeof value === "object" && !Array.isArray(value);
+var isNonEmptyString = (value) => typeof value === "string" && value.trim().length > 0;
+var isPackageVersionMap = (value) => isRecord(value) && Object.keys(value).length > 0 && Object.entries(value).every(
+  ([name, version]) => name.startsWith("@tradejs/") && isNonEmptyString(version)
+);
+var INTERVALS = /* @__PURE__ */ new Set([
+  "1",
+  "3",
+  "5",
+  "15",
+  "30",
+  "60",
+  "120",
+  "240",
+  "360",
+  "720",
+  "D",
+  "W",
+  "M"
+]);
+var UNIVERSES = /* @__PURE__ */ new Set(["crypto", "tradfi"]);
+var isRuntimeStrategySelection = (value) => value === void 0 || isRecord(value) && Object.keys(value).length === 1 && Object.keys(value).every((key) => key === "tickers") && Array.isArray(value.tickers) && value.tickers.length > 0 && value.tickers.every((ticker) => isNonEmptyString(ticker));
+var parseRuntimeEvidenceDeploymentSnapshot = (value) => {
+  if (!isRecord(value) || value.schemaVersion !== 2 || !isNonEmptyString(value.id) || !isNonEmptyString(value.deploymentCompositionId) || !/^dc1:[a-f0-9]{16}$/.test(value.deploymentCompositionId) || !isNonEmptyString(value.label) || !isNonEmptyString(value.connectorName) || !isNonEmptyString(value.provider) || !isNonEmptyString(value.accountId) || typeof value.enabled !== "boolean" || !Array.isArray(value.strategies)) {
+    throw new Error(
+      "Runtime evidence deployment snapshot is missing or invalid"
+    );
+  }
+  const strategies = value.strategies.map((candidate) => {
+    if (!isRecord(candidate) || !isNonEmptyString(candidate.strategyName) || !isNonEmptyString(candidate.strategyRevision) || !/^sr1:[a-f0-9]{16}$/.test(candidate.strategyRevision) || typeof candidate.enabled !== "boolean" || !["active", "entries_paused"].includes(String(candidate.controlState)) || !INTERVALS.has(String(candidate.interval)) || !UNIVERSES.has(String(candidate.universe)) || !isNonEmptyString(candidate.strategyPackage) || !isNonEmptyString(candidate.strategyPackageVersion) || !isPackageVersionMap(candidate.strategyDependencyVersions) || !isNonEmptyString(candidate.runtimePackageVersion) || !isRecord(candidate.strategyConfig) || !isRuntimeStrategySelection(candidate.selection)) {
+      throw new Error(
+        "Runtime evidence deployment strategy snapshot is invalid"
+      );
+    }
+    if (String(candidate.strategyConfig.INTERVAL) !== String(candidate.interval) || String(candidate.strategyConfig.UNIVERSE) !== String(candidate.universe)) {
+      throw new Error(
+        `Runtime evidence strategy config does not match its scope: ${candidate.strategyName}`
+      );
+    }
+    if (candidate.accountId != null && (!isNonEmptyString(candidate.accountId) || candidate.accountId !== value.accountId)) {
+      throw new Error(
+        `Runtime evidence strategy account does not match deployment: ${candidate.strategyName}`
+      );
+    }
+    return candidate;
+  });
+  const identities = /* @__PURE__ */ new Set();
+  for (const strategy of strategies) {
+    if (identities.has(strategy.strategyName)) {
+      throw new Error(
+        `Duplicate runtime evidence strategy: ${strategy.strategyName}`
+      );
+    }
+    identities.add(strategy.strategyName);
+  }
+  return {
+    ...value,
+    strategies
+  };
+};
+var resolveRuntimeEvidenceDeploymentSnapshot = async ({
+  userName,
+  projectRoot,
+  deploymentId
+}) => {
+  const [deployment, strategies] = await Promise.all([
+    (0, import_runtimeStrategies2.getRuntimeDeployment)({ userName, projectRoot, deploymentId }),
+    (0, import_runtimeStrategies2.loadResolvedRuntimeStrategies)({ userName, projectRoot, deploymentId })
+  ]);
+  if (!deployment) {
+    throw new Error(`Runtime deployment not found: ${deploymentId}`);
+  }
+  return {
+    schemaVersion: 2,
+    id: deployment.id,
+    deploymentCompositionId: deployment.deploymentCompositionId,
+    label: deployment.label,
+    connectorName: deployment.connectorName,
+    provider: deployment.provider,
+    accountId: deployment.accountId,
+    enabled: deployment.enabled,
+    strategies: strategies.map(
+      ({
+        strategyName,
+        strategyRevision,
+        enabled,
+        controlState,
+        interval,
+        universe,
+        accountId,
+        strategyPackage,
+        strategyPackageVersion,
+        strategyDependencyVersions,
+        runtimePackageVersion,
+        strategyConfig,
+        selection
+      }) => ({
+        strategyName,
+        strategyRevision,
+        enabled,
+        controlState,
+        interval,
+        universe,
+        ...accountId ? { accountId } : {},
+        strategyPackage,
+        strategyPackageVersion,
+        strategyDependencyVersions,
+        runtimePackageVersion,
+        strategyConfig,
+        ...selection ? { selection } : {}
+      })
+    ),
+    ...deployment.assetClasses ? { assetClasses: [...deployment.assetClasses] } : {},
+    ...deployment.tickers ? { tickers: [...deployment.tickers] } : {}
+  };
+};
+
+// src/lib/runtimeEvidenceProducer.ts
+var import_node_crypto2 = require("crypto");
+var import_promises = __toESM(require("fs/promises"));
+var import_node_path = __toESM(require("path"));
+var isRecord2 = (value) => value != null && typeof value === "object" && !Array.isArray(value);
+var sha256 = (value) => (0, import_node_crypto2.createHash)("sha256").update(value).digest("hex");
+var parseRuntimeEvidenceProducer = (value) => {
+  const producer = isRecord2(value) ? value : null;
+  const runtimePackageManifest = isRecord2(producer?.runtimePackageManifest) ? producer.runtimePackageManifest : null;
+  if (producer?.schemaVersion !== 1 || typeof producer.projectSha !== "string" || !/^[a-f0-9]{40}$/.test(producer.projectSha) || typeof producer.imageDigest !== "string" || !/^sha256:[a-f0-9]{64}$/.test(producer.imageDigest) || runtimePackageManifest?.file !== "runtime-package-manifest.json" || typeof runtimePackageManifest.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(runtimePackageManifest.sha256)) {
+    throw new Error("Runtime evidence producer image identity is invalid");
+  }
+  return producer;
+};
+var resolveRuntimeEvidenceProducer = async ({
+  projectRoot,
+  required
+}) => {
+  const projectSha = String(process.env.TRADEJS_PROJECT_SHA ?? "").trim();
+  const imageDigest = String(
+    process.env.TRADEJS_PROJECT_IMAGE_DIGEST ?? ""
+  ).trim();
+  if (!projectSha && !imageDigest && !required) {
+    return null;
+  }
+  if (!/^[a-f0-9]{40}$/.test(projectSha)) {
+    throw new Error(
+      "TRADEJS_PROJECT_SHA must be a full lowercase Git SHA before publishing runtime evidence"
+    );
+  }
+  if (!/^sha256:[a-f0-9]{64}$/.test(imageDigest)) {
+    throw new Error(
+      "TRADEJS_PROJECT_IMAGE_DIGEST must be an immutable sha256 digest before publishing runtime evidence"
+    );
+  }
+  const manifestPath = import_node_path.default.join(projectRoot, "runtime-package-manifest.json");
+  let manifest;
+  try {
+    manifest = await import_promises.default.readFile(manifestPath);
+  } catch (error) {
+    if (!required && error.code === "ENOENT") {
+      return null;
+    }
+    throw new Error(
+      `Runtime package manifest is required for runtime evidence: ${manifestPath}`,
+      { cause: error }
+    );
+  }
+  return {
+    schemaVersion: 1,
+    projectSha,
+    imageDigest,
+    runtimePackageManifest: {
+      file: "runtime-package-manifest.json",
+      sha256: sha256(manifest)
+    }
+  };
+};
+
+// src/lib/runtimeEvidenceCompositionSnapshots.ts
+var SNAPSHOT_FILE = "snapshot.json";
+var MANIFEST_FILE = "manifest.json";
+var COMPLETE_FILE = ".complete";
+var createRuntimeEvidenceCompositionSnapshotRecorder = ({
+  persist,
+  onError
+}) => {
+  const completed = /* @__PURE__ */ new Set();
+  const inFlight = /* @__PURE__ */ new Set();
+  return {
+    observe(compositionId) {
+      if (completed.has(compositionId) || inFlight.has(compositionId)) return;
+      inFlight.add(compositionId);
+      void Promise.resolve().then(() => persist(compositionId)).then(() => completed.add(compositionId)).catch((error) => onError(compositionId, error)).finally(() => inFlight.delete(compositionId));
+    }
+  };
+};
+var isRecord3 = (value) => value != null && typeof value === "object" && !Array.isArray(value);
+var sha2562 = (value) => (0, import_node_crypto3.createHash)("sha256").update(value).digest("hex");
+var safeSegment = (value, label) => {
+  const normalized = value.trim();
+  if (!normalized || !/^[a-zA-Z0-9._:-]+$/.test(normalized)) {
+    throw new Error(`Invalid runtime evidence snapshot ${label}`);
+  }
+  return normalized;
+};
+var isExistingDestinationError = (error) => {
+  const code = error.code;
+  return code === "EEXIST" || code === "ENOTEMPTY";
+};
+var parseManifest = (value) => {
+  const manifest = isRecord3(value) ? value : null;
+  const payload = isRecord3(manifest?.payload) ? manifest.payload : null;
+  if (manifest?.schemaVersion !== 1 || manifest.reportType !== "runtime-evidence-composition-snapshot" || typeof manifest.createdAt !== "number" || typeof manifest.userName !== "string" || typeof manifest.deploymentId !== "string" || typeof manifest.deploymentCompositionId !== "string" || payload?.file !== SNAPSHOT_FILE || typeof payload.sha256 !== "string" || !/^[a-f0-9]{64}$/.test(payload.sha256) || typeof payload.bytes !== "number") {
+    throw new Error("Invalid runtime evidence composition snapshot manifest");
+  }
+  return manifest;
+};
+var verifyRuntimeEvidenceCompositionSnapshot = async (bundleDir) => {
+  const [manifestText, payload, completeText] = await Promise.all([
+    import_promises2.default.readFile(import_node_path2.default.join(bundleDir, MANIFEST_FILE), "utf8"),
+    import_promises2.default.readFile(import_node_path2.default.join(bundleDir, SNAPSHOT_FILE)),
+    import_promises2.default.readFile(import_node_path2.default.join(bundleDir, COMPLETE_FILE), "utf8")
+  ]);
+  const manifest = parseManifest(JSON.parse(manifestText));
+  if (completeText.trim() !== manifest.deploymentCompositionId) {
+    throw new Error(`Invalid completion marker in ${bundleDir}`);
+  }
+  if (payload.byteLength !== manifest.payload.bytes || sha2562(payload) !== manifest.payload.sha256) {
+    throw new Error(
+      `Runtime evidence snapshot checksum mismatch in ${bundleDir}`
+    );
+  }
+  const value = JSON.parse(payload.toString("utf8"));
+  const record = isRecord3(value) ? value : null;
+  if (record?.schemaVersion !== 1 || record.reportType !== "runtime-evidence-composition-snapshot" || record.userName !== manifest.userName) {
+    throw new Error(
+      `Invalid runtime evidence snapshot payload in ${bundleDir}`
+    );
+  }
+  const deployment = parseRuntimeEvidenceDeploymentSnapshot(record.deployment);
+  const producer = parseRuntimeEvidenceProducer(record.producer);
+  if (deployment.id !== manifest.deploymentId || deployment.deploymentCompositionId !== manifest.deploymentCompositionId) {
+    throw new Error(
+      `Runtime evidence snapshot identity mismatch in ${bundleDir}`
+    );
+  }
+  return { bundleDir, deployment, producer };
+};
+var sameSnapshot = (snapshot, deployment, producer) => JSON.stringify(snapshot.deployment) === JSON.stringify(deployment) && JSON.stringify(snapshot.producer) === JSON.stringify(producer);
+var publishRuntimeEvidenceCompositionSnapshot = async ({
+  evidenceRoot,
+  userName,
+  deployment,
+  producer
+}) => {
+  const deploymentId = safeSegment(deployment.id, "deployment id");
+  const compositionId = safeSegment(
+    deployment.deploymentCompositionId,
+    "composition id"
+  );
+  const createdAt = Date.now();
+  const snapshot = {
+    schemaVersion: 1,
+    reportType: "runtime-evidence-composition-snapshot",
+    createdAt,
+    userName,
+    deployment,
+    producer
+  };
+  const payload = `${JSON.stringify(snapshot, null, 2)}
+`;
+  const manifest = {
+    schemaVersion: 1,
+    reportType: "runtime-evidence-composition-snapshot",
+    createdAt,
+    userName,
+    deploymentId,
+    deploymentCompositionId: compositionId,
+    payload: {
+      file: SNAPSHOT_FILE,
+      sha256: sha2562(payload),
+      bytes: Buffer.byteLength(payload)
+    }
+  };
+  const snapshotsRoot = import_node_path2.default.join(evidenceRoot, "snapshots", deploymentId);
+  const bundleDir = import_node_path2.default.join(snapshotsRoot, compositionId);
+  const temporaryDir = import_node_path2.default.join(
+    evidenceRoot,
+    "incoming",
+    `snapshot-${compositionId}.tmp-${(0, import_node_crypto3.randomUUID)()}`
+  );
+  await import_promises2.default.mkdir(temporaryDir, { recursive: true });
+  try {
+    await Promise.all([
+      import_promises2.default.writeFile(import_node_path2.default.join(temporaryDir, SNAPSHOT_FILE), payload, "utf8"),
+      import_promises2.default.writeFile(
+        import_node_path2.default.join(temporaryDir, MANIFEST_FILE),
+        `${JSON.stringify(manifest, null, 2)}
+`,
+        "utf8"
+      )
+    ]);
+    await import_promises2.default.writeFile(
+      import_node_path2.default.join(temporaryDir, COMPLETE_FILE),
+      `${compositionId}
+`,
+      "utf8"
+    );
+    await import_promises2.default.mkdir(snapshotsRoot, { recursive: true });
+    try {
+      await import_promises2.default.rename(temporaryDir, bundleDir);
+    } catch (error) {
+      if (!isExistingDestinationError(error)) throw error;
+      await import_promises2.default.rm(temporaryDir, { recursive: true, force: true });
+    }
+  } catch (error) {
+    await import_promises2.default.rm(temporaryDir, { recursive: true, force: true });
+    throw error;
+  }
+  const verified = await verifyRuntimeEvidenceCompositionSnapshot(bundleDir);
+  if (!sameSnapshot(verified, deployment, producer)) {
+    throw new Error(
+      `Conflicting runtime evidence snapshot for composition ${compositionId}`
+    );
+  }
+  return verified;
+};
+var captureRuntimeEvidenceCompositionSnapshot = async ({
+  projectRoot,
+  userName,
+  deploymentId,
+  expectedCompositionId
+}) => {
+  const [deployment, producer] = await Promise.all([
+    resolveRuntimeEvidenceDeploymentSnapshot({
+      userName,
+      projectRoot,
+      deploymentId
+    }),
+    resolveRuntimeEvidenceProducer({ projectRoot, required: true })
+  ]);
+  if (!producer) {
+    throw new Error("Runtime evidence producer identity is required");
+  }
+  if (deployment.deploymentCompositionId !== expectedCompositionId) {
+    throw new Error(
+      `Runtime deployment composition changed while capturing snapshot: expected ${expectedCompositionId}, received ${deployment.deploymentCompositionId}`
+    );
+  }
+  await publishRuntimeEvidenceCompositionSnapshot({
+    evidenceRoot: import_node_path2.default.join(projectRoot, "data", "runtime-evidence"),
+    userName,
+    deployment,
+    producer
+  });
+};
+
 // src/lib/signals/runner.ts
 var SLOW_SIGNALS_WARNING_MS = 10 * 6e4;
 var formatDuration2 = (durationMs) => `${(durationMs / 1e3).toFixed(1)}s`;
@@ -4950,6 +5312,19 @@ var resolveNonNegativeInteger = (value, fallback) => {
 var createSignalsRunner = (config2) => {
   const interval = config2.interval;
   const projectRoot = config2.projectRoot?.trim() || String(process.env.PROJECT_CWD || process.cwd()).trim() || process.cwd();
+  const compositionSnapshotRecorder = process.env.TRADEJS_PROJECT_SHA && process.env.TRADEJS_PROJECT_IMAGE_DIGEST && config2.deploymentId ? createRuntimeEvidenceCompositionSnapshotRecorder({
+    persist: (compositionId) => captureRuntimeEvidenceCompositionSnapshot({
+      projectRoot,
+      userName: config2.userName,
+      deploymentId: config2.deploymentId,
+      expectedCompositionId: compositionId
+    }),
+    onError: (compositionId, error) => import_logger4.logger.warn(
+      "runtime evidence snapshot unavailable; trading continues and the next cycle will retry (composition=%s): %s",
+      compositionId,
+      error instanceof Error ? error.message : String(error)
+    )
+  }) : null;
   const resolveSignalsDaemonMaxLiveBars = (runtimeInterval = interval) => {
     const intervalMinutes = Number(runtimeInterval);
     const preloadBars = Math.ceil(
@@ -4991,7 +5366,7 @@ var createSignalsRunner = (config2) => {
     return connectorName;
   };
   const createSignalsSession2 = async (lifecycle, scope = {}) => {
-    const deployment = config2.deploymentId ? await (0, import_runtimeStrategies2.getRuntimeDeployment)({
+    const deployment = config2.deploymentId ? await (0, import_runtimeStrategies3.getRuntimeDeployment)({
       userName: config2.userName,
       projectRoot,
       deploymentId: config2.deploymentId
@@ -5492,7 +5867,7 @@ var createSignalsRunner = (config2) => {
     if (!config2.deploymentId) {
       throw new Error("Runtime deployment id is required");
     }
-    const configuredDeployment = await (0, import_runtimeStrategies2.getRuntimeDeployment)({
+    const configuredDeployment = await (0, import_runtimeStrategies3.getRuntimeDeployment)({
       userName: config2.userName,
       projectRoot,
       deploymentId: config2.deploymentId
@@ -5526,7 +5901,7 @@ var createSignalsRunner = (config2) => {
       throw new Error("Runtime deployment id is required");
     }
     const deploymentId = config2.deploymentId;
-    const initialDeployment = await (0, import_runtimeStrategies2.getRuntimeDeployment)({
+    const initialDeployment = await (0, import_runtimeStrategies3.getRuntimeDeployment)({
       userName: config2.userName,
       projectRoot,
       deploymentId
@@ -5551,7 +5926,7 @@ var createSignalsRunner = (config2) => {
         settleDelayMs: resolveNonNegativeInteger(config2.settleDelayMs, 5e3),
         signal: abortController.signal,
         runCycle: async () => {
-          const currentDeployment = await (0, import_runtimeStrategies2.getRuntimeDeployment)({
+          const currentDeployment = await (0, import_runtimeStrategies3.getRuntimeDeployment)({
             userName: config2.userName,
             projectRoot,
             deploymentId
@@ -5559,6 +5934,9 @@ var createSignalsRunner = (config2) => {
           if (!currentDeployment) {
             throw new Error(`Runtime deployment not found: ${deploymentId}`);
           }
+          compositionSnapshotRecorder?.observe(
+            currentDeployment.deploymentCompositionId
+          );
           const scopes = await loadConfiguredSignalsScopes(currentDeployment);
           for (const [key, staleSession] of sessions) {
             if (scopes.has(key)) continue;

package/package.json

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