From 424d9e03450f575b2274774620ea8dc113f084ef Mon Sep 17 00:00:00 2001
From: doxa-maps-88655c70
 <88627970+doxa-maps-88655c70@users.noreply.github.com>
Date: Mon, 21 Sep 2026 16:45:39 +0000
Subject: [PATCH] say what cap sync actually stages instead of a bundle count
 that matches nothing
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The Capacitor record claimed "21 bundles staged". That number matches nothing measurable
today: the tree has 18 built bundles, 17 of them in the manifest since key-cities is
withheld by gatedProfiles, and 19 subdirectories under public/doxa-maps, one of which is
assets and not a bundle at all.

More to the point, bundles was never the unit cap sync operates on — it copies webDir
wholesale. A count that names the wrong noun goes stale the moment the tree changes and
cannot be re-checked against anything, which is how the original figure survived several
sweeps unnoticed. The line now states what was actually verified.
---
 docs/README-SECTION-3-cli-commands.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

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`.