docs: integrate agent browser background debugging contract

.project-docs/30-worklog/tasks/20260927-merge-browser-focus-6edcb784.md

@@ -0,0 +1,42 @@
+# Task: Integrate agent browser tab focus fix
+
+## Identity
+
+- Task ID: 20260927-merge-browser-focus-6edcb784
+- Mode: Integration
+- Branch: main
+- Worktree: D:\Datas\OthersProjects\makelore
+- Base commit: 220e89992b4d847eadcc64bd8faf058d0e25d36d
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Integrate source a52e747 from task 20260927-browser-tab-focus-5c92d7a1 into local main. Promote its verified browser lifecycle/focus contract; no new product implementation.
+
+## Intent And Constraints
+
+- Concurrent and Planning Gates Passed. Official start/status establish exclusive integration ownership at 220e899. Entry, own/source records, relevant positioning, decisions, architecture, domain and verification context loaded. Refreshed 123 peer records; packaging-170 is isolated and has no product edits. Historical placeholder records remain unknown without a concrete dependency.
+- User confirmed release --force of the completed teacher-read integration and --adopt-existing of the three known foreign documents. They remain unchanged and outside this commit.
+- Current user request supersedes the old all-tools-require-visible-view rule: only first viewport initialization requests foreground presentation. Keep explicit teardown, sandbox, generation/project and CDP guards.
+- Plan: fast-forward exact source, verify source/product equality, promote canonical documentation, pass drift/whitespace checks and commit. Reuse source validation if product bytes are identical. No push, deployment, build artifact, installation, cleanup or new reviewer.
+
+## Outcome
+
+- Fast-forwarded local main from 220e899 to source a52e747a00fb5c6ff680bb7e4e691c07d003e34f without conflicts. Product, tests, README and imported source record match the tested source exactly.
+- Promoted the first-viewport versus hidden-tab distinction and hidden-screenshot behavior into architecture/domain/current-state/history. Explicit browser close, project/module/window teardown and sandbox/CDP boundaries are unchanged.
+- The three adopted foreign task documents remain unchanged and uncommitted. No remote push, package, installation, production request or deletion.
+
+## Verification
+
+- Exact source ancestry and product/test/README/source-record equality passed; no merge resolution or product edit occurred.
+- Reused source evidence: 134 related unit tests, 4 Electron scenarios, standard typecheck and Vite build passed. Extra Main-wide compiler check retains 66 baseline diagnostics, zero additions and none in touched files.
+- Whitespace and official task-aware documentation checks passed; adopted documents retain their recorded original states.
+
+## Follow-ups
+
+- Source worktree remains available pending the separate cleanup confirmation. Installed client still needs a rebuilt package to receive the fix.
+
+## Promotion Candidates
+
+- Source promotion accepted under the user's browser-fix and merge authorization; applied to module-map, data-flow, system-overview and business-rules. Older visibility wording is clarified; no unresolved product decision or source-record edit.