byterover-cli 3.5.0 → 3.5.1

package/dist/server/infra/mcp/mcp-server.js

@@ -39,6 +39,9 @@ export class ByteRoverMcpServer {
         this.server = new McpServer({
             name: 'byterover',
             version: config.version,
+        }, {
+            instructions: 'ByteRover MCP — curate and query project context trees. ' +
+                'See the `cwd` parameter description on each tool for how to provide the project path correctly.',
         });
         this.connectOptions = {
             clientType: 'mcp',

package/dist/server/infra/mcp/tools/brv-curate-tool.js

@@ -2,19 +2,15 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
-import { associateProjectWithRetry, resolveMcpTaskContext, } from './mcp-project-context.js';
+import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
+import { cwdField } from './shared-schema.js';
 export const BrvCurateInputSchema = z.object({
     context: z
         .string()
         .optional()
         .describe('Knowledge to store: patterns, decisions, errors, or insights about the codebase. Required unless files or folder are provided.'),
-    cwd: z
-        .string()
-        .optional()
-        .describe('Working directory of the project (absolute path). ' +
-        'Required when the MCP server runs in global mode (e.g., Windsurf). ' +
-        'Optional in project mode — defaults to the project directory.'),
+    cwd: cwdField,
     files: z
         .array(z.string())
         .max(5)

package/dist/server/infra/mcp/tools/brv-query-tool.js

@@ -2,16 +2,12 @@ import { waitForConnectedClient } from '@campfirein/brv-transport-client';
 import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { TransportTaskEventNames } from '../../../core/domain/transport/schemas.js';
-import { associateProjectWithRetry, resolveMcpTaskContext, } from './mcp-project-context.js';
+import { associateProjectWithRetry, resolveMcpTaskContext } from './mcp-project-context.js';
 import { resolveClientCwd } from './resolve-client-cwd.js';
+import { cwdField } from './shared-schema.js';
 import { waitForTaskResult } from './task-result-waiter.js';
 export const BrvQueryInputSchema = z.object({
-    cwd: z
-        .string()
-        .optional()
-        .describe('Working directory of the project (absolute path). ' +
-        'Required when the MCP server runs in global mode (e.g., Windsurf). ' +
-        'Optional in project mode — defaults to the project directory.'),
+    cwd: cwdField,
     query: z.string().describe('Natural language question about the codebase or project'),
 });
 /**

package/dist/server/infra/mcp/tools/index.d.ts

@@ -1,4 +1,5 @@
 export { registerBrvCurateTool } from './brv-curate-tool.js';
 export { registerBrvQueryTool } from './brv-query-tool.js';
 export { resolveClientCwd } from './resolve-client-cwd.js';
+export { CWD_DESCRIPTION, cwdField } from './shared-schema.js';
 export { waitForTaskResult } from './task-result-waiter.js';

package/dist/server/infra/mcp/tools/index.js

@@ -1,4 +1,5 @@
 export { registerBrvCurateTool } from './brv-curate-tool.js';
 export { registerBrvQueryTool } from './brv-query-tool.js';
 export { resolveClientCwd } from './resolve-client-cwd.js';
+export { CWD_DESCRIPTION, cwdField } from './shared-schema.js';
 export { waitForTaskResult } from './task-result-waiter.js';

package/dist/server/infra/mcp/tools/shared-schema.d.ts

@@ -0,0 +1,3 @@
+import { z } from 'zod';
+export declare const CWD_DESCRIPTION: string;
+export declare const cwdField: z.ZodOptional<z.ZodString>;

package/dist/server/infra/mcp/tools/shared-schema.js

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export const CWD_DESCRIPTION = 'Absolute path to the project root — selects which ByteRover context tree to use ' +
+    String.raw `(e.g., "/Users/me/code/myapp", "C:\\code\\myapp").` +
+    '\n\n' +
+    'When to provide:\n' +
+    '- If your runtime does NOT expose any workspace/project context to you ' +
+    '(e.g., Claude Desktop, hosted MCP, global Windsurf): you MUST provide cwd. ' +
+    'Use the path the user mentions, or ASK the user for the absolute path if unknown.\n' +
+    '- If your runtime DOES expose an open workspace/project root to you ' +
+    '(e.g., Cursor, Cline, Zed, Claude Code): you can OMIT this field — ' +
+    'the MCP server was launched from that same project and already knows the cwd. ' +
+    'Providing it is harmless but unnecessary.\n' +
+    '\n' +
+    'If you omit cwd and the tool returns an error about the project not being resolved or cwd being required, retry with cwd explicitly set to the project root path.\n' +
+    '\n' +
+    'Never guess, never invent paths, never use relative paths.';
+export const cwdField = z.string().optional().describe(CWD_DESCRIPTION);

package/oclif.manifest.json

@@ -1676,84 +1676,6 @@
         "reject.js"
       ]
     },
-    "space:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all teams and spaces (deprecated)",
-      "examples": [
-        "<%= config.bin %> space list"
-      ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "space:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "space",
-        "list.js"
-      ]
-    },
-    "space:switch": {
-      "aliases": [],
-      "args": {},
-      "description": "Switch to a different space (deprecated)",
-      "examples": [
-        "<%= config.bin %> space switch"
-      ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "space:switch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "space",
-        "switch.js"
-      ]
-    },
     "source:add": {
       "aliases": [],
       "args": {
@@ -1877,57 +1799,31 @@
         "remove.js"
       ]
     },
-    "worktree:add": {
+    "space:list": {
       "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the directory to register as a worktree (relative or absolute)",
-          "name": "path",
-          "required": false
-        }
-      },
-      "description": "Register a directory as a worktree of this project",
+      "args": {},
+      "description": "List all teams and spaces (deprecated)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> packages/api",
-        "<%= config.bin %> <%= command.id %> ../other-checkout",
-        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
+        "<%= config.bin %> space list"
       ],
       "flags": {
-        "force": {
-          "description": "Replace existing .brv/ directory in target with a worktree pointer",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "add.js"
-      ]
-    },
-    "worktree": {
-      "aliases": [],
-      "args": {},
-      "description": "Manage worktree links for subdirectories and sibling checkouts",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree",
+      "id": "space:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1938,53 +1834,35 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "index.js"
+        "space",
+        "list.js"
       ]
     },
-    "worktree:list": {
+    "space:switch": {
       "aliases": [],
       "args": {},
-      "description": "Show the current worktree link and list all registered worktrees",
+      "description": "Switch to a different space (deprecated)",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> space switch"
       ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "worktree:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "worktree",
-        "list.js"
-      ]
-    },
-    "worktree:remove": {
-      "aliases": [],
-      "args": {
-        "path": {
-          "description": "Path to the worktree to remove (defaults to cwd)",
-          "name": "path",
-          "required": false
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
         }
       },
-      "description": "Remove a worktree registration and its .brv pointer",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
-        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
-      ],
-      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:remove",
+      "id": "space:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1995,8 +1873,8 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "remove.js"
+        "space",
+        "switch.js"
       ]
     },
     "swarm:curate": {
@@ -2179,6 +2057,128 @@
         "status.js"
       ]
     },
+    "worktree:add": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the directory to register as a worktree (relative or absolute)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Register a directory as a worktree of this project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> packages/api",
+        "<%= config.bin %> <%= command.id %> ../other-checkout",
+        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
+      ],
+      "flags": {
+        "force": {
+          "description": "Replace existing .brv/ directory in target with a worktree pointer",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "add.js"
+      ]
+    },
+    "worktree": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage worktree links for subdirectories and sibling checkouts",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --help"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "index.js"
+      ]
+    },
+    "worktree:list": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the current worktree link and list all registered worktrees",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "list.js"
+      ]
+    },
+    "worktree:remove": {
+      "aliases": [],
+      "args": {
+        "path": {
+          "description": "Path to the worktree to remove (defaults to cwd)",
+          "name": "path",
+          "required": false
+        }
+      },
+      "description": "Remove a worktree registration and its .brv pointer",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
+        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "worktree:remove",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "worktree",
+        "remove.js"
+      ]
+    },
     "vc:add": {
       "aliases": [],
       "args": {},
@@ -3080,5 +3080,5 @@
       ]
     }
   },
-  "version": "3.5.0"
+  "version": "3.5.1"
 }

package/package.json

@@ -12,7 +12,7 @@
     "coding-assistant",
     "knowledge-management"
   ],
-  "version": "3.5.0",
+  "version": "3.5.1",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"