@voicethere/cli 0.1.0 → 0.2.2

package/README.md

@@ -18,6 +18,29 @@ Or run without a global install:
 npx @voicethere/cli <command>
 ```
 
+## Debugging
+
+Commands print resolved paths on **stderr** at startup:
+
+```text
+[voicethere] project: 550e8400-… (project config (/path/.voicethere/config.json))
+[voicethere] bundle: /path/to/dist/agent.js (project config (/path/.voicethere/config.json))
+```
+
+Use this when a command fails to confirm which project and bundle file were picked up.
+
+## Project selection
+
+The CLI remembers the **active project** in **`.voicethere/config.json`** (safe to commit — no API keys).
+
+| Situation | What happens |
+| --------- | -------------- |
+| Config file present | `build upload`, `build list`, `build promote` use its `project_id` automatically |
+| No config, interactive terminal | `projects use` shows a numbered project picker |
+| No config, CI / script | Run `voicethere projects use <projectId>` once (or commit config from `projects create`) |
+
+You do **not** need to run `projects use` on every command when the config file is already in the repo.
+
 ## Typical workflow
 
 ### 1. One-time login (per machine)
@@ -32,7 +55,7 @@ voicethere login --api-key "$VOICETHERE_API_KEY" --api-base http://localhost:300
 
 Default API base: `https://app.voicethere.dev/api/v1`
 
-### 2. New agent repo — create project and link via git
+### 2. New agent repo — create project and commit config
 
 From your agent project root (where you build `dist/agent.js`):
 
@@ -40,37 +63,34 @@ From your agent project root (where you build `dist/agent.js`):
 npm install @voicethere/agent
 npx @voicethere/agent build
 
-# Creates the cloud project and writes .voicethere/config.json
-voicethere projects create --name "My Voice Agent"
+# Creates the cloud project and uses it (.voicethere/config.json)
+voicethere projects create "My Voice Agent"
 
 git add .voicethere/config.json
-git commit -m "chore: link VoiceThere project"
+git commit -m "chore: use VoiceThere project"
 ```
 
-`.voicethere/config.json` holds the **project id** and default **bundle** path. Commit it so teammates and CI use the same project without passing `--project` every time.
-
 ### 3. Upload a build (store artifact)
 
 Upload **stores** a new immutable build in history — it does **not** go live yet.
 
 ```bash
-voicethere build validate    # optional but recommended
+voicethere build validate    # optional; uses config bundle or dist/agent.js
 voicethere build upload -m "Add Spanish greeting and fix barge-in"
 ```
 
 `-m` / `--message` is like a git commit message: a short label so you can tell builds apart in `build list` and the dashboard.
 
-`build upload` reads `project_id` and `bundle` from `.voicethere/config.json` when flags are omitted.
-
 ### 4. Promote a build (set active in control plane)
 
 **Promote** sets the **active** build in the VoiceThere control plane. It does **not** roll out to cloud runners yet — use **`voicethere deploy`** when that command ships.
 
-Pass the build UUID from **`build list`** or from the **`build upload`** output:
+Pass the build UUID from **`build upload`** or **`build list`**, or omit it in an interactive terminal to pick from a list:
 
 ```bash
 voicethere build list
 voicethere build promote <build-uuid>
+# interactive: voicethere build promote
 ```
 
 Typical release loop:
@@ -94,19 +114,19 @@ voicethere build list
 voicethere build promote <build-uuid>
 ```
 
-No `projects create` needed — the linked project travels with the repo.
-
-### 6. Link an existing cloud project (no create)
+No `projects use` needed — the active project travels with the repo.
 
-If the project already exists in the dashboard:
+### 6. Use a different cloud project
 
 ```bash
 voicethere projects list
-voicethere projects use --project <uuid> --slug my-agent --bundle dist/agent.js
-git add .voicethere/config.json && git commit -m "chore: link VoiceThere project"
+voicethere projects use <uuid> --slug my-agent --bundle dist/agent.js
+git add .voicethere/config.json && git commit -m "chore: use VoiceThere project"
 ```
 
