Skip to content

fix(console): call a deploying version deploying, not historical - #2990

Merged
freeqaz merged 2 commits into
mainfrom
fix-2065
Oct 20, 2026
Merged

freeqaz merged 2 commits into
mainfrom
fix-2065

Conversation

@freeqaz

@freeqaz freeqaz commented Oct 20, 2026 •

Copy link
Copy Markdown
Collaborator

Problem

Dogfood D660 (board finding 2065, low). Right after Deploy new version, the URL selects v2 while v1 is still the current version. Until the deployment completed (~30 s), v2's Configuration tab said "Historical version · read-only admitted snapshot. Browsing it does not change the current version." beside "Selected version v1", which reads as if the new version were old and the deploy had not happened.

Change

Console only (agents/detail.mjs); no API change.

  • While the newest version's deployment is queued or running and it is not the current version, its notice says "Deploying version · read-only admitted snapshot. It becomes the current version only if its deployment completes." Other versions keep "Historical version"; the current version keeps "Current version".
  • The deployment status poll updates the notice in place. It goes to "Current version" once the Agent reread after a success makes the version current, with no "Historical version" flash in between, and back to "Historical version" if the deployment fails. A Configuration tab that was parked while the status changed rereads its notice when shown again. An unchanged notice is not rewritten, so a poll still touches only what changed (finding 1598).
  • Selected version is unchanged: it is OCC's selection (activeRevisionId), and the summary already shows "Latest visible deployment v2 · In progress". A note there would move the overview when the deploy settles.
  • docs/guides/console/agent-details.md says so in one sentence (the file is at the docs word limit).
  • Storybook: new Pages/Agent detail → New version in progress, then current story; steps added to New version queued, New version in progress and Deployment fails while watching for the notice and Selected version.

Verification

