[hyfdev]

Fixes voidzero-dev/void-platform#18

Problem

void mcp crashes with "Void docs directory not found" when run from a dist build or npm install.

resolveDocsDir() uses import.meta.url to find the docs directory by counting relative .. segments:

src/cli/mcp.ts  →  ../../skills/void/docs  →  <pkg-root>/skills/void/docs  ✓

But the build bundles into dist/mcp-*.mjs (1 level deep instead of 2), so the same ../.. overshoots:

dist/mcp-*.mjs  →  ../../skills/void/docs  →  <above-pkg-root>/skills/void/docs  ✗

The monorepo fallback also uses the wrong path (website/docs instead of docs).

Fix

Walk up the directory tree from the current file to find the nearest package.json, giving us a depth-agnostic package root. Then resolve docs paths relative to that root.

Also fixes the monorepo fallback path from website/docs → ../../docs (correct relative path to framework/docs/).

Test plan

• pnpm -C packages/void build — rebuild succeeds
• pnpm test packages/void/test/unit/mcp.test.ts — 11/11 unit tests pass
• pnpm test packages/void/test/integration/mcp-dist.test.ts — 2/2 dist integration tests pass (new)
• pnpm lint — 0 warnings, 0 errors
• pnpm fmt — clean
• Manual: echo '{"jsonrpc":"2.0","id":1,...}' | node dist/cli/cli.mjs mcp responds correctly

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Updates the void mcp CLI docs resolution to be build-depth agnostic by resolving the docs directory from the nearest package root (via walking up to package.json), fixing crashes when running from dist/ or an npm install.

Changes:

• Add findPackageRoot() and resolve bundled/monorepo docs paths relative to the detected package root in packages/void/src/cli/mcp.ts.
• Fix the unit test docs fallback path to point at the monorepo docs/ directory (though the current relative path still appears incorrect).
• Add a new dist-level integration test to validate MCP responses when running the built CLI from dist/.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.

File	Description
packages/void/src/cli/mcp.ts	Resolve docs directory from package root rather than relying on import.meta.url depth.
packages/void/test/unit/mcp.test.ts	Adjust test docs fallback path for monorepo docs lookup.
packages/void/test/integration/mcp-dist.test.ts	New integration coverage for MCP behavior when invoked via dist/cli/cli.mjs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.