Skip to content

v3.0.0-rc.10.md

Latest commit

 

History

History
76 lines (56 loc) · 4.32 KB

v3.0.0-rc.10.md

File metadata and controls

76 lines (56 loc) · 4.32 KB
Raw

v3.0.0-rc.10

Released: 2026-04-18

Summary

This RC folds in a major VS Code extension, a substantial rework of how builders are driven through the protocol (Spec 653), a monorepo restructure into standalone packages (@cluesmith/codev-core, @cluesmith/codev-types, dashboard), and a migration from npm to pnpm.

New Features

VS Code Extension (#672, Spec 0602)

A dedicated VS Code extension for Codev:

  • Unified Codev Sidebar — single sidebar view for builders, terminals, and workspace state
  • Terminal integration — builder terminals open directly in VS Code via TerminalLocation.Editor
  • Connection Manager + SSE client — auto-start Tower, auto-activate workspace on connect
  • Command Palette + keyboard shortcuts + status bar
  • Authentication baked into the extension

Better Handling of Builders (#674, Spec 653)

Substantial rework of the builder lifecycle:

  • Verify phase — new optional phase after review to run validation checks before merge
  • Multi-PR workflow — builders can push checkpoint PRs mid-protocol instead of only at the end
  • PR history tracking — status.yaml records every PR the builder has opened
  • Status commits at every phase transition — writeStateAndCommit commits and pushes status.yaml on every porch state change so architects can observe progress from main
  • Worktree path normalization — consistent handling of worktree paths across the toolchain
  • TICK protocol removed — folded into SPIR's verify phase

Hermes Consult Backend (#670, Spec 671)

  • Added Hermes as an optional consultation backend alongside Gemini, Codex, and Claude
  • Default consultation set remains 3 models; Hermes is opt-in

Simplified MAINTAIN Protocol

  • Reduced from 4 phases to 2 phases for faster codebase maintenance cycles

Improvements

  • Monorepo restructure: @cluesmith/codev-core and @cluesmith/codev-types extracted as standalone workspace packages; dashboard moved to standalone workspace member
  • npm → pnpm migration (#669): workspace now uses pnpm; added root build/test/local-install scripts
  • VS Code extension packaging fixes — icon path, metadata, version alignment
  • CI fixes — missing codev-core build step added to e2e and dashboard workflows; verify step fixed
  • License alignment — all package licenses set to Apache-2.0 to match root LICENSE
  • Pre-v3.0.0 maintenance (#675) — first MAINTAIN run on the new 2-phase protocol: dead deps removed (http-proxy), @xterm/xterm pinned explicitly, arch.md/AGENTS.md/lessons-learned.md synced

Bug Fixes

  • #680 — Gemini consult crashed on large PR diffs (>500KB) due to V8 heap exhaustion; fixed by bumping --max-old-space-size to 8192 and piping the prompt via stdin instead of argv (#681)
  • #676 — porch approve plan-approval failed with "Plan not found" when the plan lived in a builder worktree; artifact resolver now scopes to the worktree via a new getArtifactRoot helper (#679)
  • #677 — afx spawn --protocol maintain --force now works without an issue number (maintenance runs don't have GitHub issues) (#678)
  • #667 — E2E test updated to match dashboard-dist path after monorepo restructure (#668)
  • #664 — Dashboard reads issue number from DB instead of parsing builder name; workspace-scoped DB instead of singleton (#665)
  • Spec 653 — pr-exists excludes CLOSED-not-merged PRs; GitLab/Gitea fetch all states before filtering
  • Spec 653 — verify gate flow, gate creation, TICK cleanup fixes
  • Spec 0602 — Team visibility via workspace-scoped getOverview fetch
  • Spec 671 — porch next.test.ts properly handles hermes in 4-model validation

Breaking Changes

  • TICK protocol removed — projects using TICK must migrate to SPIR with the verify phase
  • .codev/config.json now gitignored — local-only configuration; each developer maintains their own

Migration Notes

  • Run pnpm install from the repo root (no longer npm install)
  • Build with pnpm build from root, or pnpm --filter @cluesmith/codev build
  • If you have a .codev/config.json committed, it will be replaced by a local untracked copy
  • VS Code extension installable from packages/vscode/*.vsix once built

Install

npm install -g @cluesmith/codev@next

Contributors

  • Human + AI collaboration via Codev