# iSphere AI Bridge Handoff - 2026-07-06 ## 1. Handoff summary This repository is ready to hand off for the next operator. Current branch: ```text codex/isphere-win-helper-first-phase ``` Current direction: ```text Go MCP server + C# ISphereWinHelper.exe ``` The Python MCP path has been removed from the active plan. The current first-phase surface exposes only four read-only WinHelper-backed MCP tools: ```text win_helper_version win_helper_self_check win_helper_scan_windows win_helper_dump_uia ``` No search, conversation opening, message sending, file sending/receiving, automatic login, injection, hook, memory reading, or endpoint-security bypass is implemented. ## 2. Current completed state Completed plan nodes: ```text N0 Baseline cleanup and direction lock N1 C# WinHelper baseline verification N2 Go module skeleton N3 Go helper protocol contract N4 Go helper process client N5 Helper client live verification N6 MCP library decision N7 Go MCP server skeleton N8 Four read-only MCP tool handlers N9 MCP stdio smoke verification N10 Operator runbook and process scripts N11 Commit and review checkpoint ``` N11 was completed with verification and commits. The latest checkpoint commits at handoff time are: ```text bbd2be8 docs: record final go mcp checkpoint reviews 57f1d42 docs: add go mcp runbook 17fa9dd test: add go mcp verification script 8956f33 feat: add go helper client and mcp tools 63cda71 docs: add go mcp plan and process logs 87e0e47 chore: remove temporary python mcp layer ``` After N11, the plan was adjusted because the current environment cannot log in to iSphere. The next step is not true N12 yet. It is now: ```text N12-pre: Offline evidence intake ``` ## 3. Current stop point Do not mark N12 as passed yet. True N12 still requires all of the following in the current environment: ```text 1. User manually opens iSphere in this environment. 2. User manually logs in. 3. iSphere main window is visible. 4. Go MCP read-only tools run against that live visible window. 5. win_helper_scan_windows finds the candidate window. 6. win_helper_dump_uia captures the UIA tree. 7. Output is saved under runs/real-loggedin-lab/uia-dumps/. ``` The user currently cannot log in inside this environment. Therefore, the next operator should start with offline evidence intake only. ## 4. New next step: N12-pre offline evidence intake The user has full permission over the test sandbox and can copy files from another sandbox where iSphere can be manually logged in. Do not ask the user to manually generate UIA JSON first. The practical route is: ```text Full sandbox artifact bundle ``` Expected location inside this repo after the user provides it: ```text runs/offline-evidence-intake// ``` Recommended package structure: ```text runs/offline-evidence-intake// raw/ user-profile/ install/ programdata/ temp/ shortcuts/ metadata/ notes/ copy-notes.txt ``` Important: `runs/*` is ignored by Git. Do not commit raw evidence packages. ## 5. What to ask the user to copy Ask the user to copy these from the sandbox that can log in to iSphere. ### 5.1 Full test user profile ```text C:\Users\\ ``` Place it under: ```text raw/user-profile/ ``` ### 5.2 iSphere / IMPlatformClient install directory Common parent locations: ```text C:\Program Files\ C:\Program Files (x86)\ D:\... ``` Everything keywords: ```text iSphere IMPlatformClient IMPlatform IMPP importal ``` Place install folders under: ```text raw/install/ ``` ### 5.3 ProgramData If size is acceptable, copy: ```text C:\ProgramData\ ``` Otherwise copy only directories matching: ```text iSphere IMPlatformClient IMPlatform IMPP importal ``` Place under: ```text raw/programdata/ ``` ### 5.4 Temp/importal/localcache High-priority path: ```text C:\Users\\AppData\Local\Temp\importal\ ``` Important names: ```text importal\localcache LoginLog ``` Place under: ```text raw/temp/importal/ ``` ### 5.5 Shortcuts Copy relevant shortcuts from: ```text C:\Users\\Desktop\ C:\Users\\AppData\Roaming\Microsoft\Windows\Start Menu\ C:\ProgramData\Microsoft\Windows\Start Menu\ ``` Place under: ```text raw/shortcuts/ ``` ### 5.6 Optional metadata If convenient, ask the user to include: ```text metadata/process-list.txt metadata/installed-programs.txt metadata/os-version.txt metadata/env.txt metadata/tree-user-profile.txt metadata/tree-install.txt metadata/tree-programdata.txt ``` ### 5.7 Copy notes Ask the user to write: ```text notes/copy-notes.txt ``` Minimal content: ```text source sandbox: windows user: iSphere manually logged in: yes/no client opened before copy: yes/no copy time: