@home-v0/cli 0.1.0 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # @home-v0/cli
 
-Build a house in 3D in [home-v0](https://home-v0.com) from a folder of photos and floor plans, by hand or with an AI agent (Claude Code, Codex, Cursor…). An agent in home-v0 builds the model; the CLI uploads the house, follows the build, and saves the agent's chat, renders and 3D model next to your files.
+[home-v0](https://home-v0.com) helps a homeowner decide what to do with the outside of their house and send the plan to whoever will build it. This CLI builds a house in 3D in home-v0 from a folder of photos and floor plans, by hand or with an AI agent (Claude Code, Codex, Cursor…). An agent in home-v0 builds the model; the CLI uploads the house, follows the build, and saves the agent's chat, renders and 3D model next to your files.
 
 ```sh
 npx @home-v0/cli login --token hv0_…                                  # API key from home-v0 → API keys
@@ -10,15 +10,15 @@ npx @home-v0/cli build our-house                                      # 10 to 40
 npx @home-v0/cli say our-house -m "The roof is steeper: the section shows 45 degrees"
 ```
 
-| Command                                 | What it does                                                         |
-| --------------------------------------- | -------------------------------------------------------------------- |
-| `login [--token]`, `logout`             | Save or forget an API key (or set `HOME_V0_API_KEY`)                 |
-| `init [dir] --name … --place …`          | Start a house folder: `house.json`, `photos/`, `drawings/`           |
-| `houses [dir]`                          | List the house folders below a folder                                |
-| `build [house]`                         | Make the house in home-v0, upload its files and follow the build     |
-| `say [house] -m …`                      | Tell the agent what to change and follow its answer                  |
-| `follow`, `pull`, `stop` `[house]`      | Keep following, save the latest files once, or stop the agent's turn |
-| `guide [--agents-md]`                   | The folder format, the workflow and how to review a build            |
+| Command                            | What it does                                                         |
+| ---------------------------------- | -------------------------------------------------------------------- |
+| `login [--token]`, `logout`        | Save or forget an API key (or set `HOME_V0_API_KEY`)                 |
+| `init [dir] --name … --place …`    | Start a house folder: `house.json`, `photos/`, `drawings/`           |
+| `houses [dir]`                     | List the house folders below a folder                                |
+| `build [house]`                    | Make the house in home-v0, upload its files and follow the build     |
+| `say [house] -m …`                 | Tell the agent what to change and follow its answer                  |
+| `follow`, `pull`, `stop` `[house]` | Keep following, save the latest files once, or stop the agent's turn |
+| `guide [--agents-md]`              | The folder format, the workflow and how to review a build            |
 
 A house is a folder with a `house.json`, the current folder by default.
 
@@ -30,4 +30,4 @@ Exit codes: 0 done, 1 the build failed or is waiting on a key or limit, 2 a mist
 
 ## Developing
 
-From the repo root: `npm run home -- <command>` runs the source against `--api-url http://localhost:3000` or any home-v0. A local API needs no key: the CLI makes its own account there. `npm run build -w @home-v0/cli` bundles `dist/home-v0.js`, which is what gets published. To release, bump the version here, then `npm publish` from this folder.
+From the repo root: `npm run home -- <command>` runs the source against `--api-url http://localhost:3000` or any home-v0. A local API needs no key: the CLI makes its own account there. `npm run build -w @home-v0/cli` bundles `dist/home-v0.js`, which is what gets published. Releases go through `.github/workflows/release-cli.yml`: bump the version here in a PR, then run the workflow.

package/dist/home-v0.js

@@ -52,14 +52,11 @@ var HomeApi = class {
     return this.request("GET", `places/search?${new URLSearchParams({ q: query })}`);
   }
   createProject(name, place) {
-    return this.request("POST", "projects", { json: { name, kind: "house", place } });
+    return this.request("POST", "projects", { json: { name, place } });
   }
   deleteProject(id) {
     return this.request("DELETE", `projects/${id}`);
   }
-  spaces(projectId) {
-    return this.request("GET", `projects/${projectId}/spaces`);
-  }
   space(id) {
     return this.request("GET", `spaces/${id}`);
   }
@@ -180,10 +177,10 @@ var webUrlFor = (apiUrl) => {
 // src/guide.ts
 var guide = () => `# Building a house in home-v0 with the CLI
 
-home-v0 turns a house's photos and floor plans into a 3D model built by an AI agent, and suggests what the house
-could become. The \`home-v0\` CLI does what you'd do in the app: it makes the house, uploads its photos and drawings,
-starts the build, and saves the agent's chat, renders and 3D model in the house's folder. You (a person or an AI
-agent) prepare a folder; the CLI does the rest.
+home-v0 helps a homeowner decide what to do with the outside of their house and send the plan to whoever will
+build it. An AI agent builds the house in 3D from its photos and floor plans. The \`home-v0\` CLI does what you'd
+do in the app: it makes the house, uploads its photos and drawings, starts the build, and saves the agent's chat,
+renders and 3D model in the house's folder. You (a person or an AI agent) prepare a folder; the CLI does the rest.
 
 ## Sign in
 
@@ -225,8 +222,7 @@ my-house/
 
 Photos: the whole outside of the house from eye level, each side if you can. Street View screenshots work well.
 At least one photo is required: the app reads the house from its photos. Drawings are optional but make the model
-much closer: plans decide wall lengths, rooms and openings on sides the photos don't show, and each floor with a
-plan is built inside too.
+much closer: plans decide wall lengths and openings on sides the photos don't show.
 
 ## Workflow
 
@@ -241,7 +237,7 @@ plan is built inside too.
 4. \`home-v0 follow my-house\` keeps watching if a command timed out; \`home-v0 pull my-house\` saves the latest files
    without waiting; \`home-v0 stop my-house\` stops the agent's current turn.
 
-Open the link in \`run.json\` to see the model in 3D, peel it floor by floor, and try new directions in the app.
+Open the link in \`run.json\` to see the model in 3D and try ideas on it in the app.
 
 ## Review
 
@@ -251,7 +247,6 @@ Compare each render with the photos and drawings, element by element:
 - the roof: type, pitch, overhangs, which way the ridge runs, dormers and chimneys
 - openings on each side: how many, where, and how big
 - materials and colours
-- inside each floor that has a plan: walls, doors, stairs and room names
 
 Say which render and which photo or drawing each point comes from, and how sure you are when a render's angle hides
 something. Fix the biggest differences first.
@@ -475,7 +470,7 @@ function chatMarkdown(run, messages) {
 }
 
 // src/version.ts
-var VERSION = true ? "0.1.0" : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
+var VERSION = true ? "0.2.0" : JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8")).version;
 
 // src/main.ts
 var POLL_MS = 3e3;
@@ -647,11 +642,9 @@ async function startBuild(api, house) {
   const project = await api.createProject(house.name, place);
   let run;
   try {
-    const exterior = (await api.spaces(project.id)).find((space2) => space2.kind === "exterior");
-    if (!exterior) throw new Error(`The new house ${project.id} has no exterior`);
-    let space = await api.addPhotos(exterior.id, house.photos);
+    let space = await api.addPhotos(project.spaceId, house.photos);
     for (let i = 0; i < house.drawings.length; i += MAX_DRAWING_FILES_PER_UPLOAD) {
-      space = await api.addDrawings(exterior.id, house.drawings.slice(i, i + MAX_DRAWING_FILES_PER_UPLOAD));
+      space = await api.addDrawings(project.spaceId, house.drawings.slice(i, i + MAX_DRAWING_FILES_PER_UPLOAD));
     }
     console.log(
       `  uploaded ${count(space.photos.length, "photo")} and ${count(space.drawings.length, "page")} of drawings`
@@ -660,10 +653,10 @@ async function startBuild(api, house) {
       apiUrl: api.baseUrl,
       webUrl: `${webUrlFor(api.baseUrl)}/projects/${project.id}/exterior`,
       projectId: project.id,
-      spaceId: exterior.id,
+      spaceId: project.spaceId,
       startedAt: startedAt.toISOString()
     });
-    await api.capture(exterior.id);
+    await api.capture(project.spaceId);
   } catch (error) {
     await api.deleteProject(project.id).catch(() => void 0);
     if (run) await rm2(run.folder, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@home-v0/cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Build a house in 3D in home-v0 from a folder of photos and floor plans. Made for people and AI agents.",
   "license": "MIT",
   "repository": {