byterover-cli 0.3.5 → 0.4.1

package/dist/utils/file-validator.js

@@ -0,0 +1,81 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+/**
+ * Normalize file path - handles relative, absolute, tilde, symlinks
+ * Returns absolute canonical path
+ * @param filePath - The file path to normalize
+ * @returns Normalized absolute path
+ */
+function normalizeFilePath(filePath) {
+    // Expand tilde to home directory
+    const expanded = filePath.startsWith('~') ? filePath.replace(/^~/, os.homedir()) : filePath;
+    // Resolve to absolute path
+    const absolute = path.resolve(expanded);
+    // Resolve symlinks (only if file exists)
+    try {
+        return fs.realpathSync(absolute);
+    }
+    catch {
+        // File doesn't exist or cannot resolve, return resolved path
+        return absolute;
+    }
+}
+/**
+ * Check if file is text (no null bytes in first 8KB)
+ * Returns false for binary files (images, PDFs, compiled binaries, etc.)
+ * @param filePath - The file path to check
+ * @returns true if file is text, false if binary
+ */
+function isTextFile(filePath) {
+    try {
+        const buffer = Buffer.alloc(8192);
+        const fd = fs.openSync(filePath, 'r');
+        const bytesRead = fs.readSync(fd, buffer, 0, 8192, 0);
+        fs.closeSync(fd);
+        // Check for null bytes (indicates binary file)
+        for (let i = 0; i < bytesRead; i++) {
+            if (buffer[i] === 0)
+                return false;
+        }
+        return true;
+    }
+    catch {
+        // If we can't read the file, consider it non-text
+        return false;
+    }
+}
+/**
+ * Validate file for --files flag in brv curate command
+ * Checks:
+ * 1. File exists
+ * 2. File is within project directory (where .brv exists)
+ * 3. File is text/code file (not binary)
+ *
+ * @param filePath - The file path to validate (can be relative, absolute, or tilde)
+ * @param projectRoot - The project root directory (current working directory)
+ * @returns Validation result with normalized path or error message
+ */
+export function validateFileForCurate(filePath, projectRoot) {
+    // Normalize path
+    const normalized = normalizeFilePath(filePath);
+    // Check existence
+    if (!fs.existsSync(normalized)) {
+        return { error: `File does not exist: ${filePath}`, valid: false };
+    }
+    // Check if it's a file (not a directory)
+    const stats = fs.statSync(normalized);
+    if (!stats.isFile()) {
+        return { error: `Path is not a file: ${filePath}`, valid: false };
+    }
+    // Check within project (normalized paths for reliable comparison)
+    const normalizedProjectRoot = normalizeFilePath(projectRoot);
+    if (!normalized.startsWith(normalizedProjectRoot + path.sep) && normalized !== normalizedProjectRoot) {
+        return { error: `File is outside project directory: ${filePath}`, valid: false };
+    }
+    // Check is text file
+    if (!isTextFile(normalized)) {
+        return { error: `File is not a text/code file (binary detected): ${filePath}`, valid: false };
+    }
+    return { normalizedPath: normalized, valid: true };
+}

package/dist/utils/global-config-path.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Returns the global config directory path following platform conventions:
+ * - Linux: $XDG_CONFIG_HOME/brv (defaults to ~/.config/brv)
+ * - macOS: ~/.config/brv (CLI tool convention)
+ * - Windows: %APPDATA%/brv
+ *
+ * @returns Absolute path to the global config directory
+ */
+export declare const getGlobalConfigDir: () => string;
+/**
+ * Returns the full path to the global config file.
+ *
+ * @returns Absolute path to the global config file
+ */
+export declare const getGlobalConfigPath: () => string;

package/dist/utils/global-config-path.js

