Skip to content

release: prepare v1.7.2#89

Merged
gaelic-ghost merged 6 commits into
mainfrom
maintenance/codex-schema-refresh
Jun 10, 2026
Merged

release: prepare v1.7.2#89
gaelic-ghost merged 6 commits into
mainfrom
maintenance/codex-schema-refresh

Conversation

@gaelic-ghost

@gaelic-ghost gaelic-ghost commented Jun 10, 2026

Copy link
Copy Markdown
Owner

Release

  • prepares v1.7.2 from branch maintenance/codex-schema-refresh
  • keeps protected main updates behind pull request review and CI
  • release tag v1.7.2 will be created after CI and the review-comment gate pass, so failed or still-discussed release candidates do not get tagged

Review Loop

Before merge and tagging, scripts/repo-maintenance/release.sh watches CI and stops on review comments unless the maintainer has already addressed or resolved them and reruns with --review-comments-addressed.

@chatgpt-codex-connector

Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.
To continue using code reviews, you can upgrade your account or add credits to your account and enable them for code reviews in your settings.

@coderabbitai

coderabbitai Bot commented Jun 10, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@gaelic-ghost, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 42 minutes and 30 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7eaa1177-0bcf-4368-bb7e-c1a7eaa18247

📥 Commits

Reviewing files that changed from the base of the PR and between 25dea4d and e853aac.

📒 Files selected for processing (6)
  • README.md
  • Sources/ASBAppKit/ASBThreadSidebarView.swift
  • Sources/SwiftASB/History/ThreadHistoryStore.swift
  • Sources/SwiftASB/Public/CodexAppServer+Compatibility.swift
  • Sources/SwiftASB/Public/CodexAppServer+WireMapping.swift
  • Tests/SwiftASBTests/Public/CodexAppServerTests.swift
📝 Walkthrough

Walkthrough

This PR bundles multiple preparation tasks for SwiftASB v1.7.2: it transitions licensing from Apache 2.0 to PolyForm Noncommercial, updates Codex CLI compatibility window to 0.138.x, introduces a new AppKit thread sidebar UI, refactors ReasoningEffort wire types, and updates release infrastructure to support checked-in release notes files.

Changes

SwiftASB v1.7.2 Release and Codex CLI 0.138.x Compatibility Update

