feat: update package.json to include @objectstack/service-cloud dependency and refactor serve command for project mode

Author: hotlong

package.json

@@ -8,7 +8,7 @@
     "dev": "pnpm --filter @objectstack/server dev",
     "dev:cloud": "OBJECTSTACK_MODE=cloud pnpm --filter @objectstack/server dev",
     "start": "pnpm --filter @objectstack/server start",
-    "dev:crm": "pnpm --filter @example/app-crm build && OBJECTSTACK_MODE=project OBJECTSTACK_PROJECT_ID=proj_crm pnpm --filter @example/app-crm dev",
+    "dev:crm": "pnpm --filter @example/app-crm build && OBJECTSTACK_PROJECT_ID=proj_crm pnpm --filter @example/app-crm dev",
     "studio:start": "pnpm --filter @objectstack/studio start",
     "test": "turbo run test",
     "test:e2e": "turbo run test:e2e",

packages/cli/package.json

@@ -49,6 +49,7 @@
     "@objectstack/rest": "workspace:*",
     "@objectstack/runtime": "workspace:^",
     "@objectstack/service-ai": "workspace:*",
+    "@objectstack/service-cloud": "workspace:*",
     "@objectstack/spec": "workspace:*",
     "@oclif/core": "^4.10.5",
     "bundle-require": "^5.1.0",

packages/cli/src/commands/serve.ts

@@ -175,56 +175,21 @@ export default class Serve extends Command {
         throw new Error(`No default export found in ${args.config}`);
       }
 
-      // If the user's config is a bare defineStack() and OBJECTSTACK_MODE is
-      // set (or config.bootMode is set), build the full project/cloud/
-      // standalone stack via @objectstack/service-cloud. The package is
-      // resolved by walking up node_modules from the user's cwd, so it
-      // picks up the consumer's installation regardless of where the CLI
-      // itself lives.
+      // Project mode is the canonical OS dev workflow. Every bare
+      // `defineStack()` is booted via `@objectstack/service-cloud`'s
+      // `createBootStack()` (project / cloud / standalone are selected
+      // by `OBJECTSTACK_MODE`, default `project`). Set
+      // `OBJECTSTACK_MODE=off` to fall back to the legacy lightweight
+      // assembler.
       if (shouldBootWithLibrary(config)) {
-        try {
-          const { pathToFileURL } = await import('node:url');
-          let dir = process.cwd();
-          let cloudPkgDir: string | null = null;
-          // Walk upward from cwd looking for node_modules/@objectstack/service-cloud
-          while (true) {
-            const candidate = path.join(dir, 'node_modules', '@objectstack', 'service-cloud');
-            if (fs.existsSync(path.join(candidate, 'package.json'))) {
-              cloudPkgDir = candidate;
-              break;
-            }
-            const parent = path.dirname(dir);
-            if (parent === dir) break;
-            dir = parent;
-          }
-          if (!cloudPkgDir) {
-            throw new Error('@objectstack/service-cloud not found in any node_modules from cwd upward');
-          }
-          const pkg = JSON.parse(
-            fs.readFileSync(path.join(cloudPkgDir, 'package.json'), 'utf8'),
-          );
-          const entry =
-            pkg.exports?.['.']?.import ??
-            pkg.exports?.['.']?.default ??
-            pkg.module ??
-            pkg.main ??
-            'dist/index.js';
-          const cloudEntry = path.join(cloudPkgDir, entry);
-          const cloudMod: any = await import(pathToFileURL(cloudEntry).href);
-          const bootResult = await cloudMod.createBootStack({
-            mode: config.bootMode,
-            project: config.project,
-            cloud: config.cloud,
-            standalone: config.standalone,
-          });
-          config = bootResult as any;
-        } catch (err) {
-          console.error(
-            'OBJECTSTACK_MODE is set but @objectstack/service-cloud cannot be loaded.',
-            'Install it with: pnpm add @objectstack/service-cloud',
-          );
-          throw err;
-        }
+        const { createBootStack } = await import('@objectstack/service-cloud');
+        const bootResult = await createBootStack({
+          mode: config.bootMode,
+          project: config.project,
+          cloud: config.cloud,
+          standalone: config.standalone,
+        });
+        config = bootResult as any;
       }
 
       // ── Resolve plugin tiers ──────────────────────────────────────

packages/cli/src/types/service-cloud.d.ts

@@ -0,0 +1,7 @@
+// Stub ambient declaration for the @objectstack/service-cloud package.
+// The package's tsup build cannot emit .d.ts yet (pre-existing typecheck
+// errors in upstream dependencies). The CLI only consumes the runtime
+// `createBootStack()` factory, so a loose `any` type suffices.
+declare module '@objectstack/service-cloud' {
+  export function createBootStack(config?: any): Promise<any>;
+}

packages/cli/src/utils/plugin-detection.ts

@@ -20,11 +20,15 @@ export function isHostConfig(config: any): boolean {
  * `createBootStack()` (full project / cloud / standalone stack) rather
  * than the CLI's lightweight in-memory plugin assembler.
  *
- * Triggers when:
- *   1. The config is NOT already a host config (no instantiated
- *      plugins) — a host config takes precedence.
- *   2. `OBJECTSTACK_MODE` env var is set to a recognised value, OR the
- *      config carries an explicit `bootMode` field.
+ * **Default behaviour: enabled.** Project mode is the canonical OS dev
+ * workflow — every bare `defineStack()` config gets the full stack
+ * (ObjectQL + Auth + Studio + control plane) unless one of the
+ * opt-out conditions below applies.
+ *
+ * Skips library boot when:
+ *   1. The config is a host config (already has instantiated plugins).
+ *   2. `OBJECTSTACK_MODE=off` is explicitly set (escape hatch for the
+ *      legacy lightweight assembler).
  *
  * Recognised mode aliases match `resolveMode()` in
  * `@objectstack/service-cloud/boot-env`.
@@ -41,9 +45,10 @@ const RECOGNISED_MODES = new Set([
 export function shouldBootWithLibrary(config: any): boolean {
   if (isHostConfig(config)) return false;
   const mode = process.env.OBJECTSTACK_MODE?.trim().toLowerCase();
-  if (mode && RECOGNISED_MODES.has(mode)) return true;
-  if (config?.bootMode && ['project', 'cloud', 'standalone'].includes(config.bootMode)) {
-    return true;
+  if (mode === 'off' || mode === 'none' || mode === 'legacy') return false;
+  if (mode && !RECOGNISED_MODES.has(mode)) {
+    console.warn(`[objectstack] Unknown OBJECTSTACK_MODE=${mode}; falling back to project mode.`);
   }
-  return false;
+  if (config?.bootMode === 'off') return false;
+  return true;
 }

packages/plugins/plugin-auth/package.json

@@ -15,10 +15,7 @@
   },
   "scripts": {
     "build": "tsup --config ../../../tsup.config.ts",
-    "test": "vitest run",
-    "validate": "objectstack validate",
-    "compile": "objectstack compile",
-    "info": "objectstack info"
+    "test": "vitest run"
   },
   "dependencies": {
     "@better-auth/oauth-provider": "^1.6.9",
@@ -28,7 +25,6 @@
     "better-auth": "^1.6.9"
   },
   "devDependencies": {
-    "@objectstack/cli": "workspace:*",
     "@types/node": "^25.6.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.4"