verify

Verification Loop

A closed feedback loop you can run entirely yourself. It boots your current source (not the marketplace clone), seeds a known model, and lets you observe and assert every layer — including the rendered pixels.

The whole stack runs in one process (src/index.ts serves MCP over stdio and the HTTP API + UI), and the UI is origin-relative, so a single dedicated port gives you a consistent, isolated system to verify.

When to use

After changing anything in src/ (store, API routes, projection) or ui/. Run this before considering the change done.

The loop in one command

node scripts/verify/harness.mjs run

This: stops any prior harness server → rebuilds the UI iff ui/ is newer than dist/ui → boots source on port 3947 against the golden fixture → runs the API data-layer assertions → runs the MCP write-path smoke → runs the project-root resolution regression → prints PASS/FAIL and leaves the server up for the visual checks below.

The project-root regression (assert-project-root.mjs) guards a fixed bug: the server must map CLAUDE_PROJECT_DIR (the user's project), not its own cwd (which start.sh clobbers on marketplace installs). It boots an isolated server on a separate port and asserts projectRoot resolves correctly.

When done: node scripts/verify/harness.mjs down.

Other commands: up (boot only), down (stop + clean), status (is it up?).

Then verify the pixels (Playwright MCP)

The scripted run proves the data layer. Now confirm the rendered map. The server is at the URL printed by run (read scripts/verify/out/endpoint-port).

⚠️ Do the visual checks after the scripted asserts, in this order. Some interactions (semantic zoom) persist server state (a boundary perspective is written to the store), so the model drifts. If you re-run assert-api after interacting, first harness.mjs up to re-seed a fresh fixture.

1. Overview renders. browser_navigate to the URL. Then browser_evaluate: expect .react-flow mounted, .react-flow__node count 8, .react-flow__edge count 4, and the empty-state text absent. browser_take_screenshot → scripts/verify/out/01-map-overview.png.
2. Semantic zoom. Dispatch a bubbling click on .react-flow__node[data-id="boundary:Authentication"] (the boundary center is covered by children, so a normal center-click won't reach it; a dispatched bubbling click triggers React's delegated handler). Expect the URL to gain ?perspective=perspective%3AAuthentication, a breadcrumb Overview › Authentication, and the node set to become the 3 auth children + Charge card (contextual, because Verify credentials invokes it cross-boundary).
3. Flow highlight. Navigate back to /. Click the "User login" button in the FLOWS panel (it is a toggle — click once). Expect its label to turn accent (rgb(129, 140, 248)), the 3 flow nodes to show numbered step badges (1, 2, 3), and the 3 non-flow nodes to dim to opacity 0.25.
4. Console clean. browser_console_messages at level error, all: true → expect 0.