[leehack]

Summary

Prepares llamadart and the three Apple runtime companions at 0.19.4 for release plan #1874. Merging into main publishes core 0.19.4, then the three companions; it needs the maintainer's explicit go-ahead.

Base: main d56c02e6a (the #1895 batch plus #1896). git log v0.19.3..origin/main holds only the 0.19.3 docs cut, #1895's 15 constituents, #1893 and #1896.

Production-readiness scope

• User-facing scope: release metadata and docs only. Runtime pins are unchanged since 0.19.3 (no change under lib/src/hook, hook/, lib/src/web_setup or packages/llamadart_*_flutter since v0.19.3): native llama.cpp v0.9.0 (Web upstream v0.9.0@cd959bae), native LiteRT-LM v0.19.1-2, stable-diffusion v0.3.0-3, Web bridge v0.1.83, Web LiteRT-LM @litert-lm/[email protected], manifest SHA-256 ae6f4884…c038e5.
• Changelogs (core and docs): ## Unreleased becomes ## 0.19.4, compacted from 10 bullets to 7: LiteRT-LM Web manual tool calling on @litert-lm/core 0.19.0 #1790 + Report LiteRT-LM Web token-limit truncation to the tool loop #919 (LiteRT-LM Web tool calling and length) merged; LiteRT-LM C API 1.0 chat send failures miss the bundle template note #1868 + 0.19.x audit follow-ups (index) #1861 (native LiteRT-LM error detail) merged; Thinking tags that llama.cpp keeps as text still parse as a thought in other formats and mid-reply #1865 + MiniMax M3 with thinking off takes a mid-reply thought as reasoning; llama.cpp keeps it as content #1887 (thought only at reply start, MiniMax M3) merged; the two Reasoning parity follow-ups from #1524/#1525 audit: mutants X2/X7, Ling <think> in args, partial-tag drop #1531 Qwen3-Coder bullets merged. The bridge bullet says v0.1.83 (unchanged from 0.19.3) and the runtime-baseline paragraph repeats the 0.19.3 provenance. Released sections untouched (patch release: no docs-changelog trim).
• Companions: all three move 0.19.3 -> 0.19.4. No native pin or code changed, but their README install snippets must name core ^0.19.4 (release-workflow.md §2: normal core patch preparation changes all three companion payloads and requires version bumps). Each gets ## 0.19.4 "Refresh README installation guidance for core 0.19.4" with its unchanged SwiftPM pin. Core constraints unchanged: LiteRT-LM >=0.19.1 <0.20.0, llama.cpp and stable-diffusion >=0.19.0 <0.20.0.
• Supported platforms/paths / unsupported paths: unchanged.
• Out of scope / follow-ups: genkit_llamadart and llamadart_model_store untouched; MIGRATION.md unchanged (no breaking change). Conditional plan items LiteRT-LM Apple bundles ship an unused Metal accelerator (8.3 MB on macOS) #1798 and LiteRT-LM auto CPU fallback: Galaxy S24 device evidence (#1456 audit follow-up) #1458 stay out.

Completeness checklist

• Declared scope is implemented.
• Unsupported combinations: N/A, no runtime change.
• README, installation docs, companion READMEs and all five changelogs updated.
• Regression coverage: release gates pass; pub.dev size guard passes (CHANGELOG.md 133,745 bytes, 51% of 262,144).
• Validation coverage registry: N/A (no capability change in this PR).
• Security review: no secrets, tokens or signed URLs.
• Follow-ups: None.

PR type guidance

• Release preparation: versions, install snippets, lockfiles and changelogs. No pin, Package.swift, hook or .gitattributes change. Changelog union merge was turned off in .git/info/attributes while preparing.
• Feature PR / Bugfix PR / Docs-only PR: N/A.

Test Plan

Pinned Flutter 3.47.1, isolated TMPDIR. Gates that read tag history ran in a full-history clone at this head (the local clone is shallow).

• dart run tool/prepare_workspace.dart: no tracked change on the clean clone; locks regenerated through pub only (example/chat_app, packages/llamadart_validation, website/examples/observability: local core/companion 0.19.3 -> 0.19.4 only).
• dart format --output=none --set-exit-if-changed .: 0 changed.
• dart analyze: no issues.
• dart test -p vm -j 1 --exclude-tags local-only: test/unit/tooling/ plus the tool/ci/markdown_test_suites.txt suites: 1,728 pass, 6 fail, all in windows_registry_qualification_test.dart (ProcessException: no pwsh on this macOS host; pre-existing, same as Prepare 0.19.3 release #1884). CI runs the full lane.
• dart test -p chrome --exclude-tags local-only: N/A locally, no lib/ or Web change; CI runs it.
• coverage-lib: N/A, no lib/ change.
• Other checks:
  • verify_release_docs_versions.dart and --release-prep: both exit 0 ("Release docs versions verified: llamadart 0.19.4, llamadart_llama_cpp_flutter 0.19.4, llamadart_litert_lm_flutter 0.19.4, llamadart_stable_diffusion_flutter 0.19.4; checkout llamadart-native v0.9.0."); no content-size warning.
  • check_released_changelog_sections.dart (simulated pull_request event, base main): "Release-prep PR: released changelog sections may change. Released changelog sections match the base."
  • check_webgpu_bridge_tag.dart: OK (16 pins agree on v0.1.83).
  • companion_pub_preflight.dart: OK for all three companions.
  • check_core_archive.py: pass, 1,907 files staged.
  • ./tool/docs/build_site.sh --port 65497: OK, no broken links.
  • Classifier (vs main): 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	Pending	Independent audit of this head against main d56c02e6a.
release-metadata-verification	versions, constraints, changelog promotion	macOS host, full-history clone	PASS	verify_release_docs_versions --release-prep exits 0; verify_release_docs_companion_pins_test.dart 24/24.
structured-output-adversarial, litert-lm-v1-public-*, litert-lm-json-schema	N/A	N/A	N/A	No parser, grammar, template, runtime or LiteRT-LM change in this PR; those changes were audited in #1895.

Review Notes

• Independent review status: pending (draft).
• CI status / head SHA: 6587dec223ef23512aea94e25b8cd3ac271bc418 green (CI run 42838399941; 35 pass, 10 skipped after one rerun: GitHub never acquired macOS arm64 runners for "Companion Packages (macOS)" and "Test Native (macos, 2/3)" on the first attempt)

High-risk regression review

• Classification: high-risk (artifactConsumer).
• Implementation task: 0.19.4 release prep, branch release/prep-0.19.4.
• Independent blocking QA task: pending.
• Exact head / current base: 6587dec223ef23512aea94e25b8cd3ac271bc418 / d56c02e6a (main).
• Production-branch deletion, bypass, or miswire proof: N/A, no production code change.
• Affected-family real-model/artifact evidence: N/A, no pin change.
• 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-1897.