gen-cards: regenerate Use-it block

README.md

@@ -35,6 +35,56 @@ device.
 > [`LICENSE`](LICENSE).
 
 <!-- gen-cards:use-it begin id=s1-mini (managed by scripts/gen-cards — edit cards.json / QuickStart.swift, not this block) -->
+## Use it
+
+⚡ **One line** — this model is the default behind the kit's task op
+(`import CoreAIOps`; no session, no model plumbing, downloads on first use):
+
+```swift
+let clean = try await CoreAI.tidyTranscript(rawTranscript)
+```
+
+Twenty ops, one shape — [Cookbook](https://github.com/john-rocky/coreai-kit/blob/main/docs/COOKBOOK.md).
+
+▶️ **Run it (source)** — the [Tidy runner](https://github.com/john-rocky/coreai-kit/tree/main/Examples/Tidy)
+(GUI + CLI, the three control axes as pickers):
+
+```bash
+git clone https://github.com/john-rocky/coreai-kit
+open coreai-kit/Examples/Tidy/Tidy.xcodeproj
+# → Run, then pick "S1-mini by Superwhisper" in the model picker
+
+# agents / headless (macOS):
+cd coreai-kit/Examples/Tidy
+swift run tidy-cli --model s1-mini --text "so um i need to like send the the report by uh friday no wait make that thursday"
+```
+
+💻 **Build with it** — complete; the glue is kit API, copy-paste runs:
+
+```swift
+import CoreAIKit
+
+let tidier = try await KitTextNormalizer(catalog: "s1-mini")
+// Long input is cut at word boundaries into ~450-token chunks and the rewrites stitched:
+// on iPhone the engine caps prompt + generated at 1024 tokens, so a whole meeting
+// transcript passed in one call would stop mid-sentence.
+let result = try await tidier.normalize(transcript)
+// result: the transcript as written text — English only; filler-only input returns ""
+```
+
+The take-home is [`Examples/Tidy/Sources/QuickStart.swift`](https://github.com/john-rocky/coreai-kit/blob/main/Examples/Tidy/Sources/QuickStart.swift)
+— this exact code as one typed function, no UI; both the runner's GUI and its CLI call it.
+Cleaning transcripts repeatedly? Keep the `KitTextNormalizer` loaded and call
+`normalize(_:)` per transcript — the 796 MB load is what you are avoiding.
+
+**Integration checklist**
+
+- SPM: `https://github.com/john-rocky/coreai-kit` → product **CoreAIKit**
+- Info.plist: none needed
+- Entitlements: none needed
+- First run downloads the model — 0.8 GB (Mac) / 0.8 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 -->
 
 ## Contents