@@ -0,0 +1,38 @@
+import { homedir, platform } from 'node:os';
+import { join } from 'node:path';
+import { GLOBAL_CONFIG_DIR, GLOBAL_CONFIG_FILE } from '../constants.js';
+/**
+ * Returns the global config directory path following platform conventions:
+ * - Linux: $XDG_CONFIG_HOME/brv (defaults to ~/.config/brv)
+ * - macOS: ~/.config/brv (CLI tool convention)
+ * - Windows: %APPDATA%/brv
+ *
+ * @returns Absolute path to the global config directory
+ */
+export const getGlobalConfigDir = () => {
+    const currentPlatform = platform();
+    if (currentPlatform === 'win32') {
+        // Windows: use APPDATA
+        const appData = process.env.APPDATA;
+        if (appData !== undefined) {
+            return join(appData, GLOBAL_CONFIG_DIR);
+        }
+        // Fallback to home directory if APPDATA is not set
+        return join(homedir(), 'AppData', 'Roaming', GLOBAL_CONFIG_DIR);
+    }
+    // Linux: respect XDG_CONFIG_HOME if set
+    if (currentPlatform === 'linux') {
+        const xdgConfigHome = process.env.XDG_CONFIG_HOME;
+        if (xdgConfigHome !== undefined) {
+            return join(xdgConfigHome, GLOBAL_CONFIG_DIR);
+        }
+    }
+    // Linux (default) and macOS; use ~/.config/brv
+    return join(homedir(), '.config', GLOBAL_CONFIG_DIR);
+};
+/**
+ * Returns the full path to the global config file.
+ *
+ * @returns Absolute path to the global config file
+ */
+export const getGlobalConfigPath = () => join(getGlobalConfigDir(), GLOBAL_CONFIG_FILE);

package/oclif.manifest.json

@@ -1,63 +1,41 @@
 {
   "commands": {
-    "clear": {
-      "aliases": [],
-      "args": {
-        "directory": {
-          "description": "Project directory (defaults to current directory)",
-          "name": "directory",
-          "required": false
-        }
-      },
-      "description": "Reset the context tree to its original state (6 default domains)",
-      "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"
-      ]
-    },
     "curate": {
       "aliases": [],
       "args": {
         "context": {
-          "description": "Knowledge context: patterns, decisions, errors, or insights (triggers autonomous mode)",
+          "description": "Knowledge context: patterns, decisions, errors, or insights",
           "name": "context",
           "required": false
         }
       },
-      "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)",
+      "description": "Curate context to the context tree (autonomous mode)\n\nFor interactive mode, use REPL: brv repl then /curate\n\nGood examples:\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 examples:\n- \"Authentication\" or \"JWT tokens\" (too vague, lacks context)\n- \"Rate limiting\" (no implementation details or file references)",
       "examples": [
-        "# 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\"",
+        "",
+        "# Include relevant files for comprehensive context (use sparingly, max 5 files)",
+        "- NOTE: CONTEXT argument must come BEFORE --files flag",
+        "- NOTE: For multiple files, repeat --files (or -f) flag for each file",
+        "- NOTE: Only text/code files from current project directory.",
+        "",
+        "## Single file",
+        "<%= config.bin %> <%= command.id %> \"Authentication middleware validates JWT tokens and attaches user context\" -f src/middleware/auth.ts",
+        "",
+        "## Multiple files",
+        "<%= config.bin %> <%= command.id %> \"JWT authentication implementation with refresh token rotation\" --files src/auth/jwt.ts --files docs/auth.md",
         ""
       ],
-      "flags": {},
+      "flags": {
+        "files": {
+          "char": "f",
+          "description": "Include specific file paths for critical context (max 5 files). Only text/code files from the current project directory are allowed. Use sparingly - only for truly relevant files like docs or key implementation details. NOTE: CONTEXT argument must come BEFORE this flag.",
+          "name": "files",
+          "hasDynamicHelp": false,
+          "multiple": true,
+          "type": "option"
+        }
+      },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
       "id": "curate",
@@ -94,193 +72,15 @@
         "foo.js"
       ]
     },
