← Back to wkappbot-core
wkappbot-core ★★★

# Hot-Swap Operator Cheatsheet (--force-swap + manual + 3-layer architecture)

Hot-swap operator reference. Covers force-swap (wkappbot --sudo --force-swap), manual orphan-kill + restage for stuck builds, and a 3-layer architecture recap (Eye FSW rename | Admin Eye self-respawn | MCP Launcher swap). Use when hot-swap misbehaves or when reasoning about which layer is responsible for a symptom.

user/developer
hotswap mcp orphan file-lock eye swap project v6-force-swap

## Steps

1. Force-swap one-shot: wkappbot --sudo --force...
2. Use --force-swap when: normal auto-swap sat...
3. Verify after --force-swap: ls -la bin/wkappb...
4. Manual path symptom: wkappbot hotswap prints...
5. Manual diagnosis: powershell.exe -Command Ge...
6. Manual Eye pid find: wkappbot a11y windows l...
7. Manual orphan identification: any wkappbot-c...
8. Manual kill: powershell.exe -Command Stop-Pr...
9. Manual restage and swap: cp D:/SDK/bin/wkapp...
10. Manual success check: a11y windows shows Eye...
11. Orphan workers come from Eye restart loops;...
12. Why --force-swap exists: 2026-04-19 session...
13. Architecture Layer 1 - Eye rename-swap (AppB...
14. Architecture Layer 2 - Admin Eye self-respaw...
15. Architecture Layer 3 - MCP Launcher swap (Mc...
16. Layer separation rule: Eye moves files. Laun...
17. Full gentle-swap flow: publish -> .new.exe s...
18. [AUDIT 2026-05-29] Program.cs split: TryAdmi...
19. [AUDIT 2026-06-03] source_refs broken: stale...
20. [AUDIT 2026-06-04] Program.cs: 'TryAdminHotS...

🔒 Pro Skill
Get Pro Access →