@objectstack/cli 2.0.6 → 2.0.7

package/dist/index.js

@@ -62,10 +62,10 @@ function formatZodErrors(error) {
     console.log(chalk.bold.red(`
   ${section}:`));
     for (const issue of sectionIssues) {
-      const path11 = issue.path?.join(".") || "";
+      const path12 = issue.path?.join(".") || "";
       const code = issue.code || "";
       const msg = issue.message || "";
-      console.log(chalk.red(`    \u2717 ${path11}`));
+      console.log(chalk.red(`    \u2717 ${path12}`));
       console.log(chalk.dim(`      ${code}: ${msg}`));
       if (issue.expected) {
         console.log(chalk.dim(`      expected: ${chalk.green(issue.expected)}`));
@@ -1238,16 +1238,261 @@ var createCommand = new Command6("create").description("Create a new package, pl
   }
 });
 
-// src/commands/dev.ts
+// src/commands/plugin.ts
 import { Command as Command7 } from "commander";
 import chalk9 from "chalk";
-import { execSync, spawn } from "child_process";
 import fs6 from "fs";
 import path6 from "path";
-var devCommand = new Command7("dev").description("Start development mode with hot-reload").argument("[package]", "Package name or filter pattern", "all").option("-w, --watch", "Enable watch mode (default)", true).option("--ui", "Enable Studio UI at /_studio/").option("-v, --verbose", "Verbose output").action(async (packageName, options) => {
+function resolvePluginName(plugin) {
+  if (typeof plugin === "string") return plugin;
+  if (plugin && typeof plugin === "object") {
+    const p = plugin;
+    if (typeof p.name === "string") return p.name;
+    if (p.constructor && p.constructor.name !== "Object") return p.constructor.name;
+  }
+  return "unknown";
+}
+function resolvePluginVersion(plugin) {
+  if (plugin && typeof plugin === "object") {
+    const p = plugin;
+    if (typeof p.version === "string") return p.version;
+  }
+  return "-";
+}
+function resolvePluginType(plugin) {
+  if (plugin && typeof plugin === "object") {
+    const p = plugin;
+    if (typeof p.type === "string") return p.type;
+  }
+  return "standard";
+}
+function readConfigText(configPath) {
+  return fs6.readFileSync(configPath, "utf-8");
+}
+function addPluginToConfig(configPath, packageName) {
+  let content = readConfigText(configPath);
+  const shortName = packageName.replace(/^@[^/]+\//, "").replace(/^plugin-/, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  const varName = shortName.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) + "Plugin";
+  const importLine = `import ${varName} from '${packageName}';
+`;
+  if (content.includes(packageName)) {
+    throw new Error(`Plugin '${packageName}' is already referenced in the config`);
+  }
+  const importRegex = /^import .+$/gm;
+  let lastImportEnd = 0;
+  let match;
+  while ((match = importRegex.exec(content)) !== null) {
+    lastImportEnd = match.index + match[0].length;
+  }
+  if (lastImportEnd > 0) {
+    content = content.slice(0, lastImportEnd) + "\n" + importLine + content.slice(lastImportEnd);
+  } else {
+    content = importLine + "\n" + content;
+  }
+  if (/plugins\s*:\s*\[/.test(content)) {
+    let replaced = false;
+    content = content.replace(
+      /(plugins\s*:\s*\[)/,
+      (match2) => {
+        if (replaced) return match2;
+        replaced = true;
+        return `${match2}
+    ${varName},`;
+      }
+    );
+  } else {
+    content = content.replace(
+      /(defineStack\(\{[\s\S]*?)(}\s*\))/,
+      `$1  plugins: [
+    ${varName},
+  ],
+$2`
+    );
+  }
+  fs6.writeFileSync(configPath, content);
+}
+function removePluginFromConfig(configPath, pluginName) {
+  let content = readConfigText(configPath);
+  const importRegex = new RegExp(`^import .+['"]${escapeRegex(pluginName)}['"]\\s*;?\\s*$\\n?`, "gm");
+  const hadImport = importRegex.test(content);
+  importRegex.lastIndex = 0;
+  content = content.replace(importRegex, "");
+  const shortName = pluginName.replace(/^@[^/]+\//, "").replace(/^plugin-/, "").replace(/-+/g, "-").replace(/^-|-$/g, "");
+  const varName = shortName.replace(/-([a-z])/g, (_, c) => c.toUpperCase()) + "Plugin";
+  if (!hadImport) {
+    const varImportRegex = new RegExp(`^import .* ${escapeRegex(varName)} .+$\\n?`, "gm");
+    content = content.replace(varImportRegex, "");
+  }
+  const entryPatterns = [
+    new RegExp(`\\s*${escapeRegex(varName)},?\\n?`, "g"),
+    new RegExp(`\\s*['"]${escapeRegex(pluginName)}['"],?\\n?`, "g")
+  ];
+  for (const pattern of entryPatterns) {
+    content = content.replace(pattern, "\n");
+  }
+  content = content.replace(/plugins\s*:\s*\[\s*\],?\n?/g, "");
+  fs6.writeFileSync(configPath, content);
+}
+function escapeRegex(str) {
+  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+var listCommand = new Command7("list").alias("ls").description("List plugins defined in the configuration").argument("[config]", "Configuration file path").option("--json", "Output as JSON").action(async (configSource, options) => {
+  try {
+    const { config } = await loadConfig(configSource);
+    const plugins = config.plugins || [];
+    const devPlugins = config.devPlugins || [];
+    if (options?.json) {
+      const data = {
+        plugins: plugins.map((p) => ({
+          name: resolvePluginName(p),
+          version: resolvePluginVersion(p),
+          type: resolvePluginType(p),
+          dev: false
+        })),
+        devPlugins: devPlugins.map((p) => ({
+          name: resolvePluginName(p),
+          version: resolvePluginVersion(p),
+          type: resolvePluginType(p),
+          dev: true
+        }))
+      };
+      console.log(JSON.stringify(data, null, 2));
+      return;
+    }
+    printHeader("Plugins");
+    if (plugins.length === 0 && devPlugins.length === 0) {
+      printInfo("No plugins configured");
+      console.log("");
+      console.log(chalk9.dim("  Hint: Add plugins to your objectstack.config.ts"));
+      console.log(chalk9.dim("  Or run: os plugin add <package-name>"));
+      console.log("");
+      return;
+    }
+    if (plugins.length > 0) {
+      console.log(chalk9.bold(`
+  Plugins (${plugins.length}):`));
+      for (const plugin of plugins) {
+        const name = resolvePluginName(plugin);
+        const version = resolvePluginVersion(plugin);
+        const type = resolvePluginType(plugin);
+        console.log(
+          `    ${chalk9.cyan("\u25CF")} ${chalk9.white(name)}` + (version !== "-" ? chalk9.dim(` v${version}`) : "") + (type !== "standard" ? chalk9.dim(` [${type}]`) : "")
+        );
+      }
+    }
+    if (devPlugins.length > 0) {
+      console.log(chalk9.bold(`
+  Dev Plugins (${devPlugins.length}):`));
+      for (const plugin of devPlugins) {
+        const name = resolvePluginName(plugin);
+        const version = resolvePluginVersion(plugin);
+        console.log(
+          `    ${chalk9.yellow("\u25CF")} ${chalk9.white(name)}` + (version !== "-" ? chalk9.dim(` v${version}`) : "") + chalk9.dim(" [dev]")
+        );
+      }
+    }
+    console.log("");
+  } catch (error) {
+    printError(error.message || String(error));
+    process.exit(1);
+  }
+});
+var infoSubCommand = new Command7("info").description("Show detailed information about a plugin").argument("<name>", "Plugin name or package name").argument("[config]", "Configuration file path").action(async (name, configSource) => {
+  try {
+    const { config } = await loadConfig(configSource);
+    const allPlugins = [
+      ...config.plugins || [],
+      ...config.devPlugins || []
+    ];
+    const found = allPlugins.find((p) => {
+      const pName = resolvePluginName(p);
+      return pName === name || pName.includes(name);
+    });
+    if (!found) {
+      printError(`Plugin '${name}' not found in configuration`);
+      console.log("");
+      console.log(chalk9.dim("  Available plugins:"));
+      for (const p of allPlugins) {
+        console.log(chalk9.dim(`    - ${resolvePluginName(p)}`));
+      }
+      console.log("");
+      process.exit(1);
+    }
+    printHeader(`Plugin: ${resolvePluginName(found)}`);
+    printKV("Name", resolvePluginName(found));
+    printKV("Version", resolvePluginVersion(found));
+    printKV("Type", resolvePluginType(found));
+    const isDev = (config.devPlugins || []).includes(found);
+    printKV("Environment", isDev ? "development" : "production");
+    if (found && typeof found === "object") {
+      const p = found;
+      if (typeof p.description === "string") {
+        printKV("Description", p.description);
+      }
+      if (Array.isArray(p.dependencies) && p.dependencies.length > 0) {
+        printKV("Dependencies", p.dependencies.join(", "));
+      }
+      if (typeof p.init === "function") {
+        printInfo("This is a runtime plugin instance (has init function)");
+      }
+    }
+    if (typeof found === "string") {
+      printInfo("This is a string reference (will be imported at runtime)");
+    }
+    console.log("");
+  } catch (error) {
+    printError(error.message || String(error));
+    process.exit(1);
+  }
+});
+var addCommand = new Command7("add").description("Add a plugin to objectstack.config.ts").argument("<package>", "Plugin package name (e.g. @objectstack/plugin-auth)").option("-d, --dev", "Add as a dev-only plugin").option("-c, --config <path>", "Configuration file path").action(async (packageName, options) => {
+  try {
+    const configPath = resolveConfigPath(options?.config);
+    printHeader("Add Plugin");
+    console.log(`  ${chalk9.dim("Package:")} ${chalk9.white(packageName)}`);
+    console.log(`  ${chalk9.dim("Config:")}  ${chalk9.white(path6.relative(process.cwd(), configPath))}`);
+    console.log("");
+    addPluginToConfig(configPath, packageName);
+    printSuccess(`Added ${chalk9.cyan(packageName)} to config`);
+    console.log("");
+    console.log(chalk9.dim("  Next steps:"));
+    console.log(chalk9.dim(`  1. Install the package: pnpm add ${packageName}`));
+    console.log(chalk9.dim("  2. Run: os validate"));
+    console.log("");
+  } catch (error) {
+    printError(error.message || String(error));
+    process.exit(1);
+  }
+});
+var removeCommand = new Command7("remove").alias("rm").description("Remove a plugin from objectstack.config.ts").argument("<name>", "Plugin name or package name to remove").option("-c, --config <path>", "Configuration file path").action(async (pluginName, options) => {
+  try {
+    const configPath = resolveConfigPath(options?.config);
+    printHeader("Remove Plugin");
+    console.log(`  ${chalk9.dim("Plugin:")} ${chalk9.white(pluginName)}`);
+    console.log(`  ${chalk9.dim("Config:")} ${chalk9.white(path6.relative(process.cwd(), configPath))}`);
+    console.log("");
+    removePluginFromConfig(configPath, pluginName);
+    printSuccess(`Removed ${chalk9.cyan(pluginName)} from config`);
+    console.log("");
+    console.log(chalk9.dim("  Tip: Run `pnpm remove " + pluginName + "` to uninstall the package"));
+    console.log("");
+  } catch (error) {
+    printError(error.message || String(error));
+    process.exit(1);
+  }
+});
+var pluginCommand = new Command7("plugin").description("Manage plugins (list, info, add, remove)").addCommand(listCommand).addCommand(infoSubCommand).addCommand(addCommand).addCommand(removeCommand);
+
+// src/commands/dev.ts
+import { Command as Command8 } from "commander";
+import chalk10 from "chalk";
+import { execSync, spawn } from "child_process";
+import fs7 from "fs";
+import path7 from "path";
+var devCommand = new Command8("dev").description("Start development mode with hot-reload").argument("[package]", "Package name or filter pattern", "all").option("-w, --watch", "Enable watch mode (default)", true).option("--ui", "Enable Studio UI at /_studio/").option("-v, --verbose", "Verbose output").action(async (packageName, options) => {
   printHeader("Development Mode");
-  const configPath = path6.resolve(process.cwd(), "objectstack.config.ts");
-  if (packageName === "all" && fs6.existsSync(configPath)) {
+  const configPath = path7.resolve(process.cwd(), "objectstack.config.ts");
+  if (packageName === "all" && fs7.existsSync(configPath)) {
     printKV("Config", configPath, "\u{1F4C2}");
     printStep("Starting dev server...");
     const binPath = process.argv[1];
@@ -1259,18 +1504,18 @@ var devCommand = new Command7("dev").description("Start development mode with ho
   }
   try {
     const cwd = process.cwd();
-    const workspaceConfigPath = path6.resolve(cwd, "pnpm-workspace.yaml");
-    const isWorkspaceRoot = fs6.existsSync(workspaceConfigPath);
+    const workspaceConfigPath = path7.resolve(cwd, "pnpm-workspace.yaml");
+    const isWorkspaceRoot = fs7.existsSync(workspaceConfigPath);
     if (packageName === "all" && !isWorkspaceRoot) {
       printError(`Config file not found in ${cwd}`);
-      console.error(chalk9.yellow("  Run in a directory with objectstack.config.ts, or from the monorepo root."));
+      console.error(chalk10.yellow("  Run in a directory with objectstack.config.ts, or from the monorepo root."));
       process.exit(1);
     }
     const filter = packageName === "all" ? "" : `--filter ${packageName}`;
     printKV("Package", packageName === "all" ? "All packages" : packageName, "\u{1F4E6}");
     printKV("Watch", "enabled", "\u{1F504}");
     const command = `pnpm ${filter} dev`.trim();
-    console.log(chalk9.dim(`$ ${command}`));
+    console.log(chalk10.dim(`$ ${command}`));
     console.log("");
     execSync(command, {
       stdio: "inherit",
@@ -1283,38 +1528,38 @@ var devCommand = new Command7("dev").description("Start development mode with ho
 });
 
 // src/commands/serve.ts
-import { Command as Command8 } from "commander";
-import path8 from "path";
-import fs8 from "fs";
+import { Command as Command9 } from "commander";
+import path9 from "path";
+import fs9 from "fs";
 import net from "net";
-import chalk10 from "chalk";
+import chalk11 from "chalk";
 import { bundleRequire as bundleRequire2 } from "bundle-require";
 
 // src/utils/studio.ts
-import path7 from "path";
-import fs7 from "fs";
+import path8 from "path";
+import fs8 from "fs";
 import { createRequire } from "module";
 import { pathToFileURL } from "url";
 var STUDIO_PATH = "/_studio";
 function resolveStudioPath() {
   const cwd = process.cwd();
   const candidates = [
-    path7.resolve(cwd, "apps/studio"),
-    path7.resolve(cwd, "../../apps/studio"),
-    path7.resolve(cwd, "../apps/studio")
+    path8.resolve(cwd, "apps/studio"),
+    path8.resolve(cwd, "../../apps/studio"),
+    path8.resolve(cwd, "../apps/studio")
   ];
   for (const candidate of candidates) {
-    const pkgPath = path7.join(candidate, "package.json");
-    if (fs7.existsSync(pkgPath)) {
+    const pkgPath = path8.join(candidate, "package.json");
+    if (fs8.existsSync(pkgPath)) {
       try {
-        const pkg = JSON.parse(fs7.readFileSync(pkgPath, "utf-8"));
+        const pkg = JSON.parse(fs8.readFileSync(pkgPath, "utf-8"));
         if (pkg.name === "@objectstack/studio") return candidate;
       } catch {
       }
     }
   }
   const resolutionBases = [
-    pathToFileURL(path7.join(cwd, "package.json")).href,
+    pathToFileURL(path8.join(cwd, "package.json")).href,
     // consumer workspace
     import.meta.url
     // CLI package itself
@@ -1323,18 +1568,18 @@ function resolveStudioPath() {
     try {
       const req = createRequire(base);
       const resolved = req.resolve("@objectstack/studio/package.json");
-      return path7.dirname(resolved);
+      return path8.dirname(resolved);
     } catch {
     }
   }
-  const directPath = path7.join(cwd, "node_modules", "@objectstack", "studio");
-  if (fs7.existsSync(path7.join(directPath, "package.json"))) {
+  const directPath = path8.join(cwd, "node_modules", "@objectstack", "studio");
+  if (fs8.existsSync(path8.join(directPath, "package.json"))) {
     return directPath;
   }
   return null;
 }
 function hasStudioDist(studioPath) {
-  return fs7.existsSync(path7.join(studioPath, "dist", "index.html"));
+  return fs8.existsSync(path8.join(studioPath, "dist", "index.html"));
 }
 function createStudioStaticPlugin(distPath, options) {
   return {
@@ -1348,13 +1593,13 @@ function createStudioStaticPlugin(distPath, options) {
         return;
       }
       const app = httpServer.getRawApp();
-      const absoluteDist = path7.resolve(distPath);
-      const indexPath = path7.join(absoluteDist, "index.html");
-      if (!fs7.existsSync(indexPath)) {
+      const absoluteDist = path8.resolve(distPath);
+      const indexPath = path8.join(absoluteDist, "index.html");
+      if (!fs8.existsSync(indexPath)) {
         ctx.logger?.warn?.(`Studio static: dist not found at ${absoluteDist}`);
         return;
       }
-      const rawHtml = fs7.readFileSync(indexPath, "utf-8");
+      const rawHtml = fs8.readFileSync(indexPath, "utf-8");
       const rewrittenHtml = rawHtml.replace(
         /(\s(?:href|src))="\/(?!\/)/g,
         `$1="${STUDIO_PATH}/`
@@ -1365,12 +1610,12 @@ function createStudioStaticPlugin(distPath, options) {
       app.get(STUDIO_PATH, (c) => c.redirect(`${STUDIO_PATH}/`));
       app.get(`${STUDIO_PATH}/*`, async (c) => {
         const reqPath = c.req.path.substring(STUDIO_PATH.length) || "/";
-        const filePath = path7.join(absoluteDist, reqPath);
+        const filePath = path8.join(absoluteDist, reqPath);
         if (!filePath.startsWith(absoluteDist)) {
           return c.text("Forbidden", 403);
         }
-        if (fs7.existsSync(filePath) && fs7.statSync(filePath).isFile()) {
-          const content = fs7.readFileSync(filePath);
+        if (fs8.existsSync(filePath) && fs8.statSync(filePath).isFile()) {
+          const content = fs8.readFileSync(filePath);
           return new Response(content, {
             headers: { "content-type": mimeType(filePath) }
           });
@@ -1400,7 +1645,7 @@ var MIME_TYPES = {
   ".map": "application/json"
 };
 function mimeType(filePath) {
-  const ext = path7.extname(filePath).toLowerCase();
+  const ext = path8.extname(filePath).toLowerCase();
   return MIME_TYPES[ext] || "application/octet-stream";
 }
 
@@ -1427,7 +1672,7 @@ var getAvailablePort = async (startPort) => {
   }
   return port;
 };
-var serveCommand = new Command8("serve").description("Start ObjectStack server with plugins from configuration").argument("[config]", "Configuration file path", "objectstack.config.ts").option("-p, --port <port>", "Server port", "3000").option("--dev", "Run in development mode (load devPlugins)").option("--ui", "Enable Studio UI at /_studio/ (default: true in dev mode)").option("--no-server", "Skip starting HTTP server plugin").action(async (configPath, options) => {
+var serveCommand = new Command9("serve").description("Start ObjectStack server with plugins from configuration").argument("[config]", "Configuration file path", "objectstack.config.ts").option("-p, --port <port>", "Server port", "3000").option("--dev", "Run in development mode (load devPlugins)").option("--ui", "Enable Studio UI at /_studio/ (default: true in dev mode)").option("--no-server", "Skip starting HTTP server plugin").action(async (configPath, options) => {
   let port = parseInt(options.port);
   try {
     const availablePort = await getAvailablePort(port);
@@ -1437,15 +1682,15 @@ var serveCommand = new Command8("serve").description("Start ObjectStack server w
   } catch (e) {
   }
   const isDev = options.dev || process.env.NODE_ENV === "development";
-  const absolutePath = path8.resolve(process.cwd(), configPath);
-  const relativeConfig = path8.relative(process.cwd(), absolutePath);
-  if (!fs8.existsSync(absolutePath)) {
+  const absolutePath = path9.resolve(process.cwd(), configPath);
+  const relativeConfig = path9.relative(process.cwd(), absolutePath);
+  if (!fs9.existsSync(absolutePath)) {
     printError(`Configuration file not found: ${absolutePath}`);
-    console.log(chalk10.dim("  Hint: Run `objectstack init` to create a new project"));
+    console.log(chalk11.dim("  Hint: Run `objectstack init` to create a new project"));
     process.exit(1);
   }
   console.log("");
-  console.log(chalk10.dim(`  Loading ${relativeConfig}...`));
+  console.log(chalk11.dim(`  Loading ${relativeConfig}...`));
   const loadedPlugins = [];
   const shortPluginName = (raw) => {
     if (raw.includes("objectql")) return "ObjectQL";
@@ -1549,7 +1794,7 @@ var serveCommand = new Command8("serve").description("Start ObjectStack server w
           const pluginName = plugin.name || plugin.constructor?.name || "unnamed";
           trackPlugin(pluginName);
         } catch (e) {
-          console.error(chalk10.red(`  \u2717 Failed to load plugin: ${e.message}`));
+          console.error(chalk11.red(`  \u2717 Failed to load plugin: ${e.message}`));
         }
       }
     }
@@ -1560,7 +1805,7 @@ var serveCommand = new Command8("serve").description("Start ObjectStack server w
         await kernel.use(serverPlugin);
         trackPlugin("HonoServer");
       } catch (e) {
-        console.warn(chalk10.yellow(`  \u26A0 HTTP server plugin not available: ${e.message}`));
+        console.warn(chalk11.yellow(`  \u26A0 HTTP server plugin not available: ${e.message}`));
       }
       try {
         const { createRestApiPlugin } = await import("@objectstack/rest");
@@ -1579,13 +1824,13 @@ var serveCommand = new Command8("serve").description("Start ObjectStack server w
     if (enableUI) {
       const studioPath = resolveStudioPath();
       if (!studioPath) {
-        console.warn(chalk10.yellow(`  \u26A0 @objectstack/studio not found \u2014 skipping UI`));
+        console.warn(chalk11.yellow(`  \u26A0 @objectstack/studio not found \u2014 skipping UI`));
       } else if (hasStudioDist(studioPath)) {
-        const distPath = path8.join(studioPath, "dist");
+        const distPath = path9.join(studioPath, "dist");
         await kernel.use(createStudioStaticPlugin(distPath, { isDev }));
         trackPlugin("StudioUI");
       } else {
-        console.warn(chalk10.yellow(`  \u26A0 Studio dist not found \u2014 run "pnpm --filter @objectstack/studio build" first`));
+        console.warn(chalk11.yellow(`  \u26A0 Studio dist not found \u2014 run "pnpm --filter @objectstack/studio build" first`));
       }
     }
     await runtime.start();
@@ -1601,33 +1846,33 @@ var serveCommand = new Command8("serve").description("Start ObjectStack server w
       studioPath: STUDIO_PATH
     });
     process.on("SIGINT", async () => {
-      console.warn(chalk10.yellow(`
+      console.warn(chalk11.yellow(`
 
 \u23F9  Stopping server...`));
       await runtime.getKernel().shutdown();
-      console.log(chalk10.green(`\u2705 Server stopped`));
+      console.log(chalk11.green(`\u2705 Server stopped`));
       process.exit(0);
     });
   } catch (error) {
     restoreOutput();
     console.log("");
     printError(error.message || String(error));
-    if (process.env.DEBUG) console.error(chalk10.dim(error.stack));
+    if (process.env.DEBUG) console.error(chalk11.dim(error.stack));
     process.exit(1);
   }
 });
 
 // src/commands/test.ts
-import { Command as Command9 } from "commander";
-import chalk11 from "chalk";
-import path9 from "path";
-import fs9 from "fs";
+import { Command as Command10 } from "commander";
+import chalk12 from "chalk";
+import path10 from "path";
+import fs10 from "fs";
 import { QA as CoreQA } from "@objectstack/core";
 function resolveGlob(pattern) {
   if (!pattern.includes("*")) {
-    return fs9.existsSync(pattern) ? [pattern] : [];
+    return fs10.existsSync(pattern) ? [pattern] : [];
   }
-  const parts = pattern.split(path9.sep.replace("\\", "/"));
+  const parts = pattern.split(path10.sep.replace("\\", "/"));
   const segments = pattern.includes("/") ? pattern.split("/") : parts;
   let baseDir = ".";
   let globStart = 0;
@@ -1636,25 +1881,25 @@ function resolveGlob(pattern) {
       globStart = i;
       break;
     }
-    baseDir = i === 0 ? segments[i] : path9.join(baseDir, segments[i]);
+    baseDir = i === 0 ? segments[i] : path10.join(baseDir, segments[i]);
   }
-  if (!fs9.existsSync(baseDir)) return [];
+  if (!fs10.existsSync(baseDir)) return [];
   const globPortion = segments.slice(globStart).join("/");
   const regexStr = globPortion.replace(/\./g, "\\.").replace(/\*\*\//g, "(.+/)?").replace(/\*\*/g, ".*").replace(/\*/g, "[^/]*");
   const regex = new RegExp(`^${regexStr}$`);
-  const entries = fs9.readdirSync(baseDir, { recursive: true, encoding: "utf-8" });
-  return entries.filter((entry) => regex.test(entry.replace(/\\/g, "/"))).map((entry) => path9.join(baseDir, entry)).filter((fullPath) => fs9.statSync(fullPath).isFile());
+  const entries = fs10.readdirSync(baseDir, { recursive: true, encoding: "utf-8" });
+  return entries.filter((entry) => regex.test(entry.replace(/\\/g, "/"))).map((entry) => path10.join(baseDir, entry)).filter((fullPath) => fs10.statSync(fullPath).isFile());
 }
-var testCommand = new Command9("test").description("Run Quality Protocol test scenarios against a running server").argument("[files]", 'Glob pattern for test files (e.g. "qa/*.test.json")', "qa/*.test.json").option("--url <url>", "Target base URL", "http://localhost:3000").option("--token <token>", "Authentication token").action(async (filesPattern, options) => {
-  console.log(chalk11.bold(`
+var testCommand = new Command10("test").description("Run Quality Protocol test scenarios against a running server").argument("[files]", 'Glob pattern for test files (e.g. "qa/*.test.json")', "qa/*.test.json").option("--url <url>", "Target base URL", "http://localhost:3000").option("--token <token>", "Authentication token").action(async (filesPattern, options) => {
+  console.log(chalk12.bold(`
 \u{1F9EA} ObjectStack Quality Protocol Runner`));
-  console.log(chalk11.dim(`-------------------------------------`));
-  console.log(`Target: ${chalk11.blue(options.url)}`);
+  console.log(chalk12.dim(`-------------------------------------`));
+  console.log(`Target: ${chalk12.blue(options.url)}`);
   const adapter = new CoreQA.HttpTestAdapter(options.url, options.token);
   const runner = new CoreQA.TestRunner(adapter);
   const testFiles = resolveGlob(filesPattern);
   if (testFiles.length === 0) {
-    console.warn(chalk11.yellow(`No test files found matching: ${filesPattern}`));
+    console.warn(chalk12.yellow(`No test files found matching: ${filesPattern}`));
     return;
   }
   console.log(`Found ${testFiles.length} test suites.`);
@@ -1662,19 +1907,19 @@ var testCommand = new Command9("test").description("Run Quality Protocol test sc
   let totalFailed = 0;
   for (const file of testFiles) {
     console.log(`
-\u{1F4C4} Running suite: ${chalk11.bold(path9.basename(file))}`);
+\u{1F4C4} Running suite: ${chalk12.bold(path10.basename(file))}`);
     try {
-      const content = fs9.readFileSync(file, "utf-8");
+      const content = fs10.readFileSync(file, "utf-8");
       const suite = JSON.parse(content);
       const results = await runner.runSuite(suite);
       for (const result of results) {
         const icon = result.passed ? "\u2705" : "\u274C";
         console.log(`  ${icon} Scenario: ${result.scenarioId} (${result.duration}ms)`);
         if (!result.passed) {
-          console.error(chalk11.red(`     Error: ${result.error}`));
+          console.error(chalk12.red(`     Error: ${result.error}`));
           result.steps.forEach((step) => {
             if (!step.passed) {
-              console.error(chalk11.red(`     Step Failed: ${step.stepName}`));
+              console.error(chalk12.red(`     Step Failed: ${step.stepName}`));
               if (step.output) console.error(`     Output:`, step.output);
               if (step.error) console.error(`     Error:`, step.error);
             }
@@ -1685,28 +1930,28 @@ var testCommand = new Command9("test").description("Run Quality Protocol test sc
         }
       }
     } catch (e) {
-      console.error(chalk11.red(`Failed to load or run suite ${file}: ${e}`));
+      console.error(chalk12.red(`Failed to load or run suite ${file}: ${e}`));
       totalFailed++;
     }
   }
-  console.log(chalk11.dim(`
+  console.log(chalk12.dim(`
 -------------------------------------`));
   if (totalFailed > 0) {
-    console.log(chalk11.red(`FAILED: ${totalFailed} scenarios failed. ${totalPassed} passed.`));
+    console.log(chalk12.red(`FAILED: ${totalFailed} scenarios failed. ${totalPassed} passed.`));
     process.exit(1);
   } else {
-    console.log(chalk11.green(`SUCCESS: All ${totalPassed} scenarios passed.`));
+    console.log(chalk12.green(`SUCCESS: All ${totalPassed} scenarios passed.`));
     process.exit(0);
   }
 });
 
 // src/commands/doctor.ts
-import { Command as Command10 } from "commander";
-import chalk12 from "chalk";
+import { Command as Command11 } from "commander";
+import chalk13 from "chalk";
 import { execSync as execSync2 } from "child_process";
-import fs10 from "fs";
-import path10 from "path";
-var doctorCommand = new Command10("doctor").description("Check development environment health").option("-v, --verbose", "Show detailed information").action(async (options) => {
+import fs11 from "fs";
+import path11 from "path";
+var doctorCommand = new Command11("doctor").description("Check development environment health").option("-v, --verbose", "Show detailed information").action(async (options) => {
   printHeader("Environment Health Check");
   const results = [];
   try {
@@ -1765,8 +2010,8 @@ var doctorCommand = new Command10("doctor").description("Check development envir
     });
   }
   const cwd = process.cwd();
-  const nodeModulesPath = path10.join(cwd, "node_modules");
-  if (fs10.existsSync(nodeModulesPath)) {
+  const nodeModulesPath = path11.join(cwd, "node_modules");
+  if (fs11.existsSync(nodeModulesPath)) {
     results.push({
       name: "Dependencies",
       status: "ok",
@@ -1780,8 +2025,8 @@ var doctorCommand = new Command10("doctor").description("Check development envir
       fix: "Run: pnpm install"
     });
   }
-  const specDistPath = path10.join(cwd, "packages/spec/dist");
-  if (fs10.existsSync(specDistPath)) {
+  const specDistPath = path11.join(cwd, "packages/spec/dist");
+  if (fs11.existsSync(specDistPath)) {
     results.push({
       name: "@objectstack/spec",
       status: "ok",
@@ -1823,24 +2068,111 @@ var doctorCommand = new Command10("doctor").description("Check development envir
       printError(`${padded} ${result.message}`);
     }
     if (result.fix && (options.verbose || result.status === "error")) {
-      console.log(chalk12.dim(`      \u2192 ${result.fix}`));
+      console.log(chalk13.dim(`      \u2192 ${result.fix}`));
     }
     if (result.status === "error") hasErrors = true;
     if (result.status === "warning") hasWarnings = true;
   });
   console.log("");
   if (hasErrors) {
-    console.log(chalk12.red("\u274C Some critical issues found. Please fix them before continuing."));
-    results.filter((r) => r.status === "error" && r.fix).forEach((r) => console.log(chalk12.dim(`   ${r.fix}`)));
+    console.log(chalk13.red("\u274C Some critical issues found. Please fix them before continuing."));
+    results.filter((r) => r.status === "error" && r.fix).forEach((r) => console.log(chalk13.dim(`   ${r.fix}`)));
     process.exit(1);
   } else if (hasWarnings) {
-    console.log(chalk12.yellow("\u26A0\uFE0F  Environment is functional but has some warnings."));
-    console.log(chalk12.dim("   Run with --verbose to see fix suggestions."));
+    console.log(chalk13.yellow("\u26A0\uFE0F  Environment is functional but has some warnings."));
+    console.log(chalk13.dim("   Run with --verbose to see fix suggestions."));
   } else {
-    console.log(chalk12.green("\u2705 Environment is healthy and ready for development!"));
+    console.log(chalk13.green("\u2705 Environment is healthy and ready for development!"));
   }
   console.log("");
 });
+
+// src/utils/plugin-commands.ts
+import chalk14 from "chalk";
+async function loadPluginCommands(program) {
+  let config;
+  try {
+    const loaded = await loadConfig();
+    config = loaded.config;
+  } catch {
+    return;
+  }
+  const plugins = [
+    ...config.plugins || [],
+    ...config.devPlugins || []
+  ];
+  const contributions = [];
+  for (const plugin of plugins) {
+    if (!plugin || typeof plugin !== "object") continue;
+    const p = plugin;
+    const manifest = p.manifest;
+    const contributes = manifest?.contributes ?? p.contributes;
+    if (!contributes) continue;
+    const commands = contributes.commands;
+    if (!Array.isArray(commands)) continue;
+    const pluginName = resolvePluginName2(p);
+    for (const cmd of commands) {
+      if (!cmd || typeof cmd.name !== "string") continue;
+      contributions.push({
+        name: cmd.name,
+        description: typeof cmd.description === "string" ? cmd.description : void 0,
+        module: typeof cmd.module === "string" ? cmd.module : void 0,
+        pluginName
+      });
+    }
+  }
+  if (contributions.length === 0) return;
+  for (const contribution of contributions) {
+    try {
+      const commands = await importPluginCommands(contribution);
+      for (const cmd of commands) {
+        program.addCommand(cmd);
+      }
+    } catch (error) {
+      if (process.env.DEBUG) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(
+          chalk14.yellow(`  \u26A0 Failed to load CLI command '${contribution.name}' from plugin '${contribution.pluginName}': ${message}`)
+        );
+      }
+    }
+  }
+}
+async function importPluginCommands(contribution) {
+  const moduleId = contribution.module ? `${contribution.pluginName}/${contribution.module.replace(/^\.\//, "")}` : contribution.pluginName;
+  const mod = await import(moduleId);
+  if (Array.isArray(mod.commands)) {
+    return mod.commands.filter(isCommandInstance);
+  }
+  const defaultExport = mod.default;
+  if (defaultExport) {
+    if (Array.isArray(defaultExport)) {
+      return defaultExport.filter(isCommandInstance);
+    }
+    if (isCommandInstance(defaultExport)) {
+      return [defaultExport];
+    }
+  }
+  const commands = [];
+  for (const key of Object.keys(mod)) {
+    if (isCommandInstance(mod[key])) {
+      commands.push(mod[key]);
+    }
+  }
+  return commands;
+}
+function isCommandInstance(value) {
+  if (value === null || typeof value !== "object") return false;
+  const obj = value;
+  return typeof obj.name === "function" && typeof obj.description === "function" && typeof obj.action === "function" && typeof obj.parse === "function";
+}
+function resolvePluginName2(plugin) {
+  if (typeof plugin.name === "string") return plugin.name;
+  const manifest = plugin.manifest;
+  if (manifest && typeof manifest.name === "string") return manifest.name;
+  if (plugin.constructor && plugin.constructor.name !== "Object") return plugin.constructor.name;
+  return "unknown";
+}
 export {
   compileCommand,
   createCommand,
@@ -1849,6 +2181,8 @@ export {
   generateCommand,
   infoCommand,
   initCommand,
+  loadPluginCommands,
+  pluginCommand,
   serveCommand,
   templates,
   testCommand,