Skip to content

fix(console): name versions and outcomes the same way on the agents list and agent page - #3012

Merged
freeqaz merged 8 commits into
mainfrom
fdr32-vocab
Oct 20, 2026
Merged

freeqaz merged 8 commits into
mainfrom
fdr32-vocab

Conversation

@freeqaz

@freeqaz freeqaz commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

Dogfood round 32 (finding 2093, D663): the Agents list shows the current version as a raw revision ID (rev_ff04ec12…1680ec) next to "v122 · succeeded", while the Agent page's stat row calls the same outcome "Completed". Deployment details and the version record say "succeeded"/"failed" in lower case.

Change

  • agents/list.mjs: the row's revisions read also finds the current version (it is on the first page in nearly every case; otherwise it is read on its own with GET …/revisions/<id>, beside the deployment status read), and Current version shows vN as soon as that lands. A current version the reader cannot read keeps the old ID link, and its 403 is remembered in the tab's denied reads like the Agent page's, so it is asked (and audited) once. One label map (outcomeLabel: Queued, In progress, Completed, Failed, Superseded, Stopped) names every recorded outcome.
  • agents/detail.mjs: the stat row, "Recorded status:" in Deployment details, "Recorded outcome:" on the version record and the hidden-newer note use the same map.
  • Tests: text expectations updated to the shared words; the phone list layout check now expects v1 in the body font; a new test covers both lookups.
  • Storybook: Latest deployment loading shows "Reading version…" then "v1"; Latest deployment access denied shows the short ID fallback; new Current version older than the first page (one version per page, the off-page read delayed 4 s) and Current version unreadable (that read refused) cover the direct read and the remembered 403. Latest deployment failed and the focus walkthrough use "v6" and "v7 · Failed". Each was checked by rendering the fixture frame in a browser.
  • docs/flows/platform-console.md traces currentRevision: the shared revisions page, the off-page read beside the deployment read, and deniedReadsFor. The page is 2124 words after docs(console): split near-cap console reference and flow pages #3013's split.
  • Synced with main: the overview tests' pendingDeploy keeps feat(console): move Share Agent into an Access tab #2999's Access tab entry and reads "Recorded status: In progress". The Versions list outcome badge from fix(console): mark the latest version's outcome and make the Versions list one tab stop #3006 now takes its words from outcomeLabel. The flow doc's plugin-picker sentences stay, because docs(console): split near-cap console reference and flow pages #3013 moved them out of this page. Console browser files: 380/380 on the merged head.

Verification

  • New test "Agents list names the current version by number in the page's outcome words" fails on main (current: 'rev_190765bc…de2cf8', deployment: 'v2 · succeeded') and passes with the fix; 20/20 at 2 CPUs. Its second half drops the current version from the revisions page and checks the direct read; its third denies that read and checks it is asked once across a reload (a mutant without the remember fails, 2 reads).
  • Touched browser files plus console-retained-revalidation and console.test green locally on the merged head.
  • prettier and eslint clean on touched files.

Media (fixture: teamb-codex with v1 current and v2 latest, teamb-helper with v1; then teamb-codex's v2 page):

before (main) after
agents-list-1440 vocab-before-agents-list-1440 vocab-after-agents-list-1440
agents-list-390 vocab-before-agents-list-390 vocab-after-agents-list-390
agent-1440-fold vocab-before-agent-1440-fold vocab-after-agent-1440-fold
agent-390-fold vocab-before-agent-390-fold vocab-after-agent-390-fold

Risks

… Agent page

The Agents list showed the current version as a raw revision ID and the
latest deployment as 'v122 · succeeded', while the Agent page called the
same outcome 'Completed' (finding 2093). The list now names the current
version by number, read with the row's versions (or on its own when it is
past the first page), and every outcome label comes from one map.
…land and remember its denial

The current version cell waited for the deployment status read and lost
its number when that read failed, and an unreadable current version was
read (and audited) again on every list view. The cell now fills from the
revisions read, the status read runs beside the current version read,
and a 403 on the current version is remembered like the Agent page's
denied reads (internal review).
@freeqaz
freeqaz requested a review from a team as a code owner October 20, 2026 05:11
@clawsweeper

clawsweeper Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

🦞👀
ClawSweeper picked this up.

Pull request received. I will update this pull request when review starts.

ClawSweeper review complete

ClawSweeper finished reviewing this revision. The review result is being finalized.

View the workflow run.

@clawsweeper clawsweeper Bot added clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-environment Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. and removed clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-environment Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. labels Oct 20, 2026
@clawsweeper

clawsweeper Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

Codex review: needs maintainer review before merge.

What this changes

This PR displays current Agent versions by number and shares deployment outcome labels across the Agents list and Agent page.

Example: teamb-codex has v1 current and v2 as its latest deployment.

  • Before: The list shows a shortened revision ID and “v2 · succeeded”.
  • After: The list shows “v1” and “v2 · Completed”, matching the Agent page.

Review scores

Measure Result What it means
Overall readiness 🦐 gold shrimp (3/6) The patch is focused and source-supported, with useful visual and browser evidence, but the required UI walkthrough and attachment gate remain unmet.
Proof confidence 🦐 gold shrimp (3/6) Real behavior proof is not required for maintainer- or bot-authored pull requests.
Patch quality 🐚 platinum hermit (4/6) No actionable review findings were identified.

Product

Kind: Bug fix · Worth it: Yes · Fix scope: Complete
User problem: Readers must reconcile raw revision IDs and different words for the same recorded deployment outcome across console pages.
Reason: The maintainer-authored direction offers clear user value through a small change to existing console owners.

