@objectstack/cli 4.0.4 → 4.1.0

package/src/commands/serve.ts

@@ -1,411 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import path from 'path';
-import fs from 'fs';
-import net from 'net';
-import chalk from 'chalk';
-import { bundleRequire } from 'bundle-require';
-import { loadConfig } from '../utils/config.js';
-import { isHostConfig } from '../utils/plugin-detection.js';
-import {
-  printHeader,
-  printKV,
-  printSuccess,
-  printError,
-  printStep,
-  printInfo,
-  printServerReady,
-} from '../utils/format.js';
-import {
-  STUDIO_PATH,
-  resolveStudioPath,
-  hasStudioDist,
-  createStudioStaticPlugin,
-} from '../utils/studio.js';
-import dotenvFlow from 'dotenv-flow';
-
-// Helper to find available port
-const getAvailablePort = async (startPort: number): Promise<number> => {
-  const isPortAvailable = (port: number): Promise<boolean> => {
-    return new Promise((resolve) => {
-      const server = net.createServer();
-      server.once('error', (err: any) => {
-        resolve(false);
-      });
-      server.once('listening', () => {
-        server.close(() => resolve(true));
-      });
-      server.listen(port);
-    });
-  };
-
-  let port = startPort;
-  while (!(await isPortAvailable(port))) {
-    port++;
-    if (port > startPort + 100) {
-       throw new Error(`Could not find an available port starting from ${startPort}`);
-    }
-  }
-  return port;
-};
-
-export default class Serve extends Command {
-  static override description = 'Start ObjectStack server with plugins from configuration';
-
-  static override args = {
-    config: Args.string({ description: 'Configuration file path', required: false, default: 'objectstack.config.ts' }),
-  };
-
-  static override flags = {
-    port: Flags.string({ char: 'p', description: 'Server port', default: '3000' }),
-    dev: Flags.boolean({ description: 'Run in development mode (load devPlugins)' }),
-    ui: Flags.boolean({ description: 'Enable Studio UI at /_studio/ (default: true in dev mode)' }),
-    server: Flags.boolean({ description: 'Start HTTP server plugin', default: true, allowNo: true }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Serve);
-
-    let port = parseInt(flags.port);
-    try {
-      const availablePort = await getAvailablePort(port);
-      if (availablePort !== port) {
-        port = availablePort;
-      }
-    } catch (e) {
-      // Ignore error and try with original port
-    }
-
-    // Load .env files following Vite/Next.js convention
-    const mode = flags.dev ? 'development'
-      : (process.env.NODE_ENV === 'test' ? 'test'
-        : (process.env.NODE_ENV || 'production'));
-    dotenvFlow.config({ node_env: mode, silent: true });
-
-    const isDev = flags.dev || process.env.NODE_ENV === 'development';
-
-    const absolutePath = path.resolve(process.cwd(), args.config!);
-    const relativeConfig = path.relative(process.cwd(), absolutePath);
-    
-    if (!fs.existsSync(absolutePath)) {
-      printError(`Configuration file not found: ${absolutePath}`);
-      console.log(chalk.dim('  Hint: Run `objectstack init` to create a new project'));
-      this.exit(1);
-    }
-
-    // Quiet loading — only show a single spinner line
-    console.log('');
-    console.log(chalk.dim(`  Loading ${relativeConfig}...`));
-
-    // Track loaded plugins for summary
-    const loadedPlugins: string[] = [];
-    const shortPluginName = (raw: string) => {
-      // Map verbose internal IDs to short display names
-      if (raw.includes('objectql')) return 'ObjectQL';
-      if (raw.includes('driver') && raw.includes('memory')) return 'MemoryDriver';
-      if (raw.startsWith('plugin.app.')) return raw.replace('plugin.app.', '').split('.').pop() || raw;
-      if (raw.includes('hono')) return 'HonoServer';
-      return raw;
-    };
-    const trackPlugin = (name: string) => { loadedPlugins.push(shortPluginName(name)); };
-
-    // Save original console/stdout methods — we'll suppress noise during boot
-    const originalConsoleLog = console.log;
-    const originalConsoleDebug = console.debug;
-    const origStdoutWrite = process.stdout.write.bind(process.stdout);
-    let bootQuiet = false;
-
-    const restoreOutput = () => {
-      bootQuiet = false;
-      process.stdout.write = origStdoutWrite;
-      console.log = originalConsoleLog;
-      console.debug = originalConsoleDebug;
-    };
-
-    const portShifted = parseInt(flags.port) !== port;
-
-    try {
-      // ── Suppress ALL runtime noise during boot ────────────────────
-      // Multiple sources write to stdout during startup:
-      //   • Pino-pretty (direct process.stdout.write)
-      //   • ObjectLogger browser fallback (console.log)
-      //   • SchemaRegistry (console.log)
-      // We capture stdout entirely, then restore after runtime.start().
-      bootQuiet = true;
-      process.stdout.write = (chunk: any, ...rest: any[]) => {
-        if (bootQuiet) return true;  // swallow
-        return (origStdoutWrite as any)(chunk, ...rest);
-      };
-      console.log = (...args: any[]) => { if (!bootQuiet) originalConsoleLog(...args); };
-      console.debug = (...args: any[]) => { if (!bootQuiet) originalConsoleDebug(...args); };
-
-      // Load configuration
-      const { mod } = await bundleRequire({
-        filepath: absolutePath,
-      });
-
-      const config = mod.default || mod;
-
-      if (!config) {
-        throw new Error(`No default export found in ${args.config}`);
-      }
-
-      // Import ObjectStack runtime
-      const { Runtime } = await import('@objectstack/runtime');
-
-      // Set kernel logger to 'silent' — the CLI manages its own output
-      const loggerConfig = { level: 'silent' as const };
-
-      const runtime = new Runtime({
-        kernel: {
-            logger: loggerConfig
-        }
-      });
-      const kernel = runtime.getKernel();
-
-      // Load plugins from configuration
-      let plugins = config.plugins || [];
-
-      // Merge devPlugins if in dev mode
-      if (flags.dev && config.devPlugins) {
-        plugins = [...plugins, ...config.devPlugins];
-      }
-
-      // 1. Auto-register ObjectQL Plugin if objects define but plugins missing
-      const hasObjectQL = plugins.some((p: any) => p.name?.includes('objectql') || p.constructor?.name?.includes('ObjectQL'));
-      if (config.objects && !hasObjectQL) {
-         try {
-           const { ObjectQLPlugin } = await import('@objectstack/objectql');
-           await kernel.use(new ObjectQLPlugin());
-           trackPlugin('ObjectQL');
-         } catch (e: any) {
-           // silent
-         }
-      }
-
-      // 2. Auto-register Memory Driver if in Dev and no driver configured
-      const hasDriver = plugins.some((p: any) => p.name?.includes('driver') || p.constructor?.name?.includes('Driver'));
-      if (isDev && !hasDriver && config.objects) {
-         try {
-           const { DriverPlugin } = await import('@objectstack/runtime');
-           const { InMemoryDriver } = await import('@objectstack/driver-memory');
-           await kernel.use(new DriverPlugin(new InMemoryDriver()));
-           trackPlugin('MemoryDriver');
-         } catch (e: any) {
-           // silent
-         }
-      }
-
-      // 3. Auto-register AppPlugin if config contains app definitions
-      // Skip if config is a host/aggregator config that already contains
-      // instantiated plugins — wrapping it would cause duplicate registration
-      // and startup failures (e.g. plugin.app.dev-workspace).
-      if (!isHostConfig(config) && (config.objects || config.manifest || config.apps)) {
-        try {
-            const { AppPlugin } = await import('@objectstack/runtime');
-            await kernel.use(new AppPlugin(config));
-            trackPlugin('App');
-        } catch (e: any) {
-            // silent
-        }
-      }
-
-      // 3b. Auto-register I18nServicePlugin if config contains translations/i18n
-      // This ensures i18n REST routes work out of the box without manual plugin registration.
-      const hasI18nPlugin = plugins.some(
-        (p: any) => p.name === 'com.objectstack.service.i18n'
-            || p.constructor?.name === 'I18nServicePlugin'
-      );
-      const configHasTranslations = (
-        (Array.isArray(config.translations) && config.translations.length > 0)
-        || config.i18n
-        || (config.manifest && (
-            (Array.isArray(config.manifest.translations) && config.manifest.translations.length > 0)
-            || config.manifest.i18n
-          ))
-      );
-      if (!hasI18nPlugin && configHasTranslations) {
-        try {
-          // Dynamic import with variable to prevent tsc from resolving the optional package
-          const i18nPkg = '@objectstack/service-i18n';
-          const { I18nServicePlugin } = await import(/* webpackIgnore: true */ i18nPkg);
-          const i18nCfg = config.i18n || config.manifest?.i18n || {};
-          await kernel.use(new I18nServicePlugin({
-            defaultLocale: i18nCfg.defaultLocale,
-            fallbackLocale: i18nCfg.fallbackLocale || i18nCfg.defaultLocale || 'en',
-          }));
-          trackPlugin('I18nService');
-        } catch {
-          // @objectstack/service-i18n not installed — kernel memory fallback will handle i18n
-        }
-      } else if (!hasI18nPlugin && !configHasTranslations) {
-        // No translations and no explicit i18n plugin — this is fine, kernel fallback works
-      }
-
-      // Add HTTP server plugin BEFORE config plugins so that the
-      // http-server service is available for any plugin that needs it
-      // during init/start (e.g. AuthPlugin).
-      // Skip if config already contains a HonoServerPlugin to avoid
-      // duplicate registration.
-      const configHasHonoServer = plugins.some(
-        (p: any) => p.name === 'com.objectstack.server.hono' || p.constructor?.name === 'HonoServerPlugin'
-      );
-
-      if (flags.server && !configHasHonoServer) {
-        try {
-          const { HonoServerPlugin } = await import('@objectstack/plugin-hono-server');
-          const serverPlugin = new HonoServerPlugin({ port });
-          await kernel.use(serverPlugin);
-          trackPlugin('HonoServer');
-        } catch (e: any) {
-          console.warn(chalk.yellow(`  ⚠ HTTP server plugin not available: ${e.message}`));
-        }
-      }
-
-      // 5. Auto-register SetupPlugin BEFORE config plugins so that other
-      // plugins (e.g. AuthPlugin) can call setupNav.contribute() during init.
-      const hasSetupPlugin = plugins.some(
-        (p: any) => p.name === 'com.objectstack.setup' || p.constructor?.name === 'SetupPlugin'
-      );
-      if (!hasSetupPlugin) {
-        try {
-          const setupPkg = '@objectstack/plugin-setup';
-          const { SetupPlugin } = await import(/* webpackIgnore: true */ setupPkg);
-          await kernel.use(new SetupPlugin());
-          trackPlugin('Setup');
-        } catch {
-          // @objectstack/plugin-setup not installed — setup app unavailable
-        }
-      }
-
-      if (plugins.length > 0) {
-        for (const plugin of plugins) {
-          try {
-            let pluginToLoad = plugin;
-
-            // Resolve string references (package names)
-            if (typeof plugin === 'string') {
-              try {
-                 const imported = await import(plugin);
-                 pluginToLoad = imported.default || imported;
-              } catch (importError: any) {
-                 throw new Error(`Failed to import plugin '${plugin}': ${importError.message}`);
-              }
-            }
-
-            // Wrap raw config objects (no init/start) into AppPlugin
-            // This handles plugins defined as plain { name, objects, ... } bundles
-            if (pluginToLoad && typeof pluginToLoad === 'object' && !pluginToLoad.init) {
-              try {
-                const { AppPlugin } = await import('@objectstack/runtime');
-                pluginToLoad = new AppPlugin(pluginToLoad);
-              } catch (e: any) {
-                // Fall through to kernel.use which will report the error
-              }
-            }
-
-            await kernel.use(pluginToLoad);
-            const pluginName = plugin.name || plugin.constructor?.name || 'unnamed';
-            trackPlugin(pluginName);
-          } catch (e: any) {
-            console.error(chalk.red(`  ✗ Failed to load plugin: ${e.message}`));
-          }
-        }
-      }
-
-      // Register REST API and Dispatcher plugins (consume http.server + protocol services)
-      if (flags.server) {
-        try {
-          const { createRestApiPlugin } = await import('@objectstack/rest');
-          await kernel.use(createRestApiPlugin());
-          trackPlugin('RestAPI');
-        } catch (e: any) {
-          // @objectstack/rest is optional
-        }
-
-        // Register Dispatcher plugin (auth, graphql, analytics, packages, hub, storage, automation)
-        try {
-          const { createDispatcherPlugin } = await import('@objectstack/runtime');
-          await kernel.use(createDispatcherPlugin());
-          trackPlugin('Dispatcher');
-        } catch (e: any) {
-          // optional
-        }
-      }
-
-      // 4. Auto-register AIServicePlugin if not already loaded by config plugins.
-      // Registered AFTER Dispatcher so that the ai:routes hook listener is
-      // already in place when AIServicePlugin.start() fires the hook.
-      const hasAIPlugin = plugins.some(
-        (p: any) => p.name === 'com.objectstack.service-ai'
-            || p.constructor?.name === 'AIServicePlugin'
-      );
-      if (!hasAIPlugin) {
-        try {
-          const aiPkg = '@objectstack/service-ai';
-          const { AIServicePlugin } = await import(/* webpackIgnore: true */ aiPkg);
-
-          // AIServicePlugin will auto-detect LLM provider from environment variables
-          // (AI_GATEWAY_MODEL, OPENAI_API_KEY, ANTHROPIC_API_KEY, GOOGLE_GENERATIVE_AI_API_KEY)
-          // No need to manually construct the adapter here.
-          await kernel.use(new AIServicePlugin());
-          trackPlugin('AIService');
-        } catch {
-          // @objectstack/service-ai not installed — AI features unavailable
-        }
-      }
-
-      // ── Studio UI ─────────────────────────────────────────────────
-      // In dev mode, Studio UI is enabled by default (use --no-ui to disable).
-      // Always serves the pre-built dist/ — no Vite dev server, no extra port.
-      const enableUI = flags.ui || isDev;
-
-      if (enableUI) {
-        const studioPath = resolveStudioPath();
-        if (!studioPath) {
-          console.warn(chalk.yellow(`  ⚠ @objectstack/studio not found — skipping UI`));
-        } else if (hasStudioDist(studioPath)) {
-          const distPath = path.join(studioPath, 'dist');
-          await kernel.use(createStudioStaticPlugin(distPath, { isDev }));
-          trackPlugin('StudioUI');
-        } else {
-          console.warn(chalk.yellow(`  ⚠ Studio dist not found — run "pnpm --filter @objectstack/studio build" first`));
-        }
-      }
-
-      // Boot the runtime
-      await runtime.start();
-
-      // Wait briefly for pino worker thread buffers to flush, then restore
-      await new Promise(r => setTimeout(r, 100));
-      restoreOutput();
-
-      // ── Clean startup summary ──────────────────────────────────────
-      printServerReady({
-        port,
-        configFile: relativeConfig,
-        isDev,
-        pluginCount: loadedPlugins.length,
-        pluginNames: loadedPlugins,
-        uiEnabled: enableUI,
-        studioPath: STUDIO_PATH,
-      });
-
-      // Keep process alive
-      process.on('SIGINT', async () => {
-        console.warn(chalk.yellow(`\n\n⏹  Stopping server...`));
-        await runtime.getKernel().shutdown();
-        console.log(chalk.green(`✅ Server stopped`));
-        process.exit(0);
-      });
-
-    } catch (error: any) {
-      restoreOutput();
-      console.log('');
-      printError(error.message || String(error));
-      if (process.env.DEBUG) console.error(chalk.dim(error.stack));
-      this.exit(1);
-    }
-  }
-}

