Skip to content

docs: collect unreleased maintenance notes - #3488

Merged
steipete merged 1 commit into
mainfrom
chore/phase-three-unreleased-notes
Sep 8, 2026
Merged

docs: collect unreleased maintenance notes#3488
steipete merged 1 commit into
mainfrom
chore/phase-three-unreleased-notes

Conversation

@steipete

@steipete steipete commented Sep 8, 2026

Copy link
Copy Markdown
Owner

Collect the user-visible timestamp fix from #3485 and compatible dependency updates from #3487 in one final Unreleased section, with contributor credit and a Highlights lead-in. Preserve the existing main entries, including the newly landed CLI login cancellation fix.

Land #3485, then #3487, then this notes PR. Keeping notes separate prevents unrelated additions to main’s changelog from conflicting with the dependency branch.

Validation: local documentation links and whitespace checks pass; independent P0–P2 review is clean. Released sections are unchanged. The underlying changes have complete local suites, built CLI/native app proof and independent reviews; #3485 and #3487 both have green exact-head CI. This notes-only PR passes its own exact-head CI, including both Linux builds and aggregate; macOS/musl use the documented skip.

This does not change the version, create a tag, or authorize publication. The broader issue/PR queue still needs another bounded pass before release preparation.

Keep the timestamp fix and dependency updates in one final notes PR, preserving the latest main entries. Land the code and dependency PRs before these notes.
@clawsweeper

clawsweeper Bot commented Sep 8, 2026

Copy link
Copy Markdown

🦞👀
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.

steipete added a commit that referenced this pull request Sep 8, 2026
Move the sole Unreleased additions to #3488 so independent main changelog edits do not conflict with the dependency branch. Production, tests, package pins and workflows are byte-for-byte unchanged from 3315604.
@clawsweeper

clawsweeper Bot commented Sep 8, 2026

Copy link
Copy Markdown

Codex review: blocked before merge. Reviewed September 7, 2026, 11:03 PM ET / September 8, 2026, 03:03 UTC.

ClawSweeper review

What this changes

Adds Unreleased highlights, Claude measurement-timestamp and Sparkle safety notes, contributor credit, and dependency maintenance versions.

Merge readiness

Blocked before merge - 3 items remain

Keep open: the notes remain useful, but the previously identified internal-only maintenance bullet still conflicts with release policy. This owner-authored PR is also protected from automatic closure.

Priority: P3
Reviewed head: b50b1ddb0135a4cae1598fe0585f59d212fe921b

Review scores

Measure Result What it means
Overall readiness 🐚 platinum hermit (4/6) A focused documentation patch with one small, previously identified release-policy correction.
Proof confidence 🌊 off-meta tidepool Not applicable: This owner-authored PR changes only changelog prose, so runtime proof is not required; the sibling PRs’ runtime claims do not substitute for reviewing their implementations.
Patch quality 🐚 platinum hermit (4/6) 1 actionable review finding remain.

Verification

Check Result Evidence
Real behavior Not applicable Not applicable: This owner-authored PR changes only changelog prose, so runtime proof is not required; the sibling PRs’ runtime claims do not substitute for reviewing their implementations.
Evidence reviewed 6 items Complete introduced diff: The pinned base-to-head diff contains eight additions exclusively in the Unreleased section of CHANGELOG.md; released sections and executable files are unchanged.
User-facing release contract: Lines 22–23 document that the changelog supplies GitHub and Sparkle release notes; line 110 explicitly excludes internal-only release bullets. The new maintenance bullet supplies package and CI versions without a user-visible outcome.
Prior finding remains unchanged: The prior completed review and inline review identify the same maintenance bullet. The earlier reviewed SHA equals the current checkout, and the comparison is empty. No supplied owner disposition waives the release-note rule.
Findings 1 actionable finding [P3] Remove internal-only version bookkeeping from release notes
Security None None.

How this fits together

CodexBar’s changelog supplies user-facing notes for GitHub Releases and Sparkle updates. This PR adds prose to the upcoming release section without changing application behavior or publication settings.

flowchart LR
  A[Implemented changes] --> B[Unreleased changelog]
  B --> C[Release preparation]
  C --> D[GitHub release notes]
  C --> E[Sparkle update notes]
  D --> F[Users]
  E --> F
Loading

Before merge

  • Remove internal-only version bookkeeping from release notes (P3) - This bullet will flow into GitHub Releases and Sparkle notes, but lists implementation and CI versions without a user-visible outcome. docs/RELEASING.md:110 explicitly excludes internal-only bullets. Remove this bullet and its otherwise empty Maintenance heading, retaining the separate Sparkle safety note. This remains the prior finding and was originally missed during the earlier review of this same unchanged head.
  • Resolve merge risk (P1) - The supplied snapshot shows both prerequisite PRs still open; landing these notes first would describe changes absent from the pinned main.
  • Complete next step (P2) - Remove the internal-only maintenance bullet and empty heading, then land after fix(claude): preserve claude-swap measurement timestamps #3485 and chore(deps): refresh compatible Swift packages and checkout action #3487 as requested by the owner.

