isphere-ai-bridge/docs/process/go-implementation-log.md

# Go Implementation Log

## 2026-07-05 N0 基线确认

- 当前节点：N0 Baseline cleanup and direction lock。
- 修改文件：docs/process/go-implementation-log.md。
- 新增测试：无；本轮只做只读基线确认，不写 Go 代码，不创建 go.mod，不改 C#。
- 执行命令：
  - `Get-Content -LiteralPath docs/go-mcp-minimal-plan.md -Raw`
  - `git branch --show-current`
  - `git status --short`
  - `git ls-files -- 'native/ISphereWinHelper/*'`
  - `git ls-files -- 'src/isphere_ai_bridge/*'`
  - `git ls-files -- 'tests/test_*.py'`
  - `Test-Path -LiteralPath docs/go-csharp-helper-boundary.md -PathType Leaf`
  - `git ls-files -- 'go.mod'`
- 结果：
  - 当前分支为 `codex/isphere-win-helper-first-phase`。
  - `git status --short` 仅显示计划/过程文档：`docs/go-mcp-minimal-plan.md`、`docs/process/`。
  - `git ls-files` 包含 `native/ISphereWinHelper/HelperProtocol.cs`、`Program.cs`、`UiaDumper.cs`、`WindowScanner.cs`。
  - `git ls-files` 不包含 `src/isphere_ai_bridge/*`。
  - `git ls-files` 不包含 `tests/test_*.py`。
  - `docs/go-csharp-helper-boundary.md` 存在。
  - 不存在已跟踪 `go.mod`。
- 未解决问题：无 N0 阻塞项；注意当前计划文件与过程文档仍处于未跟踪状态，后续由对应节点/负责人按范围处理。
- 下一步建议：进入 N1 前先运行 `powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-win-helper.ps1`，通过后再启动 N2 Go module skeleton。

## 2026-07-05 N2 Go module skeleton

- 当前节点：N2 Go module skeleton。
- 修改文件：go.mod；docs/process/go-implementation-log.md。
- 新增测试：无；本轮只创建最小 Go module skeleton，未创建 package/server code。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N2 内容。
  - `go version`
  - `Set-Content -LiteralPath go.mod` 写入最小 module 元数据。
  - `go list ./...`
  - `git status --short --untracked-files=all`
- 结果：
  - Go 工具链可用：`go version go1.23.4 windows/amd64`。
  - `go.mod` 已创建，内容仅包含 `module isphere-ai-bridge` 和 `go 1.23`，未添加 `require` 依赖。
  - `go list ./...` 输出 `go: warning: "./..." matched no packages`，退出码为 0，符合 N2 无 package 可接受条件。
  - 未创建 `cmd/isphere-mcp`、`internal/helperclient`、`internal/tools`，未改 C#，未恢复 Python MCP。
- 未解决问题：无 N2 阻塞项；仓库中仍存在其他智能体维护的未跟踪过程文档，未在本轮修改。
- 下一步建议：等待业务经理批准 N3 后，再按计划创建 `internal/helperclient/contract.go` 和契约测试；当前不进入 N3。

## 2026-07-05 N3 Go helper protocol contract

- 当前节点：N3 Go helper protocol contract。
- 修改文件：internal/helperclient/client_test.go；internal/helperclient/contract.go；docs/process/go-implementation-log.md。
- 新增测试：新增 `TestContractVersionRequestMarshalsProtocol`、`TestContractSuccessResponsePreservesDataFields`、`TestContractErrorResponseUnmarshalsErrorCode`，均为纯 JSON contract 测试，不启动真实 C# helper。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N3 内容。
  - `Get-Content -LiteralPath docs/go-csharp-helper-boundary.md -Raw` 读取协议边界。
  - red：`go test ./internal/helperclient -run Contract -v`
  - `gofmt -w internal/helperclient/contract.go internal/helperclient/client_test.go`
  - green：`go test ./internal/helperclient -run Contract -v`
  - 补充验证：`go test ./...`
  - `git status --short --untracked-files=all`
