Sync docs & markdown for the 1.0.0-beta.2 release

[leogdion]

Summary

Brings all prose docs in line with the API surface shipped since 1.0.0-beta.1 (subscriptions, APNs tokens, modifyZones, assets/rereference, auto-chunking conveniences, ambiguous-scalar tagging, MistDemo rebuild), ahead of tagging 1.0.0-beta.2. Markdown-only — no source changes.

Changes

• ReleaseNotes.md — new ## 1.0.0-beta.2 section above beta.1, grouped by area, with the beta.1...beta.2 compare link.
• README.md — roadmap reconciled: shipped endpoints (assets/rereference Referencing Existing Assets (assets/rereference) #31, zones/modify Modifying Zones (zones/modify) #45, subscriptions Fetching Subscriptions (subscriptions/list) #49–51, tokens Creating APNs Tokens (tokens/create) #52–53, users lookup Fetching Users by Email (users/lookup/email) #34/Fetching Users by Record Name (users/lookup/id) #35) moved into a checked ### v1.0.0-beta.2 section; the stale ### v1.0.0-alpha.X heading renamed to ### Backlog / Post-beta with only genuinely-unshipped items. Install bumped to from: "1.0.0-beta.2". Added brief Usage snippets for the new operations + auto-chunking conveniences.
• CLAUDE.md — new ## Examples section featuring BushelCloud as the canonical pattern demo (closes Documentation: Reference Bushel in CLAUDE.md Examples section #174; corrected the issue's stale Examples/Bushel/ path to Examples/BushelCloud/), plus CelestraCloud and MistDemo.
• Examples/CelestraCloud/CHANGELOG.md — stale MistKit 1.0.0-alpha.3 dependency reference → v1.0.0-beta.2.

Verification

• Roadmap no longer lists any shipped op as unchecked (grep clean).
• Remaining beta.1/alpha strings are all intentional historical refs (section headers, PR links, compare URLs).
• Every new code snippet matches the actual signatures in Sources/.

Deliberately out of scope

• © 2025 copyright drift (65 files under Tests/+Examples/, which lint.sh doesn't cover) — handled directly in the CelestraCloud repo / chore: update CelestraCloud test copyright headers 2025 → 2026 #331, since it spans subrepos with their own header identity.
• Examples/BushelCloud/.claude/migration-to-bushelkit.md still cites 1.0.0-alpha.3 in two spots, but those are historical migration snippets and BushelCloud builds via a local path dependency (no version pin) — left as-is.

Follow-up

The CelestraCloud CHANGELOG edit will need a git subrepo push to reach the standalone repo.

Closes #174

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 730317dd-0670-4c06-a6c8-85cf121ab207

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/sync-beta.2

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[leogdion]

Is everything done but sharing?

[leogdion]

Not quite — sharing isn't the only thing left here. I checked each unchecked item against the actual surface on this branch:

• File Apple Feedback Assistant report: discoverAllUserIdentities returns HTTP 500 #28 — GET users/discover: still unshipped. The shipped discoverAllUserIdentities(lookupInfos:batchSize:) is the chunked POST variant; the no-arg address-book GET form remains unavailable (pending File Apple Feedback Assistant report: discoverAllUserIdentities returns HTTP 500 #28).
• Fetching Contacts (users/lookup/contacts) #33 — users/lookup/contacts: the endpoint is in openapi.yaml and lookupContacts is generated into MistKitOpenAPI, but there's no curated CloudKitService wrapper yet. (closest to done — only the wrapper is missing)
• Fetching Record Information (records/resolve) #41 — records/resolve: not in the spec, no method.
• Accepting Share Records (records/accept) #42 — records/accept (sharing): not in the spec, no method.
• Fetching Database Changes (changes/database) #46 — changes/database: not in the spec, no method.
• Fetching Record Zone Changes (changes/zone) #47 — changes/zone: distinct from the shipped fetchZoneChanges, which hits /zones/changes and returns changed zones (meta-sync), not record changes within a zone.
• Feature: Add custom CloudKit zone support for queries #146 — custom zone for queries: queryRecords still hardcodes zoneID: .init(zoneName: "_defaultZone") with no zone parameter.

So the section is accurate as written — all seven are genuinely unshipped at the curated API level, not just sharing.

---

Generated by Claude Code