create-basalt 1.15.0 → 1.16.0

package/dist/bin-template.d.ts

@@ -4,6 +4,8 @@ export declare const PROJECT_COMMANDS_MARKER = "['update', 'add', 'doctor', 'inf
 export declare const DEV_PRELUDE_MARKER = "process.loadEnvFile(envFile)";
 /** Marker proving a bin/basalt.ts already runs the generators without booting the app. */
 export declare const GENERATORS_PRELUDE_MARKER = "process.argv[2]?.startsWith('make:')";
+/** Marker proving a bin/basalt.ts already starts `dev` without booting the app. */
+export declare const DEV_SERVER_PRELUDE_MARKER = "if (process.argv[2] === 'dev')";
 export declare function basaltBin(): string;
 /**
  * Hashes of every bin/basalt.ts an earlier create-basalt release generated
@@ -14,6 +16,7 @@ export declare const LEGACY_BIN_HASHES: ReadonlySet<string>;
 export declare const hasProjectCommands: (content: string) => boolean;
 export declare const hasDevPrelude: (content: string) => boolean;
 export declare const hasGeneratorsPrelude: (content: string) => boolean;
+export declare const hasDevServerPrelude: (content: string) => boolean;
 /**
  * Upgrades a template-generated bin/basalt.ts to the current template, step by
  * step: (1) without the project commands, inserts their prelude after the
@@ -21,8 +24,9 @@ export declare const hasGeneratorsPrelude: (content: string) => boolean;
  * longer run before it); (2) without the dev prelude, inserts it right after
  * the project commands and routes the app import through `explainBootFailure`;
  * (3) without the generators prelude, inserts it right before the dev tools
- * are imported for the booted CLI.
- * Deterministic for the known templates — for the latest ones (1.9 to 1.14) the
+ * are imported for the booted CLI; (4) without the dev server prelude, inserts
+ * it at the same place, after the generators prelude.
+ * Deterministic for the known templates — for the latest ones (1.9 to 1.15) the
  * result is exactly {@link basaltBin}.
  */
 export declare function patchBasaltBin(content: string): string;

package/dist/bin-template.js

