@hasna/microservices 0.0.19 → 0.0.21

package/bin/index.js

@@ -33,7 +33,7 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// node_modules/commander/lib/error.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
   class CommanderError extends Error {
     constructor(exitCode, code, message) {
@@ -57,7 +57,7 @@ var require_error = __commonJS((exports) => {
   exports.InvalidArgumentError = InvalidArgumentError;
 });
 
-// node_modules/commander/lib/argument.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/argument.js
 var require_argument = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -136,7 +136,7 @@ var require_argument = __commonJS((exports) => {
   exports.humanReadableArgName = humanReadableArgName;
 });
 
-// node_modules/commander/lib/help.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/help.js
 var require_help = __commonJS((exports) => {
   var { humanReadableArgName } = require_argument();
 
@@ -385,7 +385,7 @@ var require_help = __commonJS((exports) => {
   exports.Help = Help;
 });
 
-// node_modules/commander/lib/option.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/option.js
 var require_option = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -536,7 +536,7 @@ var require_option = __commonJS((exports) => {
   exports.DualOptions = DualOptions;
 });
 
-// node_modules/commander/lib/suggestSimilar.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/suggestSimilar.js
 var require_suggestSimilar = __commonJS((exports) => {
   var maxDistance = 3;
   function editDistance(a, b) {
@@ -609,13 +609,13 @@ var require_suggestSimilar = __commonJS((exports) => {
   exports.suggestSimilar = suggestSimilar;
 });
 
-// node_modules/commander/lib/command.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
   var EventEmitter = __require("events").EventEmitter;
   var childProcess = __require("child_process");
   var path = __require("path");
   var fs = __require("fs");
-  var process2 = __require("process");
+  var process3 = __require("process");
   var { Argument, humanReadableArgName } = require_argument();
   var { CommanderError } = require_error();
   var { Help } = require_help();
@@ -657,10 +657,10 @@ var require_command = __commonJS((exports) => {
       this._showHelpAfterError = false;
       this._showSuggestionAfterError = true;
       this._outputConfiguration = {
-        writeOut: (str) => process2.stdout.write(str),
-        writeErr: (str) => process2.stderr.write(str),
-        getOutHelpWidth: () => process2.stdout.isTTY ? process2.stdout.columns : undefined,
-        getErrHelpWidth: () => process2.stderr.isTTY ? process2.stderr.columns : undefined,
+        writeOut: (str) => process3.stdout.write(str),
+        writeErr: (str) => process3.stderr.write(str),
+        getOutHelpWidth: () => process3.stdout.isTTY ? process3.stdout.columns : undefined,
+        getErrHelpWidth: () => process3.stderr.isTTY ? process3.stderr.columns : undefined,
         outputError: (str, write) => write(str)
       };
       this._hidden = false;
@@ -856,7 +856,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       if (this._exitCallback) {
         this._exitCallback(new CommanderError(exitCode, code, message));
       }
-      process2.exit(exitCode);
+      process3.exit(exitCode);
     }
     action(fn) {
       const listener = (args) => {
@@ -1051,16 +1051,16 @@ Expecting one of '${allowedValues.join("', '")}'`);
       }
       parseOptions = parseOptions || {};
       if (argv === undefined && parseOptions.from === undefined) {
-        if (process2.versions?.electron) {
+        if (process3.versions?.electron) {
           parseOptions.from = "electron";
         }
-        const execArgv = process2.execArgv ?? [];
+        const execArgv = process3.execArgv ?? [];
         if (execArgv.includes("-e") || execArgv.includes("--eval") || execArgv.includes("-p") || execArgv.includes("--print")) {
           parseOptions.from = "eval";
         }
       }
       if (argv === undefined) {
-        argv = process2.argv;
+        argv = process3.argv;
       }
       this.rawArgs = argv.slice();
       let userArgs;
@@ -1071,7 +1071,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           userArgs = argv.slice(2);
           break;
         case "electron":
-          if (process2.defaultApp) {
+          if (process3.defaultApp) {
             this._scriptPath = argv[1];
             userArgs = argv.slice(2);
           } else {
@@ -1142,23 +1142,23 @@ Expecting one of '${allowedValues.join("', '")}'`);
       }
       launchWithNode = sourceExt.includes(path.extname(executableFile));
       let proc;
-      if (process2.platform !== "win32") {
+      if (process3.platform !== "win32") {
         if (launchWithNode) {
           args.unshift(executableFile);
-          args = incrementNodeInspectorPort(process2.execArgv).concat(args);
-          proc = childProcess.spawn(process2.argv[0], args, { stdio: "inherit" });
+          args = incrementNodeInspectorPort(process3.execArgv).concat(args);
+          proc = childProcess.spawn(process3.argv[0], args, { stdio: "inherit" });
         } else {
           proc = childProcess.spawn(executableFile, args, { stdio: "inherit" });
         }
       } else {
         args.unshift(executableFile);
-        args = incrementNodeInspectorPort(process2.execArgv).concat(args);
-        proc = childProcess.spawn(process2.execPath, args, { stdio: "inherit" });
+        args = incrementNodeInspectorPort(process3.execArgv).concat(args);
+        proc = childProcess.spawn(process3.execPath, args, { stdio: "inherit" });
       }
       if (!proc.killed) {
         const signals = ["SIGUSR1", "SIGUSR2", "SIGTERM", "SIGINT", "SIGHUP"];
         signals.forEach((signal) => {
-          process2.on(signal, () => {
+          process3.on(signal, () => {
             if (proc.killed === false && proc.exitCode === null) {
               proc.kill(signal);
             }
@@ -1169,7 +1169,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       proc.on("close", (code) => {
         code = code ?? 1;
         if (!exitCallback) {
-          process2.exit(code);
+          process3.exit(code);
         } else {
           exitCallback(new CommanderError(code, "commander.executeSubCommandAsync", "(close)"));
         }
@@ -1186,7 +1186,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
           throw new Error(`'${executableFile}' not executable`);
         }
         if (!exitCallback) {
-          process2.exit(1);
+          process3.exit(1);
         } else {
           const wrappedError = new CommanderError(1, "commander.executeSubCommandAsync", "(error)");
           wrappedError.nestedError = err;
@@ -1534,11 +1534,11 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     _parseOptionsEnv() {
       this.options.forEach((option) => {
-        if (option.envVar && option.envVar in process2.env) {
+        if (option.envVar && option.envVar in process3.env) {
           const optionKey = option.attributeName();
           if (this.getOptionValue(optionKey) === undefined || ["default", "config", "env"].includes(this.getOptionValueSource(optionKey))) {
             if (option.required || option.optional) {
-              this.emit(`optionEnv:${option.name()}`, process2.env[option.envVar]);
+              this.emit(`optionEnv:${option.name()}`, process3.env[option.envVar]);
             } else {
               this.emit(`optionEnv:${option.name()}`);
             }
@@ -1784,7 +1784,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     help(contextOptions) {
       this.outputHelp(contextOptions);
-      let exitCode = process2.exitCode || 0;
+      let exitCode = process3.exitCode || 0;
       if (exitCode === 0 && contextOptions && typeof contextOptions !== "function" && contextOptions.error) {
         exitCode = 1;
       }
@@ -1852,7 +1852,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
   exports.Command = Command;
 });
 
-// node_modules/commander/index.js
+// node_modules/.bun/commander@12.1.0/node_modules/commander/index.js
 var require_commander = __commonJS((exports) => {
   var { Argument } = require_argument();
   var { Command } = require_command();
@@ -1872,23 +1872,11 @@ var require_commander = __commonJS((exports) => {
   exports.InvalidOptionArgumentError = InvalidArgumentError;
 });
 
-// node_modules/commander/esm.mjs
-var import__ = __toESM(require_commander(), 1);
-var {
-  program,
-  createCommand,
-  createArgument,
-  createOption,
-  CommanderError,
-  InvalidArgumentError,
-  InvalidOptionArgumentError,
-  Command,
-  Argument,
-  Option,
-  Help
-} = import__.default;
+// src/cli/index.tsx
+import fs from "fs";
+import path from "path";
 
-// node_modules/chalk/source/vendor/ansi-styles/index.js
+// node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/vendor/ansi-styles/index.js
 var ANSI_BACKGROUND_OFFSET = 10;
 var wrapAnsi16 = (offset = 0) => (code) => `\x1B[${code + offset}m`;
 var wrapAnsi256 = (offset = 0) => (code) => `\x1B[${38 + offset};5;${code}m`;
@@ -2065,7 +2053,7 @@ function assembleStyles() {
 var ansiStyles = assembleStyles();
 var ansi_styles_default = ansiStyles;
 
-// node_modules/chalk/source/vendor/supports-color/index.js
+// node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/vendor/supports-color/index.js
 import process2 from "process";
 import os from "os";
 import tty from "tty";
@@ -2197,7 +2185,7 @@ var supportsColor = {
 };
 var supports_color_default = supportsColor;
 
-// node_modules/chalk/source/utilities.js
+// node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/utilities.js
 function stringReplaceAll(string, substring, replacer) {
   let index = string.indexOf(substring);
   if (index === -1) {
@@ -2230,7 +2218,7 @@ function stringEncaseCRLFWithFirstIndex(string, prefix, postfix, index) {
   return returnValue;
 }
 
-// node_modules/chalk/source/index.js
+// node_modules/.bun/chalk@5.6.2/node_modules/chalk/source/index.js
 var { stdout: stdoutColor, stderr: stderrColor } = supports_color_default;
 var GENERATOR = Symbol("GENERATOR");
 var STYLER = Symbol("STYLER");
@@ -2377,6 +2365,27 @@ var chalk = createChalk();
 var chalkStderr = createChalk({ level: stderrColor ? stderrColor.level : 0 });
 var source_default = chalk;
 
+// node_modules/.bun/commander@12.1.0/node_modules/commander/esm.mjs
+var import__ = __toESM(require_commander(), 1);
+var {
+  program,
+  createCommand,
+  createArgument,
+  createOption,
+  CommanderError,
+  InvalidArgumentError,
+  InvalidOptionArgumentError,
+  Command,
+  Argument,
+  Option,
+  Help
+} = import__.default;
+
+// src/lib/installer.ts
+import { execFileSync, execSync } from "child_process";
+import { accessSync, constants } from "fs";
+import { join } from "path";
+
 // src/lib/registry.ts
 var MICROSERVICES = [
   {
@@ -2387,9 +2396,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-auth",
     binary: "microservice-auth",
     schemaPrefix: "auth",
-    tags: ["auth", "users", "sessions", "jwt", "oauth", "2fa", "api-keys", "magic-links"],
+    tags: [
+      "auth",
+      "users",
+      "sessions",
+      "jwt",
+      "oauth",
+      "2fa",
+      "api-keys",
+      "magic-links"
+    ],
     requiredEnv: ["DATABASE_URL", "JWT_SECRET"],
-    optionalEnv: ["GITHUB_CLIENT_ID", "GITHUB_CLIENT_SECRET", "GOOGLE_CLIENT_ID", "GOOGLE_CLIENT_SECRET", "AUTH_PORT"]
+    optionalEnv: [
+      "GITHUB_CLIENT_ID",
+      "GITHUB_CLIENT_SECRET",
+      "GOOGLE_CLIENT_ID",
+      "GOOGLE_CLIENT_SECRET",
+      "AUTH_PORT"
+    ]
   },
   {
     name: "teams",
@@ -2399,7 +2423,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-teams",
     binary: "microservice-teams",
     schemaPrefix: "teams",
-    tags: ["teams", "workspaces", "rbac", "invites", "permissions", "multi-tenancy"],
+    tags: [
+      "teams",
+      "workspaces",
+      "rbac",
+      "invites",
+      "permissions",
+      "multi-tenancy"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["TEAMS_PORT"]
   },
@@ -2411,7 +2442,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-billing",
     binary: "microservice-billing",
     schemaPrefix: "billing",
-    tags: ["billing", "stripe", "subscriptions", "plans", "invoices", "usage", "webhooks"],
+    tags: [
+      "billing",
+      "stripe",
+      "subscriptions",
+      "plans",
+      "invoices",
+      "usage",
+      "webhooks"
+    ],
     requiredEnv: ["DATABASE_URL", "STRIPE_SECRET_KEY", "STRIPE_WEBHOOK_SECRET"],
     optionalEnv: ["BILLING_PORT"]
   },
@@ -2423,9 +2462,26 @@ var MICROSERVICES = [
     package: "@hasna/microservice-notify",
     binary: "microservice-notify",
     schemaPrefix: "notify",
-    tags: ["notifications", "email", "sms", "in-app", "webhooks", "templates", "sse"],
+    tags: [
+      "notifications",
+      "email",
+      "sms",
+      "in-app",
+      "webhooks",
+      "templates",
+      "sse"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["RESEND_API_KEY", "SMTP_HOST", "SMTP_PORT", "SMTP_USER", "SMTP_PASS", "TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN", "NOTIFY_PORT"]
+    optionalEnv: [
+      "RESEND_API_KEY",
+      "SMTP_HOST",
+      "SMTP_PORT",
+      "SMTP_USER",
+      "SMTP_PASS",
+      "TWILIO_ACCOUNT_SID",
+      "TWILIO_AUTH_TOKEN",
+      "NOTIFY_PORT"
+    ]
   },
   {
     name: "files",
@@ -2435,9 +2491,24 @@ var MICROSERVICES = [
     package: "@hasna/microservice-files",
     binary: "microservice-files",
     schemaPrefix: "files",
-    tags: ["files", "uploads", "s3", "storage", "images", "presigned-urls", "cdn"],
+    tags: [
+      "files",
+      "uploads",
+      "s3",
+      "storage",
+      "images",
+      "presigned-urls",
+      "cdn"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["S3_BUCKET", "S3_REGION", "AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "FILES_STORAGE", "FILES_PORT"]
+    optionalEnv: [
+      "S3_BUCKET",
+      "S3_REGION",
+      "AWS_ACCESS_KEY_ID",
+      "AWS_SECRET_ACCESS_KEY",
+      "FILES_STORAGE",
+      "FILES_PORT"
+    ]
   },
   {
     name: "audit",
@@ -2459,7 +2530,13 @@ var MICROSERVICES = [
     package: "@hasna/microservice-flags",
     binary: "microservice-flags",
     schemaPrefix: "flags",
-    tags: ["feature-flags", "experiments", "rollouts", "ab-testing", "targeting"],
+    tags: [
+      "feature-flags",
+      "experiments",
+      "rollouts",
+      "ab-testing",
+      "targeting"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["FLAGS_PORT"]
   },
@@ -2471,7 +2548,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-jobs",
     binary: "microservice-jobs",
     schemaPrefix: "jobs",
-    tags: ["jobs", "queues", "background", "cron", "scheduling", "workers", "retry"],
+    tags: [
+      "jobs",
+      "queues",
+      "background",
+      "cron",
+      "scheduling",
+      "workers",
+      "retry"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["JOBS_PORT", "JOBS_WORKER_CONCURRENCY"]
   },
@@ -2483,9 +2568,23 @@ var MICROSERVICES = [
     package: "@hasna/microservice-llm",
     binary: "microservice-llm",
     schemaPrefix: "llm",
-    tags: ["llm", "openai", "anthropic", "groq", "ai", "gateway", "cost-tracking", "rate-limiting"],
+    tags: [
+      "llm",
+      "openai",
+      "anthropic",
+      "groq",
+      "ai",
+      "gateway",
+      "cost-tracking",
+      "rate-limiting"
+    ],
     requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["OPENAI_API_KEY", "ANTHROPIC_API_KEY", "GROQ_API_KEY", "LLM_PORT"]
+    optionalEnv: [
+      "OPENAI_API_KEY",
+      "ANTHROPIC_API_KEY",
+      "GROQ_API_KEY",
+      "LLM_PORT"
+    ]
   },
   {
     name: "memory",
@@ -2495,7 +2594,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-memory",
     binary: "microservice-memory",
     schemaPrefix: "memory",
-    tags: ["memory", "embeddings", "pgvector", "semantic-search", "rag", "ai-agents", "recall"],
+    tags: [
+      "memory",
+      "embeddings",
+      "pgvector",
+      "semantic-search",
+      "rag",
+      "ai-agents",
+      "recall"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "MEMORY_PORT"]
   },
@@ -2507,7 +2614,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-search",
     binary: "microservice-search",
     schemaPrefix: "search",
-    tags: ["search", "full-text", "semantic", "vector", "pgvector", "hybrid", "rag"],
+    tags: [
+      "search",
+      "full-text",
+      "semantic",
+      "vector",
+      "pgvector",
+      "hybrid",
+      "rag"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "SEARCH_PORT"]
   },
@@ -2519,7 +2634,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-knowledge",
     binary: "microservice-knowledge",
     schemaPrefix: "knowledge",
-    tags: ["knowledge", "rag", "chunking", "embeddings", "retrieval", "pgvector", "documents"],
+    tags: [
+      "knowledge",
+      "rag",
+      "chunking",
+      "embeddings",
+      "retrieval",
+      "pgvector",
+      "documents"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_PORT"]
   },
@@ -2543,7 +2666,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-webhooks",
     binary: "microservice-webhooks",
     schemaPrefix: "webhooks",
-    tags: ["webhooks", "outbound", "delivery", "retry", "signing", "integrations"],
+    tags: [
+      "webhooks",
+      "outbound",
+      "delivery",
+      "retry",
+      "signing",
+      "integrations"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["WEBHOOKS_PORT"]
   },
@@ -2579,7 +2709,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-sessions",
     binary: "microservice-sessions",
     schemaPrefix: "sessions",
-    tags: ["sessions", "conversations", "chat", "messages", "context-window", "history"],
+    tags: [
+      "sessions",
+      "conversations",
+      "chat",
+      "messages",
+      "context-window",
+      "history"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["SESSIONS_PORT"]
   },
@@ -2591,22 +2728,18 @@ var MICROSERVICES = [
     package: "@hasna/microservice-guardrails",
     binary: "microservice-guardrails",
     schemaPrefix: "guardrails",
-    tags: ["guardrails", "safety", "pii", "injection", "toxicity", "moderation", "policy"],
+    tags: [
+      "guardrails",
+      "safety",
+      "pii",
+      "injection",
+      "toxicity",
+      "moderation",
+      "policy"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["GUARDRAILS_PORT"]
   },
-  {
-    name: "knowledge",
-    displayName: "Knowledge",
-    description: "RAG pipeline: document ingestion, chunking (fixed/paragraph/sentence/recursive), embedding via pgvector, retrieval with source attribution and scoring.",
-    category: "AI",
-    package: "@hasna/microservice-knowledge",
-    binary: "microservice-knowledge",
-    schemaPrefix: "knowledge",
-    tags: ["knowledge", "rag", "chunking", "ingestion", "retrieval", "documents", "pgvector"],
-    requiredEnv: ["DATABASE_URL"],
-    optionalEnv: ["OPENAI_API_KEY", "KNOWLEDGE_PORT"]
-  },
   {
     name: "traces",
     displayName: "Traces",
@@ -2615,7 +2748,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-traces",
     binary: "microservice-traces",
     schemaPrefix: "traces",
-    tags: ["traces", "tracing", "spans", "observability", "latency", "debugging", "agent-ops"],
+    tags: [
+      "traces",
+      "tracing",
+      "spans",
+      "observability",
+      "latency",
+      "debugging",
+      "agent-ops"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["TRACES_PORT"]
   },
@@ -2627,7 +2768,15 @@ var MICROSERVICES = [
     package: "@hasna/microservice-agents",
     binary: "microservice-agents",
     schemaPrefix: "agents",
-    tags: ["agents", "registry", "orchestration", "routing", "multi-agent", "capabilities", "heartbeat"],
+    tags: [
+      "agents",
+      "registry",
+      "orchestration",
+      "routing",
+      "multi-agent",
+      "capabilities",
+      "heartbeat"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["AGENTS_PORT"]
   },
@@ -2639,7 +2788,14 @@ var MICROSERVICES = [
     package: "@hasna/microservice-prompts",
     binary: "microservice-prompts",
     schemaPrefix: "prompts",
-    tags: ["prompts", "templates", "versioning", "ab-testing", "overrides", "rollback"],
+    tags: [
+      "prompts",
+      "templates",
+      "versioning",
+      "ab-testing",
+      "overrides",
+      "rollback"
+    ],
     requiredEnv: ["DATABASE_URL"],
     optionalEnv: ["PROMPTS_PORT"]
   }
@@ -2654,24 +2810,43 @@ function searchMicroservices(query) {
 }
 
 // src/lib/installer.ts
-import { execSync, execFileSync } from "child_process";
-function microserviceExists(name) {
+function getBunGlobalBinDir(env2 = process.env) {
+  const bunInstall = env2.BUN_INSTALL?.trim();
+  if (bunInstall) {
+    return join(bunInstall, "bin");
+  }
+  const home = env2.HOME?.trim();
+  if (!home) {
+    throw new Error("Unable to determine Bun global bin path: HOME is not set.");
+  }
+  return join(home, ".bun", "bin");
+}
+function resolveMicroserviceBinary(name) {
   const meta = getMicroservice(name);
   if (!meta)
-    return false;
-  try {
-    execSync(`which ${meta.binary}`, { stdio: "ignore" });
-    return true;
-  } catch {
-    return false;
+    return null;
+  const binDir = getBunGlobalBinDir();
+  const accessMode = process.platform === "win32" ? constants.F_OK : constants.X_OK;
+  const candidates = process.platform === "win32" ? [join(binDir, `${meta.binary}.cmd`), join(binDir, `${meta.binary}.exe`)] : [join(binDir, meta.binary)];
+  for (const candidate of candidates) {
+    try {
+      accessSync(candidate, accessMode);
+      return candidate;
+    } catch {}
   }
+  return null;
+}
+function microserviceExists(name) {
+  return resolveMicroserviceBinary(name) !== null;
 }
 function getMicroserviceVersion(name) {
-  const meta = getMicroservice(name);
-  if (!meta)
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath)
     return null;
   try {
-    const out = execFileSync(meta.binary, ["--version"], { encoding: "utf8" }).trim();
+    const out = execFileSync(binaryPath, ["--version"], {
+      encoding: "utf8"
+    }).trim();
     return out || null;
   } catch {
     return null;
@@ -2680,7 +2855,11 @@ function getMicroserviceVersion(name) {
 function installMicroservice(name, options = {}) {
   const meta = getMicroservice(name);
   if (!meta) {
-    return { microservice: name, success: false, error: `Unknown microservice '${name}'` };
+    return {
+      microservice: name,
+      success: false,
+      error: `Unknown microservice '${name}'`
+    };
   }
   if (microserviceExists(name) && !options.force) {
     const version = getMicroserviceVersion(name);
@@ -2701,9 +2880,6 @@ function installMicroservice(name, options = {}) {
 function installMicroservices(names, options = {}) {
   return names.map((name) => installMicroservice(name, options));
 }
-function getInstalledMicroservices() {
-  return MICROSERVICES.filter((m) => microserviceExists(m.name)).map((m) => m.name);
-}
 function removeMicroservice(name) {
   const meta = getMicroservice(name);
   if (!meta)
@@ -2724,47 +2900,15 @@ function getMicroserviceStatus(name) {
   };
 }
 
-// src/lib/runner.ts
-import { execFile } from "child_process";
-async function runMicroserviceCommand(name, args, timeout = 30000) {
-  const meta = getMicroservice(name);
-  if (!meta) {
-    return { success: false, stdout: "", stderr: `Unknown microservice '${name}'`, exitCode: 1 };
-  }
-  if (!microserviceExists(name)) {
-    return {
-      success: false,
-      stdout: "",
-      stderr: `microservice-${name} is not installed. Run: bun install -g ${meta.package}`,
-      exitCode: 1
-    };
-  }
-  return new Promise((resolve) => {
-    execFile(meta.binary, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
-      if (error && "killed" in error && error.killed) {
-        resolve({ success: false, stdout: "", stderr: "Command timed out", exitCode: 1 });
-        return;
-      }
-      const exitCode = error?.code ? typeof error.code === "number" ? error.code : 1 : 0;
-      resolve({
-        success: exitCode === 0,
-        stdout: (stdout || "").trim(),
-        stderr: (stderr || "").trim(),
-        exitCode
-      });
-    });
-  });
-}
-
 // src/lib/package-info.ts
 import { existsSync, readFileSync } from "fs";
-import { dirname, join, resolve } from "path";
+import { dirname, join as join2, resolve } from "path";
 import { fileURLToPath } from "url";
 var DEFAULT_VERSION = "0.0.1";
 function findNearestPackageJson(startDir) {
   let dir = resolve(startDir);
   while (true) {
-    const candidate = join(dir, "package.json");
+    const candidate = join2(dir, "package.json");
     if (existsSync(candidate)) {
       return candidate;
     }
@@ -2788,6 +2932,57 @@ function getPackageVersion(startDir) {
   return readPackageVersion(packageJsonPath);
 }
 
+// src/lib/runner.ts
+import { execFile } from "child_process";
+async function runMicroserviceCommand(name, args, timeout = 30000) {
+  const meta = getMicroservice(name);
+  if (!meta) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Unknown microservice '${name}'`,
+      exitCode: 1
+    };
+  }
+  if (!microserviceExists(name)) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `${meta.binary} is not installed. Run: bun install -g ${meta.package}`,
+      exitCode: 1
+    };
+  }
+  const binaryPath = resolveMicroserviceBinary(name);
+  if (!binaryPath) {
+    return {
+      success: false,
+      stdout: "",
+      stderr: `Could not resolve global binary for ${meta.binary}.`,
+      exitCode: 1
+    };
+  }
+  return new Promise((resolve2) => {
+    execFile(binaryPath, args, { timeout, maxBuffer: 10 * 1024 * 1024 }, (error, stdout, stderr) => {
+      if (error && "killed" in error && error.killed) {
+        resolve2({
+          success: false,
+          stdout: "",
+          stderr: "Command timed out",
+          exitCode: 1
+        });
+        return;
+      }
+      const exitCode = error?.code ? typeof error.code === "number" ? error.code : 1 : 0;
+      resolve2({
+        success: exitCode === 0,
+        stdout: (stdout || "").trim(),
+        stderr: (stderr || "").trim(),
+        exitCode
+      });
+    });
+  });
+}
+
 // src/cli/index.tsx
 var program2 = new Command;
 program2.name("microservices").description("Production-grade microservice building blocks for SaaS apps").version(getPackageVersion());
@@ -2846,10 +3041,10 @@ Microservice status:
 program2.command("run <name> [args...]").description("Run a command on an installed microservice").action(async (name, args) => {
   const result = await runMicroserviceCommand(name, args);
   if (result.stdout)
-    process.stdout.write(result.stdout + `
+    process.stdout.write(`${result.stdout}
 `);
   if (result.stderr)
-    process.stderr.write(result.stderr + `
+    process.stderr.write(`${result.stderr}
 `);
   process.exit(result.exitCode);
 });
@@ -2863,25 +3058,130 @@ program2.command("search <query>").description("Search microservices by name or
     console.log(`  ${source_default.cyan(m.name.padEnd(20))}  ${m.description}`);
   }
 });
-program2.command("migrate-all").description("Run migrations on all installed microservices").option("--db <url>", "PostgreSQL connection URL (overrides DATABASE_URL)").action(async (opts) => {
+program2.command("migrate-all").description("Run database migrations for all installed microservices").option("--db <url>", "PostgreSQL connection URL (overrides DATABASE_URL)").action(async (opts) => {
+  if (opts.db)
+    process.env.DATABASE_URL = opts.db;
+  const installed = MICROSERVICES.filter((m) => microserviceExists(m.name));
+  if (installed.length === 0) {
+    console.log(source_default.yellow("No microservices installed to migrate."));
+    return;
+  }
+  console.log(source_default.bold(`
+Migrating ${installed.length} installed microservices...
+`));
+  let hasErrors = false;
+  for (const m of installed) {
+    console.log(source_default.blue(`Migrating ${m.name}...`));
+    const result = await runMicroserviceCommand(m.name, ["migrate"]);
+    if (result.success) {
+      console.log(`  ${source_default.green("\u2713")} ${result.stdout.trim() || "Success"}`);
+    } else {
+      console.log(`  ${source_default.red("\u2717")} ${result.stderr.trim() || result.stdout.trim() || "Failed"}`);
+      hasErrors = true;
+    }
+  }
+  console.log();
+  if (hasErrors) {
+    console.error(source_default.red("Some migrations failed. Please check the logs above."));
+    process.exit(1);
+  } else {
+    console.log(source_default.green("\u2713 All migrations completed successfully."));
+  }
+});
+program2.command("serve-all").description("Start HTTP servers for all installed microservices concurrently").option("--db <url>", "PostgreSQL connection URL (overrides DATABASE_URL)").action(async (opts) => {
   if (opts.db)
-    process.env["DATABASE_URL"] = opts.db;
-  const installed = getInstalledMicroservices();
+    process.env.DATABASE_URL = opts.db;
+  const installed = MICROSERVICES.filter((m) => microserviceExists(m.name));
   if (installed.length === 0) {
-    console.log(source_default.yellow("No microservices installed."));
+    console.log(source_default.yellow("No microservices installed to serve."));
     return;
   }
   console.log(source_default.bold(`
-Migrating ${installed.length} microservice(s)...
+Starting ${installed.length} installed microservices...
 `));
-  for (const name of installed) {
-    const result = await runMicroserviceCommand(name, ["migrate"]);
-    if (result.success)
-      console.log(`  ${source_default.green("\u2713")} ${name}`);
-    else
-      console.log(`  ${source_default.red("\u2717")} ${name}: ${result.stderr || result.stdout}`);
+  const { spawn } = await import("child_process");
+  const procs = [];
+  const colors = [
+    source_default.cyan,
+    source_default.magenta,
+    source_default.green,
+    source_default.yellow,
+    source_default.blue
+  ];
+  for (let i = 0;i < installed.length; i++) {
+    const m = installed[i];
+    const color = colors[i % colors.length];
+    const prefix = color(`[${m.name.padEnd(10)}] `);
+    const proc = spawn(m.binary, ["serve"], {
+      env: process.env,
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    proc.stdout.on("data", (data) => {
+      const lines = data.toString().trim().split(`
+`);
+      for (const line of lines)
+        if (line)
+          console.log(`${prefix}${line}`);
+    });
+    proc.stderr.on("data", (data) => {
+      const lines = data.toString().trim().split(`
+`);
+      for (const line of lines)
+        if (line)
+          console.error(`${prefix}${source_default.red(line)}`);
+    });
+    proc.on("error", (err) => {
+      console.error(`${prefix}${source_default.red("Failed to start:")} ${err.message}`);
+    });
+    procs.push(proc);
+  }
+  process.on("SIGINT", () => {
+    console.log(source_default.yellow(`
+Stopping all microservices...`));
+    for (const p of procs)
+      p.kill("SIGINT");
+    process.exit(0);
+  });
+});
+program2.command("init-all").description("Run init (migrations) for all installed microservices").option("--db <url>", "PostgreSQL connection URL").action(async (opts) => {
+  const installed = MICROSERVICES.filter((m) => microserviceExists(m.name));
+  if (installed.length === 0) {
+    console.log(source_default.yellow("No microservices installed to init."));
+    return;
+  }
+  if (!opts.db) {
+    console.error(source_default.red("--db <url> is required. Example: microservices init-all --db postgres://localhost/myapp"));
+    process.exit(1);
+  }
+  process.env.DATABASE_URL = opts.db;
+  console.log(source_default.bold(`
+Initializing ${installed.length} installed microservices...
+`));
+  let hasErrors = false;
+  for (const m of installed) {
+    console.log(source_default.blue(`Initializing ${m.name}...`));
+    const result = await runMicroserviceCommand(m.name, [
+      "init",
+      "--db",
+      opts.db
+    ]);
+    if (result.success) {
+      console.log(`  ${source_default.green("\u2713")} ${result.stdout.trim().split(`
+`).join(`
+  `) || "Success"}`);
+    } else {
+      console.log(`  ${source_default.red("\u2717")} ${result.stderr.trim() || result.stdout.trim() || "Failed"}`);
+      hasErrors = true;
+    }
   }
   console.log();
+  if (hasErrors) {
+    console.error(source_default.red("Some inits failed. Please check the logs above."));
+    process.exit(1);
+  } else {
+    console.log(source_default.green("\u2713 All services initialized successfully."));
+    console.log(source_default.gray("  You can now run 'microservices serve-all' to start them."));
+  }
 });
 program2.command("info <name>").description("Show detailed info about a microservice").action((name) => {
   const m = getMicroservice(name);
@@ -2904,4 +3204,89 @@ ${m.displayName}`));
   console.log(`  Tags:        ${m.tags.join(", ")}`);
   console.log();
 });
+program2.command("check-env").description("Verify environment variables for all installed microservices").action(() => {
+  const installed = MICROSERVICES.filter((m) => microserviceExists(m.name));
+  if (installed.length === 0) {
+    console.log(source_default.yellow("No microservices installed to check."));
+    return;
+  }
+  console.log(source_default.bold(`
+Checking environment for ${installed.length} microservices...
+`));
+  let totalMissing = 0;
+  for (const m of installed) {
+    const missingRequired = m.requiredEnv.filter((env2) => !process.env[env2]);
+    const missingOptional = (m.optionalEnv ?? []).filter((env2) => !process.env[env2]);
+    const status = missingRequired.length > 0 ? source_default.red("\u2717 Critical Missing") : missingOptional.length > 0 ? source_default.yellow("\u26A0 Warning") : source_default.green("\u2713 OK");
+    console.log(`${source_default.bold(m.name.padEnd(12))} [${status}]`);
+    if (missingRequired.length > 0) {
+      console.log(source_default.red(`  Required missing: ${missingRequired.join(", ")}`));
+      totalMissing += missingRequired.length;
+    }
+    if (missingOptional.length > 0) {
+      console.log(source_default.gray(`  Optional missing: ${missingOptional.join(", ")}`));
+    }
+    if (missingRequired.length === 0 && missingOptional.length === 0) {
+      console.log(source_default.gray("  All variables set."));
+    }
+    console.log();
+  }
+  if (totalMissing > 0) {
+    console.log(source_default.red(`Found ${totalMissing} missing required environment variables.`));
+    console.log(source_default.gray(`Refer to .env.example for guidance.
+`));
+    process.exit(1);
+  } else {
+    console.log(source_default.green(`\u2713 All required environment variables are set across all installed services.
+`));
+  }
+});
+program2.command("scaffold <name>").description("Scaffold a new microservice from the _template directory").action((name) => {
+  if (!/^[a-z0-9-]+$/.test(name)) {
+    console.error(source_default.red("Error: Name can only contain lowercase letters, numbers, and dashes."));
+    process.exit(1);
+  }
+  const cwd = process.cwd();
+  const templateDir = path.join(cwd, "microservices", "_template");
+  const targetDir = path.join(cwd, "microservices", `microservice-${name}`);
+  if (!fs.existsSync(templateDir)) {
+    console.error(source_default.red(`Template directory not found at ${templateDir}. Make sure you are running this from the monorepo root.`));
+    process.exit(1);
+  }
+  if (fs.existsSync(targetDir)) {
+    console.error(source_default.red(`Target directory already exists at ${targetDir}`));
+    process.exit(1);
+  }
+  console.log(source_default.bold(`
+Scaffolding microservice-${name}...
+`));
+  fs.cpSync(templateDir, targetDir, { recursive: true });
+  const replaceInFile = (filePath) => {
+    const content = fs.readFileSync(filePath, "utf-8");
+    let updated = content.replace(/__NAME__/g, name.toUpperCase().replace(/-/g, "_"));
+    updated = updated.replace(/__Name__/g, name.charAt(0).toUpperCase() + name.slice(1));
+    updated = updated.replace(/__name__/g, name);
+    fs.writeFileSync(filePath, updated, "utf-8");
+  };
+  const walkAndReplace = (dir) => {
+    const files = fs.readdirSync(dir);
+    for (const file of files) {
+      const filePath = path.join(dir, file);
+      if (fs.statSync(filePath).isDirectory()) {
+        walkAndReplace(filePath);
+      } else {
+        replaceInFile(filePath);
+      }
+    }
+  };
+  walkAndReplace(targetDir);
+  console.log(`  ${source_default.green("\u2713")} Created microservices/microservice-${name}`);
+  console.log(source_default.gray(`
+  Next steps:
+  1. Add entry to src/lib/registry.ts
+  2. Implement schema, core logic, HTTP API, MCP, and CLI
+  3. Run 'bun install' to link the workspace
+  4. Run 'bun run build'
+    `));
+});
 program2.parse();