fix: restore native text context menu

.project-docs/30-worklog/tasks/20260907-input-context-menu-a7c31e.md

@@ -0,0 +1,95 @@
+# Task: Fix AI programming input context menu
+
+## Identity
+
+- Task ID: 20260907-input-context-menu-a7c31e
+- Mode: Feature
+- Branch: codex/20260907-input-context-menu-a7c31e-input-context-menu
+- Worktree: D:\Datas\OthersProjects\.codex-worktrees\makelore\20260907-input-context-menu-a7c31e
+- Base commit: 8c13ae76db6fa47972bdf9ff3de932eb761aaffe
+- Owner: codex
+- Status: Ready for Integration
+
+## Scope
+
+- Reproduce the AI Programming composer symptom where right-clicking editable text
+  exposes no native editing menu.
+- Compare the current integrated primary-window wiring with completed task
+  `20260819-context-menu-impl-c7d4a2e1` and reuse only behavior still compatible
+  with the current window lifecycle.
+- Restore the smallest Main-owned native text-editing context-menu behavior and add
+  focused regression coverage at the real window/event seam.
+- Update user-facing documentation or Electron E2E coverage only where current
+  behavior and the shared fixture require it.
+
+## Intent And Constraints
+
+- Electron Main owns desktop context-menu integration. Do not add Renderer,
+  Preload, IPC, Host API, or direct clipboard access for this fix.
+- Use the primary window's `webContents` `context-menu` event and native editing
+  roles when that remains the confirmed compatible seam.
+- Show a menu only for editable controls or an existing text selection; derive
+  enabled actions from the actual Electron edit context.
+- Preserve Renderer-owned custom menus, Monaco behavior, the detached Agent Browser,
+  existing application-menu behavior, Chinese-only UI, and the single light visual
+  system.
+- Build a deterministic red-capable feedback loop for the reported input symptom
+  before selecting a cause or changing production code.
+- Work only in the isolated task worktree; do not modify, adopt, clean, or merge the
+  occupied root `main` worktree or any peer worktree.
+
+## Outcome
+
+- Confirmed the failure at the real Electron window seam: a renderer right-click
+  produced no native menu because the primary `webContents` had zero
+  `context-menu` listeners. The earlier implementation in task
+  `20260819-context-menu-impl-c7d4a2e1` exists only on its isolated branch and
+  was never integrated into the current `main` history.
+- Added a Main-owned text context-menu module that builds native Chinese
+  `cut`, `copy`, `paste`, and `selectAll` roles from Electron's actual
+  `isEditable`, `selectionText`, and `editFlags` context. Ordinary non-editable
+  content still produces no menu.
+- Registered the listener once during primary-window creation without adding
+  Renderer, Preload, IPC, Host API, or direct clipboard access.
+- Added five focused unit cases and an Electron E2E regression that dispatches
+  a real right-click inside the primary Renderer window and observes one native
+  menu popup with the expected editing actions.
+- Synchronized `README.md` with the restored desktop behavior and ownership
+  boundary.
+
+## Verification
+
+- Red phase:
+  - `corepack pnpm exec playwright test tests/e2e/context-menu.spec.ts` failed
+    twice with `popupCount: 0` before the production change.
+  - A temporary targeted probe reported zero `context-menu` listeners on the
+    primary `webContents`; the probe was removed before completion.
+  - `corepack pnpm exec vitest run tests/unit/context-menu.test.ts` failed to
+    resolve the absent Main module before implementation.
+- Green phase:
+  - `corepack pnpm exec vitest run tests/unit/context-menu.test.ts` — 5 passed.
+  - `corepack pnpm exec playwright test tests/e2e/context-menu.spec.ts` — 1
+    passed.
+  - `corepack pnpm run typecheck` — passed.
+  - `corepack pnpm exec eslint electron/main/context-menu.ts electron/main/index.ts tests/unit/context-menu.test.ts tests/e2e/context-menu.spec.ts`
+    — passed.
+  - `corepack pnpm run lint:check` — passed with 5 pre-existing warnings in
+    untouched files and no errors.
+  - `corepack pnpm run build:vite` — passed for Renderer, Main, Preload, and
+    release utility bundles; only existing chunk/dynamic-import warnings were
+    reported.
+  - `corepack pnpm test` — 226 test files passed; one unrelated real-process
+    timing assertion in `pi-agent-server-process-real.test.ts` measured 2323ms
+    against a 2000ms threshold. Its isolated rerun with
+    `corepack pnpm exec vitest run tests/unit/pi-agent-server-process-real.test.ts --maxWorkers=1`
+    passed all 6 tests, so no unrelated timing code or threshold was changed.
+  - `git diff --check` — passed.
+
+## Follow-ups
+
+- Integrate this ready branch through the project Integration Gate after the
+  current owner of the root `main` worktree releases it.
+
+## Promotion Candidates
+
+- None recorded.