Findings

  • [P3] Remove internal-only version bookkeeping from release notes — CHANGELOG.md:25-26
Agent review details

Security

None.

Review metrics

None.

Merge-risk options

Maintainer options:

  1. Decide the mitigation before merge
    Keep concise user-facing timestamp and updater-safety notes, omit internal version bookkeeping, and preserve the owner’s prerequisite landing order.
  2. Pause or close
    Do not merge this PR until maintainers decide whether the risk is worth taking.

Technical review

Best possible solution:

Keep concise user-facing timestamp and updater-safety notes, omit internal version bookkeeping, and preserve the owner’s prerequisite landing order.

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

Not applicable to runtime reproduction: the documentation defect is directly visible in the introduced bullet and the release-guide contract.

Is this the best way to solve the issue?

Yes, collecting the notes separately is a narrow solution once the internal-only maintenance bullet is removed and the prerequisite changes land.

Full review comments:

  • [P3] Remove internal-only version bookkeeping from release notes — CHANGELOG.md:25-26
    This bullet will flow into GitHub Releases and Sparkle notes, but lists implementation and CI versions without a user-visible outcome. docs/RELEASING.md:110 explicitly excludes internal-only bullets. Remove this bullet and its otherwise empty Maintenance heading, retaining the separate Sparkle safety note. This remains the prior finding and was originally missed during the earlier review of this same unchanged head.
    Confidence: 0.99
    Late finding: first raised on code an earlier review cycle already covered.

Overall correctness: patch is correct
Overall confidence: 0.97

AGENTS.md: found and applied where relevant.

Codex review notes: model internal, reasoning medium; reviewed against 9810f24b0609.

Labels

Label justifications:

  • P3: This is a bounded release-note cleanup with no executable behavior change.
  • rating: 🐚 platinum hermit: Overall readiness is 🐚 platinum hermit; proof is 🌊 off-meta tidepool and patch quality is 🐚 platinum hermit.
  • status: 👀 ready for maintainer look: ClawSweeper has no concrete contributor-facing blocker left for this PR. Not applicable: This owner-authored PR changes only changelog prose, so runtime proof is not required; the sibling PRs’ runtime claims do not substitute for reviewing their implementations.

Evidence

Acceptance criteria:

  • [P1] git diff --check.
  • [P1] node Scripts/check-documentation-links.mjs.
  • [P1] git diff -- CHANGELOG.md.

What I checked:

  • Complete introduced diff: The pinned base-to-head diff contains eight additions exclusively in the Unreleased section of CHANGELOG.md; released sections and executable files are unchanged. (CHANGELOG.md:5, b50b1ddb0135)
  • User-facing release contract: Lines 22–23 document that the changelog supplies GitHub and Sparkle release notes; line 110 explicitly excludes internal-only release bullets. The new maintenance bullet supplies package and CI versions without a user-visible outcome. (docs/RELEASING.md:110, b50b1ddb0135)
  • Prior finding remains unchanged: The prior completed review and inline review identify the same maintenance bullet. The earlier reviewed SHA equals the current checkout, and the comparison is empty. No supplied owner disposition waives the release-note rule. (CHANGELOG.md:26, b50b1ddb0135)
  • Dependent landing order: The owner explicitly requests fix(claude): preserve claude-swap measurement timestamps #3485 followed by chore(deps): refresh compatible Swift packages and checkout action #3487 before these notes. Both remain open in the supplied snapshot. Current pinned source still uses the poll time for Claude-swap projection and older dependency versions. Live GitHub refresh failed because the network endpoint was unreachable. (Sources/CodexBarCore/Providers/Claude/ClaudeSwap/ClaudeSwapAccountProjection.swift:218, b50b1ddb0135)
  • Area history and routing: Main-branch changelog history records recent work by Peter Steinberger, and release-guide history includes his release-validation and shared-release-tooling changes. Exact line blame could not complete because required historical blobs were unavailable; no introduction attribution is claimed. (CHANGELOG.md, 9810f24b0609)
  • Read-only validation: The whitespace check passed and the checkout remained clean. No builds, tests, provider probes, or bundled review helpers were executed. (CHANGELOG.md, b50b1ddb0135)

Likely related people:

  • steipete: Suggested for follow-up; no historical authorship or introduction is verified. (role: unverified routing candidate; confidence: low)

