byterover-cli 3.1.0 → 3.3.0

package/dist/tui/stores/transport-store.js

@@ -13,8 +13,10 @@ const initialState = {
     connectionState: 'disconnected',
     error: null,
     isConnected: false,
+    projectPath: null,
     reconnectCount: 0,
     version: '',
+    worktreeRoot: null,
 };
 export const useTransportStore = create()((set) => ({
     ...initialState,
@@ -36,5 +38,9 @@ export const useTransportStore = create()((set) => ({
         error,
         isConnected: false,
     }),
+    setProjectInfo: (projectPath, worktreeRoot) => set({
+        projectPath: projectPath ?? null,
+        worktreeRoot: worktreeRoot ?? null,
+    }),
     setVersion: (version) => set({ version }),
 }));

package/dist/tui/utils/error-messages.js

@@ -9,20 +9,20 @@
 const USER_FRIENDLY_MESSAGES = {
     ERR_AGENT_NOT_INITIALIZED: "Agent failed to initialize. Run 'brv restart' to force a clean restart.",
     ERR_CONTEXT_TREE_NOT_INIT: 'Context tree not initialized.',
+    ERR_LEGACY_SYNC_UNAVAILABLE: 'Legacy cloud sync (push/pull) is not available for this project. Use /vc init to start using version control. Learn more: https://docs.byterover.dev/git-semantic/overview',
     ERR_LOCAL_CHANGES_EXIST: 'You have local changes. Run /push to save your changes before pulling.',
     ERR_NOT_AUTHENTICATED: 'Not authenticated. This is required for cloud sync. Run /login to connect your account.',
     ERR_OAUTH_REFRESH_FAILED: 'OAuth token refresh failed. Run /providers to reconnect your provider.',
     ERR_OAUTH_TOKEN_EXPIRED: 'OAuth token has expired. Run /providers to reconnect your provider.',
     ERR_PROJECT_NOT_INIT: "Project not initialized. Run 'brv restart' to reinitialize.",
     ERR_PROVIDER_NOT_CONFIGURED: 'No provider connected. Run /providers connect byterover to use the free built-in provider, or connect another provider.',
-    ERR_SPACE_NOT_CONFIGURED: 'No space configured. Run /space switch to select a space first.',
     ERR_SPACE_NOT_FOUND: 'Space not found. Check your configuration.',
     ERR_VC_AUTH_FAILED: 'Authentication failed. Run /login.',
     ERR_VC_BRANCH_ALREADY_EXISTS: 'Branch already exists.',
     ERR_VC_CANNOT_DELETE_CURRENT_BRANCH: 'Cannot delete the currently checked-out branch.',
     ERR_VC_CONFIG_KEY_NOT_SET: 'Config key is not set.',
     ERR_VC_CONFLICT_MARKERS_PRESENT: 'Conflict markers detected. Run /vc conflicts to view them. Resolve conflicts and run /vc add before pushing.',
-    ERR_VC_GIT_INITIALIZED: 'ByteRover version control is active. Use /vc commands instead of legacy sync commands.',
+    ERR_VC_GIT_INITIALIZED: 'ByteRover version control is active. Use /vc commands instead of legacy sync commands. Learn more: https://docs.byterover.dev/git-semantic/overview',
     ERR_VC_GIT_NOT_INITIALIZED: 'ByteRover version control not initialized. Run /vc init first.',
     ERR_VC_INVALID_ACTION: 'Invalid action.',
     // ERR_VC_INVALID_BRANCH_NAME intentionally omitted: fall through to server's message with actual branch name

package/oclif.manifest.json

@@ -416,6 +416,14 @@
             "json"
           ],
           "type": "option"
+        },
+        "timeout": {
+          "description": "Maximum seconds to wait for task completion",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -465,6 +473,71 @@
         "restart.js"
       ]
     },
