docs: add fastlane changelog guidance

Author: SysAdminDoc

AGENTS.md

@@ -18,7 +18,7 @@ and sourced reasoning; mine them for *why*, but pick the next task from
 `ROADMAP.md`.
 
 1. [`PROJECT_CONTEXT.md`](PROJECT_CONTEXT.md) — single-page consolidated
-   project context. Pins the load-bearing invariants, current v1.8.244
+   project context. Pins the load-bearing invariants, current v1.8.245
    stack, the module layout, roadmap-file routing, and current source-of-truth
    state.
 2. [`ARCHITECTURE.md`](ARCHITECTURE.md) — contributor-facing module,
@@ -87,11 +87,12 @@ file-per-release pattern — do not re-introduce per-release note files. Each
 section describes intent, files touched, tests added, and Definition-of-Done
 evidence. A matching `fastlane/metadata/android/en-US/changelogs/<versionCode>.txt`
 (≤500 chars; draft ≤480 for headroom) ships alongside, enforced by
-`scripts/check-fastlane-metadata.sh`.
+`scripts/check-fastlane-metadata.sh`; draft it as a short store-facing summary,
+not as a file list or test log.
 
 `gradle.properties` `projectVersionCode` + `projectVersionName` bump in lockstep
 with the changelog commit. Tag the release commit at the same time
-(`git push --tags`). HEAD is `v1.8.244` (versionCode 2044) as of 2026-06-04.
+(`git push --tags`). HEAD is `v1.8.245` (versionCode 2045) as of 2026-06-04.
 
 ### 5. Definition of Done (per [ROADMAP.md](ROADMAP.md) §15)
 

ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # SwiftFloris Architecture
 
-Last updated: 2026-06-04, against the v1.8.244 codebase.
+Last updated: 2026-06-04, against the v1.8.245 codebase.
 
 This file is the fast architectural map for contributors. It is intentionally
 shorter than `ROADMAP.md` and more code-oriented than `PROJECT_CONTEXT.md`.
@@ -179,6 +179,9 @@ maintainer-triggered Roborazzi baseline capture. Android lint runs through
 `scripts/run-lint-debug-with-baseline-check.sh` in CI so stale baseline entries
 fail visibly, and `scripts/check-repo-hygiene.sh` keeps generated build/report
 output out of committed history.
+Fastlane changelog drafting guidance keeps the short store-facing release text
+within the 480-character draft budget before the metadata script enforces the
+hard limit.
 
 The local VM used by some agent runs may not have Java or the Android SDK on
 PATH. In that case, record the exact Gradle command attempted and leave final

CHANGELOG.md

@@ -2,6 +2,46 @@
 
 All SwiftFloris release history is consolidated here. This replaces the former root-level `RELEASE_NOTES_v*.md` file-per-release pattern.
 
+<a id="v1.8.245"></a>
+## v1.8.245
+
+Released: 2026-06-04
+
+### Fastlane changelog drafting guide
+
+R5 is closed. The short Fastlane changelog now has a documented drafting rule before the metadata script enforces the hard limit: write a store-facing, evidence-backed summary with 480-character headroom instead of a file list or test log.
+
+### Changes
+
+- **`docs/REPO_HYGIENE.md`** - adds the Fastlane changelog drafting rule, including the 480-character draft budget, store-facing summary focus, and docs-only release wording guidance.
+- **`docs/LOCAL_VERIFICATION.md`** - folds the drafting expectations into the standard local gate near `scripts/check-fastlane-metadata.sh`.
+- **`CONTRIBUTING.md` / `AGENTS.md` / `ARCHITECTURE.md`** - point release contributors and agent runs at the same short-summary rule.
+- **`ROADMAP.md` / `COMPLETED.md` / `RESEARCH_REPORT.md` / `README.md` / `PROJECT_CONTEXT.md` / `gradle.properties` / fastlane metadata** - advances the release marker to v1.8.245 / versionCode 2045 and closes R5.
+- **`ROADMAP.md` / `RESEARCH_REPORT.md`** - refresh the API 37 / Kotlin blocker evidence: Kotlin `2.4.0` is current, KSP still tops out at `2.3.9`, and AndroidX Core `1.19.0` declares `minCompileSdk=37`.
+
+### Verification
+
+- `git diff --check` - PASS.
+- `bash scripts/check-fastlane-metadata.sh` - PASS for versionCode 2045.
+- `bash scripts/check-repo-hygiene.sh` - PASS.
+- APK assembly was intentionally skipped in this local docs-only batch per operator request to avoid repeated heavy Android builds.
+
+### Files Touched
+
+- `AGENTS.md`
+- `ARCHITECTURE.md`
+- `CHANGELOG.md`
+- `COMPLETED.md`
+- `CONTRIBUTING.md`
+- `PROJECT_CONTEXT.md`
+- `README.md`
+- `RESEARCH_REPORT.md`
+- `ROADMAP.md`
+- `docs/LOCAL_VERIFICATION.md`
+- `docs/REPO_HYGIENE.md`
+- `fastlane/metadata/android/en-US/changelogs/2045.txt` (new)
+- `gradle.properties` (versionCode 2044->2045, versionName 1.8.244->1.8.245)
+
 <a id="v1.8.244"></a>
 ## v1.8.244
 

