feat: add Build and Start commands for artifact compilation and serving

Author: hotlong

packages/cli/src/commands/build.ts

@@ -0,0 +1,7 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import Compile from './compile.js';
+
+export default class Build extends Compile {
+  static override description = 'Compile ObjectStack configuration to JSON artifact (alias for compile)';
+}

packages/cli/src/commands/start.ts

@@ -0,0 +1,62 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+import { Command, Flags } from '@oclif/core';
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import { printHeader, printKV, printStep, printError } from '../utils/format.js';
+
+export default class Start extends Command {
+  static override description = 'Serve the pre-compiled artifact in production mode (requires objectstack build first)';
+
+  static override flags = {
+    ui: Flags.boolean({ description: 'Enable Studio UI at /_studio/' }),
+    verbose: Flags.boolean({ char: 'v', description: 'Verbose output' }),
+    port: Flags.integer({ char: 'p', description: 'Port to listen on' }),
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(Start);
+
+    printHeader('Production Mode');
+
+    const artifactPath = process.env.OBJECTSTACK_ARTIFACT_PATH
+      ?? path.resolve(process.cwd(), 'dist/objectstack.json');
+
+    if (!fs.existsSync(artifactPath)) {
+      printError(`Artifact not found: ${path.relative(process.cwd(), artifactPath)}`);
+      console.error('  Run \x1b[33mobjectstack build\x1b[0m to compile your configuration first.');
+      process.exit(1);
+    }
+
+    printKV('Artifact', path.relative(process.cwd(), artifactPath), '📦');
+    printStep('Starting server (production mode)...');
+
+    const localEnv: NodeJS.ProcessEnv = {
+      ...process.env,
+      NODE_ENV: 'production',
+      OBJECTSTACK_PROJECT_ID: process.env.OBJECTSTACK_PROJECT_ID ?? 'proj_local',
+      OBJECTSTACK_ARTIFACT_PATH: process.env.OBJECTSTACK_ARTIFACT_PATH ?? artifactPath,
+      ...(flags.port ? { PORT: String(flags.port) } : {}),
+    };
+
+    if (!process.env.OBJECTSTACK_CLOUD_URL) {
+      delete localEnv.OBJECTSTACK_CLOUD_URL;
+    }
+
+    printKV('Project ID', localEnv.OBJECTSTACK_PROJECT_ID!, '🎯');
+
+    const binPath = process.argv[1];
+    spawn(
+      process.execPath,
+      [
+        binPath,
+        'serve',
+        '--prebuilt',
+        ...(flags.ui ? ['--ui'] : []),
+        ...(flags.verbose ? ['--verbose'] : []),
+      ],
+      { stdio: 'inherit', env: localEnv },
+    );
+  }
+}

packages/cli/src/index.ts

@@ -10,8 +10,10 @@ export { default as InfoCommand } from './commands/info.js';
 export { default as InitCommand } from './commands/init.js';
 export { default as GenerateCommand } from './commands/generate.js';
 export { default as CreateCommand } from './commands/create.js';
+export { default as BuildCommand } from './commands/build.js';
 export { default as DevCommand } from './commands/dev.js';
 export { default as ServeCommand } from './commands/serve.js';
+export { default as StartCommand } from './commands/start.js';
 export { default as TestCommand } from './commands/test.js';
 export { default as DoctorCommand } from './commands/doctor.js';