Layer / File(s) Summary
Licensing Transition to PolyForm Noncommercial
COMMERCIAL-USE.md, CONTRIBUTING.md, LICENSE, LICENSE-APACHE-2.0, NOTICE, README.md, ROADMAP.md, Tools/AgentSB/pyproject.toml
Project adopts PolyForm Noncommercial License 1.0.0 for future public versions while archiving Apache 2.0 terms. New documents define commercial-use eligibility, licensing contact, and contribution acceptance requirements. Existing versions remain under prior Apache licensing.
Codex CLI Compatibility Window Update (0.137.x → 0.138.x)
Sources/SwiftASB/Transport/CodexCLIExecutableResolver.swift, scripts/generate-wire-types.sh, README.md, ROADMAP.md, docs/maintainers/interactive-lifecycle-release-boundary.md, Tests/SwiftASBTests/.../*, Tools/AgentSB/tests/*
The documented Codex CLI supported minor version is updated from 0.137.x to 0.138.x across the resolver constant, schema generation defaults, all documentation references, test fixtures, and compatibility assertions in multiple test suites.
Thread Sidebar UI Component
Sources/ASBAppKit/ASBThreadSidebarView.swift, Tests/ASBAppKitTests/ASBThreadSidebarViewTests.swift, docs/maintainers/presentation-ui-targets-plan.md
New ASBThreadSidebarView AppKit component consumes ThreadSidebarSnapshot snapshots and renders an outline view with sections and threads. ASBThreadSidebarAdapter manages the row tree from snapshot data. ASBThreadSidebarRow models section/thread rows with titles and subtitles. The view emits ThreadSidebarIntent for selection, open, and refresh actions. Tests verify snapshot mapping and intent emission.
ReasoningEffort Wire Mapping Refactor
Sources/SwiftASB/Public/CodexAppServer+Compatibility.swift, Sources/SwiftASB/Public/CodexAppServer+WireMapping.swift, Sources/SwiftASB/Public/CodexAppServer+CodexExtensions.swift, Tests/SwiftASBTests/Protocol/CodexAppServerProtocolTests.swift
ReasoningEffort enum wire conversion is refactored from CodexWireReasoningEffort enum-based mapping to String raw-value mapping with .unrecognized fallback for unknown values. Wire initializers accept String directly and the wireValue property returns String. Protocol tests expect effort values encoded as strings in JSON.
Release Tooling and v1.7.2 Preparation
README.md, ROADMAP.md, docs/releases/v1.7.2.md, scripts/repo-maintenance/lib/common.sh, scripts/repo-maintenance/release.sh, scripts/repo-maintenance/release/40-github-release.sh
Release version bumped to 1.7.2 in version strings and dependency examples. New github_release_notes_file helper resolves release-notes file paths from tag names. Release scripts now conditionally use --notes-file when local markdown exists, otherwise fall back to --generate-notes. Release notes document new sidebar UI, Codex CLI compatibility, and licensing transition.
Documentation Updates and Module Cleanup
Sources/ASBAppKit/ASBAppKitModule.swift, Tests/ASBAppKitTests/ASBAppKitModuleTests.swift, docs/maintainers/presentation-ui-targets-plan.md, docs/maintainers/v1-public-api-audit.md, docs/agents/reports/*
ASBAppKitModule scaffold is removed (test and empty implementation file). Maintainer documentation is updated: presentation-ui-targets-plan marks Slice 4 complete with ASBThreadSidebarView responsibilities, v1-public-api-audit updates baseline to v1.7.2. New agent-generated reports document schema diffs between 0.137.0 and 0.138.0 and candidate maintenance decisions.

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly Related PRs

  • gaelic-ghost/SwiftASB#76: Both PRs update Codex CLI compatibility window by changing CodexCLIExecutableResolver.Version.latestSupportedPublicRelease to a newer minor version with cascading test and documentation updates.
  • gaelic-ghost/SwiftASB#86: Both PRs modify the release script behavior for GitHub release creation via scripts/repo-maintenance/release/40-github-release.sh.
  • gaelic-ghost/SwiftASB#85: Both PRs directly update Codex CLI compatibility logic, including CodexCLIExecutableResolver.Version.latestSupportedPublicRelease and expected version strings in tests.

Suggested Labels

enhancement, documentation

Poem

🐰 A sidebar blooms, with threads neatly aligned,
PolyForm licensing guards what we've designed,
Codex CLI bumps to point-one-three-eight,
Wire types refined, and release scripts update their fate,
SwiftASB v1.7.2, prepared with care and refine!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%. Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'release: prepare v1.7.2' accurately describes the main objective—preparing the v1.7.2 release with documentation, licensing, code, and test updates.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch maintenance/codex-schema-refresh

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@coderabbitai coderabbitai 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.

Actionable comments posted: 4

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@README.md`:
- Line 26: Update the README statement that currently asserts "v1.7.2 is the
current and latest release" to avoid claiming an unshipped release—modify the
sentence containing "SwiftASB is actively maintained and supported by Gale" and
the `v1.7.2` reference to a qualified form such as "v1.7.2 is being prepared as
the next release" or remove the release claim entirely so documentation reflects
only shipped versions.

In `@Sources/ASBAppKit/ASBThreadSidebarView.swift`:
- Around line 238-282: ASBThreadSidebarRow is unnecessarily exported; make it
internal by removing the public access modifier from the class declaration and
its members so it is not part of the module's public API. Update the declaration
of ASBThreadSidebarRow (and its initializers init(section:) and init(item:),
properties id, kind, title, subtitle, threadItem, children, and the private
static subtitle(for:) helper if marked public) to use the default internal
visibility (remove "public"), keeping the class as final and `@MainActor` as-is.
Ensure no other files require it to be public before changing visibility.
- Around line 193-236: The ASBThreadSidebarAdapter and its exposed members
(e.g., ASBThreadSidebarAdapter class declaration, columnIdentifier, sections,
init, apply, flattenedRows, row(forThreadID:), numberOfChildren(of:),
child(_:of:), isExpandable(_:)) should be made internal to reduce the framework
API surface; change the class access from public to internal (remove public) and
likewise remove public from its properties and methods so only internal
visibility is used (keeping `@MainActor` and functionality unchanged).

In `@Sources/SwiftASB/Public/CodexAppServer`+WireMapping.swift:
- Around line 489-500: The wire mapping currently maps unknown inbound strings
to the sentinel case .unrecognized and then serializes that sentinel back as the
literal "unrecognized"; update the CodexAppServer.ReasoningEffort mapping so the
original unknown string is preserved instead of being lost: change the enum to
carry the original string for unknown values (e.g., unrecognized(String)),
update init(wireValue: String) and init?(wireValue: String?) to construct
.unrecognized(originalString) when the rawValue initializer fails, and update
var wireValue to return the original unknown string for the unrecognized case
(and the normal rawValue for known cases) so we never emit the literal
"unrecognized" onto the wire.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 27ac541e-9ab2-479c-8a65-4edeec763ef5

📥 Commits

Reviewing files that changed from the base of the PR and between 6891e19 and 25dea4d.

⛔ Files ignored due to path filters (1)
  • Sources/SwiftASB/Generated/CodexWire/Latest/CodexLifecycleV2Batch+JSONValue.swift is excluded by !**/generated/**
📒 Files selected for processing (33)
  • COMMERCIAL-USE.md
  • CONTRIBUTING.md
  • LICENSE
  • LICENSE-APACHE-2.0
  • NOTICE
  • README.md
  • ROADMAP.md
  • Sources/ASBAppKit/ASBAppKitModule.swift
  • Sources/ASBAppKit/ASBThreadSidebarView.swift
  • Sources/SwiftASB/Public/CodexAppServer+CodexExtensions.swift
  • Sources/SwiftASB/Public/CodexAppServer+Compatibility.swift
  • Sources/SwiftASB/Public/CodexAppServer+WireMapping.swift
  • Sources/SwiftASB/Transport/CodexCLIExecutableResolver.swift
  • Tests/ASBAppKitTests/ASBAppKitModuleTests.swift
  • Tests/ASBAppKitTests/ASBThreadSidebarViewTests.swift
  • Tests/SwiftASBTests/Protocol/CodexAppServerProtocolTests.swift
  • Tests/SwiftASBTests/Public/CodexAppServerLiveIntegrationTests.swift
  • Tests/SwiftASBTests/Public/CodexAppServerTestSupport.swift
  • Tests/SwiftASBTests/Public/CodexAppServerTests.swift
  • Tests/SwiftASBTests/Transport/CodexCLIExecutableResolverTests.swift
  • Tools/AgentSB/pyproject.toml
  • Tools/AgentSB/tests/test_cli.py
  • Tools/AgentSB/tests/test_tools.py
  • docs/agents/reports/2026-06-09-agentsb-maintenance-draft.md
  • docs/agents/reports/2026-06-09-agentsb-schema-review.md
  • docs/maintainers/interactive-lifecycle-release-boundary.md
  • docs/maintainers/presentation-ui-targets-plan.md
  • docs/maintainers/v1-public-api-audit.md
  • docs/releases/v1.7.2.md
  • scripts/generate-wire-types.sh
  • scripts/repo-maintenance/lib/common.sh
  • scripts/repo-maintenance/release.sh
  • scripts/repo-maintenance/release/40-github-release.sh
💤 Files with no reviewable changes (2)
  • Tests/ASBAppKitTests/ASBAppKitModuleTests.swift
  • Sources/ASBAppKit/ASBAppKitModule.swift

Comment thread README.md Outdated
Comment thread Sources/ASBAppKit/ASBThreadSidebarView.swift
Comment thread Sources/ASBAppKit/ASBThreadSidebarView.swift
Comment thread Sources/SwiftASB/Public/CodexAppServer+WireMapping.swift Outdated
@gaelic-ghost gaelic-ghost merged commit 62dc85d into main Jun 10, 2026
2 checks passed
@gaelic-ghost gaelic-ghost deleted the maintenance/codex-schema-refresh branch June 10, 2026 02: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