byterover-cli 2.5.1 → 2.6.0

package/dist/server/utils/file-helpers.js

@@ -1,49 +1,3 @@
-import fs from 'node:fs';
-import { readdir, unlink } from 'node:fs/promises';
-import { join } from 'node:path';
-/**
- * Finds the most recent file in a directory by modification time.
- * @param directory - Absolute path to directory to search
- * @returns Absolute path to the most recent file
- * @throws Error if directory is empty or doesn't exist
- */
-export async function findLatestFile(directory) {
-    const files = await readdir(directory, { withFileTypes: true });
-    const fileNames = files.filter((f) => f.isFile()).map((f) => f.name);
-    if (fileNames.length === 0) {
-        throw new Error(`No files found in directory: ${directory}`);
-    }
-    // Sort files by name (timestamp-based naming ensures latest is last)
-    // Assuming filenames follow pattern: prefix-{timestamp}.json
-    fileNames.sort();
-    const latestFile = fileNames.at(-1);
-    return join(directory, latestFile);
-}
-/**
- * Removes all files from a directory while preserving the directory itself.
- * Returns the number of files removed.
- * Silently succeeds if directory doesn't exist.
- * @param dirPath - Absolute path to directory to clear
- * @returns Number of files removed
- */
-export async function clearDirectory(dirPath) {
-    try {
-        const entries = await readdir(dirPath, { withFileTypes: true });
-        // Filter to only get files (not subdirectories)
-        const files = entries.filter((entry) => entry.isFile());
-        // Remove each file
-        await Promise.all(files.map((file) => unlink(join(dirPath, file.name))));
-        return files.length;
-    }
-    catch (error) {
-        // If directory doesn't exist (ENOENT), return 0
-        if (error.code === 'ENOENT') {
-            return 0;
-        }
-        // Re-throw other errors
-        throw error;
-    }
-}
 /**
  * Sanitizes a folder path by replacing all special characters with a hyphen.
  * @param folderName - The folder path need to sanitize
@@ -73,38 +27,3 @@ export function toSnakeCase(name) {
         .replaceAll(/_{2,}/g, '_')
         .replaceAll(/^_|_$/g, '');
 }
-/**
- * Lists all immediate children (files and directories) of the given directory,
- * and, for each child folder, shows its own immediate children.
- * @param dirPath The directory path whose children to list.
- * @returns An object where keys are child names, and values are:
- *   - for files: undefined
- *   - for directories: an array of their immediate children
- */
-export function listDirectoryChildren(dirPath = '.brv/context-tree') {
-    const result = {};
-    const children = fs.readdirSync(dirPath);
-    for (const child of children) {
-        const childPath = `${dirPath}/${child}`;
-        let stat;
-        try {
-            stat = fs.statSync(childPath);
-        }
-        catch {
-            result[child] = undefined;
-            continue;
-        }
-        if (stat.isDirectory()) {
-            try {
-                result[child] = fs.readdirSync(childPath);
-            }
-            catch {
-                result[child] = undefined;
-            }
-        }
-        else {
-            result[child] = undefined;
-        }
-    }
-    return result;
-}

package/dist/server/utils/process-logger.d.ts

@@ -8,11 +8,6 @@
  *
  * Each session creates a new log file with timestamp.
  */
-/**
- * Initialize session log - creates a new log file for this session.
- * Should be called once when the main process starts.
- */
-export declare function initSessionLog(): void;
 /**
  * Write a log entry to the log file.
  * Uses synchronous append for reliability in process shutdown scenarios.
@@ -26,18 +21,10 @@ export declare function transportLog(message: string): void;
  * Log with [Agent] prefix.
  */
 export declare function agentLog(message: string): void;
-/**
- * Log with [ProcessManager] prefix.
- */
-export declare function processManagerLog(message: string): void;
 /**
  * Log a transport event (for TUI monitoring).
  */
 export declare function eventLog(eventName: string, data?: unknown): void;
-/**
- * Log an error with full details.
- */
-export declare function errorLog(error: Error | string, context?: string): void;
 /**
  * Log a crash with full environment details.
  * Everything goes to the session log file.

package/dist/server/utils/process-logger.js

@@ -8,7 +8,7 @@
  *
  * Each session creates a new log file with timestamp.
  */
