@ericminassian/plat 0.1.0 → 0.2.0

package/dist/init.d.ts

@@ -19,5 +19,12 @@ export interface InitResult {
     files: string[];
 }
 export declare function initApp(opts: InitOptions): InitResult;
+/**
+ * pnpm 10+ refuses to install (ERR_PNPM_IGNORED_BUILDS) until a dependency's
+ * install script is allowed, and esbuild (used by `plat build`) has one. It's
+ * written here rather than shipped in templates/app: a pnpm-workspace.yaml
+ * there would make that folder its own workspace inside this monorepo.
+ */
+export declare const PNPM_WORKSPACE = "# esbuild (used by `plat build`) installs its native binary with a build script.\nallowBuilds:\n  esbuild: true\n";
 export declare function replaceAppName(content: string, name: string): string;
 export declare function rewritePackageJson(content: string, name: string, range: string): string;

package/dist/init.js

@@ -1,6 +1,6 @@
 import { copyFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync, } from 'node:fs';
 import { basename, dirname, extname, join, relative, resolve } from 'node:path';
-import { validateAppName } from '@ericminassian/platform-core';
+import { APP_CONFIG_FILE, validateAppName } from '@ericminassian/platform-core';
 import { cliPackageRoot, cliVersion } from './project.js';
 import { CliError, EXIT } from './util/output.js';
 /** The app name used throughout `templates/app`; replaced on `plat init`. */
