codebyplan 1.13.21 → 1.13.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codebyplan",
-  "version": "1.13.21",
+  "version": "1.13.23",
   "description": "CLI for CodeByPlan — AI-powered development planning and tracking",
   "type": "module",
   "bin": {

package/templates/hooks/README.md

@@ -224,63 +224,13 @@ After a `complete_round` MCP call succeeds, reconciles the round's `files_change
 
 ---
 
-### `cbp-cmux-workspace-sync.sh` — SessionStart, matcher `*`
-
-On every session start, syncs the active [cmux](https://github.com/nicholasgasior/cmux) workspace title to the current git branch, the workspace description to the repo folder basename (the directory that contains `.git/`), and applies the workspace color from `.codebyplan/cmux.json` via `cmux workspace-action --action set-color`. All three actions are delegated to `codebyplan cmux-sync`. If no `workspace_color` is configured, a one-line nudge is printed to stdout prompting the user to run `/cbp-setup-cmux`.
-
-**Blocks vs warns**: never blocks — exit 0 on every path. A SessionStart hook must never prevent a session from opening.
-
-**Skips when**: `$CMUX_WORKSPACE_ID` is unset (not running inside a cmux workspace). No-ops silently — cmux is an optional integration and repos without it are completely unaffected.
-
-**cmux binary resolution order**: `$CMUX_BUNDLED_CLI_PATH` → `$CMUX_CLAUDE_HOOK_CMUX_BIN` → `cmux` on `$PATH`. All three are resolved by the `codebyplan cmux-sync` subcommand; the hook itself does not replicate this logic.
-
-**Opt out**: settings.json override removing this entry, or plugin disable.
-
----
-
-### `cbp-cmux-branch-watch.sh` — PostToolUse, matcher `Bash`
-
-After any Bash tool call that contains a `git checkout` or `git switch` invocation, syncs the active cmux workspace title to the current branch and the workspace description to the repo folder basename. The match is broad — it also fires on file-restore forms like `git checkout -- <file>` — but `codebyplan cmux-sync` is idempotent, so a redundant sync on a non-branch-change is harmless, and a real branch change is never missed.
-
-**Blocks vs warns**: never blocks — exit 0 on every path. PostToolUse hooks must never abort Claude.
-
-**Skips when**: `$CMUX_WORKSPACE_ID` is unset; or the Bash command contains no `git checkout` / `git switch`; or `jq` is not on `$PATH` (safe parse failure → exit 0). Outside cmux or on commands without checkout/switch, the hook exits immediately with no work done.
-
-**cmux binary resolution order**: same as `cbp-cmux-workspace-sync.sh` — delegated to `codebyplan cmux-sync`.
-
-**Opt out**: settings.json override removing the PostToolUse Bash entry for this hook, or plugin disable.
-
----
-
-### Auto dev server (`codebyplan cmux-serve`)
-
-At the start of each round, `cbp-round-execute` (Step 2a) calls `codebyplan cmux-serve --files "<round files>"` to auto-start the dev server for any app whose source files are touched. The subcommand probes each allocated port via `node:net`, starts a `cmux new-split` terminal pane + sends the dev command for any non-listening app, then opens a browser pane. If the port is already listening (another worktree) it only opens the browser pane. No hook registration is needed — the skill invokes the subcommand directly. Gated by `auto_dev_server` in `.codebyplan/cmux.json`; no-op outside cmux.
-
----
-
-### Status surface (`codebyplan cmux-status`)
-
-The lifecycle skills push CodeByPlan development state into the cmux workspace sidebar via `codebyplan cmux-status`. No hook registration is needed — the skills invoke the subcommand directly:
-
-| Skill | What is pushed |
-| --- | --- |
-| `cbp-task-start` (Step 4.5) | `--checkpoint "CHK-NNN: title" --task "TASK-N: title"` |
-| `cbp-task-complete` (Step 7.3) | `--task "TASK-N: title done" --progress completed/total` |
-| `cbp-round-execute` (Step 3d) | `--qa "R{n} {status}"` where status ∈ completed / blocked / re-triggering |
-
-**`auto_status` toggle.** Gated by the `auto_status` field in `.codebyplan/cmux.json` (configured via `/cbp-setup-cmux`). When `auto_status` is `false`, every call is a no-op. Default is `true` (enabled).
-
-**No-op outside cmux.** `codebyplan cmux-status` checks for `$CMUX_WORKSPACE_ID` before doing anything. Outside a cmux workspace it exits immediately — safe to call unconditionally from skills and hooks.
-
----
-
 ## Supporting (not registered)
 
 ### `test-hooks.sh` — invoked by `auto-test-hooks.sh`
 
-Test suite for the plugin's 11 registered hooks. Runs two passes:
+Test suite for the plugin's 9 registered hooks. Runs two passes:
 
-1. **Header check** — every registered hook (`lint-format-on-edit`, `test-coverage-gate`, `pre-commit-quality-gate`, `maestro-yaml-validate`, `auto-test-hooks`, `mcp-migration-guard`, `validate-git-stash-deny`, `cbp-mcp-round-sync`, `cbp-cmux-workspace-sync`, `cbp-cmux-branch-watch`) carries the required `# Hook:` and `# Purpose:` header comments. `statusline` uses its own `# Claude Code Status Line` marker.
+1. **Header check** — every registered hook (`lint-format-on-edit`, `test-coverage-gate`, `pre-commit-quality-gate`, `maestro-yaml-validate`, `auto-test-hooks`, `mcp-migration-guard`, `validate-git-stash-deny`, `cbp-mcp-round-sync`) carries the required `# Hook:` and `# Purpose:` header comments. `statusline` uses its own `# Claude Code Status Line` marker.
 2. **Functional smoke tests** — each hook is invoked with synthetic stdin matching its fast-path / graceful-degrade input; all must exit 0.
 
 Not in `hooks.json` — invoked indirectly via `auto-test-hooks.sh` on hook edits, or directly via `bash ${CLAUDE_PLUGIN_ROOT}/hooks/test-hooks.sh`.

package/templates/hooks/cbp-test-hooks.sh

@@ -255,77 +255,6 @@ fi
 
 echo ""
 
-# ===== HOOK SMOKE TESTS — cbp-cmux-workspace-sync + cbp-cmux-branch-watch =====
-echo "## Hook Smoke Tests — cbp-cmux-workspace-sync + cbp-cmux-branch-watch (CHK-162)"
-
-# --- cbp-cmux-workspace-sync.sh ---
-
-if [ ! -f "$HOOKS_DIR/cbp-cmux-workspace-sync.sh" ]; then
-  test_result "cbp-cmux-workspace-sync.sh present" "passed" "missing"
-else
-  test_result "cbp-cmux-workspace-sync.sh present" "passed" "passed"
-
-  FIRST_LINE=$(head -1 "$HOOKS_DIR/cbp-cmux-workspace-sync.sh")
-  if echo "$FIRST_LINE" | grep -q '^#!/'; then
-    test_result "cbp-cmux-workspace-sync.sh has shebang" "passed" "passed"
-  else
-    test_result "cbp-cmux-workspace-sync.sh has shebang" "passed" "missing"
-  fi
-
-  if grep -q '@scope: org-shared' "$HOOKS_DIR/cbp-cmux-workspace-sync.sh"; then
-    test_result "cbp-cmux-workspace-sync.sh has @scope: org-shared" "passed" "passed"
-  else
-    test_result "cbp-cmux-workspace-sync.sh has @scope: org-shared" "passed" "missing"
-  fi
-
-  # Graceful-degrade: CMUX_WORKSPACE_ID unset → fast-path exit 0, no output
-  ACTUAL_EXIT=$(env -u CMUX_WORKSPACE_ID bash "$HOOKS_DIR/cbp-cmux-workspace-sync.sh" <<< '{}' >/dev/null 2>&1; echo $?)
-  if [ "$ACTUAL_EXIT" = "0" ]; then
-    test_result "cbp-cmux-workspace-sync.sh graceful-degrade (no CMUX_WORKSPACE_ID) exits 0" "passed" "passed"
-  else
-    test_result "cbp-cmux-workspace-sync.sh graceful-degrade (no CMUX_WORKSPACE_ID) exits 0" "passed" "failed"
-  fi
-fi
-
-# --- cbp-cmux-branch-watch.sh ---
-
-if [ ! -f "$HOOKS_DIR/cbp-cmux-branch-watch.sh" ]; then
-  test_result "cbp-cmux-branch-watch.sh present" "passed" "missing"
-else
-  test_result "cbp-cmux-branch-watch.sh present" "passed" "passed"
-
-  FIRST_LINE=$(head -1 "$HOOKS_DIR/cbp-cmux-branch-watch.sh")
-  if echo "$FIRST_LINE" | grep -q '^#!/'; then
-    test_result "cbp-cmux-branch-watch.sh has shebang" "passed" "passed"
-  else
-    test_result "cbp-cmux-branch-watch.sh has shebang" "passed" "missing"
-  fi
-
-  if grep -q '@scope: org-shared' "$HOOKS_DIR/cbp-cmux-branch-watch.sh"; then
-    test_result "cbp-cmux-branch-watch.sh has @scope: org-shared" "passed" "passed"
-  else
-    test_result "cbp-cmux-branch-watch.sh has @scope: org-shared" "passed" "missing"
-  fi
-
-  # Graceful-degrade: CMUX_WORKSPACE_ID unset → fast-path exit 0
-  ACTUAL_EXIT=$(env -u CMUX_WORKSPACE_ID bash "$HOOKS_DIR/cbp-cmux-branch-watch.sh" <<< '{"tool_input":{"command":"git checkout main"}}' >/dev/null 2>&1; echo $?)
-  if [ "$ACTUAL_EXIT" = "0" ]; then
-    test_result "cbp-cmux-branch-watch.sh graceful-degrade (no CMUX_WORKSPACE_ID) exits 0" "passed" "passed"
-  else
-    test_result "cbp-cmux-branch-watch.sh graceful-degrade (no CMUX_WORKSPACE_ID) exits 0" "passed" "failed"
-  fi
-
-  # Non-checkout command → no-op exit 0 (even with CMUX_WORKSPACE_ID set, non-checkout should skip sync)
-  ACTUAL_EXIT=$(CMUX_WORKSPACE_ID=test-ws bash "$HOOKS_DIR/cbp-cmux-branch-watch.sh" <<< '{"tool_input":{"command":"git status"}}' >/dev/null 2>&1; echo $?)
-  if [ "$ACTUAL_EXIT" = "0" ]; then
-    test_result "cbp-cmux-branch-watch.sh non-checkout command exits 0" "passed" "passed"
-  else
-    test_result "cbp-cmux-branch-watch.sh non-checkout command exits 0" "passed" "failed"
-  fi
-fi
-
-echo ""
-
 # ===== SUMMARY =====
 echo "=== TEST SUMMARY ==="
 echo -e "Passed: ${GREEN}$PASSED${NC}"

package/templates/hooks/hooks.json

@@ -1,16 +1,5 @@
 {
   "hooks": {
-    "SessionStart": [
-      {
-        "matcher": "*",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/cbp-cmux-workspace-sync.sh"
-          }
-        ]
-      }
-    ],
     "PreToolUse": [
       {
         "matcher": "Edit|Write|MultiEdit",
@@ -70,15 +59,6 @@
             "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/cbp-mcp-round-sync.sh"
           }
         ]
-      },
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "bash ${CLAUDE_PLUGIN_ROOT}/hooks/cbp-cmux-branch-watch.sh"
-          }
-        ]
       }
     ]
   }

