byterover-cli 0.2.1 → 0.3.0

package/dist/infra/ace/ace-prompt-templates.js

@@ -1,177 +0,0 @@
-/**
- * Default implementation of ACE prompts using template strings.
- * These prompts are designed to work with coding agents (Claude Code, Cursor, etc.)
- * and LLMs that understand structured JSON output.
- */
-export class AcePromptTemplates {
-    buildCuratorPrompt(reflection, playbook, questionContext) {
-        const playbookText = playbook.asPrompt();
-        const stats = playbook.stats();
-        return `You are the curator of the ACE playbook.
-Your role is to transform reflections into structured playbook updates.
-
-## Your Principles
-- Only add genuinely NEW insights not already captured in the playbook
-- Update existing bullets if the reflection provides better clarity
-- Remove bullets that have been proven incorrect or harmful
-- Keep bullets concise, specific, and actionable
-- Organize bullets into clear sections (e.g., "Common Errors", "Best Practices", "Strategies")
-
-## Recent Reflection
-
-**Task Context**: ${questionContext}
-
-**Error Identified**: ${reflection.errorIdentification}
-
-**Root Cause**: ${reflection.rootCauseAnalysis}
-
-**Correct Approach**: ${reflection.correctApproach}
-
-**Key Insight**: ${reflection.keyInsight}
-
-**Bullet Tags**:
-${reflection.bulletTags.map((bt) => `- ${bt.id}: ${bt.tag}`).join('\n')}
-
-## Current Playbook (${stats.bullets} bullets, ${stats.sections} sections)
-${playbookText}
-
-## Instructions
-
-Review the reflection and determine what changes to make to the playbook.
-
-**Operation Types**:
-- **ADD**: Create a new bullet with fresh insights
-- **UPDATE**: Modify an existing bullet with better information
-- **REMOVE**: Delete a bullet that's been proven incorrect
-
-For each operation, provide:
-- **type**: The operation type (ADD, UPDATE, or REMOVE)
-- **section**: Which section (e.g., "Common Errors", "Best Practices")
-- **content**: The bullet text (for ADD/UPDATE)
-- **bulletId**: The existing bullet ID (for UPDATE/REMOVE)
-- **metadata**: Structured metadata with:
-  - codebasePath: Relevant file path or context
-  - tags: Array of relevant tags (e.g., ["typescript", "error-handling"])
-  - timestamp: Will be auto-generated
-
-Output as a JSON object:
-{
-  "reasoning": "Explain your curation decisions",
-  "operations": [
-    {
-      "type": "ADD",
-      "section": "Common Errors",
-      "content": "Specific, actionable lesson learned",
-      "metadata": {
-        "codebasePath": "/relevant/path",
-        "tags": ["tag1", "tag2"],
-        "timestamp": "${new Date().toISOString()}"
-      }
-    },
-    {
-      "type": "UPDATE",
-      "section": "Best Practices",
-      "bulletId": "practices-00001",
-      "content": "Updated guidance based on reflection",
-      "metadata": {
-        "codebasePath": "/relevant/path",
-        "tags": ["tag1", "tag2"],
-        "timestamp": "${new Date().toISOString()}"
-      }
-    },
-    {
-      "type": "REMOVE",
-      "section": "Strategies",
-      "bulletId": "strategies-00003"
-    }
-  ]
-}
-
-If no changes are needed, return an empty operations array.`;
-    }
-    buildExecutorPrompt(task, context, playbook, recentReflections) {
-        const playbookText = playbook.asPrompt();
-        const reflectionsText = recentReflections.length > 0 ? recentReflections.join('\n\n---\n\n') : 'No recent reflections.';
-        const stats = playbook.stats();
-        const statsText = `Playbook contains ${stats.bullets} bullets across ${stats.sections} sections.`;
-        return `You are a software developer solving tasks using a knowledge playbook.
-The playbook contains strategies, lessons learned, and common errors to avoid.
-
-## Your Task
-${task}
-
-## Additional Context
-${context || 'None provided'}
-
-## Playbook (${statsText})
-${playbookText}
-
-## Recent Reflections
-${reflectionsText}
-
-## Instructions
-1. Review the playbook for relevant strategies and common errors
-2. Consider recent reflections to avoid repeating mistakes
-3. Reference specific bullets by their IDs when applying strategies
-4. Show your step-by-step reasoning
-5. Use tools as needed to complete the task
-6. Track which bullets you reference and which tools you use
-
-Your response will be captured for later analysis, so be thorough in your reasoning.`;
-    }
-    buildReflectorPrompt(params) {
-        const { executorOutput, feedback, groundTruth, playbook, task } = params;
-        const playbookText = playbook.asPrompt();
-        const groundTruthText = groundTruth ?? 'Not available';
-        return `You are a senior code reviewer analyzing an execution trajectory.
-Your goal is to identify what went wrong, why it happened, and what lessons can be learned.
-
-## Original Task
-${task}
-
-## Executor's Reasoning
-${executorOutput.reasoning}
-
-## Executor's Final Answer
-${executorOutput.finalAnswer}
-
-## Bullets Referenced
-${executorOutput.bulletIds.length > 0 ? executorOutput.bulletIds.join(', ') : 'None'}
-
-## Tools Used
-${executorOutput.toolUsage.length > 0 ? executorOutput.toolUsage.join(', ') : 'None'}
-
-## Environment Feedback
-${feedback}
-
-## Ground Truth (Expected Answer)
-${groundTruthText}
-
-## Current Playbook
-${playbookText}
-
-## Instructions
-Analyze the executor's performance and provide:
-
-1. **Error Identification**: What specifically went wrong? Be precise.
-2. **Root Cause Analysis**: Why did this error occur? What was the underlying cause?
-3. **Correct Approach**: What should have been done instead? Be specific and actionable.
-4. **Key Insight**: What reusable lesson can be extracted for the playbook?
-5. **Bullet Tags**: For each bullet the executor referenced, tag it with a relevant tags
-
-Output your analysis as a JSON object with this structure:
-{
-  "reasoning": "Your detailed analysis of what happened",
-  "errorIdentification": "What went wrong",
-  "rootCauseAnalysis": "Why it happened",
-  "correctApproach": "What should have been done",
-  "keyInsight": "Reusable lesson for the playbook",
-  "bulletTags": [
-    {"id": "bullet-00001", "tag": ["tag1", "tag2"]}
-    {"id": "bullet-00002", "tag": ["tag1", "tag2"]}
-  ]
-}
-
-Be thorough and constructive in your analysis.`;
-    }
-}

