[leehack]

Summary

Prepares llamadart and the three Apple runtime companions at 0.19.6 for release plan #1918. Merging into main publishes core 0.19.6, then the three companions; it needs the maintainer's explicit go-ahead. Draft: not for merge, tag or publish until the maintainer says so.

Base: main dc8e26215.

Production-readiness scope

• User-facing scope: release metadata and docs. Runtime pin since 0.19.5: native LiteRT-LM v0.19.1-3 -> v0.19.1-4 (#1927); llama.cpp v0.9.0, stable-diffusion v0.3.0-3, Web bridge v0.1.83 and Web LiteRT-LM @litert-lm/[email protected] unchanged.
• Changelogs (core and docs): ## Unreleased becomes ## 0.19.6, compacted from 5 bullets to 4 plus the WebGPU baseline line and runtime baseline: #1919 (grammar rule and Seed-OSS) merged into one bullet; #1921 (e2e runner) is not user-observable and has no bullet; #1920 now names v0.19.1-4. Released sections untouched; docs page keeps 0.19.x and 0.18.x.
• Companions:
  • llamadart_litert_lm_flutter 0.19.5 -> 0.19.6: Package.swift pins leehack/[email protected] (4 targets), so its core constraint moves >=0.19.5 <0.20.0 -> >=0.19.6 <0.20.0.
  • llamadart_llama_cpp_flutter and llamadart_stable_diffusion_flutter 0.19.5 -> 0.19.6: no pin change; README install snippets name core ^0.19.6, as in Prepare 0.19.5 release #1917. Constraints stay >=0.19.0 <0.20.0.
• Supported platforms/paths / unsupported paths: unchanged by this PR.
• Out of scope / follow-ups: genkit_llamadart and llamadart_model_store untouched; MIGRATION.md unchanged.

Completeness checklist

• Declared scope is implemented.
• Unsupported combinations: N/A, no code change.
• README, installation docs, companion READMEs and all five changelogs updated.
• Regression coverage: release gates pass; pub.dev size guard passes.
• Validation coverage registry: N/A (no capability change).
• Security review: no secrets, tokens or signed URLs.
• Follow-ups: None.

PR type guidance

• Release preparation: versions, install snippets, lockfiles, changelogs and the LiteRT-LM companion's core constraint. No .gitattributes change; the changelogs were edited directly, no merge or rebase.
• Feature PR / Bugfix PR / Docs-only PR: N/A.

Test Plan

Pinned Flutter 3.47.1, isolated TMPDIR. Tag-history gates ran in a fresh full clone synced to this head (deleted afterwards).

• dart run tool/prepare_workspace.dart (plus dart pub get in packages/llamadart_validation and website/examples/observability): locks changed only for local core/companion 0.19.5 -> 0.19.6.
• dart format --output=none --set-exit-if-changed .: 0 changed.
• dart analyze: no issues.
• dart test -p vm test/unit/tooling/: 6 fail, all in windows_registry_qualification_test.dart (no pwsh on this macOS host; same as Prepare 0.19.5 release #1917).
• dart test -p vm -j 1 --exclude-tags local-only: 14,080 pass, the same six pwsh failures.
• dart test -p chrome --exclude-tags local-only: all 4,839 pass.
• coverage-lib: N/A, no lib/ change.
• Other checks:
  • verify_release_docs_versions.dart and --release-prep (full-history clone): exit 0, "llamadart 0.19.6, llamadart_llama_cpp_flutter 0.19.6, llamadart_litert_lm_flutter 0.19.6, llamadart_stable_diffusion_flutter 0.19.6; checkout llamadart-native v0.9.0."
  • check_webgpu_bridge_tag.dart: OK. companion_pub_preflight.dart: OK for all three companions. check_core_archive.py: pass, 1,933 files staged. check_platform_boundaries.dart: OK.
  • ./tool/docs/build_site.sh --port 18417: OK.
  • Classifier (origin/main...HEAD): high-risk (artifactConsumer).

Matrix Evidence

Matrix row	Scope covered	Platform / model / backend	Result	Evidence / notes
high-risk-exact-head-independent-qa	exact-head release audit	macOS host	PASS	Fresh auditor session at 530513c9: 0 P1/P2. Bullets verified against merged diffs and v0.19.1-4 assets; both verifier modes pass; workflow simulation OK; evaluator exit 2. Evidence: llamadart-evidence/pr-1928/
release-metadata-verification	versions, constraints, changelog promotion	macOS host, full-history clone	PASS	--release-prep exits 0.
release-doc-version-consistency	install docs, companion bumps	macOS host	PASS	verifier, both modes, exit 0.
release-companion-pub-gate	companion pub.dev availability and constraints	macOS host	PASS (pre-merge)	companion_pub_preflight.dart OK.
genkit-release, android-release-device-pool, release-representative-smokes	N/A	N/A	N/A	Genkit untouched; no runtime-code change; smokes belong to the publish step.

Review Notes

• Independent review status: PASS at 530513c9 (0 P1/P2).
• CI status / head SHA: all 45 checks green at 530513c9. Web Chat Contract needed reruns because of the 2026-11-11 Canonical/Azure Ubuntu mirror outage (ubuntu-26.04: apt can't resolve archive.ubuntu.com / security.ubuntu.com since ~13:48 UTC 11 Nov actions/runner-images#15296); main failed the same way.

High-risk regression review

• Classification: high-risk (artifactConsumer)
• Implementation task: lane-0196-prep
• Independent blocking QA task: PASS at 530513c9. Maintainer approved merge and publish ("Merge and publish").
• Exact head / current base: 530513c91 / dc8e26215
• Production-branch deletion, bypass, or miswire proof: N/A (metadata only)
• Affected-family real-model/artifact evidence: N/A
• Explicit unavailable-family or other N/A evidence: N/A
• Known PR-caused P1 regressions: 0
• Unresolved review threads: 0

[github-actions]

Chat app preview removed for leehack/llamadart-chat-pr-1928.