byterover-cli 3.12.0 → 3.13.0

package/oclif.manifest.json

@@ -771,144 +771,6 @@
         "webui.js"
       ]
     },
-    "connectors": {
-      "aliases": [],
-      "args": {},
-      "description": "List installed agent connectors",
-      "examples": [
-        "<%= config.bin %> connectors",
-        "<%= config.bin %> connectors --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": "connectors",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "connectors",
-        "index.js"
-      ]
-    },
-    "connectors:install": {
-      "aliases": [],
-      "args": {
-        "agent": {
-          "description": "Agent name to install connector for (e.g., \"Claude Code\", \"Cursor\"). Omit for interactive selection.",
-          "name": "agent",
-          "required": false
-        }
-      },
-      "description": "Install or switch a connector for an agent\n\n  Connector Types:\n    Rules       Agent reads instructions from rule file\n    Hook        Instructions injected on each prompt\n    MCP         Agent connects via MCP protocol\n    Agent Skill Agent reads skill files from project directory\n\n  Available agents     Default         Supported Types\n  ──────────────────── ─────────────── ─────────────────────────\n  Amp                  Agent Skill     Rules, MCP, Agent Skill\n  Antigravity          Agent Skill     Rules, MCP, Agent Skill\n  Auggie CLI           Agent Skill     Rules, MCP, Agent Skill\n  Augment Code         MCP             Rules, MCP\n  Claude Code          Agent Skill     Rules, Hook, MCP, Agent Skill\n  Claude Desktop       MCP             MCP\n  Cline                MCP             Rules, MCP\n  Codex                Agent Skill     Rules, MCP, Agent Skill\n  Cursor               Agent Skill     Rules, MCP, Agent Skill\n  Gemini CLI           Agent Skill     Rules, MCP, Agent Skill\n  Github Copilot       Agent Skill     Rules, MCP, Agent Skill\n  Junie                Agent Skill     Rules, MCP, Agent Skill\n  Kilo Code            Agent Skill     Rules, MCP, Agent Skill\n  Kiro                 Agent Skill     Rules, MCP, Agent Skill\n  OpenClaude           Agent Skill     Rules, MCP, Agent Skill\n  OpenClaw             Agent Skill     Agent Skill\n  OpenCode             Agent Skill     Rules, MCP, Agent Skill\n  Qoder                Agent Skill     Rules, MCP, Agent Skill\n  Qwen Code            MCP             Rules, MCP\n  Roo Code             Agent Skill     Rules, MCP, Agent Skill\n  Trae.ai              Agent Skill     Rules, MCP, Agent Skill\n  Warp                 Agent Skill     Rules, MCP, Agent Skill\n  Windsurf             Agent Skill     Rules, MCP, Agent Skill\n  Zed                  MCP             Rules, MCP",
-      "examples": [
-        "<%= config.bin %> connectors install \"Claude Code\"",
-        "<%= config.bin %> connectors install \"Claude Code\" --type mcp",
-        "<%= config.bin %> connectors install Cursor --type rules"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "type": {
-          "char": "t",
-          "description": "Connector type (rules, hook, mcp, skill). Defaults to agent's recommended type.",
-          "name": "type",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "rules",
-            "hook",
-            "mcp",
-            "skill"
-          ],
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "connectors:install",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "connectors",
-        "install.js"
-      ]
-    },
-    "connectors:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List installed agent connectors",
-      "examples": [
-        "<%= config.bin %> connectors list",
-        "<%= config.bin %> connectors 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": "connectors:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "connectors",
-        "list.js"
-      ]
-    },
     "curate": {
       "aliases": [],
       "args": {
@@ -1097,14 +959,31 @@
         "view.js"
       ]
     },
-    "hub": {
+    "connectors": {
       "aliases": [],
       "args": {},
-      "description": "Browse and manage skills & bundles registry",
-      "flags": {},
+      "description": "List installed agent connectors",
+      "examples": [
+        "<%= config.bin %> connectors",
+        "<%= config.bin %> connectors --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": "hub",
+      "id": "connectors",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1115,58 +994,28 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
+        "connectors",
         "index.js"
       ]
     },
-    "hub:install": {
+    "connectors:install": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Entry ID to install",
-          "name": "id",
-          "required": true
+        "agent": {
+          "description": "Agent name to install connector for (e.g., \"Claude Code\", \"Cursor\"). Omit for interactive selection.",
+          "name": "agent",
+          "required": false
         }
       },
-      "description": "Install a skill or bundle from the hub",
+      "description": "Install or switch a connector for an agent\n\n  Connector Types:\n    Rules       Agent reads instructions from rule file\n    Hook        Instructions injected on each prompt\n    MCP         Agent connects via MCP protocol\n    Agent Skill Agent reads skill files from project directory\n\n  Available agents     Default         Supported Types\n  ──────────────────── ─────────────── ─────────────────────────\n  Amp                  Agent Skill     Rules, MCP, Agent Skill\n  Antigravity          Agent Skill     Rules, MCP, Agent Skill\n  Auggie CLI           Agent Skill     Rules, MCP, Agent Skill\n  Augment Code         MCP             Rules, MCP\n  Claude Code          Agent Skill     Rules, Hook, MCP, Agent Skill\n  Claude Desktop       MCP             MCP\n  Cline                MCP             Rules, MCP\n  Codex                Agent Skill     Rules, MCP, Agent Skill\n  Cursor               Agent Skill     Rules, MCP, Agent Skill\n  Gemini CLI           Agent Skill     Rules, MCP, Agent Skill\n  Github Copilot       Agent Skill     Rules, MCP, Agent Skill\n  Junie                Agent Skill     Rules, MCP, Agent Skill\n  Kilo Code            Agent Skill     Rules, MCP, Agent Skill\n  Kiro                 Agent Skill     Rules, MCP, Agent Skill\n  OpenClaude           Agent Skill     Rules, MCP, Agent Skill\n  OpenClaw             Agent Skill     Agent Skill\n  OpenCode             Agent Skill     Rules, MCP, Agent Skill\n  Qoder                Agent Skill     Rules, MCP, Agent Skill\n  Qwen Code            MCP             Rules, MCP\n  Roo Code             Agent Skill     Rules, MCP, Agent Skill\n  Trae.ai              Agent Skill     Rules, MCP, Agent Skill\n  Warp                 Agent Skill     Rules, MCP, Agent Skill\n  Windsurf             Agent Skill     Rules, MCP, Agent Skill\n  Zed                  MCP             Rules, MCP",
       "examples": [
-        "<%= config.bin %> hub install byterover-review --agent \"Claude Code\"",
-        "<%= config.bin %> hub install typescript-kickstart",
-        "<%= config.bin %> hub install byterover-review --registry myco"
+        "<%= config.bin %> connectors install \"Claude Code\"",
+        "<%= config.bin %> connectors install \"Claude Code\" --type mcp",
+        "<%= config.bin %> connectors install Cursor --type rules"
       ],
       "flags": {
-        "agent": {
-          "char": "a",
-          "description": "Target agent for skill install",
-          "name": "agent",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "Amp",
-            "Antigravity",
-            "Auggie CLI",
-            "Claude Code",
-            "Codex",
-            "Cursor",
-            "Gemini CLI",
-            "Github Copilot",
-            "Junie",
-            "Kilo Code",
-            "Kiro",
-            "OpenClaude",
-            "OpenClaw",
-            "OpenCode",
-            "Qoder",
-            "Roo Code",
-            "Trae.ai",
-            "Warp",
-            "Windsurf"
-          ],
-          "type": "option"
-        },
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1177,31 +1026,24 @@
           ],
           "type": "option"
         },
