byterover-cli 3.8.1 → 3.8.3

package/oclif.manifest.json

@@ -233,17 +233,20 @@
       "args": {},
       "description": "Authenticate with ByteRover for cloud sync features (optional for local usage)",
       "examples": [
+        "# Browser OAuth (default)",
+        "<%= config.bin %> <%= command.id %>",
+        "",
+        "# API key (for CI / headless environments)",
         "<%= config.bin %> <%= command.id %> --api-key <key>",
         "",
         "# JSON output (for automation)",
-        "<%= config.bin %> <%= command.id %> --api-key <key> --format json"
+        "<%= config.bin %> <%= command.id %> --format json"
       ],
       "flags": {
         "api-key": {
           "char": "k",
-          "description": "API key for authentication (get yours at https://app.byterover.dev/settings/keys)",
+          "description": "API key for headless/CI login (get yours at https://app.byterover.dev/settings/keys). Omit to use the browser OAuth flow.",
           "name": "api-key",
-          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -1330,6 +1333,181 @@
         "switch.js"
       ]
     },
+    "query-log:summary": {
+      "aliases": [],
+      "args": {},
+      "description": "View aggregated query recall metrics (coverage, cache hit rate, top topics)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --last 24h",
+        "<%= config.bin %> <%= command.id %> --last 7d",
+        "<%= config.bin %> <%= command.id %> --last 30d",
+        "<%= config.bin %> <%= command.id %> --format json",
+        "<%= config.bin %> <%= command.id %> --format narrative",
+        "<%= config.bin %> <%= command.id %> --since 2026-04-01 --before 2026-04-03"
+      ],
+      "flags": {
+        "before": {
+          "description": "Entries before (ISO date or relative: 1h, 24h, 7d, 2w)",
+          "name": "before",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json",
+            "narrative"
+          ],
+          "type": "option"
+        },
+        "last": {
+          "description": "Relative time window (e.g., 1h, 24h, 7d, 30d). Default: 24h. Takes precedence over --since.",
+          "name": "last",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Entries after (ISO date or relative: 1h, 24h, 7d, 2w)",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query-log:summary",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "query-log",
+        "summary.js"
+      ]
+    },
+    "query-log:view": {
+      "aliases": [],
+      "args": {
+        "id": {
+          "description": "Query log entry ID to view in detail",
+          "name": "id",
+          "required": false
+        }
+      },
+      "description": "View query log history",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> qry-1712345678901",
+        "<%= config.bin %> <%= command.id %> --limit 20",
+        "<%= config.bin %> <%= command.id %> --status completed",
+        "<%= config.bin %> <%= command.id %> --status completed --status error",
+        "<%= config.bin %> <%= command.id %> --tier 0 --tier 1",
+        "<%= config.bin %> <%= command.id %> --since 1h",
+        "<%= config.bin %> <%= command.id %> --since 2024-01-15",
+        "<%= config.bin %> <%= command.id %> --before 2024-02-01",
+        "<%= config.bin %> <%= command.id %> --detail",
+        "<%= config.bin %> <%= command.id %> --format json"
+      ],
+      "flags": {
+        "before": {
+          "description": "Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
+          "name": "before",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "detail": {
+          "description": "Show matched docs for each entry",
+          "name": "detail",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "format": {
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "limit": {
+          "description": "Maximum number of log entries to display",
+          "name": "limit",
+          "default": 10,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "since": {
+          "description": "Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
+          "name": "since",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "status": {
+          "description": "Filter by status (can be repeated). Options: cancelled, completed, error, processing",
+          "name": "status",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "cancelled",
+            "completed",
+            "error",
+            "processing"
+          ],
+          "type": "option"
+        },
+        "tier": {
+          "description": "Filter by resolution tier (can be repeated). Options: 0, 1, 2, 3, 4",
+          "name": "tier",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "options": [
+            "0",
+            "1",
+            "2",
+            "3",
+            "4"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "query-log:view",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "query-log",
+        "view.js"
+      ]
+    },
     "providers:connect": {
       "aliases": [],
       "args": {
@@ -1585,58 +1763,51 @@
         "switch.js"
       ]
     },
-    "query-log:summary": {
+    "review:approve": {
       "aliases": [],
-      "args": {},
-      "description": "View aggregated query recall metrics (coverage, cache hit rate, top topics)",
+      "args": {
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
+          "name": "taskId",
+          "required": true
+        }
+      },
+      "description": "Approve pending review operations for a curate task",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --last 24h",
-        "<%= config.bin %> <%= command.id %> --last 7d",
-        "<%= config.bin %> <%= command.id %> --last 30d",
-        "<%= config.bin %> <%= command.id %> --format json",
-        "<%= config.bin %> <%= command.id %> --format narrative",
-        "<%= config.bin %> <%= command.id %> --since 2026-04-01 --before 2026-04-03"
+        "# Approve all pending changes from a curate task",
+        "<%= config.bin %> review approve abc-123",
+        "",
+        "# Approve specific files",
+        "<%= config.bin %> review approve abc-123 --file architecture/security/audit.md",
+        "<%= config.bin %> review approve abc-123 --file auth/jwt.md --file auth/oauth.md",
+        "",
+        "# Approve and get structured output (useful for coding agents)",
+        "<%= config.bin %> review approve abc-123 --format json"
       ],
       "flags": {
-        "before": {
-          "description": "Entries before (ISO date or relative: 1h, 24h, 7d, 2w)",
-          "name": "before",
+        "file": {
+          "description": "Approve only the specified file path(s) (relative to context tree)",
+          "name": "file",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "format": {
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
             "text",
-            "json",
-            "narrative"
+            "json"
           ],
           "type": "option"
-        },
-        "last": {
-          "description": "Relative time window (e.g., 1h, 24h, 7d, 30d). Default: 24h. Takes precedence over --since.",
-          "name": "last",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "since": {
-          "description": "Entries after (ISO date or relative: 1h, 24h, 7d, 2w)",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "query-log:summary",
+      "id": "review:approve",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1647,184 +1818,16 @@
         "dist",
         "oclif",
         "commands",
-        "query-log",
-        "summary.js"
+        "review",
+        "approve.js"
       ]
     },
-    "query-log:view": {
+    "review:base-review-decision": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Query log entry ID to view in detail",
-          "name": "id",
-          "required": false
-        }
-      },
-      "description": "View query log history",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> qry-1712345678901",
-        "<%= config.bin %> <%= command.id %> --limit 20",
-        "<%= config.bin %> <%= command.id %> --status completed",
-        "<%= config.bin %> <%= command.id %> --status completed --status error",
-        "<%= config.bin %> <%= command.id %> --tier 0 --tier 1",
-        "<%= config.bin %> <%= command.id %> --since 1h",
-        "<%= config.bin %> <%= command.id %> --since 2024-01-15",
-        "<%= config.bin %> <%= command.id %> --before 2024-02-01",
-        "<%= config.bin %> <%= command.id %> --detail",
-        "<%= config.bin %> <%= command.id %> --format json"
-      ],
-      "flags": {
-        "before": {
-          "description": "Show entries started before this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
-          "name": "before",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "detail": {
-          "description": "Show matched docs for each entry",
-          "name": "detail",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "format": {
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "limit": {
-          "description": "Maximum number of log entries to display",
-          "name": "limit",
-          "default": 10,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "since": {
-          "description": "Show entries started after this time (ISO date or relative: 30m, 1h, 24h, 7d, 2w)",
-          "name": "since",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "status": {
-          "description": "Filter by status (can be repeated). Options: cancelled, completed, error, processing",
-          "name": "status",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "cancelled",
-            "completed",
-            "error",
-            "processing"
-          ],
-          "type": "option"
-        },
-        "tier": {
-          "description": "Filter by resolution tier (can be repeated). Options: 0, 1, 2, 3, 4",
-          "name": "tier",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "options": [
-            "0",
-            "1",
-            "2",
-            "3",
-            "4"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "query-log:view",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "query-log",
-        "view.js"
-      ]
-    },
-    "review:approve": {
-      "aliases": [],
-      "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
-          "name": "taskId",
-          "required": true
-        }
-      },
-      "description": "Approve pending review operations for a curate task",
-      "examples": [
-        "# Approve all pending changes from a curate task",
-        "<%= config.bin %> review approve abc-123",
-        "",
-        "# Approve specific files",
-        "<%= config.bin %> review approve abc-123 --file architecture/security/audit.md",
-        "<%= config.bin %> review approve abc-123 --file auth/jwt.md --file auth/oauth.md",
-        "",
-        "# Approve and get structured output (useful for coding agents)",
-        "<%= config.bin %> review approve abc-123 --format json"
-      ],
-      "flags": {
-        "file": {
-          "description": "Approve only the specified file path(s) (relative to context tree)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "review:approve",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "review",
-        "approve.js"
-      ]
-    },
-    "review:base-review-decision": {
-      "aliases": [],
-      "args": {
-        "taskId": {
-          "name": "taskId",
-          "required": true
+        "taskId": {
+          "name": "taskId",
+          "required": true
         }
       },
       "flags": {
@@ -1902,289 +1905,41 @@
         "dist",
         "oclif",
         "commands",
-        "review",
-        "pending.js"
-      ]
-    },
-    "review:reject": {
-      "aliases": [],
-      "args": {
-        "taskId": {
-          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
-          "name": "taskId",
-          "required": true
-        }
-      },
-      "description": "Reject pending review operations for a curate task (restores files from backup)",
-      "examples": [
-        "# Reject all pending changes from a curate task",
-        "<%= config.bin %> review reject abc-123",
-        "",
-        "# Reject specific files",
-        "<%= config.bin %> review reject abc-123 --file architecture/security/audit.md",
-        "<%= config.bin %> review reject abc-123 --file auth/jwt.md --file auth/oauth.md",
-        "",
-        "# Reject and get structured output (useful for coding agents)",
-        "<%= config.bin %> review reject abc-123 --format json"
-      ],
-      "flags": {
-        "file": {
-          "description": "Reject only the specified file path(s) (relative to context tree)",
-          "name": "file",
-          "hasDynamicHelp": false,
-          "multiple": true,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "review:reject",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "review",
-        "reject.js"
-      ]
-    },
-    "source:add": {
-      "aliases": [],
-      "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 %> <%= command.id %> /path/to/shared-lib",
-        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
-      ],
-      "flags": {
-        "alias": {
-          "description": "Custom alias for the source (defaults to directory name)",
-          "name": "alias",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "source:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "add.js"
-      ]
-    },
-    "source": {
-      "aliases": [],
-      "args": {},
-      "description": "Manage knowledge sources (read-only references to other projects)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
-      ],
-      "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": "source:remove",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "source",
-        "remove.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"
+        "review",
+        "pending.js"
       ]
     },
-    "swarm:curate": {
+    "review:reject": {
       "aliases": [],
       "args": {
-        "content": {
-          "description": "Knowledge content to store in a swarm provider",
-          "name": "content",
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review reject abc-123\")",
+          "name": "taskId",
           "required": true
         }
       },
-      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
+      "description": "Reject pending review operations for a curate task (restores files from backup)",
       "examples": [
-        "<%= config.bin %> swarm curate \"Dario Amodei is CEO of Anthropic\"",
-        "<%= config.bin %> swarm curate \"meeting notes: decided on JWT\" --provider local-markdown:notes",
-        "<%= config.bin %> swarm curate \"Architecture uses event sourcing\" --provider gbrain"
+        "# Reject all pending changes from a curate task",
+        "<%= config.bin %> review reject abc-123",
+        "",
+        "# Reject specific files",
+        "<%= config.bin %> review reject abc-123 --file architecture/security/audit.md",
+        "<%= config.bin %> review reject abc-123 --file auth/jwt.md --file auth/oauth.md",
+        "",
+        "# Reject and get structured output (useful for coding agents)",
+        "<%= config.bin %> review reject abc-123 --format json"
       ],
       "flags": {
+        "file": {
+          "description": "Reject only the specified file path(s) (relative to context tree)",
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -2194,19 +1949,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:curate",
+      "id": "review:reject",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2217,56 +1964,18 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "curate.js"
+        "review",
+        "reject.js"
       ]
     },
-    "swarm:onboard": {
+    "space:list": {
       "aliases": [],
       "args": {},
-      "description": "Set up memory swarm with interactive onboarding wizard",
-      "examples": [
-        "<%= config.bin %> swarm onboard"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "swarm:onboard",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "swarm",
-        "onboard.js"
-      ]
-    },
-    "swarm:query": {
-      "aliases": [],
-      "args": {
-        "query": {
-          "description": "Natural language query to search across memory providers",
-          "name": "query",
-          "required": true
-        }
-      },
-      "description": "Query the memory swarm across all active providers",
+      "description": "List all teams and spaces (deprecated)",
       "examples": [
-        "<%= config.bin %> swarm query \"auth tokens\"",
-        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
+        "<%= config.bin %> space list"
       ],
       "flags": {
-        "explain": {
-          "description": "Show classification, routing, and enrichment details (ignored with --format json, which always includes all metadata)",
-          "name": "explain",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "format": {
           "char": "f",
           "description": "Output format",
@@ -2279,19 +1988,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "max-results": {
-          "char": "n",
-          "description": "Maximum number of results",
-          "name": "max-results",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:query",
+      "id": "space:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2302,17 +2003,16 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "query.js"
+        "space",
+        "list.js"
       ]
     },
-    "swarm:status": {
+    "space:switch": {
       "aliases": [],
       "args": {},
-      "description": "Show memory swarm provider health and connection status",
+      "description": "Switch to a different space (deprecated)",
       "examples": [
-        "<%= config.bin %> swarm status",
-        "<%= config.bin %> swarm status --format json"
+        "<%= config.bin %> space switch"
       ],
       "flags": {
         "format": {
@@ -2331,7 +2031,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:status",
+      "id": "space:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2342,8 +2042,8 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "status.js"
+        "space",
+        "switch.js"
       ]
     },
     "vc:add": {
@@ -2948,32 +2648,170 @@
         "status.js"
       ]
     },
-    "worktree:add": {
+    "source:add": {
       "aliases": [],
       "args": {
         "path": {
-          "description": "Path to the directory to register as a worktree (relative or absolute)",
+          "description": "Path to the target project containing .brv/",
           "name": "path",
-          "required": false
+          "required": true
         }
       },
-      "description": "Register a directory as a worktree of this project",
+      "description": "Add a read-only knowledge source from another project's context tree",
       "examples": [
-        "<%= config.bin %> <%= command.id %> packages/api",
-        "<%= config.bin %> <%= command.id %> ../other-checkout",
-        "<%= config.bin %> <%= command.id %>  (auto-detect parent from subdirectory)"
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib",
+        "<%= config.bin %> <%= command.id %> /path/to/shared-lib --alias shared"
+      ],
+      "flags": {
+        "alias": {
+          "description": "Custom alias for the source (defaults to directory name)",
+          "name": "alias",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "source:add",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "add.js"
+      ]
+    },
+    "source": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage knowledge sources (read-only references to other projects)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --help"
+      ],
+      "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": "source:remove",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "source",
+        "remove.js"
+      ]
+    },
+    "swarm:curate": {
+      "aliases": [],
+      "args": {
+        "content": {
+          "description": "Knowledge content to store in a swarm provider",
+          "name": "content",
+          "required": true
+        }
+      },
+      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
+      "examples": [
+        "<%= config.bin %> swarm curate \"Dario Amodei is CEO of Anthropic\"",
+        "<%= config.bin %> swarm curate \"meeting notes: decided on JWT\" --provider local-markdown:notes",
+        "<%= config.bin %> swarm curate \"Architecture uses event sourcing\" --provider gbrain"
       ],
       "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"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:add",
+      "id": "swarm:curate",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2984,21 +2822,21 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "add.js"
+        "swarm",
+        "curate.js"
       ]
     },
-    "worktree": {
+    "swarm:onboard": {
       "aliases": [],
       "args": {},
-      "description": "Manage worktree links for subdirectories and sibling checkouts",
+      "description": "Set up memory swarm with interactive onboarding wizard",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
+        "<%= config.bin %> swarm onboard"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree",
+      "id": "swarm:onboard",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3009,21 +2847,56 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "index.js"
+        "swarm",
+        "onboard.js"
       ]
     },
-    "worktree:list": {
+    "swarm:query": {
       "aliases": [],
-      "args": {},
-      "description": "Show the current worktree link and list all registered worktrees",
+      "args": {
+        "query": {
+          "description": "Natural language query to search across memory providers",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Query the memory swarm across all active providers",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> swarm query \"auth tokens\"",
+        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
       ],
-      "flags": {},
+      "flags": {
+        "explain": {
+          "description": "Show classification, routing, and enrichment details (ignored with --format json, which always includes all metadata)",
+          "name": "explain",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        },
+        "max-results": {
+          "char": "n",
+          "description": "Maximum number of results",
+          "name": "max-results",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:list",
+      "id": "swarm:query",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3034,28 +2907,36 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "list.js"
+        "swarm",
+        "query.js"
       ]
     },
-    "worktree:remove": {
+    "swarm:status": {
       "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",
+      "args": {},
+      "description": "Show memory swarm provider health and connection status",
       "examples": [
-        "<%= config.bin %> <%= command.id %>  (remove cwd as worktree)",
-        "<%= config.bin %> <%= command.id %> packages/api  (remove from parent)"
+        "<%= config.bin %> swarm status",
+        "<%= config.bin %> swarm status --format json"
       ],
-      "flags": {},
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "worktree:remove",
+      "id": "swarm:status",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3066,8 +2947,8 @@
         "dist",
         "oclif",
         "commands",
-        "worktree",
-        "remove.js"
+        "swarm",
+        "status.js"
       ]
     },
     "hub:registry:add": {
@@ -3268,6 +3149,128 @@
         "remove.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:remote:add": {
       "aliases": [],
       "args": {
@@ -3369,5 +3372,5 @@
       ]
     }
   },
-  "version": "3.8.1"
+  "version": "3.8.3"
 }