- 结果：
  - red 阶段按预期失败，错误为缺少实现：`undefined: HelperRequest`、`undefined: HelperResponse`，`red_exit=1`。
  - 已创建最小结构 `HelperRequest`、`HelperResponse`、`HelperError`；JSON 字段包含 `protocol`、`request_id`、`op`、`timeout_ms`、`args`、`ok`、`data`、`error`、`warnings`。
  - `HelperResponse.Data` 使用 `map[string]json.RawMessage`，可保留 unknown data fields。
  - green 阶段通过：三个 Contract 测试均 PASS，`green_exit=0`。
  - 补充 `go test ./...` 通过，`all_exit=0`。
  - 未创建 `internal/helperclient/client.go`，未启动真实 C# helper，未创建 MCP server/tools/cmd，未添加外部依赖。
- 未解决问题：无 N3 阻塞项；`go.mod` 和其他过程文档仍为未跟踪状态，属于前序/其他智能体上下文，本轮未提交。
- 下一步建议：等待业务经理批准 N4 后，再实现 `internal/helperclient/client.go` 的进程调用；当前不进入 N4。

## 2026-07-05 N4 Go helper process client

- 当前节点：N4 Go helper process client。
- 修改文件：internal/helperclient/client.go；internal/helperclient/client_test.go；docs/process/go-implementation-log.md。
- 新增测试：新增 `TestClientMissingHelperPathReturnsStructuredError`、`TestClientBadHelperOutputReturnsStructuredError`、`TestClientTimeoutReturnsStructuredError`、`TestClientNonZeroExitCapturesStderrAsStructuredError`、`TestClientRealVersionCallWhenHelperIsBuilt`。测试 stub 使用 `t.TempDir()` 下临时 Go stub 源码和临时 exe，不在仓库内创建额外脚本/二进制源文件；真实 version 测试只调用已存在的 `runs/win-helper/ISphereWinHelper.exe`。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N4 内容。
  - `Get-Content -LiteralPath internal/helperclient/contract.go -Raw` 读取既有 contract。
  - red：`go test ./internal/helperclient -run Client -v`
  - `gofmt -w internal/helperclient/client.go internal/helperclient/client_test.go`
  - green：`go test ./internal/helperclient -run Client -v -count=1`
  - 补充验证：`go test ./... -count=1`
  - `git status --short --untracked-files=all`
- 结果：
  - red 阶段按预期失败，错误为缺少实现：`undefined: Client`、`undefined: ErrorCodeMissingHelper`、`undefined: ErrorCodeBadJSON`、`undefined: ErrorCodeTimeout`、`undefined: ClientError`，`red_exit=1`。
  - 已创建 `Client`、`Client.Call(ctx, op, args)` 和结构化 `ClientError`。
  - 默认 helper 路径解析到 repo 下 `runs/win-helper/ISphereWinHelper.exe`，测试可传入明确 `HelperPath`。
  - `Client.Call` 启动 helper with `--json`，向 stdin 写入 `isphere.helper.v1` 请求 JSON，读取 stdout，捕获 stderr，context timeout 后由 `exec.CommandContext` 终止进程。
  - missing helper、timeout、bad JSON、non-zero exit 均返回结构化 Go error；non-zero exit 捕获 stderr 和 exit code。
  - green 阶段通过：五个 Client 测试均 PASS，真实 version 输出 `real helper version ok: helper_name=ISphereWinHelper path=E:\coding\codex\isphere-ai-bridge\runs\win-helper\ISphereWinHelper.exe`，`client_green_exit=0`。
  - 补充 `go test ./... -count=1` 通过，`all_exit=0`。
  - 未创建 MCP server/tools/cmd，未创建 `internal/tools`/`internal/mcpserver`，未改 C# helper，未添加外部依赖，未复制 C# UIA 逻辑到 Go。
- 未解决问题：无 N4 阻塞项；本轮未提交，其他过程文档仍由各自智能体维护。
- 下一步建议：等待业务经理批准 N5 后，再运行 C# helper 验证脚本与完整 `go test ./internal/helperclient -v`；当前不进入 N5。

## 2026-07-05 N5 Helper client live verification

- 当前节点：N5 Helper client live verification。
- 修改文件：docs/process/go-implementation-log.md。
- 新增测试：无；本轮只执行 live verification，不修改 Go/C# 代码。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N5 内容。
  - `powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-win-helper.ps1`
  - `go test ./internal/helperclient -v`
  - `Select-String` 检查验证脚本与 helperclient 代码/测试中是否出现 `click/send/upload/download` 等动作词。
  - `git status --short --untracked-files=all`
- 结果：
  - PowerShell C# helper 验证退出 0：输出包含 `{"ok":true,"configuration":"Release","platform":"anycpu"..."output":"E:\\coding\\codex\\isphere-ai-bridge\\runs\\win-helper\\ISphereWinHelper.exe"}`。
  - PowerShell helper 运行验证退出 0：输出包含 `{"ok":true,"helper":"E:\\coding\\codex\\isphere-ai-bridge\\runs\\win-helper\\ISphereWinHelper.exe","version":"0.1.0","scan_window_count":30,"uia_available":true}`，`verify_win_helper_exit=0`。
  - Go helperclient 测试退出 0：`PASS`，`ok isphere-ai-bridge/internal/helperclient 4.329s`，`helperclient_test_exit=0`。
  - Go 测试输出包含真实 version 调用：`real helper version ok: helper_name=ISphereWinHelper path=E:\coding\codex\isphere-ai-bridge\runs\win-helper\ISphereWinHelper.exe`。
  - 验证脚本涉及 helper op：`version`、`self_check`、`scan_windows`、`dump_uia`；未执行点击/输入/发送/上传/下载。
  - `click/send/upload/download/发送/上传/下载/点击` 动作词检查无命中。
- 未解决问题：无 N5 阻塞项；本轮未提交，既有未跟踪计划/过程文档和 Go N2-N4 文件仍保持原状。
- 下一步建议：等待业务经理批准 N6 后，再进入 MCP library decision；当前不进入 N6。

## 2026-07-05 N6 MCP library decision

- 当前节点：N6 MCP library decision。
- 修改文件：docs/go-mcp-library-decision.md；go.mod；go.sum；docs/process/go-implementation-log.md。
- 新增测试：无；本轮只做 MCP library decision，不写 server code、不注册工具、不调用 C# helper。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N6 内容。
  - `go version`
  - `go list -m -versions github.com/modelcontextprotocol/go-sdk`
  - `go list -m -json github.com/modelcontextprotocol/go-sdk@v1.6.1`
  - 读取 Go module cache 中 `v1.6.1.mod` 和各稳定版本 go line。
  - `go get github.com/modelcontextprotocol/go-sdk@v1.3.1`
  - `go list github.com/modelcontextprotocol/go-sdk/mcp`
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.StdioTransport`
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.AddTool`
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.NewServer`
  - `go list -m all`
  - `git status --short --untracked-files=all`
- 结果：
  - 最终选择官方 SDK：module `github.com/modelcontextprotocol/go-sdk v1.3.1`，package `github.com/modelcontextprotocol/go-sdk/mcp`。
  - 不选择 `v1.6.1`/pre-release：本机 `go version go1.23.4 windows/amd64`；`v1.6.1.mod` 为 `go 1.25.0`；`v1.3.1` 为稳定版本且 `GoVersion: "1.23.0"`。
  - `go get github.com/modelcontextprotocol/go-sdk@v1.3.1` 成功；`go.mod` 更新为 `go 1.23.0`、`toolchain go1.23.4`，并加入 `github.com/modelcontextprotocol/go-sdk v1.3.1 // indirect`（N6 禁止写 server code，尚无 import，因此保持 Go 工具生成的 indirect 状态）；`go.sum` 新增 SDK 校验和。
  - `go doc` 验证 `mcp.StdioTransport`、`mcp.AddTool`、`mcp.NewServer` 可用；`AddTool` 支持 typed handler 和自动 JSON schema 推断。
  - `go list -m all` 退出 0，只出现一个 MCP-related dependency：`github.com/modelcontextprotocol/go-sdk v1.3.1`；其余为 SDK transitive dependencies。
  - 已创建极小决策文档 `docs/go-mcp-library-decision.md`，包含 package/module name、stdio support、tool registration style、JSON schema support、maintenance risk、why enough for four tools。
  - 未创建 `cmd/isphere-mcp`、`internal/mcpserver`、`internal/tools`；未写 server code；未注册工具；未调用 C# helper；未修改 C# helper。
