@tradejs/cli 3.1.2 → 3.1.3

package/dist/cli.js

@@ -28102,16 +28102,19 @@ var init_runtimeScorecard2 = __esm({
 var runtimeConfig_exports = {};
 __export(runtimeConfig_exports, {
   buildBootstrapRuntimeDeployment: () => buildBootstrapRuntimeDeployment,
+  isEquivalentRuntimeStrategyRelease: () => isEquivalentRuntimeStrategyRelease,
   main: () => main37,
+  pointRuntimeDeploymentAtRelease: () => pointRuntimeDeploymentAtRelease,
   runtimeConfig: () => runtimeConfig
 });
-var import_config9, import_promises28, import_node_path23, import_runtimeDeployments2, import_runtimeStrategyConfigs2, import_runtimeStrategyReleases, import_runtimeStrategies, import_strategies11, argv, action, option, hasFlag, required2, projectRoot12, userName2, OPERATIONAL_CONFIG_KEYS, toReleaseConfig, writeMigrationBackup, publish, buildBootstrapRuntimeDeployment, bootstrap, migrate, publishDraft, updateControlState, rollback, verify, inspect, runtimeConfig, main37;
+var import_config9, import_promises28, import_node_path23, import_node_util2, import_runtimeDeployments2, import_runtimeStrategyConfigs2, import_runtimeStrategyReleases, import_runtimeStrategies, import_strategies11, argv, action, option, hasFlag, required2, projectRoot12, userName2, OPERATIONAL_CONFIG_KEYS, toReleaseConfig, writeMigrationBackup, publish, buildBootstrapRuntimeDeployment, isEquivalentRuntimeStrategyRelease, pointRuntimeDeploymentAtRelease, bootstrap, migrate, rollout, publishDraft, updateControlState, rollback, verify, inspect, runtimeConfig, main37;
 var init_runtimeConfig = __esm({
   "src/scripts/runtimeConfig.ts"() {
     "use strict";
     import_config9 = require("dotenv/config");
     import_promises28 = require("fs/promises");
     import_node_path23 = __toESM(require("path"));
+    import_node_util2 = require("util");
     import_runtimeDeployments2 = require("@tradejs/infra/runtimeDeployments");
     import_runtimeStrategyConfigs2 = require("@tradejs/infra/runtimeStrategyConfigs");
     import_runtimeStrategyReleases = require("@tradejs/infra/runtimeStrategyReleases");
@@ -28203,6 +28206,29 @@ var init_runtimeConfig = __esm({
         }
       ]
     });
+    isEquivalentRuntimeStrategyRelease = ({
+      release,
+      config: config2,
+      strategyPackage,
+      strategyPackageVersion,
+      runtimePackageVersion
+    }) => Boolean(
+      release && (0, import_node_util2.isDeepStrictEqual)(release.config, config2) && (release.strategyPackage ?? null) === (strategyPackage ?? null) && (release.strategyPackageVersion ?? null) === (strategyPackageVersion ?? null) && (release.runtimePackageVersion ?? null) === (runtimePackageVersion ?? null)
+    );
+    pointRuntimeDeploymentAtRelease = ({
+      deployment,
+      strategyName,
+      releaseVersion
+    }) => ({
+      ...deployment,
+      strategies: deployment.strategies.map(
+        (strategy) => strategy.strategyName === strategyName ? {
+          strategyName,
+          releaseVersion,
+          controlState: "entries_paused"
+        } : strategy
+      )
+    });
     bootstrap = async () => {
       const strategyName = required2("strategy");
       const deploymentId = required2("deployment");
@@ -28340,6 +28366,95 @@ var init_runtimeConfig = __esm({
         )
       );
     };
+    rollout = async () => {
+      const strategyName = required2("strategy");
+      const deploymentId = required2("deployment");
+      const configFile = import_node_path23.default.resolve(projectRoot12, required2("file"));
+      const [deployment, sourceConfig] = await Promise.all([
+        (0, import_runtimeDeployments2.getRuntimeDeployment)(userName2, deploymentId),
+        (0, import_promises28.readFile)(configFile, "utf8").then(
+          (value) => JSON.parse(value)
+        )
+      ]);
+      if (!deployment) throw new Error(`Deployment not found: ${deploymentId}`);
+      const reference = deployment.strategies.find(
+        (strategy) => strategy.strategyName === strategyName
+      );
+      if (!reference?.releaseVersion) {
+        throw new Error(`${strategyName} is not a versioned deployment reference`);
+      }
+      const [config2, metadata, currentRelease] = await Promise.all([
+        toReleaseConfig(strategyName, sourceConfig),
+        (0, import_runtimeStrategies.getRuntimeStrategyPackageMetadata)({ strategyName, projectRoot: projectRoot12 }),
+        (0, import_runtimeStrategyReleases.getRuntimeStrategyRelease)(userName2, strategyName, reference.releaseVersion)
+      ]);
+      const unchanged = isEquivalentRuntimeStrategyRelease({
+        release: currentRelease,
+        config: config2,
+        ...metadata
+      });
+      const preview = {
+        deploymentId,
+        strategyName,
+        currentReleaseVersion: reference.releaseVersion,
+        nextControlState: "entries_paused",
+        unchanged,
+        config: config2,
+        ...metadata
+      };
+      if (!hasFlag("write")) {
+        console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
+        return;
+      }
+      if (unchanged) {
+        console.log(
+          JSON.stringify(
+            {
+              rolledOut: false,
+              reason: "release_config_and_packages_unchanged",
+              release: currentRelease,
+              deployment
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const backupPath = await writeMigrationBackup({
+        userName: userName2,
+        capturedAt: Date.now(),
+        reason: "rollout",
+        deployment,
+        currentRelease,
+        sourceConfig
+      });
+      const release = await (0, import_runtimeStrategyReleases.publishRuntimeStrategyRelease)({
+        userName: userName2,
+        strategyName,
+        config: config2,
+        ...metadata,
+        createdBy: `cli:${userName2}`
+      });
+      const updatedDeployment = pointRuntimeDeploymentAtRelease({
+        deployment,
+        strategyName,
+        releaseVersion: release.releaseVersion
+      });
+      await (0, import_runtimeDeployments2.saveRuntimeDeployment)(userName2, updatedDeployment);
+      console.log(
+        JSON.stringify(
+          {
+            rolledOut: true,
+            backupPath,
+            release,
+            deployment: updatedDeployment
+          },
+          null,
+          2
+        )
+      );
+    };
     publishDraft = async () => {
       const strategyName = required2("strategy");
       const draft = await (0, import_runtimeStrategyReleases.getRuntimeStrategyDraft)(userName2, strategyName);
@@ -28450,6 +28565,7 @@ var init_runtimeConfig = __esm({
     runtimeConfig = async () => {
       if (action === "bootstrap") return bootstrap();
       if (action === "migrate") return migrate();
+      if (action === "rollout") return rollout();
       if (action === "publish-draft") return publishDraft();
       if (action === "verify") return verify();
       if (action === "pause") return updateControlState("entries_paused");
@@ -28457,7 +28573,7 @@ var init_runtimeConfig = __esm({
       if (action === "rollback") return rollback();
       if (action === "inspect") return inspect();
       throw new Error(
-        "Usage: tradejs runtime-config inspect|verify|bootstrap|migrate|publish-draft|pause|resume|rollback"
+        "Usage: tradejs runtime-config inspect|verify|bootstrap|migrate|rollout|publish-draft|pause|resume|rollback"
       );
     };
     main37 = runtimeConfig;

package/dist/scripts/runtimeConfig.js

@@ -31,13 +31,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var runtimeConfig_exports = {};
 __export(runtimeConfig_exports, {
   buildBootstrapRuntimeDeployment: () => buildBootstrapRuntimeDeployment,
+  isEquivalentRuntimeStrategyRelease: () => isEquivalentRuntimeStrategyRelease,
   main: () => main,
+  pointRuntimeDeploymentAtRelease: () => pointRuntimeDeploymentAtRelease,
   runtimeConfig: () => runtimeConfig
 });
 module.exports = __toCommonJS(runtimeConfig_exports);
 var import_config = require("dotenv/config");
 var import_promises = require("fs/promises");
 var import_node_path = __toESM(require("path"));
+var import_node_util = require("util");
 var import_runtimeDeployments = require("@tradejs/infra/runtimeDeployments");
 var import_runtimeStrategyConfigs = require("@tradejs/infra/runtimeStrategyConfigs");
 var import_runtimeStrategyReleases = require("@tradejs/infra/runtimeStrategyReleases");
@@ -129,6 +132,29 @@ var buildBootstrapRuntimeDeployment = ({
     }
   ]
 });
+var isEquivalentRuntimeStrategyRelease = ({
+  release,
+  config,
+  strategyPackage,
+  strategyPackageVersion,
+  runtimePackageVersion
+}) => Boolean(
+  release && (0, import_node_util.isDeepStrictEqual)(release.config, config) && (release.strategyPackage ?? null) === (strategyPackage ?? null) && (release.strategyPackageVersion ?? null) === (strategyPackageVersion ?? null) && (release.runtimePackageVersion ?? null) === (runtimePackageVersion ?? null)
+);
+var pointRuntimeDeploymentAtRelease = ({
+  deployment,
+  strategyName,
+  releaseVersion
+}) => ({
+  ...deployment,
+  strategies: deployment.strategies.map(
+    (strategy) => strategy.strategyName === strategyName ? {
+      strategyName,
+      releaseVersion,
+      controlState: "entries_paused"
+    } : strategy
+  )
+});
 var bootstrap = async () => {
   const strategyName = required("strategy");
   const deploymentId = required("deployment");
@@ -266,6 +292,95 @@ var migrate = async () => {
     )
   );
 };
+var rollout = async () => {
+  const strategyName = required("strategy");
+  const deploymentId = required("deployment");
+  const configFile = import_node_path.default.resolve(projectRoot, required("file"));
+  const [deployment, sourceConfig] = await Promise.all([
+    (0, import_runtimeDeployments.getRuntimeDeployment)(userName, deploymentId),
+    (0, import_promises.readFile)(configFile, "utf8").then(
+      (value) => JSON.parse(value)
+    )
+  ]);
+  if (!deployment) throw new Error(`Deployment not found: ${deploymentId}`);
+  const reference = deployment.strategies.find(
+    (strategy) => strategy.strategyName === strategyName
+  );
+  if (!reference?.releaseVersion) {
+    throw new Error(`${strategyName} is not a versioned deployment reference`);
+  }
+  const [config, metadata, currentRelease] = await Promise.all([
+    toReleaseConfig(strategyName, sourceConfig),
+    (0, import_runtimeStrategies.getRuntimeStrategyPackageMetadata)({ strategyName, projectRoot }),
+    (0, import_runtimeStrategyReleases.getRuntimeStrategyRelease)(userName, strategyName, reference.releaseVersion)
+  ]);
+  const unchanged = isEquivalentRuntimeStrategyRelease({
+    release: currentRelease,
+    config,
+    ...metadata
+  });
+  const preview = {
+    deploymentId,
+    strategyName,
+    currentReleaseVersion: reference.releaseVersion,
+    nextControlState: "entries_paused",
+    unchanged,
+    config,
+    ...metadata
+  };
+  if (!hasFlag("write")) {
+    console.log(JSON.stringify({ dryRun: true, ...preview }, null, 2));
+    return;
+  }
+  if (unchanged) {
+    console.log(
+      JSON.stringify(
+        {
+          rolledOut: false,
+          reason: "release_config_and_packages_unchanged",
+          release: currentRelease,
+          deployment
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const backupPath = await writeMigrationBackup({
+    userName,
+    capturedAt: Date.now(),
+    reason: "rollout",
+    deployment,
+    currentRelease,
+    sourceConfig
+  });
+  const release = await (0, import_runtimeStrategyReleases.publishRuntimeStrategyRelease)({
+    userName,
+    strategyName,
+    config,
+    ...metadata,
+    createdBy: `cli:${userName}`
+  });
+  const updatedDeployment = pointRuntimeDeploymentAtRelease({
+    deployment,
+    strategyName,
+    releaseVersion: release.releaseVersion
+  });
+  await (0, import_runtimeDeployments.saveRuntimeDeployment)(userName, updatedDeployment);
+  console.log(
+    JSON.stringify(
+      {
+        rolledOut: true,
+        backupPath,
+        release,
+        deployment: updatedDeployment
+      },
+      null,
+      2
+    )
+  );
+};
 var publishDraft = async () => {
   const strategyName = required("strategy");
   const draft = await (0, import_runtimeStrategyReleases.getRuntimeStrategyDraft)(userName, strategyName);
@@ -376,6 +491,7 @@ var inspect = async () => {
 var runtimeConfig = async () => {
   if (action === "bootstrap") return bootstrap();
   if (action === "migrate") return migrate();
+  if (action === "rollout") return rollout();
   if (action === "publish-draft") return publishDraft();
   if (action === "verify") return verify();
   if (action === "pause") return updateControlState("entries_paused");
@@ -383,13 +499,15 @@ var runtimeConfig = async () => {
   if (action === "rollback") return rollback();
   if (action === "inspect") return inspect();
   throw new Error(
-    "Usage: tradejs runtime-config inspect|verify|bootstrap|migrate|publish-draft|pause|resume|rollback"
+    "Usage: tradejs runtime-config inspect|verify|bootstrap|migrate|rollout|publish-draft|pause|resume|rollback"
   );
 };
 var main = runtimeConfig;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildBootstrapRuntimeDeployment,
+  isEquivalentRuntimeStrategyRelease,
   main,
+  pointRuntimeDeploymentAtRelease,
   runtimeConfig
 });

package/package.json

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