Skip to content

Prepare 0.8.20 release - #343

Merged
leehack merged 2 commits into
mainfrom
release/0.8.20-prep
Aug 21, 2026
Merged

Prepare 0.8.20 release#343
leehack merged 2 commits into
mainfrom
release/0.8.20-prep

Conversation

@leehack

@leehack leehack commented Aug 21, 2026

Copy link
Copy Markdown
Owner

Summary

  • Prepare llamadart 0.8.20, llamadart_llama_cpp_flutter 0.0.14, and llamadart_litert_lm_flutter 0.0.10.
  • Finalize concise user-facing release notes and update current installation snippets.
  • Refresh the chat-app path dependency lock entries for the three release versions.
  • Support both code_assets 1.x and 2.x so current consumers retain compatibility and pub.dev resolves the latest supported toolchain.

Opening this PR does not publish packages or create tags. Merging the release-prep branch is the guarded publication boundary handled by release_on_prep_merge.yml.

Production-readiness scope

  • User-facing scope: Version and document the runtime, WebGPU, speech, chat-app, and companion-package work already merged since 0.8.19; keep native-asset hooks compatible with code_assets 1.x and 2.x.
  • Supported platforms/paths: Release metadata, README and website install snippets, root and companion changelogs, the chat-app path lockfile, and the code_assets dependency constraint.
  • Unsupported or intentionally unavailable paths: N/A; no implementation source or public API changes in this prep PR.
  • Out of scope / follow-ups: Draft PR Add selectable Windows CUDA release sidecars #340 (selectable Windows CUDA release sidecars) is not included in 0.8.20.

Completeness checklist

  • Declared scope is fully implemented, or explicitly reduced above.
  • Unsupported platform/option combinations fail loudly with actionable diagnostics or are clearly documented as unavailable.
  • Public API docs, README/website docs, examples, support matrices, and changelog entries are updated where relevant.
  • Regression coverage covers the original issue plus key negative/version-skew paths where relevant.
  • Security/privacy review completed: no secrets, bearer tokens, signed URLs, or raw secret-bearing paths leak through logs, cache keys, metadata, errors, or snapshots.
  • Follow-up work that is useful but not required for this PR is tracked in GitHub Issues, or explicitly marked "None" above.

PR type guidance

  • Release-prep/dependency/docs PR: No implementation or public API changes. The exact merged runtime head was already validated across Web, macOS, Pixel, and physical iPad in Update native and Web llama.cpp pins to b10514 #342. The widened code_assets constraint is validated at both major-version bounds.

Test Plan

  • dart format --output=none --set-exit-if-changed . — no changed Dart sources; the full command reports four pre-existing formatter deltas under the newer local SDK. Pana's packaged-source formatting gate passed.
  • dart analyze
  • dart test -p vm -j 1 --exclude-tags local-only — 1,411 passed, 66 skipped.
  • dart test -p chrome --exclude-tags local-only — 766 passed, 1 existing skip.
  • flutter test in example/chat_app — 336 passed.
  • Both companion packages: format, analyze, Flutter tests, and SwiftPM dump-package.
  • dart test test/unit/hook -j 1 with Dart 3.13.1 + code_assets 2.0.0 — 77 passed.
  • Exact pub.dev toolchain: Dart 3.13.1 + Pana 0.23.18 — 160/160, including 50/50 static analysis and 40/40 dependencies.
  • Pana lower-bound analysis with code_assets 1.0.0 — PASS.
  • dart run tool/testing/check_platform_boundaries.dart
  • dart run tool/testing/verify_release_docs_versions.dart
  • ./tool/docs/build_site.sh
  • ./tool/docs/validate_links.sh
  • Root and both companion flutter pub publish --dry-run from clean temporary copies — 0 warnings.
  • git diff --check

Matrix Evidence

Matrix row Scope covered Platform / model / backend Result Evidence / notes
Release metadata Version/doc consistency Core 0.8.20; companions 0.0.14 and 0.0.10 PASS Release verifier and clean publish dry-runs passed.
Native-assets dependency code_assets compatibility 1.0.0 lower bound and 2.0.0 latest PASS Pana lower-bound analysis passed; 77 hook tests passed on 2.0.0.
Root regression Core Dart behavior VM PASS 1,411 passed, 66 skipped.
Browser regression Web-facing Dart behavior Chrome PASS 766 passed, 1 existing skip.
Chat-app regression Release lock compatibility Flutter host tests PASS 336 passed.
Package quality pub.dev readiness Dart 3.13.1 / Pana 0.23.18 PASS 160/160; dartdoc had 0 warnings/errors.
Runtime/device matrix Already-merged runtime behavior Web, macOS, Pixel, physical iPad; Qwen 3.5, Gemma 4, Qwen3-ASR/TTS N/A for this prep commit Exact runtime head evidence is recorded in #342; no runtime implementation file changed here.

Review Notes

  • Independent review status: Three parallel scope, release-note, and validation audits found no release blocker on the initial prep head; dependency follow-up is independently covered by exact hosted-toolchain and focused hook evidence.
  • CI status / head SHA: 14/14 checks green on 0d0d1a28ca78dcc0dd59c6dcb38d1ae7025f3354; mergeable/CLEAN; 0 review threads.

Copilot AI lite review requested due to automatic review settings August 21, 2026 00:46
@github-actions

github-actions Bot commented Aug 21, 2026

Copy link
Copy Markdown
Contributor

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

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Prepares the llamadart 0.8.20 release (plus companion package bumps) by updating package versions and aligning user-facing installation snippets and release notes across the README, website docs, companion package docs, and the chat-app path lockfile.

Changes:

  • Bumped core and companion package versions (llamadart 0.8.20, llamadart_llama_cpp_flutter 0.0.14, llamadart_litert_lm_flutter 0.0.10).
  • Updated install snippets in README and website installation docs to reference the new versions.
  • Finalized 0.8.20 release notes in changelogs and refreshed example/chat_app path dependency lock versions.

Reviewed changes

Copilot reviewed 11 out of 12 changed files in this pull request and generated no comments.

Show a summary per file
File Description
pubspec.yaml Bumps core package version to 0.8.20.
CHANGELOG.md Finalizes release notes under ## 0.8.20.
README.md Updates installation snippets to ^0.8.20 / new companion versions.
website/docs/getting-started/installation.md Updates website installation snippets for 0.8.20 and companion versions.
website/docs/changelog/recent-releases.md Promotes release highlights to ## 0.8.20 and refines bullets.
packages/llamadart_llama_cpp_flutter/pubspec.yaml Bumps companion version to 0.0.14.
packages/llamadart_llama_cpp_flutter/README.md Updates companion install snippet to ^0.0.14 (and core to ^0.8.20).
packages/llamadart_llama_cpp_flutter/CHANGELOG.md Finalizes companion release notes under ## 0.0.14.
packages/llamadart_litert_lm_flutter/pubspec.yaml Bumps companion version to 0.0.10.
packages/llamadart_litert_lm_flutter/README.md Updates companion install snippet to ^0.0.10 (and core to ^0.8.20).
packages/llamadart_litert_lm_flutter/CHANGELOG.md Finalizes companion release notes under ## 0.0.10.
example/chat_app/pubspec.lock Updates path-locked versions to match the new release versions.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Copilot AI review requested due to automatic review settings August 21, 2026 00:59

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 11 out of 12 changed files in this pull request and generated no new comments.

@leehack
leehack marked this pull request as ready for review August 21, 2026 01:13
@leehack
leehack merged commit 15c3336 into main Aug 21, 2026
15 checks passed
@leehack
leehack deleted the release/0.8.20-prep branch August 21, 2026 01:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants