byterover-cli 3.8.2 → 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"
@@ -1190,106 +1193,13 @@
         "list.js"
       ]
     },
-    "providers:connect": {
-      "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
-          "name": "provider",
-          "required": false
-        }
-      },
-      "description": "Connect or switch to an LLM provider",
-      "examples": [
-        "<%= config.bin %> providers connect",
-        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
-        "<%= config.bin %> providers connect openai --oauth",
-        "<%= config.bin %> providers connect byterover",
-        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
-      ],
-      "flags": {
-        "api-key": {
-          "char": "k",
-          "description": "API key for the provider",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "char": "b",
-          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "code": {
-          "char": "c",
-          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
-          "hidden": true,
-          "name": "code",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "model": {
-          "char": "m",
-          "description": "Model to set as active after connecting",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "oauth": {
-          "description": "Connect via OAuth (browser-based)",
-          "name": "oauth",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "providers:connect",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "providers",
-        "connect.js"
-      ]
-    },
-    "providers:disconnect": {
+    "model": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Disconnect an LLM provider",
+      "args": {},
+      "description": "Show the active model",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "<%= config.bin %> model",
+        "<%= config.bin %> model --format json"
       ],
       "flags": {
         "format": {
@@ -1307,7 +1217,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "model",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1318,17 +1228,17 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "model",
+        "index.js"
       ]
     },
-    "providers": {
+    "model:list": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "List available models from all connected providers",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
+        "<%= config.bin %> model list",
+        "<%= config.bin %> model list --format json"
       ],
       "flags": {
         "format": {
@@ -1342,50 +1252,19 @@
             "json"
           ],
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "providers",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "providers",
-        "index.js"
-      ]
-    },
-    "providers:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all available providers and their connection status",
-      "examples": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --format json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
+        },
+        "provider": {
+          "char": "p",
+          "description": "Only list models for a specific provider",
+          "name": "provider",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "model:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1396,23 +1275,24 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "model",
         "list.js"
       ]
     },
-    "providers:switch": {
+    "model:switch": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
+        "model": {
+          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
+          "name": "model",
           "required": true
         }
       },
-      "description": "Switch the active provider",
+      "description": "Switch the active model",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> model switch claude-sonnet-4-5",
+        "<%= config.bin %> model switch gpt-4.1 --provider openai",
+        "<%= config.bin %> model switch claude-sonnet-4-5 --format json"
       ],
       "flags": {
         "format": {
@@ -1426,11 +1306,19 @@
             "json"
           ],
           "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider ID (defaults to active provider)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "model:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1441,7 +1329,7 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "model",
         "switch.js"
       ]
     },
@@ -1620,15 +1508,49 @@
         "view.js"
       ]
     },
-    "model": {
+    "providers:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Show the active model",
+      "args": {
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
+          "name": "provider",
+          "required": false
+        }
+      },
+      "description": "Connect or switch to an LLM provider",
       "examples": [
-        "<%= config.bin %> model",
-        "<%= config.bin %> model --format json"
+        "<%= config.bin %> providers connect",
+        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
+        "<%= config.bin %> providers connect openai --oauth",
+        "<%= config.bin %> providers connect byterover",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx"
       ],
       "flags": {
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "char": "b",
+          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "code": {
+          "char": "c",
+          "description": "Authorization code for code-paste OAuth providers (e.g., Anthropic). Not applicable to browser-callback providers like OpenAI — use --oauth without --code instead.",
+          "hidden": true,
+          "name": "code",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1640,11 +1562,25 @@
             "json"
           ],
           "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to set as active after connecting",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "oauth": {
+          "description": "Connect via OAuth (browser-based)",
+          "name": "oauth",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1655,17 +1591,62 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "index.js"
-      ]
+        "providers",
+        "connect.js"
+      ]
     },
-    "model:list": {
+    "providers:disconnect": {
+      "aliases": [],
+      "args": {
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Disconnect an LLM provider",
+      "examples": [
+        "<%= config.bin %> providers disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers:disconnect",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "disconnect.js"
+      ]
+    },
+    "providers": {
       "aliases": [],
       "args": {},
-      "description": "List available models from all connected providers",
+      "description": "Show active provider and model",
       "examples": [
-        "<%= config.bin %> model list",
-        "<%= config.bin %> model list --format json"
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --format json"
       ],
       "flags": {
         "format": {
@@ -1679,19 +1660,50 @@
             "json"
           ],
           "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Only list models for a specific provider",
-          "name": "provider",
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "providers",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "index.js"
+      ]
+    },
+    "providers:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all available providers and their connection status",
+      "examples": [
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model:list",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1702,24 +1714,23 @@
         "dist",
         "oclif",
         "commands",
-        "model",
+        "providers",
         "list.js"
       ]
     },
-    "model:switch": {
+    "providers:switch": {
       "aliases": [],
       "args": {
-        "model": {
-          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
-          "name": "model",
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
           "required": true
         }
       },
-      "description": "Switch the active model",
+      "description": "Switch the active provider",
       "examples": [
-        "<%= config.bin %> model switch claude-sonnet-4-5",
-        "<%= config.bin %> model switch gpt-4.1 --provider openai",
-        "<%= config.bin %> model switch claude-sonnet-4-5 --format json"
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
       ],
       "flags": {
         "format": {
@@ -1733,19 +1744,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Provider ID (defaults to active provider)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model:switch",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1756,7 +1759,7 @@
         "dist",
         "oclif",
         "commands",
-        "model",
+        "providers",
         "switch.js"
       ]
     },
@@ -1965,129 +1968,6 @@
         "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": {},
@@ -2166,187 +2046,7 @@
         "switch.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": {
-        "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": "swarm:curate",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "swarm",
-        "curate.js"
-      ]
-    },
-    "swarm:onboard": {
-      "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",
-      "examples": [
-        "<%= config.bin %> swarm query \"auth tokens\"",
-        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
-      ],
-      "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": "swarm:query",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "swarm",
-        "query.js"
-      ]
-    },
-    "swarm:status": {
-      "aliases": [],
-      "args": {},
-      "description": "Show memory swarm provider health and connection status",
-      "examples": [
-        "<%= config.bin %> swarm status",
-        "<%= config.bin %> swarm status --format json"
-      ],
-      "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "swarm:status",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "swarm",
-        "status.js"
-      ]
-    },
-    "vc:add": {
+    "vc:add": {
       "aliases": [],
       "args": {},
       "description": "Stage files for the next commit",
@@ -2948,6 +2648,309 @@
         "status.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"
+      ]
+    },
+    "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": {
+        "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": "swarm:curate",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "swarm",
+        "curate.js"
+      ]
+    },
+    "swarm:onboard": {
+      "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",
+      "examples": [
+        "<%= config.bin %> swarm query \"auth tokens\"",
+        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
+      ],
+      "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": "swarm:query",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "swarm",
+        "query.js"
+      ]
+    },
+    "swarm:status": {
+      "aliases": [],
+      "args": {},
+      "description": "Show memory swarm provider health and connection status",
+      "examples": [
+        "<%= config.bin %> swarm status",
+        "<%= config.bin %> swarm status --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "swarm:status",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "swarm",
+        "status.js"
+      ]
+    },
     "hub:registry:add": {
       "aliases": [],
       "args": {
@@ -3369,5 +3372,5 @@
       ]
     }
   },
-  "version": "3.8.2"
+  "version": "3.8.3"
 }