package/templates/rules/todo-backend.md

@@ -9,7 +9,7 @@ paths:
 
 # Todo backend — queue contract, invariants, and writer obligations
 
-The todos queue is materialised by `apps/todo-worker` (CHK-122) and consumed by `/cbp-todo` + `mcp__codebyplan__get_next_action`. This rule documents what every contributor to the MCP write tools, the worker, or the SQL schema must respect.
+The todos queue is materialised by `apps/todo-worker` (CHK-122) and consumed by `/cbp-todo` (via `mcp__codebyplan__get_todos`). This rule documents what every contributor to the MCP write tools, the worker, or the SQL schema must respect.
 
 ## 1. Six workflow invariants — DB-layer guards, never bypassable
 
@@ -46,7 +46,7 @@ MCP write → enqueueTodoJob → todos_jobs (status='pending')
 
 ## 3. Priority sort_order bands
 
-The worker emits todos with these `sort_order` ranges. Lower = surfaces first in `get_next_action`.
+The worker emits todos with these `sort_order` ranges. Lower = surfaces first in the todo queue.
 
 | Band | sort_order | State |
 |------|-----------|-------|
@@ -59,7 +59,7 @@ The worker emits todos with these `sort_order` ranges. Lower = surfaces first in
 
 ## 4. Command + args mapping
 
