sproutboat 0.54.0 → 0.55.0

package/src/main.ts

@@ -1,6 +1,7 @@
 #!/usr/bin/env bun
-import { mkdir, open, readFile, rename, writeFile } from "node:fs/promises";
+import { mkdir, open, readFile, rename, stat, writeFile } from "node:fs/promises";
 import { existsSync, rmSync } from "node:fs";
+import { isIP } from "node:net";
 import { basename, dirname, relative, resolve } from "node:path";
 import { tmpdir } from "node:os";
 import { isBoolean, isSafeInteger, isString, jsonObject, parseJsonValue, type JsonObject } from "./json";
@@ -8,7 +9,8 @@ import type { AssetFiles } from "./assets";
 import { pinBindingId, resourceRefs, type SproutboatConfig } from "./config";
 import { validateHttpSyncSource } from "./source";
 import { buildArtifact, emitGenerated } from "./build";
-import { generateTypes, TYPES_FILE } from "./types-gen";
+import { LEGACY_TYPES_FILE, TYPES_FILE } from "./types-gen";
+import { checkTypes, parseTypesArgs, planTypes, refreshTypes, removeLegacyTypes, TYPES_USAGE } from "./types-cmd";
 import { bundleHandler, BundleError, type BundleResult } from "./bundle";
 import { runDev } from "./dev";
 import { buildStandalone, emitStandalone, isReleaseBuild } from "./standalone-build";