-import { appendFileSync, existsSync, mkdirSync, readdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { appendFileSync, existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { getGlobalLogsDir } from './global-logs-path.js';
 /** Current session's log file path (set on init) */
@@ -35,34 +35,6 @@ function ensureLogDir() {
         // Logging will fail gracefully later when trying to write
     }
 }
-/** Max age for log files in milliseconds (30 days) */
-const LOG_MAX_AGE_MS = 30 * 24 * 60 * 60 * 1000;
-/**
- * Clean up log files older than 30 days.
- * Runs silently - errors are ignored to not affect the main process.
- */
-function cleanupOldLogs() {
-    try {
-        const logsDir = getLogsDir();
-        if (!existsSync(logsDir))
-            return;
-        const now = Date.now();
-        const files = readdirSync(logsDir);
-        for (const file of files) {
-            if (!file.endsWith('.log'))
-                continue;
-            const filePath = join(logsDir, file);
-            const stats = statSync(filePath);
-            const age = now - stats.mtimeMs;
-            if (age > LOG_MAX_AGE_MS) {
-                unlinkSync(filePath);
-            }
-        }
-    }
-    catch {
-        // Silently ignore - don't crash the process
-    }
-}
 /**
  * Format timestamp for log entries.
  */
@@ -104,32 +76,6 @@ function getLogPath() {
     }
     return sessionLogPath;
 }
-/**
- * Initialize session log - creates a new log file for this session.
- * Should be called once when the main process starts.
- */
-export function initSessionLog() {
-    if (sessionLogPath)
-        return;
-    try {
-        ensureLogDir();
-        cleanupOldLogs();
-        sessionLogPath = join(getLogsDir(), generateSessionLogFilename());
-        const timestamp = formatTimestamp();
-        const header = [
-            '='.repeat(70),
-            `BRV Session Log - Started: ${timestamp}`,
-            `CWD: ${process.cwd()}`,
-            `Node: ${process.version} | Platform: ${process.platform} | PID: ${process.pid}`,
-            '='.repeat(70),
-            '',
-        ].join('\n');
-        writeFileSync(sessionLogPath, header);
-    }
-    catch {
-        // Silently ignore - don't crash the process
-    }
-}
 /**
  * Write a log entry to the log file.
  * Uses synchronous append for reliability in process shutdown scenarios.
@@ -157,12 +103,6 @@ export function transportLog(message) {
 export function agentLog(message) {
     processLog(`[Agent] ${message}`);
 }
-/**
- * Log with [ProcessManager] prefix.
- */
-export function processManagerLog(message) {
-    processLog(`[ProcessManager] ${message}`);
-}
 /**
  * Log a transport event (for TUI monitoring).
  */
@@ -170,23 +110,6 @@ export function eventLog(eventName, data) {
     const dataStr = data ? ` ${JSON.stringify(data)}` : '';
     processLog(`[Event] ${eventName}${dataStr}`);
 }