@@ -197,12 +197,31 @@ if (process.argv[2]?.startsWith('make:')) {
   }
 }
 `;
+/**
+ * The DEV SERVER PRELUDE, after the generators prelude and still before
+ * anything of the app is imported: `basalt dev` must start while the app
+ * cannot boot (a variable missing, the database down, code mid-edit) — that
+ * is when a watcher is needed. `runDev` boots the app only for the route
+ * table, prints why when it does not, and starts the watcher either way.
+ */
+const DEV_SERVER_PRELUDE = `// \`dev\` starts the watcher even while the app cannot boot (database down, a
+// variable missing, code mid-edit): the route table is printed when it boots.
+if (process.argv[2] === 'dev') {
+  const { runDev } = await import('@basaltkit/cli')
+  process.env['NODE_ENV'] ??= 'development'
+  process.exit(await runDev({
+    loadApp: async () => (await import('../src/app.js')).buildApp({ logLevel: 'silent' }),
+  }))
+}
+`;
 /** Marker proving a bin/basalt.ts already delegates the project commands. */
 export const PROJECT_COMMANDS_MARKER = "['update', 'add', 'doctor', 'info'].includes(process.argv[2]";
 /** Marker proving a bin/basalt.ts already has the dev prelude (.env loading, `upgrade`, env errors). */
 export const DEV_PRELUDE_MARKER = 'process.loadEnvFile(envFile)';
 /** Marker proving a bin/basalt.ts already runs the generators without booting the app. */
 export const GENERATORS_PRELUDE_MARKER = "process.argv[2]?.startsWith('make:')";
+/** Marker proving a bin/basalt.ts already starts `dev` without booting the app. */
+export const DEV_SERVER_PRELUDE_MARKER = "if (process.argv[2] === 'dev')";
 const APP_IMPORT = "await import('../src/app.js')";
 const APP_IMPORT_EXPLAINED = `${APP_IMPORT}.catch(explainBootFailure)`;
 const RUN_CLI = 'process.exit(await runCli({ app })';
@@ -211,6 +230,7 @@ export function basaltBin() {
 ${PRELUDE}
 ${DEV_PRELUDE}
 ${GENERATORS_PRELUDE}
+${DEV_SERVER_PRELUDE}
 // The dev tools are imported dynamically, after the project commands above.
 const { runCli } = await import('@basaltkit/cli')
 const { generatorCommands } = await import('@basaltkit/generator')
@@ -259,10 +279,14 @@ export const LEGACY_BIN_HASHES = new Set([
     'sha256-bd0b6c9c40089a18c2c2f1a70953044d6a74a329d38a72903b494b1f2265a114',
     // 2026-10-08: database diagnoses in explainBootFailure — make:* still booted.
     'sha256-abea8cbfdb41a302cabad7929617f7fc2fe822345aa8db6ff777e923eb0fc96b',
+    // 2026-10-25 (create-basalt ≤ 1.15): make:* without a boot — but `dev`
+    // booted the app first, so it did not start while the app could not boot.
+    'sha256-5c2cf3f431399b961de890af457c7be5f9a0cb810cd96d6bdf080ac942e33f1b',
 ]);
 export const hasProjectCommands = (content) => content.includes(PROJECT_COMMANDS_MARKER);
 export const hasDevPrelude = (content) => content.includes(DEV_PRELUDE_MARKER);
 export const hasGeneratorsPrelude = (content) => content.includes(GENERATORS_PRELUDE_MARKER);
+export const hasDevServerPrelude = (content) => content.includes(DEV_SERVER_PRELUDE_MARKER);
 /**
  * Upgrades a template-generated bin/basalt.ts to the current template, step by
  * step: (1) without the project commands, inserts their prelude after the
@@ -270,8 +294,9 @@ export const hasGeneratorsPrelude = (content) => content.includes(GENERATORS_PRE
  * longer run before it); (2) without the dev prelude, inserts it right after
  * the project commands and routes the app import through `explainBootFailure`;
  * (3) without the generators prelude, inserts it right before the dev tools
- * are imported for the booted CLI.
- * Deterministic for the known templates — for the latest ones (1.9 to 1.14) the
+ * are imported for the booted CLI; (4) without the dev server prelude, inserts
+ * it at the same place, after the generators prelude.
+ * Deterministic for the known templates — for the latest ones (1.9 to 1.15) the
  * result is exactly {@link basaltBin}.
  */
 export function patchBasaltBin(content) {
@@ -282,6 +307,8 @@ export function patchBasaltBin(content) {
         text = addDevPrelude(text);
     if (!hasGeneratorsPrelude(text))
         text = addGeneratorsPrelude(text);
+    if (!hasDevServerPrelude(text))
+        text = addDevServerPrelude(text);
     return text;
 }
 function addProjectCommands(content) {
@@ -317,11 +344,19 @@ function addGeneratorsPrelude(content) {
         return content;
     return `${content.slice(0, anchor.index)}${GENERATORS_PRELUDE}\n${content.slice(anchor.index)}`;
 }
+/** Inserts the dev server prelude right before the dev tools are imported for the booted CLI (after the generators prelude). */
+function addDevServerPrelude(content) {
+    const anchor = /^(?:\/\/ The dev tools are imported dynamically[^\n]*\n)?const \{ runCli \} = await import\('@basaltkit\/cli'\)$/m.exec(content);
+    // Without the template's dynamic CLI import, the file is not ours to rearrange.
+    if (!anchor || !hasGeneratorsPrelude(content))
+        return content;
+    return `${content.slice(0, anchor.index)}${DEV_SERVER_PRELUDE}\n${content.slice(anchor.index)}`;
+}
 /** Where a bin/basalt.ts stands: already current, an untouched old template, or user code. */
 export function binStatus(content, manifestHash) {
     if (content === undefined)
         return 'absent';
-    if (hasProjectCommands(content) && hasDevPrelude(content) && hasGeneratorsPrelude(content))
+    if (hasProjectCommands(content) && hasDevPrelude(content) && hasGeneratorsPrelude(content) && hasDevServerPrelude(content))
         return 'current';
     const hash = hashContent(content);
     return LEGACY_BIN_HASHES.has(hash) || hash === manifestHash ? 'patchable' : 'modified';
@@ -351,6 +386,13 @@ booted CLI) — it runs the make:* generators without booting the app, so they
 work before the database is up or migrated:
 
 ${GENERATORS_PRELUDE}`);
+    }
+    if (!hasDevServerPrelude(content)) {
+        steps.push(`${steps.length > 0 ? 'Then paste' : 'Paste'} this after the generators prelude (before the dev tools are imported for
+the booted CLI) — \`basalt dev\` then starts its watcher even while the app cannot
+boot (database down, a variable missing):
+
+${DEV_SERVER_PRELUDE}`);
     }
     return steps.join('\n');
 }

package/dist/project/doctor.js

