OpenMay 25, 2026
No due date
•Last updated 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-tui → codewhale 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 ambiguousactive / runningwording 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/Yyank affordances (focused ID / full receipt). Copy-paste-friendly rows. Terminal-native throughout — no mouse dependency. - Goal mode (replaces the narrow
/goalcommand over time). Goal mode is a persistent objective surface — orthogonal to Plan / Agent / YOLO execution modes and to--model automodel 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./goalcontinues 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 doctornames 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.43to npm,deepseek-tui@0.8.43as a deprecation shim. Merge the web rebrand PR socodewhale.netserves canonical content anddeepseek-tui.com301-redirects. Docs domain flip. Follow-up PR for residualHmbown/DeepSeek-TUIURLs.
Out of scope
~/.deepseek/config directory rename (would break existing users; permanent anti-scope).- DeepSeek API env vars (
DEEPSEEK_API_KEYetc.) 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 autoor 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.43andcargo search codewhale-cliconfirm publishes.codewhale.net/roadmaprenders 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
0 issues of 25 selected
- Status: Open.#1884 In Hmbown/CodeWhale;
- Status: Open.#1190 In Hmbown/CodeWhale;
- Status: Open.#1439 In Hmbown/CodeWhale;
- Status: Open.#1862 In Hmbown/CodeWhale;
- Status: Open.#1269 In Hmbown/CodeWhale;
- Status: Open.#1147 In Hmbown/CodeWhale;
- Status: Open.#1830 In Hmbown/CodeWhale;
- Status: Open.#689 In Hmbown/CodeWhale;
- Status: Open.#1887 In Hmbown/CodeWhale;
- Status: Open.#1894 In Hmbown/CodeWhale;
- Status: Open.#1897 In Hmbown/CodeWhale;
- Status: Open.#1886 In Hmbown/CodeWhale;
- Status: Open.#1961 In Hmbown/CodeWhale;
- Status: Open.#1972 In Hmbown/CodeWhale;
- Status: Open.#1869 In Hmbown/CodeWhale;
- Status: Open.#1858 In Hmbown/CodeWhale;
- Status: Open.#1435 In Hmbown/CodeWhale;
- Status: Open.#861 In Hmbown/CodeWhale;
- Status: Draft (not ready).Hmbown/CodeWhalenumber 1875#1875 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1870#1870 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1859#1859 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1844#1844 In Hmbown/CodeWhale;
- Status: Open (in progress).Hmbown/CodeWhalenumber 1836#1836 In Hmbown/CodeWhale;
- Status: Open.#1976 In Hmbown/CodeWhale;