{ "checker": { "claims": [ { "claim": "Whiteboard MCP lets the coding agent draw diagrams on a live board beside the chat", "command": "node mcp tools/call {\"tool\": \"canvas_draw\", \"arguments\": {\"elements\": [{\"type\": \"text\", \"id\": \"title\", \"text\": \"Hello whiteboard\"}]}}", "evidence": "\u2026Created: title\\nCanvas: 1 element \u00b7 bounds (0,0)\u2013(186,25) \u00b7 showing 1\\ntext \\\"title\\\" \\\"Hello whiteboard\\\" (0,0)\\ncould not open (spawn xdg-open ENOENT), so the human can't see the board yet; ask them to open http://127.0.0.1:47428/c/workspace-f807a4/21a94cc71be9bb3ff08775c569ac64da18cc477bc4e4f65f54f8efc926984595/.\"}]}", "expected": "the tool reports the element was created", "input": "{\"tool\": \"canvas_draw\", \"arguments\": {\"elements\": [{\"type\": \"text\", \"id\": \"title\", \"text\": \"Hello whiteboard\"}]}}", "kind": "claim", "outcome": "Real input produced the expected result: Created: title", "source": "Your coding agent draws diagrams on a live board beside the chat, and sees what you draw back.", "source_checked": true, "source_file": "README.md", "verdict": "yes" } ], "cycle_checks": [ { "claim": "Scheduled or looping main behavior", "command": "", "evidence": "Inspected README.md, docs/configuration.md, src/cli.ts and src/canvas/daemon.ts. The only interval (daemon.ts every(heartbeatMs, ...)) is an internal viewer-liveness heartbeat, not a user-facing cron, loop, webhook, --once or --now trigger, so no manual cycle was run.", "expected": "identify the product trigger", "input": "source inspection", "kind": "cycle", "outcome": "Inspected README.md, docs/configuration.md, src/cli.ts and src/canvas/daemon.ts. The only interval (daemon.ts every(heartbeatMs, ...)) is an internal viewer-liveness heartbeat, not a user-facing cron, loop, webhook, --once or --now trigger, so no manual cycle was run.", "source": "repository entry points", "verdict": "yes" } ], "details": { "argv": [ "node", "", "mcp" ], "kind": "mcp", "scope": "product operation", "serverInfo": { "name": "whiteboard-mcp", "version": "0.3.1" }, "tool_result": { "content": [ { "text": "Created: title\nCanvas: 1 element \u00b7 bounds (0,0)\u2013(186,25) \u00b7 showing 1\ntext \"title\" \"Hello whiteboard\" (0,0)\ncould not open (spawn xdg-open ENOENT), so the human can't see the board yet; ask them to open http://127.0.0.1:47428/c/workspace-eba417/21a94cc71be9bb3ff08775c569ac64da18cc477bc4e4f65f54f8efc926984595/.", "type": "text" } ] }, "tool_result_checked": true, "tool_schema_bytes": 7093, "tools": [ "canvas_open", "canvas_read", "canvas_draw", "canvas_delete", "canvas_focus", "canvas_screenshot", "canvas_mermaid", "canvas_export", "canvas_save", "canvas_search", "canvas_guide" ], "working": true }, "evidence_strength": "readme_checked", "example_checks": [ { "claim": "The CLI runs a tool once: whiteboard-mcp call [json] draws an element on the board", "command": "node call canvas_draw '{\"elements\":[{\"type\":\"text\",\"id\":\"note\",\"text\":\"CLI note\"}]}'", "deferred": false, "evidence": "Updated: note\nCanvas: 1 element \u00b7 bounds (0,0)\u2013(93,25) \u00b7 showing 1\ntext \"note\" \"CLI note\" (0,0)\ncould not open (spawn xdg-open ENOENT), so the human can't see the board yet; ask them to open http://127.0.0.1:47428/c/workspace-6faa26/21a94cc71be9bb3ff08775c569ac64da18cc477bc4e4f65f54f8efc926984595/.", "expected": "the tool reports the element was created", "input": "canvas_draw with one text element id note", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "docs/configuration.md", "verdict": "yes" }, { "claim": "npm test runs the unit and integration suite (CONTRIBUTING.md Development section)", "command": "npm test", "deferred": false, "evidence": "ests\u001b[22m\u001b[2m)\u001b[22m\u001b[32m 4\u001b[2mms\u001b[22m\u001b[39m\n \u001b[32m\u2713\u001b[39m tests/unit/registry.test.ts \u001b[2m(\u001b[22m\u001b[2m4 tests\u001b[22m\u001b[2m)\u001b[22m\u001b[32m 4\u001b[2mms\u001b[22m\u001b[39m\n \u001b[2m\u001b[90m\u2193\u001b[39m\u001b[22m tests/vscode/vscode.test.ts \u001b[2m(\u001b[22m\u001b[2m1 test\u001b[22m\u001b[2m | \u001b[22m\u001b[33m1 skipped\u001b[39m\u001b[2m)\u001b[22m\n\n\u001b[2m Test Files \u001b[22m \u001b[1m\u001b[32m19 passed\u001b[39m\u001b[22m\u001b[2m | \u001b[22m\u001b[33m1 skipped\u001b[39m\u001b[90m (20)\u001b[39m\n\u001b[2m Tests \u001b[22m \u001b[1m\u001b[32m298 passed\u001b[39m\u001b[22m\u001b[2m | \u001b[22m\u001b[33m1 skipped\u001b[39m\u001b[90m (299)\u001b[39m\n\u001b[2m Start at \u001b[22m 15:11:08\n\u001b[2m Duration \u001b[22m 57.19s\u001b[2m (transform 1.14s, setup 0ms, import 2.83s, tests 42.39s, environment 1ms)\u001b[22m", "expected": "all tests pass", "input": "none", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "CONTRIBUTING.md", "verdict": "yes" } ], "status": "PASS" }, "deviations": [ "Used the locally built dist/cli.js (the pinned source) instead of 'npx -y @ansuman-shukla/whiteboard-mcp' from the README, so the tested code is exactly the pinned commit.", "The README's npm test suite failed once on first run (tests/integration/mcp.test.ts 'exports inside the workspace and refuses paths outside the allowed roots'). Cause: the guest HOME is , which lies under the OS temp dir; the product's documented export rule allows the temp dir, so the export was accepted instead of refused. Rerun with HOME= (outside /tmp) passed 298 tests with 1 skipped. This is a guest-environment issue, not a product defect, and the example records the HOME override in its env.", "The /inputs/coldpass-preflight.py path named in the task does not exist; validation was run with as instructed.", "No cron/loop/webhook/--once/--now product cycle was found; cycles.json has detected=false." ], "fault_owner": null, "main_blocker": null, "operation": "Build the whiteboard-mcp server from the pinned source and drive its MCP stdio server to draw on a live canvas (canvas_draw returns 'Created: title'), plus the CLI 'call' subcommand and the documented npm test suite.", "operation_scope": "Linux guest, Node v22.23.4 (README/package.json require >=20), npm 10.9.9, Python 3.12.3 (checker). Local build of the pinned commit (dist/cli.js) rather than the published npx package. No browser was required; the Playwright browser download was skipped. Local daemon bound to 127.0.0.1 only.", "outcome": "working", "plain_failure": null, "steps": [ "npm ci (package.json devDependencies; PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1 NODE_USE_ENV_PROXY=1)", "npm run build (vite frontend + tsc server; CONTRIBUTING.md 'npm run build')", "node dist/cli.js call canvas_guide '{}' (CLI 'call' subcommand, docs/configuration.md)", "node dist/cli.js call canvas_draw with a rectangle, then canvas_read (round trip)", "node dist/cli.js mcp tools/call canvas_draw with a text element (MCP probe and README claim)", "npm test (CONTRIBUTING.md Development section)" ], "stuck_step": null, "suggested_fix": "None required for the working path. Optionally make the export-refusal integration test independent of HOME location (for example by setting HOME outside os.tmpdir() in the test), so that npm test passes in guests where the home directory is under /tmp." }