Merge readiness

✅ Ready for maintainer review

Keep this PR open: it provides a focused console consistency improvement that main still lacks, and no introduced correctness defect was found.

Priority: P3
Reviewed head: 2ed6ecbfa51ab9d2232f38a1403a759046141205

Before merge

None.

Findings

None.

Tests

  • Missing end-to-end proof: The reported base-fail/head-pass browser regression supports the lookup, but the required attached walkthrough of list-to-Agent navigation and changed loading/refusal states is still absent.
Agent review details

How this fits together

The console reads Agent revision summaries and deployment records through existing authenticated API requests, then renders version links and recorded outcomes without claiming live serving health.

flowchart TB
  A[Agents list] --> B[Revision summary page]
  B --> C[Current version lookup]
  B --> D[Latest deployment record]
  C --> E[Version number or ID link]
  D --> F[Shared outcome labels]
  G[Agent page] --> F
Loading

Technical review

Best possible solution:

Land the shared labels and existing revision lookup with the repository-required visual evidence.

Do we have a high-confidence way to reproduce the issue?

Main's rendering code and the inspected before screenshots establish the inconsistent identifiers and outcome words; no target code was run during this review.

Is this the best way to solve the issue?

The patch reuses revision summaries, the existing exact-read endpoint and denied-read owner, while consolidating labels without changing API status values or serving-health semantics.

AGENTS.md: found and applied where relevant.

Codex review notes: model internal, reasoning medium; reviewed against 9c911b458a22.

Provenance checked

  • Current-version identifier on the Agents list changes intended behavior with a stated reason (unknown: Path-scoped git log -S and git log --follow reach unavailable creation contents, leaving the original raw-ID rationale unknown; this PR explains the replacement with user-facing version numbers.)
  • Deployment outcome wording and serving-health distinction keeps the original intent (7c3ecbf: The overview separates current version, recorded deployment work and unverified live serving; subsequent changes retain neutral superseded and stopped results.)
  • Paged revisions and retained-list loading keeps the original intent (2a55afc: Revision summaries avoid loading full history documents, while later retained-list changes keep row reads from blocking the list and prevent brief loading-text flashes.)

Testing

Proof path: shipped entry point.

Security

None.

Evidence

What I checked:

Labels

Label changes:

  • add rating: 🦐 gold shrimp: Overall readiness is 🦐 gold shrimp; proof is 🦐 gold shrimp and patch quality is 🐚 platinum hermit.
  • add status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR.
  • remove rating: 🦪 silver shellfish: Current PR rating is rating: 🦐 gold shrimp, so this older rating label is no longer current.
  • remove status: ⏳ waiting on author: Current PR status label is status: 👀 ready for maintainer look.

Label justifications:

  • P3: This is a limited console clarity improvement; existing Agent operations remain available.
  • rating: 🦐 gold shrimp: Overall readiness is 🦐 gold shrimp; proof is 🦐 gold shrimp and patch quality is 🐚 platinum hermit.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR.

Rank-up moves

Optional improvements that raise the rating; they are not merge blockers.

  • Upload native GitHub screenshots and a short walkthrough of the changed UI states, identifying the tested revision and environment.

Rating scale

6/6 🦀 challenger crab · 5/6 🦞 diamond lobster · 4/6 🐚 platinum hermit · 3/6 🦐 gold shrimp · 2/6 🦪 silver shellfish · 1/6 🧂 unranked krab. Overall follows the weaker of proof and patch quality; ✨ marks media proof (a screenshot, video, or linked artifact) that directly shows the changed behavior.

Workflow

ClawSweeper edits this one comment on every review. Comment @clawsweeper re-review for a fresh review only. Repair and merge execution lanes are retired.

History

Review history (2 earlier review cycles)
  • reviewed 2026-10-20T05:27:29.239Z sha eb56900 :: needs changes before merge. :: [P3] Add the changed version lookup states to Storybook | [P3] Document the new current-version read path
  • reviewed 2026-10-20T05:40:27.113Z sha 60c3ca3 :: needs changes before merge. :: none

Reviewed October 20, 2026, 2:22 AM ET / 06:22 UTC (Revision 3).

…ts Storybook states

The flow names currentRevision, its off-page read and the remembered 403.
Two duplicated plugin-picker sentences, which the console reference owns,
make room under the 2,500-word cap.
@freeqaz

freeqaz commented Oct 20, 2026

Copy link
Copy Markdown
Collaborator Author

@clawsweeper re-review

@clawsweeper

clawsweeper Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

🦞👀
Exact review queued.

Re-review progress:

@clawsweeper clawsweeper Bot added clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. and removed rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. labels Oct 20, 2026
@freeqaz

freeqaz commented Oct 20, 2026

Copy link
Copy Markdown
Collaborator Author

@clawsweeper re-review

@clawsweeper

clawsweeper Bot commented Oct 20, 2026 •

Copy link
Copy Markdown
Contributor

🦞👀
Exact review queued.

Re-review progress:

@clawsweeper clawsweeper Bot added clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-environment Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed rating: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. status: ⏳ waiting on author ClawSweeper has contributor-facing work open and is waiting for author action. clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-environment Preliminary submission classification; full source review pending. clawsweeper:intake:needs-repro Preliminary submission classification; full source review pending. labels Oct 20, 2026
@freeqaz
freeqaz merged commit b95bbbc into main Oct 20, 2026
78 of 79 checks passed
@freeqaz
freeqaz deleted the fdr32-vocab branch October 20, 2026 06:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. rating: 🦐 gold shrimp Decent PR readiness signal, but merge confidence is limited. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant