docs: establish integrated project memory

.project-docs/30-worklog/current-state.md

@@ -0,0 +1,46 @@
+# Current State
+
+This file is the integrated default-branch snapshot. Feature tasks record progress in `30-worklog/tasks/{task_id}.md` and propose canonical changes for the Integration Gate. Feature tasks must not rewrite this file; it changes only in integration mode.
+
+## Integrated Through
+
+- Source task `20260811-native-display-f2456ea9`, product commit `50ac5bddc4f747b88064051f9038fa026280ab4b`.
+
+## Current Focus
+
+The current focus is field acceptance and production hardening of the native Android display while preserving the existing web, API, and queue invariants.
+
+## Recently Completed
+
+- 2026-08-12: Replaced the Android WebView wrapper with native overview/project Views and direct public API polling.
+- 2026-08-12: Added project-detail-only, three-repeat embedded Mandarin WAV announcements through streaming `AudioTrack`; overview remains silent.
+- 2026-08-12: Added full-range single-line fitting so a batch such as `00010 至 00011` is not clipped, and produced debug APK 1.5.2.
+- 2026-08-12: Retained and verified the responsive browser display adjustments for short landscape screens.
+
+## In Progress
+
+- No product code change is currently in progress on the integrated branch.
+
+## Next Recommended Steps
+
+1. Install debug APK 1.5.2 on the target television and accept representative single/range audio plus full range-number rendering.
+2. Before formal production rollout, build a release-signed APK with the organization's long-lived signing key.
+3. Confirm the legacy WAV asset ownership/redistribution basis before distributing the APK outside the authorized project deployment.
+4. Revalidate landscape behavior before raising Android targetSdk to 37 because the current Android 16 compatibility property is temporary.
+
+## Open Questions / Blockers
+
+- Target-TV audio routing, font metrics, and final range rendering cannot be fully verified by host-side tests.
+- The historical WAV generator, speaker, and separate license record are unknown.
+- The checked-in installable is debug-signed and is not a final production release artifact.
+
+## Risky Areas
+
+- Queue writes and same-session transitions require transaction/row-lock/revision invariants.
+- Public projections must remain free of personal data.
+- Android audio focus, cancellation, and `AudioTrack` lifecycle are vendor-sensitive.
+- Android large-screen orientation behavior changes at targetSdk 37.
+
+## Last Updated
+
+2026-08-12

.project-docs/30-worklog/session-notes/.gitkeep

@@ -0,0 +1 @@
+

.project-docs/30-worklog/task-history.md

@@ -0,0 +1,11 @@
+# Task History
+
+## Completed Tasks
+
+| Date | Task | Outcome | Docs Updated |
+|---|---|---|---|
+| 2026-08-12 | `20260811-native-display-f2456ea9` | Native Android display, embedded Mandarin announcements, range-fit regression fix, and APK 1.5.2 integrated in `50ac5bd` | Architecture, decisions, domain rules, evidence, reflection, commitments, current state |
+
+## Notes
+
+This is legacy integrated history. Feature tasks must not append here. Record new work in `30-worklog/tasks/{task_id}.md`; an integration workflow may render or summarize accepted history later.

.project-docs/30-worklog/task-template.md

@@ -0,0 +1,35 @@
+# Task: {title}
+
+## Identity
+
+- Task ID: {task_id}
+- Mode: {mode}
+- Branch: {branch}
+- Worktree: {worktree}
+- Base commit: {base_commit}
+- Owner: {owner}
+- Status: Planning
+
+## Scope
+
+- {scope}
+
+## Intent And Constraints
+
+- {intent_or_constraint}
+
+## Outcome
+
+- Not completed.
+
+## Verification
+
+- Not run.
+
+## Follow-ups
+
+- None recorded.
+
+## Promotion Candidates
+
+- None recorded.

.project-docs/30-worklog/tasks/20260812-finalize-native-display-7c23e18a.md

@@ -0,0 +1,50 @@
+# Task: Finalize native display integration
+
+## Identity
+
+- Task ID: 20260812-finalize-native-display-7c23e18a
+- Mode: Integration
+- Branch: main
+- Worktree: D:\Datas\PythonProjects\XQKqueue
+- Base commit: 50ac5bddc4f747b88064051f9038fa026280ab4b
+- Owner: codex
+- Status: Complete
+
+## Scope
+
+- Promote the completed native Android display task into canonical project memory from product commit `50ac5bddc4f747b88064051f9038fa026280ab4b`.
+- Verify the integrated source, canonical decisions, architecture, domain rules, evidence pointers, follow-up commitments, build output, and repository state.
+- Obtain an independent read-only final review and push the resulting `main` branch to `origin`.
+
+## Intent And Constraints
+
+- Integration worktree and lock are exclusively owned by this task.
+- Source task records/evidence are read-only at this base.
+- Canonical updates must preserve confirmed behavior and distinguish target-device acceptance gaps from completed host verification.
+- No new product behavior is introduced by this documentation/push task.
+
+## Outcome
+
+- Promoted project positioning, completion criteria, two accepted Android decisions, system/module/data-flow architecture, integrated state/history, durable business rules/glossary, evidence/reflection indexes, commitments, and known missing context.
+- Full local verification, APK integrity checks, canonical-memory audit, independent final review, and documentation ownership gate passed. The documentation commit and remote push are the remaining mechanical handoff steps.
+
+## Verification
+
+- Verified source commit `50ac5bddc4f747b88064051f9038fa026280ab4b` is present on local `main`.
+- Confirmed this task's base is that source commit, so the historical source records are unchanged during canonical promotion.
+- Android: `clean testDebugUnitTest lintDebug assembleDebug` passed; 56 tests, zero failures/errors/skips, zero lint errors.
+- Web: 18 test files / 66 tests passed; typecheck and production build passed.
+- Server: `go test ./...`, `go vet ./...`, and `go build ./...` passed.
+- APK metadata: package `cn.nianxx.queue.display`, versionCode 9, versionName 1.5.2, minSdk 23, targetSdk 36; v1/v2 signature verification passed.
+- Build APK, deliverable APK, and declared checksum all match SHA-256 `0D56C10B8CE706893F3EA8E59B21329847517F56F7347ABEA127AB30C6C71D77`.
+- `check_project_docs.py` passed and `check_doc_drift.py --task-id 20260812-finalize-native-display-7c23e18a` passed before independent review.
+- Canonical-memory audit corrected two overbroad statements (ticket calling is "up to N" and the current web client polls rather than consuming SSE), narrowed mutation guarantees to implemented endpoint contracts, and recorded privacy-retention/session rules plus the unregistered transition/reissue source paths.
+- Independent final integration review: PASS; no actionable P0/P1 blocker.
+
+## Follow-ups
+
+- Target-TV field acceptance, production signing, legacy audio-rights confirmation, and targetSdk 37 landscape revalidation are recorded in canonical commitments.
+
+## Promotion Candidates
+
+- None. This Integration task applies the accepted promotion candidates directly to canonical memory.