Screenshots (real controller; v2 deploying, v1 current, v2's Configuration tab)

Before 1440 After 1440 Before 390 After 390

Risks

  • Low. Copy change keyed on the deployment status the page already reads. A reader who views the deploying version from another tab after the status read fails sees "Historical version" as before.

Right after Deploy new version the page selects the new version while the
previous one is still current, and its notice called it a Historical
version until the deployment completed (dogfood finding 2065). While the
newest version's deployment is queued or running and it is not current,
the notice now says it is deploying and becomes current only if the
deployment completes. Deployment polls update the notice, and leave it
untouched when unchanged.
@freeqaz
freeqaz requested a review from a team as a code owner October 20, 2026 01:48
@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. P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. 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. and removed clawsweeper:intake:bug Preliminary submission classification; full source review pending. clawsweeper:intake:needs-environment 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 labels the newest pending Agent version as Deploying and refreshes its notice as deployment state changes.

Example: v2 is deploying while v1 remains the selected version.

  • Before: v2's Configuration tab says Historical version.
  • After: It says Deploying version, then Current version after activation or Historical version after failure.

Review scores

Measure Result What it means
Overall readiness 🦪 silver shellfish (2/6) The focused implementation and regression coverage are strong; visual evidence demonstrates the static correction but does not satisfy the required recording gate.
Proof confidence 🦪 silver shellfish (2/6) Real behavior proof is not required for maintainer- or bot-authored pull requests.
Patch quality 🦞 diamond lobster (5/6) No actionable review findings were identified.

Product

Kind: Bug fix · Worth it: Yes · Fix scope: Complete
User problem: A newly deploying version appears historical beside the previously selected version, making a successful deployment request look ineffective.
Reason: This maintainer-authored correction makes existing deployment state understandable without changing the product contract.

Merge readiness

✅ Ready for maintainer review

This PR fixes misleading deployment wording that remains on main; the earlier Storybook finding is resolved, and no actionable code defects remain.

Priority: P3
Reviewed head: d12d5a018af616c5610f10ae68e28b8a0d9cd78d

Before merge

None.

Findings

None.

Tests

  • Missing end-to-end proof: Provide the required short UI recording showing Deploying becoming Current on success and Historical on failure, including return to the parked Configuration tab.
Agent review details

How this fits together

The Agent detail console reads version history, deployment records, and the Agent's selected revision to present version notices without claiming verified runtime health.

flowchart TB
  A[Agent API] --> C[Agent detail console]
  B[Deployment status API] --> C
  C --> D[Version notice]
  C --> E[Selected version summary]
Loading

Technical review

Best possible solution:

Keep the focused console fix and complete the repository-required visual evidence before merge.

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

Current-main source and the supplied before screenshots establish the incorrect Historical notice for deploying v2 while v1 remains current; no target code was executed during this review.

Is this the best way to solve the issue?

The patch uses existing deployment status and rendering owners, preserves selection and serving semantics, and adds focused coverage for success and parked-tab failure.

AGENTS.md: found and applied where relevant.

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

Provenance checked

  • Current and historical version notices keeps the original intent (7c3ecbf: Separate OCC selection, recorded deployment results, and unverified serving state.)
  • Retained console tabs keeps the original intent (3534179: Preserve loaded panels, controls, and drafts while rechecking access and dependencies on return.)
  • Deployment record refresh keeps the original intent (4cc112b: Keep the viewed deployment record synchronized with fresh activity reads.)

Testing

Proof path: shipped entry point.

Security

None.

Evidence

What I checked:

Likely related people:

  • Free Wortley: Raw commit 765417d adds apps/controller/src/console/agents/detail.mjs:1600 relative to its recorded parents. This identifies author metadata, not feature responsibility or a PR merger. (role: source-line author; confidence: high; commits: 765417d54a15; files: apps/controller/src/console/agents/detail.mjs)
  • stevenlee-oai: Raw commit 7c3ecbf adds apps/controller/src/console/agents/detail.mjs:621 relative to its recorded parents. This identifies author metadata, not feature responsibility or a PR merger. (role: source-line author; confidence: high; commits: 7c3ecbfce4fa; files: apps/controller/src/console/agents/detail.mjs)
  • kevinlin-openai: Raw commit 3534179 adds apps/controller/src/console/agents/detail.mjs:1258 relative to its recorded parents. This identifies author metadata, not feature responsibility or a PR merger. (role: source-line author; confidence: high; commits: 353417974c94; files: apps/controller/src/console/agents/detail.mjs)

Labels

Label changes:

  • add status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR.
  • remove status: ⏳ waiting on author: Current PR status label is status: 👀 ready for maintainer look.

Label justifications:

  • P3: This corrects transient, misleading wording while deployment controls and recorded state remain usable.
  • rating: 🦪 silver shellfish: Overall readiness is 🦪 silver shellfish; proof is 🦪 silver shellfish and patch quality is 🦞 diamond lobster.
  • 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.

  • Attach the required final-head UI walkthrough and screenshots showing the pending, successful, and failed version notices.

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 (1 earlier review cycle)
  • reviewed 2026-10-20T02:09:36.950Z sha bc667f5 :: needs changes before merge. :: [P3] Update the matching deployment Storybook scenarios

Reviewed October 19, 2026, 11:03 PM ET / October 20, 2026, 03:03 UTC (Revision 2).

…ash on success

A Configuration tab parked while its deployment failed came back saying
Deploying; it now rereads the notice when it is shown again. On success
the notice waits for the Agent reread instead of showing Historical until
the version becomes current. Storybook gains the in-progress-then-current
story and steps for the pending, running and failing stories. The guide
sentence is shortened to keep agent-details.md within the docs word limit.
@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. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. and removed 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. labels Oct 20, 2026
@freeqaz
freeqaz merged commit a70c9e5 into main Oct 20, 2026
68 checks passed
@freeqaz
freeqaz deleted the fix-2065 branch October 20, 2026 03:16
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: 🦪 silver shellfish Thin PR readiness signal; proof, validation, or implementation needs work. 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