deepline 0.1.32 → 0.1.35

package/README.md

@@ -15,12 +15,12 @@ Wait for health: `curl http://localhost:3000/api/v2/health`
 ### Auth (one-time)
 
 ```bash
-bun sdk/bin/deepline-dev.ts auth register
+./cli-env sdk-worktree deepline auth register
 ```
 
 Opens browser for approval. Stores SDK CLI auth in `~/.local/deepline/<host-slug>/.env`.
 
-Check status: `bun sdk/bin/deepline-dev.ts auth status --json`
+Check status: `./cli-env sdk-worktree deepline auth status --json`
 
 ### Making changes
 
@@ -29,10 +29,13 @@ Edit any file in `sdk/src/` and re-run. No build step needed — `deepline-dev.t
 ```bash
 # Edit sdk/src/cli/commands/play.ts
 # Then immediately:
-bun sdk/bin/deepline-dev.ts play run --file my-play.play.ts --watch
+./cli-env sdk-worktree deepline plays run --file my-play.play.ts --watch
 ```
 
-The root `package.json` has an alias: `bun run deepline` does the same thing.
+The root `package.json` has an alias, `bun run deepline`, that runs the same
+source CLI without selecting a host. Use `./cli-env sdk-worktree deepline ...`
+for local app/worktree development so the binary and `DEEPLINE_HOST_URL` move
+together.
 
 ### When you need to build
 
@@ -49,28 +52,38 @@ cd sdk && bun run build    # or: npm run sdk:build from root
 
 | File                                 | Set by              | Contains                                  |
 | ------------------------------------ | ------------------- | ----------------------------------------- |
-| `~/.local/deepline/<host-slug>/.env` | SDK `auth register` | `DEEPLINE_ORIGIN_URL`, `DEEPLINE_API_KEY` |
+| `~/.local/deepline/<host-slug>/.env` | SDK `auth register` | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY`   |
+| `.env.deepline`                      | Developer/agent     | `DEEPLINE_HOST_URL`, `DEEPLINE_API_KEY`   |
+
+The SDK CLI env contract is only `DEEPLINE_HOST_URL` and `DEEPLINE_API_KEY`.
+Do not route the SDK CLI through `.env`, `.env.local`, or `.env.worktree`.
 
-`deepline-dev.ts` hard-sets `DEEPLINE_ORIGIN_URL=http://localhost:3000` so you never need to configure it manually for local dev.
+Config resolution order:
 
-Config resolution order: explicit options > env vars > checkout `.env.worktree` > SDK v2 `.env` > prod fallback.
+```text
+host: explicit SDK option -> DEEPLINE_HOST_URL -> nearest .env.deepline -> saved production auth -> https://code.deepline.com
+key:  explicit SDK option -> DEEPLINE_API_KEY -> matching nearest .env.deepline -> saved auth for the resolved host
+```
 
 ## CLI commands
 
 ```bash
-bun sdk/bin/deepline-dev.ts health
-bun sdk/bin/deepline-dev.ts auth register|status
-bun sdk/bin/deepline-dev.ts tools list|describe|execute
-bun sdk/bin/deepline-dev.ts plays run <file.play.ts> [--input '{}'] [--<input> value] [--watch]
-bun sdk/bin/deepline-dev.ts plays run <name> [--input '{}'] [--<input> value] [--watch]
-bun sdk/bin/deepline-dev.ts plays get <file.play.ts|name> [--json]
-bun sdk/bin/deepline-dev.ts plays versions --name <name> [--json]
-bun sdk/bin/deepline-dev.ts runs list --play <name> [--status failed] [--json]
-bun sdk/bin/deepline-dev.ts runs get <run-id> [--json]
-bun sdk/bin/deepline-dev.ts runs tail <run-id> [--json]
-bun sdk/bin/deepline-dev.ts runs stop <run-id> [--reason "..."] [--json]
-bun sdk/bin/deepline-dev.ts plays publish <play-file.ts|name> [--latest|--revision-id <id>] [--json]
-bun sdk/bin/deepline-dev.ts update
+./cli-env sdk-worktree deepline health
+./cli-env sdk-worktree deepline auth register
+./cli-env sdk-worktree deepline auth status
+./cli-env sdk-worktree deepline tools list
+./cli-env sdk-worktree deepline tools describe test_rate_limit
+./cli-env sdk-worktree deepline tools execute test_rate_limit --input '{"key":"stripe.com"}'
+./cli-env sdk-worktree deepline plays run my-play.play.ts --input '{}' --watch
+./cli-env sdk-worktree deepline plays run company-lookup --input '{}' --watch
+./cli-env sdk-worktree deepline plays get company-lookup --json
+./cli-env sdk-worktree deepline plays versions company-lookup --json
+./cli-env sdk-worktree deepline runs list --play company-lookup --status failed --json
+./cli-env sdk-worktree deepline runs get run_123 --json
+./cli-env sdk-worktree deepline runs tail run_123 --json
+./cli-env sdk-worktree deepline runs stop run_123 --reason "no longer needed" --json
+./cli-env sdk-worktree deepline plays publish my-play.play.ts --latest --json
+./cli-env sdk-worktree deepline update
 ```
 
 `tools describe` and `tools execute` are canonical. `tools get` and `tools run`