v3.1.1 Jacobean Released

[waleedkadous]

v3.1.1 Jacobean is now on npm and GitHub.

npm install -g @cluesmith/codev@3.1.1
afx tower stop && afx tower start

First minor on the new Jacobean line. Bundles four substantial threads since v3.0.7:

Multi-architect routing — actually works now (#774)

The headline value prop of sibling architects ("a builder spawned by ob-refine, when it sends to architect, reaches ob-refine") was non-functional from v3.0.5 through v3.0.7 — every builder→architect message routed to main regardless of which sibling spawned the builder. Reported by an external adopter within hours of v3.0.7's install. Root cause: a singleton DB handle opened the worktree's empty state.db instead of the workspace's. Fixed; verified end-to-end on a real two-architect workspace.

Multi-architect lifecycle, persistence, and UX (#786)

• afx workspace remove-architect <name> is now a first-class CLI; refuses to remove main.
• Sibling architects survive afx workspace stop/start (race-free via PtySession exit-await).
• Identity preservation: CODEV_ARCHITECT_NAME is re-injected on shellper auto-restart.
• afx status enumerates all architects with PID + terminal ID.
• Dashboard sibling tabs have a close button + confirmation modal; VSCode Architects tree has right-click Remove (main excluded).
• Mobile solo-architect tab label restored to "Architect" (Mobile: solo-architect tab label regresses from 'Architect' to 'main' after #762 #764).

Multi-architect coordination (#823)

• Dashboard shows · <architect> attribution on builder cards when N>1.
• CLAUDE.md/AGENTS.md document all four addressing forms (architect:<name> spoofing-check, architect↔sibling-architect messaging, builder→spawning-architect affinity).
• Per-builder free-text thread file convention at codev/state/<builder-id>_thread.md.
• VSCode Architects tree auto-refreshes on CLI-side architect-add via new architects-updated SSE event.

VS Code extension — two substantial Amr rounds (#771, #779, #785)

• Per-builder changed files inline with SCM-style decorations + multi-file diff editor (Codev: View Diff).
• Accordion mode for Builders tree, live-status dot, count badge, "waiting on input" surfacing.
• Image paste (Cmd+Alt+V) into Codev terminals.
• Backlog dedup + inline send-issue-to-architect button.
• Open Dev URL rows + per-engineer .codev/config.local.json overrides.
• Workspace view live-refreshes on config edits.

Skipped versions

• v3.0.8 was built locally and verified end-to-end but never published — content was superseded by additional work that landed before the publish window opened. Tag exists on GitHub as a historical breadcrumb.
• v3.1.0 was briefly published as orphan dep-only packages under a since-rejected codename ("Jugendstil"). @cluesmith/codev itself never reached 3.1.0, so users see a clean 3.0.7 → 3.1.1 upgrade.

One TypeScript-facing change

OverviewBuilder.spawnedByArchitect is now a required field on @cluesmith/codev-types. Consumers that destructure overview builders may need to add ? to their local types until they catch up.

Full release notes

docs/releases/v3.1.1-jacobean.md

Contributors

External Codev consumer (Shannon) — surfaced the routing bug and drove the multi-architect coherence pressure. Amr Elsayed (@amrmelsayed) — two VS Code extension rounds. M Waleed Kadous (@waleedkadous) — architect review, integration CMAP discipline that caught the #786 race condition pre-merge.