-`get_next_action` returns one row mapping to one of these slash commands. The worker stamps `command` + `metadata.context` based on workflow state:
+The queue head (`get_todos` `rows[0]`) maps to one of these slash commands. The worker stamps `command` + `metadata.context` based on workflow state:
 
 | State | Command | Required context |
 |-------|---------|------------------|

package/templates/settings.project.base.json

@@ -61,19 +61,11 @@
       "Skill(cbp-standalone-task-create)",
       "Skill(cbp-standalone-task-start)",
       "Skill(cbp-standalone-task-complete)",
-      "mcp__codebyplan__accept_invite",
-      "mcp__codebyplan__change_role",
-      "mcp__codebyplan__create_launch",
-      "mcp__codebyplan__update_launch",
-      "mcp__codebyplan__delete_launch",
       "mcp__codebyplan__create_organization",
       "mcp__codebyplan__create_project",
       "mcp__codebyplan__create_repo",
       "mcp__codebyplan__delete_session_log",
       "mcp__codebyplan__delete_worktree",
-      "mcp__codebyplan__invite_member",
-      "mcp__codebyplan__remove_member",
-      "mcp__codebyplan__revoke_invite",
       "mcp__codebyplan__release_assignment",
       "Bash(codebyplan setup:*)",
       "Bash(npx codebyplan setup:*)",
