release: prepare v1.2.1

[gaelic-ghost]

Release

• prepares v1.2.1 from branch wire/codex-0-130-schema
• keeps protected main updates behind pull request review and CI
• release tag v1.2.1 was created locally before this PR so the reviewed release candidate is preserved exactly

Review Loop

Before merge, 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.

Summary by CodeRabbit

Release Notes

• New Features

  • Added API to list stored items within conversation turns with paging support
  • Added plugin hook summaries to plugin detail information
  • Added control over turn-list item detail level via new TurnItemsView option

• Deprecations

  • Deprecated per-directory extra skill roots parameter; use currentDirectoryPaths and forceReload instead

• Updates

  • Updated Codex CLI compatibility window to 0.130.x
  • Version bumped to v1.2.1

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

SwiftASB is updated to support Codex CLI v0.130.x schema with v1.2.1 baseline. Key changes include a new thread/turns/items/list RPC method for paginated turn item retrieval, plugin hook summaries in extension detail queries, deprecation of per-cwd skill roots, and wire-type mappings for the new data structures.

Changes

Codex CLI v0.130.x Schema Upgrade

Layer / File(s)	Summary
Release & Compatibility Baseline README.md, ROADMAP.md, Sources/SwiftASB/Transport/CodexCLIExecutableResolver.swift, docs/maintainers/*, scripts/*	Version bumped from v1.2.0 to v1.2.1; documented Codex CLI compatibility window advanced from 0.129.x to 0.130.x across all config, docs, and build scripts.
Protocol Wire Types Sources/SwiftASB/Protocol/CodexAppServerProtocol+Types.swift, Sources/SwiftASB/Protocol/CodexAppServerProtocol.swift	New RPC method threadTurnsItemsList added; CodexProtocolThreadTurnsListParams extended with optional itemsView wire parameter and corresponding CodingKeys entry; request/response encoder/decoder methods added.
Public API Data Contracts Sources/SwiftASB/Public/CodexAppServer+ThreadLifecycle.swift, Sources/SwiftASB/Public/CodexAppServer+CodexExtensions.swift	New TurnItemsView enum for controlling item detail level; ThreadTurnsListRequest extended with optional itemsView; new ThreadTurnsItemsListRequest and ThreadTurnsItemsPage request/response types; PluginDetail extended with hooks array; new PluginHookSummary type added.
Wire Mapping Sources/SwiftASB/Public/CodexAppServer+WireMapping.swift	Wire mapping initializers added for CodexWireTurnItemsView and CodexWireSortDirection; prior CodexProtocolThreadTurnsSortDirection initializer replaced.
Public API Implementation Sources/SwiftASB/Public/CodexAppServer.swift, Sources/SwiftASB/Public/CodexAppServer+CodexExtensions.swift	listThreadTurns updated to map itemsView to wire type; new listThreadTurnItems public method added to retrieve paginated turn items; skills/list enforces contract change by rejecting perCurrentDirectoryExtraUserRoots with invalidState error; PluginDetail wire mapping updated to populate hooks; new HookMetadata.EventName initializer maps from wire types.
Tests Tests/SwiftASBTests/Protocol/*, Tests/SwiftASBTests/Public/*, Tests/SwiftASBTests/Transport/*	Protocol encoding tests updated for itemsView parameter; new test for thread/turns/items/list encoding; skills/list tests updated to remove and verify absence of perCwdExtraUserRoots; new rejection test for removed parameter; FakeCodexAppServerTransport extended with configurable threadTurnsItemsListResult; unit, integration, and resolver tests updated to expect 0.130.x compatibility; new listsStoredTurnItems test verifies end-to-end functionality.
Documentation & Build Sources/SwiftASB/SwiftASB.docc/CodexExtensions.md, scripts/generate-wire-types.sh, docs/maintainers/v1-public-api-symbol-inventory.md	DoCC documentation updated to describe plugin hooks in extension detail reads; PluginHookSummary added to topic list; build script extended to generate ThreadTurnsItemsListParams and ThreadTurnsItemsListResponse wire types; symbol inventory refreshed.

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~45 minutes

Suggested labels

enhancement

Poem

🐰 A new release hops into view,
With thread items fetched, and hooks so true,
Schema 0.130 brings fresh delight,
Per-cwd skills fade into the night,
v1.2.1 bounds forward bright!

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 9.68% 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.2.1' accurately and concisely describes the main objective of the PR, which is preparing version 1.2.1 for release.
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 docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch wire/codex-0-130-schema

---

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