test(agent-workspace): deepen pane lifecycle evidence for m7.2

Author: Jacobinwwey

docs/brainstorms/2026-04-16-mainline-ci-stabilization-and-m7-direction-requirements.md

@@ -155,6 +155,19 @@ Deliverables:
 - expanded behavior/runtime tests for focus-path coexistence + fullscreen promote/restore lifecycle.
 - explicit assertions around `requestBridgeWindowVisibility` transitions.
 
+#### M7.2 Progress Note (2026-04-16)
+
+- [Done] expanded source-level runtime behavior coverage in:
+  - `src/agent_workspace.runtime.behavior.test.ts`
+- [Done] added coexistence lifecycle assertions:
+  - focus action remains available while path dock is visible,
+  - path dock fullscreen enter/exit preserves reversible state transitions.
+- [Done] added deterministic bridge visibility transition assertions:
+  - close-button hide path -> `requestBridgeWindowVisibility(false, reason=agent-workspace-hide-path-dock)`,
+  - `nc:pathmode:exited` hide path -> same reasoned bridge-hide request.
+- [Done] verification evidence:
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+
 ### M7.3 (Then): Foundation Re-entry Readiness Checklist (No Overclaim)
 
 Deliverables:

docs/diataxis/en/explanation/development-progress-dashboard.md

@@ -258,6 +258,17 @@ Execution anchor:
   - failing references: `24405317254`, `24404975285`,
   - recovered run: `24502592419` (`Migration Gates` all green, including runtime/browser/tauri agent-workspace suites).
 
+## Latest Mainline Increment (2026-04-16 M7.2 Runtime Evidence Deepening Lane)
+
+- Expanded runtime behavior coverage in `src/agent_workspace.runtime.behavior.test.ts` for pane lifecycle evidence:
+  - focus-mode action and path-dock visibility coexistence,
+  - path fullscreen enter/exit reversible transitions while dock remains active.
+- Added deterministic bridge visibility assertions for hide transitions:
+  - close-button hide path requests bridge visibility off with `reason=agent-workspace-hide-path-dock`,
+  - `nc:pathmode:exited` event path hide follows the same bridge-hide reason contract.
+- Verification evidence:
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+
 ## Mainline vs Working-Branch Snapshot (2026-04-14)
 
 | Capability Slice | Working Branch (`feat/learning-multi-tutor-adapter`) | Mainline (`origin/main`) | Integration Status |

docs/diataxis/zh/explanation/development-progress-dashboard.md

@@ -258,6 +258,17 @@
   - 历史失败参考：`24405317254`、`24404975285`，
   - 修复后运行：`24502592419`（`Migration Gates` 全绿，含 runtime/browser/tauri 三个 agent-workspace 套件）。
 
+## 主线最新增量（2026-04-16 M7.2 运行时证据加深链路）
+
+- 已在 `src/agent_workspace.runtime.behavior.test.ts` 扩展 pane 生命周期证据覆盖：
+  - focus 动作与 path dock 可并存，
+  - path fullscreen 进入/退出保持可逆状态变更。
+- 已增加 bridge 可见性收敛断言：
+  - close 按钮隐藏 path 时触发 `requestBridgeWindowVisibility(false, reason=agent-workspace-hide-path-dock)`，
+  - `nc:pathmode:exited` 事件触发隐藏时复用同一 reason 合同。
+- 验证证据：
+  - `npm test -- src/agent_workspace.runtime.behavior.test.ts --runInBand`
+
 ## 主线 vs 工作分支快照（2026-04-14）
 
 | 能力切片 | 工作分支（`feat/learning-multi-tutor-adapter`） | 主线（`origin/main`） | 集成状态 |

src/agent_workspace.runtime.behavior.test.ts

@@ -325,6 +325,109 @@ describe('agent workspace runtime behavior', () => {
         );
     });
 