COMPLETED.md

@@ -83,6 +83,7 @@ Consolidated from the archived open-work checklist (closed items). Full per-rele
 - [x] R4-4 (P3) — `NativeStr.toJavaString()` now decodes only ByteBuffer remaining bytes and preserves caller-visible position across heap, sliced heap, direct, and read-only buffers. Shipped v1.8.242. — *Source: ROADMAP.md Researcher Queue Cycle 4.*
 - [x] WS12 (P2) — Localization content-quality pass cleared Turkish adjacent repeated-word lint with native-safe copy, tightened source labels, standardized trust-sensitive failure/destructive wording, and documented translation-safe cleanup rules. Shipped v1.8.243. — *Source: docs/archive/TODO_2026-06-03.md A5 / improvement-plan WS12.*
 - [x] WS10 / WS15 (P2) — Visual-QA, manual-QA, and release-evidence checklists now live in `docs/QA_CHECKLISTS.md` and are linked from verification, contributor, accessibility, and README docs. Shipped v1.8.244. — *Source: docs/archive/TODO_2026-06-03.md A5 / improvement-plan WS10/WS15.*
+- [x] R5 (P3) — Fastlane changelog drafting guidance now documents the 480-character draft budget, store-facing summary rules, and evidence-backed wording expectations. Shipped v1.8.245. — *Source: docs/archive/TODO_2026-06-03.md A5 / second-pass R5.*
 - [x] F1, F2, F15, F16, F17, F19, F20, F25, F26, F32, F34, F35, F36, F41, F42, EI8, EI11, EI4 (doc) — Closed across v1.8.174 -> v1.8.187. — *Source: TODO_2026-06-03.md*
 - [x] IMPROVEMENT_PLAN Workstreams 1, 3, 4, 5, 6 complete; Workstream 2 (lint) monotonically decreasing. — *Source: IMPROVEMENT_PLAN_2026-05-18.md*
 

CONTRIBUTING.md

@@ -156,6 +156,12 @@ Versioned releases use:
   state changes.
 - A local annotated tag for the release commit.
 
+Draft the Fastlane changelog as the short store-facing summary: keep it at or
+below 480 characters for headroom, summarize the verified outcome, and avoid
+test commands, file paths, internal-only IDs, or claims not backed by the full
+`CHANGELOG.md` section. The detailed rule lives in
+[`docs/REPO_HYGIENE.md`](docs/REPO_HYGIENE.md).
+
 Docs-only housekeeping commits do not need a version bump unless they are being
 published as a release.
 

PROJECT_CONTEXT.md

@@ -3,7 +3,7 @@
 **Maintained at root for fast onboarding.**
 **Last consolidated:** 2026-06-04 (from the autonomous research run at
 [`.ai/research/2026-05-17/`](.ai/research/2026-05-17/) plus follow-up slices
-through v1.8.244).
+through v1.8.245).
 
 This file is the single fastest read for an AI session, new contributor, or
 maintainer-context refresh. It does **not** replace [ROADMAP.md](ROADMAP.md),
@@ -47,7 +47,7 @@ them requires changing both the relevant code *and* the gate.
 If a proposed change conflicts with any of these, the answer is "move that
 feature into an addon" — never "loosen the invariant."
 