- 未解决问题：无 N6 阻塞项；后续 N7 首次引入 package import 后，Go 工具可能将 SDK 从 indirect 调整为 direct。
- 下一步建议：等待业务经理批准 N7 后，再创建最小 Go MCP server skeleton；当前不进入 N7。

## 2026-07-05 N7 Go MCP server skeleton

- 当前节点：N7 Go MCP server skeleton。
- 修改文件：cmd/isphere-mcp/main.go；internal/mcpserver/server.go；internal/mcpserver/server_test.go；go.mod；go.sum；docs/process/go-implementation-log.md。
- 新增测试：新增 `TestNewServerConstructsEmptyMCPServer`，只验证空 MCP server 可构造；测试不启动 stdio、不调用 C# helper、不导入 helperclient。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N7 内容。
  - `Get-Content -LiteralPath docs/go-mcp-library-decision.md -Raw` 读取 N6 SDK 决策。
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.NewServer`
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.Server.Run`
  - `go doc github.com/modelcontextprotocol/go-sdk/mcp.StdioTransport`
  - 初次 red：`go test ./internal/mcpserver -v`
  - `go mod download all`
  - `go mod tidy`
  - 正确 red：`go test ./internal/mcpserver -v`
  - `gofmt -w internal/mcpserver/server.go internal/mcpserver/server_test.go cmd/isphere-mcp/main.go`
  - green：`go test ./internal/mcpserver -v -count=1`
  - required：`go test ./... -count=1`
  - required：`go build ./cmd/isphere-mcp`
  - `Select-String` 检查 main/server/test 中无 `helperclient`、`internal/tools`、`AddTool`、HTTP listener、Python、`ISphereWinHelper`。
  - `git status --short --untracked-files=all`
- 结果：
  - 初次 red 暴露 SDK import 后缺少 go.sum 传递校验和：`missing go.sum entry for module providing package github.com/google/jsonschema-go/jsonschema`，`server_red_exit=1`。
  - 因 N7 首次实际 import `github.com/modelcontextprotocol/go-sdk/mcp`，执行 `go mod download all` 和 `go mod tidy` 补齐必要 module 元数据；`go.mod` 将 SDK 调整为 direct require，并记录 SDK 的间接依赖；未添加第二个 MCP SDK。
  - 正确 red 阶段按预期失败，错误为缺少实现：`undefined: NewServer`，`server_red_after_tidy_exit=1`。
  - 已实现 `internal/mcpserver.NewServer()`，只调用 `mcp.NewServer` 构造无 feature/无 tool 的 server。
  - 已实现 `cmd/isphere-mcp/main.go`，只在 `mcp.StdioTransport` 上运行 server。
  - green 阶段通过：`TestNewServerConstructsEmptyMCPServer` PASS，`mcpserver_green_exit=0`。
  - `go test ./... -count=1` 通过：`cmd/isphere-mcp [no test files]`，`internal/helperclient` ok，`internal/mcpserver` ok，`all_green_exit=0`。
  - `go build ./cmd/isphere-mcp` 退出 0；构建临时产生的 `isphere-mcp.exe` 已删除，未保留额外构建产物。
  - 源码扫描无 `helperclient` import、无 `internal/tools`、无 `AddTool`/tool registration、无 HTTP listener、无 Python runtime、无 C# helper 调用。
