feat(runtime): refactor to use @objectstack/runtime and implement standalone stack functionality

Author: hotlong

examples/app-crm/package.json

@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "@objectstack/spec": "workspace:*",
-    "@objectstack/service-cloud": "workspace:*"
+    "@objectstack/runtime": "workspace:*"
   },
   "devDependencies": {
     "@objectstack/cli": "workspace:*",

packages/cli/src/commands/serve.ts

@@ -175,21 +175,24 @@ export default class Serve extends Command {
         throw new Error(`No default export found in ${args.config}`);
       }
 
-      // Standalone is the default OS dev workflow. Every bare
-      // `defineStack()` is booted via `@objectstack/service-cloud`'s
-      // `createBootStack()` (runtime / cloud / standalone selected by
-      // `OBJECTSTACK_MODE`, default `standalone`). Set
-      // `OBJECTSTACK_MODE=off` to fall back to the legacy lightweight
-      // assembler.
+      // Boot-mode dispatch: standalone goes directly through
+      // `@objectstack/runtime` (no cloud dependencies). runtime/cloud
+      // modes go through `@objectstack/service-cloud`.
       if (shouldBootWithLibrary(config)) {
-        const { createBootStack } = await import('@objectstack/service-cloud');
-        const bootResult = await createBootStack({
-          mode: config.bootMode,
-          runtime: config.runtime ?? config.project,
-          cloud: config.cloud,
-          standalone: config.standalone,
-        });
-        config = bootResult as any;
+        const resolvedMode = config.bootMode ?? process.env.OBJECTSTACK_MODE ?? 'standalone';
+        if (resolvedMode === 'standalone') {
+          const { createStandaloneStack } = await import('@objectstack/runtime');
+          const bootResult = await createStandaloneStack(config.standalone);
+          config = bootResult as any;
+        } else {
+          const { createBootStack } = await import('@objectstack/service-cloud');
+          const bootResult = await createBootStack({
+            mode: config.bootMode,
+            runtime: config.runtime ?? config.project,
+            cloud: config.cloud,
+          });
+          config = bootResult as any;
+        }
       }
 
       // ── Resolve plugin tiers ──────────────────────────────────────

packages/runtime/package.json

@@ -29,6 +29,8 @@
     "@objectstack/driver-memory": "workspace:*",
     "@objectstack/driver-sql": "workspace:*",
     "@objectstack/driver-turso": "workspace:*",
+    "@objectstack/metadata": "workspace:*",
+    "@objectstack/objectql": "workspace:*",
     "typescript": "^6.0.3",
     "vitest": "^4.1.4"
   },

packages/runtime/src/index.ts

@@ -7,6 +7,10 @@ export { ObjectKernel } from '@objectstack/core';
 export { Runtime } from './runtime.js';
 export type { RuntimeConfig } from './runtime.js';
 
+// Export Standalone Stack
+export { createStandaloneStack } from './standalone-stack.js';
+export type { StandaloneStackConfig, StandaloneStackResult } from './standalone-stack.js';
+
 // Export Plugins
 export { DriverPlugin } from './driver-plugin.js';
 export { AppPlugin } from './app-plugin.js';

…es/service-cloud/src/standalone-stack.ts packages/runtime/src/standalone-stack.tspackages/services/service-cloud/src/standalone-stack.ts renamed to packages/runtime/src/standalone-stack.ts packages/services/service-cloud/src/standalone-stack.ts renamed to packages/runtime/src/standalone-stack.ts

@@ -39,7 +39,8 @@ export async function createStandaloneStack(config?: StandaloneStackConfig): Pro
 
     const { ObjectQLPlugin } = await import('@objectstack/objectql');
     const { MetadataPlugin } = await import('@objectstack/metadata');
-    const { DriverPlugin, AppPlugin } = await import('@objectstack/runtime');
+    const { DriverPlugin } = await import('./driver-plugin.js');
+    const { AppPlugin } = await import('./app-plugin.js');
 
     const cwd = process.cwd();
     const projectId = cfg.projectId ?? process.env.OBJECTSTACK_PROJECT_ID ?? 'proj_local';

packages/services/service-cloud/src/boot-stack.ts

@@ -14,7 +14,6 @@ import { z } from 'zod';
 import { resolveMode, resolveAuthSecret, resolveBaseUrl } from './boot-env.js';
 import type { BootMode } from './boot-env.js';
 import { createRuntimeStack, RuntimeStackConfigSchema } from './runtime-stack.js';
-import { createStandaloneStack, StandaloneStackConfigSchema } from './standalone-stack.js';
 import { createCloudStack } from './cloud-stack.js';
 import type { CloudStackConfig } from './cloud-stack.js';
 import type { ProjectTemplate } from './multi-project-plugin.js';
@@ -35,7 +34,7 @@ const CloudStackConfigSchema = z.object({
 
 export const BootStackConfigSchema = z.object({
     /** Explicit mode override. When unset, resolves from env. */
-    mode: z.enum(['runtime', 'cloud', 'standalone', 'project']).optional(),
+    mode: z.enum(['runtime', 'cloud', 'project']).optional(),
     /** Runtime-mode options (used when mode resolves to `runtime`). */
     runtime: RuntimeStackConfigSchema.optional(),
     /**
@@ -45,8 +44,6 @@ export const BootStackConfigSchema = z.object({
     project: RuntimeStackConfigSchema.optional(),
     /** Cloud-mode options (used when mode resolves to `cloud`). */
     cloud: CloudStackConfigSchema.optional(),
-    /** Standalone-mode options (used when mode resolves to `standalone`). */
-    standalone: StandaloneStackConfigSchema.optional(),
 });
 
 export type BootStackConfig = z.input<typeof BootStackConfigSchema>;
@@ -92,10 +89,6 @@ export async function createBootStack(config?: BootStackConfig): Promise<BootSta
         return createCloudStack(merged);
     }
 
-    if (mode === 'standalone') {
-        return createStandaloneStack(cfg.standalone);
-    }
-
     // runtime (also reached via deprecated `mode: 'project'`)
     return createRuntimeStack(cfg.runtime ?? cfg.project);
 }

packages/services/service-cloud/src/index.ts

@@ -78,8 +78,6 @@ export { createProjectStack, ProjectStackConfigSchema } from './runtime-stack.js
 /** @deprecated Use `RuntimeStackConfig`/`RuntimeStackResult`. */
 export type { ProjectStackConfig, ProjectStackResult } from './runtime-stack.js';
 
-export { createStandaloneStack, StandaloneStackConfigSchema } from './standalone-stack.js';
-export type { StandaloneStackConfig, StandaloneStackResult } from './standalone-stack.js';
 
 export { createBootStack, BootStackConfigSchema } from './boot-stack.js';
 export type { BootStackConfig, BootStackResult } from './boot-stack.js';