-## 3. Stack at HEAD (v1.8.244)
+## 3. Stack at HEAD (v1.8.245)
 
 ```
 Kotlin 2.3.21 · Compose BOM 2026.05.01 · Material 3 + material-kolor 4.1.1
@@ -204,7 +204,7 @@ and in [`ROADMAP.md` §0 v5.5 + v5.4](ROADMAP.md). Net deltas to invariants:
   at `docs/outreach/2026-05-17-swiftkey-migration/` covering
   AlternativeTo, BGR, Android Authority, and r/Swiftkey.
 
-**v1.8.104 - v1.8.244** ships the seventh research-pass privacy,
+**v1.8.104 - v1.8.245** ships the seventh research-pass privacy,
 voice, clipboard, NLP, visual-regression, Addons trust/asset/catalog layer, and
 input-behavior testability plus conservative lint/dependency cleanup and
 performance-baseline / CI-quality / repo-hygiene / destructive-confirmation
@@ -538,7 +538,7 @@ keyboard preview field now renders as a distinct bottom surface, exposes
 ready/active focus-state feedback, preserves bottom-bar traversal ordering, and
 uses coroutine-safe feedback when Android cannot open the keyboard picker.
 
-v1.8.171 through v1.8.244 refresh the release front door after the 2026-05-31
+v1.8.171 through v1.8.245 refresh the release front door after the 2026-05-31
 SwiftKey account-export cutoff, consolidate planning into `ROADMAP.md`,
 backfill audit docs, ship settings search and search polish, add hardware
 keyboard import and per-app language/accent discovery, harden release gates
@@ -618,6 +618,10 @@ documents translation-safe cleanup rules.
 v1.8.244 closes the QA/release-evidence checklist gap: `docs/QA_CHECKLISTS.md`
 now owns the visual-QA matrix, manual-QA flow, and release-evidence capture
 format, and verification/contributor/accessibility docs link to it.
+v1.8.245 closes the Fastlane changelog drafting gap: repo hygiene, local
+verification, contributor, architecture, and agent-facing release docs now
+describe the 480-character draft budget, store-facing summary focus, and
+evidence-backed wording rule for each versionCode changelog.
 
 ## 4. Module layout
 

README.md

@@ -1,6 +1,6 @@
 # SwiftFloris
 
-![Version](https://img.shields.io/badge/version-v1.8.244-blue) ![License](https://img.shields.io/badge/license-Apache%202.0-green) ![Platform](https://img.shields.io/badge/platform-Android%208.0+-orange) ![Network](https://img.shields.io/badge/network-none-lightgrey) ![Dictionary imports](https://img.shields.io/badge/dictionary%20imports-local%20files-green)
+![Version](https://img.shields.io/badge/version-v1.8.245-blue) ![License](https://img.shields.io/badge/license-Apache%202.0-green) ![Platform](https://img.shields.io/badge/platform-Android%208.0+-orange) ![Network](https://img.shields.io/badge/network-none-lightgrey) ![Dictionary imports](https://img.shields.io/badge/dictionary%20imports-local%20files-green)
 
 **SwiftFloris** is a privacy-first Android keyboard, forked from FlorisBoard and pushed toward SwiftKey-class multilingual typing without the cloud. It ships under Apache-2.0, holds no `INTERNET` permission, and binds zero accounts.
 
@@ -37,7 +37,7 @@
 
 ## Highlights
 
-| Area | What's in v1.8.244 | Privacy posture |
+| Area | What's in v1.8.245 | Privacy posture |
 |------|-------------------|-----------------|
 | **Autocorrect / prediction** | SCOWL 117k English dictionary, SymSpell d1+d2, bigram + trigram next-word, capitalization-aware completions, contraction handling, instant-remember user-dictionary overlay | On-device |
 | **Multilingual typing** | Bilingual subtype presets (EN+ES / EN+FR / EN+DE), per-token Latin language identification, top-two straddle guard, sentence-local context scoring, and opt-in remembered keyboard language per app | On-device |
@@ -56,7 +56,7 @@
 | **Editor reliability** | Expected-content generation for selection, text commit, composing finalize, and composing-region replacement paths now happens before `InputConnection` batch edits, with try/finally begin/end pairing and focused call-order tests | Local editor state only |
 | **Alternative layouts** | Colemak / Dvorak / Workman from the FlorisBoard layout pack, plus selectable honeycomb hex layout with clipped hex keys and hex-aware hit testing (only FOSS Android keyboard shipping this — Typewise vacated the consumer market early 2026; see [docs/HONEYCOMB_LAYOUT.md](docs/HONEYCOMB_LAYOUT.md)) | On-device |
 | **AI transparency** | First-run AI/ML explainer plus Settings → About → AI features screen covering next-word, glide, voice, translation, and smart compose; async suggestion work consumes request-scoped privacy snapshots for incognito, no-personalized-learning, offensive-content, and ghost-text sensitivity gates | On-device, no account, no telemetry |
-| **CI / build** | No-network gate, repo-hygiene gate, OSV dep scan, Dependabot version review, lint baseline-drift wrapper with no committed app lint baseline, startup crash recovery via the local crash dialog, restore/crash diagnostics routed through project logging with safe fallback copy, settings-search resource/route drift guard, MIME helper aggregate-contract tests, NativeStr ByteBuffer slice tests, localization/copy contract tests, post-hotfix regression coverage for Arabic shaping, Snygg imports, private trace suppression, and locale-scoped n-gram flushes, manual emulator settings smoke, reproducible-build toolchain pins + build-twice APK self-check chained into release publication, Roborazzi visual-regression hard gate with committed theme/Addons baselines, Macrobenchmark trace sections in 6 hot paths, manual benchmark trend-regression report, and compatible dependency freshness through Compose BOM 2026.05.01 / KSP 2.3.9 / Roborazzi 1.63.0 | Audit-friendly |
+| **CI / build** | No-network gate, repo-hygiene gate, Fastlane changelog drafting guide, OSV dep scan, Dependabot version review, lint baseline-drift wrapper with no committed app lint baseline, startup crash recovery via the local crash dialog, restore/crash diagnostics routed through project logging with safe fallback copy, settings-search resource/route drift guard, MIME helper aggregate-contract tests, NativeStr ByteBuffer slice tests, localization/copy contract tests, post-hotfix regression coverage for Arabic shaping, Snygg imports, private trace suppression, and locale-scoped n-gram flushes, manual emulator settings smoke, reproducible-build toolchain pins + build-twice APK self-check chained into release publication, Roborazzi visual-regression hard gate with committed theme/Addons baselines, Macrobenchmark trace sections in 6 hot paths, manual benchmark trend-regression report, and compatible dependency freshness through Compose BOM 2026.05.01 / KSP 2.3.9 / Roborazzi 1.63.0 | Audit-friendly |
 
 ## Distribution
 
@@ -288,6 +288,7 @@ Real device-number collection is tracked in [`docs/BENCHMARKS.md`](docs/BENCHMAR
 
 The full release stream lives in [`CHANGELOG.md`](CHANGELOG.md) and on [GitHub Releases](https://github.com/SysAdminDoc/SwiftFloris/releases).
 
+- **v1.8.245** (2026-06-04) — Fastlane changelog drafting now documents the 480-character draft budget, store-facing summary rules, and evidence-backed wording expectations. ([notes](CHANGELOG.md#v1.8.245))
 - **v1.8.244** (2026-06-04) — Visual-QA, manual-QA, and release-evidence checklists now live in `docs/QA_CHECKLISTS.md` and are linked from verification docs. ([notes](CHANGELOG.md#v1.8.244))
 - **v1.8.243** (2026-06-04) — Localization copy now avoids Turkish repeated-word lint, uses clearer source labels, and standardizes trust-sensitive failure/destructive copy with focused resource tests. ([notes](CHANGELOG.md#v1.8.243))
 - **v1.8.242** (2026-06-04) — `NativeStr.toJavaString()` now decodes only ByteBuffer remaining bytes across heap, sliced, direct, and read-only buffers without consuming caller position. ([notes](CHANGELOG.md#v1.8.242))
@@ -475,7 +476,7 @@ limitations under the License.
 
 ## Status
 
-🚀 **Active development.** Current release: **v1.8.244** (2026-06-04). The SwiftKey account export window closed on **2026-05-31**; local/on-device migration paths remain documented above.
+🚀 **Active development.** Current release: **v1.8.245** (2026-06-04). The SwiftKey account export window closed on **2026-05-31**; local/on-device migration paths remain documented above.
 
 ---