rastack 0.0.56 → 0.0.57

package/CHANGELOG.md

@@ -2,6 +2,8 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.57](https://github.com/theserverkid/reactapistack/compare/v0.0.56...v0.0.57) (2026-07-18)
+
 ### [0.0.56](https://github.com/theserverkid/reactapistack/compare/v0.0.55...v0.0.56) (2026-07-18)
 
 

package/dist/compile/index.d.ts

@@ -4,6 +4,7 @@ export { analyze, analyzeDsl } from "./analyze";
 export { analyzeEntities, detectCycles } from "./entities";
 export type { EntityAnalysis, EntityDiagnostic, EntityTypeExport, } from "./entities";
 export { buildManifest } from "./manifest";
+export { runCompile } from "./run";
 export { buildOpenApi, writeSchema } from "./openapi";
 export * from "./model";
 export interface CompileResult {

package/dist/compile/index.js

@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.writeSchema = exports.buildOpenApi = exports.buildManifest = exports.detectCycles = exports.analyzeEntities = exports.analyzeDsl = exports.analyze = void 0;
+exports.writeSchema = exports.buildOpenApi = exports.runCompile = exports.buildManifest = exports.detectCycles = exports.analyzeEntities = exports.analyzeDsl = exports.analyze = void 0;
 exports.resolveResourceFiles = resolveResourceFiles;
 exports.analyzeProject = analyzeProject;
 exports.detectTransitionProblems = detectTransitionProblems;
@@ -61,6 +61,8 @@ Object.defineProperty(exports, "analyzeEntities", { enumerable: true, get: funct
 Object.defineProperty(exports, "detectCycles", { enumerable: true, get: function () { return entities_2.detectCycles; } });
 var manifest_2 = require("./manifest");
 Object.defineProperty(exports, "buildManifest", { enumerable: true, get: function () { return manifest_2.buildManifest; } });
+var run_1 = require("./run");
+Object.defineProperty(exports, "runCompile", { enumerable: true, get: function () { return run_1.runCompile; } });
 var openapi_2 = require("./openapi");
 Object.defineProperty(exports, "buildOpenApi", { enumerable: true, get: function () { return openapi_2.buildOpenApi; } });
 Object.defineProperty(exports, "writeSchema", { enumerable: true, get: function () { return openapi_2.writeSchema; } });
@@ -96,7 +98,8 @@ function resolveResourceFiles(input) {
                     if (!IGNORE_DIRS.has(entry.name))
                         walk(path.join(dir, entry.name));
                 }
-                else if (/\.tsx?$/.test(entry.name) && !entry.name.endsWith(".d.ts")) {
+                else if (/\.tsx?$/.test(entry.name) &&
+                    !entry.name.endsWith(".d.ts")) {
                     files.push(path.resolve(dir, entry.name));
                 }
             }
@@ -124,7 +127,9 @@ function analyzeProject(input) {
         ...fromDsl.resources,
         ...fromInterfaces.resources.filter((r) => !defined.has(`${r.app}.${r.model}`)),
     ];
-    resources.sort((a, b) => a.app === b.app ? a.model.localeCompare(b.model) : a.app.localeCompare(b.app));
+    resources.sort((a, b) => a.app === b.app
+        ? a.model.localeCompare(b.model)
+        : a.app.localeCompare(b.app));
     // Registry entries follow the same merge rule as the resources: the DSL
     // definition wins an `app.model` collision.
     const types = [

package/dist/compile/run.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Run the compiler **in-process**, writing `schema.rastack.json` +
+ * `openapi.json` (and `rastack-env.d.ts`) into `outDir`. Prints any warnings
+ * and, on failure, the error; returns `true` on success.
+ *
+ * This is the single entry point the two real modalities of use share instead
+ * of shelling out to a standalone `compile` command:
+ *   • `rastack dev` / `rastack admin` — local development (compile, then serve
+ *     the app + admin in the browser over WASM), and
+ *   • `rastack ci` — the deploy pipeline (compile the manifest the Rust backend
+ *     reads + the OpenAPI contract, then build/ship).
+ */
+export declare function runCompile(resourcesDir: string, outDir: string): boolean;

package/dist/compile/run.js

@@ -0,0 +1,63 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCompile = runCompile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const index_1 = require("./index");
+/**
+ * Run the compiler **in-process**, writing `schema.rastack.json` +
+ * `openapi.json` (and `rastack-env.d.ts`) into `outDir`. Prints any warnings
+ * and, on failure, the error; returns `true` on success.
+ *
+ * This is the single entry point the two real modalities of use share instead
+ * of shelling out to a standalone `compile` command:
+ *   • `rastack dev` / `rastack admin` — local development (compile, then serve
+ *     the app + admin in the browser over WASM), and
+ *   • `rastack ci` — the deploy pipeline (compile the manifest the Rust backend
+ *     reads + the OpenAPI contract, then build/ship).
+ */
+function runCompile(resourcesDir, outDir) {
+    try {
+        const result = (0, index_1.compile)(resourcesDir, outDir);
+        for (const d of result.diagnostics)
+            console.warn(`  ⚠ ${d.message}`);
+        return fs.existsSync(path.join(outDir, "schema.rastack.json"));
+    }
+    catch (err) {
+        console.error(`  ✗ ${err.message}`);
+        return false;
+    }
+}

package/dist/deploy/ci.d.ts

@@ -20,10 +20,17 @@ export type CiPhase = "check" | "build" | "deploy";
 export interface CiStep {
     /** Human label, echoed before the step runs. */
     name: string;
-    /** The shell command to execute. */
+    /** The shell command to execute (or, for an in-process step, a description). */
     run: string;
     /** Working directory relative to the repo root (default: repo root). */
     cwd?: string;
+    /**
+     * When set, the step is executed **in-process by the CLI** rather than through
+     * a shell — `run` is then a human-readable description, not a command. Today
+     * the only in-process action is `"compile"`, which the CLI runs via the shared
+     * compiler (`runCompile`) instead of shelling out to a standalone command.
+     */
+    action?: "compile";
 }
 export interface CiPlanOptions {
     /** How to invoke the rastack CLI for nested steps (default: `rastack`). */

package/dist/deploy/ci.js

@@ -21,6 +21,19 @@ exports.checkSteps = checkSteps;
 exports.buildSteps = buildSteps;
 exports.deploySteps = deploySteps;
 exports.ciPlan = ciPlan;
+/**
+ * The in-process compile step shared by `check` and `build`: it produces
+ * `schema.rastack.json` + `openapi.json` in `cfg.outDir` without a subprocess,
+ * so compilation lives inside the two modalities of use (`dev` and `ci`) rather
+ * than in a separately-invoked `compile` command.
+ */
+function compileStep(cfg) {
+    return {
+        name: "Compile manifest + OpenAPI",
+        run: `compile ${cfg.resourcesDir} ${cfg.outDir} (in-process)`,
+        action: "compile",
+    };
+}
 /**
  * A stack Output value: the literal from `cfg.outputs` if wired, else a shell
  * command substitution that resolves it live from CloudFormation. Keeping the
@@ -46,10 +59,7 @@ function checkSteps(cfg, bin) {
             name: "Validate resource graph",
             run: `${bin} check ${cfg.resourcesDir}`,
         },
-        {
-            name: "Compile manifest + OpenAPI",
-            run: `${bin} compile ${cfg.resourcesDir} ${cfg.outDir}`,
-        },
+        compileStep(cfg),
     ];
 }
 /**
@@ -58,15 +68,11 @@ function checkSteps(cfg, bin) {
  * binary together with the files it reads at `/var/task`.
  */
 function buildSteps(cfg, opts = {}) {
-    const bin = opts.bin ?? "rastack";
     const stage = stageDir(cfg);
     const archFlag = cfg.lambda.arch === "arm64" ? "--arm64" : "--x86-64";
     const jwks = stackOutput(cfg, "JwksUrl", opts.jwksUrl ?? cfg.outputs?.jwksUrl);
     return [
-        {
-            name: "Compile manifest + OpenAPI",
-            run: `${bin} compile ${cfg.resourcesDir} ${cfg.outDir}`,
-        },
+        compileStep(cfg),
         {
             name: "Cross-build the Lambda binary",
             run: `cargo lambda build --release ${archFlag} --bin ${cfg.lambda.bin} --features ${cfg.lambda.features}`,

package/dist/rastack-admin.js

@@ -57,16 +57,9 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const http = __importStar(require("http"));
 const path = __importStar(require("path"));
+const compile_1 = require("./compile");
 const harness_1 = require("./dev/harness");
 const HERE = __dirname; // dist/ when installed — the bundle lives beside us.
-/** Compile the resources to schema.rastack.json + openapi.json in outDir. */
-function compile(resourcesDir, outDir) {
-    const compiler = path.join(HERE, "rastack-compile.js");
-    const result = (0, child_process_1.spawnSync)(process.execPath, [compiler, "compile", resourcesDir, outDir], { stdio: "inherit" });
-    if (result.status !== 0)
-        return false;
-    return fs.existsSync(path.join(outDir, "schema.rastack.json"));
-}
 /** Locate the prebuilt wasm bundle dir shipped in the package (no cargo fallback). */
 function resolveWasmDir() {
     for (const dir of (0, harness_1.wasmBundleCandidates)(HERE)) {
@@ -121,7 +114,7 @@ function main(argv) {
     const args = (0, harness_1.parseAdminArgs)(argv);
     console.log(`\n  rastack admin — the database console, built with React API Stack\n`);
     console.log(`▸ Compiling ${args.resourcesDir} → ${args.outDir}`);
-    if (!compile(args.resourcesDir, args.outDir)) {
+    if (!(0, compile_1.runCompile)(args.resourcesDir, args.outDir)) {
         console.error("  ✗ compile failed — fix the resource graph and re-run.");
         process.exit(1);
     }

package/dist/rastack-ci.js

@@ -18,6 +18,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const child_process_1 = require("child_process");
+const compile_1 = require("./compile");
 const ci_1 = require("./deploy/ci");
 const io_1 = require("./deploy/io");
 const PHASES = ["check", "build", "deploy"];
@@ -74,12 +75,23 @@ function printPlan(phase, steps) {
     steps.forEach((s, i) => {
         const at = s.cwd ? ` (in ${s.cwd}/)` : "";
         console.log(`  ${i + 1}. ${s.name}${at}`);
-        console.log(`     $ ${s.run}\n`);
+        // In-process steps have no shell command; `run` is a description.
+        console.log(`     ${s.action ? "» " : "$ "}${s.run}\n`);
     });
 }
-function runSteps(phase, steps) {
+function runSteps(phase, steps, cfg) {
     for (const step of steps) {
         console.log(`\n▸ ${step.name}${step.cwd ? ` (in ${step.cwd}/)` : ""}`);
+        if (step.action === "compile") {
+            // Compilation runs in-process — it lives inside `ci` (and `dev`), not in a
+            // separately-invoked `compile` command.
+            console.log(`  » ${step.run}`);
+            if (!(0, compile_1.runCompile)(cfg.resourcesDir, cfg.outDir)) {
+                console.error(`\n  ✗ step failed: ${step.name}`);
+                process.exit(1);
+            }
+            continue;
+        }
         console.log(`  $ ${step.run}`);
         try {
             // Runs a CI pipeline step derived from the developer's own deploy config
@@ -111,7 +123,7 @@ function main(argv) {
     if (plan)
         printPlan(phase, steps);
     else
-        runSteps(phase, steps);
+        runSteps(phase, steps, cfg);
 }
 if (require.main === module) {
     main(process.argv.slice(2));

package/dist/rastack-compile.d.ts

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
 /**
- * `rastack compile | check | list | urls` — the TypeScript-first replacement for the
- * old Django `manage.py rastack` command.
+ * `rastack check | list | urls` — introspection over the TypeScript-first
+ * resource graph.
  *
- *   rastack compile [resourcesDir] [outDir]   defs → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]            validate the resource graph (exit != 0 on error)
  *   rastack list    [resourcesDir]            print every resource + its fields/relations
  *   rastack urls    [resourcesDir]            print the generated /api/{app}/v1/{model}/ routes
+ *
+ * Compilation itself (defs → schema.rastack.json + openapi.json) is no longer a
+ * command here: it runs in-process inside the two modalities of use — `rastack
+ * dev`/`admin` (local) and `rastack ci` (deploy) — via the shared `runCompile`.
  */
 export {};

package/dist/rastack-compile.js

@@ -1,30 +1,23 @@
 #!/usr/bin/env node
 "use strict";
 /**
- * `rastack compile | check | list | urls` — the TypeScript-first replacement for the
- * old Django `manage.py rastack` command.
+ * `rastack check | list | urls` — introspection over the TypeScript-first
+ * resource graph.
  *
- *   rastack compile [resourcesDir] [outDir]   defs → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]            validate the resource graph (exit != 0 on error)
  *   rastack list    [resourcesDir]            print every resource + its fields/relations
  *   rastack urls    [resourcesDir]            print the generated /api/{app}/v1/{model}/ routes
+ *
+ * Compilation itself (defs → schema.rastack.json + openapi.json) is no longer a
+ * command here: it runs in-process inside the two modalities of use — `rastack
+ * dev`/`admin` (local) and `rastack ci` (deploy) — via the shared `runCompile`.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 const compile_1 = require("./compile");
 const DEFAULT_RESOURCES = "resources";
-const DEFAULT_OUT = ".rastack";
 function main(argv) {
     const [sub, ...rest] = argv;
     switch (sub) {
-        case "compile": {
-            const resourcesDir = rest[0] || DEFAULT_RESOURCES;
-            const outDir = rest[1] || DEFAULT_OUT;
-            const result = (0, compile_1.compile)(resourcesDir, outDir);
-            for (const d of result.diagnostics)
-                console.warn(`  ⚠ ${d.message}`);
-            console.log(`✓ compiled ${result.manifest.resources.length} resource(s) → ${result.files.join(", ")}`);
-            break;
-        }
         case "check": {
             const { resources, diagnostics } = (0, compile_1.analyzeProject)(rest[0] || DEFAULT_RESOURCES);
             const errors = [
@@ -54,7 +47,9 @@ function main(argv) {
             for (const r of resources) {
                 console.log(`${r.app}.${r.model}`);
                 for (const f of r.fields) {
-                    const rel = f.relation ? ` → ${f.relation.app}.${f.relation.model}` : "";
+                    const rel = f.relation
+                        ? ` → ${f.relation.app}.${f.relation.model}`
+                        : "";
                     console.log(`  ${f.name}: ${f.type}${rel}`);
                 }
                 if (r.sync) {
@@ -78,9 +73,8 @@ function main(argv) {
             break;
         }
         default:
-            console.error(`Unknown compile subcommand: "${sub}"\n\n` +
+            console.error(`Unknown subcommand: "${sub}"\n\n` +
                 `Usage:\n` +
-                `  rastack compile [resourcesDir] [outDir]\n` +
                 `  rastack check   [resourcesDir]\n` +
                 `  rastack list    [resourcesDir]\n` +
                 `  rastack urls    [resourcesDir]\n`);

package/dist/rastack-dev.js

@@ -58,20 +58,13 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const http = __importStar(require("http"));
 const path = __importStar(require("path"));
+const compile_1 = require("./compile");
 const harness_1 = require("./dev/harness");
 const HERE = __dirname; // dist/ when installed
-/** Compile the resources to schema.rastack.json + openapi.json in outDir. */
-function compile(resourcesDir, outDir) {
-    const compiler = path.join(HERE, "rastack-compile.js");
-    const result = (0, child_process_1.spawnSync)(process.execPath, [compiler, "compile", resourcesDir, outDir], { stdio: "inherit" });
-    if (result.status !== 0)
-        return false;
-    return fs.existsSync(path.join(outDir, "schema.rastack.json"));
-}
 /** True when `cargo` is on PATH (the from-source wasm fallback needs it). */
 function cargoAvailable() {
     try {
-        return ((0, child_process_1.spawnSync)("cargo", ["--version"], { stdio: "ignore" }).status === 0);
+        return (0, child_process_1.spawnSync)("cargo", ["--version"], { stdio: "ignore" }).status === 0;
     }
     catch {
         return false;
@@ -155,7 +148,7 @@ function main(argv) {
     const args = (0, harness_1.parseDevArgs)(argv);
     console.log(`\n  rastack dev — your app, in your browser over WASM\n`);
     console.log(`▸ Compiling ${args.resourcesDir} → ${args.outDir}`);
-    if (!compile(args.resourcesDir, args.outDir)) {
+    if (!(0, compile_1.runCompile)(args.resourcesDir, args.outDir)) {
         console.error("  ✗ compile failed — fix the resource graph and re-run.");
         process.exit(1);
     }

package/dist/rastack.d.ts

@@ -2,8 +2,10 @@
 /**
  * rastack — unified CLI for React API Stack
  *
+ * Compilation is not a command of its own: it runs in-process inside the two
+ * modalities of use — `rastack dev`/`admin` (local) and `rastack ci` (deploy).
+ *
  * Commands:
- *   rastack compile [resourcesDir] [outDir]     TypeScript resources → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]              Validate the resource graph
  *   rastack list    [resourcesDir]              Print resources, fields and relations
  *   rastack urls    [resourcesDir]              Print the generated /api/{app}/v1/{model}/ routes

package/dist/rastack.js

@@ -3,8 +3,10 @@
 /**
  * rastack — unified CLI for React API Stack
  *
+ * Compilation is not a command of its own: it runs in-process inside the two
+ * modalities of use — `rastack dev`/`admin` (local) and `rastack ci` (deploy).
+ *
  * Commands:
- *   rastack compile [resourcesDir] [outDir]     TypeScript resources → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]              Validate the resource graph
  *   rastack list    [resourcesDir]              Print resources, fields and relations
  *   rastack urls    [resourcesDir]              Print the generated /api/{app}/v1/{model}/ routes
@@ -64,6 +66,15 @@ switch (command) {
         printVersion();
         break;
     case "compile":
+        // Compilation is no longer a standalone command — it runs in-process as
+        // part of the two modalities of use. Point the way rather than 404.
+        console.error("`rastack compile` has been removed — compilation now runs automatically\n" +
+            "inside the two modalities of use:\n" +
+            "  • rastack dev    local development (compiles, then serves over WASM)\n" +
+            "  • rastack ci     the deploy pipeline (compiles the manifest + OpenAPI)\n\n" +
+            "Introspect the resource graph with: rastack check | list | urls\n");
+        process.exit(1);
+        break;
     case "check":
     case "list":
     case "urls":
@@ -133,7 +144,6 @@ switch (command) {
     default:
         console.error(`Unknown command: "${command}"\n\n` +
             `Usage:\n` +
-            `  rastack compile [resourcesDir] [outDir]\n` +
             `  rastack check | list | urls [resourcesDir]\n` +
             `  rastack generate [--schema-only]\n` +
             `  rastack tokens  [input] [outDir] [--prefix p]  Compile design tokens → CSS vars + typed theme\n` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rastack",
-  "version": "0.0.56",
+  "version": "0.0.57",
   "description": "",
   "main": "runtime.ts",
   "types": "runtime.ts",

package/src/compile/index.ts

@@ -21,6 +21,7 @@ export type {
   EntityTypeExport,
 } from "./entities";
 export { buildManifest } from "./manifest";
+export { runCompile } from "./run";
 export { buildOpenApi, writeSchema } from "./openapi";
 export * from "./model";
 
@@ -60,7 +61,10 @@ export function resolveResourceFiles(input: string): string[] {
       for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
         if (entry.isDirectory()) {
           if (!IGNORE_DIRS.has(entry.name)) walk(path.join(dir, entry.name));
-        } else if (/\.tsx?$/.test(entry.name) && !entry.name.endsWith(".d.ts")) {
+        } else if (
+          /\.tsx?$/.test(entry.name) &&
+          !entry.name.endsWith(".d.ts")
+        ) {
           files.push(path.resolve(dir, entry.name));
         }
       }
@@ -96,10 +100,14 @@ export function analyzeProject(input: string): ProjectAnalysis {
   const defined = new Set(fromDsl.resources.map((r) => `${r.app}.${r.model}`));
   const resources = [
     ...fromDsl.resources,
-    ...fromInterfaces.resources.filter((r) => !defined.has(`${r.app}.${r.model}`)),
+    ...fromInterfaces.resources.filter(
+      (r) => !defined.has(`${r.app}.${r.model}`),
+    ),
   ];
   resources.sort((a, b) =>
-    a.app === b.app ? a.model.localeCompare(b.model) : a.app.localeCompare(b.app),
+    a.app === b.app
+      ? a.model.localeCompare(b.model)
+      : a.app.localeCompare(b.app),
   );
 
   // Registry entries follow the same merge rule as the resources: the DSL
@@ -237,7 +245,8 @@ export function collisions(resources: ResourceModel[]): string[] {
     }
   }
   for (const [key, count] of seen) {
-    if (count > 1) errors.push(`Duplicate resource ${key} defined ${count} times.`);
+    if (count > 1)
+      errors.push(`Duplicate resource ${key} defined ${count} times.`);
   }
   return errors;
 }

package/src/compile/run.ts

@@ -0,0 +1,26 @@
+import * as fs from "fs";
+import * as path from "path";
+import { compile } from "./index";
+
+/**
+ * Run the compiler **in-process**, writing `schema.rastack.json` +
+ * `openapi.json` (and `rastack-env.d.ts`) into `outDir`. Prints any warnings
+ * and, on failure, the error; returns `true` on success.
+ *
+ * This is the single entry point the two real modalities of use share instead
+ * of shelling out to a standalone `compile` command:
+ *   • `rastack dev` / `rastack admin` — local development (compile, then serve
+ *     the app + admin in the browser over WASM), and
+ *   • `rastack ci` — the deploy pipeline (compile the manifest the Rust backend
+ *     reads + the OpenAPI contract, then build/ship).
+ */
+export function runCompile(resourcesDir: string, outDir: string): boolean {
+  try {
+    const result = compile(resourcesDir, outDir);
+    for (const d of result.diagnostics) console.warn(`  ⚠ ${d.message}`);
+    return fs.existsSync(path.join(outDir, "schema.rastack.json"));
+  } catch (err) {
+    console.error(`  ✗ ${(err as Error).message}`);
+    return false;
+  }
+}

package/src/deploy/ci.ts

@@ -23,10 +23,31 @@ export type CiPhase = "check" | "build" | "deploy";
 export interface CiStep {
   /** Human label, echoed before the step runs. */
   name: string;
-  /** The shell command to execute. */
+  /** The shell command to execute (or, for an in-process step, a description). */
   run: string;
   /** Working directory relative to the repo root (default: repo root). */
   cwd?: string;
+  /**
+   * When set, the step is executed **in-process by the CLI** rather than through
+   * a shell — `run` is then a human-readable description, not a command. Today
+   * the only in-process action is `"compile"`, which the CLI runs via the shared
+   * compiler (`runCompile`) instead of shelling out to a standalone command.
+   */
+  action?: "compile";
+}
+
+/**
+ * The in-process compile step shared by `check` and `build`: it produces
+ * `schema.rastack.json` + `openapi.json` in `cfg.outDir` without a subprocess,
+ * so compilation lives inside the two modalities of use (`dev` and `ci`) rather
+ * than in a separately-invoked `compile` command.
+ */
+function compileStep(cfg: DeployConfig): CiStep {
+  return {
+    name: "Compile manifest + OpenAPI",
+    run: `compile ${cfg.resourcesDir} ${cfg.outDir} (in-process)`,
+    action: "compile",
+  };
 }
 
 export interface CiPlanOptions {
@@ -72,10 +93,7 @@ export function checkSteps(cfg: DeployConfig, bin: string): CiStep[] {
       name: "Validate resource graph",
       run: `${bin} check ${cfg.resourcesDir}`,
     },
-    {
-      name: "Compile manifest + OpenAPI",
-      run: `${bin} compile ${cfg.resourcesDir} ${cfg.outDir}`,
-    },
+    compileStep(cfg),
   ];
 }
 
@@ -88,7 +106,6 @@ export function buildSteps(
   cfg: DeployConfig,
   opts: CiPlanOptions = {},
 ): CiStep[] {
-  const bin = opts.bin ?? "rastack";
   const stage = stageDir(cfg);
   const archFlag = cfg.lambda.arch === "arm64" ? "--arm64" : "--x86-64";
   const jwks = stackOutput(
@@ -97,10 +114,7 @@ export function buildSteps(
     opts.jwksUrl ?? cfg.outputs?.jwksUrl,
   );
   return [
-    {
-      name: "Compile manifest + OpenAPI",
-      run: `${bin} compile ${cfg.resourcesDir} ${cfg.outDir}`,
-    },
+    compileStep(cfg),
     {
       name: "Cross-build the Lambda binary",
       run: `cargo lambda build --release ${archFlag} --bin ${cfg.lambda.bin} --features ${cfg.lambda.features}`,

package/src/rastack-admin.ts

@@ -20,10 +20,11 @@
  * falls back to a from-source cargo build.
  */
 
-import { execFileSync, spawnSync } from "child_process";
+import { execFileSync } from "child_process";
 import * as fs from "fs";
 import * as http from "http";
 import * as path from "path";
+import { runCompile } from "./compile";
 import {
   WASM_ENTRY,
   contentType,
@@ -34,18 +35,6 @@ import {
 
 const HERE = __dirname; // dist/ when installed — the bundle lives beside us.
 
-/** Compile the resources to schema.rastack.json + openapi.json in outDir. */
-function compile(resourcesDir: string, outDir: string): boolean {
-  const compiler = path.join(HERE, "rastack-compile.js");
-  const result = spawnSync(
-    process.execPath,
-    [compiler, "compile", resourcesDir, outDir],
-    { stdio: "inherit" },
-  );
-  if (result.status !== 0) return false;
-  return fs.existsSync(path.join(outDir, "schema.rastack.json"));
-}
-
 /** Locate the prebuilt wasm bundle dir shipped in the package (no cargo fallback). */
 function resolveWasmDir(): string | null {
   for (const dir of wasmBundleCandidates(HERE)) {
@@ -106,9 +95,11 @@ function openBrowser(url: string): void {
 function main(argv: string[]): void {
   const args = parseAdminArgs(argv);
 
-  console.log(`\n  rastack admin — the database console, built with React API Stack\n`);
+  console.log(
+    `\n  rastack admin — the database console, built with React API Stack\n`,
+  );
   console.log(`▸ Compiling ${args.resourcesDir} → ${args.outDir}`);
-  if (!compile(args.resourcesDir, args.outDir)) {
+  if (!runCompile(args.resourcesDir, args.outDir)) {
     console.error("  ✗ compile failed — fix the resource graph and re-run.");
     process.exit(1);
   }

package/src/rastack-ci.ts

@@ -18,6 +18,8 @@
  */
 
 import { execSync } from "child_process";
+import { runCompile } from "./compile";
+import { DeployConfig } from "./deploy/config";
 import { CiPhase, CiPlanOptions, CiStep, ciPlan } from "./deploy/ci";
 import { loadConfig } from "./deploy/io";
 
@@ -85,13 +87,24 @@ function printPlan(phase: CiPhase, steps: CiStep[]): void {
   steps.forEach((s, i) => {
     const at = s.cwd ? ` (in ${s.cwd}/)` : "";
     console.log(`  ${i + 1}. ${s.name}${at}`);
-    console.log(`     $ ${s.run}\n`);
+    // In-process steps have no shell command; `run` is a description.
+    console.log(`     ${s.action ? "» " : "$ "}${s.run}\n`);
   });
 }
 
-function runSteps(phase: CiPhase, steps: CiStep[]): void {
+function runSteps(phase: CiPhase, steps: CiStep[], cfg: DeployConfig): void {
   for (const step of steps) {
     console.log(`\n▸ ${step.name}${step.cwd ? ` (in ${step.cwd}/)` : ""}`);
+    if (step.action === "compile") {
+      // Compilation runs in-process — it lives inside `ci` (and `dev`), not in a
+      // separately-invoked `compile` command.
+      console.log(`  » ${step.run}`);
+      if (!runCompile(cfg.resourcesDir, cfg.outDir)) {
+        console.error(`\n  ✗ step failed: ${step.name}`);
+        process.exit(1);
+      }
+      continue;
+    }
     console.log(`  $ ${step.run}`);
     try {
       // Runs a CI pipeline step derived from the developer's own deploy config
@@ -123,7 +136,7 @@ function main(argv: string[]): void {
   }
   const steps = ciPlan(phase, cfg, opts);
   if (plan) printPlan(phase, steps);
-  else runSteps(phase, steps);
+  else runSteps(phase, steps, cfg);
 }
 
 if (require.main === module) {

package/src/rastack-compile.ts

@@ -1,40 +1,31 @@
 #!/usr/bin/env node
 
 /**
- * `rastack compile | check | list | urls` — the TypeScript-first replacement for the
- * old Django `manage.py rastack` command.
+ * `rastack check | list | urls` — introspection over the TypeScript-first
+ * resource graph.
  *
- *   rastack compile [resourcesDir] [outDir]   defs → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]            validate the resource graph (exit != 0 on error)
  *   rastack list    [resourcesDir]            print every resource + its fields/relations
  *   rastack urls    [resourcesDir]            print the generated /api/{app}/v1/{model}/ routes
+ *
+ * Compilation itself (defs → schema.rastack.json + openapi.json) is no longer a
+ * command here: it runs in-process inside the two modalities of use — `rastack
+ * dev`/`admin` (local) and `rastack ci` (deploy) — via the shared `runCompile`.
  */
 
 import {
   analyzeProject,
   analyzeResources,
   collisions,
-  compile,
   urlsFor,
 } from "./compile";
 
 const DEFAULT_RESOURCES = "resources";
-const DEFAULT_OUT = ".rastack";
 
 function main(argv: string[]): void {
   const [sub, ...rest] = argv;
 
   switch (sub) {
-    case "compile": {
-      const resourcesDir = rest[0] || DEFAULT_RESOURCES;
-      const outDir = rest[1] || DEFAULT_OUT;
-      const result = compile(resourcesDir, outDir);
-      for (const d of result.diagnostics) console.warn(`  ⚠ ${d.message}`);
-      console.log(
-        `✓ compiled ${result.manifest.resources.length} resource(s) → ${result.files.join(", ")}`,
-      );
-      break;
-    }
     case "check": {
       const { resources, diagnostics } = analyzeProject(
         rest[0] || DEFAULT_RESOURCES,
@@ -65,7 +56,9 @@ function main(argv: string[]): void {
       for (const r of resources) {
         console.log(`${r.app}.${r.model}`);
         for (const f of r.fields) {
-          const rel = f.relation ? ` → ${f.relation.app}.${f.relation.model}` : "";
+          const rel = f.relation
+            ? ` → ${f.relation.app}.${f.relation.model}`
+            : "";
           console.log(`  ${f.name}: ${f.type}${rel}`);
         }
         if (r.sync) {
@@ -89,9 +82,8 @@ function main(argv: string[]): void {
     }
     default:
       console.error(
-        `Unknown compile subcommand: "${sub}"\n\n` +
+        `Unknown subcommand: "${sub}"\n\n` +
           `Usage:\n` +
-          `  rastack compile [resourcesDir] [outDir]\n` +
           `  rastack check   [resourcesDir]\n` +
           `  rastack list    [resourcesDir]\n` +
           `  rastack urls    [resourcesDir]\n`,

package/src/rastack-dev.ts

@@ -25,6 +25,7 @@ import { execFileSync, spawnSync } from "child_process";
 import * as fs from "fs";
 import * as http from "http";
 import * as path from "path";
+import { runCompile } from "./compile";
 import {
   APP_ENTRY,
   WASM_ENTRY,
@@ -37,24 +38,10 @@ import {
 
 const HERE = __dirname; // dist/ when installed
 
-/** Compile the resources to schema.rastack.json + openapi.json in outDir. */
-function compile(resourcesDir: string, outDir: string): boolean {
-  const compiler = path.join(HERE, "rastack-compile.js");
-  const result = spawnSync(
-    process.execPath,
-    [compiler, "compile", resourcesDir, outDir],
-    { stdio: "inherit" },
-  );
-  if (result.status !== 0) return false;
-  return fs.existsSync(path.join(outDir, "schema.rastack.json"));
-}
-
 /** True when `cargo` is on PATH (the from-source wasm fallback needs it). */
 function cargoAvailable(): boolean {
   try {
-    return (
-      spawnSync("cargo", ["--version"], { stdio: "ignore" }).status === 0
-    );
+    return spawnSync("cargo", ["--version"], { stdio: "ignore" }).status === 0;
   } catch {
     return false;
   }
@@ -146,7 +133,7 @@ function main(argv: string[]): void {
 
   console.log(`\n  rastack dev — your app, in your browser over WASM\n`);
   console.log(`▸ Compiling ${args.resourcesDir} → ${args.outDir}`);
-  if (!compile(args.resourcesDir, args.outDir)) {
+  if (!runCompile(args.resourcesDir, args.outDir)) {
     console.error("  ✗ compile failed — fix the resource graph and re-run.");
     process.exit(1);
   }

package/src/rastack.ts

@@ -3,8 +3,10 @@
 /**
  * rastack — unified CLI for React API Stack
  *
+ * Compilation is not a command of its own: it runs in-process inside the two
+ * modalities of use — `rastack dev`/`admin` (local) and `rastack ci` (deploy).
+ *
  * Commands:
- *   rastack compile [resourcesDir] [outDir]     TypeScript resources → schema.rastack.json + openapi.json
  *   rastack check   [resourcesDir]              Validate the resource graph
  *   rastack list    [resourcesDir]              Print resources, fields and relations
  *   rastack urls    [resourcesDir]              Print the generated /api/{app}/v1/{model}/ routes
@@ -65,6 +67,17 @@ switch (command) {
     printVersion();
     break;
   case "compile":
+    // Compilation is no longer a standalone command — it runs in-process as
+    // part of the two modalities of use. Point the way rather than 404.
+    console.error(
+      "`rastack compile` has been removed — compilation now runs automatically\n" +
+        "inside the two modalities of use:\n" +
+        "  • rastack dev    local development (compiles, then serves over WASM)\n" +
+        "  • rastack ci     the deploy pipeline (compiles the manifest + OpenAPI)\n\n" +
+        "Introspect the resource graph with: rastack check | list | urls\n",
+    );
+    process.exit(1);
+    break;
   case "check":
   case "list":
   case "urls":
@@ -135,7 +148,6 @@ switch (command) {
     console.error(
       `Unknown command: "${command}"\n\n` +
         `Usage:\n` +
-        `  rastack compile [resourcesDir] [outDir]\n` +
         `  rastack check | list | urls [resourcesDir]\n` +
         `  rastack generate [--schema-only]\n` +
         `  rastack tokens  [input] [outDir] [--prefix p]  Compile design tokens → CSS vars + typed theme\n` +

package/test/deploy.spec.ts

@@ -419,12 +419,15 @@ describe("repo variables + lambda env", () => {
 });
 
 describe("ci plan — check", () => {
-  it("validates then compiles, honouring the resources dir + bin", () => {
+  it("validates then compiles in-process, honouring the resources dir + bin", () => {
     const steps = checkSteps(base({ resourcesDir: "res" }), "npx rastack");
     expect(steps.map((s) => s.run)).toEqual([
       "npx rastack check res",
-      "npx rastack compile res .rastack",
+      "compile res .rastack (in-process)",
     ]);
+    // The compile step runs in-process (no shell command), so the CLI can drop
+    // the standalone `compile` command entirely.
+    expect(steps[1].action).toBe("compile");
     expect(ciPlan("check", base(), { bin: "rastack" })).toEqual(
       checkSteps(base(), "rastack"),
     );