docs(@projects/@magic-civilization): 📝 p2-86 phase 2 done — MCP rendered tools verified via built TS

magic_civ_screenshot / open_screen tools + render_client TCP transport +
render-driver-server.sh, verified end-to-end through the compiled RenderClient
(ping {ok}, screenshot -> 3420x1923 PNG of the live world map). Only the
tool-surfacing-in-a-Claude-session step remains (needs a restart; dist/ builds
locally).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Natalie 2026-06-18 21:10:20 -05:00
parent 70537bc0d1
commit 8fd3ef4ee3
2 changed files with 20 additions and 8 deletions

View file

@ -33,10 +33,22 @@ complementing the headless state API.
`screenshot` / `open_screen` / `ping` / quit against the live rendered game and
returns the image path. Done via a **localhost TCP socket** (commit 22197a81c).
- [x] Works on plum (windowed); cloud path documented (weston/xvfb + GPU node).
- [ ] New MCP tools: **`magic_civ_screenshot`**, **`magic_civ_open_screen`** in
`index.ts` + `harness.ts` methods (connect to the driver's TCP port).
- [ ] `npm install` (never run — p2-67 phase 13) + `.mcp.json` entry + restart.
- [ ] Proof: from a Claude session, open a screen and capture via the MCP tool.
- [x] New MCP tools `magic_civ_screenshot` / `magic_civ_open_screen` (`index.ts`)
+ `render_client.ts` TCP transport + `scripts/render-driver-server.sh`.
- [x] `npm install` run (100 pkgs); build clean; `.mcp.json` already registers
`magic-civ``dist/index.js` (no change needed).
- [ ] Final proof: tools surface in a **Claude session** — needs a Claude restart
(the one step not self-verifiable from here). `dist/` is gitignored → built
locally; rebuild on each host (`npm install && npm run build`).
## Progress (2026-06-18) — Phase 2 done (modulo restart)
- TS tools wired + **verified through the BUILT code** (no Claude restart): the
compiled `RenderClient` spawned the rendered game via `render-driver-server.sh`,
connected over TCP, `ping → {ok}`, `screenshot → ` a real **3420×1923 PNG** of the
live world map. So the whole transport + driver path is proven; only the MCP
tool-registration surfacing awaits a restart.
- Commits: render driver `22197a81c`, auto-start `a1d5b3187`, TS tools `77b60d314`.
## Progress (2026-06-18) — Phase 1 done

View file

@ -1,11 +1,11 @@
{
"generated_at": "2026-06-19T01:30:48Z",
"generated_at": "2026-06-19T02:10:18Z",
"totals": {
"done": 247,
"missing": 5,
"partial": 34,
"oos": 31,
"done": 247,
"in_progress": 0,
"partial": 34,
"missing": 5,
"stub": 6,
"total": 323
},