← 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
hotswapmcporphanfile-lockeyeswapprojectv6-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 →