Document iteration 1: settings file, HA Dashboard tab, new hooks

README: settings file, --config, the new tab. ARCHITECTURE.md and
CLAUDE.md: prepare() hook, app command-line options, app code layout,
WebEngine notes, the moc raw-string pitfall. THIRD_PARTY_NOTICES: Qt
WebEngine. Ship config.example.json; the package README explains the
set-up. PROGRESS.md and DESIGN.md: phase 3 results and deviations.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

docs/PROGRESS.md

@@ -5,9 +5,12 @@ CLAUDE.md ("Working rules").
 
 ## Current state
 
-- **Implementation iteration 1 (DSH-1 and configuration), phase 3 (implementation).**
-  Requirements (D13) and design ([DESIGN.md](DESIGN.md)) are approved; the plan below was
-  approved on 2026-10-05.
+- **Implementation iteration 1 (DSH-1 and configuration), phase 3 (implementation) done,
+  waiting for the user's approval.** All plan steps are implemented and committed; next is
+  phase 4, testing on the Frame (plan item 10).
+- **Open point found:** started by SteamVR, the app writes no log file (the manifest passes no
+  `--log-file`, stderr goes to SteamVR). CFG-2 wants the settings error "in the log file and
+  on stderr". To be decided.
 
 ## Next steps
 
@@ -77,6 +80,23 @@ Known limitation: the bundled-Qt package does not support WebEngine in this iter
   present (relevant for Q2/Q3).
 - libmosquitto ABI check: Debian's 2.0.21 needs at most `OPENSSL_3.0.0`/`GLIBC_2.34`; the
   Frame has OpenSSL 3.2.1 and glibc 2.39. No libcjson dependency. D14 holds.
+- Phase 3 of implementation iteration 1:
+  - Platform: `prepare()` hook and app-specific command-line options, tested in
+    `tst_surfaces` (incl. `surfaces_prepare_fail`).
+  - Settings file (`src/config/`, new library `frameassistant_lib`), `--config`; `tst_config`
+    (37 cases). `config.example.json` in the package; README.txt explains the set-up.
+  - "HA Dashboard" tab: `WebEngineView`, `HaWebUi` with a persistent profile, WebEngine
+    initialisation in `main()`. Host: desktop mode loads a local test page, profile data
+    lands in `~/.local/share/frameassistant/webengine`; snapshot renders both tabs.
+  - Build containers with Qt WebEngine. Cross build: the aarch64 binary needs no private Qt
+    symbols, at most `Qt_6.8` and `GLIBC_2.34`. Container tests 8/8 (incl. Vulkan with
+    validation layers, no messages).
+  - Snags: moc misses classes in files with raw strings containing `//` (CLAUDE.md);
+    generated QML type registration includes headers by file name; Qt ≥ 6.9 hints at
+    `WebEngineProfilePrototype` (not in the Frame's 6.8). Deviations: `HaWebUi` lives in the
+    app, not the library; the password warning needs a password in the file.
+  - Not verified yet: WebEngine with a URL in the off-screen pipeline (Frame, phase 4); the
+    bundled package (not supported for WebEngine in this iteration).
 - Plan for implementation iteration 1 approved; phase 3 started.
 - Plan for implementation iteration 1 written; new tab "HA Dashboard" (D38, D39).
 - MVP implemented in four iterations; DSH-1 first, at the user's wish (D37).