@@ -28,10 +28,10 @@ const TEXT_EXT = new Set([
 /** Published CLI: `template/` inside the package. In this repo: `templates/app`. */
 export function templateDir() {
     const packaged = join(cliPackageRoot(), 'template');
-    if (existsSync(join(packaged, 'platform.json')))
+    if (existsSync(join(packaged, APP_CONFIG_FILE)))
         return packaged;
     const repo = resolve(cliPackageRoot(), '..', '..', 'templates', 'app');
-    if (existsSync(join(repo, 'platform.json')))
+    if (existsSync(join(repo, APP_CONFIG_FILE)))
         return repo;
     throw new CliError('app template not found (broken CLI install?)');
 }
@@ -50,8 +50,20 @@ export function initApp(opts) {
     const src = opts.template ?? templateDir();
     const range = opts.versionRange ?? `^${cliVersion()}`;
     const files = copyTree(src, dir, (rel, content) => rel === 'package.json' ? rewritePackageJson(content, name, range) : replaceAppName(content, name));
+    writeFileSync(join(dir, 'pnpm-workspace.yaml'), PNPM_WORKSPACE);
+    files.push('pnpm-workspace.yaml');
     return { dir, name, files: files.sort() };
 }
+/**
+ * pnpm 10+ refuses to install (ERR_PNPM_IGNORED_BUILDS) until a dependency's
+ * install script is allowed, and esbuild (used by `plat build`) has one. It's
+ * written here rather than shipped in templates/app: a pnpm-workspace.yaml
+ * there would make that folder its own workspace inside this monorepo.
+ */
+export const PNPM_WORKSPACE = `# esbuild (used by \`plat build\`) installs its native binary with a build script.
+allowBuilds:
+  esbuild: true
+`;
 export function replaceAppName(content, name) {
     return content.split(TEMPLATE_APP_NAME).join(name);
 }

package/dist/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/dist/project.d.ts

@@ -1,17 +1,16 @@
 import { type ResolvedManifest } from '@ericminassian/platform-core';
-export declare const MANIFEST_FILE = "platform.json";
 export interface Project {
-    /** Directory containing platform.json. */
+    /** Directory containing plat.config.ts. */
     root: string;
-    /** platform.json as written. */
+    /** The config's default export as JSON: exactly what is validated, built and deployed. */
     raw: Record<string, unknown>;
     manifest: ResolvedManifest;
 }
-/** Walk up from `cwd` to the nearest platform.json. */
+/** Walk up from `cwd` to the nearest plat.config.ts. */
 export declare function findProjectRoot(cwd: string): string | null;
-export declare function loadProject(cwd: string): Project;
-/** App name from `--app`, else the nearest platform.json. */
-export declare function resolveAppName(opt: string | undefined, cwd?: string): string;
+export declare function loadProject(cwd: string): Promise<Project>;
+/** App name from `--app`, else the nearest plat.config.ts. */
+export declare function resolveAppName(opt: string | undefined, cwd?: string): Promise<string>;
 export declare function cliVersion(): string;
 export declare function cliPackageRoot(): string;
 /**

package/dist/project.js

@@ -1,15 +1,26 @@
-import { existsSync, readFileSync } from 'node:fs';
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync, readFileSync, rmSync } from 'node:fs';
 import { createRequire } from 'node:module';
 import { dirname, join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { ManifestError, parseManifest } from '@ericminassian/platform-core';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { APP_CONFIG_FILE, ManifestError, parseManifest, } from '@ericminassian/platform-core';
+import { build as esbuild } from 'esbuild';
+import { buildFailureList } from './util/esbuild.js';
 import { CliError, EXIT } from './util/output.js';
-export const MANIFEST_FILE = 'platform.json';
-/** Walk up from `cwd` to the nearest platform.json. */
-export function findProjectRoot(cwd) {
+/** Apps configured with JSON before `plat.config.ts`; only detected to say how to move. */
+const LEGACY_MANIFEST_FILE = 'platform.json';
+/** Walk up from `cwd` to the nearest directory containing `name`. */
+function findUp(cwd, name) {
     let dir = resolve(cwd);
     for (;;) {
-        if (existsSync(join(dir, MANIFEST_FILE)))
+        if (existsSync(join(dir, name)))
             return dir;
         const parent = dirname(dir);
         if (parent === dir)
@@ -17,23 +28,30 @@ export function findProjectRoot(cwd) {
         dir = parent;
     }
 }
-export function loadProject(cwd) {
+/** Walk up from `cwd` to the nearest plat.config.ts. */
+export function findProjectRoot(cwd) {
+    return findUp(cwd, APP_CONFIG_FILE);
+}
+export async function loadProject(cwd) {
     const root = findProjectRoot(cwd);
     if (!root) {
-        throw new CliError(`no ${MANIFEST_FILE} found in ${cwd} or its parents`, {
-            hint: 'run this inside an app, or create one with `plat init <dir> --name <app>`',
+        const legacy = findUp(cwd, LEGACY_MANIFEST_FILE);
+        throw new CliError(`no ${APP_CONFIG_FILE} found in ${cwd} or its parents`, {
+            hint: legacy
+                ? `${join(legacy, LEGACY_MANIFEST_FILE)} is no longer read: move its fields into ${APP_CONFIG_FILE} as \`export default defineApp({ ... })\` from '@ericminassian/platform/config'`
+                : 'run this inside an app, or create one with `plat init <dir> --name <app>`',
             exitCode: EXIT.usage,
         });
     }
-    let raw;
-    try {
-        raw = JSON.parse(readFileSync(join(root, MANIFEST_FILE), 'utf8'));
-    }
-    catch (err) {
-        throw new CliError(`${MANIFEST_FILE} is not valid JSON: ${err.message}`, {
+    const exported = await importConfig(root);
+    if (exported === null || typeof exported !== 'object' || Array.isArray(exported)) {
+        throw new CliError(`${APP_CONFIG_FILE} must default-export the app config`, {
+            hint: "export default defineApp({ name: '...' }) from '@ericminassian/platform/config'",
             exitCode: EXIT.usage,
         });
     }
+    // The platform receives JSON, so validate (and later deploy) the JSON form.
+    const raw = JSON.parse(JSON.stringify(exported));
     try {
         return { root, raw, manifest: parseManifest(raw) };
     }
@@ -43,18 +61,57 @@ export function loadProject(cwd) {
         throw err;
     }
 }
-/** App name from `--app`, else the nearest platform.json. */
-export function resolveAppName(opt, cwd = process.cwd()) {
+/**
+ * Bundles the config (its relative imports included, packages left external)
+ * into `.plat/` and imports that, like Vite does for vite.config.ts. This
+ * works whatever the app's package `type` is, and a fresh file name means a
+ * changed config is always re-read.
+ */
+async function importConfig(root) {
+    const outfile = join(root, '.plat', `config-${process.pid}-${Date.now()}.mjs`);
+    try {
+        await esbuild({
+            entryPoints: [join(root, APP_CONFIG_FILE)],
+            outfile,
+            bundle: true,
+            packages: 'external',
+            platform: 'node',
+            format: 'esm',
+            target: 'node24',
+            sourcemap: 'inline',
+            logLevel: 'silent',
+            absWorkingDir: root,
+        });
+    }
+    catch (err) {
+        throw new CliError(`could not compile ${APP_CONFIG_FILE}:${buildFailureList(err)}`, {
+            exitCode: EXIT.usage,
+        });
+    }
+    try {
+        const mod = (await import(__rewriteRelativeImportExtension(pathToFileURL(outfile).href)));
+        return mod.default;
+    }
+    catch (err) {
+        throw new CliError(`${APP_CONFIG_FILE} threw while loading: ${err.message}`, {
+            exitCode: EXIT.usage,
+        });
+    }
+    finally {
+        rmSync(outfile, { force: true });
+    }
+}
+/** App name from `--app`, else the nearest plat.config.ts. */
+export async function resolveAppName(opt, cwd = process.cwd()) {
     if (opt)
         return opt;
-    const root = findProjectRoot(cwd);
-    if (!root) {
+    if (!findProjectRoot(cwd)) {
         throw new CliError('no app given', {
             hint: 'pass --app <name> or run inside an app directory',
             exitCode: EXIT.usage,
         });
     }
-    return loadProject(root).manifest.name;
+    return (await loadProject(cwd)).manifest.name;
 }
 export function cliVersion() {
     return cliPackageJson().version ?? '0.0.0';

package/dist/project.js.map

@@ -1 +1 @@
-{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"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"}

package/dist/util/esbuild.d.ts

@@ -0,0 +1,2 @@
+/** An esbuild failure as `file:line: message` items (or the error's message), for a CliError list. */
+export declare function buildFailureList(err: unknown): string;

package/dist/util/esbuild.js

@@ -0,0 +1,9 @@
+/** An esbuild failure as `file:line: message` items (or the error's message), for a CliError list. */
+export function buildFailureList(err) {
+    const errors = err.errors;
+    const lines = errors?.length
+        ? errors.map((e) => (e.location ? `${e.location.file}:${e.location.line}: ${e.text}` : e.text))
+        : [err.message];
+    return `\n  - ${lines.join('\n  - ')}`;
+}
+//# sourceMappingURL=esbuild.js.map

package/dist/util/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","sourceRoot":"","sources":["../../src/util/esbuild.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,MAAM,UAAU,gBAAgB,CAAC,GAAY;IAC3C,MAAM,MAAM,GACV,GACD,CAAC,MAAM,CAAC;IACT,MAAM,KAAK,GAAG,MAAM,EAAE,MAAM;QAC1B,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAE,GAAa,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,SAAS,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ericminassian/plat",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI for the platform: init, dev (AWS Emulator), build, deploy, logs, metrics, errors, data.",
   "type": "module",
   "license": "MIT",
@@ -34,9 +34,9 @@
     "@aws-sdk/client-s3": "^3.1169.0",
     "@aws-sdk/client-sqs": "^3.1169.0",
     "@aws-sdk/client-ssm": "^3.1169.0",
-    "@ericminassian/platform": "0.1.0",
-    "@ericminassian/platform-core": "0.1.0",
-    "@ericminassian/platform-engine": "0.1.0",
+    "@ericminassian/platform": "0.2.0",
+    "@ericminassian/platform-core": "0.2.0",
+    "@ericminassian/platform-engine": "0.2.0",
     "commander": "^15.1.0",
     "cron-parser": "^5.10.6",
     "esbuild": "^0.28.2",

package/src/build.ts

@@ -3,7 +3,8 @@ import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node
 import { delimiter, join, resolve } from 'node:path';
 import type { ArtifactFile, ResolvedManifest } from '@ericminassian/platform-core';
 import { build as esbuild, type Plugin } from 'esbuild';
-import { cliVersion, loadProject } from './project.ts';
+import { cliVersion, loadProject, type Project } from './project.ts';
+import { buildFailureList } from './util/esbuild.ts';
 import { CliError, EXIT, step } from './util/output.ts';
 import { dirExists, zipDirectory } from './util/zip.ts';
 
@@ -12,6 +13,8 @@ export const SDK_WORKER = '@ericminassian/platform/worker';
 
 export interface BuildOptions {
   cwd: string;
+  /** Already-loaded project (skips evaluating plat.config.ts again). */
+  project?: Project;
   /** Default `<app>/.plat/build`. */
   outDir?: string;
   /** Skip `web.build` (e.g. `plat dev`, which runs the dev server instead). */
@@ -38,10 +41,10 @@ export interface BuildResult {
  *  - `server.zip`  → `index.mjs` (+ map): the app's fetch handler wrapped by the SDK server
  *  - `worker.zip`  → `index.mjs` (+ map): `export const handler` for the worker Lambda
  *  - `static.zip`  → the built frontend
- *  - `manifest.json` → `{ manifest, resolved, build }`
+ *  - `manifest.json` → `{ manifest, resolved, build }` (`manifest` is plat.config.ts evaluated to JSON)
  */
 export async function buildApp(opts: BuildOptions): Promise<BuildResult> {
-  const project = loadProject(opts.cwd);
+  const project = opts.project ?? (await loadProject(opts.cwd));
   const { root, manifest, raw } = project;
   const outDir = resolve(opts.outDir ?? join(root, '.plat', 'build'));
   const want = (part: 'server' | 'worker' | 'static') => !opts.only || opts.only.includes(part);
@@ -198,13 +201,7 @@ async function bundle(o: {
       absWorkingDir: o.root,
     });
   } catch (err) {
-    const errors = (
-      err as { errors?: Array<{ text: string; location?: { file: string; line: number } | null }> }
-    ).errors;
-    const detail = errors
-      ?.map((e) => (e.location ? `${e.location.file}:${e.location.line}: ${e.text}` : e.text))
-      .join('\n  - ');
-    throw new CliError(`bundling failed${detail ? `:\n  - ${detail}` : `: ${(err as Error).message}`}`);
+    throw new CliError(`bundling failed:${buildFailureList(err)}`);
   }
   return o.outDir;
 }

package/src/commands/common.ts

@@ -17,9 +17,9 @@ export function withCommon(cmd: Command): Command {
     .addOption(new Option('--api-url <url>', 'platform API base URL').env('PLATFORM_API_URL'));
 }
 
-/** `--app` (defaults to platform.json) and `--stage` (defaults to prod). */
+/** `--app` (defaults to plat.config.ts) and `--stage` (defaults to prod). */
 export function withTarget(cmd: Command, stageDefault: string | false = 'prod'): Command {
-  cmd.option('--app <name>', 'app name (default: from platform.json)');
+  cmd.option('--app <name>', 'app name (default: from plat.config.ts)');
   if (stageDefault) cmd.option('--stage <stage>', 'stage', stageDefault);
   else cmd.option('--stage <stage>', 'stage');
   return withCommon(cmd);
@@ -29,7 +29,7 @@ export function apiFor(opts: CommonOpts): ApiClient {
   return new ApiClient(opts.apiUrl ? { baseUrl: opts.apiUrl } : {});
 }
 
-export function appFor(opts: CommonOpts): string {
+export function appFor(opts: CommonOpts): Promise<string> {
   return resolveAppName(opts.app);
 }
 

package/src/commands/lifecycle.ts

@@ -28,10 +28,11 @@ export function registerLifecycle(program: Command): void {
           '',
           '  next:',
           rel === '.' ? '' : `    cd ${rel}`,
-          '    pnpm install',
+          '    pnpm install                               # creates the lockfile CI installs from',
           '    pnpm dev                                   # local, on the AWS Emulator',
-          `    gh repo create <owner>/${v.name} --private --source . --push`,
-          `    plat apps create ${v.name} --repo <owner>/${v.name}`,
+          `    plat apps create ${v.name} --repo <owner>/${v.name}   # register before the first push`,
+          `    git init && git add -A && git commit -m "Initial commit"`,
+          `    gh repo create <owner>/${v.name} --private --source . --push   # CI deploys https://${v.name}.<domain>`,
         ]
           .filter(Boolean)
           .join('\n'),

package/src/commands/manage.ts

@@ -15,7 +15,7 @@ export function registerManage(program: Command): void {
 
   withTarget(secrets.command('list').description('secret names for a stage (and shared ones)')).action(
     action(async (opts: TargetOpts) => {
-      const list = await apiFor(opts).listSecrets(appFor(opts), { stage: opts.stage });
+      const list = await apiFor(opts).listSecrets(await appFor(opts), { stage: opts.stage });
       result(list, (l) =>
         table(
           l.map((s) => ({
@@ -40,7 +40,7 @@ export function registerManage(program: Command): void {
       const v = value ?? (process.stdin.isTTY ? await prompt(`value for ${name}: `) : readStdin());
       if (!v) throw new CliError('empty secret value', { exitCode: EXIT.usage });
       const info = await apiFor(opts).setSecret(
-        appFor(opts),
+        await appFor(opts),
         name,
         opts.shared ? { value: v, shared: true } : { value: v, stage: opts.stage },
       );
@@ -61,7 +61,7 @@ export function registerManage(program: Command): void {
     action(async (name: string, opts: TargetOpts & { shared?: boolean }) => {
       checkSecretName(name);
       await apiFor(opts).deleteSecret(
-        appFor(opts),
+        await appFor(opts),
         name,
         opts.shared ? { shared: true } : { stage: opts.stage },
       );
@@ -72,7 +72,7 @@ export function registerManage(program: Command): void {
   // ------------------------------------------------------------ deployments & stages
   withTarget(program.command('deployments').description('recent deployments'), false).action(
     action(async (opts: CommonOpts & { stage?: string }) => {
-      const list = await apiFor(opts).listDeployments(appFor(opts), opts.stage);
+      const list = await apiFor(opts).listDeployments(await appFor(opts), opts.stage);
       result(list, (l) =>
         table(
           l.map((d) => ({
@@ -96,7 +96,7 @@ export function registerManage(program: Command): void {
 
   withTarget(program.command('stages').description('stages of an app'), false).action(
     action(async (opts: CommonOpts) => {
-      const list = await apiFor(opts).listStages(appFor(opts));
+      const list = await apiFor(opts).listStages(await appFor(opts));
       result(list, (l) =>
         table(
           l.map((s) => ({
@@ -118,7 +118,7 @@ export function registerManage(program: Command): void {
       .option('--to <deploymentId>', 'a specific earlier deployment'),
   ).action(
     action(async (opts: TargetOpts & { to?: string }) => {
-      const r = await apiFor(opts).rollback(appFor(opts), opts.stage, opts.to);
+      const r = await apiFor(opts).rollback(await appFor(opts), opts.stage, opts.to);
       result(r, () => `${pc.green('✓')} rolled back ${opts.stage}`);
     }),
   );
@@ -139,7 +139,7 @@ export function registerManage(program: Command): void {
           exitCode: EXIT.usage,
         });
       }
-      const app = appFor(opts);
+      const app = await appFor(opts);
       await confirmByTyping(`destroy ${app}/${opts.stage}?`, opts.stage, opts.yes);
       await apiFor(opts).destroyStage(app, opts.stage);
       result(
@@ -153,7 +153,7 @@ export function registerManage(program: Command): void {
   const cron = program.command('cron').description('scheduled jobs');
   withTarget(cron.command('run <name>').description('run a cron now on a deployed stage')).action(
     action(async (name: string, opts: TargetOpts) => {
-      await apiFor(opts).runCron(appFor(opts), name, opts.stage);
+      await apiFor(opts).runCron(await appFor(opts), name, opts.stage);
       result(
         { cron: name, stage: opts.stage, triggered: true },
         () => `${pc.green('✓')} triggered ${name} on ${opts.stage}`,

package/src/commands/observe.ts

@@ -32,7 +32,7 @@ export function registerObserve(program: Command): void {
       ) => {
         const keep = (l: LogLine) => opts.runtime || l.level !== 'system';
         const api = apiFor(opts);
-        const app = appFor(opts);
+        const app = await appFor(opts);
         if (opts.follow) {
           const ac = new AbortController();
           process.once('SIGINT', () => ac.abort());
@@ -74,7 +74,7 @@ export function registerObserve(program: Command): void {
   ).action(
     action(async (opts: TargetOpts & { since: string }) => {
       const api = apiFor(opts);
-      const app = appFor(opts);
+      const app = await appFor(opts);
       const range = sinceRange(opts.since);
       const [metrics, routes, jobs] = await Promise.all([
         api.metrics(app, { stage: opts.stage, ...range }),
@@ -150,7 +150,7 @@ export function registerObserve(program: Command): void {
 
   withTarget(program.command('errors').description('grouped errors for a stage')).action(
     action(async (opts: TargetOpts) => {
-      const groups = await apiFor(opts).errors(appFor(opts), { stage: opts.stage });
+      const groups = await apiFor(opts).errors(await appFor(opts), { stage: opts.stage });
       result(groups, (g) =>
         table(
           g.map((e) => ({
@@ -173,7 +173,7 @@ export function registerObserve(program: Command): void {
       .description('every event of one request/job across web, queues and worker'),
   ).action(
     action(async (traceId: string, opts: TargetOpts) => {
-      const t = await apiFor(opts).trace(appFor(opts), traceId, { stage: opts.stage });
+      const t = await apiFor(opts).trace(await appFor(opts), traceId, { stage: opts.stage });
       result(t, (v) => formatTrace(v.events));
     }),
   );
@@ -200,7 +200,7 @@ export function registerObserve(program: Command): void {
         },
       ) => {
         const api = apiFor(opts);
-        const app = appFor(opts);
+        const app = await appFor(opts);
         if (opts.store) {
           const r = await api.files(app, {
             stage: opts.stage,

package/src/deploy.ts

@@ -31,11 +31,11 @@ export interface DeployResult {
 }
 
 export async function deploy(api: ApiClient, opts: DeployOptions): Promise<DeployResult> {
-  const project = loadProject(opts.cwd);
+  const project = await loadProject(opts.cwd);
   const stage = deriveStage(opts.stage);
   const app = project.manifest.name;
 
-  const { files } = await buildApp({ cwd: project.root });
+  const { files } = await buildApp({ cwd: project.root, project });
   // The API always issues an upload for manifest.json; `files` lists the optional bundles.
   const fileNames = (Object.keys(files) as ArtifactFile[]).filter((f) => f !== 'manifest.json');
   const git = gitInfo(project.root);

package/src/dev/crons.ts

@@ -2,7 +2,7 @@ import { CronExpressionParser } from 'cron-parser';
 
 /**
  * Local stand-in for EventBridge Scheduler (the emulator creates schedules but
- * never fires them). Same expressions as platform.json: 5-field cron in UTC
+ * never fires them). Same expressions as plat.config.ts: 5-field cron in UTC
  * (or the cron's timezone) or `rate(n unit)`.
  */
 export interface LocalCron {

package/src/dev/index.ts

@@ -35,7 +35,7 @@ export const DEV_CONTROL_PREFIX = '/__plat_dev/';
  *  worker (real Node, tsx watch) ← dispatcher (emulator SQS + EventBridge tap + local crons)
  */
 export async function runDev(opts: DevOptions): Promise<void> {
-  const { root, manifest } = loadProject(opts.cwd);
+  const { root, manifest } = await loadProject(opts.cwd);
   const children: ChildProcess[] = [];
   const cleanups: Array<() => void | Promise<void>> = [];
   let stage: LocalStage | undefined;

package/src/dev/local-stage.ts

@@ -136,7 +136,7 @@ export function emulatorClientConfig(conn: EmulatorConnection) {
 /**
  * `.env.local` (KEY=VALUE, not committed) → SecureString parameters, so
  * `secrets.get()` works locally exactly as deployed. Only names declared in
- * platform.json are loaded.
+ * plat.config.ts are loaded.
  */
 async function seedSecrets(conn: EmulatorConnection, bindings: Bindings, root: string): Promise<void> {
   const values = readDotEnv(join(root, '.env.local'));

package/src/dev/router.ts

@@ -50,7 +50,7 @@ export function localDecision(state: LocalRouterState, uri: string): LocalDecisi
   if (state.webDev) return { kind: 'webdev', target: state.webDev };
   if (state.webDevStarting) return { kind: 'unavailable', reason: 'the frontend dev server is starting' };
   if (!state.staticDir)
-    return { kind: 'unavailable', reason: 'no frontend: set web.static or web.dev in platform.json' };
+    return { kind: 'unavailable', reason: 'no frontend: set web.static or web.dev in plat.config.ts' };
   const prefix = `/${state.record.s ?? ''}`;
   const rel = d.key.startsWith(prefix) ? d.key.slice(prefix.length) : d.key;
   const file = safeJoin(state.staticDir, decodeURIComponent(rel));

package/src/dev/test.ts

@@ -16,7 +16,7 @@ export const INTEGRATION_CONFIG = 'vitest.integration.config.ts';
  * `vitest.integration.config.ts` when present.
  */
 export async function runTests(opts: { cwd: string; args: string[] }): Promise<number> {
-  const { root, manifest } = loadProject(opts.cwd);
+  const { root, manifest } = await loadProject(opts.cwd);
   step('starting the AWS Emulator');
   let stage: Awaited<ReturnType<typeof startLocalStage>>;
   try {

package/src/init.ts

@@ -8,7 +8,7 @@ import {
   writeFileSync,
 } from 'node:fs';
 import { basename, dirname, extname, join, relative, resolve } from 'node:path';
-import { validateAppName } from '@ericminassian/platform-core';
+import { APP_CONFIG_FILE, validateAppName } from '@ericminassian/platform-core';
 import { cliPackageRoot, cliVersion } from './project.ts';
 import { CliError, EXIT } from './util/output.ts';
 
@@ -39,9 +39,9 @@ const TEXT_EXT = new Set([
 /** Published CLI: `template/` inside the package. In this repo: `templates/app`. */
 export function templateDir(): string {
   const packaged = join(cliPackageRoot(), 'template');
-  if (existsSync(join(packaged, 'platform.json'))) return packaged;
+  if (existsSync(join(packaged, APP_CONFIG_FILE))) return packaged;
   const repo = resolve(cliPackageRoot(), '..', '..', 'templates', 'app');
-  if (existsSync(join(repo, 'platform.json'))) return repo;
+  if (existsSync(join(repo, APP_CONFIG_FILE))) return repo;
   throw new CliError('app template not found (broken CLI install?)');
 }
 
@@ -76,9 +76,22 @@ export function initApp(opts: InitOptions): InitResult {
   const files = copyTree(src, dir, (rel, content) =>
     rel === 'package.json' ? rewritePackageJson(content, name, range) : replaceAppName(content, name),
   );
+  writeFileSync(join(dir, 'pnpm-workspace.yaml'), PNPM_WORKSPACE);
+  files.push('pnpm-workspace.yaml');
   return { dir, name, files: files.sort() };
 }
 
+/**
+ * pnpm 10+ refuses to install (ERR_PNPM_IGNORED_BUILDS) until a dependency's
+ * install script is allowed, and esbuild (used by `plat build`) has one. It's
+ * written here rather than shipped in templates/app: a pnpm-workspace.yaml
+ * there would make that folder its own workspace inside this monorepo.
+ */
+export const PNPM_WORKSPACE = `# esbuild (used by \`plat build\`) installs its native binary with a build script.
+allowBuilds:
+  esbuild: true
+`;
+
 export function replaceAppName(content: string, name: string): string {
   return content.split(TEMPLATE_APP_NAME).join(name);
 }