package/dist/infra/ace/file-bullet-content-store.d.ts

@@ -1,27 +0,0 @@
-import type { IBulletContentStore } from '../../core/interfaces/i-bullet-content-store.js';
-/**
- * File-based implementation of IBulletContentStore.
- * Stores bullet content in .brv/ace/bullets/{bullet-id}.md files.
- */
-export declare class FileBulletContentStore implements IBulletContentStore {
-    delete(bulletId: string, directory?: string): Promise<void>;
-    exists(bulletId: string, directory?: string): Promise<boolean>;
-    load(bulletId: string, directory?: string): Promise<string | undefined>;
-    save(bulletId: string, content: string, directory?: string): Promise<string>;
-    /**
-     * Gets the full path to the .brv/ace directory
-     */
-    private getAceDirPath;
-    /**
-     * Gets the full path to the .brv directory
-     */
-    private getBrDirPath;
-    /**
-     * Gets the full path to the .brv/ace/bullets directory
-     */
-    private getBulletsDirPath;
-    /**
-     * Gets the full path to a bullet content file
-     */
-    private getContentPath;
-}

package/dist/infra/ace/file-bullet-content-store.js

@@ -1,89 +0,0 @@
-import { existsSync } from 'node:fs';
-import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { ACE_DIR, BRV_DIR, BULLETS_DIR } from '../../constants.js';
-/**
- * File-based implementation of IBulletContentStore.
- * Stores bullet content in .brv/ace/bullets/{bullet-id}.md files.
- */
-export class FileBulletContentStore {
-    async delete(bulletId, directory) {
-        const contentPath = this.getContentPath(bulletId, directory);
-        if (!existsSync(contentPath)) {
-            return;
-        }
-        try {
-            await unlink(contentPath);
-        }
-        catch (error) {
-            throw new Error(`Failed to delete bullet content at ${contentPath}: ${error.message}`);
-        }
-    }
-    async exists(bulletId, directory) {
-        const contentPath = this.getContentPath(bulletId, directory);
-        return existsSync(contentPath);
-    }
-    async load(bulletId, directory) {
-        const contentPath = this.getContentPath(bulletId, directory);
-        if (!existsSync(contentPath)) {
-            return undefined;
-        }
-        try {
-            const rawContent = await readFile(contentPath, 'utf8');
-            // Strip the warning header if present
-            const headerPattern = /^<!--\s*\nWARNING:.*?-->\n\n/s;
-            const content = rawContent.replace(headerPattern, '');
-            return content;
-        }
-        catch (error) {
-            throw new Error(`Failed to load bullet content from ${contentPath}: ${error.message}`);
-        }
-    }
-    async save(bulletId, content, directory) {
-        const bulletsDirPath = this.getBulletsDirPath(directory);
-        const contentPath = this.getContentPath(bulletId, directory);
-        try {
-            // Create .brv/ace/bullets directory if it doesn't exist
-            await mkdir(bulletsDirPath, { recursive: true });
-            // Add warning header to content
-            const header = `<!--
-WARNING: Do not rename this file manually!
-File name: ${bulletId}.md
-This file is managed by ByteRover CLI. Only edit the content below.
-Renaming this file will break the link to the playbook metadata.
--->\n\n`;
-            const contentWithHeader = header + content;
-            // Write content file with header
-            await writeFile(contentPath, contentWithHeader, 'utf8');
-            return contentPath;
-        }
-        catch (error) {
-            throw new Error(`Failed to save bullet content to ${contentPath}: ${error.message}`);
-        }
-    }
-    /**
-     * Gets the full path to the .brv/ace directory
-     */
-    getAceDirPath(directory) {
-        return join(this.getBrDirPath(directory), ACE_DIR);
-    }
-    /**
-     * Gets the full path to the .brv directory
-     */
-    getBrDirPath(directory) {
-        const baseDir = directory ?? process.cwd();
-        return join(baseDir, BRV_DIR);
-    }
-    /**
-     * Gets the full path to the .brv/ace/bullets directory
-     */
-    getBulletsDirPath(directory) {
-        return join(this.getAceDirPath(directory), BULLETS_DIR);
-    }
-    /**
-     * Gets the full path to a bullet content file
-     */
-    getContentPath(bulletId, directory) {
-        return join(this.getBulletsDirPath(directory), `${bulletId}.md`);
-    }
-}

package/dist/infra/ace/file-delta-store.d.ts

@@ -1,9 +0,0 @@
-import type { DeltaBatch } from '../../core/domain/entities/delta-batch.js';
-import type { IDeltaStore } from '../../core/interfaces/i-delta-store.js';
-/**
- * File-based implementation of IDeltaStore.
- * Stores delta batches as JSON files in .brv/ace/deltas/ directory.
- */
-export declare class FileDeltaStore implements IDeltaStore {
-    save(deltaBatch: DeltaBatch, hint?: string, directory?: string): Promise<string>;
-}

package/dist/infra/ace/file-delta-store.js

@@ -1,26 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { DELTAS_DIR } from '../../constants.js';
-import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
-/**
- * File-based implementation of IDeltaStore.
- * Stores delta batches as JSON files in .brv/ace/deltas/ directory.
- */
-export class FileDeltaStore {
-    async save(deltaBatch, hint, directory) {
-        try {
-            // Ensure deltas directory exists
-            const deltasDir = await ensureAceDirectory(directory, DELTAS_DIR);
-            // Generate filename with optional hint and timestamp
-            const filename = generateTimestampedFilename('delta', hint);
-            const filePath = join(deltasDir, filename);
-            // Serialize and save delta batch
-            const content = JSON.stringify(deltaBatch.toJson(), null, 2);
-            await writeFile(filePath, content, 'utf8');
-            return filePath;
-        }
-        catch (error) {
-            throw new Error(`Failed to save delta batch: ${error.message}`);
-        }
-    }
-}