package/src/commands/studio.ts

@@ -1,52 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import { spawn } from 'child_process';
-import { printHeader, printKV, printStep } from '../utils/format.js';
-
-/**
- * `objectstack studio` — Launch the ObjectStack Studio UI.
- *
- * Alias for `objectstack serve --dev --ui`.
- * Starts the ObjectStack server in development mode with the Studio
- * UI available at http://localhost:<port>/_studio/
- */
-export default class Studio extends Command {
-  static override description = 'Launch Studio UI with development server';
-
-  static override args = {
-    config: Args.string({ description: 'Configuration file path', required: false, default: 'objectstack.config.ts' }),
-  };
-
-  static override flags = {
-    port: Flags.string({ char: 'p', description: 'Server port', default: '3000' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Studio);
-
-    printHeader('Studio');
-    printKV('Mode', 'dev + ui', '🎨');
-    printStep('Delegating to serve --dev --ui …');
-    console.log('');
-
-    // Delegate to the serve command with --dev --ui flags
-    const binPath = process.argv[1];
-    const spawnArgs = [
-      binPath,
-      'serve',
-      args.config!,
-      '--dev',
-      '--ui',
-      '--port', flags.port,
-    ];
-
-    const child = spawn(process.execPath, spawnArgs, {
-      stdio: 'inherit',
-      env: { ...process.env, NODE_ENV: 'development' },
-    });
-
-    child.on('exit', (code) => process.exit(code ?? 0));
-  }
-}

package/src/commands/test.ts

@@ -1,135 +0,0 @@
-// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
-
-import { Args, Command, Flags } from '@oclif/core';
-import chalk from 'chalk';
-import path from 'path';
-import fs from 'fs';
-import { QA as CoreQA } from '@objectstack/core';
-import { QA } from '@objectstack/spec';
-
-/**
- * Resolve a glob-like pattern to matching file paths.
- * Supports `*` (single segment wildcard) and `**` (recursive wildcard).
- * Falls back to direct file path if no glob characters are present.
- */
-function resolveGlob(pattern: string): string[] {
-  // Direct file path — no wildcards
-  if (!pattern.includes('*')) {
-    return fs.existsSync(pattern) ? [pattern] : [];
-  }
-
-  // Split pattern into the static base directory and the glob portion
-  const parts = pattern.split(path.sep.replace('\\', '/'));
-  // Also handle forward-slash on Windows
-  const segments = pattern.includes('/') ? pattern.split('/') : parts;
-
-  let baseDir = '.';
-  let globStart = 0;
-  for (let i = 0; i < segments.length; i++) {
-    if (segments[i].includes('*')) {
-      globStart = i;
-      break;
-    }
-    baseDir = i === 0 ? segments[i] : path.join(baseDir, segments[i]);
-  }
-
-  if (!fs.existsSync(baseDir)) return [];
-
-  // Convert the glob portion into a RegExp
-  const globPortion = segments.slice(globStart).join('/');
-  const regexStr = globPortion
-    .replace(/\./g, '\\.')           // escape dots
-    .replace(/\*\*\//g, '(.+/)?')   // ** matches any directory depth
-    .replace(/\*\*/g, '.*')         // trailing ** without slash
-    .replace(/\*/g, '[^/]*');       // * matches within a single segment
-  const regex = new RegExp(`^${regexStr}$`);
-
-  // Recursively read all files under baseDir
-  const entries = fs.readdirSync(baseDir, { recursive: true, encoding: 'utf-8' }) as string[];
-  return entries
-    .filter(entry => regex.test(entry.replace(/\\/g, '/')))
-    .map(entry => path.join(baseDir, entry))
-    .filter(fullPath => fs.statSync(fullPath).isFile());
-}
-
-export default class Test extends Command {
-  static override description = 'Run Quality Protocol test scenarios against a running server';
-
-  static override args = {
-    files: Args.string({ description: 'Glob pattern for test files (e.g. "qa/*.test.json")', required: false, default: 'qa/*.test.json' }),
-  };
-
-  static override flags = {
-    url: Flags.string({ description: 'Target base URL', default: 'http://localhost:3000' }),
-    token: Flags.string({ description: 'Authentication token' }),
-  };
-
-  async run(): Promise<void> {
-    const { args, flags } = await this.parse(Test);
-    const filesPattern = args.files;
-
-    console.log(chalk.bold(`\n🧪 ObjectStack Quality Protocol Runner`));
-    console.log(chalk.dim(`-------------------------------------`));
-    console.log(`Target: ${chalk.blue(flags.url)}`);
-    
-    // 1. Setup Runner
-    const adapter = new CoreQA.HttpTestAdapter(flags.url, flags.token);
-    const runner = new CoreQA.TestRunner(adapter);
-
-    // 2. Find test files using glob-style pattern matching
-    const testFiles: string[] = resolveGlob(filesPattern);
-
-    if (testFiles.length === 0) {
-        console.warn(chalk.yellow(`No test files found matching: ${filesPattern}`));
-        // Create a demo test file if none exist?
-        return;
-    }
-
-    console.log(`Found ${testFiles.length} test suites.`);
-
-    // 3. Run Tests
-    let totalPassed = 0;
-    let totalFailed = 0;
-
-    for (const file of testFiles) {
-        console.log(`\n📄 Running suite: ${chalk.bold(path.basename(file))}`);
-        try {
-            const content = fs.readFileSync(file, 'utf-8');
-            const suite = JSON.parse(content) as QA.TestSuite; // Should validate with Zod
-            
-            const results = await runner.runSuite(suite);
-            
-            for (const result of results) {
-                const icon = result.passed ? '✅' : '❌';
-                console.log(`  ${icon} Scenario: ${result.scenarioId} (${result.duration}ms)`);
-                if (!result.passed) {
-                   console.error(chalk.red(`     Error: ${result.error}`));
-                   result.steps.forEach(step => {
-                       if (!step.passed) {
-                           console.error(chalk.red(`     Step Failed: ${step.stepName}`));
-                           if (step.output) console.error(`     Output:`, step.output);
-                           if (step.error) console.error(`     Error:`, step.error);
-                       }
-                   });
-                   totalFailed++;
-                } else {
-                    totalPassed++;
-                }
-            }
-        } catch (e) {
-            console.error(chalk.red(`Failed to load or run suite ${file}: ${e}`));
-            totalFailed++; // Count suite failure
-        }
-    }
-
-    // 4. Summary
-    console.log(chalk.dim(`\n-------------------------------------`));
-    if (totalFailed > 0) {
-        console.log(chalk.red(`FAILED: ${totalFailed} scenarios failed. ${totalPassed} passed.`));
-        process.exit(1);
-    } else {
-        console.log(chalk.green(`SUCCESS: All ${totalPassed} scenarios passed.`));
-        process.exit(0);
-    }
-  }
-}