@nmakarov/cli-toolkit 0.46.0 → 0.49.0

package/dist/index.cjs

@@ -1142,6 +1142,7 @@ __export(src_exports, {
   h: () => import_react5.createElement,
   initServiceStructure: () => initServiceStructure,
   installDeps: () => installDeps,
+  installOperatorShell: () => installOperatorShell,
   ipcFileLogsTableNameForSourceResource: () => ipcFileLogsTableNameForSourceResource,
   joiEdateType: () => joiEdateType,
   joiStringArrayType: () => joiStringArrayType,
@@ -1561,36 +1562,29 @@ var Args = class _Args {
       }
       return;
     }
-    let dotEnvPathFile = null;
-    const envSpecificFile = `.env.${this.env}`;
-    const envSpecificPath = (0, import_path.resolve)(dotEnvPath, envSpecificFile);
-    if ((0, import_fs.existsSync)(envSpecificPath)) {
-      dotEnvPathFile = envSpecificPath;
-    }
-    if (!dotEnvPathFile && !this.get("dotEnvPath")) {
+    let dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
+    if (!(0, import_fs.existsSync)(dotEnvPathFile) && !this.get("dotEnvPath")) {
       const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
-      const examplesEnvSpecificPath = (0, import_path.resolve)(examplesPath, envSpecificFile);
-      if ((0, import_fs.existsSync)(examplesEnvSpecificPath)) {
-        dotEnvPathFile = examplesEnvSpecificPath;
-      }
-    }
-    if (!dotEnvPathFile) {
-      dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, dotEnvFile);
-      if (!(0, import_fs.existsSync)(dotEnvPathFile)) {
-        if (!this.get("dotEnvPath")) {
-          const examplesPath = (0, import_path.resolve)(dotEnvPath, "examples");
-          const examplesEnvFile = (0, import_path.resolve)(examplesPath, dotEnvFile);
-          if ((0, import_fs.existsSync)(examplesEnvFile)) {
-            dotEnvPathFile = examplesEnvFile;
-          } else {
-            dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, "..", dotEnvFile);
-          }
-        }
+      const examplesEnvFile = (0, import_path.resolve)(examplesPath, dotEnvFile);
+      if ((0, import_fs.existsSync)(examplesEnvFile)) {
+        dotEnvPathFile = examplesEnvFile;
+      } else {
+        dotEnvPathFile = (0, import_path.resolve)(dotEnvPath, "..", dotEnvFile);
       }
     }
     if (dotEnvPathFile && (0, import_fs.existsSync)(dotEnvPathFile)) {
       (0, import_dotenv.config)({ path: dotEnvPathFile, quiet: true });
     }
+    const envSpecificFile = `.env.${this.env}`;
+    const envSpecificPath = (0, import_path.resolve)(dotEnvPath, envSpecificFile);
+    if ((0, import_fs.existsSync)(envSpecificPath) && envSpecificPath !== dotEnvPathFile) {
+      (0, import_dotenv.config)({ path: envSpecificPath, quiet: true });
+    } else if (!this.get("dotEnvPath")) {
+      const examplesOverlay = (0, import_path.resolve)(dotEnvPath, "examples", envSpecificFile);
+      if ((0, import_fs.existsSync)(examplesOverlay)) {
+        (0, import_dotenv.config)({ path: examplesOverlay, quiet: true });
+      }
+    }
   }
   /**
    * Load configuration files
@@ -5947,10 +5941,9 @@ function buildEcosystemConfig(service, paths) {
   const outLog = (0, import_node_path8.join)(paths.logs, `${pm2.appName}.out.log`);
   const errLog = (0, import_node_path8.join)(paths.logs, `${pm2.appName}.err.log`);
   return `/**
- * pm2 ecosystem for ${service.name} \u2014 seeded by cli-toolkit deploy (init).
- *
- * cwd points at the \`current\` symlink (created on first deploy).
- * Tweak \`args\` here, then: pm2 reload ${paths.ecosystem} --update-env
+ * pm2 ecosystem for ${service.name} \u2014 written by cli-toolkit deploy from the
+ * service manifest (init/deploy). Do not hand-edit; change pm2.* in the
+ * manifest and redeploy. cwd \u2192 \`current\` symlink.
  */
 module.exports = {
     apps: [
@@ -5958,7 +5951,7 @@ module.exports = {
             name: "${pm2.appName}",
             script: "${pm2.script}",
             cwd: "${paths.current}",
-            args: "${pm2.args}",
+            args: "${pm2.args ?? ""}",
             instances: 1,
             exec_mode: "fork",
             autorestart: true,
@@ -5971,6 +5964,8 @@ module.exports = {
             merge_logs: true,
             time: true,
             env: {
+                // cli-toolkit Args: ENV selects env-suffixed defaults (DB_NAME_PRODUCTION, BUCKET_PRODUCTION, \u2026)
+                ENV: "production",
                 NODE_ENV: "production",
             },
         },
@@ -5995,17 +5990,17 @@ async function initServiceStructure(service, options = {}) {
     if (!dryRun) await (0, import_promises11.mkdir)(dir, { recursive: true });
     created.push(dir);
   }
-  let ecosystemCreated = false;
-  if (await pathExists4(paths.ecosystem)) {
-    skipped.push(paths.ecosystem);
+  const ecosystemExisted = await pathExists4(paths.ecosystem);
+  if (!dryRun) {
+    await (0, import_promises11.writeFile)(paths.ecosystem, buildEcosystemConfig(service, paths), { mode: 420 });
+  }
+  if (ecosystemExisted) {
+    logger.info(`synced ${paths.ecosystem} from manifest`);
   } else {
-    if (!dryRun) {
-      await (0, import_promises11.writeFile)(paths.ecosystem, buildEcosystemConfig(service, paths), { mode: 420 });
-    }
-    ecosystemCreated = true;
     created.push(paths.ecosystem);
+    logger.info(`seeded ${paths.ecosystem}`);
   }
-  const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] init-structure service=${service.name} dryRun=${dryRun} created=${created.length} skipped=${skipped.length}
+  const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] init-structure service=${service.name} dryRun=${dryRun} created=${created.length} skipped=${skipped.length} ecosystem=synced
 `;
   if (!dryRun) {
     await (0, import_promises11.mkdir)(paths.logs, { recursive: true });
@@ -6014,8 +6009,7 @@ async function initServiceStructure(service, options = {}) {
   logger.info(`service=${service.name} appsRoot=${paths.root}`);
   logger.info(`created: ${created.length ? created.join(", ") : "(none)"}`);
   logger.info(`already present: ${skipped.length ? skipped.join(", ") : "(none)"}`);
-  if (ecosystemCreated) logger.info(`seeded ${paths.ecosystem}`);
-  return { paths, created, skipped, ecosystemCreated };
+  return { paths, created, skipped, ecosystemCreated: !ecosystemExisted, ecosystemSynced: true };
 }
 
 // src/deploy/bootstrap-host.js
@@ -6112,11 +6106,55 @@ async function installLogrotate(service, options = {}) {
   await runShell(`sudo cp '${tmp}' '${conf}'`, { logger });
   logger.info(`logrotate config written: ${conf}`);
 }
+var OPERATOR_SHELL_BEGIN = "# >>> mlsfarm-operator >>>";
+var OPERATOR_SHELL_END = "# <<< mlsfarm-operator <<<";
+async function installOperatorShell(service, options = {}) {
+  const { user = "ubuntu", dryRun = false, logger = console } = options;
+  const appsRoot = service.appsRoot;
+  if (!appsRoot) {
+    logger.warn("installOperatorShell: service.appsRoot missing \u2014 skipped");
+    return;
+  }
+  const home = user === "ubuntu" || user === process.env.USER ? (0, import_node_path9.join)((0, import_node_os2.homedir)(), ".bashrc") : `/home/${user}/.bashrc`;
+  const currentDir = (0, import_node_path9.join)(appsRoot, "current");
+  const block = [
+    OPERATOR_SHELL_BEGIN,
+    "# Managed by cli-toolkit deploy bootstrap \u2014 do not edit by hand.",
+    "export ENV=production",
+    `if [ -d "${currentDir}" ]; then`,
+    `  cd "${currentDir}" || true`,
+    "fi",
+    OPERATOR_SHELL_END,
+    ""
+  ].join("\n");
+  if (dryRun) {
+    logger.info(`[dryRun] would update ${home} (ENV=production, cd ${currentDir})`);
+    return;
+  }
+  let existing = "";
+  if (await pathExists5(home)) {
+    existing = await (0, import_promises12.readFile)(home, "utf8");
+  }
+  const begin = existing.indexOf(OPERATOR_SHELL_BEGIN);
+  const end = existing.indexOf(OPERATOR_SHELL_END);
+  let next;
+  if (begin !== -1 && end !== -1 && end > begin) {
+    const afterEnd = end + OPERATOR_SHELL_END.length;
+    const rest = existing.slice(afterEnd).replace(/^\n/, "");
+    next = `${existing.slice(0, begin).replace(/\s*$/, "\n")}${block}${rest}`;
+  } else {
+    next = `${existing.replace(/\s*$/, "\n")}
+${block}`;
+  }
+  await (0, import_promises12.writeFile)(home, next, { mode: 420 });
+  logger.info(`operator shell: ${home} \u2192 ENV=production, cd ${currentDir}`);
+}
 async function bootstrapHost(service, options = {}) {
   const { deployKey = service.deployKey, user = "ubuntu", dryRun = false, logger = console } = options;
   await ensurePm2Startup({ user, dryRun, logger });
   if (deployKey) await installDeployKey(deployKey, { dryRun, logger });
   await installLogrotate(service, { dryRun, logger });
+  await installOperatorShell(service, { user, dryRun, logger });
   logger.info("bootstrap-host complete");
 }
 
@@ -8855,6 +8893,7 @@ var TasksManager = class _TasksManager {
   h,
   initServiceStructure,
   installDeps,
+  installOperatorShell,
   ipcFileLogsTableNameForSourceResource,
   joiEdateType,
   joiStringArrayType,