@tradejs/cli 3.1.1 → 3.1.3

package/dist/cli.js

@@ -28101,16 +28101,20 @@ var init_runtimeScorecard2 = __esm({
 // src/scripts/runtimeConfig.ts
 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, 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");
@@ -28176,6 +28180,131 @@ var init_runtimeConfig = __esm({
         createdBy: `cli:${userName2}`
       });
     };
+    buildBootstrapRuntimeDeployment = ({
+      deploymentId,
+      label,
+      connectorName,
+      provider,
+      accountId,
+      strategyName,
+      releaseVersion,
+      config: config2
+    }) => ({
+      id: deploymentId,
+      label,
+      connectorName,
+      provider,
+      accountId,
+      universe: config2.UNIVERSE,
+      interval: String(config2.INTERVAL),
+      enabled: true,
+      strategies: [
+        {
+          strategyName,
+          releaseVersion,
+          controlState: "entries_paused"
+        }
+      ]
+    });
+    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");
+      const accountId = required2("account");
+      const connectorName = option("connector") ?? "bybit";
+      const provider = option("provider") ?? connectorName;
+      const label = option("label") ?? deploymentId;
+      const configFile = import_node_path23.default.resolve(projectRoot12, required2("file"));
+      const sourceConfig = JSON.parse(
+        await (0, import_promises28.readFile)(configFile, "utf8")
+      );
+      const existingDeployment = await (0, import_runtimeDeployments2.getRuntimeDeployment)(userName2, deploymentId);
+      if (existingDeployment) {
+        throw new Error(
+          `Deployment already exists: ${deploymentId}; publish a release and switch its pointer instead`
+        );
+      }
+      const releaseConfig = await toReleaseConfig(strategyName, sourceConfig);
+      const previewDeployment = buildBootstrapRuntimeDeployment({
+        deploymentId,
+        label,
+        connectorName,
+        provider,
+        accountId,
+        strategyName,
+        releaseVersion: 1,
+        config: releaseConfig
+      });
+      if (!hasFlag("write")) {
+        console.log(
+          JSON.stringify(
+            {
+              dryRun: true,
+              releaseConfig,
+              deployment: {
+                ...previewDeployment,
+                strategies: previewDeployment.strategies.map((strategy) => ({
+                  ...strategy,
+                  releaseVersion: "<allocated on write>"
+                }))
+              }
+            },
+            null,
+            2
+          )
+        );
+        return;
+      }
+      const backupPath = await writeMigrationBackup({
+        userName: userName2,
+        capturedAt: Date.now(),
+        reason: "bootstrap",
+        sourceConfig
+      });
+      const release = await publish({ strategyName, sourceConfig });
+      const deployment = await (0, import_runtimeDeployments2.saveRuntimeDeployment)(
+        userName2,
+        buildBootstrapRuntimeDeployment({
+          deploymentId,
+          label,
+          connectorName,
+          provider,
+          accountId,
+          strategyName,
+          releaseVersion: release.releaseVersion,
+          config: release.config
+        })
+      );
+      console.log(
+        JSON.stringify(
+          { bootstrapped: true, backupPath, release, deployment },
+          null,
+          2
+        )
+      );
+    };
     migrate = async () => {
       const strategyName = required2("strategy");
       const configId = option("config") ?? "config";
@@ -28237,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);
@@ -28345,7 +28563,9 @@ var init_runtimeConfig = __esm({
       console.log(JSON.stringify({ userName: userName2, deployments, releases }, null, 2));
     };
     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");
@@ -28353,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|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

@@ -30,13 +30,17 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/scripts/runtimeConfig.ts
 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");
@@ -102,6 +106,131 @@ var publish = async ({
     createdBy: `cli:${userName}`
   });
 };
+var buildBootstrapRuntimeDeployment = ({
+  deploymentId,
+  label,
+  connectorName,
+  provider,
+  accountId,
+  strategyName,
+  releaseVersion,
+  config
+}) => ({
+  id: deploymentId,
+  label,
+  connectorName,
+  provider,
+  accountId,
+  universe: config.UNIVERSE,
+  interval: String(config.INTERVAL),
+  enabled: true,
+  strategies: [
+    {
+      strategyName,
+      releaseVersion,
+      controlState: "entries_paused"
+    }
+  ]
+});
+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");
+  const accountId = required("account");
+  const connectorName = option("connector") ?? "bybit";
+  const provider = option("provider") ?? connectorName;
+  const label = option("label") ?? deploymentId;
+  const configFile = import_node_path.default.resolve(projectRoot, required("file"));
+  const sourceConfig = JSON.parse(
+    await (0, import_promises.readFile)(configFile, "utf8")
+  );
+  const existingDeployment = await (0, import_runtimeDeployments.getRuntimeDeployment)(userName, deploymentId);
+  if (existingDeployment) {
+    throw new Error(
+      `Deployment already exists: ${deploymentId}; publish a release and switch its pointer instead`
+    );
+  }
+  const releaseConfig = await toReleaseConfig(strategyName, sourceConfig);
+  const previewDeployment = buildBootstrapRuntimeDeployment({
+    deploymentId,
+    label,
+    connectorName,
+    provider,
+    accountId,
+    strategyName,
+    releaseVersion: 1,
+    config: releaseConfig
+  });
+  if (!hasFlag("write")) {
+    console.log(
+      JSON.stringify(
+        {
+          dryRun: true,
+          releaseConfig,
+          deployment: {
+            ...previewDeployment,
+            strategies: previewDeployment.strategies.map((strategy) => ({
+              ...strategy,
+              releaseVersion: "<allocated on write>"
+            }))
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  const backupPath = await writeMigrationBackup({
+    userName,
+    capturedAt: Date.now(),
+    reason: "bootstrap",
+    sourceConfig
+  });
+  const release = await publish({ strategyName, sourceConfig });
+  const deployment = await (0, import_runtimeDeployments.saveRuntimeDeployment)(
+    userName,
+    buildBootstrapRuntimeDeployment({
+      deploymentId,
+      label,
+      connectorName,
+      provider,
+      accountId,
+      strategyName,
+      releaseVersion: release.releaseVersion,
+      config: release.config
+    })
+  );
+  console.log(
+    JSON.stringify(
+      { bootstrapped: true, backupPath, release, deployment },
+      null,
+      2
+    )
+  );
+};
 var migrate = async () => {
   const strategyName = required("strategy");
   const configId = option("config") ?? "config";
@@ -163,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);
@@ -271,7 +489,9 @@ var inspect = async () => {
   console.log(JSON.stringify({ userName, deployments, releases }, null, 2));
 };
 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");
@@ -279,12 +499,15 @@ var runtimeConfig = async () => {
   if (action === "rollback") return rollback();
   if (action === "inspect") return inspect();
   throw new Error(
-    "Usage: tradejs runtime-config inspect|verify|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.1",
+  "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.1",
-    "@tradejs/core": "^3.1.1",
-    "@tradejs/indicators": "^3.1.1",
-    "@tradejs/infra": "^3.1.1",
-    "@tradejs/node": "^3.1.1",
+    "@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.1",
+    "@tradejs/types": "^3.1.3",
     "args": "^5.0.3",
     "bcryptjs": "^2.4.3",
     "chalk": "4.1.2",