release: v0.1.1 — drop PhoneResult SPEC DRIFT comment block

postio-api 1.0.3 aligned the spec and runtime: PhoneResult.is_reachable
is now boolean|nil (matches HLR return), and the runtime always emits
every nullable field as explicit null instead of dropping them on parse
failure.

The .from_hash hash-lookup pattern naturally handles either shape, so
no consumer-visible change beyond the dropped explanatory comment.

Author: Oliver Kingston

CHANGELOG.md

@@ -6,6 +6,16 @@ follows [SemVer](https://semver.org/).
 
 ## [Unreleased]
 
+## [0.1.1] — 2026-05-02
+
+### Changed
+
+- Drop the SPEC DRIFT block on `PhoneResult`. postio-api 1.0.3 aligned
+  the spec with the runtime — `is_reachable` is bool|nil, and the
+  runtime now always emits explicit nulls for every nullable field.
+  The hash-lookup `.from_hash` already handled either shape, so no
+  consumer-visible change.
+
 ## [0.1.0] — 2026-05-02
 
 Initial release. First Postio Ruby SDK on RubyGems.
@@ -35,5 +45,6 @@ Initial release. First Postio Ruby SDK on RubyGems.
   live API returns booleans there even though the spec says
   string-only. Aligned once postio-api ships a spec/runtime fix.
 
-[Unreleased]: https://github.com/postio-uk/postio-ruby/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/postio-uk/postio-ruby/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/postio-uk/postio-ruby/releases/tag/v0.1.1
 [0.1.0]: https://github.com/postio-uk/postio-ruby/releases/tag/v0.1.0

CLAUDE.md

@@ -60,12 +60,14 @@ Local dev picks up `~/PROJECTS/ONNO/POSTIO/.env` via `set -a && source
   https://rubygems.org/profile/oidc/api_key_roles
   Bind to `(postio-uk/postio-ruby, release.yml, environment: rubygems)`.
 
-## Spec drift
-
-`PhoneResult` carries the same drift handling as the other SDKs: every
-nullable field defaults to `nil` (handled by hash lookup returning
-`nil` for missing keys), and `is_reachable` accepts either bool or
-string. Reapply if model is regenerated.
+## Spec ↔ runtime alignment
+
+As of postio-api 1.0.3 the OpenAPI spec and runtime are aligned —
+`PhoneResult` is a clean mirror of the spec. The live API now always
+emits explicit nulls for every field (no missing-key fallbacks needed)
+and `is_reachable` is bool|nil only. If a future spec change
+re-introduces drift, prefer fixing it at the source (postio-api Zod
+schemas + handlers) over patching downstream.
 
 ## Secrets the CI needs
 

lib/postio/models.rb

@@ -109,13 +109,6 @@ def self.from_hash(h)
     end
 
     # PhoneResult — validation verdict for one phone number.
-    #
-    # SPEC DRIFT (2026-05-02): the OpenAPI spec marks every nullable
-    # field as required, but on invalid input the live API drops them
-    # entirely. The .from_hash fetcher uses h["..."] which returns nil
-    # for missing keys, papering over the drift. Also: spec says
-    # is_reachable is string|null, but the live API returns bool — we
-    # accept either.
     PhoneResult = Data.define(
       :number, :is_valid, :is_possible, :type, :country_code, :country_name,
       :national_format, :international_format, :e164_format, :original_carrier,

lib/postio/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Postio
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end