-/**
- * Log an error with full details.
- */
-export function errorLog(error, context) {
-    const errorMessage = error instanceof Error ? error.message : error;
-    const errorStack = error instanceof Error ? error.stack : undefined;
-    const contextStr = context ? ` (${context})` : '';
-    processLog(`[ERROR]${contextStr} ${errorMessage}`);
-    if (errorStack) {
-        const indentedStack = errorStack
-            .split('\n')
-            .slice(1)
-            .map((line) => `         ${line}`)
-            .join('\n');
-        processLog(indentedStack);
-    }
-}
 /**
  * Log a crash with full environment details.
  * Everything goes to the session log file.

package/node_modules/@campfirein/brv-transport-client/LICENSE

@@ -0,0 +1,95 @@
+Copyright (c) 2026 ByteRover
+
+Elastic License 2.0
+
+URL: https://www.elastic.co/licensing/elastic-license
+
+## Acceptance
+
+By using the software, you agree to all of the terms and conditions below.
+
+## Copyright License
+
+The licensor grants you a non-exclusive, royalty-free, worldwide,
+non-sublicensable, non-transferable license to use, copy, distribute, make
+available, and prepare derivative works of the software, in each case subject to
+the limitations and conditions below.
+
+## Limitations
+
+You may not provide the software to third parties as a hosted or managed
+service, where the service provides users with access to any substantial set of
+the features or functionality of the software.
+
+You may not move, change, disable, or circumvent the license key functionality
+in the software, and you may not remove or obscure any functionality in the
+software that is protected by the license key.
+
+You may not alter, remove, or obscure any licensing, copyright, or other notices
+of the licensor in the software. Any use of the licensor's trademarks is subject
+to applicable law.
+
+## Patents
+
+The licensor grants you a license, under any patent claims the licensor can
+license, or becomes able to license, to make, have made, use, sell, offer for
+sale, import and have imported the software, in each case subject to the
+limitations and conditions in this license. This license does not cover any
+patent claims that you cause to be infringed by modifications or additions to
+the software. If you or your company make any written claim that the software
+infringes or contributes to infringement of any patent, your patent license for
+the software granted under these terms ends immediately. If your company makes
+such a claim, your patent license ends immediately for work on behalf of your
+company.
+
+## Notices
+
+You must ensure that anyone who gets a copy of any part of the software from you
+also gets a copy of these terms.
+
+If you modify the software, you must include in any modified copies of the
+software prominent notices stating that you have modified the software.
+
+## No Other Rights
+
+These terms do not imply any licenses other than those expressly granted in
+these terms.
+
+## Termination
+
+If you use the software in violation of these terms, such use is not licensed,
+and your licenses will automatically terminate. If the licensor provides you
+with a notice of your violation, and you cease all violation of this license no
+later than 30 days after you receive that notice, your licenses will be
+reinstated retroactively. However, if you violate these terms after such
+reinstatement, any additional violation of these terms will cause your licenses
+to terminate automatically and permanently.
+
+## No Liability
+
+*As far as the law allows, the software comes as is, without any warranty or
+condition, and the licensor will not be liable to you for any damages arising
+out of these terms or the use or nature of the software, under any kind of
+legal claim.*
+
+## Definitions
+
+The **licensor** is the entity offering these terms, and the **software** is the
+software the licensor makes available under these terms, including any portion
+of it.
+
+**you** refers to the individual or entity agreeing to these terms.
+
+**your company** is any legal entity, sole proprietorship, or other kind of
+organization that you work for, plus all organizations that have control over,
+are under the control of, or are under common control with that
+organization. **control** means ownership of substantially all the assets of an
+entity, or the power to direct its management and policies by vote, contract, or
+otherwise. Control can be direct or indirect.
+
+**your licenses** are all the licenses granted to you for the software under
+these terms.
+
+**use** means anything you do with the software requiring one of your licenses.
+
+**trademark** means trademarks, service marks, and similar rights.

package/node_modules/@campfirein/brv-transport-client/README.md

@@ -5,11 +5,9 @@ Real-time transport client for ByteRover. Connects CLI/TUI/REPL clients to the B
 ## Installation
 
 ```bash
-npm install @campfirein/brv-transport-client
+npm install github:campfirein/brv-transport-client#<tag>
 ```
 
-Requires `.npmrc` configured for GitHub Packages.
-
 ## Quick Start
 
 ```typescript
@@ -147,4 +145,5 @@ import {
 
 ## License
 
-UNLICENSED - Private package for ByteRover ecosystem
+This project is licensed under the Elastic License 2.0.
+See [LICENSE](./LICENSE)

package/node_modules/@campfirein/brv-transport-client/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@campfirein/brv-transport-client",
-  "version": "1.0.1",
+  "version": "1.0.0",
   "description": "Transport client for ByteRover CLI - server discovery, connection, and real-time communication",
   "type": "module",
   "main": "dist/index.js",
@@ -49,5 +49,5 @@
     "type": "git",
     "url": "https://github.com/campfirein/brv-transport-client.git"
   },
-  "license": "UNLICENSED"
+  "license": "Elastic-2.0"
 }

package/oclif.manifest.json

@@ -1636,5 +1636,5 @@
       ]
     }
   },
-  "version": "2.5.1"
+  "version": "2.6.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "2.5.1",
+  "version": "2.6.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -22,7 +22,7 @@
     "@ai-sdk/vercel": "^1.0.33",
     "@ai-sdk/xai": "^2.0.57",
     "@anthropic-ai/sdk": "^0.70.1",
-    "@campfirein/brv-transport-client": "github:campfirein/brv-transport-client#release/0.8.4",
+    "@campfirein/brv-transport-client": "github:campfirein/brv-transport-client#1.0.0",
     "@google/genai": "^1.29.0",
     "@inkjs/ui": "^2.0.0",
     "@inquirer/prompts": "^7.9.0",
@@ -34,8 +34,9 @@
     "@socket.io/admin-ui": "^0.5.1",
     "@tanstack/react-query": "^5.90.20",
     "ai": "^5.0.129",
-    "axios": "^1.12.2",
+    "axios": "1.14.0",
     "chalk": "^5.6.2",
+    "dotenv": "^17.3.1",
     "esbuild": "^0.27.2",
     "express": "^5.1.0",
     "fullscreen-ink": "^0.1.0",
@@ -110,12 +111,13 @@
     "node": ">=20.0.0"
   },
   "files": [
+    "./.env.production",
     "./bin",
     "./dist",
     "./oclif.manifest.json"
   ],
   "homepage": "https://www.byterover.dev/",
-  "license": "UNLICENSED",
+  "license": "Elastic-2.0",
   "main": "dist/index.js",
   "type": "module",
   "oclif": {

package/dist/server/core/domain/entities/bullet.d.ts

@@ -1,51 +0,0 @@
-/**
- * Represents metadata associated with a bullet point
- */
-export interface BulletMetadata {
-    relatedFiles: string[];
-    tags: string[];
-    timestamp: string;
-}
-export interface BulletJson {
-    content?: string;
-    id: string;
-    memoryId?: string;
-    metadata: {
-        relatedFiles: string[];
-        tags: string[];
-        timestamp: string;
-    };
-    section: string;
-}
-/**
- * Represents a single knowledge entry in the playbook.
- * Bullets contain reusable insights, strategies, or lessons learned.
- */
-export declare class Bullet {
-    readonly content: string;
-    readonly id: string;
-    readonly memoryId?: string;
-    readonly metadata: BulletMetadata;
-    readonly section: string;
-    constructor(id: string, section: string, content: string, metadata: BulletMetadata, memoryId?: string);
-    /**
-     * Creates a Bullet instance from a JSON object.
-     * The content parameter must be provided separately when content is stored in files.
-     * @param json The JSON object containing bullet metadata
-     * @param content Optional content string (required if json.content is undefined)
-     */
-    static fromJson(json: BulletJson, content?: string): Bullet;
-    /**
-     * Formats the bullet for display in a playbook
-     */
-    toDisplayString(): string;
-    /**
-     * Converts the bullet to a JSON object
-     * @param includeContent If false, content field is omitted (for file-based storage)
-     */
-    toJson(includeContent?: boolean): BulletJson;
-    /**
-     * Creates a new bullet with updated content
-     */
-    withUpdatedContent(content: string): Bullet;
-}