-    "gen-rules": {
-      "aliases": [],
-      "args": {},
-      "description": "Generate rule instructions for coding agents to work with ByteRover correctly",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "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",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "gen-rules.js"
-      ]
-    },
-    "init": {
+    "main": {
       "aliases": [],
       "args": {},
-      "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": {
-        "force": {
-          "char": "f",
-          "description": "Force re-initialization without confirmation prompt",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "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"
-      ],
+      "description": "ByteRover CLI - Interactive REPL",
       "flags": {},
       "hasDynamicHelp": false,
+      "hidden": true,
       "hiddenAliases": [],
-      "id": "login",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "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 context tree to 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"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompt",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "push",
+      "id": "main",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -290,7 +90,7 @@
       "relativePath": [
         "dist",
         "commands",
-        "push.js"
+        "main.js"
       ]
     },
     "query": {
@@ -584,93 +384,7 @@
         "cipher-agent",
         "show-prompt.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 .brv/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.3.5"
+  "version": "0.4.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "0.3.5",
+  "version": "0.4.1",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -11,8 +11,7 @@
     "@anthropic-ai/sdk": "^0.70.1",
     "@anthropic-ai/vertex-sdk": "^0.14.0",
     "@google/genai": "^1.29.0",
-    "@grpc/grpc-js": "^1.10.0",
-    "@grpc/proto-loader": "^0.7.13",
+    "@inkjs/ui": "^2.0.0",
     "@inquirer/prompts": "^7.9.0",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
@@ -22,8 +21,13 @@
     "chalk": "^5.6.2",
     "chokidar": "^4.0.3",
     "express": "^5.1.0",
+    "fullscreen-ink": "^0.1.0",
     "glob": "^11.0.3",
+    "gradient-string": "^3.0.0",
     "ignore": "^7.0.5",
+    "ink": "^6.5.1",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
     "inquirer-file-selector": "^1.0.1",
     "js-yaml": "^4.1.1",
     "keytar": "^7.9.0",
@@ -31,6 +35,7 @@
     "nanoid": "^5.1.6",
     "open": "^10.2.0",
     "openai": "^6.9.1",
+    "react": "^19.2.1",
     "update-notifier": "^7.3.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
@@ -45,6 +50,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10",
     "@types/node": "^20",
+    "@types/react": "^19.2.7",
     "@types/sinon": "^17.0.4",
     "chai": "^4",
     "eslint": "^9",
@@ -57,6 +63,7 @@
     "shx": "^0.3.3",
     "sinon": "^21.0.0",
     "ts-node": "^10",
+    "tsx": "^4.21.0",
     "typescript": "^5"
   },
   "engines": {
@@ -97,7 +104,7 @@
   },
   "repository": "campfirein/byterover-cli",
   "scripts": {
-    "build": "shx rm -rf dist && tsc -b && shx cp -r src/templates dist/templates && shx cp -r src/resources dist/resources && shx cp src/infra/cipher/grpc/internal-llm-grpc.proto dist/infra/cipher/grpc/",
+    "build": "shx rm -rf dist && tsc -b && shx cp -r src/templates dist/templates && shx cp -r src/resources dist/resources",
     "lint": "eslint",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",

package/dist/commands/clear.d.ts

@@ -1,19 +0,0 @@
-import { Command } from '@oclif/core';
-import type { IContextTreeService } from '../core/interfaces/i-context-tree-service.js';
-import type { IContextTreeSnapshotService } from '../core/interfaces/i-context-tree-snapshot-service.js';
-export default class Clear extends Command {
-    static args: {
-        directory: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-    };
-    protected confirmClear(): Promise<boolean>;
-    protected createServices(): {
-        contextTreeService: IContextTreeService;
-        contextTreeSnapshotService: IContextTreeSnapshotService;
-    };
-    run(): Promise<void>;
-}