Background

The README roadmap may contain outdated information. A comprehensive verification of all GitHub issues (#1-#179) against the actual codebase has been completed.

Findings

Verified Implementations (just closed 12 issues):

• ✅ List field types (List Field Types #24) - FieldValue.list
• ✅ Reference field types (Reference Field Types #36) - FieldValue.reference
• ✅ Query records with filtering (Fetching Records Using a Query (records/query) w/ basic filtering #32) - CloudKitService.queryRecords()
• ✅ Error codes (Error Codes #37) - Comprehensive CloudKitError
• ✅ Zones list (Fetching Zones (zones/list) #43) - CloudKitService.listZones()

In Generated/Client.swift (need public API wrappers) - 13 operations:

• Record changes (fetchRecordChanges) - Fetching Record Changes (records/changes) #40
• Zone operations (lookupZones, modifyZones, fetchZoneChanges) - Fetching Zones by Identifier (zones/lookup) #44, Modifying Zones (zones/modify) #45, Fetching Zone Changes (zones/changes) #48
• Subscriptions (listSubscriptions, lookupSubscriptions, modifySubscriptions) - Fetching Subscriptions (subscriptions/list) #49, Fetching Subscriptions by Identifier (subscriptions/lookup) #50, Modifying Subscriptions (subscriptions/modify) #51
• User discovery (discoverUserIdentities, lookupContacts) - Discovering User Identities (POST users/discover) #27, Discovering All User Identities (GET users/discover) #28, Fetching Contacts (users/lookup/contacts) #33
• Assets (uploadAssets) - Uploading Assets (assets/upload) #30
• Tokens (createToken, registerToken) - Creating APNs Tokens (tokens/create) #52, Registering Tokens (tokens/register) #53

Not Implemented - 8 operations not found in generated code:

• assets/rereference (Referencing Existing Assets (assets/rereference) #31)
• users/lookup/email (Fetching Users by Email (users/lookup/email) #34), users/lookup/id (Fetching Users by Record Name (users/lookup/id) #35)
• records/resolve (Fetching Record Information (records/resolve) #41), records/accept (Accepting Share Records (records/accept) #42)
• changes/database (Fetching Database Changes (changes/database) #46)
• System field integration (System Field Integration #25)
• Name component types (Name Component Types #26)

Tasks

• Update README roadmap section with verified implementation status
• Remove or clarify outdated feature mentions
• Document that 17 operations exist in Generated/Client.swift (from OpenAPI spec)
• Clarify which operations are publicly exposed vs. internal-only
• Add section explaining "Implemented but not exposed" vs. "Not implemented"

Reference

See ISSUE_VERIFICATION_REPORT.md for complete analysis with file locations and line numbers.

Verification completed: November 27, 2025 (commit b89de65, v1.0.0-alpha.1)