byterover-cli 0.1.0

package/oclif.manifest.json

@@ -0,0 +1,476 @@
+{
+  "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": {
+        "directory": {
+          "description": "Project directory (defaults to current directory)",
+          "name": "directory",
+          "required": false
+        }
+      },
+      "description": "Clear local ACE context (playbook) managed by ByteRover CLI",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --yes",
+        "<%= config.bin %> <%= command.id %> /path/to/project"
+      ],
+      "flags": {
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompt",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "clear",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "clear.js"
+      ]
+    },
+    "complete": {
+      "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
+        }
+      },
+      "description": "Complete ACE workflow: save executor output, generate reflection, and update playbook in one command",
+      "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\""
+      ],
+      "flags": {
+        "bullet-ids": {
+          "char": "b",
+          "description": "Comma-separated list of playbook bullet IDs referenced",
+          "name": "bullet-ids",
+          "default": "",
+          "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,
+          "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"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "complete",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "complete.js"
+      ]
+    },
+    "gen-rules": {
+      "aliases": [],
+      "args": {},
+      "description": "Generate rule instructions for coding agents to work with ByteRover correctly",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "gen-rules",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "gen-rules.js"
+      ]
+    },
+    "init": {
+      "aliases": [],
+      "args": {},
+      "description": "Initialize a project with ByteRover (creates .br/config.json with team/space selection and initializes ACE playbook)",
+      "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": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "init",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "init.js"
+      ]
+    },
+    "login": {
+      "aliases": [],
+      "args": {},
+      "description": "Authenticate with ByteRover using OAuth 2.0 + PKCE (opens browser for secure login, stores tokens in keychain)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "# After authentication expires, re-login:\n<%= config.bin %> <%= command.id %>",
+        "# Check authentication status after login:\n<%= config.bin %> <%= command.id %>\n<%= config.bin %> status"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "login",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "login.js"
+      ]
+    },
+    "push": {
+      "aliases": [],
+      "args": {},
+      "description": "Push playbook to ByteRover memory storage and clean up local ACE files",
+      "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": "push",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "push.js"
+      ]
+    },
+    "retrieve": {
+      "aliases": [],
+      "args": {},
+      "description": "Retrieve memories from ByteRover Memora service and output as JSON",
+      "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"
+      ],
+      "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,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "query": {
+          "char": "q",
+          "description": "Search query string",
+          "name": "query",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "retrieve",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "retrieve.js"
+      ]
+    },
+    "status": {
+      "aliases": [],
+      "args": {
+        "directory": {
+          "description": "Project directory (defaults to current directory)",
+          "name": "directory",
+          "required": false
+        }
+      },
+      "description": "Show CLI status and project information. Display local ACE context (ACE playbook) managed by ByteRover CLI",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "# Check status after login:\n<%= config.bin %> login\n<%= config.bin %> <%= command.id %>",
+        "# Verify project initialization:\n<%= config.bin %> init\n<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> /path/to/project",
+        "<%= config.bin %> <%= command.id %> --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "table",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "table",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "status",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "status.js"
+      ]
+    },
+    "space:list": {
+      "aliases": [],
+      "args": {},
+      "description": "List all spaces for the current team (requires project initialization)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --all",
+        "<%= config.bin %> <%= command.id %> --limit 10",
+        "<%= config.bin %> <%= command.id %> --limit 10 --offset 20",
+        "<%= config.bin %> <%= command.id %> --json"
+      ],
+      "flags": {
+        "all": {
+          "char": "a",
+          "description": "Fetch all spaces (may be slow for large teams)",
+          "name": "all",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "json": {
+          "char": "j",
+          "description": "Output in JSON format",
+          "name": "json",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "limit": {
+          "char": "l",
+          "description": "Maximum number of spaces to fetch",
+          "name": "limit",
+          "default": 50,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "char": "o",
+          "description": "Number of spaces to skip",
+          "name": "offset",
+          "default": 0,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:list",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "space",
+        "list.js"
+      ]
+    },
+    "space:switch": {
+      "aliases": [],
+      "args": {},
+      "description": "Switch to a different team or space (updates .br/config.json)",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "# Shows current configuration, then prompts for new team/space selection"
+      ],
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "space:switch",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "space",
+        "switch.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "byterover-cli",
+  "description": "ByteRover's CLI",
+  "version": "0.1.0",
+  "author": "ByteRover",
+  "bin": {
+    "br": "./bin/run.js"
+  },
+  "bugs": "https://github.com/campfirein/byterover-cli/issues",
+  "dependencies": {
+    "@inquirer/prompts": "^7.9.0",
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "axios": "^1.12.2",
+    "chalk": "^5.6.2",
+    "express": "^5.1.0",
+    "keytar": "^7.9.0",
+    "mixpanel": "^0.18.1",
+    "open": "^10.2.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1",
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^4",
+    "@types/express": "^5.0.3",
+    "@types/mocha": "^10",
+    "@types/node": "^18",
+    "@types/sinon": "^17.0.4",
+    "chai": "^4",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-prettier": "^10",
+    "mocha": "^10",
+    "nock": "^14.0.10",
+    "oclif": "^4",
+    "shx": "^0.3.3",
+    "sinon": "^21.0.0",
+    "ts-node": "^10",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "./bin",
+    "./dist",
+    "./oclif.manifest.json"
+  ],
+  "homepage": "https://github.com/campfirein/byterover-cli",
+  "keywords": [
+    "oclif"
+  ],
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "module",
+  "oclif": {
+    "bin": "br",
+    "dirname": "br",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "space": {
+        "description": "Manage ByteRover spaces"
+      }
+    }
+  },
+  "repository": "campfirein/byterover-cli",
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b && shx cp -r src/templates dist/templates",
+    "lint": "eslint",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "npm run lint",
+    "prepack": "npm run build && oclif manifest",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "version": "git add README.md"
+  },
+  "types": "dist/index.d.ts"
+}