Skip to content
Open
No due date
Last updated May 25, 2026

CodeWhale is a terminal-native workbench, not a chat transcript. v0.8.43 makes Brother Whale's state inspectable instead of mysterious (visible active work, last event, stall reason, evidence, decision cards, receipts), opens Goal mode as a persistent objective surface with Fin as a cheap wakeup/verifier, and lands the remaining registry publishes and URL flips that complete the deepseek-tuicodewhale rename.

In scope

  • Truth-surface UI primitives. Every "Working" state names the active operation, the last event timestamp, and a stall reason when stalled > 30s. Stuck-state explanations replace silent freezes. Resizable thinking blocks and thinking-preview controls (#1972). Active tool/job properties pane (#1884, #1862, #1830, #1269, #1190, #1147, #765, etc.). Active-state surfaces start using the project's orange / blue / white work-state palette (full theme pass lands in v0.8.48).
  • Tasks sidebar inspectability (#1975). Full / recoverable turn and task IDs (no mid-string ellipsis below the prefix needed for task_read/task_cancel). Replace ambiguous active / running wording with a state model the user can act on. Structured two-line recent-tool rows (status, name, duration on top; description / output below). Visible detail/expand path for truncated output. y / Y yank affordances (focused ID / full receipt). Copy-paste-friendly rows. Terminal-native throughout — no mouse dependency.
  • Goal mode (replaces the narrow /goal command over time). Goal mode is a persistent objective surface — orthogonal to Plan / Agent / YOLO execution modes and to --model auto model routing. The agent can ask clarifying questions when an objective is underspecified, plan its approach as a visible artifact, and keep working until complete, blocked, or explicitly stopped. Fin (the fast DeepSeek V4 Flash thinking-off seam) acts as a cheap wakeup/verifier — periodic binary-perspective check on whether the goal is actually done from tests, build, changed files, docs, install state, release gates, and user acceptance criteria. /goal continues to work as the current-goal command; Goal mode is the recommended surface for objective-driven sessions. Fin dispatches through the existing provider plumbing today and will inherit the v0.8.47 provider abstraction (including Hugging Face Inference Providers as a first-class backend) with no surface change.
  • Decision cards. When Brother Whale needs input (including clarifying questions from Goal mode), it surfaces a structured choice card (numbered options, default highlighted, explicit accept/decline) instead of a vague prompt. Decisions are logged.
  • Receipts. Every meaningful action ends with a receipt: what changed, what was tried, what evidence supports the claim. Model-asserted "done" always cites at least one tool result or file diff. Fin wakeup checks emit receipts too.
  • Doctor surfaces. codewhale doctor names the invoked command path correctly (codewhale vs deepseek shim) and the brand consistently.
  • Publish-out. Publish the 14 codewhale-* crates to crates.io (first-time), codewhale@0.8.43 to npm, deepseek-tui@0.8.43 as a deprecation shim. Merge the web rebrand PR so codewhale.net serves canonical content and deepseek-tui.com 301-redirects. Docs domain flip. Follow-up PR for residual Hmbown/DeepSeek-TUI URLs.

Out of scope

  • ~/.deepseek/ config directory rename (would break existing users; permanent anti-scope).
  • DeepSeek API env vars (DEEPSEEK_API_KEY etc.) and model IDs (refer to the DeepSeek API, not the TUI brand).
  • CNB mirror namespace, Homebrew tap rename, Docker image rename (later milestones).
  • New tool surface or capability work beyond truth-surface UI primitives, Goal mode, and publish-out.
  • Verifier-native completion hooks as default behavior (preview ships in v0.8.46; Fin wakeup in v0.8.43 is the Goal-mode-specific case, not the general verifier).
  • Renaming /model auto or treating it as an execution mode — it remains model routing, distinct from Plan / Agent / YOLO and from Goal mode.
  • Hugging Face Workset implementation (Hub API / model cards / datasets / adapters — see #1977). The HF provider integration lands in v0.8.47; the HF workset lands post-v0.9.0.

Definition of done

  • Stall reason and last-event surfaced in TUI for every long-running operation.
  • Tasks sidebar exposes full IDs, structured tool rows, an expand/inspect path, and at least one keyboard path to copy the focused ID or details (per #1975 acceptance criteria).
  • Goal mode ships as a persistent objective surface; agent asks clarifying questions when objectives are underspecified; Fin wakeup/verifier flags binary-incomplete states.
  • Decision cards used at every point where Brother Whale needs structured input.
  • Every completed task ends with a receipt that cites evidence.
  • npm view codewhale@0.8.43 and cargo search codewhale-cli confirm publishes.
  • codewhale.net/roadmap renders from the renamed feed.

Release gate

  • Parity gates green: cargo fmt --all -- --check, cargo clippy --workspace --all-targets --all-features --locked -- -D warnings, cargo test --workspace --all-features --locked.
  • CHANGELOG.md [0.8.43] entry written; contributor credits captured.
  • GitHub Release notes + npm shim publish (deepseek-tui@0.8.43) verified.
40% complete

List view