byterover-cli 0.2.0 → 0.3.0

package/oclif.manifest.json

@@ -1,67 +1,5 @@
 {
   "commands": {
-    "add": {
-      "aliases": [],
-      "args": {},
-      "description": "Add or update a bullet in the playbook (bypasses ACE workflow for direct agent usage)",
-      "examples": [
-        "<%= config.bin %> <%= command.id %> --interactive",
-        "<%= config.bin %> <%= command.id %> -i",
-        "<%= config.bin %> <%= command.id %> --section \"Common Errors\" --content \"Authentication fails when token expires\"",
-        "<%= config.bin %> <%= command.id %> --section \"Common Errors\" --bullet-id \"common-00001\" --content \"Updated: Auth fails when token expires\"",
-        "<%= config.bin %> <%= command.id %> -s \"Best Practices\" -c \"Always validate user input before processing\""
-      ],
-      "flags": {
-        "bullet-id": {
-          "char": "b",
-          "description": "Bullet ID to update (if not provided, a new bullet will be created)",
-          "name": "bullet-id",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "content": {
-          "char": "c",
-          "description": "Content of the bullet",
-          "name": "content",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "interactive": {
-          "char": "i",
-          "description": "Run in interactive mode",
-          "name": "interactive",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "section": {
-          "char": "s",
-          "description": "Section name for the bullet",
-          "name": "section",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "add",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "add.js"
-      ]
-    },
     "clear": {
       "aliases": [],
       "args": {
@@ -71,7 +9,7 @@
           "required": false
         }
       },
-      "description": "Clear local ACE context (playbook) managed by ByteRover CLI",
+      "description": "Reset the context tree to its original state (6 default domains)",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --yes",
@@ -101,71 +39,58 @@
         "clear.js"
       ]
     },
-    "complete": {
+    "curate": {
       "aliases": [],
       "args": {
-        "hint": {
-          "description": "Short hint for naming output files (e.g., \"user-auth\", \"bug-fix\")",
-          "name": "hint",
-          "required": true
-        },
-        "reasoning": {
-          "description": "Detailed reasoning and approach for completing the task",
-          "name": "reasoning",
-          "required": true
-        },
-        "finalAnswer": {
-          "description": "The final answer/solution to the task",
-          "name": "finalAnswer",
-          "required": true
+        "context": {
+          "description": "Knowledge context: patterns, decisions, errors, or insights (triggers autonomous mode)",
+          "name": "context",
+          "required": false
         }
       },
-      "description": "Complete ACE workflow: save executor output, generate reflection, and update playbook in one command",
+      "description": "Curate context to the context tree (interactive or autonomous mode)\nGood:\n- \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"\n- \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\"\nBad:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> \"user-auth\" \"Implemented OAuth2 flow\" \"Auth works\" --tool-usage \"Read:src/auth.ts,Edit:src/auth.ts,Bash:npm test\" --feedback \"All tests passed\"",
-        "<%= config.bin %> <%= command.id %> \"validation-fix\" \"Analyzed validator\" \"Fixed bug\" --tool-usage \"Grep:pattern:\\\"validate\\\",Read:src/validator.ts\" --bullet-ids \"bullet-123\" --feedback \"Tests passed\"",
-        "<%= config.bin %> <%= command.id %> \"auth-update\" \"Improved error handling\" \"Better errors\" --tool-usage \"Edit:src/auth.ts\" --feedback \"Tests passed\" --update-bullet \"bullet-5\""
+        "# Interactive mode (manually choose domain/topic)",
+        "<%= config.bin %> <%= command.id %>",
+        "",
+        "# Autonomous mode - LLM auto-categorizes your context",
+        "<%= config.bin %> <%= command.id %> \"Auth uses JWT with 24h expiry. Tokens stored in httpOnly cookies via authMiddleware.ts\"",
+        "",
+        "# Autonomous mode with OpenRouter (development only)",
+        "<%= config.bin %> <%= command.id %> -k YOUR_API_KEY \"React components follow atomic design in src/components/. Atoms in atoms/, molecules in molecules/, organisms in organisms/\"",
+        "",
+        "# Autonomous mode with custom model (development only)",
+        "<%= config.bin %> <%= command.id %> -k YOUR_API_KEY -m anthropic/claude-sonnet-4 \"API rate limit is 100 req/min per user. Implemented using Redis with sliding window in rateLimiter.ts\""
       ],
       "flags": {
-        "bullet-ids": {
-          "char": "b",
-          "description": "Comma-separated list of playbook bullet IDs referenced",
-          "name": "bullet-ids",
-          "default": "",
+        "apiKey": {
+          "char": "k",
+          "description": "OpenRouter API key (use OpenRouter instead of internal gRPC backend) [Development only]",
+          "env": "OPENROUTER_API_KEY",
+          "name": "apiKey",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "feedback": {
-          "char": "f",
-          "description": "Environment feedback about task execution (e.g., \"Tests passed\", \"Build failed\")",
-          "name": "feedback",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "tool-usage": {
-          "char": "t",
-          "description": "Comma-separated list of tool calls with arguments (format: \"ToolName:argument\", e.g., \"Read:src/file.ts,Bash:npm test\")",
-          "name": "tool-usage",
-          "required": true,
+        "model": {
+          "char": "m",
+          "description": "Model to use (default: google/gemini-2.5-pro for OpenRouter, gemini-2.5-pro for gRPC) [Development only]",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "update-bullet": {
-          "char": "u",
-          "description": "Bullet ID to update with new knowledge (if not provided, adds new bullet)",
-          "name": "update-bullet",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "verbose": {
+          "char": "v",
+          "description": "Enable verbose debug output [Development only]",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "complete",
+      "id": "curate",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -175,7 +100,28 @@
       "relativePath": [
         "dist",
         "commands",
-        "complete.js"
+        "curate.js"
+      ]
+    },
+    "foo": {
+      "aliases": [],
+      "args": {},
+      "description": "Purely for testing CodingAgentLogWatcher [Development only]",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "foo",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "foo.js"
       ]
     },
     "gen-rules": {
@@ -185,7 +131,16 @@
       "examples": [
         "<%= config.bin %> <%= command.id %>"
       ],
-      "flags": {},
+      "flags": {
+        "agent": {
+          "char": "a",
+          "description": "Agent to generate rules for (optional, will prompt if not provided)",
+          "name": "agent",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "gen-rules",
@@ -204,13 +159,21 @@
     "init": {
       "aliases": [],
       "args": {},
-      "description": "Initialize a project with ByteRover (creates .brv/config.json with team/space selection and initializes ACE playbook)",
+      "description": "Initialize a project with ByteRover (creates .brv/config.json with team/space selection and initializes Context Tree)",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "# Re-initialize if config exists (will show current config and exit):\n<%= config.bin %> <%= command.id %>",
         "# Full workflow: login then initialize:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>"
       ],
-      "flags": {},
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Force re-initialization without confirmation prompt",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "init",
@@ -251,10 +214,77 @@
         "login.js"
       ]
     },
+    "logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Log out of ByteRover CLI and clear authentication (does not affect local project files)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --yes"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logout",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "logout.js"
+      ]
+    },
+    "pull": {
+      "aliases": [],
+      "args": {},
+      "description": "Pull context tree from ByteRover memory storage",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --branch develop",
+        "<%= config.bin %> <%= command.id %> -b feature-auth"
+      ],
+      "flags": {
+        "branch": {
+          "char": "b",
+          "description": "ByteRover branch name (not Git branch)",
+          "name": "branch",
+          "default": "main",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "pull",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "pull.js"
+      ]
+    },
     "push": {
       "aliases": [],
       "args": {},
-      "description": "Push playbook to ByteRover memory storage and clean up local ACE files",
+      "description": "Push context tree to ByteRover memory storage",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --branch develop",
@@ -293,55 +323,69 @@
         "push.js"
       ]
     },
-    "retrieve": {
+    "query": {
       "aliases": [],
-      "args": {},
-      "description": "Retrieve memories from ByteRover Memora service and output as JSON",
+      "args": {
+        "query": {
+          "description": "Natural language question about your codebase or project knowledge",
+          "name": "query",
+          "required": true
+        }
+      },
+      "description": "Query and retrieve information from the context tree\nGood:\n- \"How is user authentication implemented?\"\n- \"What are the API rate limits and where are they enforced?\"\nBad:\n- \"auth\" or \"authentication\" (too vague, not a question)\n- \"show me code\" (not specific about what information is needed)",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --query \"authentication best practices\"",
-        "<%= config.bin %> <%= command.id %> -q \"error handling\" -n \"src/auth/login.ts,src/auth/oauth.ts\"",
-        "<%= config.bin %> <%= command.id %> -q \"database connection issues\" --compact"
+        "# Ask questions about patterns, decisions, or implementation details",
+        "<%= config.bin %> <%= command.id %> What are the coding standards?",
+        "<%= config.bin %> <%= command.id %> How is authentication implemented?",
+        "",
+        "# Query with OpenRouter (development only)",
+        "<%= config.bin %> <%= command.id %> -k YOUR_API_KEY Show me all API endpoints",
+        "",
+        "# Query with custom model (development only)",
+        "<%= config.bin %> <%= command.id %> -k YOUR_API_KEY -m anthropic/claude-sonnet-4 Explain the database schema",
+        "",
+        "# Query with verbose output (development only)",
+        "<%= config.bin %> <%= command.id %> -v What testing strategies are used?"
       ],
       "flags": {
-        "compact": {
-          "description": "Output compact JSON (single line)",
-          "name": "compact",
-          "required": false,
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "node-keys": {
-          "char": "n",
-          "description": "Comma-separated list of node keys (file paths) to filter results",
-          "name": "node-keys",
-          "required": false,
+        "apiKey": {
+          "char": "k",
+          "description": "OpenRouter API key (use OpenRouter instead of internal gRPC backend) [Development only]",
+          "env": "OPENROUTER_API_KEY",
+          "name": "apiKey",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "query": {
-          "char": "q",
-          "description": "Search query string",
-          "name": "query",
-          "required": true,
+        "model": {
+          "char": "m",
+          "description": "Model to use (default: google/gemini-2.5-pro for OpenRouter, gemini-2.5-pro for gRPC) [Development only]",
+          "name": "model",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Enable verbose debug output [Development only]",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "retrieve",
+      "id": "query",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
-      "strict": true,
+      "strict": false,
       "enableJsonFlag": false,
       "isESM": true,
       "relativePath": [
         "dist",
         "commands",
-        "retrieve.js"
+        "query.js"
       ]
     },
     "status": {
@@ -353,7 +397,7 @@
           "required": false
         }
       },
-      "description": "Show CLI status and project information. Display local ACE context (ACE playbook) managed by ByteRover CLI",
+      "description": "Show CLI status and project information. Display local context tree managed by ByteRover CLI",
       "examples": [
         "<%= config.bin %> <%= command.id %>",
         "# Check status after login:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>",
@@ -392,6 +436,242 @@
         "status.js"
       ]
     },
+    "watch": {
+      "aliases": [],
+      "args": {},
+      "description": "Watch file system directories for changes and trigger parsing pipeline [Development only]",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --paths ./agent-logs",
+        "<%= config.bin %> <%= command.id %> --paths ./logs,./outputs,./workspace",
+        "<%= config.bin %> <%= command.id %> -p ./src,./lib",
+        "# Use chat log path from config (if IDE was configured during init):",
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "clean": {
+          "description": "Run clean parsing after raw parsing (default: true)",
+          "name": "clean",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "debounce": {
+          "description": "Debounce time in milliseconds before triggering parsing (default: 2000)",
+          "name": "debounce",
+          "default": 2000,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "paths": {
+          "char": "p",
+          "description": "Comma-separated list of directories to watch (defaults to configured chat log path)",
+          "name": "paths",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "watch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "watch.js"
+      ]
+    },
+    "cipher-agent:run": {
+      "aliases": [],
+      "args": {
+        "prompt": {
+          "description": "The prompt to send to CipherAgent (optional in interactive mode)",
+          "name": "prompt",
+          "required": false
+        }
+      },
+      "description": "Run CipherAgent in interactive or single-execution mode [Development only]",
+      "examples": [
+        "# Interactive mode (creates new unique session each time)",
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --interactive",
+        "",
+        "# Continue most recent session in interactive mode",
+        "<%= config.bin %> <%= command.id %> -c",
+        "<%= config.bin %> <%= command.id %> -c -i",
+        "",
+        "# Resume specific session in interactive mode",
+        "<%= config.bin %> <%= command.id %> -r session-1731686400123-a7b3c9",
+        "<%= config.bin %> <%= command.id %> -r session-1731686400123-a7b3c9 -i",
+        "",
+        "# Single execution mode (creates new unique session)",
+        "<%= config.bin %> <%= command.id %> \"Analyze the project structure\" --no-interactive",
+        "<%= config.bin %> <%= command.id %> \"Find all TypeScript files\" --no-interactive",
+        "",
+        "# Continue session with a new prompt (headless)",
+        "<%= config.bin %> <%= command.id %> -c \"What did we discuss?\"",
+        "<%= config.bin %> <%= command.id %> -r session-1731686400123-a7b3c9 \"Continue implementation\"",
+        "",
+        "# Piped input (automatically uses non-interactive mode)",
+        "echo \"Analyze the codebase\" | <%= config.bin %> <%= command.id %>",
+        "",
+        "# Specify working directory",
+        "<%= config.bin %> <%= command.id %> -w /path/to/project",
+        "<%= config.bin %> <%= command.id %> --working-directory ~/myproject"
+      ],
+      "flags": {
+        "apiKey": {
+          "char": "k",
+          "description": "OpenRouter API key (use OpenRouter instead of gRPC backend) [Development only]",
+          "env": "OPENROUTER_API_KEY",
+          "name": "apiKey",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to use (default: google/gemini-2.5-pro for OpenRouter, gemini-2.5-pro for gRPC) [Development only]",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "verbose": {
+          "char": "v",
+          "description": "Enable verbose debug output for prompt loading and agent operations [Development only]",
+          "name": "verbose",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "continue": {
+          "char": "c",
+          "description": "Continue most recent session (requires prompt in headless mode)",
+          "name": "continue",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "interactive": {
+          "char": "i",
+          "description": "Enable interactive mode (auto-detected from TTY if not specified)",
+          "name": "interactive",
+          "allowNo": true,
+          "type": "boolean"
+        },
+        "maxTokens": {
+          "char": "t",
+          "description": "Maximum tokens in response (default: 8192)",
+          "name": "maxTokens",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "resume": {
+          "char": "r",
+          "description": "Resume specific session by ID (requires prompt in headless mode)",
+          "name": "resume",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "temperature": {
+          "char": "T",
+          "description": "Temperature for randomness 0-1 (default: 0.2)",
+          "name": "temperature",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "workingDirectory": {
+          "char": "w",
+          "description": "Working directory for file operations (default: current directory)",
+          "name": "workingDirectory",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "cipher-agent:run",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cipher-agent",
+        "run.js"
+      ]
+    },
+    "cipher-agent:set-prompt": {
+      "aliases": [],
+      "args": {
+        "prompt": {
+          "description": "The system prompt for CipherAgent",
+          "name": "prompt",
+          "required": true
+        }
+      },
+      "description": "Set custom system prompt for CipherAgent [Development only]",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> \"You are a helpful coding assistant specialized in TypeScript\"",
+        "<%= config.bin %> <%= command.id %> \"You are an expert in refactoring and code quality improvements\""
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "cipher-agent:set-prompt",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cipher-agent",
+        "set-prompt.js"
+      ]
+    },
+    "cipher-agent:show-prompt": {
+      "aliases": [],
+      "args": {},
+      "description": "Show the current CipherAgent system prompt [Development only]",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hidden": false,
+      "hiddenAliases": [],
+      "id": "cipher-agent:show-prompt",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "cipher-agent",
+        "show-prompt.js"
+      ]
+    },
     "space:list": {
       "aliases": [],
       "args": {},
@@ -479,5 +759,5 @@
       ]
     }
   },
-  "version": "0.2.0"
+  "version": "0.3.0"
 }