@@ -29,7 +31,13 @@ import {
 import { extractGlobalFlags, globalFlags, locateProject, setGlobalFlags } from "./global-flags";
 import { checkOptions, ENDPOINT_COMMANDS } from "./options";
 import { chooseTarget, TargetError, type Target } from "./target";
-import { configAccount, configMigrationsDir, parseProjectConfig } from "./account-field";
+import {
+  ASSETS_ONLY_MAIN,
+  assetsOnlySource,
+  configAccount,
+  configMigrationsDir,
+  parseProjectConfig,
+} from "./account-field";
 import { DATA_ERROR_STATUSES } from "./data-errors";
 import {
   cloudLogout,
@@ -58,6 +66,12 @@ import {
   tailBuild,
   waitForApply,
 } from "./cloud-deploy";
+import {
+  checkDurableObjectExports,
+  describeCloudBindings,
+  mapCloudBindings,
+  type CloudBindings,
+} from "./cloud-bindings";
 import {
   APPLY_USAGE,
   applyMigrations,
@@ -84,6 +98,7 @@ import {
   putCloudSecret,
   readSecretsFile,
 } from "./cloud-secrets";
+import { cloudDomainsUnsupported, describeCloudRoutes, listCloudRoutes } from "./cloud-domains";
 import { parseBulkSecrets, type BulkPlan } from "./secrets-bulk";
 import {
   cloudTarget,
@@ -129,7 +144,7 @@ import {
 import { notifyIfOutdated } from "./update-check";
 import { controlVersionWarning } from "./api-version";
 import { amber, bold, dim, leaf, ok, rose } from "./style";
-import { detectPackageManager, installCommand, planPackageJson, runScriptCommand } from "./init-package";
+import { InitError, parseInitArgs, runInit, terminalInitIo } from "./init";
 import { pathToFileURL } from "node:url";
 import { constants as osConstants } from "node:os";
 import { inspectToolchain } from "./toolchain";
@@ -310,28 +325,6 @@ function parseToken(source: string): string | undefined {
   return record && isString(record.token) ? record.token : undefined;
 }
 
-const starterConfig = (name: string) => `{
-  "$schema": "https://sproutboat.com/schema.json",
-  "name": "${name}",
-  "main": "src/index.js",
-  "compatibility_date": "2026-09-28"
-}
-`;
-const starterHandler = `export default {
-  fetch(request, env, ctx) {
-    return new Response("hello from Sproutboat");
-  }
-};
-`;
-// .sproutboat/ holds build output (dist/) and `dev`'s local broker state
-// (dev/, including its SQLite files) — neither belongs in version control.
-// .dev.vars carries secret values for `sproutboat dev`, same convention as
-// Wrangler's file of the same name.
-const starterGitignore = `.sproutboat/
-.dev.vars
-node_modules/
-`;
-
 /** An operational failure — the command was invoked correctly but could not complete. Exit 1. */
 function fail(message: string): never {
   console.error(`${rose("✗")} ${message}`);
@@ -383,10 +376,20 @@ async function readProjectConfig(directory?: string) {
   };
 }
 
+/** What to call the entry in messages: its path, or "assets only" when the project has no `main`. */
+const entryLabel = (config: { main: string }) => (config.main === ASSETS_ONLY_MAIN ? "assets only" : config.main);
+
 /** Full build input: configuration plus entry point, resolved imports and checks. */
 async function readProject(directory?: string) {
   const project = await readProjectConfig(directory);
-  const sourcePath = resolve(project.directory, project.config.main);
+  let sourcePath = resolve(project.directory, project.config.main);
+  if (project.config.main === ASSETS_ONLY_MAIN) {
+    // A Worker with only static assets: there is no entry file, so the small one that hands every miss to the assets is written
+    // into .sproutboat/ (the local state folder) and bundled like any other.
+    sourcePath = resolve(project.directory, ".sproutboat", "assets-only.js");
+    await mkdir(dirname(sourcePath), { recursive: true });
+    await writeFile(sourcePath, assetsOnlySource(project.config.assets?.binding ?? "ASSETS"));
+  }
   let source: string;
   try {
     source = await readFile(sourcePath, "utf8");
@@ -409,97 +412,57 @@ async function readProject(directory?: string) {
   return { ...project, sourcePath, source, bundle };
 }
 
-async function init(name = "hello") {
-  if (!/^[a-z0-9](?:[a-z0-9-]{1,30}[a-z0-9])?$/.test(name))
-    fail("project name must be a 3–32 character lowercase slug");
-  const directory = resolve(process.cwd(), name);
-  const configPath = resolve(directory, "sproutboat.jsonc");
-  const handlerPath = resolve(directory, "src/index.js");
-  // Check both targets before writing either — `name` can collide with an
-  // unrelated existing directory, and a second `wx` write failing partway
-  // through used to crash with a raw EEXIST stack trace after already having
-  // created sproutboat.jsonc, leaving a half-scaffolded project behind.
-  for (const [path, label] of [
-    [configPath, "sproutboat.jsonc"],
-    [handlerPath, "src/index.js"],
-  ] as const) {
-    if (await Bun.file(path).exists()) fail(`${basename(directory)} already contains ${label}`);
-  }
-  // Plan package.json before writing anything, so an unreadable one stops init
-  // instead of leaving a half-scaffolded project.
-  const packagePath = resolve(directory, "package.json");
-  let existingPackage: string | undefined;
-  try {
-    existingPackage = await readFile(packagePath, "utf8");
-  } catch {
-    existingPackage = undefined;
-  }
-  let packagePlan: ReturnType<typeof planPackageJson>;
+async function init(args: string[]) {
+  const parsed = parseInitArgs(args);
+  if ("error" in parsed) usageError(parsed.error, usageOf("init"));
   try {
-    packagePlan = planPackageJson(name, existingPackage, CLI_VERSION);
+    await runInit(parsed, terminalInitIo(CLI_VERSION));
   } catch (cause) {
-    fail(`${basename(directory)}: ${cause instanceof Error ? cause.message : String(cause)}`);
-  }
-  await mkdir(resolve(directory, "src"), { recursive: true });
-  await writeFile(configPath, starterConfig(name), { flag: "wx" });
-  await writeFile(handlerPath, starterHandler, { flag: "wx" });
-  console.log(`Created ${basename(directory)}/sproutboat.jsonc`);
-  console.log(`Created ${basename(directory)}/src/index.js`);
-  // Unlike the two files above, an existing .gitignore here is not a sign this
-  // isn't a fresh project (`name` can collide with an unrelated directory) —
-  // leave it alone rather than failing init or clobbering it.
-  const gitignorePath = resolve(directory, ".gitignore");
-  if (!(await Bun.file(gitignorePath).exists())) {
-    await writeFile(gitignorePath, starterGitignore, { flag: "wx" });
-    console.log(`Created ${basename(directory)}/.gitignore`);
-  }
-  if (packagePlan.created || packagePlan.addedDependency || packagePlan.addedScripts.length > 0) {
-    await writeFile(packagePath, packagePlan.text);
-    console.log(`${packagePlan.created ? "Created" : "Updated"} ${basename(directory)}/package.json`);
-  }
-  for (const script of packagePlan.skippedScripts)
-    console.log(
-      amber(
-        `  ! package.json already has a "${script}" script; left it as is (sproutboat's would be "sproutboat ${script}")`,
-      ),
-    );
-  const manager = detectPackageManager(directory);
-  console.log(`\nNext: cd ${basename(directory)} && ${installCommand(manager)} && ${runScriptCommand(manager, "dev")}`);
-  console.log(dim(`After "sproutboat login", ship it with ${runScriptCommand(manager, "deploy")}.`));
+    if (cause instanceof InitError) fail(cause.message);
+    throw cause;
+  }
 }
 
 async function check(directory?: string) {
   const project = await readProject(directory);
-  console.log(ok(`check passed — ${project.config.name} (${project.config.main}, native-fetch)`));
+  console.log(ok(`check passed — ${project.config.name} (${entryLabel(project.config)}, native-fetch)`));
 }
 
-async function types(directory?: string) {
-  const project = await readProject(directory);
-  const path = resolve(project.directory, TYPES_FILE);
-  await writeFile(path, generateTypes(project.config));
-  console.log(ok(`wrote ${relative(process.cwd(), path) || TYPES_FILE}`));
-  console.log(dim("  Commit it. Add it to tsconfig `include` if your project has one."));
+async function types(args: string[]) {
+  const parsed = parseTypesArgs(args);
+  if ("error" in parsed) usageError(parsed.error, TYPES_USAGE);
+  // A positional that is a directory is the project directory, as it was before the positional became the output file.
+  const project = await readProjectConfig(
+    parsed.positional !== undefined && existsSync(parsed.positional) && (await stat(parsed.positional)).isDirectory()
+      ? parsed.positional
+      : undefined,
+  );
+  const plan = await planTypes(parsed, project.config, project.directory);
+  const shown = relative(process.cwd(), plan.path) || TYPES_FILE;
+  if (parsed.check) {
+    const state = await checkTypes(plan);
+    if (state === "current") {
+      console.log(ok(`types at ${shown} are up to date`));
+      return;
+    }
+    console.error(
+      `${rose("✗")} ${state === "missing" ? `${shown} does not exist` : `${shown} is out of date`}. Run \`sproutboat types\` to write it.`,
+    );
+    process.exit(1);
+  }
+  await mkdir(dirname(plan.path), { recursive: true });
+  await writeFile(plan.path, plan.text);
+  console.log(ok(`wrote ${shown}`));
+  if (await removeLegacyTypes(project.directory))
+    console.log(dim(`  removed ${LEGACY_TYPES_FILE}, which this file replaces`));
+  console.log(dim('  Commit it, and add it to the "include" of your tsconfig. Rerun after changing sproutboat.jsonc.'));
 }
 
-/**
- * Rewrite the generated types when the config has moved on, and only then.
- *
- * Called from `dev` and `deploy` so a binding added to sproutboat.jsonc cannot
- * sit unreflected in the editor. It writes only when the content actually
- * differs, which keeps it out of the way of git and of file watchers.
- */
-async function refreshTypes(projectDir: string, config: SproutboatConfig): Promise<void> {
-  const path = resolve(projectDir, TYPES_FILE);
-  const wanted = generateTypes(config);
-  try {
-    if ((await readFile(path, "utf8")) === wanted) return;
-  } catch {
-    // No file yet: only write one if the project already opted in by having a
-    // tsconfig. Generating into a plain JavaScript project is noise.
-    if (!(await Bun.file(resolve(projectDir, "tsconfig.json")).exists())) return;
-  }
-  await writeFile(path, wanted);
-  console.log(dim(`  ${TYPES_FILE} refreshed from sproutboat.jsonc`));
+/** `dev` and `deploy`: keep the default generated types current (types-cmd.ts says when it does and does not). */
+async function refreshProjectTypes(projectDir: string, config: SproutboatConfig): Promise<void> {
+  const { wrote, removedLegacy } = await refreshTypes(projectDir, config);
+  if (wrote) console.log(dim(`  ${TYPES_FILE} refreshed from sproutboat.jsonc`));
+  if (removedLegacy) console.log(dim(`  removed ${LEGACY_TYPES_FILE}, which it replaces`));
 }
 
 async function build(directory?: string, target: BuildTarget = "linux-x86_64") {
@@ -616,11 +579,13 @@ async function emitStandaloneUnit(directory: string | undefined): Promise<string
 }
 
 /** #62 — build for this machine, run it against a real broker, rebuild on save. */
-const DEV_USAGE = "dev [project-dir] [--port <n>] [--no-watch] [-e, --env <name>] [--env-file <file>]...";
+const DEV_USAGE =
+  "dev [project-dir] [--port <n>] [--ip <address>] [--no-watch] [-e, --env <name>] [--env-file <file>]...";
 
 async function dev(args: string[]) {
   let directory: string | undefined;
   let portArg: string | undefined;
+  let host: string | undefined;
   // --env and --env-file are global flags, already taken out of `args` (global-flags.ts).
   const envName = globalFlags().env;
   const envFiles = globalFlags().envFiles.map((file) => resolve(file));
@@ -632,15 +597,22 @@ async function dev(args: string[]) {
       if (value === undefined || value.startsWith("--")) usageError(`${arg} needs a value`, DEV_USAGE);
       at += 1;
       portArg = value;
+    } else if (arg === "--ip") {
+      const value = args[at + 1];
+      if (value === undefined || value.startsWith("--")) usageError(`${arg} needs a value`, DEV_USAGE);
+      at += 1;
+      host = value;
     } else if (!arg.startsWith("--") && directory === undefined) directory = arg;
   }
   const port = Number(portArg ?? 8787);
   if (!Number.isSafeInteger(port) || port < 1 || port > 65_535) usageError(`invalid --port: ${portArg}`, DEV_USAGE);
+  if (host !== undefined && !isIP(host) && host !== "localhost")
+    usageError(`invalid --ip: ${host} (an IPv4 or IPv6 address, or localhost)`, DEV_USAGE);
   if (envName !== undefined && !/^[A-Za-z0-9_-]+$/.test(envName))
     usageError("--env takes a name (letters, digits, - and _)", DEV_USAGE);
   for (const file of envFiles) if (!existsSync(file)) fail(`env file not found: ${file}`);
   const project = await readProject(directory);
-  await refreshTypes(project.directory, project.config);
+  await refreshProjectTypes(project.directory, project.config);
   console.log(dim(`Building ${project.config.name} for this machine (${hostTarget()})…`));
   await runDev({
     projectDir: project.directory,
@@ -648,6 +620,7 @@ async function dev(args: string[]) {
     sourcePath: project.sourcePath,
     source: project.bundle.code,
     port,
+    host,
     envFiles,
     envName,
     watch: !args.includes("--no-watch"),
@@ -655,7 +628,7 @@ async function dev(args: string[]) {
     // files changed, so the bundle captured at startup is stale by definition.
     rebuild: async () => {
       const next = await readProject(directory);
-      await refreshTypes(next.directory, next.config);
+      await refreshProjectTypes(next.directory, next.config);
       return { config: next.config, sourcePath: next.sourcePath, source: next.bundle.code };
     },
   });
@@ -890,7 +863,7 @@ async function deploy(args: string[]) {
     artifactDir = built.artifact.artifactDir;
     config = built.project.config;
     // After provisioning: ids may have been pinned into the config just now.
-    await refreshTypes(built.project.directory, built.project.config);
+    await refreshProjectTypes(built.project.directory, built.project.config);
   }
   const manifest = Bun.file(resolve(artifactDir, "manifest.json"));
   const sprout = Bun.file(resolve(artifactDir, "sprout"));
@@ -1247,25 +1220,14 @@ async function deployCloud(args: string[], apiUrl: string, flags: ReturnType<typ
   const hosts = [hostFor(name, team)];
 
   const cfg = project.config;
-  const unsent = Object.entries({
-    kv_namespaces: cfg.kv_namespaces?.length,
-    d1_databases: cfg.d1_databases?.length,
-    r2_buckets: cfg.r2_buckets?.length,
-    queues: cfg.queues?.length,
-    analytics_engine_datasets: cfg.analytics_engine_datasets?.length,
-    durable_objects: Object.keys(cfg.durable_objects ?? {}).length,
-    ratelimiters: cfg.ratelimiters?.length,
-    "triggers.crons": cfg.triggers?.crons?.length,
-  })
-    .filter(([, count]) => (count ?? 0) > 0)
-    .map(([key]) => key);
-  if (unsent.length > 0)
-    io.warn(
-      `! ${unsent.join(", ")} in sproutboat.jsonc are not sent to the Cloud by the CLI yet; the app runs without them`,
-    );
-
   const services = cfg.services ?? [];
   guardSync(() => checkServiceBindings(name, services, cfg.compatibility_date));
+  let cloudBindings!: CloudBindings;
+  guardSync(() => {
+    cloudBindings = mapCloudBindings(cfg, services.length);
+    checkDurableObjectExports(cfg, project.directory);
+  });
+  for (const warning of cloudBindings.warnings) io.warn(`! ${warning}`);
   let secretValues: Record<string, string> | undefined;
   const secretsFile = flags["--secrets-file"];
   if (secretsFile !== undefined) {
@@ -1299,6 +1261,7 @@ async function deployCloud(args: string[], apiUrl: string, flags: ReturnType<typ
   console.log(`endpoint  ${apiUrl}`);
   console.log(`route     https://${hosts[0]}`);
   if (assets) console.log(`assets    ${assets.files} files`);
+  for (const line of describeCloudBindings(cloudBindings)) console.log(`binding   ${line}`);
   if (services.length > 0)
     console.log(`services  ${services.map((entry) => `${entry.binding} -> ${entry.service}`).join(", ")}`);
   if (secretValues) console.log(`secrets   ${Object.keys(secretValues).length} from ${secretsFile} (set, others kept)`);
@@ -1336,7 +1299,7 @@ async function deployCloud(args: string[], apiUrl: string, flags: ReturnType<typ
   };
   if (fromSource) {
     const sourcePath = await emitStandaloneUnit(directory);
-    console.log(`  Bundling   ${cfg.main} (${formatKiB(Bun.file(sourcePath).size)})`);
+    console.log(`  Bundling   ${entryLabel(cfg)} (${formatKiB(Bun.file(sourcePath).size)})`);
     const controller = new AbortController();
     const interrupt = () => controller.abort();
     process.once("SIGINT", interrupt);
@@ -1348,6 +1311,7 @@ async function deployCloud(args: string[], apiUrl: string, flags: ReturnType<typ
           tokenFromEnv,
           project: name,
           services,
+          cloudBindings,
           compatibilityDate: cfg.compatibility_date,
           secrets: secretValues,
           hosts,
@@ -1383,6 +1347,7 @@ async function deployCloud(args: string[], apiUrl: string, flags: ReturnType<typ
         assets,
         noWait,
         services,
+        cloudBindings,
         compatibilityDate: cfg.compatibility_date,
         secrets: secretValues,
       },
@@ -1663,9 +1628,24 @@ async function domains(args: string[]) {
     args[0] && !args[0].startsWith("-") && ["list", "add", "verify", "delete"].includes(args[0])
       ? args.shift()!
       : "list";
+  const flags = takeFlags(args, ["--account"] as const);
   const host = sub === "list" ? undefined : args.shift();
   if (sub !== "list" && !host)
     usageError(`domains ${sub}: missing <hostname>`, `domains ${sub} <hostname> [project-dir]`);
+  const { apiUrl: targetUrl } = await resolveApiUrl();
+  if ((await deployKind(targetUrl, false)) === "cloud") {
+    await guard(async () => {
+      if (host !== undefined) throw new CloudError(cloudDomainsUnsupported(sub, host));
+      const project = await readProjectConfig(args[0]);
+      const credentials = await cloudCredentials(targetUrl, flags["--account"] ?? project.account);
+      for (const line of describeCloudRoutes(
+        project.config.name,
+        await listCloudRoutes(credentials, project.config.name),
+      ))
+        console.log(line);
+    });
+    return;
+  }
   const [project, { apiUrl, token }] = await Promise.all([readProjectConfig(args[0]), apiCredentials()]);
   const base = `${apiUrl}/api/projects/${project.config.name}/domains`;
   const auth = { "x-api-key": token };
@@ -2527,13 +2507,13 @@ if (!(command === "tail" && args.some((arg) => arg === "--file" || arg.startsWit
 
 switch (resolveCommand(command)) {
   case "init":
-    await init(args[0]);
+    await init(args);
     break;
   case "check":
     await check(args[0]);
     break;
   case "types":
-    await types(args[0]);
+    await types(args);
     break;
   case "dev":
     await dev(args);

package/src/options.ts

@@ -28,10 +28,19 @@ export type Options = {
 };
 
 export const COMMAND_OPTIONS = {
-  init: {},
+  // As in create-cloudflare: --template picks a starter, --git and --install (and their --no-) decide the two steps
+  // after scaffolding, -y takes every default. --list-templates prints the starters and exits.
+  init: {
+    value: ["--template"],
+    flag: ["--list-templates", "--git", "--no-git", "--install", "--no-install", "--yes", "-y", "--accept-defaults"],
+  },
   check: {},
-  types: {},
-  dev: { value: ["--port"], flag: ["--no-watch"] },
+  // The booleans take `--strict-vars=false` as in Wrangler (types-cmd.ts reads the pair); `--no-...` is the short way.
+  types: {
+    value: ["--env-interface", "--strict-vars", "--include-runtime", "--include-env"],
+    flag: ["--check", "--no-strict-vars", "--no-include-runtime", "--no-include-env"],
+  },
+  dev: { value: ["--port", "--ip"], flag: ["--no-watch"] },
   run: { value: ["--binary", "--port", "--data-dir", "--require"], flag: ["--check"] },
   build: {
     value: ["--target"],
@@ -56,7 +65,7 @@ export const COMMAND_OPTIONS = {
     flag: ["--recent", "--sprout", "--no-follow"],
   },
   delete: { value: ["--name"], flag: ["--yes", "-y"] },
-  domains: {},
+  domains: { value: ["--account"] },
   // `secret` is the same command (surface.ts); `list | put | delete | bulk` share these, `--value` is put's.
   secrets: { value: ["--value", "--account"], flag: ["--no-deploy"] },
   kv: {

package/src/surface.ts

@@ -92,10 +92,10 @@ export const COMMANDS: readonly Command[] = [
     group: "Develop",
     emoji: "🌱",
     short: "Scaffold a new project",
-    args: "[name]",
+    args: "[name] [--template <name>] [--list-templates] [--git | --no-git] [--install | --no-install] [-y, --yes]",
     brief: "[name]",
     summary:
-      "Scaffold sproutboat.jsonc, src/index.js and package.json (sproutboat devDependency, dev, deploy and check scripts) in ./<name>.",
+      "Scaffold a project in ./<name> (the last path segment is the app's name), with the shape of `npm create cloudflare`. Without --template it writes sproutboat.jsonc, src/index.js and package.json (sproutboat devDependency, dev, deploy and check scripts). `--template <name>` writes a starter instead, standard Workers TypeScript with tests, a README and a current worker-configuration.d.ts: realtime-room (a chat room on Durable Objects and hibernating WebSockets), api-d1 (a JSON API on D1 with migrations and validation), site-api (a static site and its API in one Worker) or jobs (a cron trigger, a queue and KV); `--list-templates` prints them with their descriptions. In a terminal it asks for the template, the directory, whether to install dependencies and whether to use git (both default to yes); `-y` takes every default without asking, and anywhere else nothing runs that a flag did not ask for. `--install` runs the project's package manager (npm, pnpm, yarn or bun, by lockfile, else the tool that launched the CLI); `--git` runs `git init` and makes a first commit, and does nothing inside an existing repository. It never overwrites a file.",
   },
   {
     name: "check",
@@ -110,21 +110,21 @@ export const COMMANDS: readonly Command[] = [
     name: "types",
     group: "Develop",
     emoji: "🧾",
-    short: "Write sproutboat-env.d.ts for your editor",
-    args: "[project-dir]",
-    brief: "[project-dir]",
+    short: "Write worker-configuration.d.ts for your editor",
+    args: "[path] [--env-interface <name>] [--strict-vars[=false]] [--include-runtime[=false]] [--include-env[=false]] [--check]",
+    brief: "[path]",
     summary:
-      "Write sproutboat-env.d.ts from the config, so an editor knows what `env` holds. `dev` and `deploy` refresh it when the config is newer.",
+      'Generate the project\'s `Env` as TypeScript from sproutboat.jsonc, like `wrangler types`: the file is worker-configuration.d.ts unless <path> names another; it declares `interface Env` (and `Cloudflare.Env`, which `import { env } from "cloudflare:workers"` reads) with a type per binding, literal types for vars (--strict-vars=false makes them `string`), and a Durable Object binding typed with its class when the entry is TypeScript. It references the runtime types shipped with the CLI (--include-runtime=false leaves that out, for a project that brings its own) instead of copying them in, and there is no --include-main-module. Type a handler as `export default { ... } satisfies ExportedHandler<Env>`. --check exits 1 when the file is missing or out of date, by the hash in its first lines. KV, D1, R2, Durable Object and Fetcher types follow the compatibility date, as the runtime does. `dev` and `deploy` refresh the default file when it was written by a plain `sproutboat types` and the config has moved on; they leave one made with other flags alone. A positional that is an existing directory is still read as the project directory. The file earlier releases wrote, sproutboat-env.d.ts, is removed when it is still as generated.',
   },
   {
     name: "dev",
     group: "Develop",
     emoji: "⚡",
     short: "Run the app locally, rebuilding on save",
-    args: "[project-dir] [--port <n>] [--no-watch] [-e, --env <name>] [--env-file <file>]...",
+    args: "[project-dir] [--port <n>] [--ip <address>] [--no-watch] [-e, --env <name>] [--env-file <file>]...",
     brief: "[project-dir]",
     summary:
-      "Run the project on this machine with local storage, rebuilding on save. Secrets come from .dev.vars or the .env files (never both), as in Wrangler; a declared secret with no value is a warning.",
+      "Run the project on this machine with local storage, rebuilding on save. It listens on 127.0.0.1 unless `--ip` names another address (`--ip 0.0.0.0` is reachable from other machines on the network, as in Wrangler). Secrets come from .dev.vars or the .env files (never both), as in Wrangler; a declared secret with no value is a warning.",
   },
   {
     name: "run",
@@ -223,9 +223,10 @@ export const COMMANDS: readonly Command[] = [
     group: "Configure",
     emoji: "🌐",
     short: "Attach custom domains",
-    args: "<list | add <host> | verify <host> | delete <host>> [project-dir] [--api-url <url>]",
+    args: "<list | add <host> | verify <host> | delete <host>> [project-dir] [--api-url <url>] [--account <team>]",
     brief: "<list | add | verify | delete>",
-    summary: "Attach a custom domain to the project (TXT-verified). No sub-command lists.",
+    summary:
+      "List the project's domains, or attach one (TXT-verified). On the Cloud only list works: custom domains are added by an operator, and deploys keep them.",
   },
   {
     name: "secrets",
@@ -351,7 +352,7 @@ export const ENV_VARS: readonly EnvVar[] = [
   {
     name: "SPROUTBOAT_PORFFOR_CHANNEL",
     purpose:
-      "Porffor channel for standalone builds: `alpha-22` (default) or `alpha-19` (the previous compiler, kept as a fallback for one release).",
+      "Porffor channel for standalone builds: `alpha-23` (default), `alpha-22` or `alpha-19` (the oldest compiler, kept as a fallback for one release).",
   },
   {
     name: "SPROUTBOAT_RELEASE",