create-curb.js 1.16.0-preview.3 → 1.16.0-preview.5

package/RELEASE_NOTES.md

@@ -6,6 +6,8 @@
 
 ### Fixed
 
+- Explain a target folder that cannot be created (#40)
+- Say what hosted deploys accept today (#46)
 - Correct what the help and guide say about conversations and build (#41)
 - Start curb outside a project from the npm package (#38)
 

package/bin/create-curb.js

@@ -12,6 +12,7 @@ import {
   readFileSync,
   readdirSync,
   renameSync,
+  statSync,
   writeFileSync,
 } from "node:fs";
 import { basename, dirname, join, resolve } from "node:path";
@@ -118,6 +119,9 @@ if (!/^[a-z0-9][a-z0-9._-]*$/.test(appName)) {
     `"${appName}" is not a valid project name — use lowercase letters, digits, ".", "_", "-" (npm package name rules).`,
   );
 }
+if (existsSync(targetDir) && !statSync(targetDir).isDirectory()) {
+  fail(`${targetDir} is a file. Choose a new directory.`);
+}
 if (existsSync(targetDir) && readdirSync(targetDir).length > 0) {
   fail(`${targetDir} already exists and is not empty. Choose a new directory.`);
 }
@@ -301,8 +305,12 @@ const envValues = finalizeEnv();
 
 // -------------------------------------------------------------- copy template
 const templateDir = resolve(dirname(fileURLToPath(import.meta.url)), "../templates/default");
-mkdirSync(targetDir, { recursive: true });
-cpSync(templateDir, targetDir, { recursive: true });
+try {
+  mkdirSync(targetDir, { recursive: true });
+  cpSync(templateDir, targetDir, { recursive: true });
+} catch (error) {
+  fail(`Cannot create the project in ${targetDir} (${error.code ?? error.message}). Choose a directory you can write to.`);
+}
 
 // npm strips .gitignore from published tarballs, so the template ships it without the
 // leading dot. The project carries no .npmrc: hosted builds refuse one.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-curb.js",
-  "version": "1.16.0-preview.3",
+  "version": "1.16.0-preview.5",
   "description": "Create a Curb voice agent: npm create curb.js my-agent",
   "license": "Apache-2.0",
   "homepage": "https://curbjs.com",

package/templates/default/AGENTS.md

@@ -134,6 +134,12 @@ context/*.md                knowledge a skill reads with <Text src="file.md" />
 
 ## Deploy to KugelAudio
 
+**Hosted deploys do not accept a project that installs Curb from npm yet, and this project
+does.** Tell the user so before you try to deploy, and do not change the `curb` dependency to
+get around it. Today the project runs locally with `npm run dev` and goes live on the user's own
+servers (`node_modules/curb/docs/agent-guide/hosting.md`). The rest of this section applies once
+hosted deploys accept the project.
+
 `.mcp.json` registers two MCP servers for Claude Code started in this folder (it asks once
 to use them): `kugelaudio`, your KugelAudio account (sign in from `/mcp`), and
 `kugelaudio-docs`, the docs (no sign-in). Another client adds

package/templates/default/README.md

@@ -41,6 +41,10 @@ Type or talk in the preview:
 
 ## Deploy to KugelAudio
 
+Hosted deploys do not accept a project that installs Curb from npm yet, and this project does.
+Today it runs locally with `npm run dev` and goes live on your own servers: see
+`node_modules/curb/docs/agent-guide/hosting.md`. Once hosted deploys accept it:
+
 ```bash
 npx curb login
 npx curb secrets push
@@ -49,8 +53,7 @@ npx curb deploy
 
 `deploy` prints the playground URL where you can call the live agent. Your `.env` is
 never uploaded; `secrets push` sends its values and prints only their names. Details:
-`node_modules/curb/docs/agent-guide/deploying.md`. To run the voice worker on your own LiveKit instead,
-see `node_modules/curb/docs/agent-guide/hosting.md`.
+`node_modules/curb/docs/agent-guide/deploying.md`.
 
 ## Learn more