Skip to content

chat: settings says checker, no zero durations or byte counts, and help and manual match the screen - #1711

Merged
AbirAbbas merged 7 commits into
devfrom
abir/manual-help-truth-1001
Oct 1, 2026
Merged

AbirAbbas merged 7 commits into
devfrom
abir/manual-help-truth-1001

Conversation

@AbirAbbas

Copy link
Copy Markdown
Collaborator

What was wrong

These are small truth defects the re-verification pass over dev (feac16a48) found. All of them were already in v0.5.0.

  • /settings → Providers labelled the checking role with its internal id, auditor, a banned machinery word.
  • A thinking row said thought for 0s · 10 tok.
  • A senior-dev run in a plain folder printed 0 bytes across 3 file(s), although a plain folder produces no patch text to measure.
  • codeaf doc --help printed codeaf doc with no PATH.
  • The manual said codeaf --help prints the environment table (it points to codeaf help env).
  • The manual said there are nine settings tabs (there are ten, with Teams).
  • The manual said a launch with a key always opens on Home (a first launch with nothing elsewhere opens the chat's greeting).
  • The manual said an untitled manager gets an @manager-… handle (it is @<team>, or @lead for All teams).

What is true now

  • Settings calls the role checker everywhere, the way /crew does. A saved pin keeps the auditor id.
  • An unknown or sub-second thought duration draws nothing.
  • An unmeasured patch size draws nothing, and a measured one still prints its bytes.
  • codeaf doc --help reads codeaf doc PATH [--pages A-B], and every help page stays within 80 columns.
  • The manual pages say what the screen does. A corpus-wide guard in internal/manual/chatdisplaytruth_test.go keeps each stale sentence from coming back.

Proof

Each code item has a test that fails before the change (settings_role_words_test.go, thinking_duration_test.go, solo_patch_size_test.go, doc_help_test.go), plus tmux frames for the Settings label and the thinking row. No existing test was changed. An independent read-only review found two remaining manual mismatches, and the last commit fixes them.

🤖 Generated with Claude Code

AbirAbbas and others added 7 commits September 30, 2026 21:25
Settings exposed the internal checking role identifier on its row and model picker, and searching by the crew seat word did not find it. The row, search and picker now use checker from the crew seat vocabulary while persisted role pins and model resolution retain their identifiers.

Regression tests cover the rendered row, seat-word search and picker identity. The roles manual is updated in the final corpus commit of this wave because commands.md also carries the help and tab corrections.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
Settled thinking rows printed zero seconds and could derive a duration from an absent timestamp. Rows now omit a duration until at least one second has been measured, retain positive token estimates and the disclosure, and keep the existing rounded display for longer spans.

The duration-free sentence keeps the collapsed thought for wording required by the existing design tests. Deterministic timestamp cases and the manual describe that sentence and its zero-token form.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
The plain-folder snapshot recorder deliberately supplies no patch text, but senior-dev described that missing measurement as zero bytes. Candidate descriptions now show the changed files and tree without a byte size when no positive size exists, and continue to print measured positive sizes.

Regression tests use the real snapshot recorder and retain a positive-size control. The manual explains why a plain-folder ending has no byte count.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
The combined patch and doc synopsis left doc without a leading command line, so its own help fell back to the bare command name. Per-command help now reads each explicitly named command on a shared row separately, and doc help prints codeaf doc PATH [--pages A-B]. The front page keeps its compact shared row and existing line cap, and pipes in arguments or alternate forms remain intact.

The regression test reaches runDoc's help door, and the existing eighty-column law covers all help pages. The shell manual explicitly describes the corrected help output.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
…reen

The manual still promised the environment table in the main help page, omitted Teams from both tab lists, promised Home on every keyed launch and invented an untitled-manager handle. Each retrieved section now describes the running screen, quotes the current help footer and explains the team-name or lead fallback.

The roles section also calls the checking row checker to match the Settings correction in this wave. New corpus-wide stale-claim checks and positive section checks were appended without changing any existing test. CONTRACT.md records the observable behaviours and preserved design choices.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
…belongs to its submission receipt

The role table under /settings Providers still listed the checking role as auditor, which the screen no longer shows; it now says checker and notes that a saved pin keeps the old id. The senior-dev page credited the across-N-files wording to the run's ending, but that wording is the submission receipt's; the last line is the ending sentence. The corpus guard now also catches the old table row.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@AbirAbbas
AbirAbbas marked this pull request as ready for review October 1, 2026 02:05
@AbirAbbas
AbirAbbas merged commit df7022d into dev Oct 1, 2026
4 checks passed
@AbirAbbas
AbirAbbas deleted the abir/manual-help-truth-1001 branch October 1, 2026 02:05
@santoshkumarradha santoshkumarradha added the area:chat The v3 surface a person sits in front of (internal/tui3) label Oct 3, 2026
@santoshkumarradha santoshkumarradha added this to the Chat & connections milestone Oct 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:chat The v3 surface a person sits in front of (internal/tui3)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants