byterover-cli 2.5.2 → 3.0.0

package/package.json

@@ -1,7 +1,12 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "2.5.2",
+  "keywords": [
+    "cli", "ai", "llm", "mcp", "developer-tools",
+    "context-memory", "autonomous-agents", "coding-assistant",
+    "knowledge-management"
+  ],
+  "version": "3.0.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
@@ -22,7 +27,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",
@@ -36,6 +41,7 @@
     "ai": "^5.0.129",
     "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",
@@ -48,6 +54,7 @@
     "ink-spinner": "^5.0.0",
     "ink-text-input": "^6.0.0",
     "inquirer-file-selector": "^1.0.1",
+    "isomorphic-git": "^1.37.2",
     "js-yaml": "^4.1.1",
     "lodash-es": "^4.17.22",
     "minisearch": "^7.2.0",
@@ -110,12 +117,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": {
@@ -126,11 +134,11 @@
       "init": [
         "./dist/oclif/hooks/init/block-command-update-npm",
         "./dist/oclif/hooks/init/welcome",
-        "./dist/oclif/hooks/init/update-notifier"
+        "./dist/oclif/hooks/init/update-notifier",
+        "./dist/oclif/hooks/init/validate-brv-config"
       ],
       "command_not_found": "./dist/oclif/hooks/command_not_found/handle-invalid-commands",
       "error": "./dist/oclif/hooks/error/clean-errors",
-      "prerun": "./dist/oclif/hooks/prerun/validate-brv-config-version",
       "postrun": "./dist/oclif/hooks/postrun/restart-after-update"
     },
     "plugins": [

package/dist/oclif/hooks/prerun/validate-brv-config-version.d.ts

@@ -1,33 +0,0 @@
-import type { Hook } from '@oclif/core';
-import type { IProjectConfigStore } from '../../../server/core/interfaces/storage/i-project-config-store.js';
-import { type AutoInitDeps } from '../../../server/infra/config/auto-init.js';
-/**
- * Commands that should skip auto-init and config version validation.
- */
-export declare const SKIP_COMMANDS: Set<string>;
-/**
- * Dependencies for the curate-view patch marker, injected for testability.
- * The marker file lives in the XDG/global data dir scoped to the current project,
- * keeping internal patch bookkeeping out of the user-facing .brv/config.json.
- */
-export type PatchMarkerDeps = {
-    isPatched(): Promise<boolean>;
-    markPatched(): Promise<void>;
-    patchFn?: (cwd: string) => Promise<void>;
-};
-/**
- * Core validation logic extracted for testability.
- * Auto-initializes .brv/ if it doesn't exist, then migrates config version if needed.
- * Also ensures connector files are patched with `brv curate view` docs (once per project).
- *
- * @param commandId - The command being executed
- * @param configStore - The config store to use for reading config
- * @param autoInitDeps - Dependencies for auto-init (optional, for testing)
- * @param patchMarkerDeps - Dependencies for the curate-view patch marker (optional, for testing)
- */
-export declare const validateBrvConfigVersion: (commandId: string, configStore: IProjectConfigStore, autoInitDeps?: AutoInitDeps, patchMarkerDeps?: PatchMarkerDeps) => Promise<void>;
-/**
- * Prerun hook that auto-initializes .brv/ if missing, then validates config version.
- */
-declare const hook: Hook<'prerun'>;
-export default hook;

package/dist/oclif/hooks/prerun/validate-brv-config-version.js

@@ -1,86 +0,0 @@
-import { access, mkdir, writeFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { BRV_CONFIG_VERSION } from '../../../server/constants.js';
-import { ensureProjectInitialized } from '../../../server/infra/config/auto-init.js';
-import { ProjectConfigStore } from '../../../server/infra/config/file-config-store.js';
-import { ensureCurateViewPatched } from '../../../server/infra/connectors/shared/rule-segment-patcher.js';
-import { FileContextTreeService } from '../../../server/infra/context-tree/file-context-tree-service.js';
-import { FileContextTreeSnapshotService } from '../../../server/infra/context-tree/file-context-tree-snapshot-service.js';
-import { syncConfigToXdg } from '../../../server/utils/config-xdg-sync.js';
-import { getProjectDataDir } from '../../../server/utils/path-utils.js';
-/**
- * Commands that should skip auto-init and config version validation.
- */
-export const SKIP_COMMANDS = new Set(['--help', 'help', 'login', 'logout']);
-const getCurateViewMarkerPath = (cwd) => join(getProjectDataDir(cwd), 'patches', 'curate-view.done');
-const defaultPatchMarkerDeps = (cwd) => ({
-    async isPatched() {
-        try {
-            await access(getCurateViewMarkerPath(cwd));
-            return true;
-        }
-        catch {
-            return false;
-        }
-    },
-    async markPatched() {
-        const markerPath = getCurateViewMarkerPath(cwd);
-        await mkdir(dirname(markerPath), { recursive: true });
-        await writeFile(markerPath, '');
-    },
-});
-/**
- * Core validation logic extracted for testability.
- * Auto-initializes .brv/ if it doesn't exist, then migrates config version if needed.
- * Also ensures connector files are patched with `brv curate view` docs (once per project).
- *
- * @param commandId - The command being executed
- * @param configStore - The config store to use for reading config
- * @param autoInitDeps - Dependencies for auto-init (optional, for testing)
- * @param patchMarkerDeps - Dependencies for the curate-view patch marker (optional, for testing)
- */
-export const validateBrvConfigVersion = async (commandId, configStore, autoInitDeps, patchMarkerDeps) => {
-    // Skip for commands that don't need config
-    if (SKIP_COMMANDS.has(commandId)) {
-        return;
-    }
-    const exists = await configStore.exists();
-    if (!exists) {
-        // Auto-init: create .brv/ with minimal local config
-        const deps = autoInitDeps ?? {
-            contextTreeService: new FileContextTreeService(),
-            contextTreeSnapshotService: new FileContextTreeSnapshotService(),
-            projectConfigStore: configStore,
-        };
-        await ensureProjectInitialized(deps);
-        return;
-    }
-    // Read existing config — fromJson() preserves original version
-    const config = await configStore.read();
-    if (!config)
-        return;
-    // ProjectConfigStore checks .brv/ at process.cwd() directly (no walk-up),
-    // so configStore.exists() returning true means process.cwd() IS the project root.
-    const cwd = process.cwd();
-    // Gate the connector-file patch behind a per-project marker file in the XDG data dir.
-    // This keeps internal bookkeeping out of the user-facing .brv/config.json.
-    const marker = patchMarkerDeps ?? defaultPatchMarkerDeps(cwd);
-    const alreadyPatched = await marker.isPatched();
-    if (!alreadyPatched) {
-        const patchFn = patchMarkerDeps?.patchFn ?? ensureCurateViewPatched;
-        await patchFn(cwd).catch(() => { });
-        await marker.markPatched().catch(() => { });
-    }
-    if (config.version !== BRV_CONFIG_VERSION) {
-        const updated = config.withVersion(BRV_CONFIG_VERSION);
-        await configStore.write(updated);
-        await syncConfigToXdg(updated, cwd);
-    }
-};
-/**
- * Prerun hook that auto-initializes .brv/ if missing, then validates config version.
- */
-const hook = async function (options) {
-    await validateBrvConfigVersion(options.Command.id, new ProjectConfigStore());
-};
-export default hook;

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;
-}

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

@@ -1,90 +0,0 @@
-/**
- * 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 class Memory {
-    bulletId;
-    childrenIds;
-    content;
-    id;
-    metadataType;
-    nodeKeys;
-    parentIds;
-    score;
-    section;
-    tags;
-    timestamp;
-    title;
-    constructor(params) {
-        if (params.id.trim().length === 0) {
-            throw new Error('Memory ID cannot be empty');
-        }
-        if (params.bulletId.trim().length === 0) {
-            throw new Error('Memory bulletId cannot be empty');
-        }
-        if (params.title.trim().length === 0) {
-            throw new Error('Memory title cannot be empty');
-        }
-        if (params.content.trim().length === 0) {
-            throw new Error('Memory content cannot be empty');
-        }
-        if (params.section.trim().length === 0) {
-            throw new Error('Memory section cannot be empty');
-        }
-        if (params.timestamp.trim().length === 0) {
-            throw new Error('Memory timestamp cannot be empty');
-        }
-        if (params.metadataType.trim().length === 0) {
-            throw new Error('Memory metadataType cannot be empty');
-        }
-        // Only validate score if it's provided (primary memories have score, related memories don't)
-        if (params.score !== undefined && (params.score < 0 || params.score > 1)) {
-            throw new Error('Memory score must be between 0.0 and 1.0');
-        }
-        this.id = params.id;
-        this.bulletId = params.bulletId;
-        this.title = params.title;
-        this.content = params.content;
-        this.score = params.score;
-        this.section = params.section;
-        this.metadataType = params.metadataType;
-        this.timestamp = params.timestamp;
-        // Defensive copy to prevent external mutation
-        this.nodeKeys = [...params.nodeKeys];
-        this.parentIds = params.parentIds ? [...params.parentIds] : undefined;
-        this.childrenIds = params.childrenIds ? [...params.childrenIds] : undefined;
-        this.tags = [...params.tags];
-    }
-    /**
-     * Creates a Memory instance from a JSON object.
-     * @param json JSON object representing the Memory
-     * @returns An instance of Memory
-     */
-    static fromJson(json) {
-        return new Memory(json);
-    }
-    /**
-     * Converts the Memory instance to a JSON object.
-     * @returns A JSON object representing the Memory
-     */
-    toJson() {
-        return {
-            bulletId: this.bulletId,
-            ...(this.childrenIds !== undefined && { childrenIds: [...this.childrenIds] }),
-            content: this.content,
-            id: this.id,
-            metadataType: this.metadataType,
-            nodeKeys: [...this.nodeKeys],
-            ...(this.parentIds !== undefined && { parentIds: [...this.parentIds] }),
-            ...(this.score !== undefined && { score: this.score }),
-            section: this.section,
-            tags: [...this.tags],
-            timestamp: this.timestamp,
-            title: this.title,
-        };
-    }
-}

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

@@ -1,80 +0,0 @@
-import { Bullet, type BulletJson, type BulletMetadata } from './bullet.js';
-export interface PlaybookJson {
-    bullets: Record<string, BulletJson>;
-    nextId: number;
-    sections: Record<string, string[]>;
-}
-export interface PlaybookStats {
-    bullets: number;
-    sections: number;
-    tags: string[];
-}
-/**
- * The central knowledge repository that stores and manages bullets.
- * Playbooks are organized into sections.
- * Playbooks are used as temporary notes then will be pushed to byterover for usage.
- */
-export declare class Playbook {
-    private readonly bullets;
-    private nextId;
-    private readonly sections;
-    constructor(bullets?: Map<string, Bullet>, sections?: Map<string, string[]>, nextId?: number);
-    /**
-     * Adds a new bullet to the playbook
-     */
-    addBullet(section: string, content: string, bulletId?: string, metadata?: BulletMetadata): Bullet;
-    /**
-     * Adds a tag to a bullet
-     */
-    addTagToBullet(bulletId: string, tag: string): Bullet | undefined;
-    /**
-     * Converts playbook to markdown format for LLM prompts
-     */
-    asPrompt(): string;
-    /**
-     * Serializes to JSON string (pretty-printed)
-     * @param includeContent If false, content field is omitted from bullets (for file-based storage)
-     */
-    dumps(includeContent?: boolean): string;
-    /**
-     * Retrieves a single bullet by ID
-     */
-    getBullet(bulletId: string): Bullet | undefined;
-    /**
-     * Returns all bullets as an array
-     */
-    getBullets(): Bullet[];
-    /**
-     * Returns bullets in a specific section
-     */
-    getBulletsInSection(section: string): Bullet[];
-    /**
-     * Returns the next bullet ID that will be generated
-     */
-    getNextId(): string;
-    /**
-     * Returns all section names
-     */
-    getSections(): string[];
-    /**
-     * Removes a bullet from the playbook
-     */
-    removeBullet(bulletId: string): void;
-    /**
-     * Removes a tag from a bullet
-     */
-    removeTagFromBullet(bulletId: string, tag: string): Bullet | undefined;
-    /**
-     * Returns playbook statistics
-     */
-    stats(): PlaybookStats;
-    toJson(includeContent?: boolean): PlaybookJson;
-    /**
-     * Updates an existing bullet's content and/or metadata
-     */
-    updateBullet(bulletId: string, options: {
-        content?: string;
-        metadata?: BulletMetadata;
-    }): Bullet | undefined;
-    private _generateId;
-}