- 未解决问题：无 N7 阻塞项；`go.mod/go.sum` 的 N7 变化是 SDK 包首次导入后的必要 module 元数据更新。
- 下一步建议：等待业务经理批准 N8 后，再创建 `internal/tools` 并注册四个 read-only `win_helper_*` tools；当前不进入 N8。

## 2026-07-05 N8 Four read-only MCP tool handlers

- 当前节点：N8 Four read-only MCP tool handlers。
- 修改文件：internal/tools/winhelper.go；internal/tools/winhelper_test.go；internal/mcpserver/server.go；internal/mcpserver/server_test.go；docs/process/go-implementation-log.md。
- 新增测试：新增 `TestWinHelperToolsRegisterExactlyFourReadOnlyTools`、`TestWinHelperToolSchemasExposeOnlyAllowedParameters`、`TestWinHelperHandlersCallHelperClientAbstractionWithCorrectOps`；扩展 `TestNewServerRegistersN8WinHelperToolsWithoutCallingHelper`，使用 SDK in-memory transport 验证 server list tools，不启动真实 C# helper。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N8 内容。
  - `Get-Content` 读取既有 `internal/mcpserver` 与 `internal/helperclient` 代码。
  - `go doc` 查看 `mcp.Tool`、`mcp.AddTool`、`mcp.ToolHandlerFor`、`mcp.CallToolResult`、in-memory transport 与 client API。
  - red：`go test ./internal/tools -v`
  - mcpserver 接入 red：`go test ./internal/mcpserver -run WinHelper -v`
  - `gofmt -w internal/tools/winhelper.go internal/tools/winhelper_test.go internal/mcpserver/server.go internal/mcpserver/server_test.go`
  - green：`go test ./internal/tools -v -count=1`
  - required：`go test ./... -count=1`
  - `Select-String` 扫描 N8 Go 源码中是否存在禁止工具名/动作词、直接 UIA/窗口实现、helperclient import、`mcp.AddTool` 数量。
  - `git status --short --untracked-files=all`
- 结果：
  - tools red 阶段按预期失败：`undefined: RegisterWinHelperTools`、`undefined: VersionArgs`、`undefined: SelfCheckArgs`、`undefined: ScanWindowsArgs`、`undefined: DumpUIAArgs`，`tools_red_exit=1`。
  - mcpserver 接入 red 阶段按预期失败：server tool names 为 `[]string{}`，期望四个 `win_helper_*` tools，`mcpserver_red_exit=1`。
  - 已实现并只注册四个工具：`win_helper_version`、`win_helper_self_check`、`win_helper_scan_windows`、`win_helper_dump_uia`；源码中 `mcp.AddTool` 恰好四处。
  - 参数结构限制：version/self_check 无业务参数；scan 只有 `include_all_visible`；dump 只有 `hwnd`、`max_depth`、`include_text`、`max_children`。
  - handler 通过 `HelperCaller` 抽象调用 `internal/helperclient`，映射 op 为 `version`、`self_check`、`scan_windows`、`dump_uia`；测试使用 fake caller 验证映射，不调用真实 helper。
  - `internal/mcpserver.NewServer()` 最小接入四个工具，构造/列工具不启动 C# helper。
  - green 阶段通过：三个 internal/tools 测试均 PASS，`tools_green_rerun_exit=0`。
  - `go test ./... -count=1` 通过：`cmd/isphere-mcp [no test files]`，`internal/helperclient` ok，`internal/mcpserver` ok，`internal/tools` ok，`all_green_rerun_exit=0`。
  - 禁止范围检查：未创建 `scripts/verify-go-mcp.ps1`；未出现 N9 script；未创建第五个工具；未实现 search/open/send/file/login；未发现直接 UIA API/WindowScanner/UiaDumper/user32/FindWindow/SendKeys 等逻辑。
