jeiel85 · jeiel85 · Jul 28, 2026 · Jul 28, 2026
diff --git a/.agent/decisions.md b/.agent/decisions.md
@@ -7,6 +7,26 @@
 
 ## Confirmed Decisions
 
+### D065 - Distribution Guidance Separates Current Release From Update Channels
+
+GitHub Releases is the public source of the current signed APK. F-Droid remains the
+recommended route for automatic updates once its catalog has published that version.
+GitLab remains a source mirror, but its release assets are not an installation promise.
+
+Why:
+- Google Play updates are currently paused, so the public documentation must name one
+  unambiguous current-release source.
+- F-Droid publication is valuable for trusted updates but can lag a GitHub release.
+- The GitLab release publication step has had quota and availability failures; presenting
+  it as interchangeable with GitHub can direct a user to an older or missing asset.
+
+Decision:
+- All six READMEs describe the same channel hierarchy.
+- `docs/ROADMAP.md` treats distribution reliability and real-user evidence as the next
+  gate, ahead of new broad features.
+- This changes documentation and operations only; it does not add network access,
+  analytics, accounts, or any new runtime dependency.
+
 ### D064 - The R8 Mapping Is Not A GitHub Release Asset Either
 
 The GitHub Release carries exactly one asset, the signed APK. The R8 mapping is

diff --git a/.agent/progress.md b/.agent/progress.md
@@ -1,3 +1,17 @@
+## 2026-07-28 - Project direction and distribution documentation refreshed
+
+Selected task:
+- Align public installation guidance and the active roadmap with the observed release channels and current product stage.
+
+What changed:
+- Updated all six READMEs: GitHub Releases is the current signed-APK source, F-Droid is the automatic-update path after catalog publication, and GitLab is a source mirror rather than an installation promise.
+- Added a 2026-07–10 stabilization, distribution, and user-evidence gate to `docs/ROADMAP.md`; moved the older feature phases to an explicitly deferred backlog.
+- Marked the commercial-readiness document as historical-complete and linked it to the active operating plan.
+
+Verification:
+- `pwsh scripts/verify-landing-versions.ps1`
+- Manual parity review of all six installation sections and their current v2.32.1 release links.
+
 ---
 
 ## 2026-07-16 - main 브랜치 통합과 GitLab v2.24 정렬

diff --git a/.agent/tasks.md b/.agent/tasks.md
@@ -5,6 +5,11 @@
 
 ---
 
+## User-requested Project Direction Refresh (Done, 2026-07-28)
+
+- [x] 공개 저장소·릴리스·CI·배포 채널을 점검하고, 최신 설치 경로와 3/6개월 안정화 게이트를
+  `README*.md`와 `docs/ROADMAP.md`에 반영
+
 ## User-requested Public Surface Renewal (Done, 2026-07-15)
 
 - [x] GitHub Pages 랜딩을 Quiet proof 방향으로 재구성하고 실제 앱 화면, no-INTERNET 증거, F-Droid 우선 설치 경로, 반응형·접근성·SEO를 검증

diff --git a/HISTORY.md b/HISTORY.md
@@ -1,3 +1,18 @@
+## 2026-07-28 - Project direction and distribution guidance aligned
+
+- Trigger: a repository review found a mature local-first app with an outdated feature
+  roadmap, a paused Google Play channel, an F-Droid catalog that can trail GitHub, and
+  GitLab release-asset publication that is not reliable enough to advertise as an equal
+  installation path.
+- Contract/scope: no application code, permissions, telemetry, account, dependency, or
+  release version changed. The six README installation sections now distinguish GitHub
+  Releases (current signed APK), F-Droid (automatic updates after catalog publication),
+  and GitLab (source mirror). `docs/ROADMAP.md` gains a July–October stabilization,
+  distribution, and user-evidence gate; the older feature phases remain deferred ideas.
+- Verification: `pwsh scripts/verify-landing-versions.ps1` and a line-by-line parity
+  review of all six README installation sections. `./gradlew test` had already passed on
+  the unchanged v2.32.1 source tree during the repository assessment.
+
 ## 2026-07-27 - The Trendshift daily-Kotlin award on the README and landing hero
 
 - Trigger: Trendshift ranked the repository #1 Kotlin repository of the day on 23 Jul 2026, and the maintainer asked whether the badge it hands out belonged on the README. It did, and the landing pages were added in the same pass.

