[leehack]

Summary

• Prepare genkit_llamadart 3.8.0: version 3.7.0 → 3.8.0, and ## Unreleased → ## 3.8.0 - 2026-11-08. The one bullet comes from #1816 (llamadart: ^0.19.0).
• Why 3.8.0: adapter minors track core minors (3.6/0.17, 3.7/0.18), and ^0.19.0 is a new core minor. Public API unchanged.
• Two files only, as release_genkit_on_prep_merge.yml requires. Core llamadart 0.19.0 is released ("core first" holds). The maintainer approved opening this PR; merging needs a separate explicit approval.

What merging this PR does

Merging publishes. The branch matches release/genkit_llamadart-vX.Y.Z and changes only the two prep files, so release_genkit_on_prep_merge.yml tags the merge commit genkit_llamadart-v3.8.0 and dispatches publish_genkit_pubdev.yml, which publishes genkit_llamadart 3.8.0 and creates its GitHub Release with --latest=false. Core and companion publishers do not run. pub.dev versions cannot be unpublished. If the merge lands on a later day, fix the changelog date first.

Production-readiness scope

• User-facing scope: after merge, genkit_llamadart 3.8.0 (llamadart: ^0.19.0) is on pub.dev.
• Supported platforms/paths: unchanged from main.
• Unsupported or intentionally unavailable paths: unchanged from main.
• Out of scope / follow-ups: after publication, update the published-pairing snippets in website/docs/integrations/genkit.md and choosing-an-api.md to 3.8.0 / llamadart 0.19.0. The Genkit ## Unreleased heading returns with the next adapter change.

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. N/A: version and changelog only.
• Public API docs, README/website docs, examples, support matrices, and changelog entries are updated where relevant. Website pairings follow publication, as noted above.
• Regression coverage covers the original issue plus key negative/version-skew paths where relevant. N/A: no code change.
• Public capability changes update the validation coverage registry with a pack or a reasoned, issue-linked exemption; inventory checks pass (or N/A with scope). N/A: no capability change.
• Security/privacy review completed: version and changelog text only.
• 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

• Feature PR: N/A, release prep.
• Bugfix PR: N/A, release prep.
• Docs-only PR: N/A. A version changes and the merge publishes.

Test Plan

Pinned Flutter 3.47.1, macOS arm64, head bff432136e21cccdf8734891bb1aec3800c80468.

• dart run tool/prepare_workspace.dart: no tracked changes beyond the two prep files.
• dart format --output=none --set-exit-if-changed .: 0 changed.
• dart analyze: no issues. check_platform_boundaries.dart: OK.
• dart test -p vm -j 1 --exclude-tags local-only: N/A, no core change.
• dart test -p chrome --exclude-tags local-only: N/A, no core change.
• coverage-lib: N/A, no lib/ change.
• Other targeted/local-only validation:
  • From packages/genkit_llamadart: dart format, dart analyze --fatal-infos, python3 .github/check_docs.py: pass. dart test -x real-model: +471.
  • stage_genkit_package.py to a fresh directory, dart pub get && dart pub publish --dry-run: 3.8.0, 0 warnings, 585 KB.
  • pub.dev genkit_llamadart 3.8.0 returns 404 (latest 3.7.0); tag genkit_llamadart-v3.8.0 absent.

Matrix Evidence

Matrix row	Scope covered	Platform / model / backend	Result	Evidence / notes
genkit-release	release isolation, two-file prep scope, tag/version guards, staging	macOS arm64	PASS (staged dry-run)	dry-run 0 warnings; routing tests run in CI
genkit-contracts	adapter tests, docs, archive	macOS arm64, hosted llamadart 0.19.0	PASS	+471
release-companion-pub-gate	pub.dev version availability	pub.dev API	PASS (pre-merge)	3.8.0 returns 404; tag absent

Review Notes

• Independent review status: PASS at exact head bff432136e21cccdf8734891bb1aec3800c80468 vs base ab2ead08306fa7e36119c25a8061db188eb9f562 by a fresh agent session uninvolved in the implementation; 0 blocking findings, 0 PR-caused P1, 0 review threads. Verified: 2 files only; release_genkit_on_prep_merge.yml fires (branch regex, fork check, two-file rule, pubspec/heading parse, tag absent, pub.dev 3.8.0 404, no GitHub Release); publish_genkit_pubdev.yml verify passes; core and companion publishers do not fire; changelog accurate. Package lanes against hosted llamadart 0.19.0: format 195/0, analyze --fatal-infos clean, .github unittest 7 OK, check_docs pass (27), dart test -x real-model +471, real-model +10 ~32, Dart 3.12.0 lower-bound analyze clean + 471, staged publish dry-run 585 KB 0 warnings, pana 160/160, test/ci genkit unittests 39 OK; git diff --stat v0.19.0 origin/main -- lib hook pubspec.yaml empty.
• CI status / head SHA: green at bff432136e21cccdf8734891bb1aec3800c80468: runs 42525499984, 42525499897, 42525499267, 42525499941 all success.

High-risk regression review

git diff --name-only --no-renames origin/main...HEAD | dart run tool/testing/classify_high_risk_changes.dart:

Classification: high-risk
Surfaces: artifactConsumer
Required matrix: dart run tool/testing/test_matrix.dart --tier high-risk

• Classification: high-risk (artifactConsumer)
• Implementation task: this PR's author session
• Independent blocking QA task: fresh agent session, PASS, 0 known PR-caused P1, 0 unresolved threads
• Exact head / current base: bff432136e21cccdf8734891bb1aec3800c80468 / ab2ead08306fa7e36119c25a8061db188eb9f562
• Known PR-caused P1 regressions: 0 known
• Production-branch deletion, bypass, or miswire proof: genkit_release_routing_test.dart passes at head (+1); replacing the "$changelog_version" != "$version" check in release_genkit_on_prep_merge.yml with false makes it fail (mutation observed in the worktree, restored).
• Readiness CLI: dart run tool/testing/high_risk_readiness.dart --evidence 1822-evidence.json --repository leehack/llamadart --pr-number 1822 --head-sha bff432136e21cccdf8734891bb1aec3800c80468 --base-sha ab2ead08306fa7e36119c25a8061db188eb9f562 --pr-author leehack exited 2 (unverifiedPrerequisites / externalPrerequisitesUnavailable): repository-local v2 evidence is internally consistent; external app/environment/ruleset provenance is unavailable locally, as expected.
• Affected-family real-model/artifact evidence: N/A, no runtime change; staged archive dry-run and real-model leg against published 0.19.0 above.
• Explicit unavailable-family or other N/A evidence: N/A.
• Unresolved review threads: 0

[github-actions]

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