@timekast/factory 1.21.0 → 1.22.0

package/dist/lib/constants.js

@@ -200,6 +200,26 @@ export const E2E_UI_SCRIPT_CMD = `tsx ${E2E_DIRECT_SCRIPT_FILE} --ui`;
 export const GENERATE_REFERENCE_NAME = 'generate:reference';
 export const GENERATE_REFERENCE_CMD = 'tsx scripts/tools/generate-inventory.ts && tsx scripts/tools/generate-codebase.ts && tsx scripts/tools/generate-hooks.ts && tsx scripts/tools/generate-schema.ts && tsx scripts/tools/generate-api.ts';
 export const GENERATE_REFERENCE_GATE_FILE = 'scripts/tools/generate-schema.ts';
+/**
+ * The dev server's heap ceiling, carried inside the `dev:next` script the launcher shells
+ * (`scripts/tools/dev.mjs` → `pnpm dev:next`).
+ *
+ * WHY THE CLI OWNS IT. This value lives in `package.json`, which is frozen at bootstrap in a
+ * derivative (BR-FACTORY-006) and is NOT part of the tracked file set — so `factory update`
+ * swapping `.claude/` + `scripts/` can never reach it. The CLI is the only thing that can,
+ * exactly as it does for `agentKitVersion` and the retired e2e port. Without an entry here,
+ * every existing derivative would keep the old ceiling forever while new ones are born with
+ * the current one.
+ *
+ * FILE-GATED on the launcher, like `GENERATOR_SCRIPTS`: a `core`/non-Next derivative has no
+ * `dev.mjs` and never receives an alias for a dev server it does not run.
+ */
+export const DEV_NEXT_SCRIPT_NAME = 'dev:next';
+export const DEV_NEXT_GATE_FILE = 'scripts/tools/dev.mjs';
+export const DEV_NEXT_HEAP_MB = 4096;
+export const DEV_NEXT_SCRIPT_CMD = `NODE_OPTIONS='--max-old-space-size=${DEV_NEXT_HEAP_MB}' next dev --turbopack`;
+/** The ceiling(s) the kit shipped before — the ONLY values healing is allowed to overwrite. */
+export const DEV_NEXT_OBSOLETE_HEAPS_MB = [2048];
 /**
  * The `ports` block of a derivative's `package.json`, and the one key inside it the CLI
  * maintains.
@@ -244,4 +264,8 @@ export const OBSOLETE_SCRIPT_CMDS = {
     // dev can act on. A derivative that pointed either alias somewhere of its own keeps it.
     [E2E_DIRECT_SCRIPT_NAME]: ['playwright test'],
     [E2E_UI_SCRIPT_NAME]: ['playwright test --ui'],
+    // Every heap ceiling the kit shipped for the dev server before the current one. Listed as
+    // whole COMMANDS (not just the number) so healing stays exact-match: a derivative that
+    // appended a flag of its own, or picked a ceiling the kit never shipped, is left alone.
+    [DEV_NEXT_SCRIPT_NAME]: DEV_NEXT_OBSOLETE_HEAPS_MB.map((mb) => `NODE_OPTIONS='--max-old-space-size=${mb}' next dev --turbopack`),
 };

package/dist/lib/neon-api.js

@@ -28,6 +28,28 @@ const NEON_API_TIMEOUT_MS = 30_000;
 export const NEON_MAIN_BRANCH = 'main';
 /** Name of the isolated, data-clean second branch this step creates. */
 export const NEON_DEVELOP_BRANCH = 'develop';