@@ -382,7 +382,7 @@ export async function runDoctor(ctx, options = {}) {
     const bin = await readText(join(dir, 'bin', 'basalt.ts'));
     const status = binStatus(bin, ctx.manifest?.files['bin/basalt.ts']);
     if (status === 'patchable') {
-        push('warn', 'tooling', 'bin/basalt.ts is an older template (it lacks some of: .env loading, pre-boot project commands, make:* without booting the app) — `npx create-basalt@latest update` patches it.');
+        push('warn', 'tooling', 'bin/basalt.ts is an older template (it lacks some of: .env loading, pre-boot project commands, make:* and dev without booting the app) — `npx create-basalt@latest update` patches it.');
     }
     if (status === 'modified') {
         push('info', 'tooling', 'bin/basalt.ts is customised and lacks the current preludes (project commands, .env loading, pre-boot `upgrade` and make:*) — see `create-basalt update` for the snippet.');

package/dist/project/update.js

@@ -1,6 +1,6 @@
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { binStatus, hasDevPrelude, hasProjectCommands, manualBinSnippet, patchBasaltBin } from '../bin-template.js';
+import { binStatus, hasDevPrelude, hasGeneratorsPrelude, hasProjectCommands, manualBinSnippet, patchBasaltBin } from '../bin-template.js';
 import { devEntryStatus, MANUAL_DEV_SNIPPET, patchDevEntry, patchEnvExample } from '../dev-entry.js';
 import { alwaysLatest, lookupLatestVersions, minimumReleaseAgeMinutes, } from '../latest-versions.js';
 import { BASALT_PROJECT_SCRIPT } from '../templates.js';
@@ -207,7 +207,7 @@ export async function planUpdate(ctx, options = {}) {
             const after = patchBasaltBin(bin);
             files['bin/basalt.ts'] = { before: bin, after };
             patched['bin/basalt.ts'] = after;
-            toolingNotes.push(`bin/basalt.ts: unmodified template from an earlier release — ${hasProjectCommands(bin) ? '' : 'gains update/add/doctor/info; '}${hasDevPrelude(bin) ? '' : 'loads .env for development, runs \`upgrade\` without booting the app, explains env errors; '}runs make:* without booting the app (no database needed to generate code)`);
+            toolingNotes.push(`bin/basalt.ts: unmodified template from an earlier release — ${hasProjectCommands(bin) ? '' : 'gains update/add/doctor/info; '}${hasDevPrelude(bin) ? '' : 'loads .env for development, runs \`upgrade\` without booting the app, explains env errors; '}${hasGeneratorsPrelude(bin) ? '' : 'runs make:* without booting the app (no database needed to generate code); '}starts \`basalt dev\` even while the app cannot boot (the route table when it does)`);
         }
         else if (status === 'modified' && bin !== undefined) {
             manual.push(`bin/basalt.ts was customised, so it was not patched. To bring it up to date:\n${manualBinSnippet(bin)}`);

package/dist/versions.js

@@ -8,10 +8,10 @@ export const SCAFFOLD_VERSIONS = {
     '@basaltkit/ai-mcp': '^0.4.0',
     '@basaltkit/auth': '^5.0.0',
     '@basaltkit/auth-prisma': '^3.0.0',
-    '@basaltkit/cli': '^1.4.2',
+    '@basaltkit/cli': '^1.6.0',
     '@basaltkit/config': '^1.1.2',
     '@basaltkit/core': '^1.6.0',
-    '@basaltkit/deploy': '^0.10.0',
+    '@basaltkit/deploy': '^0.10.1',
     '@basaltkit/env': '^3.1.1',
     '@basaltkit/events': '^1.3.0',
     '@basaltkit/fastify': '^3.0.0',
@@ -28,5 +28,5 @@ export const SCAFFOLD_VERSIONS = {
     '@basaltkit/tenancy': '^4.0.0',
     '@basaltkit/tenancy-prisma': '^3.0.0',
     '@basaltkit/testing': '^3.0.0',
-    'create-basalt': '^1.15.0',
+    'create-basalt': '^1.16.0',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-basalt",
-  "version": "1.15.0",
+  "version": "1.16.0",
   "engines": {
     "node": ">=22.5.0"
   },
@@ -32,27 +32,27 @@
     "typescript": "^7.0.2",
     "vitest": "^5.0.5",
     "zod": "^4.6.7",
-    "@basaltkit/auth": "^5.0.0",
     "@basaltkit/auth-prisma": "^3.0.0",
-    "@basaltkit/cli": "^1.4.2",
     "@basaltkit/config": "^1.1.2",
+    "@basaltkit/auth": "^5.0.0",
     "@basaltkit/core": "^1.6.0",
-    "@basaltkit/events": "^1.3.0",
+    "@basaltkit/cli": "^1.6.0",
+    "@basaltkit/deploy": "^0.10.1",
     "@basaltkit/env": "^3.1.1",
-    "@basaltkit/deploy": "^0.10.0",
     "@basaltkit/fastify": "^3.0.0",
-    "@basaltkit/prisma": "^4.1.1",
+    "@basaltkit/events": "^1.3.0",
     "@basaltkit/logger": "^1.3.0",
-    "@basaltkit/generator": "^1.7.0",
-    "@basaltkit/subscriptions": "^6.0.0",
     "@basaltkit/mcp": "^6.0.0",
+    "@basaltkit/subscriptions": "^6.0.0",
     "@basaltkit/subscriptions-prisma": "^4.0.0",
+    "@basaltkit/teams": "^4.1.1",
+    "@basaltkit/prisma": "^4.1.1",
     "@basaltkit/teams-prisma": "^1.1.0",
     "@basaltkit/tenancy": "^4.0.0",
     "@basaltkit/tenancy-prisma": "^3.0.0",
-    "@basaltkit/tsconfig": "^0.24.0",
+    "@basaltkit/generator": "^1.7.0",
     "@basaltkit/testing": "^3.0.0",
-    "@basaltkit/teams": "^4.1.1"
+    "@basaltkit/tsconfig": "^0.24.0"
   },
   "publishConfig": {
     "access": "public"