Skip to content

feat(advance): rename advance to go + TUI g keybinding#340

Merged
birdmanmandbir merged 4 commits intomainfrom
worker/b133a2be
Mar 20, 2026
Merged

feat(advance): rename advance to go + TUI g keybinding#340
birdmanmandbir merged 4 commits intomainfrom
worker/b133a2be

Conversation

@birdmanmandbir
Copy link
Contributor

Rename ttal task advance to ttal task go. Replace TUI x/r with g. Update all docs.

Renames the CLI command from `advance` to `go` to match the `g` TUI
keybinding added in the next commit. Updates all user-facing strings,
error messages, and test assertions. Internal types (AdvanceRequest etc.)
are unchanged.
Adds `g` → `keyAdvance` which calls `ttal task go`. Removes `x` (execute)
and `r` (route) keybindings and the route overlay (stateRouteInput, agent
picker, routeInput/routeMatches) since all pipeline advancement is now
handled by a single `g` key. Top navigation (formerly `g`) moves to
Home key; bottom remains `G`.
Replaces all user-facing occurrences of `ttal task route`, `ttal task execute`,
and `ttal task advance` with `ttal task go` across docs, templates, agent
identity files, skills, and Go source strings. Internal type names
(AdvanceRequest etc.) are unchanged.
@birdmanmandbir
Copy link
Contributor Author

PR Review — #340: TUI keybindings + ttal task go rename

Summary

Clean, thorough PR. The advancego rename is consistent across all ~40 files, the TUI route-input overlay is properly excised (no dangling references), and docs/templates are well-updated. One navigation regression was introduced by the g reassignment.


🔴 Critical Issue (1 found)

keyTop unreachable — "jump to top" navigation is silently broken
internal/tui/keymap.go:56,96

"g" was previously bound to keyTop (scroll to top). This PR reassigns it to keyAdvance without binding any replacement key for keyTop. The keyTop constant still exists (line 30) and its handler is still in model.go, but no key in keyMap produces it — the feature is dead code.

The help text at line 96 makes it worse:

G               Bottom (Home goes to top)

This claims Home jumps to top, but "home" is not in keyMap. The parenthetical is inaccurate.

Fix: Add "home": keyTop to keyMap to match the help text, or pick another key (e.g. vim-style "0"):

"home": keyTop,

✅ Strengths

  • Rename from cmd/advance.gocmd/go.go is clean: variable, Use, Long, examples, task.go registration, and test file all updated consistently
  • Route-input overlay (route_input.go, stateRouteInput, routeMatches, findAgentByRole, viewRouteOverlay, handleRouteKey, updateRouteMatches) cleanly removed — no orphaned call sites
  • Documentation sweep is thorough: README, CLAUDE.md, CLAUDE.user.md, RULE.md, all docs/, templates/, and skills/ files updated
  • task_detail.go hint correctly updated from x:execute r:route to g:advance
  • Test file renamed and updated to match new command name

VERDICT: NEEDS_WORK

One fix needed: bind "home" (or another key) to keyTop and correct the help text, or explicitly remove the keyTop dead code and the misleading "Home goes to top" note.

@birdmanmandbir
Copy link
Contributor Author

Triage Update

Fixed

  • keyTop unreachable / "Home goes to top" inaccurate — added "home": keyTop to keyMap and corrected help text to Home Top / G Bottomfixed in commit 2fe7efa

Verdict

One valid issue, one fix. All other aspects were LGTM per the review. Ready for re-review.

@birdmanmandbir
Copy link
Contributor Author

Re-review — fix commit 2fe7efa

Fixed

  • keyTop unreachable — "home": keyTop correctly added to keyMap; help text updated to Home Top / G Bottom — accurate and consistent

VERDICT: LGTM

Fix is minimal and precise. No new issues introduced. Full PR is good to merge.

@birdmanmandbir
Copy link
Contributor Author

Triage Update

LGTM — fix verified, merging.

@birdmanmandbir birdmanmandbir merged commit 907b030 into main Mar 20, 2026
1 check passed
@birdmanmandbir birdmanmandbir deleted the worker/b133a2be branch March 20, 2026 14:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant