[refactor] harden app version identity contract

Signed-off-by: Viwat Vchirawongkwin <viwat.v@chula.ac.th>

Author: yyods

app/test/unit/app_version_contract_test.dart

@@ -37,4 +37,25 @@ void main() {
       reason: 'PBLE/1 HELLO must match the package base version exactly',
     );
   });
+
+  test('production PBLE/1 HELLO consumes the shared app identity', () {
+    final String mainSource = File(
+      '${appPackageRoot().path}/lib/main.dart',
+    ).readAsStringSync();
+
+    expect(
+      mainSource,
+      matches(
+        RegExp(
+          r'PbleConnectionManager\.production\('
+          r'\s*appName:\s*kAppName,'
+          r'\s*appVersion:\s*kAppVersion,'
+          r'\s*\)',
+        ),
+      ),
+      reason:
+          'the production manager must not replace either shared constant '
+          'with an independently versioned literal',
+    );
+  });
 }

docs/decisions/0044-start-app-v020-beta-train-at-build-5.md

@@ -8,13 +8,13 @@
 
 ## Context
 
-The installed app identity remains `0.1.0+4`, but build 4 is a retained
-TestFlight handoff bound to an earlier source commit. Since that handoff, the
-app source has gained a coherent set of compatible beta features: connected
-board identity, the numbered and adjustable rich editor, SHA-pinned GitHub
-import, the editable official examples-repository default with branch-only
-discovery, session-bound visible-file multi-delete, and a one-row responsive
-Files toolbar.
+Before this decision, the installed app identity was `0.1.0+4`; build 4 remains
+a retained TestFlight handoff bound to an earlier source commit. Since that
+handoff, the app source has gained a coherent set of compatible beta features:
+connected board identity, the numbered and adjustable rich editor, SHA-pinned
+GitHub import, the editable official examples-repository default with
+branch-only discovery, session-bound visible-file multi-delete, and a one-row
+responsive Files toolbar.
 
 Reinstalling a different source state under the same version and build works
 for local development, but it makes About, screenshots, HIL evidence, and
@@ -70,8 +70,8 @@ previously assigned a numbered milestone to the current Unreleased app work.
    moving branch tip.
 
 8. **Keep delivery test-first and local until accepted.** The synchronization
-   test lands red before the version implementation. The exact release build is
-   installed and physically reviewed on iPad before any pull request or push
+   test lands red before the version implementation. The exact candidate build
+   is installed and physically reviewed on iPad before any pull request or push
    for this combined feature branch.
 
 ## Consequences