diff --git a/README.de.md b/README.de.md
@@ -34,7 +34,7 @@
 <p align="center">
   <a href="https://github.com/jeiel85/markleaf-android">GitHub-Repository</a> ·
   <a href="https://github.com/jeiel85/markleaf-android/discussions">Discussions (Feedback)</a> ·
-  <a href="https://gitlab.com/jeiel85/markleaf-android">Öffentlicher GitLab-Mirror</a>
+  <a href="https://gitlab.com/jeiel85/markleaf-android">GitLab-Quellcode-Mirror</a>
 </p>
 
 <p align="center">
@@ -163,11 +163,11 @@ com.markleaf.notes
 ### Installation
 
 > [!NOTE]
-> **Google-Play-Updates sind derzeit ausgesetzt.** Bis eine koreanische Gewerbeanmeldungs-Anforderung für den Einzelentwickler geklärt ist, werden keine neuen Versionen in den Play Store geladen. Hol dir in der Zwischenzeit **die neueste Version über F-Droid, GitHub Releases oder GitLab Releases.** (Wenn du sie bereits aus dem Play Store installiert hast, funktioniert sie weiterhin.)
+> **Google-Play-Updates sind derzeit ausgesetzt.** Bis eine koreanische Gewerbeanmeldungs-Anforderung für den Einzelentwickler geklärt ist, werden keine neuen Versionen in den Play Store geladen. Die aktuelle Version bekommst du über **GitHub Releases**. Sobald der F-Droid-Build nachgezogen hat, ist F-Droid der empfohlene Update-Weg. (Wenn du sie bereits aus dem Play Store installiert hast, funktioniert sie weiterhin.)
 
-- **F-Droid** *(empfohlen)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) – im F-Droid-Client suchen oder über den Link oben installieren. Es wird derselbe Signaturschlüssel (SHA-256 `0be97352…f91a`) verwendet, sodass Updates auch dann nahtlos weiterlaufen, wenn du ein APK aus den GitHub- oder GitLab-Releases per Sideload installiert hast.
+- **F-Droid** *(für automatische Updates empfohlen)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) – im F-Droid-Client suchen oder über den Link oben installieren. Der Katalog kann später als GitHub veröffentlichen; falls die aktuelle Version noch nicht angezeigt wird, nutze unten GitHub Releases. Es wird derselbe Signaturschlüssel (SHA-256 `0be97352…f91a`) verwendet, sodass Updates auch nach einem ersten Sideload eines GitHub-APKs nahtlos weiterlaufen.
 - **Direkte APK-Installation**: lade das APK aus dem [GitHub-v2.32.1-Release](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) herunter und führe es auf deinem Android-Gerät aus.
-- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) – **Updates sind ausgesetzt** (siehe Hinweis oben). Wenn du die App bereits hast, funktioniert sie weiter, aber die neueste Version gibt es über F-Droid, GitHub oder GitLab.
+- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) – **Updates sind ausgesetzt** (siehe Hinweis oben). Wenn du die App bereits hast, funktioniert sie weiter; die aktuelle Version gibt es über GitHub Releases oder nach Veröffentlichung über F-Droid.
 
 ### Aus dem Quellcode bauen
 Wenn du selbst bauen oder beitragen möchtest, folge diesen Schritten.

diff --git a/README.es.md b/README.es.md
@@ -34,7 +34,7 @@
 <p align="center">
   <a href="https://github.com/jeiel85/markleaf-android">Repositorio de GitHub</a> ·
   <a href="https://github.com/jeiel85/markleaf-android/discussions">Discussions (sugerencias)</a> ·