@@ -126,7 +118,6 @@
       "Skill(cbp-round-input)",
       "Skill(cbp-round-start)",
       "Skill(cbp-session-start)",
-      "Skill(cbp-setup-cmux)",
       "Skill(cbp-setup-e2e)",
       "Skill(cbp-setup-eslint)",
       "Skill(cbp-ship-configure)",
@@ -145,10 +136,7 @@
       "mcp__codebyplan__get_eslint_presets",
       "mcp__codebyplan__get_eslint_repo_config",
       "mcp__codebyplan__get_file_changes",
-      "mcp__codebyplan__get_launch",
-      "mcp__codebyplan__get_launches",
       "mcp__codebyplan__get_library_doc_job",
-      "mcp__codebyplan__get_next_action",
       "mcp__codebyplan__get_repos",
       "mcp__codebyplan__get_rounds",
       "mcp__codebyplan__get_server_config",
@@ -159,7 +147,6 @@
       "mcp__codebyplan__get_task_templates",
       "mcp__codebyplan__get_tasks",
       "mcp__codebyplan__get_todos",
-      "mcp__codebyplan__get_work_plan",
       "mcp__codebyplan__get_worktrees",
       "mcp__codebyplan__list_tech_stack_sync_sessions",
       "mcp__codebyplan__get_chunk",
@@ -184,8 +171,6 @@
       "mcp__codebyplan__update_session_state",
       "mcp__codebyplan__create_worktree",
       "mcp__codebyplan__flag_stale_chunk",
-      "mcp__codebyplan__list_invites",
-      "mcp__codebyplan__list_members",
       "mcp__codebyplan__update_eslint_repo_config",
       "mcp__codebyplan__update_server_config",
       "mcp__codebyplan__update_task_template",
@@ -193,12 +178,6 @@
       "Bash(npx codebyplan whoami:*)",
       "Bash(codebyplan resolve-worktree:*)",
       "Bash(npx codebyplan resolve-worktree:*)",
-      "Bash(codebyplan cmux-sync:*)",
-      "Bash(npx codebyplan cmux-sync:*)",
-      "Bash(codebyplan cmux-status:*)",
-      "Bash(npx codebyplan cmux-status:*)",
-      "Bash(codebyplan cmux-serve:*)",
-      "Bash(npx codebyplan cmux-serve:*)",
       "Bash(codebyplan version-status:*)",
       "Bash(npx codebyplan version-status:*)",
       "Bash(codebyplan statusline:*)",

