codebyplan 1.5.0 → 1.8.0

package/README.md

@@ -12,7 +12,7 @@ This will:
 
 1. Prompt for your API key (get one at [codebyplan.com/settings/api-keys](https://codebyplan.com/settings/api-keys))
 2. Configure Claude Code to connect via remote MCP
-3. Optionally link a repository and run the first sync
+3. Optionally link a repository
 
 ## Commands
 
@@ -20,9 +20,28 @@ This will:
 
 Interactive setup wizard. Configures your API key and MCP server connection.
 
-### `codebyplan sync`
+### `codebyplan config`
 
-Bidirectional sync of `.claude/` infrastructure files between your local project and the CodeByPlan database.
+Sync repo configuration from the CodeByPlan database to `.codebyplan.json`. Updates `server_port`, `server_type`, `branch_config`, and `port_allocations`. Also runs the worktree self-heal to cache the active worktree ID in memory.
+
+**Options:**
+
+| Flag               | Description                                      |
+| ------------------ | ------------------------------------------------ |
+| `--path <dir>`     | Project root directory (default: cwd)            |
+| `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
+| `--dry-run`        | Preview changes without writing                  |
+
+**Example:**
+
+```bash
+codebyplan config
+codebyplan config --dry-run
+```
+
+### `codebyplan ports`
+
+Verify port allocations match local `package.json` dev scripts. Reports mismatches and unallocated apps. With `--fix`, auto-creates missing port allocations in the database.
 
 **Options:**
 
@@ -31,10 +50,34 @@ Bidirectional sync of `.claude/` infrastructure files between your local project
 | `--path <dir>`     | Project root directory (default: cwd)            |
 | `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
 | `--dry-run`        | Preview changes without writing                  |
-| `--force`          | Skip confirmation and conflict prompts           |
 | `--fix`            | Auto-create missing port allocations             |
 
-**Side effects:** writes `worktree_id` (UUID) at the top level of `.codebyplan.json`, used as a cached scope for workflow skills. See `.claude/rules/worktree-tagging.md`.
+**Example:**
+
+```bash
+codebyplan ports
+codebyplan ports --fix
+codebyplan ports --fix --dry-run
+```
+
+### `codebyplan tech-stack`
+
+Detect and sync tech stack dependencies from all `package.json` files in the project. Also runs the local config migration to move any legacy `worktree_id` from `.codebyplan.json` to the gitignored `.codebyplan.local.json`.
+
+**Options:**
+
+| Flag               | Description                                      |
+| ------------------ | ------------------------------------------------ |
+| `--path <dir>`     | Project root directory (default: cwd)            |
+| `--repo-id <uuid>` | Repository ID (default: from `.codebyplan.json`) |
+| `--dry-run`        | Preview changes without writing                  |
+
+**Example:**
+
+```bash
+codebyplan tech-stack
+codebyplan tech-stack --dry-run
+```
 
 ### `codebyplan help`