Mastodawn

Swift is for the Eloi. The framework you live in and the machine humming under the floor were built by the same hands, twelve years apart. John Harper built Core Animation (codename "LayerKit"), demoed it on the Mac in 2006, then came back to build SwiftUI. We just stopped looking down.
https://aleahim.com/blog/morlocks-built-swiftui/
#SwiftUI #iOSDev

The Morlocks Built SwiftUI - Aleahim

The cynical read is that Apple kept the real tools and handed us toys. But the same engineer built Core Animation in 2007 and co-built SwiftUI in 2019, and that one fact says the opposite. On why the foundation never left, and the debt that comes due the day the abstraction breaks.

Aleahim

Aleahim May 21

Cupertino v1.2.0 hits 92% rank-1 on canonical Apple API lookups, up from 52% in v1.1.0. Observable, AsyncSequence, EnvironmentObject, ForEach, DateFormatter and 11 others climbed to rank 1.

No vectors, no reranker. SQLite FTS5 with BM25F field weighting, AST extraction at index time. McNemar p ≤ 1e-5. Zero regressions across 110 paired queries.

https://aleahim.com/blog/cupertino-v1-2-0-ironclad/

#Swift #MCP

cupertino v1.2.0: lands the right Apple doc 9 times in 10 - Aleahim

Search-quality release. AI coding assistants now land the right Apple documentation page on the first try 9 times out of 10, up from 5 out of 10 in v1.1.0. Cross-validated on three independent corpora, zero regressions. The architecture, and what it still gets wrong, in writing.

Aleahim

Aleahim May 14

The YAML was fine. The actual problem was one stray key, eleven levels deep, that OpenAPIKit rejected and Yams wrapped in a DecodingError pointing nowhere useful. The real error was three layers in.
I lost an afternoon. Then a morning the next week. Then I built OpenAPIDoctor: a typed validator and auto-repair CLI for OpenAPI 3.0/3.1, on OpenAPIKit, tested across 594 YAML files.
#Swift #OpenAPI

Aleahim May 13

Three days ago I shipped cupertino v1.0.2 with "all 13 audits return zero."

Today v1.1.0 removes 7,095 silently-bad rows. The audit was walking one out of six source directories. A 3 a.m. SQL query found one HTTP 403 page indexed as Apple's DocC documentation. Pulling that thread unraveled 13 ways Apple's CDN lies to crawlers.
If your audit returns zero, audit your audit.

https://aleahim.com/blog/cupertino-v1-1-0-poison-cleanup/

#Swift #SQLite #iOSDev

Cupertino v1.1.0: my Apple docs index was 30% lies and I didn't know - Aleahim

A 3 a.m. SQL query found one row of HTTP poison in the search index. Pulling on that thread unraveled 13 ways Apple's CDN lies to crawlers, plus a release bug where the binary cheerfully downgraded every user to the previous bundle.

Aleahim May 11

Recently I shipped cupertino v1.0.1 with "verified zero duplicate pairs across 405,782 rows."

Today v1.0.2 removed 128,142 of those rows. They had been duplicates the whole time.

The v1.0.1 verification query was structurally incapable of seeing the bug: URIs carry a hash suffix computed before lowercasing, so GROUP BY LOWER(uri) was lowercasing two already-different strings.

Full write-up:
https://aleahim.com/blog/cupertino-v1-0-2/

#Swift #SQLite #iOSDev

Cupertino v1.0.2: the duplicate that `LOWER(uri)` could not see - Aleahim

A third of the search index was the same Apple page indexed twice. The verification query that "proved" it wasn't could not have seen the bug. What v1.0.2 ships, and three takeaways from the audit.

Aleahim May 5

Cupertino v1.0 "First Light" is out.

Ask an LLM what Swift's Task does and you can still get a Mach kernel essay. Cupertino serves Apple's docs to the model over MCP, ranked correctly.
https://aleahim.com/blog/cupertino-first-light/

#Swift #MCP #LLM

Cupertino v1.0.0 "First Light" - Aleahim

First release stable across crawl, index, rank, serve, and distribute. Search that finally returns the right answer, one bundle, MCP spec 2025-11-25.

Aleahim

Aleahim Apr 19

https://swifttribune.walidsassi.com/podcast/cupertino-mcp-server-swift-ai-development-tools/

Cupertino MCP: Local AI Tooling for Swift and iOS Development with Mihaela Mihaljević

How the Cupertino MCP server gives AI agents offline access to 302,000+ Apple docs across 307 frameworks — a technical deep-dive into Model Context Protocol for Swift AI development.

SwiftTribune

Aleahim Mar 13

Cupertino v0.10 — my AI documentation server now indexes all 307 Apple frameworks. 302,424 pages.

Found 5 bugs in the crawler. Best one: it was only discovering ~20 frameworks from Apple's
homepage. Fed it Apple's own technologies.json and the whole library opened up. Even
OpenGLES. Deprecated, but completionism has no room for judgment.

First community contributions too. Feels good.

aleahim.com/blog/cupertino-10-release/

#Swift #Apple #OpenSource #MCP #iOS #macOS