v2.0.10 Hagia Sophia

New Features

• af cron (Spec 399): Tower-resident cron scheduler for automated monitoring. Define YAML tasks in .af-cron/ that run on a schedule, evaluate conditions, and deliver messages to architect/builder terminals. Includes af cron list/status/run/enable/disable CLI commands.
• Typing-aware message delivery (Spec 403): af send now detects when a user is actively typing in a terminal and defers message delivery until they're idle, preventing disruption mid-thought. Messages are buffered up to 60s with a 3s idle threshold.
• Porch rollback (Bugfix #401): porch rollback command allows rewinding project phase when a builder gets stuck or goes down the wrong path.

Improvements

• Architect auto-restart (Bugfix #418): When the architect Claude session exits, it automatically restarts after 2 seconds — matching existing builder behavior.
• Dashboard "Needs Attention" (Bugfix #409): Replaced the Pull Requests section with a Needs Attention view showing items requiring architect action.
• Cross-workspace af send: Documented workspace:target syntax (e.g., af send marketmaker:architect "msg") for sending messages across workspaces.
• Flaky test fixes: Fixed CLI Integration Tests ENOTEMPTY teardown race on macOS with retry logic. Improved tower proxies requests to dashboard test stability with longer polling window.

Bug Fixes

• Fixed send-integration test port collision (Bugfix #411)
• Fixed cron workspace field name and DB enable priority

Install

npm install -g @cluesmith/codev@2.0.10

v2.0.3 Hagia Sophia

v2.0.3 Hagia Sophia

Released: 2026-02-15

Summary

Patch release with a major naming refactor (project → workspace), reliability improvements, and dead code cleanup. Total net reduction of ~4,000 lines.

New Features

• Spec 0108 - Porch Gate Notifications: Push-based af send from porch replaces broken poll-based gate watcher. Net -80 lines. (PR #272)
• Spec 0109 - Tunnel Keepalive: WebSocket ping/pong heartbeat (30s ping, 10s pong timeout) detects and auto-recovers silent connection drops after sleep/wake. 10 new unit tests. (PR #271)

Improvements

• Spec 0112 - Workspace Rename: All uses of "project" meaning "git repository" renamed to "workspace" across Tower, CLI, dashboard, and database. DB migration v9 renames project_path → workspace_path. +2360/-1826 across 100 files. (PR #276)
• Spec 0111 - Dead Vanilla Dashboard Removal: Deleted 16 dead template files from the pre-React dashboard. -4,614 lines. (PR #273)
• Bugfix #277 - Dead Code Cleanup: Removed codev-hq package, hq-connector, and unused utilities. -2,928 lines. (PR #278)

Bug Fixes

• Bugfix #266: codev init and codev adopt now correctly copy role files from skeleton (PR #267)
• Bugfix #269: PrismJS, marked, and DOMPurify bundled locally to avoid CSP blocks in document viewer (PR #270)
• Bugfix #274: Architect terminal no longer lost on Tower restart — fixed startup race between initInstances() and reconcileTerminalSessions(), added _reconciling guard (PR #275)

Documentation

• Added mobile web debugging guide (codev/resources/mobile-web-debugging.md)
• Added Spec 0115 draft (Consultation Metrics & Cost Tracking)

Breaking Changes

• DB migration v9: Automatically renames project_path → workspace_path columns. Rollback requires manual SQL.
• API paths changed: /project/ routes renamed to /workspace/ in Tower server

Migration Notes

Upgrade with:

npm install -g @cluesmith/codev@2.0.3
af tower stop && af tower start

Database migration v9 runs automatically on first Tower start. Existing terminal sessions will be preserved.

v2.0.2

Always show connect dialog when clicking Connect, pre-populated with existing tower name and server URL so users can review or change preferences before reconnecting.

v2.0.1

Fix cloud tunnel disconnecting immediately after registration. The config file watcher was firing a redundant reconnect that killed the working connection.

v2.0.0 Hagia Sophia

v2.0.0 Hagia Sophia

Released: 2026-02-14

Summary

Hagia Sophia marks the first major release of Codev since 1.0. Named after the architectural masterpiece in Istanbul — a building that has endured for 1,500 years by continuously reinventing itself while keeping its foundations solid — v2.0.0 brings a complete rearchitecture of the terminal system, Tower server decomposition, cloud connectivity, and a mobile-friendly dashboard. Like the great dome of Hagia Sophia, the new Shellper session manager provides a self-supporting structure that doesn't rely on external tools.

Highlights

• Shellper: Custom terminal session manager replaces tmux entirely
• Tower Cloud Connect: Register your Tower with codevos.ai from the web UI
• Tower Server Decomposition: Monolithic handler split into focused modules
• Mobile-Ready Dashboard: Full terminal access from phone and tablet
• Porch Protocol Orchestrator: State-machine-driven protocol execution with gates

New Features

Terminal Architecture (Specs 0081, 0094, 0104, 0106)

• Shellper session manager: Custom PTY manager replaces tmux — no external dependencies
• Web terminal access: Full terminal in the browser with xterm.js
• Session persistence: Reconnect to running sessions with output replay
• Mobile compaction: Touch-friendly virtual modifier keys, paste support
• Renamed from Shepherd to Shellper (shell + helper) for clarity

Tower Server (Specs 0085, 0090, 0097, 0098, 0099, 0105, 0107)

• Single daemon architecture: One Tower process manages all projects
• Server decomposition: Monolithic handler split into tower-routes, tower-instances, tower-terminals, tower-tunnel, tower-utils, tower-websocket
• Cloud tunnel client: Secure WebSocket tunnel to codevos.ai
• Cloud Connect UI: Register/disconnect from Tower homepage with OAuth flow
• Port registry removal: Simplified networking, no more port conflicts
• Codebase hygiene: Dead code removal, consistent patterns

Dashboard (Specs 0085, 0092, 0101)

• Full rewrite: React dashboard with file browser, terminal tabs, project management
• Clickable file paths: Terminal output file paths open in the file browser
• Terminal file links: Click paths in terminal output to view files
• Image paste support: Paste images directly into dashboard terminals

Protocol & Orchestration (Specs 0083, 0095, 0100, 0102, 0103)

• Porch protocol orchestrator: State machine drives SPIR, TICK, and BUGFIX protocols
• Gate notifications: Desktop notifications when builders reach approval gates
• Protocol-agnostic spawn: af spawn works with any protocol
• Porch worktree awareness: Correct CWD handling in builder worktrees
• Claude Agent SDK consultation: consult uses Claude's agent SDK

CLI Improvements

• af tower connect / af tower disconnect (renamed from register/deregister, aliases preserved)
• af spawn --resume to resume existing porch state
• af attach command for connecting to builder terminals
• Smart connect: reconnects without dialog when already registered

Bug Fixes

Over 30 bug fixes including:

• Terminal scrollback history preserved on reconnect (#247)
• Dashboard 404s when accessed via cloud tunnel (#222)
• Terminal garbled output from concurrent writes (#205)
• Copy-paste text rendering in dashboard (#203)
• Zombie builder tab removal (#199)
• Consult diff truncation crashes (#240)
• Tower auto-reconnect to cloud on config change (#242)
• Architect auto-restart on exit (#213)
• Review loop on false positives (#245)
• Stale temp directory projects in Tower UI (#202)

Infrastructure

• CI: 4-job pipeline — unit tests, Tower integration, CLI integration, package verification
• E2E tests: Playwright-based browser testing for Tower and dashboard
• Test stability: Fixed flaky E2E tests (temp directory filtering), vitest worker crash workaround

Breaking Changes

• tmux no longer required: Shellper handles all terminal sessions natively
• Single Tower port: All projects served from port 4100 (no per-project ports)
• Dashboard rewrite: Old dashboard HTML replaced with React SPA

Migration Notes

Upgrade with:

npm install -g @cluesmith/codev@2.0.0
af tower stop && af tower start

The first Tower start after upgrade will migrate the SQLite database automatically (v6/v7 migrations drop tmux columns, add shellper fields).

v2.0.0-rc.27

Bug Fixes

• Fix CSS loading through tower proxy: Dashboard CSS/JS now use relative paths so they load correctly when accessed via tower's reverse proxy
• Improve share dialog UX: Added cancel button and timeout message (30 seconds) so users know the dialog isn't stuck

Validation

Both fixes validated with Playwright tests:

• All 8 CSS files load with 200 status through proxy
• Share dialog shows cancel button and timeout message

v2.0.0-rc.26

Remove port numbers from tower UI - everything uses proxy paths now for tunnel compatibility.

v2.0.0-rc.25

CLI Restructuring

This release reorganizes commands for clarity and adds mobile access:

Command Changes

• af start → af dash start (project dashboard)
• af stop → af dash stop
• af tower moved under af (was codev tower)
• af util → af shell
• Removed: af kickoff (use af spawn), af tutorial, af web

Tower Improvements

• 📱 Share button: One-click QR code for mobile access (requires cloudflared)
• Reverse proxy: All project dashboards accessible through single tunnel URL
• Fixed emoji encoding in UI
• Simplified security (URL obscurity)

Documentation

All docs updated to reflect new command structure.

v2.0.0-rc.3

Allow af kickoff without spec file when porch state exists - enables starting from the SPECIFY phase

v2.0.0-rc.2

Fix porch CLI usage message to show 'porch' not 'codev porch'