-        "registry": {
-          "char": "r",
-          "description": "Registry to install from (when ID exists in multiple registries)",
-          "name": "registry",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "scope": {
-          "char": "s",
-          "description": "Install scope for skills (global: home directory, project: current project)",
-          "name": "scope",
-          "default": "project",
+        "type": {
+          "char": "t",
+          "description": "Connector type (rules, hook, mcp, skill). Defaults to agent's recommended type.",
+          "name": "type",
           "hasDynamicHelp": false,
           "multiple": false,
           "options": [
-            "global",
-            "project"
+            "rules",
+            "hook",
+            "mcp",
+            "skill"
           ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:install",
+      "id": "connectors:install",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1212,22 +1054,21 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
+        "connectors",
         "install.js"
       ]
     },
-    "hub:list": {
+    "connectors:list": {
       "aliases": [],
       "args": {},
-      "description": "List available skills & bundles from the hub",
+      "description": "List installed agent connectors",
       "examples": [
-        "<%= config.bin %> hub list",
-        "<%= config.bin %> hub list --format json"
+        "<%= config.bin %> connectors list",
+        "<%= config.bin %> connectors list --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1241,7 +1082,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:list",
+      "id": "connectors:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1252,35 +1093,18 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
+        "connectors",
         "list.js"
       ]
     },
-    "model": {
+    "hub": {
       "aliases": [],
       "args": {},
-      "description": "Show the active model",
-      "examples": [
-        "<%= config.bin %> model",
-        "<%= config.bin %> model --format json"
-      ],
-      "flags": {
-        "format": {
-          "description": "Output format (text or json)",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        }
-      },
+      "description": "Browse and manage skills & bundles registry",
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model",
+      "id": "hub",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1291,21 +1115,58 @@
         "dist",
         "oclif",
         "commands",
-        "model",
+        "hub",
         "index.js"
       ]
     },
-    "model:list": {
+    "hub:install": {
       "aliases": [],
-      "args": {},
-      "description": "List available models from all connected providers",
+      "args": {
+        "id": {
+          "description": "Entry ID to install",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Install a skill or bundle from the hub",
       "examples": [
-        "<%= config.bin %> model list",
-        "<%= config.bin %> model list --format json"
+        "<%= config.bin %> hub install byterover-review --agent \"Claude Code\"",
+        "<%= config.bin %> hub install typescript-kickstart",
+        "<%= config.bin %> hub install byterover-review --registry myco"
       ],
       "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Target agent for skill install",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "Amp",
+            "Antigravity",
+            "Auggie CLI",
+            "Claude Code",
+            "Codex",
+            "Cursor",
+            "Gemini CLI",
+            "Github Copilot",
+            "Junie",
+            "Kilo Code",
+            "Kiro",
+            "OpenClaude",
+            "OpenClaw",
+            "OpenCode",
+            "Qoder",
+            "Roo Code",
+            "Trae.ai",
+            "Warp",
+            "Windsurf"
+          ],
+          "type": "option"
+        },
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1316,18 +1177,31 @@
           ],
           "type": "option"
         },
-        "provider": {
-          "char": "p",
-          "description": "Only list models for a specific provider",
-          "name": "provider",
+        "registry": {
+          "char": "r",
+          "description": "Registry to install from (when ID exists in multiple registries)",
+          "name": "registry",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "scope": {
+          "char": "s",
+          "description": "Install scope for skills (global: home directory, project: current project)",
+          "name": "scope",
+          "default": "project",
           "hasDynamicHelp": false,
           "multiple": false,
+          "options": [
+            "global",
+            "project"
+          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model:list",
+      "id": "hub:install",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1338,28 +1212,22 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "list.js"
+        "hub",
+        "install.js"
       ]
     },
-    "model:switch": {
+    "hub:list": {
       "aliases": [],
-      "args": {
-        "model": {
-          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
-          "name": "model",
-          "required": true
-        }
-      },
-      "description": "Switch the active model",
+      "args": {},
+      "description": "List available skills & bundles from the hub",
       "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 %> hub list",
+        "<%= config.bin %> hub list --format json"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1369,19 +1237,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": "hub:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1392,51 +1252,37 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "switch.js"
+        "hub",
+        "list.js"
       ]
     },
-    "providers:connect": {
+    "review:approve": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter). Omit for interactive selection.",
-          "name": "provider",
-          "required": false
+        "taskId": {
+          "description": "Task ID shown in the curate output (e.g. \"brv review approve abc-123\")",
+          "name": "taskId",
+          "required": true
         }
       },
-      "description": "Connect or switch to an LLM provider",
+      "description": "Approve pending review operations for a curate task",
       "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"
+        "# 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": {
-        "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",
+        "file": {
+          "description": "Approve only the specified file path(s) (relative to context tree)",
+          "name": "file",
           "hasDynamicHelp": false,
-          "multiple": false,
+          "multiple": true,
           "type": "option"
         },
         "format": {
@@ -1450,25 +1296,11 @@
             "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",
+      "id": "review:approve",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1479,25 +1311,25 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "review",
+        "approve.js"
       ]
     },
-    "providers:disconnect": {
+    "review:base-review-decision": {
       "aliases": [],
       "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
+        "taskId": {
+          "name": "taskId",
           "required": true
         }
       },
-      "description": "Disconnect an LLM provider",
-      "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
-      ],
       "flags": {
+        "file": {
+          "name": "file",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1513,7 +1345,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "review:base-review-decision",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1524,17 +1356,20 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "review",
+        "base-review-decision.js"
       ]
     },
-    "providers": {
+    "review:pending": {
       "aliases": [],
       "args": {},
-      "description": "Show active provider and model",
+      "description": "List all pending review operations for the current project",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
+        "# Show all pending reviews",
+        "<%= config.bin %> review pending",
+        "",
+        "# Get structured output for agent-driven workflows",
+        "<%= config.bin %> review pending --format json"
       ],
       "flags": {
         "format": {
@@ -1552,7 +1387,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "review:pending",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1563,241 +1398,11 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "index.js"
+        "review",
+        "pending.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": "providers:list",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "providers",
-        "list.js"
-      ]
-    },
-    "providers:switch": {
-      "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Switch the active provider",
-      "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch 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:switch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "providers",
-        "switch.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
-        }
-      },
-      "flags": {
-        "file": {
-          "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:base-review-decision",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "review",
-        "base-review-decision.js"
-      ]
-    },
-    "review:pending": {
-      "aliases": [],
-      "args": {},
-      "description": "List all pending review operations for the current project",
-      "examples": [
-        "# Show all pending reviews",
-        "<%= config.bin %> review pending",
-        "",
-        "# Get structured output for agent-driven workflows",
-        "<%= config.bin %> review pending --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": "review:pending",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "review",
-        "pending.js"
-      ]
-    },
-    "review:reject": {
+    "review:reject": {
       "aliases": [],
       "args": {
         "taskId": {
@@ -1979,17 +1584,17 @@
         "remove.js"
       ]
     },
-    "space:list": {
+    "model": {
       "aliases": [],
       "args": {},
-      "description": "List all teams and spaces (deprecated)",
+      "description": "Show the active model",
       "examples": [
-        "<%= config.bin %> space list"
+        "<%= config.bin %> model",
+        "<%= config.bin %> model --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -2003,7 +1608,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:list",
+      "id": "model",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2014,21 +1619,21 @@
         "dist",
         "oclif",
         "commands",
-        "space",
-        "list.js"
+        "model",
+        "index.js"
       ]
     },
-    "space:switch": {
+    "model:list": {
       "aliases": [],
       "args": {},
-      "description": "Switch to a different space (deprecated)",
+      "description": "List available models from all connected providers",
       "examples": [
-        "<%= config.bin %> space switch"
+        "<%= config.bin %> model list",
+        "<%= config.bin %> model list --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -2038,9 +1643,587 @@
             "json"
           ],
           "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
+        },
+        "provider": {
+          "char": "p",
+          "description": "Only list models for a specific provider",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "model:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "model",
+        "list.js"
+      ]
+    },
+    "model:switch": {
+      "aliases": [],
+      "args": {
+        "model": {
+          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
+          "name": "model",
+          "required": true
+        }
+      },
+      "description": "Switch the active model",
+      "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"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "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",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "model",
+        "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": {
+        "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 byterover --team acme",
+        "<%= 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"
+        },
+        "team": {
+          "description": "Pin this project to a billing team (byterover only). Accepts team name or slug.",
+          "name": "team",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "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": {
+      "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": "Show active provider and model",
+      "examples": [
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --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",
+      "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": "providers:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "list.js"
+      ]
+    },
+    "providers:switch": {
+      "aliases": [],
+      "args": {
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Switch the active provider",
+      "examples": [
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch 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:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "providers",
+        "switch.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",
@@ -2179,180 +2362,39 @@
         "remove.js"
       ]
     },
-    "vc:add": {
-      "aliases": [],
-      "args": {},
-      "description": "Stage files for the next commit",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> .",
-        "<%= config.bin %> <%= command.id %> notes.md",
-        "<%= config.bin %> <%= command.id %> design/architecture.md",
-        "<%= config.bin %> <%= command.id %> docs/"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": false,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "add.js"
-      ]
-    },
-    "vc:branch": {
-      "aliases": [],
-      "args": {
-        "name": {
-          "description": "Branch name to create",
-          "name": "name"
-        }
-      },
-      "description": "List, create, or delete local branches",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> feature/new-context",
-        "<%= config.bin %> <%= command.id %> -d feature/new-context",
-        "<%= config.bin %> <%= command.id %> -a",
-        "<%= config.bin %> <%= command.id %> --set-upstream-to origin/main"
-      ],
-      "flags": {
-        "all": {
-          "char": "a",
-          "description": "List all branches including remote-tracking",
-          "name": "all",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "delete": {
-          "char": "d",
-          "description": "Delete a branch by name",
-          "name": "delete",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "set-upstream-to": {
-          "description": "Set upstream tracking (e.g. origin/main)",
-          "name": "set-upstream-to",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:branch",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "branch.js"
-      ]
-    },
-    "vc:checkout": {
+    "swarm:curate": {
       "aliases": [],
       "args": {
-        "branch": {
-          "description": "Branch to switch to",
-          "name": "branch",
+        "content": {
+          "description": "Knowledge content to store in a swarm provider",
+          "name": "content",
           "required": true
         }
       },
-      "description": "Switch to an existing branch, or create and switch with -b",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> feature/my-branch",
-        "<%= config.bin %> <%= command.id %> -b feature/new-branch",
-        "<%= config.bin %> <%= command.id %> --force feature/my-branch"
-      ],
-      "flags": {
-        "create": {
-          "char": "b",
-          "description": "Create a new branch and switch to it",
-          "name": "create",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "force": {
-          "description": "Discard local changes and switch",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:checkout",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "checkout.js"
-      ]
-    },
-    "vc:clone": {
-      "aliases": [],
-      "args": {
-        "url": {
-          "description": "Clone URL (e.g. https://byterover.dev/<team>/<space>.git)",
-          "name": "url"
-        }
-      },
-      "description": "Clone a ByteRover space repository",
-      "examples": [
-        "<%= config.bin %> vc clone https://byterover.dev/acme/project.git"
-      ],
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:clone",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "clone.js"
-      ]
-    },
-    "vc:commit": {
-      "aliases": [],
-      "args": {},
-      "description": "Save staged changes as a commit",
+      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> -m \"Add project architecture notes\""
+        "<%= 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": {
-        "message": {
-          "char": "m",
-          "description": "Commit message",
-          "name": "message",
+        "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"
@@ -2360,45 +2402,32 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:commit",
+      "id": "swarm:curate",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "commit.js"
+        "swarm",
+        "curate.js"
       ]
     },
-    "vc:config": {
+    "swarm:onboard": {
       "aliases": [],
-      "args": {
-        "key": {
-          "description": "Config key (user.name or user.email)",
-          "name": "key",
-          "required": true
-        },
-        "value": {
-          "description": "Value to set (omit to read current value)",
-          "name": "value"
-        }
-      },
-      "description": "Get or set commit author for ByteRover version control",
+      "args": {},
+      "description": "Set up memory swarm with interactive onboarding wizard",
       "examples": [
-        "<%= config.bin %> <%= command.id %> user.name \"Your Name\"",
-        "<%= config.bin %> <%= command.id %> user.email \"you@example.com\"",
-        "<%= config.bin %> <%= command.id %> user.name",
-        "<%= config.bin %> <%= command.id %> user.email"
+        "<%= config.bin %> swarm onboard"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:config",
+      "id": "swarm:onboard",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2409,75 +2438,56 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "config.js"
+        "swarm",
+        "onboard.js"
       ]
     },
-    "vc:diff": {
+    "swarm:query": {
       "aliases": [],
       "args": {
-        "ref": {
-          "description": "commit, branch, or <ref1>..<ref2> range",
-          "name": "ref"
+        "query": {
+          "description": "Natural language query to search across memory providers",
+          "name": "query",
+          "required": true
         }
       },
-      "description": "Show changes between commits, the index, or the working tree",
+      "description": "Query the memory swarm across all active providers",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --staged",
-        "<%= config.bin %> <%= command.id %> HEAD~1",
-        "<%= config.bin %> <%= command.id %> main..feature/x",
-        "<%= config.bin %> <%= command.id %> main"
+        "<%= config.bin %> swarm query \"auth tokens\"",
+        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
       ],
       "flags": {
-        "staged": {
-          "description": "Show staged changes (HEAD vs index)",
-          "name": "staged",
+        "explain": {
+          "description": "Show classification, routing, and enrichment details (ignored with --format json, which always includes all metadata)",
+          "name": "explain",
           "allowNo": false,
           "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "vc:diff",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "oclif",
-        "commands",
-        "vc",
-        "diff.js"
-      ]
-    },
-    "vc:fetch": {
-      "aliases": [],
-      "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
         },
-        "branch": {
-          "description": "Branch to fetch",
-          "name": "branch",
-          "required": false
+        "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"
         }
       },
-      "description": "Fetch refs from ByteRover cloud",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> origin",
-        "<%= config.bin %> <%= command.id %> origin main"
-      ],
-      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:fetch",
+      "id": "swarm:query",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2488,21 +2498,36 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "fetch.js"
+        "swarm",
+        "query.js"
       ]
     },
-    "vc": {
+    "swarm:status": {
       "aliases": [],
       "args": {},
-      "description": "Version control commands for the context tree",
+      "description": "Show memory swarm provider health and connection status",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --help"
+        "<%= 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": "vc",
+      "id": "swarm:status",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2513,25 +2538,28 @@
         "dist",
         "oclif",
         "commands",
-        "vc",
-        "index.js"
+        "swarm",
+        "status.js"
       ]
     },
-    "vc:init": {
+    "vc:add": {
       "aliases": [],
       "args": {},
-      "description": "Initialize ByteRover version control for context tree",
+      "description": "Stage files for the next commit",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %> .",
+        "<%= config.bin %> <%= command.id %> notes.md",
+        "<%= config.bin %> <%= command.id %> design/architecture.md",
+        "<%= config.bin %> <%= command.id %> docs/"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:init",
+      "id": "vc:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
@@ -2539,36 +2567,44 @@
         "oclif",
         "commands",
         "vc",
-        "init.js"
+        "add.js"
       ]
     },
-    "vc:log": {
+    "vc:branch": {
       "aliases": [],
       "args": {
-        "branch": {
-          "description": "Branch name to show history for",
-          "name": "branch"
+        "name": {
+          "description": "Branch name to create",
+          "name": "name"
         }
       },
-      "description": "Show commit history for the context-tree",
+      "description": "List, create, or delete local branches",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --limit 20",
-        "<%= config.bin %> <%= command.id %> main",
-        "<%= config.bin %> <%= command.id %> --all"
+        "<%= config.bin %> <%= command.id %> feature/new-context",
+        "<%= config.bin %> <%= command.id %> -d feature/new-context",
+        "<%= config.bin %> <%= command.id %> -a",
+        "<%= config.bin %> <%= command.id %> --set-upstream-to origin/main"
       ],
       "flags": {
         "all": {
           "char": "a",
-          "description": "Show commits from all branches",
+          "description": "List all branches including remote-tracking",
           "name": "all",
           "allowNo": false,
           "type": "boolean"
         },
-        "limit": {
-          "description": "Number of commits to show",
-          "name": "limit",
-          "default": 10,
+        "delete": {
+          "char": "d",
+          "description": "Delete a branch by name",
+          "name": "delete",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "set-upstream-to": {
+          "description": "Set upstream tracking (e.g. origin/main)",
+          "name": "set-upstream-to",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -2576,7 +2612,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:log",
+      "id": "vc:branch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2588,62 +2624,42 @@
         "oclif",
         "commands",
         "vc",
-        "log.js"
+        "branch.js"
       ]
     },
-    "vc:merge": {
+    "vc:checkout": {
       "aliases": [],
       "args": {
         "branch": {
-          "description": "Branch to merge into the current branch",
+          "description": "Branch to switch to",
           "name": "branch",
-          "required": false
+          "required": true
         }
       },
-      "description": "Merge a branch into the current branch",
+      "description": "Switch to an existing branch, or create and switch with -b",
       "examples": [
         "<%= config.bin %> <%= command.id %> feature/my-branch",
-        "<%= config.bin %> <%= command.id %> --abort",
-        "<%= config.bin %> <%= command.id %> --continue",
-        "<%= config.bin %> <%= command.id %> -m \"Custom merge message\" feature/my-branch"
+        "<%= config.bin %> <%= command.id %> -b feature/new-branch",
+        "<%= config.bin %> <%= command.id %> --force feature/my-branch"
       ],
       "flags": {
-        "abort": {
-          "description": "Abort the current merge",
-          "exclusive": [
-            "continue"
-          ],
-          "name": "abort",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "allow-unrelated-histories": {
-          "description": "Allow merging unrelated histories",
-          "name": "allow-unrelated-histories",
+        "create": {
+          "char": "b",
+          "description": "Create a new branch and switch to it",
+          "name": "create",
           "allowNo": false,
           "type": "boolean"
         },
-        "continue": {
-          "description": "Continue the current merge after resolving conflicts",
-          "exclusive": [
-            "abort"
-          ],
-          "name": "continue",
+        "force": {
+          "description": "Discard local changes and switch",
+          "name": "force",
           "allowNo": false,
           "type": "boolean"
-        },
-        "message": {
-          "char": "m",
-          "description": "Merge commit message",
-          "name": "message",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:merge",
+      "id": "vc:checkout",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2655,44 +2671,63 @@
         "oclif",
         "commands",
         "vc",
-        "merge.js"
+        "checkout.js"
       ]
     },
-    "vc:pull": {
+    "vc:clone": {
       "aliases": [],
       "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
-        },
-        "branch": {
-          "description": "Branch to pull",
-          "name": "branch",
-          "required": false
+        "url": {
+          "description": "Clone URL (e.g. https://byterover.dev/<team>/<space>.git)",
+          "name": "url"
         }
       },
-      "description": "Pull commits from ByteRover cloud",
+      "description": "Clone a ByteRover space repository",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> origin main",
-        "<%= config.bin %> <%= command.id %> origin main --allow-unrelated-histories"
+        "<%= config.bin %> vc clone https://byterover.dev/acme/project.git"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:clone",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "clone.js"
+      ]
+    },
+    "vc:commit": {
+      "aliases": [],
+      "args": {},
+      "description": "Save staged changes as a commit",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> -m \"Add project architecture notes\""
       ],
       "flags": {
-        "allow-unrelated-histories": {
-          "description": "Allow merging unrelated histories",
-          "name": "allow-unrelated-histories",
-          "allowNo": false,
-          "type": "boolean"
+        "message": {
+          "char": "m",
+          "description": "Commit message",
+          "name": "message",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:pull",
+      "id": "vc:commit",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
@@ -2700,41 +2735,33 @@
         "oclif",
         "commands",
         "vc",
-        "pull.js"
+        "commit.js"
       ]
     },
-    "vc:push": {
+    "vc:config": {
       "aliases": [],
       "args": {
-        "remote": {
-          "description": "Remote name (only origin supported)",
-          "name": "remote",
-          "required": false
+        "key": {
+          "description": "Config key (user.name or user.email)",
+          "name": "key",
+          "required": true
         },
-        "branch": {
-          "description": "Branch to push",
-          "name": "branch",
-          "required": false
+        "value": {
+          "description": "Value to set (omit to read current value)",
+          "name": "value"
         }
       },
-      "description": "Push commits to ByteRover cloud",
+      "description": "Get or set commit author for ByteRover version control",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> -u",
-        "<%= config.bin %> <%= command.id %> origin feat/my-branch"
+        "<%= config.bin %> <%= command.id %> user.name \"Your Name\"",
+        "<%= config.bin %> <%= command.id %> user.email \"you@example.com\"",
+        "<%= config.bin %> <%= command.id %> user.name",
+        "<%= config.bin %> <%= command.id %> user.email"
       ],
-      "flags": {
-        "set-upstream": {
-          "char": "u",
-          "description": "Set upstream tracking branch",
-          "name": "set-upstream",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:push",
+      "id": "vc:config",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2746,47 +2773,40 @@
         "oclif",
         "commands",
         "vc",
-        "push.js"
+        "config.js"
       ]
     },
-    "vc:reset": {
+    "vc:diff": {
       "aliases": [],
-      "args": {},
-      "description": "Unstage files or undo commits",
+      "args": {
+        "ref": {
+          "description": "commit, branch, or <ref1>..<ref2> range",
+          "name": "ref"
+        }
+      },
+      "description": "Show changes between commits, the index, or the working tree",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> notes.md",
-        "<%= config.bin %> <%= command.id %> --soft HEAD~1",
-        "<%= config.bin %> <%= command.id %> --hard HEAD~1",
-        "<%= config.bin %> <%= command.id %> --hard"
+        "<%= config.bin %> <%= command.id %> --staged",
+        "<%= config.bin %> <%= command.id %> HEAD~1",
+        "<%= config.bin %> <%= command.id %> main..feature/x",
+        "<%= config.bin %> <%= command.id %> main"
       ],
       "flags": {
-        "hard": {
-          "description": "Reset HEAD, index, and working tree",
-          "exclusive": [
-            "soft"
-          ],
-          "name": "hard",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "soft": {
-          "description": "Reset HEAD only, keep changes staged",
-          "exclusive": [
-            "hard"
-          ],
-          "name": "soft",
+        "staged": {
+          "description": "Show staged changes (HEAD vs index)",
+          "name": "staged",
           "allowNo": false,
           "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:reset",
+      "id": "vc:diff",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": false,
+      "strict": true,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
@@ -2794,20 +2814,33 @@
         "oclif",
         "commands",
         "vc",
-        "reset.js"
+        "diff.js"
       ]
     },
-    "vc:status": {
+    "vc:fetch": {
       "aliases": [],
-      "args": {},
-      "description": "Show ByteRover version control status",
+      "args": {
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to fetch",
+          "name": "branch",
+          "required": false
+        }
+      },
+      "description": "Fetch refs from ByteRover cloud",
       "examples": [
-        "<%= config.bin %> <%= command.id %>"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> origin",
+        "<%= config.bin %> <%= command.id %> origin main"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "vc:status",
+      "id": "vc:fetch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2819,82 +2852,20 @@
         "oclif",
         "commands",
         "vc",
-        "status.js"
+        "fetch.js"
       ]
     },
-    "hub:registry:add": {
+    "vc": {
       "aliases": [],
-      "args": {
-        "name": {
-          "description": "Registry name",
-          "name": "name",
-          "required": true
-        }
-      },
-      "description": "Add a hub registry",
+      "args": {},
+      "description": "Version control commands for the context tree",
       "examples": [
-        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json",
-        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json --token secret",
-        "<%= config.bin %> hub registry add ghrepo --url https://raw.githubusercontent.com/org/repo/main/registry.json --auth-scheme token --token ghp_xxx",
-        "<%= config.bin %> hub registry add gitlab --url https://gitlab.com/.../registry.json --auth-scheme custom-header --header-name PRIVATE-TOKEN --token glpat-xxx"
+        "<%= config.bin %> <%= command.id %> --help"
       ],
-      "flags": {
-        "auth-scheme": {
-          "char": "s",
-          "description": "Auth scheme for hub registry",
-          "name": "auth-scheme",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "bearer",
-            "token",
-            "basic",
-            "custom-header",
-            "none"
-          ],
-          "type": "option"
-        },
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
-          "type": "option"
-        },
-        "header-name": {
-          "description": "Custom header name (for custom-header auth scheme)",
-          "name": "header-name",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "token": {
-          "char": "t",
-          "description": "Auth token for private hub registry",
-          "name": "token",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "url": {
-          "char": "u",
-          "description": "Registry URL",
-          "name": "url",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:registry:add",
+      "id": "vc",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2905,19 +2876,21 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "registry",
-        "add.js"
+        "vc",
+        "index.js"
       ]
     },
-    "hub:registry": {
+    "vc:init": {
       "aliases": [],
       "args": {},
-      "description": "Manage hub registries",
+      "description": "Initialize ByteRover version control for context tree",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:registry",
+      "id": "vc:init",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2928,37 +2901,45 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "registry",
-        "index.js"
+        "vc",
+        "init.js"
       ]
     },
-    "hub:registry:list": {
+    "vc:log": {
       "aliases": [],
-      "args": {},
-      "description": "List configured hub registries",
+      "args": {
+        "branch": {
+          "description": "Branch name to show history for",
+          "name": "branch"
+        }
+      },
+      "description": "Show commit history for the context-tree",
       "examples": [
-        "<%= config.bin %> hub registry list",
-        "<%= config.bin %> hub registry list --format json"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --limit 20",
+        "<%= config.bin %> <%= command.id %> main",
+        "<%= config.bin %> <%= command.id %> --all"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
+        "all": {
+          "char": "a",
+          "description": "Show commits from all branches",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "description": "Number of commits to show",
+          "name": "limit",
+          "default": 10,
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:registry:list",
+      "id": "vc:log",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -2969,42 +2950,63 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "registry",
-        "list.js"
+        "vc",
+        "log.js"
       ]
     },
-    "hub:registry:remove": {
+    "vc:merge": {
       "aliases": [],
       "args": {
-        "name": {
-          "description": "Registry name to remove",
-          "name": "name",
-          "required": true
+        "branch": {
+          "description": "Branch to merge into the current branch",
+          "name": "branch",
+          "required": false
         }
       },
-      "description": "Remove a hub registry",
+      "description": "Merge a branch into the current branch",
       "examples": [
-        "<%= config.bin %> hub registry remove myco"
+        "<%= config.bin %> <%= command.id %> feature/my-branch",
+        "<%= config.bin %> <%= command.id %> --abort",
+        "<%= config.bin %> <%= command.id %> --continue",
+        "<%= config.bin %> <%= command.id %> -m \"Custom merge message\" feature/my-branch"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
+        "abort": {
+          "description": "Abort the current merge",
+          "exclusive": [
+            "continue"
+          ],
+          "name": "abort",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "allow-unrelated-histories": {
+          "description": "Allow merging unrelated histories",
+          "name": "allow-unrelated-histories",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "continue": {
+          "description": "Continue the current merge after resolving conflicts",
+          "exclusive": [
+            "abort"
+          ],
+          "name": "continue",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "message": {
+          "char": "m",
+          "description": "Merge commit message",
+          "name": "message",
           "hasDynamicHelp": false,
           "multiple": false,
-          "options": [
-            "text",
-            "json"
-          ],
           "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "hub:registry:remove",
+      "id": "vc:merge",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3015,77 +3017,160 @@
         "dist",
         "oclif",
         "commands",
-        "hub",
-        "registry",
-        "remove.js"
+        "vc",
+        "merge.js"
       ]
     },
-    "swarm:curate": {
+    "vc:pull": {
       "aliases": [],
       "args": {
-        "content": {
-          "description": "Knowledge content to store in a swarm provider",
-          "name": "content",
-          "required": true
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to pull",
+          "name": "branch",
+          "required": false
         }
       },
-      "description": "Store knowledge in a swarm provider (GBrain, local markdown)",
+      "description": "Pull commits from ByteRover cloud",
       "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"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> origin main",
+        "<%= config.bin %> <%= command.id %> origin main --allow-unrelated-histories"
       ],
       "flags": {
-        "format": {
-          "char": "f",
-          "description": "Output format",
-          "name": "format",
-          "default": "text",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "text",
-            "json"
+        "allow-unrelated-histories": {
+          "description": "Allow merging unrelated histories",
+          "name": "allow-unrelated-histories",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:pull",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "pull.js"
+      ]
+    },
+    "vc:push": {
+      "aliases": [],
+      "args": {
+        "remote": {
+          "description": "Remote name (only origin supported)",
+          "name": "remote",
+          "required": false
+        },
+        "branch": {
+          "description": "Branch to push",
+          "name": "branch",
+          "required": false
+        }
+      },
+      "description": "Push commits to ByteRover cloud",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> -u",
+        "<%= config.bin %> <%= command.id %> origin feat/my-branch"
+      ],
+      "flags": {
+        "set-upstream": {
+          "char": "u",
+          "description": "Set upstream tracking branch",
+          "name": "set-upstream",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "vc:push",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "vc",
+        "push.js"
+      ]
+    },
+    "vc:reset": {
+      "aliases": [],
+      "args": {},
+      "description": "Unstage files or undo commits",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> notes.md",
+        "<%= config.bin %> <%= command.id %> --soft HEAD~1",
+        "<%= config.bin %> <%= command.id %> --hard HEAD~1",
+        "<%= config.bin %> <%= command.id %> --hard"
+      ],
+      "flags": {
+        "hard": {
+          "description": "Reset HEAD, index, and working tree",
+          "exclusive": [
+            "soft"
           ],
-          "type": "option"
+          "name": "hard",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "provider": {
-          "char": "p",
-          "description": "Target provider ID (e.g., gbrain, local-markdown:notes)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "soft": {
+          "description": "Reset HEAD only, keep changes staged",
+          "exclusive": [
+            "hard"
+          ],
+          "name": "soft",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:curate",
+      "id": "vc:reset",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "curate.js"
+        "vc",
+        "reset.js"
       ]
     },
-    "swarm:onboard": {
+    "vc:status": {
       "aliases": [],
       "args": {},
-      "description": "Set up memory swarm with interactive onboarding wizard",
+      "description": "Show ByteRover version control status",
       "examples": [
-        "<%= config.bin %> swarm onboard"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:onboard",
+      "id": "vc:status",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3096,30 +3181,41 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "onboard.js"
+        "vc",
+        "status.js"
       ]
     },
-    "swarm:query": {
+    "hub:registry:add": {
       "aliases": [],
       "args": {
-        "query": {
-          "description": "Natural language query to search across memory providers",
-          "name": "query",
+        "name": {
+          "description": "Registry name",
+          "name": "name",
           "required": true
         }
       },
-      "description": "Query the memory swarm across all active providers",
+      "description": "Add a hub registry",
       "examples": [
-        "<%= config.bin %> swarm query \"auth tokens\"",
-        "<%= config.bin %> swarm query \"what changed yesterday\" --format json"
+        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json",
+        "<%= config.bin %> hub registry add myco --url https://example.com/registry.json --token secret",
+        "<%= config.bin %> hub registry add ghrepo --url https://raw.githubusercontent.com/org/repo/main/registry.json --auth-scheme token --token ghp_xxx",
+        "<%= config.bin %> hub registry add gitlab --url https://gitlab.com/.../registry.json --auth-scheme custom-header --header-name PRIVATE-TOKEN --token glpat-xxx"
       ],
       "flags": {
-        "explain": {
-          "description": "Show classification, routing, and enrichment details (ignored with --format json, which always includes all metadata)",
-          "name": "explain",
-          "allowNo": false,
-          "type": "boolean"
+        "auth-scheme": {
+          "char": "s",
+          "description": "Auth scheme for hub registry",
+          "name": "auth-scheme",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "bearer",
+            "token",
+            "basic",
+            "custom-header",
+            "none"
+          ],
+          "type": "option"
         },
         "format": {
           "char": "f",
@@ -3134,10 +3230,26 @@
           ],
           "type": "option"
         },
-        "max-results": {
-          "char": "n",
-          "description": "Maximum number of results",
-          "name": "max-results",
+        "header-name": {
+          "description": "Custom header name (for custom-header auth scheme)",
+          "name": "header-name",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "token": {
+          "char": "t",
+          "description": "Auth token for private hub registry",
+          "name": "token",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "url": {
+          "char": "u",
+          "description": "Registry URL",
+          "name": "url",
+          "required": true,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
@@ -3145,7 +3257,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:query",
+      "id": "hub:registry:add",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3156,36 +3268,19 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "query.js"
+        "hub",
+        "registry",
+        "add.js"
       ]
     },
-    "swarm:status": {
+    "hub:registry": {
       "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"
-        }
-      },
+      "description": "Manage hub registries",
+      "flags": {},
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "swarm:status",
+      "id": "hub:registry",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3196,32 +3291,22 @@
         "dist",
         "oclif",
         "commands",
-        "swarm",
-        "status.js"
+        "hub",
+        "registry",
+        "index.js"
       ]
     },
-    "query-log:summary": {
+    "hub:registry:list": {
       "aliases": [],
       "args": {},
-      "description": "View aggregated query recall metrics (coverage, cache hit rate, top topics)",
+      "description": "List configured hub registries",
       "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"
+        "<%= config.bin %> hub registry list",
+        "<%= config.bin %> hub registry list --format json"
       ],
       "flags": {
-        "before": {
-          "description": "Entries before (ISO date or relative: 1h, 24h, 7d, 2w)",
-          "name": "before",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "format": {
+          "char": "f",
           "description": "Output format",
           "name": "format",
           "default": "text",
@@ -3229,29 +3314,14 @@
           "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": "hub:registry:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3262,48 +3332,27 @@
         "dist",
         "oclif",
         "commands",
-        "query-log",
-        "summary.js"
+        "hub",
+        "registry",
+        "list.js"
       ]
     },
-    "query-log:view": {
+    "hub:registry:remove": {
       "aliases": [],
       "args": {
-        "id": {
-          "description": "Query log entry ID to view in detail",
-          "name": "id",
-          "required": false
+        "name": {
+          "description": "Registry name to remove",
+          "name": "name",
+          "required": true
         }
       },
-      "description": "View query log history",
+      "description": "Remove a hub registry",
       "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"
+        "<%= config.bin %> hub registry remove myco"
       ],
       "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": {
+          "char": "f",
           "description": "Output format",
           "name": "format",
           "default": "text",
@@ -3314,53 +3363,11 @@
             "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",
+      "id": "hub:registry:remove",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -3371,8 +3378,9 @@
         "dist",
         "oclif",
         "commands",
-        "query-log",
-        "view.js"
+        "hub",
+        "registry",
+        "remove.js"
       ]
     },
     "vc:remote:add": {
@@ -3508,5 +3516,5 @@
       ]
     }
   },
-  "version": "3.12.0"
+  "version": "3.13.0"
 }