byterover-cli 0.4.0 → 1.0.0

package/oclif.manifest.json

@@ -9,27 +9,21 @@
           "required": false
         }
       },
-      "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)",
+      "description": "Curate context to the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\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": [
-        "# Autonomous mode - LLM auto-categorizes your context",
+        "# Curate context - queues task for background processing",
         "<%= 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.",
+        "# Include relevant files for comprehensive context (max 5 files)",
+        "<%= config.bin %> <%= command.id %> \"Authentication middleware validates JWT tokens\" -f src/middleware/auth.ts",
         "",
-        "## 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",
-        ""
+        "# Multiple files",
+        "<%= config.bin %> <%= command.id %> \"JWT authentication implementation\" --files src/auth/jwt.ts --files docs/auth.md"
       ],
       "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.",
+          "description": "Include specific file paths for critical context (max 5 files)",
           "name": "files",
           "hasDynamicHelp": false,
           "multiple": true,
@@ -51,27 +45,6 @@
         "curate.js"
       ]
     },
-    "foo": {
-      "aliases": [],
-      "args": {},
-      "description": "Purely for testing CodingAgentLogWatcher [Development only]",
-      "flags": {},
-      "hasDynamicHelp": false,
-      "hidden": true,
-      "hiddenAliases": [],
-      "id": "foo",
-      "pluginAlias": "byterover-cli",
-      "pluginName": "byterover-cli",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "foo.js"
-      ]
-    },
     "main": {
       "aliases": [],
       "args": {},
@@ -102,12 +75,11 @@
           "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)",
+      "description": "Query and retrieve information from the context tree (connects to running brv instance)\n\nRequires a running brv instance. Start one with: brv start\n\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": [
         "# 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?",
-        ""
+        "<%= config.bin %> <%= command.id %> How is authentication implemented?"
       ],
       "flags": {},
       "hasDynamicHelp": false,
@@ -224,167 +196,7 @@
         "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": {
-        "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": true,
-      "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": true,
-      "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": true,
-      "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"
-      ]
     }
   },
-  "version": "0.4.0"
+  "version": "1.0.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "0.4.0",
+  "version": "1.0.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -36,6 +36,8 @@
     "open": "^10.2.0",
     "openai": "^6.9.1",
     "react": "^19.2.1",
+    "socket.io": "^4.8.1",
+    "socket.io-client": "^4.8.1",
     "update-notifier": "^7.3.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"
@@ -44,6 +46,7 @@
     "@eslint/compat": "^1",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
+    "@socket.io/admin-ui": "^0.5.1",
     "@types/better-sqlite3": "^7.6.13",
     "@types/chai": "^4",
     "@types/express": "^5.0.3",
@@ -56,6 +59,7 @@
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "eslint-import-resolver-typescript": "^4.4.4",
     "expect-type": "^1.2.2",
     "mocha": "^10",
     "nock": "^14.0.10",

package/dist/commands/cipher-agent/run.d.ts

@@ -1,142 +0,0 @@
-import { Command } from '@oclif/core';
-import type { IProjectConfigStore } from '../../core/interfaces/i-project-config-store.js';
-import type { ITerminal } from '../../core/interfaces/i-terminal.js';
-import { CipherAgent } from '../../infra/cipher/cipher-agent.js';
-export default class CipherAgentRun extends Command {
-    static args: {
-        prompt: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        continue: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        maxTokens: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        resume: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        temperature: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        workingDirectory: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        apiKey?: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions> | undefined;
-        model?: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions> | undefined;
-        verbose?: import("@oclif/core/interfaces").BooleanFlag<boolean> | undefined;
-    };
-    static hidden: boolean;
-    protected terminal: ITerminal;
-    catch(error: Error & {
-        oclif?: {
-            exit: number;
-        };
-    }): Promise<void>;
-    protected createServices(): {
-        projectConfigStore: IProjectConfigStore;
-    };
-    /**
-     * Generate a unique session ID with timestamp and random component.
-     *
-     * Format: "session-{timestamp}-{random}"
-     * Example: "session-1731686400123-a7b3c9"
-     *
-     * @returns Unique session ID string
-     */
-    protected generateSessionId(): string;
-    /**
-     * Get the most recent session ID from history storage.
-     *
-     * @param agent - CipherAgent instance
-     * @returns Most recent session ID or undefined if no sessions found
-     */
-    protected getMostRecentSessionId(agent: CipherAgent): Promise<string | undefined>;
-    run(): Promise<void>;
-    /**
-     * Validate that a session exists in storage.
-     *
-     * @param agent - CipherAgent instance
-     * @param sessionId - Session ID to validate
-     * @returns True if session exists
-     */
-    protected validateSessionExists(agent: CipherAgent, sessionId: string): Promise<boolean>;
-    /**
-     * Create LLM configuration from flags and environment
-     *
-     * @param token - Authentication token
-     * @param token.accessToken - Access token for authentication
-     * @param token.sessionKey - Session key for authentication
-     * @param token.spaceId - Space ID for the session
-     * @param token.teamId - Team ID for the session
-     * @param flags - Command flags
-     * @param flags.apiKey - OpenRouter API key for direct service (optional)
-     * @param flags.maxTokens - Maximum tokens in response
-     * @param flags.model - Model to use
-     * @param flags.temperature - Temperature for randomness
-     * @param flags.verbose - Enable verbose debug output
-     * @param flags.workingDirectory - Working directory for file operations
-     * @returns LLM configuration object
-     */
-    private createLLMConfig;
-    /**
-     * Format curate tool result summary
-     *
-     * @param result - Tool result data
-     * @returns Formatted summary string or empty
-     */
-    private formatCurateResult;
-    /**
-     * Format find_knowledge_topics tool result summary
-     *
-     * @param result - Tool result data
-     * @returns Formatted summary string or empty
-     */
-    private formatFindKnowledgeTopicsResult;
-    /**
-     * Format grep_content tool result summary
-     *
-     * @param result - Tool result data
-     * @returns Formatted summary string or empty
-     */
-    private formatGrepContentResult;
-    /**
-     * Format list_directory tool result summary
-     *
-     * @param result - Tool result data
-     * @returns Formatted summary string or empty
-     */
-    private formatListDirectoryResult;
-    /**
-     * Format tool call for concise display in interactive mode
-     *
-     * @param toolName - Name of the tool
-     * @param args - Tool arguments
-     * @returns Formatted string for display
-     */
-    private formatToolForInteractive;
-    /**
-     * Format tool result summary for display
-     *
-     * @param toolName - Name of the tool
-     * @param result - Tool result data
-     * @returns Formatted summary string or empty if no summary needed
-     */
-    private formatToolResultSummary;
-    /**
-     * Handle workspace not initialized error with friendly message
-     *
-     * @param _error - WorkspaceNotInitializedError instance (unused, kept for type safety)
-     */
-    private handleWorkspaceError;
-    /**
-     * Resolve session ID based on flags
-     *
-     * @param agent - CipherAgent instance
-     * @param flags - Command flags
-     * @param flags.continue - Continue most recent session flag
-     * @param flags.resume - Resume specific session flag
-     * @returns Resolved session ID
-     */
-    private resolveSessionId;
-    /**
-     * Setup event listeners based on mode
-     *
-     * @param agent - CipherAgent instance
-     * @param isInteractive - Whether in interactive mode
-     */
-    private setupEventListeners;
-}