# AetherDesk AI PC Post-Validation Backlog

Generated: 2026-07-01

Rule: do not add more AI PC runtime surfaces until a served-preview validation report exists.

## P0: Evidence before completion

- Run static smoke when validation is allowed.
- Launch localhost preview.
- Generate a validation report scaffold.
- Test `1280x720` and short `900x520` viewport.
- Fill gate-by-gate evidence.
- Do not mark the goal complete until runtime evidence exists.

## P1: Fix runtime failures found by validation

Likely areas:

- overlay stacking and z-index collisions
- shortcut collisions from multiple document listeners
- short-screen density
- localStorage corruption fallback
- backend sync response-shape mismatch
- Safe Mode hiding too much or too little

## P2: Consolidate shell architecture

Use the refactor roadmap:

- `KeyboardRouter`
- `OverlayManager`
- `PersistentSurfaceManager`
- `LocalStateStore`
- `WindowOps`
- `BackendSyncBridge`
- `ProofAndHandoff`

Refactor only after behavior is known.

## P3: Manifest/docs/runtime alignment

After validation or refactor changes:

- update `aetherdesk-ai-pc-manifest.json`
- update `aetherdesk-ai-pc-acceptance-gates.json` if gates change
- update quick cards if shortcuts change
- update static smoke markers if sections are renamed
- update developer handoff with new evidence

## P4: Product polish after proof

Only after validation:

- reduce first-screen visual density if needed
- convert Control Map and Quick Help to render from shortcut registry
- add guided tour only if first-contact gate fails
- add backend-specific agent task details if `/api/pc/agent-task` is confirmed

## Current highest-value next command when allowed

```powershell
node C:\Users\issda\AetherDesk\scripts\aetherdesk-ai-pc-static-smoke.js
```

Then:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File C:\Users\issda\AetherDesk\scripts\aetherdesk-ai-pc-launch.ps1
```

Then:

```powershell
node C:\Users\issda\AetherDesk\scripts\aetherdesk-ai-pc-create-validation-report.js --validator "agent" --preview-url "http://127.0.0.1:5717/?resetDesktop=1" --viewports "1280x720,900x520" --backend-mode "static-preview"
```