package/dist/server/core/domain/entities/bullet.js

@@ -1,94 +0,0 @@
-/**
- * Represents a single knowledge entry in the playbook.
- * Bullets contain reusable insights, strategies, or lessons learned.
- */
-export class Bullet {
-    content;
-    id;
-    memoryId;
-    metadata;
-    section;
-    // eslint-disable-next-line max-params
-    constructor(id, section, content, metadata, memoryId) {
-        if (id.trim().length === 0) {
-            throw new Error('Bullet ID cannot be empty');
-        }
-        if (section.trim().length === 0) {
-            throw new Error('Bullet section cannot be empty');
-        }
-        if (content.trim().length === 0) {
-            throw new Error('Bullet content cannot be empty');
-        }
-        if (!metadata.timestamp || metadata.timestamp.trim().length === 0) {
-            throw new Error('Bullet metadata timestamp cannot be empty');
-        }
-        if (!metadata.relatedFiles || !Array.isArray(metadata.relatedFiles)) {
-            throw new Error('Bullet metadata relatedFiles must be an array');
-        }
-        if (!metadata.tags || metadata.tags.length === 0) {
-            throw new Error('Bullet metadata tags cannot be empty');
-        }
-        this.id = id;
-        this.section = section;
-        this.content = content;
-        this.metadata = metadata;
-        this.memoryId = memoryId;
-    }
-    /**
-     * Creates a Bullet instance from a JSON object.
-     * The content parameter must be provided separately when content is stored in files.
-     * @param json The JSON object containing bullet metadata
-     * @param content Optional content string (required if json.content is undefined)
-     */
-    static fromJson(json, content) {
-        const bulletContent = json.content ?? content;
-        if (!bulletContent) {
-            throw new Error(`Bullet content is required for bullet ${json.id}`);
-        }
-        return new Bullet(json.id, json.section, bulletContent, {
-            relatedFiles: json.metadata.relatedFiles,
-            tags: json.metadata.tags,
-            timestamp: json.metadata.timestamp,
-        }, json.memoryId);
-    }
-    /**
-     * Formats the bullet for display in a playbook
-     */
-    toDisplayString() {
-        const tags = this.metadata.tags.join(', ');
-        const tagDisplay = `[Tags: ${tags}]`;
-        const filesDisplay = this.metadata.relatedFiles.length > 0 ? `[Files: ${this.metadata.relatedFiles.join(', ')}]` : '[Files: none]';
-        const timestampDisplay = `[Updated: ${this.metadata.timestamp}]`;
-        const metadataDisplay = [tagDisplay, filesDisplay, timestampDisplay].join(' ');
-        return `- [${this.id}] ${this.content}\n  ${this.section}\n  ${metadataDisplay}`;
-    }
-    /**
-     * Converts the bullet to a JSON object
-     * @param includeContent If false, content field is omitted (for file-based storage)
-     */
-    toJson(includeContent = true) {
-        const json = {
-            id: this.id,
-            memoryId: this.memoryId,
-            metadata: {
-                relatedFiles: this.metadata.relatedFiles,
-                tags: this.metadata.tags,
-                timestamp: this.metadata.timestamp,
-            },
-            section: this.section,
-        };
-        if (includeContent) {
-            json.content = this.content;
-        }
-        return json;
-    }
-    /**
-     * Creates a new bullet with updated content
-     */
-    withUpdatedContent(content) {
-        return new Bullet(this.id, this.section, content, {
-            ...this.metadata,
-            timestamp: new Date().toISOString(),
-        }, this.memoryId);
-    }
-}