-  <a href="https://gitlab.com/jeiel85/markleaf-android">Espejo público de GitLab</a>
+  <a href="https://gitlab.com/jeiel85/markleaf-android">Espejo de código fuente en GitLab</a>
 </p>
 
 <p align="center">
@@ -163,11 +163,11 @@ com.markleaf.notes
 ### Instalación
 
 > [!NOTE]
-> **Las actualizaciones en Google Play están en pausa por ahora.** No se publicarán nuevas versiones en la Play Store hasta que se resuelva un requisito de política de registro de negocio en Corea para el desarrollador individual. Mientras tanto, **obtén la última versión desde F-Droid, GitHub Releases o GitLab Releases.** (Si ya la instalaste desde la Play Store, seguirá funcionando.)
+> **Las actualizaciones en Google Play están en pausa por ahora.** No se publicarán nuevas versiones en la Play Store hasta que se resuelva un requisito de política de registro de negocio en Corea para el desarrollador individual. Para obtener la versión actual, usa **GitHub Releases**. Cuando la compilación de F-Droid se haya puesto al día, F-Droid será la ruta de actualización recomendada. (Si ya la instalaste desde la Play Store, seguirá funcionando.)
 
-- **F-Droid** *(recomendado)*: [Markleaf en F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — búscalo en el cliente de F-Droid o instálalo con el enlace de arriba. Usa la misma clave de firma (SHA-256 `0be97352…f91a`), así que las actualizaciones continúan sin problemas incluso si instalaste un APK de GitHub o GitLab Releases mediante sideload.
+- **F-Droid** *(recomendado para actualizaciones automáticas)*: [Markleaf en F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — búscalo en el cliente de F-Droid o instálalo con el enlace de arriba. El catálogo puede publicarse después de GitHub; si aún no muestra la versión actual, usa GitHub Releases a continuación. Usa la misma clave de firma (SHA-256 `0be97352…f91a`), así que las actualizaciones continúan sin problemas aunque primero instales por sideload un APK de GitHub.
 - **Instalación directa del APK**: descarga el APK desde el [release v2.32.1 de GitHub](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1), y ejecútalo en tu dispositivo Android.
-- **Google Play**: [Markleaf en Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **las actualizaciones están en pausa** (ver la nota de arriba). Si ya la tienes instalada, seguirá funcionando, pero obtén la última versión desde F-Droid, GitHub o GitLab.
+- **Google Play**: [Markleaf en Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **las actualizaciones están en pausa** (ver la nota de arriba). Si ya la tienes instalada, seguirá funcionando; obtén la versión actual desde GitHub Releases o desde F-Droid cuando esté disponible allí.
 
 ### Compilar desde el código fuente
 Si quieres compilar el proyecto o contribuir, sigue estos pasos.

diff --git a/README.fr.md b/README.fr.md
@@ -34,7 +34,7 @@
 <p align="center">
   <a href="https://github.com/jeiel85/markleaf-android">Dépôt GitHub</a> ·
   <a href="https://github.com/jeiel85/markleaf-android/discussions">Discussions (retours)</a> ·
-  <a href="https://gitlab.com/jeiel85/markleaf-android">Miroir public GitLab</a>
+  <a href="https://gitlab.com/jeiel85/markleaf-android">Miroir du code source GitLab</a>
 </p>
 
 <p align="center">
@@ -163,11 +163,11 @@ com.markleaf.notes
 ### Installation
 
 > [!NOTE]
-> **Les mises à jour sur Google Play sont actuellement en pause.** Aucune nouvelle version ne sera publiée sur le Play Store tant qu'une exigence de politique d'enregistrement d'entreprise en Corée pour le développeur indépendant ne sera pas résolue. En attendant, **obtenez la dernière version via F-Droid, GitHub Releases ou GitLab Releases.** (Si vous l'avez déjà installée depuis le Play Store, elle continue de fonctionner.)
+> **Les mises à jour sur Google Play sont actuellement en pause.** Aucune nouvelle version ne sera publiée sur le Play Store tant qu'une exigence de politique d'enregistrement d'entreprise en Corée pour le développeur indépendant ne sera pas résolue. Pour la version actuelle, utilisez **GitHub Releases**. Une fois que la compilation F-Droid est à jour, F-Droid reste le canal de mise à jour recommandé. (Si vous l'avez déjà installée depuis le Play Store, elle continue de fonctionner.)
 
-- **F-Droid** *(recommandé)* : [Markleaf sur F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — recherchez-le dans le client F-Droid ou installez-le via le lien ci-dessus. Il utilise la même clé de signature (SHA-256 `0be97352…f91a`), donc les mises à jour continuent sans interruption même si vous avez installé un APK via sideload depuis GitHub ou GitLab Releases.
+- **F-Droid** *(recommandé pour les mises à jour automatiques)* : [Markleaf sur F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — recherchez-le dans le client F-Droid ou installez-le via le lien ci-dessus. Le catalogue peut être publié après GitHub ; s'il n'affiche pas encore la version actuelle, utilisez GitHub Releases ci-dessous. Il utilise la même clé de signature (SHA-256 `0be97352…f91a`), donc les mises à jour continuent sans interruption même si vous installez d'abord un APK GitHub par sideload.
 - **Installation directe de l'APK** : téléchargez l'APK depuis la [release GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1), puis exécutez-le sur votre appareil Android.
-- **Google Play** : [Markleaf sur Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **les mises à jour sont en pause** (voir la note ci-dessus). Si vous l'avez déjà, elle continue de fonctionner, mais obtenez la dernière version via F-Droid, GitHub ou GitLab.
+- **Google Play** : [Markleaf sur Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **les mises à jour sont en pause** (voir la note ci-dessus). Si vous l'avez déjà, elle continue de fonctionner ; obtenez la version actuelle via GitHub Releases ou via F-Droid une fois publiée.
 
 ### Compilation depuis les sources
 Si vous souhaitez compiler le projet ou contribuer, suivez ces étapes.

diff --git a/README.ja.md b/README.ja.md
@@ -34,7 +34,7 @@
 <p align="center">
   <a href="https://github.com/jeiel85/markleaf-android">GitHub リポジトリ</a> ·
   <a href="https://github.com/jeiel85/markleaf-android/discussions">Discussions（フィードバック）</a> ·
-  <a href="https://gitlab.com/jeiel85/markleaf-android">GitLab 公開ミラー</a>
+  <a href="https://gitlab.com/jeiel85/markleaf-android">GitLab ソースミラー</a>
 </p>
 
 <p align="center">
@@ -163,11 +163,11 @@ com.markleaf.notes
 ### インストール方法
 
 > [!NOTE]
-> **現在、Google Play での更新は一時保留中です。** 個人開発者の韓国の事業者登録に関するポリシー要件が解決するまで、新しいバージョンは Play ストアに公開しません。その間は **最新版を F-Droid、GitHub Releases、または GitLab Releases から入手してください。**（すでに Play ストアからインストール済みの場合はそのまま使えます。）
+> **現在、Google Play での更新は一時保留中です。** 個人開発者の韓国の事業者登録に関するポリシー要件が解決するまで、新しいバージョンは Play ストアに公開しません。最新リリースは **GitHub Releases** から入手してください。F-Droid のビルドが追いついた後は、F-Droid が推奨の更新経路です。（すでに Play ストアからインストール済みの場合はそのまま使えます。）
 
-- **F-Droid** *(推奨)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid クライアントで検索するか、上のリンクから直接インストールできます。同じ署名鍵（SHA-256 `0be97352…f91a`）を使用するため、GitHub/GitLab Releases の APK をサイドロードした場合でも途切れなく更新が続きます。
+- **F-Droid** *(自動更新に推奨)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid クライアントで検索するか、上のリンクから直接インストールできます。カタログへの公開は GitHub より遅れることがあるため、最新版がまだ表示されない場合は下の GitHub Releases を使ってください。同じ署名鍵（SHA-256 `0be97352…f91a`）を使用するため、最初に GitHub の APK をサイドロードしても更新は継続します。
 - **APK の直接インストール**: [GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) リリースから APK をダウンロードし、Android 端末で実行してインストールします。
-- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **更新は一時保留中**です（上の注記を参照）。すでにインストール済みなら引き続き使えますが、最新版は F-Droid・GitHub・GitLab から入手してください。
+- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **更新は一時保留中**です（上の注記を参照）。すでにインストール済みなら引き続き使えます。最新版は GitHub Releases、または反映後の F-Droid から入手してください。
 
 ### 開発環境の構築
 自分でビルドしたり貢献したい場合は、次の手順に従ってください。

diff --git a/README.ko.md b/README.ko.md
@@ -34,7 +34,7 @@
 <p align="center">
   <a href="https://github.com/jeiel85/markleaf-android">GitHub 저장소</a> ·
   <a href="https://github.com/jeiel85/markleaf-android/discussions">Discussions (피드백)</a> ·
-  <a href="https://gitlab.com/jeiel85/markleaf-android">GitLab 공개 미러</a>
+  <a href="https://gitlab.com/jeiel85/markleaf-android">GitLab 소스 미러</a>
 </p>
 
 <p align="center">
@@ -163,11 +163,11 @@ com.markleaf.notes
 ### 설치 방법
 
 > [!NOTE]
-> **Google Play 업데이트는 현재 잠정 보류 중입니다.** 1인 개발자의 한국 사업자 등록 요건 관련 정책 이슈가 정리될 때까지 새 버전을 Play Store에 올리지 않습니다. 그동안 **최신 버전은 F-Droid, GitHub Releases 또는 GitLab Releases에서 받아 주세요.** (Play Store에 이미 설치돼 있다면 그대로 사용할 수 있습니다.)
+> **Google Play 업데이트는 현재 잠정 보류 중입니다.** 1인 개발자의 한국 사업자 등록 요건 관련 정책 이슈가 정리될 때까지 새 버전을 Play Store에 올리지 않습니다. 최신 버전은 **GitHub Releases**에서 받으세요. F-Droid 빌드가 따라온 뒤에는 F-Droid가 권장 업데이트 경로입니다. (Play Store에 이미 설치돼 있다면 그대로 사용할 수 있습니다.)
 
-- **F-Droid** *(권장)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid 클라이언트에서 검색하거나 위 링크로 바로 설치할 수 있습니다. 동일 서명 키(SHA-256 `0be97352…f91a`)를 사용하므로 GitHub/GitLab Releases APK로 사이드로드한 경우에도 끊김 없이 업데이트가 이어집니다.
+- **F-Droid** *(자동 업데이트용 권장)*: [Markleaf on F-Droid](https://f-droid.org/packages/com.markleaf.notes/) — F-Droid 클라이언트에서 검색하거나 위 링크로 바로 설치할 수 있습니다. 카탈로그 반영은 GitHub보다 늦을 수 있으므로, 아직 최신 버전이 보이지 않으면 아래 GitHub Releases를 사용하세요. 동일 서명 키(SHA-256 `0be97352…f91a`)를 사용하므로 처음 GitHub APK를 사이드로드했어도 업데이트가 이어집니다.
 - **APK 직접 설치**: [GitHub v2.32.1](https://github.com/jeiel85/markleaf-android/releases/tag/v2.32.1) 릴리스에서 APK를 다운로드한 뒤 Android 기기에서 실행해 설치합니다.
-- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **업데이트 잠정 보류 중**입니다(위 안내 참고). 이미 설치돼 있으면 계속 쓸 수 있지만, 최신 버전은 F-Droid·GitHub·GitLab에서 받으세요.
+- **Google Play**: [Markleaf on Google Play](https://play.google.com/store/apps/details?id=com.markleaf.notes) — **업데이트 잠정 보류 중**입니다(위 안내 참고). 이미 설치돼 있으면 계속 쓸 수 있으며, 최신 버전은 GitHub Releases 또는 반영이 끝난 F-Droid에서 받으세요.
 
 ### 개발 환경 구축
 직접 빌드하거나 기여하고 싶다면 다음 과정을 따르세요.