- 未解决问题：无 N8 阻塞项；当前工具调用测试仍使用 fake caller，真实 MCP stdio smoke 留到 N9。
- 下一步建议：等待业务经理批准 N9 后，再创建并运行 `scripts/verify-go-mcp.ps1`；当前不进入 N9。

## 2026-07-05 N9 MCP stdio smoke verification

- 当前节点：N9 MCP stdio smoke verification。
- 修改文件：scripts/verify-go-mcp.ps1；docs/process/go-implementation-log.md。
- 新增测试：新增可重复运行的 PowerShell smoke verification 脚本；脚本构建 C# helper、构建 Go MCP binary，并用官方 Go MCP SDK in-memory harness 自动执行 initialize/connect、tools/list、tools/call `win_helper_version`。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N9 内容。
  - red：`powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-go-mcp.ps1`，在脚本缺失时运行。
  - `Get-Content` 读取 `scripts/build-win-helper.ps1`、`scripts/verify-win-helper.ps1`、当前 mcpserver/tools 代码。
  - 创建 `scripts/verify-go-mcp.ps1`。
  - green：`powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-go-mcp.ps1`。
  - `git status --short --untracked-files=all`
- 结果：
  - red 阶段按预期失败：`The argument 'scripts\verify-go-mcp.ps1' to the -File parameter does not exist`，`verify_go_mcp_red_exit=-196608`。
  - 初版 stdio PowerShell verifier 暴露 Windows PowerShell stdin BOM/encoding 问题：Go SDK 报 `invalid character 'ï' looking for beginning of value`；按 N9 允许路径切换为 SDK/test harness，不扩大修改 Go/C# 代码。
  - 最终脚本调用 `scripts\build-win-helper.ps1` 构建 C# helper，输出包含 `{"ok":true,..."output":"E:\\coding\\codex\\isphere-ai-bridge\\runs\\win-helper\\ISphereWinHelper.exe"}`。
  - 最终脚本构建 Go MCP binary 到系统临时目录，并在结束时清理临时目录。
  - SDK harness 自动执行 initialize/connect、tools/list、tools/call `win_helper_version`；输出包含 `{"action_tools_present":false,"helper_name":"ISphereWinHelper","initialized":true,"ok":true,"python_runtime_required":false,"real_isphere_login_required":false,"tool_count":4,"tools":["win_helper_dump_uia","win_helper_scan_windows","win_helper_self_check","win_helper_version"],"transport":"sdk_in_memory"}`。
  - 最终脚本输出包含 `{"ok":true,"verification":"go_mcp_sdk_harness","go_mcp_binary_built":true,"helper_name":"ISphereWinHelper","tool_count":4,..."action_tools_present":false}`，`verify_go_mcp_exit=0`。
  - 未要求真实 iSphere 登录；未引入 Python runtime；未创建新工具；未实现 search/send/file/autologin/injection/hook/memory-read。
- 未解决问题：无 N9 阻塞项；PowerShell 5 直接 stdio 写入存在 BOM 兼容问题，当前脚本使用计划允许的 SDK harness 路径完成同等 MCP 初始化、列工具和调用工具验证。
- 下一步建议：等待业务经理批准 N10 后，再创建 operator runbook；当前不进入 N10。

## 2026-07-05 N10 Operator runbook and process scripts

- 当前节点：N10 Operator runbook and process scripts。
- 修改文件：docs/go-mcp-runbook.md；docs/process/go-implementation-log.md。
- 新增测试：无；本轮只新增 operator runbook，并用 PowerShell/Select-String 做轻量文档覆盖验证。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N10 内容。
  - `Get-Content -LiteralPath README.md -TotalCount 80` 检查 README 是否已有明显 Go MCP 入口；未发现专门入口，因此不改 README。
  - 创建 `docs/go-mcp-runbook.md`。
  - `Select-String -LiteralPath docs/go-mcp-runbook.md -SimpleMatch` 验证 required commands、boundary phrases、四个 allowed tool names、runbook required sections。
  - `git status --short --untracked-files=all`