package/dist/server/core/domain/entities/memory.d.ts

@@ -1,55 +0,0 @@
-/**
- * Parameters for creating a Memory instance.
- *
- * Note: score, parentIds, and childrenIds are optional.
- * These fields are present in primary memories (from the `memories` array)
- * but absent in related memories (from the `related_memories` array).
- */
-export type MemoryParams = {
-    bulletId: string;
-    childrenIds?: string[];
-    content: string;
-    id: string;
-    metadataType: string;
-    nodeKeys: string[];
-    parentIds?: string[];
-    score?: number;
-    section: string;
-    tags: string[];
-    timestamp: string;
-    title: string;
-};
-/**
- * Represents a memory retrieved from the ByteRover Memora service.
- * Memories are hierarchical knowledge fragments that can have parent and child relationships.
- *
- * Note: score, parentIds, and childrenIds are optional fields.
- * - Primary memories (from API `memories` array) have these fields
- * - Related memories (from API `related_memories` array) don't have these fields
- */
-export declare class Memory {
-    readonly bulletId: string;
-    readonly childrenIds?: readonly string[];
-    readonly content: string;
-    readonly id: string;
-    readonly metadataType: string;
-    readonly nodeKeys: readonly string[];
-    readonly parentIds?: readonly string[];
-    readonly score?: number;
-    readonly section: string;
-    readonly tags: readonly string[];
-    readonly timestamp: string;
-    readonly title: string;
-    constructor(params: MemoryParams);
-    /**
-     * Creates a Memory instance from a JSON object.
-     * @param json JSON object representing the Memory
-     * @returns An instance of Memory
-     */
-    static fromJson(json: MemoryParams): Memory;
-    /**
-     * Converts the Memory instance to a JSON object.
-     * @returns A JSON object representing the Memory
-     */
-    toJson(): MemoryParams;
-}