+/**
+ * Autoscaling bounds every compute this CLI creates is born with.
+ *
+ * We declare them EXPLICITLY instead of inheriting Neon's account default, which
+ * is not stable over time: projects provisioned in earlier eras were born at a
+ * fixed `1-1 CU` (min == max), which bills a full CU for every hour the compute
+ * is merely awake — 4x the floor below — and today's default is `0.25-8`, whose
+ * ceiling is 32x the floor. Neither is a deliberate choice for a fresh derivative.
+ *
+ * The floor is what an idle-but-awake compute bills, so it is the single biggest
+ * lever on the fleet's Neon bill; 0.25 CU is Neon's minimum. The ceiling is pure
+ * headroom (it costs nothing until traffic actually needs it), so 2 CU gives a
+ * new project 8x of burst room while keeping a runaway query from silently
+ * scaling to 8 CU. A project that outgrows it raises the ceiling deliberately.
+ */
+export const NEON_AUTOSCALING_MIN_CU = 0.25;
+export const NEON_AUTOSCALING_MAX_CU = 2;
+/** The autoscaling pair as the Neon REST API spells it — shared by both writes. */
+const NEON_AUTOSCALING_SETTINGS = {
+    autoscaling_limit_min_cu: NEON_AUTOSCALING_MIN_CU,
+    autoscaling_limit_max_cu: NEON_AUTOSCALING_MAX_CU,
+};
 /**
  * Neon returns 423 (Locked) while a freshly-created project runs its post-create
  * operations ("project already has running conflicting operations"). The develop
@@ -93,6 +115,10 @@ export async function createNeonProject(apiKey, projectName, orgId, deps = {}) {
                 ...(orgId ? { org_id: orgId } : {}),
                 // Name the auto-created primary branch `main` so production reads cleanly.
                 branch: { name: NEON_MAIN_BRANCH },
+                // Bind the autoscaling bounds at the PROJECT level so the primary compute
+                // AND every branch created later (by us or by hand in the console) inherit
+                // them — otherwise a new branch silently re-adopts Neon's account default.
+                default_endpoint_settings: { ...NEON_AUTOSCALING_SETTINGS },
             },
         }),
         signal: AbortSignal.timeout(NEON_API_TIMEOUT_MS),
@@ -129,7 +155,10 @@ export async function createDevelopBranch(apiKey, projectId, parentBranchId, dep
         headers: neonHeaders(apiKey),
         body: JSON.stringify({
             branch: { name: NEON_DEVELOP_BRANCH, parent_id: parentBranchId },
-            endpoints: [{ type: 'read_write' }],
+            // Stated explicitly rather than left to project inheritance: this branch is
+            // created in the same run as the project, and a bare `{type}` endpoint is
+            // exactly how the fleet ended up with computes nobody chose the size of.
+            endpoints: [{ type: 'read_write', ...NEON_AUTOSCALING_SETTINGS }],
         }),
         signal: AbortSignal.timeout(NEON_API_TIMEOUT_MS),
     });

package/dist/lib/package-json.js

@@ -8,7 +8,7 @@
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import path from 'node:path';
 import { CLIError } from './cli-error.js';
-import { E2E_DIRECT_SCRIPT_CMD, E2E_DIRECT_SCRIPT_FILE, E2E_DIRECT_SCRIPT_NAME, E2E_UI_SCRIPT_CMD, E2E_UI_SCRIPT_NAME, FACTORY_SCRIPTS, GENERATE_REFERENCE_CMD, GENERATE_REFERENCE_GATE_FILE, GENERATE_REFERENCE_NAME, GENERATOR_SCRIPTS, INVITE_ADMIN_SCRIPT_CMD, INVITE_ADMIN_SCRIPT_FILE, INVITE_ADMIN_SCRIPT_NAME, OBSOLETE_SCRIPT_CMDS, PORTS_E2E_COMMENT, PORTS_E2E_COMMENT_KEY, PORTS_E2E_KEY, PORTS_KEY, PREFLIGHT_SCRIPT_CMD, PREFLIGHT_SCRIPT_FILE, PREFLIGHT_SCRIPT_NAME, PROFILES, SHIPPED_E2E_PORT, UPDATE_SCRIPT_NAME, } from './constants.js';
+import { DEV_NEXT_GATE_FILE, DEV_NEXT_SCRIPT_CMD, DEV_NEXT_SCRIPT_NAME, E2E_DIRECT_SCRIPT_CMD, E2E_DIRECT_SCRIPT_FILE, E2E_DIRECT_SCRIPT_NAME, E2E_UI_SCRIPT_CMD, E2E_UI_SCRIPT_NAME, FACTORY_SCRIPTS, GENERATE_REFERENCE_CMD, GENERATE_REFERENCE_GATE_FILE, GENERATE_REFERENCE_NAME, GENERATOR_SCRIPTS, INVITE_ADMIN_SCRIPT_CMD, INVITE_ADMIN_SCRIPT_FILE, INVITE_ADMIN_SCRIPT_NAME, OBSOLETE_SCRIPT_CMDS, PORTS_E2E_COMMENT, PORTS_E2E_COMMENT_KEY, PORTS_E2E_KEY, PORTS_KEY, PREFLIGHT_SCRIPT_CMD, PREFLIGHT_SCRIPT_FILE, PREFLIGHT_SCRIPT_NAME, PROFILES, SHIPPED_E2E_PORT, UPDATE_SCRIPT_NAME, } from './constants.js';
 /**
  * Auto-detect the profile to install into an existing repo from its
  * `package.json`: a `factoryVersion` field means the repo was born from the
@@ -113,6 +113,8 @@ function ensureFactoryScripts(pkg, extraScripts = {}) {
  * - `test:e2e:direct` / `test:e2e:ui` — the two raw-Playwright debugging entry
  *   points, routed through the wrapper that arms the compile-guard stub. Both
  *   gate on that one wrapper file.
+ * - `dev:next` — the dev server the launcher shells, whose heap ceiling the kit
+ *   owns. Gated on the launcher (`dev.mjs`), which is what invokes it.
  *
  * Insert-if-missing for all: a dev's own value for any of these is never
  * overwritten (see `ensureFactoryScripts`).
@@ -134,6 +136,8 @@ export function kitLocalScripts(rootDir) {
         scripts[E2E_DIRECT_SCRIPT_NAME] = E2E_DIRECT_SCRIPT_CMD;
         scripts[E2E_UI_SCRIPT_NAME] = E2E_UI_SCRIPT_CMD;
     }
+    if (has(DEV_NEXT_GATE_FILE))
+        scripts[DEV_NEXT_SCRIPT_NAME] = DEV_NEXT_SCRIPT_CMD;
     return scripts;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@timekast/factory",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Public, thin CLI to bootstrap and maintain TimeKast Factory derived projects.",
   "type": "module",
   "license": "UNLICENSED",