-Inspect the link anytime:
+Re-run `voicethere projects use` with no args to confirm the current project (reads existing config).
+
+Inspect the selection anytime:
 
 ```bash
 voicethere projects show
@@ -114,18 +134,33 @@ voicethere projects show
 
 ### 7. CI / automation
 
-- **Credentials:** inject `VOICETHERE_API_KEY` and run `voicethere login` (or set `VOICETHERE_CREDENTIALS_PATH` in tests).
-- **Project:** rely on committed `.voicethere/config.json` — no `--project` in the pipeline.
-- **Override config path:** `VOICETHERE_PROJECT_CONFIG=/path/to/config.json`
+**With committed `.voicethere/config.json`** (typical agent repo):
 
 ```bash
 voicethere login --api-key "$VOICETHERE_API_KEY"
 npx @voicethere/agent build
 voicethere build upload -m "$GITHUB_SHA — $GITHUB_REF_NAME" --skip-validate
-voicethere build promote <build-uuid>
+voicethere build promote <build-uuid-from-upload>
+```
+
+No `projects use` step — the config file is the active project.
+
+**Without a config file** (one-off job cwd):
+
+```bash
+voicethere login --api-key "$VOICETHERE_API_KEY"
+voicethere projects use <project-uuid>
+npx @voicethere/agent build
+voicethere build upload --skip-validate
+voicethere build promote <build-uuid-from-upload>
 ```
 
-Split upload and promote in separate jobs if you want a human approval gate between them.
+Other CI notes:
+
+- **Credentials:** `VOICETHERE_CREDENTIALS_PATH` for isolated test runs
+- **Config override:** `VOICETHERE_PROJECT_CONFIG=/path/to/config.json`
+
+Split upload and promote across jobs if you want a human approval gate between them.
 
 ### 8. `deploy` (coming soon)
 
@@ -133,41 +168,61 @@ Split upload and promote in separate jobs if you want a human approval gate betw
 
 ## Repo config (version control)
 
-Per-agent-repo link file: **`.voicethere/config.json`** (safe to commit — no API keys).
+Per-agent-repo file: **`.voicethere/config.json`**
 
-| Field                  | Purpose                                                    |
-| ---------------------- | ---------------------------------------------------------- |
-| `project_id`           | Platform project UUID — used as default for `build upload` |
-| `project_slug`, `name` | Human-readable metadata (optional)                         |
-| `bundle`               | Default bundle path (default `dist/agent.js`)              |
-
-```bash
-# Link an existing cloud project
-voicethere projects use --project <uuid> --slug my-agent --bundle dist/agent.js
-
-# Override path for tests
-export VOICETHERE_PROJECT_CONFIG=/path/to/config.json
-```
+| Field                  | Purpose                                              |
+| ---------------------- | ---------------------------------------------------- |
+| `project_id`           | Active platform project UUID                         |
+| `project_slug`, `name` | Human-readable metadata (optional)                   |
+| `bundle`               | Default bundle path (default `dist/agent.js`)        |
 
-**Secrets stay global:** `~/.config/voicethere/credentials.json` (from `voicethere login`).  
-Optional gitignored overrides: `.voicethere/local.json` (reserved for future use).
+**Secrets stay global:** `~/.config/voicethere/credentials.json` (from `voicethere login`).
 
 Example: [`.voicethere/config.json.example`](./.voicethere/config.json.example)
 
 ## Commands
 
-| Command                                               | Description                                              |
-| ----------------------------------------------------- | -------------------------------------------------------- |
-| `login --api-key <key> [--api-base <url>]`            | Save credentials                                         |
-| `projects list`                                       | List org projects                                        |
-| `projects create --name <name> [--slug <slug>]`       | Create project; writes `.voicethere/config.json`         |
-| `projects use --project <id>`                         | Link repo to existing project                            |
-| `projects show`                                       | Print linked `.voicethere/config.json`                   |
-| `build list [--project <id>]`                         | Uploaded builds: id, time, message, active flag          |
-| `build validate [--file dist/agent.js]`               | Run `@voicethere/agent verify --no-build --bundle`       |
-| `build upload [-m <msg>] [--project <id>] [--file …]` | Store build in history (does not promote)                |
-| `build promote <buildId> [--project <id>]`            | Set active build in the control plane                    |
-| `deploy`                                              | **Coming soon** — promote + cloud rollout + wait         |
+| Command                                        | Description                                              |
+| ---------------------------------------------- | -------------------------------------------------------- |
+| `login --api-key <key> [--api-base <url>]`     | Save credentials                                         |
+| `projects list`                                | List org projects                                        |
+| `projects create <name> [--slug <slug>]`       | Create project; uses it (writes config)                  |
+| `projects use [projectId]`                     | Use project (picker or existing config when omitted)     |
+| `projects show`                                | Print `.voicethere/config.json`                          |
+| `projects delete [projectId] [--force]`        | Delete project + builds (type name to confirm, or `--force`) |
+| `build list`                                   | Builds for the active project                            |
+| `build validate [file]`                        | Sandbox verify (default bundle from config)              |
+| `build upload [file] [-m <msg>]`               | Upload to active project                                 |
+| `build promote [buildId]`                      | Promote on active project (picker when omitted in TTY)   |
+| `deploy`                                       | **Coming soon** — promote + cloud rollout + wait         |
+
+## Logging
+
+Progress and resolved paths go to **stderr** as `[voicethere] …` so **stdout** stays clean for JSON/tables (scripts can pipe stdout).
+
+| Mode | Flag / env | What you get |
+| ---- | ---------- | ------------ |
+| **Default** | *(always on)* | High-level steps: “Creating project…”, “Uploading bundle…”, resolved project/bundle paths |
+| **Verbose** | `-v` / `--verbose` or `VOICETHERE_VERBOSE=1` | API method + path, request bodies (no secrets), response status + timing, counts |
+
+Examples:
+
+```bash
+voicethere build upload
+# stderr: [voicethere] Uploading agent bundle
+#         [voicethere] project: …
+#         [voicethere] bundle: …
+#         [voicethere] Validating bundle locally before upload
+#         [voicethere] Running @voicethere/agent verify on bundle
+#         [voicethere] Uploading bundle to control plane API
+
+voicethere -v build upload
+# …plus [voicethere:verbose] api: https://…
+#           [voicethere:verbose] POST /projects/…/builds
+#           [voicethere:verbose] response: 201 (842ms)
+```
+
+Global `-v` works on any subcommand: `voicethere -v projects list`.
 
 ## Development
 

package/dist/cli.js

@@ -2,6 +2,7 @@
 import { Command } from "commander";
 import { runLogin } from "./commands/login.js";
 import { runProjectsCreate } from "./commands/projects/create.js";
+import { runProjectsDelete } from "./commands/projects/delete.js";
 import { runProjectsList } from "./commands/projects/list.js";
 import { runProjectsShow } from "./commands/projects/show.js";
 import { runProjectsUse } from "./commands/projects/use.js";
@@ -10,13 +11,19 @@ import { runBuildList } from "./commands/build/list.js";
 import { runBuildUpload } from "./commands/build/upload.js";
 import { runBuildValidate } from "./commands/build/validate.js";
 import { runDeployReserved } from "./commands/deploy.js";
+import { configureLogging } from "./lib/command-log.js";
 import { DEFAULT_API_BASE } from "./lib/config.js";
 async function main() {
+    configureLogging();
     const program = new Command();
     program
         .name("voicethere")
         .description("VoiceThere cloud CLI")
-        .version("0.1.0");
+        .version("0.2.2")
+        .option("-v, --verbose", "Detailed logs on stderr (API calls, timings)")
+        .hook("preAction", (_thisCommand, actionCommand) => {
+        configureLogging({ verbose: actionCommand.optsWithGlobals().verbose });
+    });
     program
         .command("login")
         .description("Store API key and API base URL")
@@ -40,13 +47,13 @@ async function main() {
     projects
         .command("create")
         .description("Create a new project")
-        .requiredOption("--name <name>", "Project display name")
+        .argument("<name>", "Project display name")
         .option("--slug <slug>", "URL-safe slug (derived from name when omitted)")
         .option("--no-link", "Do not write .voicethere/config.json in the current repo")
         .option("--bundle <path>", "Default bundle path stored in .voicethere/config.json", "dist/agent.js")
-        .action(async (options) => {
+        .action(async (name, options) => {
         await runProjectsCreate({
-            name: options.name,
+            name,
             slug: options.slug,
             link: !options.noLink,
             bundle: options.bundle,
@@ -54,14 +61,14 @@ async function main() {
     });
     projects
         .command("use")
-        .description("Link this repo to a platform project (.voicethere/config.json)")
-        .requiredOption("--project <id>", "Project UUID")
-        .option("--slug <slug>", "Project slug (metadata only)")
-        .option("--name <name>", "Project display name (metadata only)")
+        .description("Use a project for this repo (.voicethere/config.json)")
+        .argument("[projectId]", "Project UUID (interactive picker when omitted in a TTY)")
+        .option("--slug <slug>", "Override project slug in local config")
+        .option("--name <name>", "Override display name in local config")
         .option("--bundle <path>", "Default bundle path", "dist/agent.js")
-        .action(async (options) => {
+        .action(async (projectId, options) => {
         await runProjectsUse({
-            project: options.project,
+            projectId,
             slug: options.slug,
             name: options.name,
             bundle: options.bundle,
@@ -69,36 +76,44 @@ async function main() {
     });
     projects
         .command("show")
-        .description("Show linked .voicethere/config.json for this repo")
+        .description("Show the active project (.voicethere/config.json)")
         .action(async () => {
         await runProjectsShow();
     });
+    projects
+        .command("delete")
+        .description("Delete a project and all its builds")
+        .argument("[projectId]", "Project UUID (default: active project from .voicethere/config.json)")
+        .option("--force", "Skip interactive name confirmation")
+        .action(async (projectId, options) => {
+        await runProjectsDelete({
+            projectId,
+            force: options.force,
+        });
+    });
     const build = program.command("build").description("Agent bundle operations");
     build
         .command("validate")
         .description("Run @voicethere/agent sandbox verify on a bundle")
-        .option("--file <path>", "Bundle path (default: config bundle or dist/agent.js)")
-        .action(async (options) => {
-        await runBuildValidate({ file: options.file });
+        .argument("[file]", "Bundle path (default: config bundle or dist/agent.js)")
+        .action(async (file) => {
+        await runBuildValidate({ file });
     });
     build
         .command("list")
-        .description("List uploaded builds (newest first)")
-        .option("--project <id>", "Project UUID (default: .voicethere/config.json project_id)")
-        .action(async (options) => {
-        await runBuildList({ project: options.project });
+        .description("List uploaded builds for the active project (newest first)")
+        .action(async () => {
+        await runBuildList();
     });
     build
         .command("upload")
         .description("Validate (unless skipped) and upload a bundle")
-        .option("--project <id>", "Project UUID (default: .voicethere/config.json project_id)")
-        .option("--file <path>", "Bundle path (default: config bundle or dist/agent.js)")
+        .argument("[file]", "Bundle path (default: config bundle or dist/agent.js)")
         .option("-m, --message <text>", "Build label (like a git commit message)")
         .option("--skip-validate", "Upload without local sandbox verify")
-        .action(async (options) => {
+        .action(async (file, options) => {
         await runBuildUpload({
-            project: options.project,
-            file: options.file,
+            file,
             message: options.message,
             skipValidate: options.skipValidate,
         });
@@ -106,13 +121,9 @@ async function main() {
     build
         .command("promote")
         .description("Set active build in the control plane (platform promote API; no cluster rollout)")
-        .argument("<buildId>", "Build UUID to promote (from build list or upload output)")
-        .option("--project <id>", "Project UUID (default: .voicethere/config.json project_id)")
-        .action(async (buildId, options) => {
-        await runBuildPromote({
-            project: options.project,
-            buildId,
-        });
+        .argument("[buildId]", "Build UUID (interactive picker when omitted in a TTY)")
+        .action(async (buildId) => {
+        await runBuildPromote({ buildId });
     });
     program
         .command("deploy")

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/build/list.d.ts

@@ -1,5 +1,6 @@
 export interface BuildListOptions {
-    project?: string;
+    /** Reserved for tests. */
+    startDir?: string;
 }
-export declare function runBuildList(options: BuildListOptions): Promise<void>;
+export declare function runBuildList(options?: BuildListOptions): Promise<void>;
 //# sourceMappingURL=list.d.ts.map

package/dist/commands/build/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/build/list.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB3E"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/build/list.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAaD,wBAAsB,YAAY,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BhF"}

package/dist/commands/build/list.js

@@ -1,6 +1,7 @@
 import { createApi } from "../../lib/api.js";
+import { logResolvedProject, logStep, logVerbose } from "../../lib/command-log.js";
 import { requireCredentials } from "../../lib/config.js";
-import { requireProjectId } from "../../lib/project-config.js";
+import { resolveProjectId } from "../../lib/project-config.js";
 function formatUploadedAt(iso) {
     const date = new Date(iso);
     if (Number.isNaN(date.getTime())) {
@@ -11,21 +12,25 @@ function formatUploadedAt(iso) {
         .replace("T", " ")
         .replace(/\.\d{3}Z$/, " UTC");
 }
-export async function runBuildList(options) {
-    const projectId = await requireProjectId({ projectFlag: options.project });
+export async function runBuildList(options = {}) {
+    logStep("Listing builds for active project");
+    const project = await resolveProjectId({ startDir: options.startDir });
+    logResolvedProject(project);
     const credentials = await requireCredentials();
     const api = createApi(credentials.api_key, credentials.api_base);
-    const [project, builds] = await Promise.all([
-        api.getProject(projectId),
-        api.listBuilds(projectId),
+    logVerbose("fetching project and build history");
+    const [platformProject, builds] = await Promise.all([
+        api.getProject(project.projectId),
+        api.listBuilds(project.projectId),
     ]);
+    logVerbose(`found ${builds.length} build(s)`);
     if (builds.length === 0) {
         console.log("No builds uploaded yet.");
         return;
     }
     console.log("build_id\tuploaded_at\tstatus\tactive\tmessage");
     for (const build of builds) {
-        const active = project.active_build_id === build.id ? "yes" : "";
+        const active = platformProject.active_build_id === build.id ? "yes" : "";
         const message = build.message?.replace(/\s+/g, " ").trim() ?? "";
         console.log(`${build.id}\t${formatUploadedAt(build.created_at)}\t${build.validation_status}\t${active}\t${message}`);
     }

package/dist/commands/build/list.js.map

@@ -1 +1 @@
-{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/build/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAM/D,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAAyB;IAC1D,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEjE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1C,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;QACzB,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;KAC1B,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAE9D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACjE,OAAO,CAAC,GAAG,CACT,GAAG,KAAK,CAAC,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,iBAAiB,KAAK,MAAM,KAAK,OAAO,EAAE,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/build/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACnF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAO/D,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC;SACjB,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAA4B,EAAE;IAC/D,OAAO,CAAC,mCAAmC,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAE5B,MAAM,WAAW,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEjE,UAAU,CAAC,oCAAoC,CAAC,CAAC;IACjD,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAClD,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;QACjC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC;KAClC,CAAC,CAAC;IAEH,UAAU,CAAC,SAAS,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC;IAE9D,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,MAAM,GACV,eAAe,CAAC,eAAe,KAAK,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QACjE,OAAO,CAAC,GAAG,CACT,GAAG,KAAK,CAAC,EAAE,KAAK,gBAAgB,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,iBAAiB,KAAK,MAAM,KAAK,OAAO,EAAE,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/build/promote.d.ts

@@ -1,6 +1,5 @@
 export interface BuildPromoteOptions {
-    project?: string;
-    buildId: string;
+    buildId?: string;
 }
 /**
  * Promote sets the active build in the control plane (platform `POST …/promote`).

package/dist/commands/build/promote.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../src/commands/build/promote.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBjF"}
+{"version":3,"file":"promote.d.ts","sourceRoot":"","sources":["../../../src/commands/build/promote.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0DD;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/commands/build/promote.js

@@ -1,19 +1,60 @@
 import { createApi } from "../../lib/api.js";
+import { logBuildPromoteContext, logStep, logVerbose } from "../../lib/command-log.js";
 import { requireCredentials } from "../../lib/config.js";
-import { requireProjectId } from "../../lib/project-config.js";
+import { isInteractive, promptChoice } from "../../lib/prompt.js";
+import { resolveProjectId } from "../../lib/project-config.js";
+function formatUploadedAt(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime())) {
+        return iso;
+    }
+    return date
+        .toISOString()
+        .replace("T", " ")
+        .replace(/\.\d{3}Z$/, " UTC");
+}
+function formatBuildChoice(build, activeBuildId) {
+    const active = activeBuildId === build.id ? " [active]" : "";
+    const message = build.message?.replace(/\s+/g, " ").trim();
+    const label = message ? `${message} — ` : "";
+    return `${label}${build.id} — ${formatUploadedAt(build.created_at)}${active}`;
+}
+async function resolveBuildId(projectId, buildIdArg) {
+    const trimmed = buildIdArg?.trim();
+    if (trimmed) {
+        return trimmed;
+    }
+    const credentials = await requireCredentials();
+    const api = createApi(credentials.api_key, credentials.api_base);
+    logVerbose(`loading builds for project ${projectId}`);
+    const [project, builds] = await Promise.all([
+        api.getProject(projectId),
+        api.listBuilds(projectId),
+    ]);
+    if (builds.length === 0) {
+        throw new Error("No builds uploaded yet. Run: voicethere build upload");
+    }
+    if (!isInteractive()) {
+        throw new Error("Build id required in non-interactive mode. Run: voicethere build promote <buildId>");
+    }
+    return promptChoice("Select a build to promote", builds.map((build) => ({
+        label: formatBuildChoice(build, project.active_build_id),
+        value: build.id,
+    })));
+}
 /**
  * Promote sets the active build in the control plane (platform `POST …/promote`).
  * Does not roll out to cloud runners — use `voicethere deploy` when available.
  */
 export async function runBuildPromote(options) {
-    const buildId = options.buildId.trim();
-    if (!buildId) {
-        throw new Error("Build ID is required. Usage: voicethere build promote <buildId>");
-    }
-    const projectId = await requireProjectId({ projectFlag: options.project });
+    logStep("Promoting build to active");
+    const project = await resolveProjectId();
+    const buildId = await resolveBuildId(project.projectId, options.buildId);
+    logBuildPromoteContext(buildId, project);
     const credentials = await requireCredentials();
     const api = createApi(credentials.api_key, credentials.api_base);
-    const result = await api.promote(projectId, buildId);
+    logStep("Calling control plane promote API");
+    const result = await api.promote(project.projectId, buildId);
     console.log(`Promoted build ${result.active_build_id} for project ${result.project_id}`);
     console.log(`Active artifact: ${result.active_storage_path}`);
     console.log("Control plane updated — cloud runner rollout is not available yet (future: voicethere deploy --wait).");

package/dist/commands/build/promote.js.map

@@ -1 +1 @@
-{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../../src/commands/build/promote.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAO/D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA4B;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,iEAAiE,CAClE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEjE,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAErD,OAAO,CAAC,GAAG,CACT,kBAAkB,MAAM,CAAC,eAAe,gBAAgB,MAAM,CAAC,UAAU,EAAE,CAC5E,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,mBAAmB,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CACT,uGAAuG,CACxG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"promote.js","sourceRoot":"","sources":["../../../src/commands/build/promote.ts"],"names":[],"mappings":"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"}

package/dist/commands/build/upload.d.ts

@@ -1,6 +1,5 @@
 import { type BuildValidateOptions } from "./validate.js";
 export interface BuildUploadOptions extends BuildValidateOptions {
-    project?: string;
     message?: string;
     skipValidate?: boolean;
 }

package/dist/commands/build/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/commands/build/upload.ts"],"names":[],"mappings":"AAGA,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoBf"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/commands/build/upload.ts"],"names":[],"mappings":"AAeA,OAAO,EAAoB,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE5E,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAmCf"}

package/dist/commands/build/upload.js

@@ -1,16 +1,29 @@
+import { stat } from "node:fs/promises";
 import { createApi } from "../../lib/api.js";
+import { logResolvedBundle, logResolvedProject, logStep, logVerbose, } from "../../lib/command-log.js";
 import { requireCredentials } from "../../lib/config.js";
-import { requireProjectId, resolveBundlePath } from "../../lib/project-config.js";
+import { assertBundleExists, resolveBundlePathDetailed, resolveProjectId, } from "../../lib/project-config.js";
 import { runBuildValidate } from "./validate.js";
 export async function runBuildUpload(options) {
-    const projectId = await requireProjectId({ projectFlag: options.project });
-    const bundlePath = await resolveBundlePath(options.file);
+    logStep("Uploading agent bundle");
+    const project = await resolveProjectId();
+    const bundle = await resolveBundlePathDetailed(options.file);
+    logResolvedProject(project);
+    logResolvedBundle(bundle);
     if (!options.skipValidate) {
-        await runBuildValidate({ file: bundlePath });
+        logStep("Validating bundle locally before upload");
+        await runBuildValidate({ file: options.file, logContext: false });
     }
+    else {
+        logVerbose("skipping local validation (--skip-validate)");
+        await assertBundleExists(bundle.absolutePath);
+    }
+    const bundleStat = await stat(bundle.absolutePath);
+    logVerbose(`bundle size: ${bundleStat.size} bytes`);
+    logStep("Uploading bundle to control plane API");
     const credentials = await requireCredentials();
     const api = createApi(credentials.api_key, credentials.api_base);
-    const build = await api.uploadBuild(projectId, bundlePath, options.message);
+    const build = await api.uploadBuild(project.projectId, bundle.absolutePath, options.message);
     console.log(`Uploaded build ${build.id}`);
     if (build.message) {
         console.log(`Message: ${build.message}`);

package/dist/commands/build/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/commands/build/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAA6B,MAAM,eAAe,CAAC;AAQ5E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B;IAE3B,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1B,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5E,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../../src/commands/build/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,OAAO,EACP,UAAU,GACX,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAA6B,MAAM,eAAe,CAAC;AAO5E,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA2B;IAE3B,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,CAAC,yCAAyC,CAAC,CAAC;QACnD,MAAM,gBAAgB,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,6CAA6C,CAAC,CAAC;QAC1D,MAAM,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACnD,UAAU,CAAC,gBAAgB,UAAU,CAAC,IAAI,QAAQ,CAAC,CAAC;IAEpD,OAAO,CAAC,uCAAuC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,WAAW,CACjC,OAAO,CAAC,SAAS,EACjB,MAAM,CAAC,YAAY,EACnB,OAAO,CAAC,OAAO,CAChB,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,kBAAkB,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC"}