gen-cards: regenerate Use-it block

README.md

@@ -25,6 +25,46 @@ LM drive a **12-layer LocDiT** flow-matching diffusion head, decoded by a **48 k
 bundles + a few host-side projections.
 
 <!-- gen-cards:use-it begin id=voxcpm2-2b (managed by scripts/gen-cards — edit cards.json / QuickStart.swift, not this block) -->
+## Use it
+
+▶️ **Run it (source)** — the [Speak runner](https://github.com/john-rocky/coreai-kit/tree/main/Examples/Speak)
+(GUI + CLI, one app for every text-to-speech model in the catalog):
+
+```bash
+git clone https://github.com/john-rocky/coreai-kit
+open coreai-kit/Examples/Speak/Speak.xcodeproj
+# → Run, then pick "VoxCPM2 2B" in the model picker
+
+# agents / headless (macOS):
+cd coreai-kit/Examples/Speak
+swift run speak-cli --model voxcpm2-2b --text "Hello from Core AI." --output hello.wav
+```
+
+💻 **Build with it** — complete; the glue is kit API, copy-paste runs:
+
+```swift
+import CoreAIKit
+
+let speaker = try await KitSpeaker(catalog: "voxcpm2-2b")
+let audio = try await speaker.synthesize(text)
+// audio.samples: 48 kHz mono PCM in [-1, 1] — play it or write a WAV
+```
+
+The take-home is [`Examples/Speak/Sources/QuickStart.swift`](https://github.com/john-rocky/coreai-kit/blob/main/Examples/Speak/Sources/QuickStart.swift)
+— this exact code as one typed function, no UI; the CLI is an argument shell over it, and
+the GUI drives the same `KitSpeaker(catalog:)` and plays the samples.
+Live playback? `synthesizeStreaming(_:onChunk:)` hands you ~0.5 s chunks as they decode,
+so audio starts before the whole clip exists. The WAV container is your app's territory
+(the runner ships a 20-line writer).
+
+**Integration checklist**
+
+- SPM: `https://github.com/john-rocky/coreai-kit` → product **CoreAIKit**
+- Info.plist: none needed
+- Entitlements: none needed
+- First run downloads the model — 4.7 GB (Mac) / 5.7 GB (iPhone) — then it loads from the
+  local cache (Application Support; progress via the `downloadProgress` callback)
+- Measure in Release — Debug is ~3× slower on per-token host work
 <!-- gen-cards:use-it end -->
 
 ## What's inside