@bluealba/platform-cli 0.3.1-feature-add-new-commands-226 → 0.3.1-feature-platform-cli-228

package/dist/index.js

@@ -311,7 +311,12 @@ async function scaffoldBootstrap(bootstrapServiceDir, organizationName, bootstra
     {
       templateDir: bootstrapTemplateDir,
       outputDir: bootstrapServiceDir,
-      variables: { organizationName, bootstrapName, bootstrapServiceDir: bootstrapServiceDir_var },
+      variables: {
+        organizationName,
+        bootstrapName,
+        bootstrapServiceName: `${bootstrapName}-bootstrap-service`,
+        bootstrapServiceDir: bootstrapServiceDir_var
+      },
       exclude: ["src/data/shared-libraries.json", "src/data/platform/modules-config.json"]
     },
     (message) => logger.log(message)
@@ -628,7 +633,8 @@ function addApplicationToManifest(manifest, app) {
 var CREATE_APPLICATION_COMMAND_NAME = "create-application";
 var createApplicationCommand = {
   name: CREATE_APPLICATION_COMMAND_NAME,
-  description: "Create an application in a platform"
+  description: "Create an application in a platform",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 async function createApplication(params, logger) {
   const {
@@ -871,6 +877,8 @@ async function init(params, logger) {
     platformTitle,
     platformDisplayName,
     bootstrapName: platformName,
+    bootstrapServiceName,
+    customizationUiName,
     bootstrapServiceDir: `${coreDirName}/services`
   };
   try {
@@ -1003,7 +1011,8 @@ function getAllProviders() {
 var CONFIGURE_IDP_COMMAND_NAME = "configure-idp";
 var configureIdpCommand = {
   name: CONFIGURE_IDP_COMMAND_NAME,
-  description: "Configure an Identity Provider (IDP) in the gateway"
+  description: "Configure an Identity Provider (IDP) in the gateway",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 async function configureIdp(params, logger) {
   const layout = await findPlatformLayout();
@@ -1134,7 +1143,8 @@ async function appendServiceToDockerCompose(dockerComposePath, serviceName, plat
 var CREATE_SERVICE_MODULE_COMMAND_NAME = "create-service-module";
 var createServiceModuleCommand = {
   name: CREATE_SERVICE_MODULE_COMMAND_NAME,
-  description: "Add a new service module to an existing application"
+  description: "Add a new service module to an existing application",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 async function createServiceModule(params, logger) {
   const { applicationName, serviceName, serviceDisplayName, serviceNameSuffix } = params;
@@ -1228,7 +1238,8 @@ async function appendUiToDockerCompose(dockerComposePath, platformName, applicat
 var CREATE_UI_MODULE_COMMAND_NAME = "create-ui-module";
 var createUiModuleCommand = {
   name: CREATE_UI_MODULE_COMMAND_NAME,
-  description: "Add a UI module to an existing application"
+  description: "Add a UI module to an existing application",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 async function createUiModule(params, logger) {
   const { applicationName, applicationDisplayName, uiModuleSuffix } = params;
@@ -1287,13 +1298,274 @@ async function createUiModule(params, logger) {
   logger.log(`Done! UI module "${uiName}" added to application "${applicationName}".`);
 }
 
-// src/commands/local-scripts/docker-compose-orchestrator.ts
+// src/commands/status/status-checks.ts
 import { spawn } from "child_process";
 import { access as access5 } from "fs/promises";
-import { join as join22 } from "path";
+import { join as join22, resolve as resolve4 } from "path";
+function spawnCapture(cmd, args2, cwd5) {
+  return new Promise((resolvePromise) => {
+    const child = spawn(cmd, args2, {
+      cwd: cwd5,
+      shell: false,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (data) => {
+      stdout += data.toString();
+    });
+    child.stderr.on("data", (data) => {
+      stderr += data.toString();
+    });
+    child.on("close", (code) => {
+      resolvePromise({ code: code ?? 1, stdout, stderr });
+    });
+    child.on("error", () => {
+      resolvePromise({ code: 1, stdout, stderr });
+    });
+  });
+}
+async function pathExists(p) {
+  try {
+    await access5(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function checkNodeVersion() {
+  const { code, stdout } = await spawnCapture("node", ["--version"]);
+  if (code !== 0 || !stdout.trim()) {
+    return { name: "Node.js", available: false, version: null, versionOk: false, detail: "not found in PATH" };
+  }
+  const version2 = stdout.trim();
+  const match = version2.match(/^v(\d+)/);
+  const major = match ? parseInt(match[1], 10) : 0;
+  const versionOk = major >= 22;
+  return {
+    name: "Node.js",
+    available: true,
+    version: version2,
+    versionOk,
+    detail: versionOk ? void 0 : `>=22 required, found ${version2}`
+  };
+}
+async function checkDocker() {
+  const { code, stdout } = await spawnCapture("docker", ["info", "--format", "{{.ServerVersion}}"]);
+  if (code === 0 && stdout.trim()) {
+    return { name: "Docker", available: true, version: stdout.trim(), versionOk: true };
+  }
+  const { code: vCode, stdout: vOut } = await spawnCapture("docker", ["--version"]);
+  if (vCode === 0 && vOut.trim()) {
+    return {
+      name: "Docker",
+      available: false,
+      version: null,
+      versionOk: false,
+      detail: "installed but daemon is not running"
+    };
+  }
+  return { name: "Docker", available: false, version: null, versionOk: false, detail: "not found in PATH" };
+}
+async function checkInstalled(layout, manifest) {
+  const results = [];
+  const coreCheck = {
+    name: layout.coreDirName,
+    path: join22(layout.coreDir, "node_modules"),
+    exists: await pathExists(join22(layout.coreDir, "node_modules"))
+  };
+  results.push(coreCheck);
+  for (const app of manifest.applications) {
+    const appDir = resolve4(layout.coreDir, app.localPath);
+    const nodeModulesPath = join22(appDir, "node_modules");
+    results.push({
+      name: app.name,
+      path: nodeModulesPath,
+      exists: await pathExists(nodeModulesPath)
+    });
+  }
+  return results;
+}
+async function checkBuilt(layout, manifest) {
+  const results = [];
+  const coreTurboPath = join22(layout.coreDir, ".turbo");
+  results.push({
+    name: layout.coreDirName,
+    path: coreTurboPath,
+    exists: await pathExists(coreTurboPath)
+  });
+  for (const app of manifest.applications) {
+    const appDir = resolve4(layout.coreDir, app.localPath);
+    const appTurboPath = join22(appDir, ".turbo");
+    results.push({
+      name: app.name,
+      path: appTurboPath,
+      exists: await pathExists(appTurboPath)
+    });
+  }
+  return results;
+}
+async function resolveComposeFiles(layout, manifest) {
+  const { localDir, coreDirName } = layout;
+  const platformName = manifest.product.name;
+  const files = [join22(localDir, "platform-docker-compose.yml")];
+  const prefixedCore = join22(localDir, `${coreDirName}-docker-compose.yml`);
+  const unprefixedCore = join22(localDir, "core-docker-compose.yml");
+  files.push(await pathExists(prefixedCore) ? prefixedCore : unprefixedCore);
+  for (const app of manifest.applications) {
+    const prefixed = join22(localDir, `${platformName}-${app.name}-docker-compose.yml`);
+    const unprefixed = join22(localDir, `${app.name}-docker-compose.yml`);
+    if (await pathExists(prefixed)) files.push(prefixed);
+    else if (await pathExists(unprefixed)) files.push(unprefixed);
+  }
+  return files;
+}
+async function checkContainers(layout, manifest) {
+  const platformName = manifest.product.name;
+  const projectName = `${platformName}-platform`;
+  const composeFiles = await resolveComposeFiles(layout, manifest);
+  const fileArgs = composeFiles.flatMap((f) => ["-f", f]);
+  const { code: cfgCode, stdout: cfgOut } = await spawnCapture(
+    "docker",
+    ["compose", "-p", projectName, ...fileArgs, "config", "--services"],
+    layout.rootDir
+  );
+  const expectedServices = cfgCode === 0 ? cfgOut.trim().split("\n").map((s) => s.trim()).filter(Boolean) : [];
+  const { stdout: psOut } = await spawnCapture(
+    "docker",
+    ["compose", "-p", projectName, ...fileArgs, "ps", "--format", "json"],
+    layout.rootDir
+  );
+  const runningByService = /* @__PURE__ */ new Map();
+  for (const line of psOut.trim().split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    try {
+      const obj = JSON.parse(trimmed);
+      const service = String(obj["Service"] ?? obj["Name"] ?? "");
+      if (service) {
+        runningByService.set(service, {
+          state: String(obj["State"] ?? "unknown").toLowerCase(),
+          ports: String(obj["Publishers"] ? formatPublishers(obj["Publishers"]) : obj["Ports"] ?? "")
+        });
+      }
+    } catch {
+    }
+  }
+  if (expectedServices.length > 0) {
+    return expectedServices.map((service) => {
+      const actual = runningByService.get(service);
+      return {
+        name: service,
+        state: actual ? actual.state : "not started",
+        ports: actual ? actual.ports : ""
+      };
+    });
+  }
+  return Array.from(runningByService.entries()).map(([name, info]) => ({
+    name,
+    ...info
+  }));
+}
+function formatPublishers(publishers) {
+  if (!Array.isArray(publishers)) return "";
+  return publishers.map((p) => {
+    if (typeof p !== "object" || p === null) return "";
+    const pub = p;
+    const host = pub["URL"] ?? "0.0.0.0";
+    const published = pub["PublishedPort"];
+    const target = pub["TargetPort"];
+    const proto = pub["Protocol"] ?? "tcp";
+    if (!published || !target) return "";
+    return `${host}:${published}->${target}/${proto}`;
+  }).filter(Boolean).join(", ");
+}
+function computeNextStep(result) {
+  if (!result.lifecycle.initialized) return "init";
+  if (!result.lifecycle.installed) return "install";
+  if (!result.lifecycle.built) return "build";
+  if (!result.lifecycle.running) return "start";
+  return null;
+}
+async function gatherStatus() {
+  const layout = await findPlatformLayout();
+  const [nodeCheck, dockerCheck] = await Promise.all([checkNodeVersion(), checkDocker()]);
+  const prerequisites = [nodeCheck, dockerCheck];
+  if (!layout) {
+    return {
+      projectInfo: null,
+      prerequisites,
+      lifecycle: {
+        initialized: false,
+        installed: false,
+        installedDetails: [],
+        built: false,
+        builtDetails: [],
+        running: false
+      },
+      containers: []
+    };
+  }
+  let manifest;
+  try {
+    manifest = await readManifest(layout.rootDir, layout.coreDirName);
+  } catch {
+    return {
+      projectInfo: null,
+      prerequisites,
+      lifecycle: {
+        initialized: true,
+        installed: false,
+        installedDetails: [],
+        built: false,
+        builtDetails: [],
+        running: false
+      },
+      containers: []
+    };
+  }
+  const [installedDetails, builtDetails, containers] = await Promise.all([
+    checkInstalled(layout, manifest),
+    checkBuilt(layout, manifest),
+    checkContainers(layout, manifest)
+  ]);
+  const projectInfo = {
+    productName: manifest.product.name,
+    displayName: manifest.product.displayName,
+    organization: manifest.product.organization,
+    scope: manifest.product.scope,
+    applicationCount: manifest.applications.length,
+    applicationNames: manifest.applications.map((a) => a.name)
+  };
+  return {
+    projectInfo,
+    prerequisites,
+    lifecycle: {
+      initialized: true,
+      installed: installedDetails.every((d) => d.exists),
+      installedDetails,
+      built: builtDetails.every((d) => d.exists),
+      builtDetails,
+      running: containers.length > 0 && containers.every((c) => c.state === "running")
+    },
+    containers
+  };
+}
+
+// src/commands/status/status.command.ts
+var STATUS_COMMAND_NAME = "status";
+var statusCommand = {
+  name: STATUS_COMMAND_NAME,
+  description: "Show platform status and health checks"
+};
+
+// src/commands/local-scripts/docker-compose-orchestrator.ts
+import { spawn as spawn2 } from "child_process";
+import { access as access6 } from "fs/promises";
+import { join as join23 } from "path";
 function runDockerCompose(args2, logger, rootDir, signal) {
   return new Promise((resolvePromise) => {
-    const child = spawn("docker", ["compose", ...args2], {
+    const child = spawn2("docker", ["compose", ...args2], {
       shell: false,
       stdio: ["ignore", "pipe", "pipe"],
       cwd: rootDir
@@ -1337,7 +1609,7 @@ function runDockerCompose(args2, logger, rootDir, signal) {
 }
 function captureDockerCompose(args2, rootDir) {
   return new Promise((resolvePromise, reject) => {
-    const child = spawn("docker", ["compose", ...args2], {
+    const child = spawn2("docker", ["compose", ...args2], {
       shell: false,
       stdio: ["ignore", "pipe", "pipe"],
       cwd: rootDir
@@ -1356,15 +1628,15 @@ function captureDockerCompose(args2, rootDir) {
 async function getAppComposePaths(localDir, platformName, manifest) {
   const results = [];
   for (const app of manifest.applications) {
-    const prefixedPath = join22(localDir, `${platformName}-${app.name}-docker-compose.yml`);
-    const unprefixedPath = join22(localDir, `${app.name}-docker-compose.yml`);
+    const prefixedPath = join23(localDir, `${platformName}-${app.name}-docker-compose.yml`);
+    const unprefixedPath = join23(localDir, `${app.name}-docker-compose.yml`);
     let resolved = null;
     try {
-      await access5(prefixedPath);
+      await access6(prefixedPath);
       resolved = prefixedPath;
     } catch {
       try {
-        await access5(unprefixedPath);
+        await access6(unprefixedPath);
         resolved = unprefixedPath;
       } catch {
       }
@@ -1378,18 +1650,18 @@ async function getAppComposePaths(localDir, platformName, manifest) {
 async function buildFullComposeArgs(layout, manifest, logger) {
   const { coreDirName, localDir } = layout;
   const platformName = manifest.product.name;
-  const prefixedCoreCompose = join22(localDir, `${coreDirName}-docker-compose.yml`);
-  const unprefixedCoreCompose = join22(localDir, "core-docker-compose.yml");
+  const prefixedCoreCompose = join23(localDir, `${coreDirName}-docker-compose.yml`);
+  const unprefixedCoreCompose = join23(localDir, "core-docker-compose.yml");
   let coreComposePath;
   try {
-    await access5(prefixedCoreCompose);
+    await access6(prefixedCoreCompose);
     coreComposePath = prefixedCoreCompose;
   } catch {
     coreComposePath = unprefixedCoreCompose;
   }
   const fileArgs = [
     "-f",
-    join22(localDir, "platform-docker-compose.yml"),
+    join23(localDir, "platform-docker-compose.yml"),
     "-f",
     coreComposePath
   ];
@@ -1409,16 +1681,16 @@ async function buildSelectedComposeFiles(layout, selectedManifest, includeCore)
   const platformName = selectedManifest.product.name;
   const files = [];
   if (includeCore) {
-    const prefixedCoreCompose = join22(localDir, `${coreDirName}-docker-compose.yml`);
-    const unprefixedCoreCompose = join22(localDir, "core-docker-compose.yml");
+    const prefixedCoreCompose = join23(localDir, `${coreDirName}-docker-compose.yml`);
+    const unprefixedCoreCompose = join23(localDir, "core-docker-compose.yml");
     let coreComposePath;
     try {
-      await access5(prefixedCoreCompose);
+      await access6(prefixedCoreCompose);
       coreComposePath = prefixedCoreCompose;
     } catch {
       coreComposePath = unprefixedCoreCompose;
     }
-    files.push(join22(localDir, "platform-docker-compose.yml"), coreComposePath);
+    files.push(join23(localDir, "platform-docker-compose.yml"), coreComposePath);
   }
   const appEntries = await getAppComposePaths(localDir, platformName, selectedManifest);
   for (const { composePath } of appEntries) {
@@ -1455,7 +1727,7 @@ async function getServicesFromComposeFiles(selectedFiles, allFiles, rootDir) {
 async function startEnvironment(layout, manifest, logger, signal, includeCore = true, fullManifest) {
   const { rootDir, localDir } = layout;
   const platformName = manifest.product.name;
-  const envFile = join22(localDir, ".env");
+  const envFile = join23(localDir, ".env");
   const isSelective = fullManifest !== void 0;
   const fileArgs = await buildFullComposeArgs(layout, isSelective ? fullManifest : manifest, logger);
   const projectArgs = ["-p", `${platformName}-platform`, "--project-directory", localDir, "--env-file", envFile];
@@ -1477,7 +1749,7 @@ async function startEnvironment(layout, manifest, logger, signal, includeCore =
 async function stopEnvironment(layout, manifest, logger, signal, includeCore = true, fullManifest) {
   const { rootDir, localDir } = layout;
   const platformName = manifest.product.name;
-  const envFile = join22(localDir, ".env");
+  const envFile = join23(localDir, ".env");
   const isSelective = fullManifest !== void 0;
   const fileArgs = await buildFullComposeArgs(layout, isSelective ? fullManifest : manifest, logger);
   const projectArgs = ["-p", `${platformName}-platform`, "--project-directory", localDir, "--env-file", envFile];
@@ -1499,7 +1771,7 @@ async function stopEnvironment(layout, manifest, logger, signal, includeCore = t
 async function destroyEnvironment(layout, manifest, logger, signal, includeCore = true, fullManifest) {
   const { rootDir, localDir } = layout;
   const platformName = manifest.product.name;
-  const envFile = join22(localDir, ".env");
+  const envFile = join23(localDir, ".env");
   const isSelective = fullManifest !== void 0;
   const fileArgs = await buildFullComposeArgs(layout, isSelective ? fullManifest : manifest, logger);
   const projectArgs = ["-p", `${platformName}-platform`, "--project-directory", localDir, "--env-file", envFile];
@@ -1523,12 +1795,12 @@ async function destroyEnvironment(layout, manifest, logger, signal, includeCore
 }
 
 // src/commands/local-scripts/npm-orchestrator.ts
-import { spawn as spawn2 } from "child_process";
-import { access as access6 } from "fs/promises";
-import { resolve as resolve4, join as join23 } from "path";
+import { spawn as spawn3 } from "child_process";
+import { access as access7 } from "fs/promises";
+import { resolve as resolve5, join as join24 } from "path";
 function runCommand(command, args2, workDir, logger, signal) {
   return new Promise((resolvePromise) => {
-    const child = spawn2(command, args2, {
+    const child = spawn3(command, args2, {
       cwd: workDir,
       shell: false,
       stdio: ["ignore", "pipe", "pipe"]
@@ -1572,7 +1844,7 @@ function runCommand(command, args2, workDir, logger, signal) {
 }
 async function dirExists(dirPath) {
   try {
-    await access6(dirPath);
+    await access7(dirPath);
     return true;
   } catch {
     return false;
@@ -1582,7 +1854,7 @@ async function installDependencies(layout, manifest, logger, signal, includeCore
   const { coreDir, coreDirName } = layout;
   const appDirs = [];
   for (const app of manifest.applications) {
-    const appDir = resolve4(join23(coreDir), app.localPath);
+    const appDir = resolve5(join24(coreDir), app.localPath);
     if (!await dirExists(appDir)) {
       logger.log(`Warning: Application directory "${app.name}" not found at ${appDir} \u2014 skipping install.`);
       continue;
@@ -1608,7 +1880,7 @@ async function buildAll(layout, manifest, logger, signal, includeCore = true) {
   }
   const appDirs = [];
   for (const app of manifest.applications) {
-    const appDir = resolve4(join23(coreDir), app.localPath);
+    const appDir = resolve5(join24(coreDir), app.localPath);
     if (!await dirExists(appDir)) {
       logger.log(`Warning: Application directory "${app.name}" not found at ${appDir} \u2014 skipping build.`);
       continue;
@@ -1635,23 +1907,28 @@ var DESTROY_COMMAND_NAME = "destroy";
 var CORE_APP_NAME = "core";
 var installCommand = {
   name: INSTALL_COMMAND_NAME,
-  description: "Install dependencies in the local dev environment"
+  description: "Install dependencies in the local dev environment",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 var buildCommand = {
   name: BUILD_COMMAND_NAME,
-  description: "Build the local dev environment"
+  description: "Build the local dev environment",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 var startCommand = {
   name: START_COMMAND_NAME,
-  description: "Start the local dev environment"
+  description: "Start the local dev environment",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 var stopCommand = {
   name: STOP_COMMAND_NAME,
-  description: "Stop the local dev environment"
+  description: "Stop the local dev environment",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 var destroyCommand = {
   name: DESTROY_COMMAND_NAME,
-  description: "Destroy the local dev environment"
+  description: "Destroy the local dev environment",
+  hidden: (ctx) => !ctx.platformInitialized
 };
 var localScriptCommands = [
   installCommand,
@@ -1744,14 +2021,15 @@ var CommandRegistry = class {
   }
 };
 var registry = new CommandRegistry();
-registry.register({ ...createApplicationCommand, hidden: (ctx) => !ctx.platformInitialized });
 registry.register(initCommand);
-registry.register({ ...configureIdpCommand, hidden: (ctx) => !ctx.platformInitialized });
-registry.register({ ...createServiceModuleCommand, hidden: (ctx) => !ctx.platformInitialized });
-registry.register({ ...createUiModuleCommand, hidden: (ctx) => !ctx.platformInitialized });
+registry.register(configureIdpCommand);
+registry.register(createApplicationCommand);
+registry.register(createServiceModuleCommand);
+registry.register(createUiModuleCommand);
 for (const cmd of localScriptCommands) {
-  registry.register({ ...cmd, hidden: (ctx) => !ctx.platformInitialized });
+  registry.register(cmd);
 }
+registry.register(statusCommand);
 
 // src/app-state.ts
 var APP_STATE = {
@@ -1958,11 +2236,121 @@ async function createUiModuleUiController(ctx) {
   );
 }
 
+// src/services/status.service.ts
+async function statusService() {
+  return gatherStatus();
+}
+
+// src/utils/theme.ts
+import chalk from "chalk";
+var theme = {
+  prompt: chalk.green,
+  commandName: chalk.cyan,
+  commandDescription: chalk.gray,
+  selected: chalk.bgBlue.white,
+  output: chalk.white,
+  muted: chalk.dim,
+  error: chalk.red,
+  success: chalk.green,
+  warning: chalk.yellow,
+  info: chalk.cyan,
+  section: chalk.bold.white,
+  label: chalk.dim
+};
+
+// src/commands/status/status-formatter.ts
+var CHECK = theme.success("\u2713");
+var CROSS = theme.error("\u2717");
+function tick(ok) {
+  return ok ? CHECK : CROSS;
+}
+function formatStatusLines(result) {
+  const lines = [];
+  if (result.projectInfo) {
+    const p = result.projectInfo;
+    lines.push(theme.info("\u25B8 ") + theme.section(p.displayName) + theme.label(` (${p.productName})`));
+    lines.push(theme.label("  Organization: ") + p.organization + theme.label(` (${p.scope})`));
+    const appList = p.applicationNames.length > 0 ? p.applicationNames.join(", ") : "(none)";
+    lines.push(theme.label("  Applications: ") + `${p.applicationCount} \u2014 ` + appList);
+    lines.push("");
+  }
+  lines.push(theme.section("Prerequisites"));
+  for (const pre of result.prerequisites) {
+    const ok = pre.available && pre.versionOk;
+    const versionStr = pre.version ? theme.label(` ${pre.version}`) : "";
+    const detailStr = pre.detail ? theme.warning(` \u2014 ${pre.detail}`) : "";
+    lines.push(`  ${tick(ok)} ${pre.name}${versionStr}${detailStr}`);
+  }
+  lines.push("");
+  lines.push(theme.section("Lifecycle"));
+  lines.push(`  ${tick(result.lifecycle.initialized)} Platform initialized`);
+  const installed = result.lifecycle.installed;
+  lines.push(`  ${tick(installed)} Dependencies installed`);
+  if (!installed && result.lifecycle.installedDetails.length > 0) {
+    for (const d of result.lifecycle.installedDetails) {
+      if (!d.exists) {
+        lines.push(`    ${CROSS} ${theme.label(d.name)} ${theme.warning("(missing node_modules/)")}`);
+      }
+    }
+  }
+  const built = result.lifecycle.built;
+  lines.push(`  ${tick(built)} Build completed`);
+  if (!built && result.lifecycle.builtDetails.length > 0) {
+    for (const d of result.lifecycle.builtDetails) {
+      if (!d.exists) {
+        lines.push(`    ${CROSS} ${theme.label(d.name)} ${theme.warning("(missing .turbo/)")}`);
+      }
+    }
+  }
+  lines.push(`  ${tick(result.lifecycle.running)} Environment running`);
+  if (result.containers.length > 0) {
+    lines.push("");
+    lines.push(theme.section("Containers"));
+    for (const c of result.containers) {
+      const ok = c.state === "running";
+      const stateStr = ok ? theme.success(c.state) : c.state === "not started" ? theme.label(c.state) : theme.error(c.state);
+      const ports = c.ports ? theme.label(`   ${c.ports}`) : "";
+      lines.push(`  ${tick(ok)} ${c.name.padEnd(35)} ${stateStr}${ports}`);
+    }
+  }
+  return lines;
+}
+
 // src/services/local-script.service.ts
 async function localScriptService(scriptName, logger, signal, appNames) {
   await runLocalScript(scriptName, logger, signal, appNames);
 }
 
+// src/controllers/ui/status.ui-controller.ts
+async function statusUiController(ctx) {
+  while (true) {
+    const result = await statusService();
+    for (const line of formatStatusLines(result)) {
+      ctx.log(line);
+    }
+    const next = computeNextStep(result);
+    if (next === null) {
+      ctx.log("");
+      ctx.log("All checks passed!");
+      return;
+    }
+    const shouldRun = await ctx.confirm(`Next step: "${next}". Run it now?`, true);
+    if (!shouldRun) return;
+    if (next === "init") {
+      await initUiController(ctx);
+    } else {
+      await localScriptService(next, ctx, ctx.signal);
+    }
+    const resultAfter = await statusService();
+    const nextAfter = computeNextStep(resultAfter);
+    if (nextAfter === next) {
+      ctx.log("");
+      ctx.log(`"${next}" did not complete successfully. Check the output above for errors.`);
+      return;
+    }
+  }
+}
+
 // src/controllers/ui/local-script.ui-controller.ts
 function createLocalScriptUiController(scriptName) {
   return async (ctx) => {
@@ -2008,6 +2396,7 @@ var uiControllers = /* @__PURE__ */ new Map([
   [CONFIGURE_IDP_COMMAND_NAME, configureIdpUiController],
   [CREATE_SERVICE_MODULE_COMMAND_NAME, createServiceModuleUiController],
   [CREATE_UI_MODULE_COMMAND_NAME, createUiModuleUiController],
+  [STATUS_COMMAND_NAME, statusUiController],
   [INSTALL_COMMAND_NAME, createLocalScriptUiController(INSTALL_COMMAND_NAME)],
   [BUILD_COMMAND_NAME, createLocalScriptUiController(BUILD_COMMAND_NAME)],
   [START_COMMAND_NAME, createLocalScriptUiController(START_COMMAND_NAME)],
@@ -2046,7 +2435,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
           }
         },
         prompt(message, defaultValue) {
-          return new Promise((resolve5, reject) => {
+          return new Promise((resolve6, reject) => {
             if (controller.signal.aborted) {
               reject(new DOMException("Aborted", "AbortError"));
               return;
@@ -2054,7 +2443,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
             setPromptMessage(message);
             setPromptValue(defaultValue ?? "");
             setPromptMode({ kind: "text" });
-            promptResolveRef.current = resolve5;
+            promptResolveRef.current = resolve6;
             setState(APP_STATE.PROMPTING);
             controller.signal.addEventListener(
               "abort",
@@ -2064,7 +2453,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
           });
         },
         select(message, options) {
-          return new Promise((resolve5, reject) => {
+          return new Promise((resolve6, reject) => {
             if (controller.signal.aborted) {
               reject(new DOMException("Aborted", "AbortError"));
               return;
@@ -2072,7 +2461,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
             setPromptMessage(message);
             setPromptMode({ kind: "select", options });
             setSelectIndex(0);
-            promptResolveRef.current = resolve5;
+            promptResolveRef.current = resolve6;
             setState(APP_STATE.PROMPTING);
             controller.signal.addEventListener(
               "abort",
@@ -2082,7 +2471,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
           });
         },
         multiselect(message, options) {
-          return new Promise((resolve5, reject) => {
+          return new Promise((resolve6, reject) => {
             if (controller.signal.aborted) {
               reject(new DOMException("Aborted", "AbortError"));
               return;
@@ -2092,7 +2481,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
             setSelectIndex(0);
             setMultiselectChecked(new Set(options.map((_, i) => i)));
             promptResolveRef.current = (value) => {
-              resolve5(value ? value.split(",") : []);
+              resolve6(value ? value.split(",") : []);
             };
             setState(APP_STATE.PROMPTING);
             controller.signal.addEventListener(
@@ -2103,7 +2492,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
           });
         },
         confirm(message, defaultValue) {
-          return new Promise((resolve5, reject) => {
+          return new Promise((resolve6, reject) => {
             if (controller.signal.aborted) {
               reject(new DOMException("Aborted", "AbortError"));
               return;
@@ -2111,7 +2500,7 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
             setPromptMessage(message);
             setPromptMode({ kind: "confirm" });
             setConfirmValue(defaultValue ?? true);
-            promptResolveRef.current = (value) => resolve5(value === "true");
+            promptResolveRef.current = (value) => resolve6(value === "true");
             setState(APP_STATE.PROMPTING);
             controller.signal.addEventListener(
               "abort",
@@ -2145,11 +2534,11 @@ function useCommandRunner({ appendStaticItem, setState, onCommandComplete }) {
   );
   const handlePromptSubmit = useCallback(
     (value) => {
-      const resolve5 = promptResolveRef.current;
+      const resolve6 = promptResolveRef.current;
       promptResolveRef.current = null;
       setPromptMode({ kind: "text" });
       setState(APP_STATE.EXECUTING);
-      resolve5?.(value);
+      resolve6?.(value);
     },
     [setState]
   );
@@ -2557,6 +2946,21 @@ async function createUiModuleCliController(args2) {
   );
 }
 
+// src/controllers/cli/status.cli-controller.ts
+var statusCliController = async (_args) => {
+  const result = await statusService();
+  const lines = formatStatusLines(result);
+  for (const line of lines) {
+    console.log(line);
+  }
+  const next = computeNextStep(result);
+  if (next !== null) {
+    console.log("");
+    console.log(`Hint: Run "platform ${next}" to continue.`);
+    process.exit(1);
+  }
+};
+
 // src/controllers/cli/registry.ts
 var cliControllers = /* @__PURE__ */ new Map([
   [CREATE_APPLICATION_COMMAND_NAME, createApplicationCliController],
@@ -2564,6 +2968,7 @@ var cliControllers = /* @__PURE__ */ new Map([
   [CONFIGURE_IDP_COMMAND_NAME, configureIdpCliController],
   [CREATE_SERVICE_MODULE_COMMAND_NAME, createServiceModuleCliController],
   [CREATE_UI_MODULE_COMMAND_NAME, createUiModuleCliController],
+  [STATUS_COMMAND_NAME, statusCliController],
   [INSTALL_COMMAND_NAME, createLocalScriptCliController(INSTALL_COMMAND_NAME)],
   [BUILD_COMMAND_NAME, createLocalScriptCliController(BUILD_COMMAND_NAME)],
   [START_COMMAND_NAME, createLocalScriptCliController(START_COMMAND_NAME)],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluealba/platform-cli",
-  "version": "0.3.1-feature-add-new-commands-226",
+  "version": "0.3.1-feature-platform-cli-228",
   "description": "Blue Alba Platform CLI",
   "license": "PolyForm-Noncommercial-1.0.0",
   "type": "module",

package/templates/bootstrap-service-template/Dockerfile

@@ -5,7 +5,7 @@ ENV PORT=3000
 
 RUN apk -U upgrade --no-cache
 
-WORKDIR /app/out/{{bootstrapName}}-bootstrap-service
+WORKDIR /app/out/{{bootstrapServiceName}}
 
 COPY ./out/ /app/out
 

package/templates/bootstrap-service-template/Dockerfile.development

@@ -3,7 +3,7 @@ FROM node:20.11-alpine as development
 ENV NODE_ENV=development
 ENV PORT=80
 
-WORKDIR /app/out/{{bootstrapServiceDir}}/{{bootstrapName}}-bootstrap-service
+WORKDIR /app/out/{{bootstrapServiceDir}}/{{bootstrapServiceName}}
 
 EXPOSE 80
 

package/templates/bootstrap-service-template/README.md

@@ -1,4 +1,4 @@
-# {{bootstrapName}}-bootstrap-service
+# {{bootstrapServiceName}}
 
 A service that defines the {{platformTitle}} elements such as modules, operations, roles, etc.
 

package/templates/bootstrap-service-template/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "@{{organizationName}}/{{bootstrapName}}-bootstrap-service",
+  "name": "@{{organizationName}}/{{bootstrapServiceName}}",
   "displayName": "{{platformTitle}} Bootstrap Service",
   "version": "0.1.0",
   "private": true,

package/templates/platform-init-template/{{platformName}}-core/local/{{platformName}}-core-docker-compose.yml

@@ -1,12 +1,12 @@
 # Core Services
 services:
-  {{platformName}}-bootstrap-service:
+  {{bootstrapServiceName}}:
     build:
-      context: ../services/{{platformName}}-bootstrap-service
+      context: ../services/{{bootstrapServiceName}}
       dockerfile: Dockerfile.development
     environment:
       - NODE_TLS_REJECT_UNAUTHORIZED=0
-      - SERVICE_ACCESS_NAME={{platformName}}-bootstrap-service
+      - SERVICE_ACCESS_NAME={{bootstrapServiceName}}
       - WAIT_TIME=5000
       - SYNC_STRATEGY=${PAE_BOOTSTRAP_SYNC_STRATEGY}
       - GATEWAY_SERVICE_URL=${PAE_GATEWAY_URL}
@@ -17,9 +17,9 @@ services:
       pae-nestjs-gateway-service:
         condition: service_healthy
 
-  {{platformName}}-customization-ui:
+  {{customizationUiName}}:
     build:
-      context: ../ui/{{platformName}}-customization-ui
+      context: ../ui/{{customizationUiName}}
       dockerfile: Dockerfile.development
     ports:
       - 9446:80