- 结果：
  - 已创建 `docs/go-mcp-runbook.md`，面向 operator，覆盖 Build C# helper、Verify C# helper、Build Go MCP、Verify Go MCP、Configure MCP client command、Allowed tools、Explicit non-goals、Real-login UIA capture procedure。
  - Runbook 原样包含必需命令：`powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-win-helper.ps1`、`go test ./...`、`go build ./cmd/isphere-mcp`、`powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-go-mcp.ps1`。
  - Runbook 包含四个 allowed tools：`win_helper_version`、`win_helper_self_check`、`win_helper_scan_windows`、`win_helper_dump_uia`。
  - Runbook 包含边界：`no login automation`、`no send message`、`no send file`、`no receive/download file`、`no process injection`、`no hook`、`no memory reading`，并明确无 Python MCP fallback、不实现搜索/会话/发送/文件/自动登录。
  - Runbook 写明 future send/file operations 必须有人类审批和审计，当前阶段未实现。
  - 轻量验证通过：`runbook_validation=ok required_count=23`。
  - 本轮未修改 Go/C# 功能代码，未新增工具，未改 MCP handlers，未创建 N10 以外的 runbook，未进入 N11，未提交。
- 未解决问题：无 N10 阻塞项；仓库仍保留前序 N2-N9 的未跟踪实现/过程文件，未在本轮回退或提交。
- 下一步建议：等待业务经理批准 N11 后，再执行 commit/review checkpoint；当前不进入 N11。

## 2026-07-05 N11-A verification and precise commit

- 当前节点：N11-A verification and precise commit for N0-N10 artifacts。
- 修改文件：docs/process/go-implementation-log.md。
- 新增测试：无；本轮只执行 N11-A 验证、清理临时构建产物、精确提交既有 N0-N10 产物。
- 执行命令：
  - `Get-Content/Select-String` 读取 `docs/go-mcp-minimal-plan.md` 的 N11 内容。
  - `powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-win-helper.ps1`
  - `powershell -NoProfile -ExecutionPolicy Bypass -File scripts\verify-go-mcp.ps1`
  - `go test ./...`
  - `go build ./cmd/isphere-mcp`
  - `git status --short`
  - `Remove-Item -LiteralPath isphere-mcp.exe -Force` 清理顶层临时 build 产物。
  - `git status --short --untracked-files=all`
  - 精确 `git add <具体路径...>`，禁止 `git add -A`。
  - 小提交：docs/process、Go helper/MCP、verify script、runbook。
- 结果：
  - `verify-win-helper.ps1` 退出 0，输出包含 `{"ok":true,"helper":"E:\\coding\\codex\\isphere-ai-bridge\\runs\\win-helper\\ISphereWinHelper.exe","version":"0.1.0","scan_window_count":30,"uia_available":true}`。
  - `verify-go-mcp.ps1` 退出 0，输出包含 `{"ok":true,"verification":"go_mcp_sdk_harness","go_mcp_binary_built":true,"helper_name":"ISphereWinHelper","tool_count":4,"tools":["win_helper_dump_uia","win_helper_scan_windows","win_helper_self_check","win_helper_version"],"python_runtime_required":false,"real_isphere_login_required":false,"action_tools_present":false}`。
  - `go test ./...` 退出 0：`cmd/isphere-mcp [no test files]`，`internal/helperclient` ok，`internal/mcpserver` ok，`internal/tools` ok。
  - `go build ./cmd/isphere-mcp` 退出 0；生成的顶层 `isphere-mcp.exe` 已删除，未提交 build 产物。
  - `git status --short` 在提交前仅显示 N0-N10 候选产物和临时 `isphere-mcp.exe`；临时 exe 已清理。
- 未解决问题：N11-A 不进入 N12；不真实采集登录 UIA；不实现新功能/新工具。N11-B 将在审查日志追加后执行最终 process checkpoint 提交。
- 下一步建议：完成 N11-A 精确提交后，等待业务经理/主协调进入 N11-B；当前不进入 N12。