+    test('keeps focus mode and path dock coexistence during fullscreen lifecycle', async () => {
+        const fetchMock = jest.fn().mockResolvedValue({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                success: true,
+                result: {
+                    userId: 'agent_user_default',
+                    message: 'Found 1 local knowledge point(s).',
+                    knowledgePoints: [
+                        {
+                            atomId: 'atom-coexist-1',
+                            title: 'Coexist Candidate',
+                            snippet: 'Focus then path dock.',
+                            score: 0.73,
+                            capabilities: [
+                                {
+                                    actionId: 'open_focus_mode',
+                                    label: 'Focus',
+                                    request: { userId: 'agent_user_default', atomId: 'atom-coexist-1' },
+                                    execution: { kind: 'frontend_only' },
+                                },
+                            ],
+                        },
+                    ],
+                },
+            }),
+        });
+        (global as unknown as Record<string, unknown>).fetch = fetchMock;
+
+        const runtime = runtimeModule.createAgentWorkspaceRuntime({ defaultUserId: 'agent_user_default' });
+        runtime.init();
+
+        const input = document.getElementById('agent-workspace-input') as HTMLTextAreaElement;
+        const form = document.getElementById('agent-workspace-form') as HTMLFormElement;
+        input.value = 'focus then open path';
+        form.dispatchEvent(new dom!.window.Event('submit', { bubbles: true, cancelable: true }));
+        await flushAsync();
+
+        const pointCard = document.querySelector('.agent-workspace-point-card') as HTMLElement;
+        expect(pointCard).not.toBeNull();
+        pointCard.click();
+
+        runtime.openLearningPathDock('atom-coexist-1');
+        await flushAsync();
+
+        expect(document.body.classList.contains('agent-workspace-enabled')).toBe(true);
+        expect(document.body.classList.contains('agent-workspace-path-visible')).toBe(true);
+        expect(document.body.classList.contains('agent-workspace-path-fullscreen')).toBe(false);
+        const graphWrapper = document.getElementById('graph-wrapper') as HTMLElement;
+        expect(graphWrapper.style.display).toBe('block');
+
+        runtime.togglePathFullscreen();
+        expect(document.body.classList.contains('agent-workspace-path-fullscreen')).toBe(true);
+        runtime.togglePathFullscreen();
+        expect(document.body.classList.contains('agent-workspace-path-fullscreen')).toBe(false);
+
+        const pathApp = (global as unknown as Record<string, unknown>).pathApp as Record<string, jest.Mock>;
+        expect(pathApp.requestBridgeWindowVisibility).toHaveBeenCalledWith(
+            true,
+            expect.objectContaining({ reason: 'agent-workspace-open-path-dock' })
+        );
+        const focusOnNode = (global as unknown as Record<string, unknown>).focusOnNode as jest.Mock;
+        expect(focusOnNode).toHaveBeenCalledWith('atom-coexist-1');
+    });
+
+    test('sends deterministic bridge-hide transitions for close button and path exit event', async () => {
+        const runtime = runtimeModule.createAgentWorkspaceRuntime({ defaultUserId: 'agent_user_default' });
+        runtime.init();
+
+        runtime.openLearningPathDock('atom-close-1');
+        await flushAsync();
+
+        const pathApp = (global as unknown as Record<string, unknown>).pathApp as Record<string, jest.Mock>;
+        pathApp.requestBridgeWindowVisibility.mockClear();
+
+        const closeButton = document.getElementById('agent-workspace-close-learning-path') as HTMLButtonElement;
+        closeButton.click();
+        await flushAsync();
+
+        expect(document.body.classList.contains('agent-workspace-path-visible')).toBe(false);
+        expect(document.body.classList.contains('agent-workspace-path-fullscreen')).toBe(false);
+        const pathContainer = document.getElementById('path-container') as HTMLElement;
+        expect(pathContainer.style.display).toBe('none');
+        expect(pathApp.requestBridgeWindowVisibility).toHaveBeenCalledWith(
+            false,
+            expect.objectContaining({ reason: 'agent-workspace-hide-path-dock' })
+        );
+
+        runtime.openLearningPathDock('atom-close-2');
+        await flushAsync();
+        pathApp.requestBridgeWindowVisibility.mockClear();
+
+        dom!.window.dispatchEvent(new dom!.window.CustomEvent('nc:pathmode:exited'));
+        await flushAsync();
+
+        expect(document.body.classList.contains('agent-workspace-path-visible')).toBe(false);
+        expect(pathApp.requestBridgeWindowVisibility).toHaveBeenCalledWith(
+            false,
+            expect.objectContaining({ reason: 'agent-workspace-hide-path-dock' })
+        );
+    });
+
     test('executes study session capability and renders summary message', async () => {
         const fetchMock = jest
             .fn()