@tradejs/cli 3.1.8-beta.207 → 3.1.8-beta.212

package/dist/lib/runtimeLineage.js

@@ -276,20 +276,20 @@ async function buildRuntimeLineage({
   projectRoot,
   strategyName,
   compositionId,
-  releaseVersion,
+  version,
   strategyPackageVersion,
   runtimePackageVersion,
   config,
   runContext,
   env = process.env
 }) {
-  if (releaseVersion != null) {
-    if (!Number.isSafeInteger(releaseVersion) || releaseVersion <= 0) {
-      throw new Error(`Invalid runtime releaseVersion: ${releaseVersion}`);
+  if (version != null) {
+    if (!Number.isSafeInteger(version) || version <= 0) {
+      throw new Error(`Invalid runtime strategy version: ${version}`);
     }
     return {
       schemaVersion: 2,
-      releaseVersion,
+      version,
       strategyPackageVersion,
       runtimePackageVersion,
       maxLossValue: resolveRuntimeMaxLossValue(config)
@@ -330,7 +330,7 @@ async function buildRuntimeLineage({
     maxLossValue: resolveRuntimeMaxLossValue(config)
   };
 }
-var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.releaseVersion].join(":") : [
+var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.version].join(":") : [
   lineage.schemaVersion,
   lineage.compositionId ?? "unbound-composition",
   lineage.gitSha ?? "unknown",

package/dist/lib/runtimeSignalsStorage.js

@@ -64,7 +64,7 @@ var toRuntimeSignalBucketRef = (signal) => ({
   strategy: signal.strategy,
   timestamp: signal.timestamp,
   ...signal.runtimeConfigId && signal.runtimeConfigId !== "config" ? { runtimeConfigId: signal.runtimeConfigId } : {},
-  ...signal.runtimeReleaseVersion ? { runtimeReleaseVersion: signal.runtimeReleaseVersion } : {}
+  ...signal.runtimeVersion ? { runtimeVersion: signal.runtimeVersion } : {}
 });
 var shouldStoreRuntimeSignalDiagnostics = (signal) => signal.orderStatus === "completed" || signal.orderStatus === "failed";
 var toStoredRuntimeSignal = (signal) => {

package/dist/lib/strategyRelease.js

@@ -300,8 +300,8 @@ var verifyFullPeriodChartArtifact = async (input) => {
     return false;
   }
 };
-var hasExactRuntimeTarget = (target) => Boolean(
-  target?.userName.trim() && target.deploymentId.trim() && target.accountId.trim() && target.strategyConfigName.trim()
+var hasExactRuntimeTarget = (target, strategyName) => Boolean(
+  target?.userName.trim() && target.deploymentId.trim() && target.accountId.trim() && target.strategyName.trim() === strategyName.trim() && Number.isSafeInteger(target.version) && target.version > 0
 );
 var deriveStrategyReleaseResearchDecision = async (input) => {
   const blockers = [];
@@ -386,13 +386,14 @@ var deriveStrategyReleaseResearchDecision = async (input) => {
       targetDirection: input.recentFailure?.direction ?? null,
       maxLossValue: 1,
       requiresRuntimeBinding: !hasExactRuntimeTarget(
-        input.forwardTest.runtimeTarget
+        input.forwardTest.runtimeTarget,
+        input.strategy
       ),
       blockers: ["FORWARD_NOT_AUTHORIZED"],
       summary: "The candidate is ready for a separately authorized micro-forward test at MAX_LOSS_VALUE=1."
     };
   }
-  if (!hasExactRuntimeTarget(input.forwardTest.runtimeTarget)) {
+  if (!hasExactRuntimeTarget(input.forwardTest.runtimeTarget, input.strategy)) {
     return {
       strategy: input.strategy,
       action: "MICRO_FORWARD_READY",
@@ -401,7 +402,7 @@ var deriveStrategyReleaseResearchDecision = async (input) => {
       maxLossValue: 1,
       requiresRuntimeBinding: true,
       blockers: [],
-      summary: "The portable micro-forward handoff is ready. Bind it on the runtime server to that server's deployment/account ids and verify canonical composition fingerprints there."
+      summary: "The portable micro-forward handoff is ready. Commit its deployment, account binding, complete config, and explicit strategy version in TradeJS-Project."
     };
   }
   return {

package/dist/scripts/backtest.js

@@ -74,7 +74,7 @@ var import_constants5 = require("@tradejs/core/constants");
 var import_time3 = require("@tradejs/core/time");
 var import_backtestArtifacts = require("@tradejs/infra/backtestArtifacts");
 var import_redis4 = require("@tradejs/infra/redis");
-var import_runtimeDeployments = require("@tradejs/infra/runtimeDeployments");
+var import_runtimeStrategies = require("@tradejs/node/runtimeStrategies");
 var import_types3 = require("@tradejs/types");
 
 // src/lib/runFormatting.ts
@@ -5025,7 +5025,11 @@ var validateBacktestRuntimeDeployment = ({
 };
 var prepareRunEnvironment2 = async () => {
   const deployment = validateBacktestRuntimeDeployment({
-    deployment: flags.deployment ? await (0, import_runtimeDeployments.getRuntimeDeployment)(userName, String(flags.deployment)) : null,
+    deployment: flags.deployment ? await (0, import_runtimeStrategies.getRuntimeDeployment)({
+      userName,
+      projectRoot,
+      deploymentId: String(flags.deployment)
+    }) : null,
     deploymentId: typeof flags.deployment === "string" ? flags.deployment : void 0
   });
   const preparedRun = await prepareRunEnvironment({

package/dist/scripts/replay.js

@@ -5139,20 +5139,20 @@ async function buildRuntimeLineage({
   projectRoot,
   strategyName,
   compositionId,
-  releaseVersion,
+  version,
   strategyPackageVersion,
   runtimePackageVersion,
   config,
   runContext,
   env = process.env
 }) {
-  if (releaseVersion != null) {
-    if (!Number.isSafeInteger(releaseVersion) || releaseVersion <= 0) {
-      throw new Error(`Invalid runtime releaseVersion: ${releaseVersion}`);
+  if (version != null) {
+    if (!Number.isSafeInteger(version) || version <= 0) {
+      throw new Error(`Invalid runtime strategy version: ${version}`);
     }
     return {
       schemaVersion: 2,
-      releaseVersion,
+      version,
       strategyPackageVersion,
       runtimePackageVersion,
       maxLossValue: resolveRuntimeMaxLossValue(config)
@@ -5193,7 +5193,7 @@ async function buildRuntimeLineage({
     maxLossValue: resolveRuntimeMaxLossValue(config)
   };
 }
-var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.releaseVersion].join(":") : [
+var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.version].join(":") : [
   lineage.schemaVersion,
   lineage.compositionId ?? "unbound-composition",
   lineage.gitSha ?? "unknown",
@@ -7226,7 +7226,7 @@ var buildRuntimeEvidenceLineageScopes = ({
     strategy,
     symbol,
     runtimeConfigId,
-    runtimeReleaseVersion,
+    runtimeVersion,
     timestamp,
     lineage
   }) => {
@@ -7239,7 +7239,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy,
       symbol,
       ...runtimeConfigId ? { runtimeConfigId } : {},
-      ...runtimeReleaseVersion ? { runtimeReleaseVersion } : {},
+      ...runtimeVersion ? { runtimeVersion } : {},
       lineage,
       firstTimestamp: existing ? Math.min(existing.firstTimestamp, timestamp) : timestamp,
       lastTimestamp: existing ? Math.max(existing.lastTimestamp, timestamp) : timestamp
@@ -7250,7 +7250,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy: signal.strategy,
       symbol: signal.symbol,
       runtimeConfigId: signal.runtimeConfigId,
-      runtimeReleaseVersion: signal.runtimeReleaseVersion,
+      runtimeVersion: signal.runtimeVersion,
       timestamp: signal.timestamp,
       lineage: signal.runtimeLineage
     });
@@ -7260,7 +7260,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy: evaluation.strategy,
       symbol: evaluation.symbol,
       runtimeConfigId: evaluation.runtimeConfigId,
-      runtimeReleaseVersion: evaluation.runtimeReleaseVersion,
+      runtimeVersion: evaluation.runtimeVersion,
       timestamp: evaluation.timestamp,
       lineage: evaluation.runtimeLineage
     });
@@ -8575,7 +8575,7 @@ var renderLineageRows = (runtimeComparison) => {
       existing.gitShas.add("release-versioned");
       existing.dirty.add("n/a");
       existing.gates.add("release-versioned");
-      existing.configs.add(`v${record.lineage.releaseVersion}`);
+      existing.configs.add(`v${record.lineage.version}`);
       existing.contexts.add(
         [
           record.lineage.strategyPackageVersion ?? "strategy:unknown",

package/dist/scripts/replayRunner.js

@@ -5142,20 +5142,20 @@ async function buildRuntimeLineage({
   projectRoot,
   strategyName,
   compositionId,
-  releaseVersion,
+  version,
   strategyPackageVersion,
   runtimePackageVersion,
   config,
   runContext,
   env = process.env
 }) {
-  if (releaseVersion != null) {
-    if (!Number.isSafeInteger(releaseVersion) || releaseVersion <= 0) {
-      throw new Error(`Invalid runtime releaseVersion: ${releaseVersion}`);
+  if (version != null) {
+    if (!Number.isSafeInteger(version) || version <= 0) {
+      throw new Error(`Invalid runtime strategy version: ${version}`);
     }
     return {
       schemaVersion: 2,
-      releaseVersion,
+      version,
       strategyPackageVersion,
       runtimePackageVersion,
       maxLossValue: resolveRuntimeMaxLossValue(config)
@@ -5196,7 +5196,7 @@ async function buildRuntimeLineage({
     maxLossValue: resolveRuntimeMaxLossValue(config)
   };
 }
-var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.releaseVersion].join(":") : [
+var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.version].join(":") : [
   lineage.schemaVersion,
   lineage.compositionId ?? "unbound-composition",
   lineage.gitSha ?? "unknown",
@@ -7229,7 +7229,7 @@ var buildRuntimeEvidenceLineageScopes = ({
     strategy,
     symbol,
     runtimeConfigId,
-    runtimeReleaseVersion,
+    runtimeVersion,
     timestamp,
     lineage
   }) => {
@@ -7242,7 +7242,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy,
       symbol,
       ...runtimeConfigId ? { runtimeConfigId } : {},
-      ...runtimeReleaseVersion ? { runtimeReleaseVersion } : {},
+      ...runtimeVersion ? { runtimeVersion } : {},
       lineage,
       firstTimestamp: existing ? Math.min(existing.firstTimestamp, timestamp) : timestamp,
       lastTimestamp: existing ? Math.max(existing.lastTimestamp, timestamp) : timestamp
@@ -7253,7 +7253,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy: signal.strategy,
       symbol: signal.symbol,
       runtimeConfigId: signal.runtimeConfigId,
-      runtimeReleaseVersion: signal.runtimeReleaseVersion,
+      runtimeVersion: signal.runtimeVersion,
       timestamp: signal.timestamp,
       lineage: signal.runtimeLineage
     });
@@ -7263,7 +7263,7 @@ var buildRuntimeEvidenceLineageScopes = ({
       strategy: evaluation.strategy,
       symbol: evaluation.symbol,
       runtimeConfigId: evaluation.runtimeConfigId,
-      runtimeReleaseVersion: evaluation.runtimeReleaseVersion,
+      runtimeVersion: evaluation.runtimeVersion,
       timestamp: evaluation.timestamp,
       lineage: evaluation.runtimeLineage
     });
@@ -8578,7 +8578,7 @@ var renderLineageRows = (runtimeComparison) => {
       existing.gitShas.add("release-versioned");
       existing.dirty.add("n/a");
       existing.gates.add("release-versioned");
-      existing.configs.add(`v${record.lineage.releaseVersion}`);
+      existing.configs.add(`v${record.lineage.version}`);
       existing.contexts.add(
         [
           record.lineage.strategyPackageVersion ?? "strategy:unknown",

package/dist/scripts/runtimeControl.js

@@ -0,0 +1,177 @@
+"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/scripts/runtimeControl.ts
+var runtimeControl_exports = {};
+__export(runtimeControl_exports, {
+  RUNTIME_CONTROL_ACTIONS: () => RUNTIME_CONTROL_ACTIONS,
+  main: () => main,
+  runtimeControl: () => runtimeControl
+});
+module.exports = __toCommonJS(runtimeControl_exports);
+var import_config = require("dotenv/config");
+var import_runtimeControls = require("@tradejs/infra/runtimeControls");
+var import_runtimeStrategies = require("@tradejs/node/runtimeStrategies");
+var argv = process.argv.slice(2);
+var RUNTIME_CONTROL_ACTIONS = [
+  "inspect",
+  "verify",
+  "pause",
+  "resume"
+];
+var action = argv[0] ?? "inspect";
+var option = (name) => {
+  const index = argv.indexOf(`--${name}`);
+  return index >= 0 ? argv[index + 1] : void 0;
+};
+var required = (name) => {
+  const value = String(option(name) ?? "").trim();
+  if (!value) throw new Error(`--${name} is required`);
+  return value;
+};
+var projectRoot = String(process.env.PROJECT_CWD || process.cwd()).trim() || process.cwd();
+var userName = String(option("user") ?? process.env.USER_NAME ?? "root");
+var verify = async () => {
+  const deployments = await (0, import_runtimeStrategies.listRuntimeDeployments)({ userName, projectRoot });
+  const requestedDeployment = option("deployment");
+  const selected = requestedDeployment ? deployments.filter((deployment) => deployment.id === requestedDeployment) : deployments;
+  if (requestedDeployment && !selected.length) {
+    throw new Error(`Runtime deployment not found: ${requestedDeployment}`);
+  }
+  const results = [];
+  for (const deployment of selected) {
+    try {
+      const strategies = await (0, import_runtimeStrategies.loadResolvedRuntimeStrategies)({
+        userName,
+        projectRoot,
+        deploymentId: deployment.id
+      });
+      results.push({
+        deploymentId: deployment.id,
+        ok: true,
+        strategies: strategies.map((strategy) => ({
+          strategyName: strategy.strategyName,
+          version: strategy.version,
+          controlState: strategy.controlState,
+          interval: strategy.interval,
+          universe: strategy.universe,
+          accountId: strategy.accountId,
+          strategyPackage: strategy.strategyPackage,
+          strategyPackageVersion: strategy.strategyPackageVersion,
+          runtimePackageVersion: strategy.runtimePackageVersion
+        }))
+      });
+    } catch (error) {
+      results.push({
+        deploymentId: deployment.id,
+        ok: false,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+  console.log(JSON.stringify({ userName, results }, null, 2));
+  if (results.some((result) => !result.ok)) process.exitCode = 1;
+};
+var inspect = async () => {
+  const requestedDeployment = option("deployment");
+  const requestedStrategy = option("strategy");
+  const deployments = (await (0, import_runtimeStrategies.listRuntimeDeployments)({ userName, projectRoot })).filter(
+    (deployment) => !requestedDeployment || deployment.id === requestedDeployment
+  ).map((deployment) => ({
+    ...deployment,
+    strategies: deployment.strategies.filter(
+      (strategy) => !requestedStrategy || strategy.strategyName === requestedStrategy
+    )
+  }));
+  console.log(JSON.stringify({ userName, deployments }, null, 2));
+};
+var updateControlState = async (nextState) => {
+  const deploymentId = required("deployment");
+  const strategyName = required("strategy");
+  const deployment = await (0, import_runtimeStrategies.getRuntimeDeployment)({
+    userName,
+    projectRoot,
+    deploymentId
+  });
+  if (!deployment) {
+    throw new Error(`Runtime deployment not found: ${deploymentId}`);
+  }
+  const reference = deployment.strategies.find(
+    (strategy) => strategy.strategyName === strategyName
+  );
+  if (!reference) {
+    throw new Error(`${strategyName} is not declared in ${deploymentId}`);
+  }
+  if (nextState === "active" && (!deployment.enabled || !reference.enabled)) {
+    throw new Error(
+      `${strategyName} is disabled in tradejs.config.ts and cannot be resumed manually`
+    );
+  }
+  const previousState = reference.controlState;
+  if (nextState === "entries_paused") {
+    await (0, import_runtimeControls.pauseRuntimeStrategy)({
+      userName,
+      deploymentId,
+      strategyName,
+      updatedBy: `cli:${userName}`
+    });
+  } else {
+    await (0, import_runtimeControls.resumeRuntimeStrategy)({ userName, deploymentId, strategyName });
+  }
+  const updated = await (0, import_runtimeStrategies.getRuntimeDeployment)({
+    userName,
+    projectRoot,
+    deploymentId
+  });
+  const updatedReference = updated?.strategies.find(
+    (strategy) => strategy.strategyName === strategyName
+  );
+  const event = previousState === nextState ? null : await (0, import_runtimeControls.recordRuntimeStrategyControlEvent)({
+    userName,
+    deploymentId,
+    strategyName,
+    version: reference.version,
+    previousState,
+    nextState,
+    createdBy: `cli:${userName}`
+  });
+  console.log(
+    JSON.stringify(
+      { deployment: updated, strategy: updatedReference, event },
+      null,
+      2
+    )
+  );
+};
+var runtimeControl = async () => {
+  if (action === "verify") return verify();
+  if (action === "pause") return updateControlState("entries_paused");
+  if (action === "resume") return updateControlState("active");
+  if (action === "inspect") return inspect();
+  throw new Error(
+    `Usage: tradejs runtime-control ${RUNTIME_CONTROL_ACTIONS.join("|")}`
+  );
+};
+var main = runtimeControl;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RUNTIME_CONTROL_ACTIONS,
+  main,
+  runtimeControl
+});

package/dist/scripts/runtimeEvidence.js

@@ -573,7 +573,7 @@ var import_promises2 = __toESM(require("fs/promises"));
 var import_node_path2 = __toESM(require("path"));
 
 // src/lib/runtimeLineage.ts
-var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.releaseVersion].join(":") : [
+var runtimeLineageKey = (lineage) => lineage.schemaVersion === 2 ? ["v2", lineage.version].join(":") : [
   lineage.schemaVersion,
   lineage.compositionId ?? "unbound-composition",
   lineage.gitSha ?? "unknown",