Rank-up moves

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

  • Remove the internal-only maintenance bullet and empty heading.

Rating scale

Score Internal tier Crab rank Meaning
6/6 S 🦀 challenger crab Exceptional readiness
5/6 A 🦞 diamond lobster Very strong readiness
4/6 B 🐚 platinum hermit Good normal PR; ordinary maintainer review
3/6 C 🦐 gold shrimp Useful, but confidence is limited
2/6 D 🦪 silver shellfish Proof or implementation needs work
1/6 F 🧂 unranked krab Not merge-ready
N/A NA 🌊 off-meta tidepool Rating does not apply

Overall follows the weaker of proof and patch quality.
Shiny media proof means a screenshot, video, or linked artifact directly shows the changed behavior. Runtime, network, CSP, and security claims still need visible diagnostics.

Workflow

  • ClawSweeper keeps one durable marker-backed review comment per issue or PR.
  • Re-runs edit this comment so the latest verdict, findings, and automation markers stay together instead of adding duplicate bot comments.
  • A fresh review can be triggered by eligible @clawsweeper re-review comments, exact-item GitHub events, scheduled/background review runs, or manual workflow dispatch.
  • PR/issue authors and users with repository write access can comment @clawsweeper re-review or @clawsweeper re-run on an open PR or issue to request a fresh review only.
  • Maintainers can also comment @clawsweeper review to request a fresh review only.
  • Fresh-review commands do not start repair, autofix, rebase, CI repair, or automerge.
  • Maintainer-only repair and merge flows require explicit commands such as @clawsweeper autofix, @clawsweeper automerge, @clawsweeper fix ci, or @clawsweeper address review.
  • Maintainers can comment @clawsweeper explain to ask for more context, or @clawsweeper stop to stop active automation.

History

Review history (2 earlier review cycles)
  • reviewed 2026-09-08T02:28:55.166Z sha b50b1dd :: blocked before merge. :: none
  • reviewed 2026-09-08T02:42:31.713Z sha b50b1dd :: blocked before merge. :: [P3] Remove internal-only version bookkeeping from release notes

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b50b1ddb01

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

Comment thread CHANGELOG.md
- Antigravity local usage: tolerate bookkeeping steps without UUIDs while retaining duplicate bot-ID ambiguity checks, so valid history remains available without assigning uncertain dates (#3462). Thanks @urda!

### Maintenance
- Update Commander to 0.2.4, swift-log to 1.15.0, swift-asn1 to 1.7.2, and the pinned checkout action to 7.0.1.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Remove internal-only dependency bumps from release notes

The release pipeline embeds this changelog section into Sparkle and GitHub release notes (docs/RELEASING.md:74), while the release checklist explicitly requires user-facing entries and says to omit script bumps (docs/RELEASING.md:110). Commander, swift-log, swift-asn1, and especially the pinned checkout action are implementation/CI maintenance with no user-visible outcome; remove this bullet or describe only an actual user-facing effect.

Useful? React with 👍 / 👎.

@steipete

steipete commented Sep 8, 2026

Copy link
Copy Markdown
Owner Author

Validation on b50b1ddb0135a4cae1598fe0585f59d212fe921b:

  • Only CHANGELOG.md changes: eight added Unreleased lines, with the latest main CLI-login entry preserved.
  • Released sections from 0.56.8 onward are byte-for-byte unchanged.
  • git diff --check and node Scripts/check-documentation-links.mjs pass (190 local links).
  • Independent local and committed-branch autoreview through P2 found no actionable issue.

The linked code/dependency changes carry their full local suites and real built-binary/app proofs. #3485 and #3487 are both green and land-ready on their final exact heads. This notes-only change follows the repository’s existing documentation CI path: macOS/musl skip, while both Linux builds and the aggregate remain required. Notes CI passed on the exact head, including both Linux builds and aggregate; macOS/musl skipped under the existing documentation policy.

Land #3485, then #3487, then this PR. No tag, version bump or release publication is included.

@clawsweeper clawsweeper Bot added P3 Low-risk cleanup, docs, polish, ergonomics, or speculative feature. rating: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. status: 👀 ready for maintainer look ClawSweeper has no concrete contributor-facing blocker left for this PR. labels Sep 8, 2026
steipete added a commit that referenced this pull request Sep 8, 2026
Update Commander, Sparkle, swift-log, swift-asn1 and checkout 7.0.1 within existing major constraints. Sparkle includes installer hardening. Keep release notes in #3488.

Closes no issue; no version or publication is included.
@steipete
steipete merged commit 1b7678f into main Sep 8, 2026
8 checks passed
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: 🐚 platinum hermit Good normal PR readiness with ordinary maintainer review expected. 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