package/templates/skills/cbp-build-cc-settings/reference/cbp-permission-policy.md

@@ -31,7 +31,7 @@ Precedence is `deny > ask > allow`; arrays union across scopes (managed/user/pro
 
 - **Production-shipment skills**: `cbp-ship`, `cbp-ship-main`, `cbp-checkpoint-end` — these promote/deploy to production, so they prompt even in an otherwise auto-allowed setup.
 - **Lifecycle / state-transition skills**: `cbp-checkpoint-start`, `cbp-checkpoint-create`, `cbp-checkpoint-check`, `cbp-checkpoint-complete`, `cbp-round-update`, `cbp-session-end`, `cbp-task-complete`, `cbp-standalone-task-create`, `cbp-standalone-task-start`, `cbp-standalone-task-complete` — these open or close checkpoints, tasks, rounds, and sessions (advancing workflow state in the database), so they stop for explicit confirmation rather than running autonomously.
-- **Destructive / admin / external MCP tools**: `delete_session_log`, `delete_worktree`, `delete_launch`, `create_repo`, `create_launch`, `update_launch`, `release_assignment`, and the membership tools `invite_member`, `remove_member`, `change_role`, `accept_invite`, `revoke_invite`.
+- **Destructive / admin MCP tools**: `delete_session_log`, `delete_worktree`, `create_repo`, `release_assignment`. (The launch and member-admin tools were dropped from the MCP surface in CHK-180 — those concerns are web-app only now.)
 - **Mutating / external / clobber-risk CLI commands** (both prefixes): `setup`, `login`, `logout`, `upgrade-auth`, `config` (can overwrite committed `.codebyplan/` files), `branch` (rewrites branch config), `ship`, `claude` (`install`/`update`/`uninstall` overwrite `.claude/`).
 
 ### `deny` — unchanged

package/templates/skills/cbp-checkpoint-create/SKILL.md

@@ -20,7 +20,7 @@ Runs INLINE. This is the **mechanical** stage only: capture raw user input, infe
 
 ### Step 1: Check for Existing Checkpoint Data
 
-Source `repo_id` from `.codebyplan/repo.json`. If `$ARGUMENTS` contains a checkpoint number, or MCP `get_next_action` returns one, load it via MCP `get_checkpoints`. If the checkpoint already has `ideas[]` with descriptions, reuse `ideas[].description` (do not re-ask) and skip Step 2.
+Source `repo_id` from `.codebyplan/repo.json`. If `$ARGUMENTS` contains a checkpoint number, load it via MCP `get_checkpoints`. If the checkpoint already has `ideas[]` with descriptions, reuse `ideas[].description` (do not re-ask) and skip Step 2.
 
 ### Step 2: Get Checkpoint Description
 
@@ -113,6 +113,6 @@ Auto-trigger `/cbp-checkpoint-plan {NNN}` in the same context. This skill create
 ## Integration
 
 - **Runs inline**: mechanical setup only — no assessment, research, Q&A, plan, or tasks
-- **Reads**: MCP `get_next_action`, `get_checkpoints`; `.codebyplan/repo.json`, `.codebyplan/git.json`; `npx codebyplan resolve-worktree`
+- **Reads**: MCP `get_checkpoints`; `.codebyplan/repo.json`, `.codebyplan/git.json`; `npx codebyplan resolve-worktree`
 - **Writes**: MCP `create_checkpoint` (description-only ideas + deadline + optional worktree_id), `update_checkpoint` (branch_name)
 - **Triggers**: `/cbp-checkpoint-plan` (auto)

package/templates/skills/cbp-round-execute/SKILL.md

@@ -57,16 +57,6 @@ Read the plan from round context (`context.planner_output`). If no plan: `No app
 
 Read effective testing profile: `round.context.testing_profile_override` if set (user override for this round only), else `task.context.testing_profile` (set by planner Phase 4.8), else default `'web'`. Pass the effective profile to all per-wave `cbp-testing-qa-agent` spawns.
 
-### Step 2a: Auto-Dev-Server (cmux)
-
-Fire the dev-server hook at round-execution start. Self-no-ops outside cmux or when `auto_dev_server` is disabled in `.codebyplan/cmux.json`.
-
-```bash
-npx codebyplan cmux-serve --files "<comma-separated approved_plan.files_to_modify[].path>"
-```
-
-The subcommand reads `.codebyplan/server.json` `port_allocations[]`, resolves which apps' source dirs intersect the round's files, probes each allocated port, and starts a cmux terminal split + browser pane for any app not already serving. Idempotent — if the port is already listening it only opens the browser pane (mitigating the multi-worktree port collision).
-
 ### Step 3: Route Execution Path
 
 Inspect `approved_plan.files_to_modify[]` and `approved_plan.round_type`. Four execution paths exist; pick the one that matches BEFORE Step 3a/3b.
@@ -153,14 +143,6 @@ If the approved plan includes database schema changes, RLS policies, or type gen
 - `status: 'blocked'` → present blocker to user via AskUserQuestion, resolve, re-spawn executor with remaining work
 - Deliverables incomplete → re-spawn executor with remaining deliverables (max 3 re-triggers). After 3 re-triggers, save partial output and proceed.
 
-### Step 3d: Push cmux QA Status
-
-Push the round's QA outcome to the cmux workspace sidebar. Self-no-ops outside cmux or when `auto_status` is disabled. Status is one of: `completed`, `blocked`, or `re-triggering`.
-
-```bash
-npx codebyplan cmux-status --qa "R{round_number} {status}"
-```
-
 ### Step 4: Dev-Server Probe (rounds 2+, web/desktop profile)
 
 When `round_number >= 2` AND `testing_profile` is `'web'` or `'desktop'` AND `files_changed` contains any UI file, probe the dev server BEFORE cbp-testing-qa-agent spawns (saves a full agent spawn when the server is down).

package/templates/skills/cbp-session-end/SKILL.md

@@ -27,18 +27,21 @@ Always write a session log for this session — **even if empty**. `/cbp-session
 
 Snapshot the current next-action so the next `/cbp-session-start` (Step 4.5) can auto-resume. The handoff write-path + payload shape are specified inline here and in `/cbp-session-start` Step 4.5 (freshness gate).
 
-1. Call MCP `get_next_action({ repo_id, worktree_id })`.
-2. If the returned `command` is non-empty (active work in flight):
+1. Call MCP `get_todos({ repo_id, worktree_id })` and take the queue head `rows[0]` (rows are ordered by `sort_order`; `rows[0]` is the current next-action). The worker stamps `command`, `instructions`, `state`, and the entity ids `checkpoint_id` / `task_id` / `round_id` on every row.
+2. If `rows[0]` exists and its `command` is non-empty (active work in flight):
    ```yaml
    handoff:
-     command: <result.command> # e.g. "/cbp-round-update"
-     instructions: <result.instructions> # human-readable trigger reason
-     state: <result.state> # workflow state label
-     context: <result.context> # entity ids (checkpoint_id / task_id / round_id) used by freshness probe
+     command: <rows[0].command> # e.g. "/cbp-round-update"
+     instructions: <rows[0].instructions> # human-readable trigger reason
+     state: <rows[0].state> # workflow state label
+     context: # entity ids used by the Step 4.5 freshness probe
+       checkpoint_id: <rows[0].checkpoint_id>
+       task_id: <rows[0].task_id>
+       round_id: <rows[0].round_id>
      captured_at: <ISO now> # for entity-drift freshness comparison
      captured_session_log_id: <current session log id>
    ```
-3. If `command` is empty / idle / queue-empty: set `handoff = null` so the next session's probe falls through to `/cbp-todo`.
+3. If the queue is empty or `rows[0].command` is empty / idle: set `handoff = null` so the next session's probe falls through to `/cbp-todo`.
 4. Hold `handoff` in context for Step 1's `update_session_log` call below — it ships in the same write as `ended_at` and `summary`.
 
 Continuing Step 1:
@@ -157,7 +160,7 @@ You can close this window.
 ## Integration
 
 - **Triggered by**: user invocation (prompted by `/cbp-todo` when no work remains)
-- **Reads**: `.codebyplan/repo.json`, `.codebyplan/git.json` (`branch_config.production` for the Step 1.6 home-branch fast-forward), MCP `get_session_logs` (resolve current log), MCP `get_current_task`, MCP `get_rounds`, MCP `get_next_action` (Step 1.3 handoff snapshot); `npx codebyplan version-status` (Step 1.7 package-freshness gate)
+- **Reads**: `.codebyplan/repo.json`, `.codebyplan/git.json` (`branch_config.production` for the Step 1.6 home-branch fast-forward), MCP `get_session_logs` (resolve current log), MCP `get_current_task`, MCP `get_rounds`, MCP `get_todos` (Step 1.3 handoff snapshot — queue head `rows[0]`); `npx codebyplan version-status` (Step 1.7 package-freshness gate)
 - **Writes**: MCP `update_session_log` (with `ended_at` + `handoff` per TASK-2 alias surface; or `create_session_log` fallback), MCP `update_session_state` (deactivate)
 - **Spawns**: none
 - **Triggers**: none at the skill-contract level. Step 1.5 may invoke `/cbp-git-commit` inline on user approval; Step 1.7 may invoke `/cbp-git-commit` on the `newer:true AND guarded:false` update path (committing changed `.claude/` and `.codebyplan/` paths).

package/templates/skills/cbp-task-complete/SKILL.md

@@ -138,20 +138,6 @@ Skip the push only when nothing was committed in Step 5 AND `/cbp-merge-main` re
 
 Call `complete_task(task_id)`. The server resolves the caller's worktree identity from the JWT/ctx and enforces the mutate-lock (CHK-140 TASK-3 — `caller_worktree_id` input field removed). The server auto-clears `assigned_user_id` + `assigned_worktree_id` on the task; if this was the last sibling task, it also clears the parent checkpoint's assignment. (Per CHK-104 hard-lock.)
 
-### Step 7.3: Push cmux Status (task done + progress)
-
-Push completion status and checkpoint progress to the cmux workspace sidebar. Self-no-ops outside cmux or when `auto_status` is disabled.
-
-Compute progress from the `get_tasks` data already loaded by the routing step: `completed = count of tasks with status 'completed'`, `total = total task count for the checkpoint`. For standalone tasks (no checkpoint), omit `--progress`.
-
-```bash
-# Checkpoint-bound task:
-npx codebyplan cmux-status --task "TASK-{N}: {task-title} done" --progress {completed}/{total}
-
-# Standalone task:
-npx codebyplan cmux-status --task "TASK-{N}: {task-title} done"
-```
-
 ### Step 8: Run Cleanup + Migration (inline)
 
 Apply the `cleanup` skill inline to remove orphan references to deleted/modified files. Then apply `migration` to propagate renames/moves to consumers. Both run without sub-agent spawns. Skip cleanup if no deletions/modifications; skip migration if cleanup handled everything.

package/templates/skills/cbp-task-start/SKILL.md

@@ -228,14 +228,6 @@ Display context summary:
 - **Previous rounds**: [count] completed
 ```
 
-### Step 4.5: Push cmux Status
-
-Push the active checkpoint and task context to the cmux workspace sidebar. Self-no-ops outside cmux or when `auto_status` is disabled in `.codebyplan/cmux.json`.
-
-```bash
-npx codebyplan cmux-status --checkpoint "CHK-{NNN}: {checkpoint-title}" --task "TASK-{N}: {task-title}"
-```
-
 ### Step 5: Set Task Status
 
 Use MCP `update_task(task_id, status: "in_progress")`.

package/templates/skills/cbp-todo/SKILL.md

@@ -44,7 +44,7 @@ With `USER_ID` resolved, call MCP `get_todos({ repo_id, user_id, worktree_id })`
 
 - The head carries `command`, `instructions`, `state`, `metadata`, `worktree_id`, `checkpoint_id`, `task_id`.
 - The routing context (checkpoint/task) lives in **`rows[0].metadata`**.
-- `get_todos` is **pure-read** — `apps/todo-worker` is the sole regen authority. NEVER call `get_next_action` or `regenerate_todos_for_repo`.
+- `get_todos` is **pure-read** — `apps/todo-worker` is the sole regen authority. NEVER call `regenerate_todos_for_repo`.
 - Empty array, or `USER_ID` unavailable → go to Step 3 (empty-queue fallback).
 
 Queue `command` values may use the `/codebyplan:<name>` plugin-namespace form (e.g. `/codebyplan:round-start`); treat each as the matching `/cbp-<name>` skill for the Step 2 matrix.

package/templates/skills/cbp-todo/qa-regression.md

@@ -12,7 +12,7 @@ Repo under test: `2ff6d405-39c5-47b8-a6d1-59f998ac0537`. Resolve a real `user_id
 
 ## Preconditions
 
-- `get_todos` is the only Step 1 read — confirm no `get_next_action` / `regenerate_todos_for_repo` call remains (`grep -n 'get_next_action\|regenerate_todos_for_repo' SKILL.md` → no hits).
+- `get_todos` is the only Step 1 read — confirm no `regenerate_todos_for_repo` call remains (`grep -n 'regenerate_todos_for_repo' SKILL.md` → no hits).
 - Step 0 uses `resolve-worktree --json` and `whoami --json`.
 
 ## Scenario A — caller owns the work → auto-trigger

package/templates/hooks/cbp-cmux-branch-watch.sh

@@ -1,39 +0,0 @@
-#!/bin/bash
-# @scope: org-shared
-# Hook: PostToolUse Bash
-# Purpose: After a Bash tool call that contains a git checkout or git switch command,
-#          sync the active cmux workspace title to the current git branch and the
-#          workspace description to the repo folder basename.
-#          Delegates entirely to `codebyplan cmux-sync` — no cmux or git logic here.
-#          Matching is broad: it also fires on file-restore forms such as
-#          `git checkout -- <file>`. That is intentional — `codebyplan cmux-sync` is
-#          idempotent, so a redundant sync on a non-branch-change is harmless, and the
-#          broad match guarantees a real branch change is never missed.
-#          No-ops silently when CMUX_WORKSPACE_ID is unset or the command contains no
-#          checkout/switch. Exit 0 on every path — never blocks tool execution.
-
-# Fast-path: skip npx spawn when clearly not in a cmux workspace.
-[ -n "$CMUX_WORKSPACE_ID" ] || exit 0
-
-# Parse stdin — PostToolUse hooks receive JSON on stdin.
-# Guard against jq absence: if jq is not available the whole block is skipped.
-if command -v jq >/dev/null 2>&1; then
-  INPUT=$(cat 2>/dev/null || true)
-  CMD=$(echo "$INPUT" | jq -r '.tool_input.command // empty' 2>/dev/null)
-
-  # Run the sync when the command contains git checkout/switch. Broad match by design:
-  # also catches file-restore forms (e.g. `git checkout -- <file>`); cmux-sync is
-  # idempotent so a redundant sync is harmless, and a real branch change is never missed.
-  if ! echo "$CMD" | grep -qE 'git[[:space:]]+(checkout|switch)' 2>/dev/null; then
-    exit 0
-  fi
-else
-  # jq not available — drain stdin and skip.
-  cat >/dev/null 2>&1 || true
-  exit 0
-fi
-
-# Delegate to the CLI subcommand (self-no-ops when cmux binary is absent).
-npx codebyplan cmux-sync >/dev/null 2>&1 || true
-
-exit 0

package/templates/hooks/cbp-cmux-workspace-sync.sh

@@ -1,19 +0,0 @@
-#!/bin/bash
-# @scope: org-shared
-# Hook: SessionStart
-# Purpose: On session start, sync the active cmux workspace title to the current git branch
-#          and the workspace description to the repo folder basename.
-#          Delegates entirely to `codebyplan cmux-sync` — no cmux or git logic here.
-#          No-ops silently when CMUX_WORKSPACE_ID is unset (not inside a cmux workspace).
-#          Exit 0 on every path — never blocks session start.
-
-# Fast-path: skip npx spawn when clearly not in a cmux workspace.
-[ -n "$CMUX_WORKSPACE_ID" ] || exit 0
-
-# Drain stdin — SessionStart hooks receive JSON on stdin; we don't use it.
-cat >/dev/null 2>&1
-
-# Delegate to the CLI subcommand (self-no-ops when cmux binary is absent).
-npx codebyplan cmux-sync >/dev/null 2>&1 || true
-
-exit 0