diff --git a/docs/README-SECTION-3-cli-commands.md b/docs/README-SECTION-3-cli-commands.md index d1fab0a78..6ba5f42cb 100644 --- a/docs/README-SECTION-3-cli-commands.md +++ b/docs/README-SECTION-3-cli-commands.md @@ -90,8 +90,16 @@ needs no Android toolchain at all; `cap:verify` then asserts `capacitor/android/app/src/main/assets/public/index.html` exists. That guards the soft failure `capacitor.config.json` warns about — *a wrong `webDir` yields an EMPTY `assets/public` and a BLANK WHITE SCREEN at launch, not an error*. Verified 2026-09-20 with -`java`, `gradle`, `adb` and `sdkmanager` all absent: sync EXIT=0, 21 bundles staged, -`cap:verify` OK. Negative-tested by removing `index.html` — EXIT=1. +`java`, `gradle`, `adb` and `sdkmanager` all absent: sync EXIT=0, the whole `public/` tree +staged into the native assets, `cap:verify` OK. Negative-tested by removing `index.html` — EXIT=1. + +> **Why this says "the whole tree" and not a bundle count.** It used to read "21 bundles staged". +> That number matched nothing measurable: the tree today has **18 built bundles**, **17** of them +> listed in `manifest.json` (`key-cities` is withheld by `gatedProfiles`), and **19** +> subdirectories under `public/doxa-maps/` — one of which is `assets/`, not a bundle at all. +> `cap sync` copies `webDir` wholesale, so *bundles* was never the unit it operates on. A count +> that names the wrong noun goes stale the moment the tree changes and cannot be re-checked, +> which is exactly how the original figure survived unnoticed. **Status: built + contract-proven; not shot.** The APK itself (`gradlew assembleDebug`) and its launch on a device still need JDK 17 + the Android SDK + `adb`.