{ "checker": { "claims": [ { "claim": "The MCP server lets assistants read notes that were written to the brain", "command": "/tmp/node24/bin/pnpm --filter @brainstack/server dev tools/call {\"tool\": \"get_note\", \"arguments\": {\"path\": \"coldpass/probe-note.md\"}}", "evidence": "coldpass-7f3a9c\\\",\\n \\\"mtime\\\": 1792810848122,\\n \\\"checksum\\\": \\\"be4cda40418c05f3c124cea5da40d44fd2f0c41a28df00aeebee2caa6a0725e1\\\"\\n}\"}]}", "expected": "the note body with the marker is returned", "input": "{\"tool\": \"get_note\", \"arguments\": {\"path\": \"coldpass/probe-note.md\"}}", "kind": "claim", "outcome": "Real input produced the expected result: coldpass-7f3a9c", "source": "Assistants read and write the same notes through the MCP server", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "The core package test suite runs on PGlite, in process, with no database", "command": "/tmp/node24/bin/pnpm --filter @brainstack/core test", "evidence": "211 passed (211)\n Start at 03:10:02\n Duration 17.97s (transform 587ms, setup 0ms, collect 3.84s, tests 7.89s, environment 1ms, prepare 2.06s)\n\n", "expected": "all core test files pass", "input": "pnpm --filter @brainstack/core test", "kind": "claim", "outcome": "Real input produced the expected result: 211 passed", "returncode": 0, "source": "runs on PGlite, in process; no database needed", "source_checked": true, "source_file": "README.md", "verdict": "yes" } ], "cycle_checks": [ { "claim": "The server runs housekeeping on its own every hour, after purging at boot", "command": "/tmp/node24/bin/node --env-file= --import tsx ", "evidence": "hourly purge ran once: deleted=0", "expected": "one purge pass completes and reports the rows it deleted", "input": "current database state and wall clock", "kind": "cycle", "method": "run-once wrapper: calls the same purgeExpired function once against the live DATABASE_URL, no source edits, no fake clock", "outcome": "Triggered one cycle by hand (run-once wrapper: calls the same purgeExpired function once against the live DATABASE_URL, no source edits, no fake clock; normal trigger: every 60 minutes (60 * 60 * 1000 ms) in the long-running server; also once at boot): hourly purge ran once: deleted=0", "returncode": 0, "schedule": "every 60 minutes (60 * 60 * 1000 ms) in the long-running server; also once at boot", "source": "apps/server/src/serve.ts", "verdict": "yes" } ], "details": { "argv": [ "/tmp/node24/bin/pnpm", "--filter", "@brainstack/server", "dev" ], "hosting": "local", "kind": "mcp_http", "protocolVersion": "2025-06-18", "scope": "remote hosted MCP initialize + tools/list", "serverInfo": { "name": "brainstack", "version": "0.1.0" }, "tool_result": { "content": [ { "text": "{\n \"source\": \"own\",\n \"path\": \"coldpass/probe-note.md\",\n \"title\": \"Coldpass probe\",\n \"frontmatter\": {},\n \"body\": \"# Coldpass probe\\n\\nMarker: coldpass-7f3a9c\",\n \"mtime\": 1792810848122,\n \"checksum\": \"be4cda40418c05f3c124cea5da40d44fd2f0c41a28df00aeebee2caa6a0725e1\"\n}", "type": "text" } ] }, "tool_result_checked": true, "tool_schema_bytes": 32178, "tools": [ "search_brain", "get_note", "get_notes", "list_notes", "create_note", "update_note", "edit_note", "save_notes", "list_tree", "list_decisions", "create_folder", "move", "move_to_owner", "delete", "list_links", "list_outbound_links", "list_related", "list_unlinked_mentions", "gather_context", "place_note", "list_facets", "list_shared_with_me", "list_shares", "share_folder", "unshare", "get_brainstack_guide" ], "transport": "streamable-http", "url": "http://localhost:3000/api/mcp", "working": true }, "evidence_strength": "readme_checked", "example_checks": [ { "claim": "Build the whole monorepo", "command": "/tmp/node24/bin/pnpm build", "deferred": false, "evidence": "signup 5.42 kB 135 kB\napps/web build: \u2514 \u25cb /verify-email 3.46 kB 119 kB\napps/web build: + First Load JS shared by all 103 kB\napps/web build: \u251c chunks/18-c858b3a70433e430.js 46.5 kB\napps/web build: \u251c chunks/87c73c54-dd8d81ac9604067c.js 54.2 kB\napps/web build: \u2514 other shared chunks (total) 2.08 kB\napps/web build: \u0192 Middleware 33.1 kB\napps/web build: \u25cb (Static) prerendered as static content\napps/web build: \u0192 (Dynamic) server-rendered on demand\napps/web build: Done", "expected": "web app and server build", "input": "pnpm build", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md Local development", "verdict": "yes" }, { "claim": "Lint the workspace", "command": "/tmp/node24/bin/pnpm lint", "deferred": false, "evidence": "ace projects\npackages/core lint$ eslint \"src/**/*.ts\"\npackages/skill lint$ eslint . --ext .ts\npackages/skill lint: Done\npackages/core lint: Done\napps/server lint$ eslint \"src/**/*.ts\"\napps/server lint: Done\napps/web lint$ next lint --dir src\napps/web lint: `next lint` is deprecated and will be removed in Next.js 16.\napps/web lint: For new projects, use create-next-app to choose your preferred linter.\napps/web lint: For existing projects, migrate to the ESLint CLI:\napps/web lint: npx @next/codemod@canary next-lint-to-eslint-cli .\napps/web lint: \u2714 No ESLint warnings or errors\napps/web lint: Done", "expected": "no lint errors", "input": "pnpm lint", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md Local development", "verdict": "yes" }, { "claim": "Build the skill for every major client", "command": "/tmp/node24/bin/pnpm --filter @brainstack/skill build", "deferred": false, "evidence": "> @brainstack/skill@0.0.0 build \n> tsc -p tsconfig.build.json && node build/build.js\n\n[skill] built 6 adapters to ", "expected": "six client adapters built", "input": "pnpm --filter @brainstack/skill build", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md Loading the skill", "verdict": "yes" }, { "claim": "Run the full test suite", "command": "", "deferred": false, "evidence": "Ran pnpm test: packages/core passed 211/211 and apps/server ran most test files, but a vitest worker in apps/server crashed ('Worker exited unexpectedly') on each run, so pnpm test exits 1. Substitute: the core package test example above.", "expected": "documented command completes successfully", "input": "", "kind": "example", "outcome": "Ran pnpm test: packages/core passed 211/211 and apps/server ran most test files, but a vitest worker in apps/server crashed ('Worker exited unexpectedly') on each run, so pnpm test exits 1. Substitute: the core package test example above.", "source": "README.md Local development", "verdict": "blocked" } ], "status": "PASS" }, "deviations": [ "The pinned snapshot had no .git; ran the git init/remote/fetch --depth 1/reset --mixed sequence from the task first.", "Node was not installed. Installed Node v24.22.1 from the official tarball into /tmp/node24 and put it on PATH (required for corepack's shebang).", "Docker is absent, so the README's docker compose quickstart was not run. Used the README local-development path with PostgreSQL 16 from apt as the 'any Postgres' store.", "pnpm test exited 1. The apps/server vitest run had a worker die with 'Worker exited unexpectedly' (an unhandled error) on two runs; most test files passed. The cause is unconfirmed (possibly memory on this small VM, possibly a repo test issue). packages/core tests passed (211), and that was used as the core-test claim.", "The owner account and API key were created through the same HTTP API the web app uses (signup, login, tRPC apiKeys.create), not through the web UI.", "The hourly purge was run once by a hand-written wrapper outside the repo () calling purgeExpired, not by waiting an hour. It deleted 0 rows." ], "fault_owner": null, "main_blocker": null, "operation": "Run the BrainStack server locally (README 'Local development': pnpm install, then pnpm --filter @brainstack/server dev) and create and read back a note through its MCP endpoint", "operation_scope": "Local development on one Linux VM with a local PostgreSQL 16 database (apt). Docker was not available, so the docker compose quickstart was not run.", "outcome": "working", "plain_failure": null, "steps": [ "git init; git remote add origin https://github.com/Impulse-Labs-SAS/brainstack; git fetch --depth 1 origin 6fd684d6e57429d21f2cfeb16183f74a628b41a9; git reset --mixed FETCH_HEAD", "Install Node 24 (.nvmrc 24, engines >=24); corepack enable (pnpm 10.30.3)", "pnpm install", "pnpm build; pnpm lint; pnpm typecheck; pnpm test (exit 1, see deviations); pnpm --filter @brainstack/core test", "apt-get install postgresql (16); cp apps/server/.env.example apps/server/.env with DATABASE_URL pointing at the local DB", "pnpm --filter @brainstack/server dev (server on :3000 with HTTP and MCP at /api/mcp)", "POST /api/auth/signup, POST /api/auth/login, POST /api/trpc/apiKeys.create", "MCP streamable HTTP: create_note then get_note; get_note returned coldpass-7f3a9c", "pnpm --filter @brainstack/skill build" ], "stuck_step": null, "suggested_fix": "Investigate the apps/server vitest 'Worker exited unexpectedly' crash that makes pnpm test exit 1 on a small (2 CPU) VM, for example by checking memory use of the PGlite-heavy test files or limiting test workers, and confirm it passes on a clean machine." }