package/dist/infra/ace/file-executor-output-store.d.ts

@@ -1,9 +0,0 @@
-import type { ExecutorOutput } from '../../core/domain/entities/executor-output.js';
-import type { IExecutorOutputStore } from '../../core/interfaces/i-executor-output-store.js';
-/**
- * File-based implementation of IExecutorOutputStore.
- * Stores executor outputs as JSON files in .brv/ace/executor-outputs/ directory.
- */
-export declare class FileExecutorOutputStore implements IExecutorOutputStore {
-    save(output: ExecutorOutput, directory?: string): Promise<string>;
-}

package/dist/infra/ace/file-executor-output-store.js

@@ -1,26 +0,0 @@
-import { writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { EXECUTOR_OUTPUTS_DIR } from '../../constants.js';
-import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
-/**
- * File-based implementation of IExecutorOutputStore.
- * Stores executor outputs as JSON files in .brv/ace/executor-outputs/ directory.
- */
-export class FileExecutorOutputStore {
-    async save(output, directory) {
-        try {
-            // Ensure executor-outputs directory exists
-            const outputDir = await ensureAceDirectory(directory, EXECUTOR_OUTPUTS_DIR);
-            // Generate filename with hint from executor output and timestamp
-            const filename = generateTimestampedFilename('executor', output.hint || undefined);
-            const filePath = join(outputDir, filename);
-            // Serialize and save executor output
-            const content = JSON.stringify(output.toJson(), null, 2);
-            await writeFile(filePath, content, 'utf8');
-            return filePath;
-        }
-        catch (error) {
-            throw new Error(`Failed to save executor output: ${error.message}`);
-        }
-    }
-}

package/dist/infra/ace/file-playbook-store.d.ts

@@ -1,29 +0,0 @@
-import type { IBulletContentStore } from '../../core/interfaces/i-bullet-content-store.js';
-import type { IPlaybookStore } from '../../core/interfaces/i-playbook-store.js';
-import { Playbook } from '../../core/domain/entities/playbook.js';
-/**
- * File-based implementation of IPlaybookStore.
- * Stores playbook metadata in .brv/ace/playbook.json and bullet content in .brv/ace/bullets/{id}.md files.
- */
-export declare class FilePlaybookStore implements IPlaybookStore {
-    private static readonly PLAYBOOK_FILE;
-    private readonly contentStore;
-    constructor(contentStore?: IBulletContentStore);
-    clear(directory?: string): Promise<void>;
-    delete(directory?: string): Promise<void>;
-    exists(directory?: string): Promise<boolean>;
-    load(directory?: string): Promise<Playbook | undefined>;
-    save(playbook: Playbook, directory?: string): Promise<void>;
-    /**
-     * Gets the full path to the .brv/ace directory
-     */
-    private getAceDirPath;
-    /**
-     * Gets the full path to the .brv directory
-     */
-    private getBrDirPath;
-    /**
-     * Gets the full path to the playbook.json file
-     */
-    private getPlaybookPath;
-}

package/dist/infra/ace/file-playbook-store.js

@@ -1,107 +0,0 @@
-import { existsSync } from 'node:fs';
-import { mkdir, readFile, unlink, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { ACE_DIR, BRV_DIR } from '../../constants.js';
-import { Playbook } from '../../core/domain/entities/playbook.js';
-import { PlaybookNotFoundError } from '../../core/domain/errors/ace-error.js';
-import { FileBulletContentStore } from './file-bullet-content-store.js';
-/**
- * File-based implementation of IPlaybookStore.
- * Stores playbook metadata in .brv/ace/playbook.json and bullet content in .brv/ace/bullets/{id}.md files.
- */
-export class FilePlaybookStore {
-    static PLAYBOOK_FILE = 'playbook.json';
-    contentStore;
-    constructor(contentStore) {
-        this.contentStore = contentStore ?? new FileBulletContentStore();
-    }
-    async clear(directory) {
-        const exists = await this.exists(directory);
-        if (!exists) {
-            return;
-        }
-        // Load existing playbook to get bullet IDs
-        const playbook = await this.load(directory);
-        if (playbook) {
-            // Delete all bullet content files
-            const bullets = playbook.getBullets();
-            await Promise.all(bullets.map((bullet) => this.contentStore.delete(bullet.id, directory)));
-        }
-        // Save empty playbook
-        const emptyPlaybook = new Playbook();
-        await this.save(emptyPlaybook, directory);
-    }
-    async delete(directory) {
-        const playbookPath = this.getPlaybookPath(directory);
-        if (!existsSync(playbookPath)) {
-            return;
-        }
-        try {
-            // Load playbook to get bullet IDs
-            const playbook = await this.load(directory);
-            if (playbook) {
-                // Delete all bullet content files
-                const bullets = playbook.getBullets();
-                await Promise.all(bullets.map((bullet) => this.contentStore.delete(bullet.id, directory)));
-            }
-            // Delete playbook.json
-            await unlink(playbookPath);
-        }
-        catch (error) {
-            throw new Error(`Failed to delete playbook at ${playbookPath}: ${error.message}`);
-        }
-    }
-    async exists(directory) {
-        const playbookPath = this.getPlaybookPath(directory);
-        return existsSync(playbookPath);
-    }
-    async load(directory) {
-        const playbookPath = this.getPlaybookPath(directory);
-        if (!existsSync(playbookPath)) {
-            return undefined;
-        }
-        try {
-            const content = await readFile(playbookPath, 'utf8');
-            return await Playbook.loads(content, this.contentStore, directory);
-        }
-        catch (error) {
-            throw new PlaybookNotFoundError(`Failed to load playbook from ${playbookPath}: ${error.message}`);
-        }
-    }
-    async save(playbook, directory) {
-        const aceDirPath = this.getAceDirPath(directory);
-        const playbookPath = this.getPlaybookPath(directory);
-        try {
-            // Create .brv/ace directory if it doesn't exist
-            await mkdir(aceDirPath, { recursive: true });
-            // Save all bullet content to separate files
-            const bullets = playbook.getBullets();
-            await Promise.all(bullets.map((bullet) => this.contentStore.save(bullet.id, bullet.content, directory)));
-            // Write playbook.json (without content)
-            const content = playbook.dumps(false);
-            await writeFile(playbookPath, content, 'utf8');
-        }
-        catch (error) {
-            throw new Error(`Failed to save playbook to ${playbookPath}: ${error.message}`);
-        }
-    }
-    /**
-     * Gets the full path to the .brv/ace directory
-     */
-    getAceDirPath(directory) {
-        return join(this.getBrDirPath(directory), ACE_DIR);
-    }
-    /**
-     * Gets the full path to the .brv directory
-     */
-    getBrDirPath(directory) {
-        const baseDir = directory ?? process.cwd();
-        return join(baseDir, BRV_DIR);
-    }
-    /**
-     * Gets the full path to the playbook.json file
-     */
-    getPlaybookPath(directory) {
-        return join(this.getAceDirPath(directory), FilePlaybookStore.PLAYBOOK_FILE);
-    }
-}

package/dist/infra/ace/file-reflection-store.d.ts

@@ -1,10 +0,0 @@
-import type { IReflectionStore } from '../../core/interfaces/i-reflection-store.js';
-import { ReflectorOutput } from '../../core/domain/entities/reflector-output.js';
-/**
- * File-based implementation of IReflectionStore.
- * Stores reflections as JSON files in .brv/ace/reflections/ directory.
- */
-export declare class FileReflectionStore implements IReflectionStore {
-    loadRecent(directory?: string, count?: number): Promise<ReflectorOutput[]>;
-    save(reflection: ReflectorOutput, directory?: string): Promise<string>;
-}

package/dist/infra/ace/file-reflection-store.js

@@ -1,55 +0,0 @@
-import { readdir, readFile, writeFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { REFLECTIONS_DIR } from '../../constants.js';
-import { ReflectorOutput } from '../../core/domain/entities/reflector-output.js';
-import { ensureAceDirectory, generateTimestampedFilename } from './ace-file-utils.js';
-/**
- * File-based implementation of IReflectionStore.
- * Stores reflections as JSON files in .brv/ace/reflections/ directory.
- */
-export class FileReflectionStore {
-    async loadRecent(directory, count = 3) {
-        try {
-            // Get reflections directory path
-            const reflectionsDir = await ensureAceDirectory(directory, REFLECTIONS_DIR);
-            // Read all reflection files
-            const files = await readdir(reflectionsDir);
-            const reflectionFiles = files
-                .filter((f) => f.endsWith('.json'))
-                .sort()
-                .reverse() // Most recent first (assuming timestamped filenames)
-                .slice(0, count);
-            // Load and parse reflections
-            const reflections = await Promise.all(reflectionFiles.map(async (file) => {
-                const filePath = join(reflectionsDir, file);
-                const content = await readFile(filePath, 'utf8');
-                const json = JSON.parse(content);
-                return ReflectorOutput.fromJson(json);
-            }));
-            return reflections;
-        }
-        catch (error) {
-            // If reflections directory doesn't exist or is empty, return empty array
-            if (error.code === 'ENOENT') {
-                return [];
-            }
-            throw new Error(`Failed to load recent reflections: ${error.message}`);
-        }
-    }
-    async save(reflection, directory) {
-        try {
-            // Ensure reflections directory exists
-            const reflectionsDir = await ensureAceDirectory(directory, REFLECTIONS_DIR);
-            // Generate filename with hint from reflection and timestamp
-            const filename = generateTimestampedFilename('reflection', reflection.hint || undefined);
-            const filePath = join(reflectionsDir, filename);
-            // Serialize and save reflection
-            const content = JSON.stringify(reflection.toJson(), null, 2);
-            await writeFile(filePath, content, 'utf8');
-            return filePath;
-        }
-        catch (error) {
-            throw new Error(`Failed to save reflection: ${error.message}`);
-        }
-    }
-}

package/dist/infra/playbook/file-playbook-service.d.ts

@@ -1,42 +0,0 @@
-import type { Bullet, BulletMetadata } from '../../core/domain/entities/bullet.js';
-import type { DeltaBatch } from '../../core/domain/entities/delta-batch.js';
-import type { ReflectorOutput } from '../../core/domain/entities/reflector-output.js';
-import type { IPlaybookService } from '../../core/interfaces/i-playbook-service.js';
-import type { IPlaybookStore } from '../../core/interfaces/i-playbook-store.js';
-import { Playbook } from '../../core/domain/entities/playbook.js';
-export type PlaybookServiceConfig = {
-    baseDirectory?: string;
-};
-/**
- * File-based implementation of IPlaybookService.
- * Provides high-level playbook operations including initialization,
- * bullet management, delta application, and reflection tag processing.
- */
-export declare class FilePlaybookService implements IPlaybookService {
-    private static readonly SUBDIRS;
-    private readonly config;
-    private readonly playbookStore;
-    constructor(config?: PlaybookServiceConfig, playbookStore?: IPlaybookStore);
-    addOrUpdateBullet(params: {
-        bulletId?: string;
-        content: string;
-        directory?: string;
-        metadata?: BulletMetadata;
-        section: string;
-    }): Promise<Bullet>;
-    applyDelta(params: {
-        delta: DeltaBatch;
-        directory?: string;
-    }): Promise<{
-        operationsApplied: number;
-        playbook: Playbook;
-    }>;
-    applyReflectionTags(params: {
-        directory?: string;
-        reflection: ReflectorOutput;
-    }): Promise<{
-        playbook: Playbook;
-        tagsApplied: number;
-    }>;
-    initialize(directory?: string): Promise<string>;
-}