+    "search": {
+      "aliases": [],
+      "args": {
+        "query": {
+          "description": "Search query to find relevant knowledge in the context tree",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Search the context tree for relevant knowledge\n\nReturns ranked results with paths, scores, and excerpts.\nPure BM25 retrieval — no LLM, no token cost.\n\nUse this for structured results with file paths.\nUse \"brv query\" when you need a synthesized answer.",
+      "examples": [
+        "# Search for knowledge about authentication",
+        "<%= config.bin %> <%= command.id %> \"authentication\"",
+        "",
+        "# Limit results and scope to a domain",
+        "<%= config.bin %> <%= command.id %> \"JWT tokens\" --limit 5 --scope auth/",
+        "",
+        "# JSON output (for automation)",
+        "<%= config.bin %> <%= command.id %> \"auth\" --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of results (1-50)",
+          "name": "limit",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "description": "Path prefix to scope results (e.g. \"auth/\" for auth domain only)",
+          "name": "scope",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "search",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": false,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "search.js"
+      ]
+    },
     "status": {
       "aliases": [],
       "args": {},
@@ -486,6 +559,21 @@
             "json"
           ],
           "type": "option"
+        },
+        "project-root": {
+          "description": "Explicit project root path (overrides auto-detection)",
+          "name": "project-root",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Show resolution source and diagnostic info",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
@@ -668,6 +756,9 @@
         "# Folder pack with context",
         "<%= config.bin %> <%= command.id %> \"Analyze authentication module\" -d src/auth/",
         "",
+        "# Increase timeout for slow models (in seconds)",
+        "<%= config.bin %> <%= command.id %> \"context here\" --timeout 600",
+        "",
         "# View curate history",
         "<%= config.bin %> curate view",
         "<%= config.bin %> curate view --status completed --since 1h"
@@ -706,6 +797,14 @@
             "json"
           ],
           "type": "option"
+        },
+        "timeout": {
+          "description": "Maximum seconds to wait for task completion",
+          "name": "timeout",
+          "default": 300,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1322,6 +1421,84 @@
         "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"
+      ]
+    },
     "providers:connect": {
       "aliases": [],
       "args": {
@@ -1577,31 +1754,33 @@
         "switch.js"
       ]
     },
-    "space:list": {
+    "source:add": {
       "aliases": [],
-      "args": {},
-      "description": "List all teams and spaces (deprecated)",
+      "args": {
+        "path": {
+          "description": "Path to the target project containing .brv/",
+          "name": "path",
+          "required": true
+        }
+      },
+      "description": "Add a read-only knowledge source from another project's context tree",
       "examples": [
-        "<%= config.bin %> space list"
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
+        "alias": {
+          "description": "Custom alias for the source (defaults to directory name)",
+          "name": "alias",
+          "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:list",
+      "id": "source:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1612,35 +1791,78 @@
         "dist",
         "oclif",
         "commands",
-        "space",
-        "list.js"
+        "source",
+        "add.js"
       ]
     },
-    "space:switch": {
+    "source": {
       "aliases": [],
       "args": {},
-      "description": "Switch to a different space (deprecated)",
+      "description": "Manage knowledge sources (read-only references to other projects)",
       "examples": [
-        "<%= config.bin %> space switch"
+        "<%= config.bin %> <%= command.id %> --help"
       ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "index.js"
+      ]
+    },
+    "source:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all knowledge sources and their status",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "list.js"
+      ]
+    },
+    "source:remove": {
+      "aliases": [],
+      "args": {
+        "aliasOrPath": {
+          "description": "Alias or path of the knowledge source to remove",
+          "name": "aliasOrPath",
+          "required": true
         }
       },
+      "description": "Remove a knowledge source",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib"
+      ],
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:switch",
+      "id": "source:remove",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1651,8 +1873,8 @@
         "dist",
         "oclif",
         "commands",
-        "space",
-        "switch.js"
+        "source",
+        "remove.js"
       ]
     },
     "vc:add": {
@@ -2257,6 +2479,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"
+      ]
+    },
     "hub:registry:add": {
       "aliases": [],
       "args": {
@@ -2556,5 +2900,5 @@
       ]
     }
   },
-  "version": "3.1.0"
+  "version": "3.3.0"
 }

package/package.json

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