byterover-cli 0.2.1 → 0.3.0

package/package.json

@@ -1,36 +1,54 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"
   },
   "bugs": "https://github.com/campfirein/byterover-cli/issues",
   "dependencies": {
+    "@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",
     "@inquirer/prompts": "^7.9.0",
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "axios": "^1.12.2",
+    "better-sqlite3": "^11.5.0",
     "chalk": "^5.6.2",
+    "chokidar": "^4.0.3",
     "express": "^5.1.0",
+    "glob": "^11.0.3",
+    "ignore": "^7.0.5",
+    "inquirer-file-selector": "^1.0.1",
+    "js-yaml": "^4.1.1",
     "keytar": "^7.9.0",
     "mixpanel": "^0.18.1",
-    "open": "^10.2.0"
+    "nanoid": "^5.1.6",
+    "open": "^10.2.0",
+    "openai": "^6.9.1",
+    "zod": "^3.25.76",
+    "zod-to-json-schema": "^3.24.6"
   },
   "devDependencies": {
     "@eslint/compat": "^1",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/chai": "^4",
     "@types/express": "^5.0.3",
+    "@types/js-yaml": "^4.0.9",
     "@types/mocha": "^10",
-    "@types/node": "^18",
+    "@types/node": "^20",
     "@types/sinon": "^17.0.4",
     "chai": "^4",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "expect-type": "^1.2.2",
     "mocha": "^10",
     "nock": "^14.0.10",
     "oclif": "^4",
@@ -40,7 +58,7 @@
     "typescript": "^5"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "files": [
     "./bin",
@@ -57,7 +75,10 @@
     "dirname": "brv",
     "commands": "./dist/commands",
     "hooks": {
-      "init": "./dist/hooks/init/welcome"
+      "init": "./dist/hooks/init/welcome",
+      "command_not_found": "./dist/hooks/command_not_found/handle-invalid-commands",
+      "error": "./dist/hooks/error/clean-errors",
+      "prerun": "./dist/hooks/prerun/validate-brv-config-version"
     },
     "plugins": [
       "@oclif/plugin-help"
@@ -71,7 +92,7 @@
   },
   "repository": "campfirein/byterover-cli",
   "scripts": {
-    "build": "shx rm -rf dist && tsc -b && shx cp -r src/templates dist/templates",
+    "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/",
     "lint": "eslint",
     "postpack": "shx rm -f oclif.manifest.json",
     "posttest": "npm run lint",

package/dist/commands/add.d.ts

@@ -1,49 +0,0 @@
-import { Command } from '@oclif/core';
-import type { IPlaybookService } from '../core/interfaces/i-playbook-service.js';
-import type { IPlaybookStore } from '../core/interfaces/i-playbook-store.js';
-import type { ITrackingService } from '../core/interfaces/i-tracking-service.js';
-interface SectionPromptOptions {
-    readonly existingSections: readonly string[];
-    readonly suggestedSections: readonly string[];
-}
-export default class Add extends Command {
-    static description: string;
-    static examples: string[];
-    static flags: {
-        'bullet-id': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        content: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        interactive: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        section: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    protected createServices(): {
-        playbookService: IPlaybookService;
-        playbookStore: IPlaybookStore;
-        trackingService: ITrackingService;
-    };
-    /**
-     * Prompt user to confirm adding the bullet
-     */
-    protected promptForConfirmation(bulletId: string, section: string, content: string): Promise<boolean>;
-    /**
-     * Prompt user to enter bullet content
-     */
-    protected promptForContent(section: string): Promise<string>;
-    /**
-     * Prompt user to select or create a section name
-     */
-    protected promptForSection(options: SectionPromptOptions): Promise<string>;
-    run(): Promise<void>;
-    /**
-     * Display success message after adding a bullet
-     */
-    private displaySuccess;
-    /**
-     * Run in flag-based mode (non-interactive)
-     */
-    private runFlagBased;
-    /**
-     * Run in interactive mode
-     */
-    private runInteractive;
-}
-export {};

package/dist/commands/add.js

@@ -1,192 +0,0 @@
-import { confirm, input, search } from '@inquirer/prompts';
-import { Command, Flags } from '@oclif/core';
-import { Playbook } from '../core/domain/entities/playbook.js';
-import { FilePlaybookStore } from '../infra/ace/file-playbook-store.js';
-import { FilePlaybookService } from '../infra/playbook/file-playbook-service.js';
-import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
-import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
-// Constants
-const SUGGESTED_SECTIONS = [
-    'Common Errors',
-    'Best Practices',
-    'Strategies',
-    'Lessons Learned',
-    'Architecture',
-    'Testing',
-];
-const validateContent = (content) => content.trim().length > 0;
-export default class Add extends Command {
-    static description = 'Add or update a bullet in the playbook (bypasses ACE workflow for direct agent usage)';
-    static examples = [
-        '<%= config.bin %> <%= command.id %> --interactive',
-        '<%= config.bin %> <%= command.id %> -i',
-        '<%= config.bin %> <%= command.id %> --section "Common Errors" --content "Authentication fails when token expires"',
-        '<%= config.bin %> <%= command.id %> --section "Common Errors" --bullet-id "common-00001" --content "Updated: Auth fails when token expires"',
-        '<%= config.bin %> <%= command.id %> -s "Best Practices" -c "Always validate user input before processing"',
-    ];
-    static flags = {
-        'bullet-id': Flags.string({
-            char: 'b',
-            description: 'Bullet ID to update (if not provided, a new bullet will be created)',
-            required: false,
-        }),
-        content: Flags.string({
-            char: 'c',
-            description: 'Content of the bullet',
-            required: false,
-        }),
-        interactive: Flags.boolean({
-            char: 'i',
-            default: false,
-            description: 'Run in interactive mode',
-        }),
-        section: Flags.string({
-            char: 's',
-            description: 'Section name for the bullet',
-            required: false,
-        }),
-    };
-    createServices() {
-        return {
-            playbookService: new FilePlaybookService(),
-            playbookStore: new FilePlaybookStore(),
-            trackingService: new MixpanelTrackingService(new KeychainTokenStore()),
-        };
-    }
-    /**
-     * Prompt user to confirm adding the bullet
-     */
-    async promptForConfirmation(bulletId, section, content) {
-        this.log('\nReview your bullet:');
-        this.log(`  ID: ${bulletId}`);
-        this.log(`  Section: ${section}`);
-        const contentDisplay = content.length > 200 ? `${content.slice(0, 200)}...` : content;
-        this.log(`  Content: ${contentDisplay}`);
-        this.log('\nTip: Use `brv status` to view and update bullets later');
-        const confirmed = await confirm({
-            default: true,
-            message: 'Add this bullet?',
-        });
-        return confirmed;
-    }
-    /**
-     * Prompt user to enter bullet content
-     */
-    async promptForContent(section) {
-        const message = `Enter content for new bullet in "${section}":`;
-        const content = await input({
-            message,
-            validate(value) {
-                if (!validateContent(value)) {
-                    return 'Content cannot be empty';
-                }
-                return true;
-            },
-        });
-        return content;
-    }
-    /**
-     * Prompt user to select or create a section name
-     */
-    async promptForSection(options) {
-        const allSections = [...new Set([...options.existingSections, ...options.suggestedSections])];
-        const section = await search({
-            message: 'Select or type a section name:',
-            async source(input) {
-                if (!input) {
-                    return allSections.map((s) => ({ name: s, value: s }));
-                }
-                const filtered = allSections.filter((s) => s.toLowerCase().includes(input.toLowerCase()));
-                // Allow creating new section
-                if (filtered.length === 0 || !filtered.includes(input)) {
-                    filtered.unshift(input);
-                }
-                return filtered.map((s) => ({ name: s, value: s }));
-            },
-        });
-        return section;
-    }
-    async run() {
-        const { flags } = await this.parse(Add);
-        return flags.interactive ? this.runInteractive() : this.runFlagBased(flags);
-    }
-    /**
-     * Display success message after adding a bullet
-     */
-    displaySuccess(bullet) {
-        this.log(`\n✓ Added bullet successfully!`);
-        this.log(`  ID: ${bullet.id}`);
-        this.log(`  Section: ${bullet.section}`);
-        this.log(`  Content: ${bullet.content}`);
-        if (bullet.metadata.tags.length > 0) {
-            this.log(`  Tags: ${bullet.metadata.tags.join(', ')}`);
-        }
-    }
-    /**
-     * Run in flag-based mode (non-interactive)
-     */
-    async runFlagBased(flags) {
-        const { playbookService, trackingService } = this.createServices();
-        try {
-            // Validate required flags
-            if (!flags.section || !flags.content) {
-                this.error('--section and --content are required in non-interactive mode');
-            }
-            // Warn if section is not a standard ACE section
-            if (!SUGGESTED_SECTIONS.includes(flags.section)) {
-                this.warn(`Section "${flags.section}" is not a standard ACE section.\n` +
-                    `  Suggested sections: ${SUGGESTED_SECTIONS.join(', ')}\n` +
-                    `  You can still proceed, but consider using a standard section for consistency.`);
-            }
-            await trackingService.track('ace:add_bullet');
-            const bullet = await playbookService.addOrUpdateBullet({
-                bulletId: flags['bullet-id'],
-                content: flags.content,
-                section: flags.section,
-            });
-            this.displaySuccess(bullet);
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : 'Unexpected error occurred');
-        }
-    }
-    /**
-     * Run in interactive mode
-     */
-    async runInteractive() {
-        const { playbookService, playbookStore, trackingService } = this.createServices();
-        try {
-            // Display welcome message
-            this.log('Press Ctrl+C at any time to cancel the process\n');
-            // Load existing playbook or create new one
-            let playbook = await playbookStore.load();
-            if (!playbook) {
-                playbook = new Playbook();
-            }
-            const sectionOptions = {
-                existingSections: playbook.getSections(),
-                suggestedSections: SUGGESTED_SECTIONS,
-            };
-            const section = await this.promptForSection(sectionOptions);
-            const content = await this.promptForContent(section);
-            // Get next bullet ID for confirmation
-            const nextId = playbook.getNextId();
-            // Prompt for confirmation
-            const confirmed = await this.promptForConfirmation(nextId, section, content);
-            if (!confirmed) {
-                this.log('\nBullet not added. Operation cancelled.');
-                return;
-            }
-            const bullet = await playbookService.addOrUpdateBullet({
-                bulletId: undefined,
-                content,
-                section,
-            });
-            await trackingService.track('ace:add_bullet');
-            this.displaySuccess(bullet);
-        }
-        catch (error) {
-            this.error(error instanceof Error ? error.message : 'Unexpected error occurred');
-        }
-    }
-}

package/dist/commands/complete.d.ts

@@ -1,108 +0,0 @@
-import { Command } from '@oclif/core';
-import type { IAcePromptBuilder } from '../core/interfaces/i-ace-prompt-builder.js';
-import type { IDeltaStore } from '../core/interfaces/i-delta-store.js';
-import type { IExecutorOutputStore } from '../core/interfaces/i-executor-output-store.js';
-import type { IPlaybookService } from '../core/interfaces/i-playbook-service.js';
-import type { IReflectionStore } from '../core/interfaces/i-reflection-store.js';
-export default class Complete extends Command {
-    static args: {
-        hint: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        reasoning: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        finalAnswer: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static description: string;
-    static examples: string[];
-    static flags: {
-        'bullet-ids': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        feedback: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'tool-usage': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'update-bullet': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-    };
-    protected createServices(): {
-        deltaStore: IDeltaStore;
-        executorOutputStore: IExecutorOutputStore;
-        playbookService: IPlaybookService;
-        promptBuilder: IAcePromptBuilder;
-        reflectionStore: IReflectionStore;
-    };
-    run(): Promise<void>;
-    /**
-     * Displays a formatted summary of the completed ACE workflow.
-     * Shows file paths, delta operations breakdown, and success confirmation.
-     *
-     * @param summary - Summary data containing all workflow outputs
-     * @param summary.curatorOutput - The curator output containing delta operations
-     * @param summary.deltaFilePath - Path to the saved delta file
-     * @param summary.executorPath - Path to the saved executor output file
-     * @param summary.hint - The hint used for naming output files
-     * @param summary.reflectionFilePath - Path to the saved reflection file
-     * @param summary.tagsApplied - Number of tags applied to the playbook
-     */
-    private displayFinalSummary;
-    /**
-     * Extracts file paths from tool usage strings and formats them with project name prefix.
-     * Converts tool usage entries like "Read:src/file.ts" to "projectName/src/file.ts".
-     * Filters out non-file-like arguments (e.g., "Bash:npm test" is excluded).
-     *
-     * @param toolUsage - Array of tool usage strings (e.g., ["Read:src/file.ts", "Edit:src/other.ts"])
-     * @returns Array of formatted file paths with project name prefix
-     */
-    private extractFilePaths;
-    /**
-     * Phase 3: Generates curation and applies delta operations to the playbook.
-     * Creates delta operations (ADD or UPDATE) based on reflection insights and applies them to the playbook.
-     *
-     * @param services - The service instances
-     * @param services.deltaStore - Delta store for persisting deltas
-     * @param services.playbookService - Playbook service for applying deltas
-     * @param services.promptBuilder - Prompt builder for curation prompts
-     * @param reflection - The reflection output from Phase 2
-     * @param executorOutput - The executor output from Phase 1
-     * @param flags - Command flags containing optional update-bullet ID
-     * @returns Object containing curator output and delta file path
-     */
-    private generateCurationAndApplyDelta;
-    /**
-     * Phase 2: Generates reflection based on executor output and applies tags to the playbook.
-     * Auto-generates reflection analysis from feedback and applies bullet tags to relevant playbook sections.
-     *
-     * @param services - The service instances
-     * @param services.playbookService - Playbook service for applying reflection tags
-     * @param services.promptBuilder - Prompt builder for reflection prompts
-     * @param services.reflectionStore - Reflection store for persisting reflections
-     * @param executorOutput - The executor output from Phase 1
-     * @param feedback - Environment feedback about task execution (e.g., "Tests passed", "Build failed")
-     * @returns Object containing reflection output, file path, and number of tags applied
-     */
-    private generateReflectionAndApplyTags;
-    /**
-     * Parses comma-separated bullet IDs string into an array of trimmed IDs.
-     * Empty strings and whitespace-only entries are filtered out.
-     *
-     * @param bulletIdsStr - Comma-separated string of bullet IDs (e.g., "bullet-1, bullet-2")
-     * @returns Array of trimmed bullet ID strings (empty array if input is empty string)
-     */
-    private parseBulletIds;
-    /**
-     * Parses comma-separated tool usage string into an array of trimmed entries.
-     * Empty strings and whitespace-only entries are filtered out.
-     *
-     * @param toolUsageStr - Comma-separated string of tool usage (e.g., "Read:file.ts, Edit:other.ts")
-     * @returns Array of trimmed tool usage strings
-     */
-    private parseToolUsage;
-    /**
-     * Phase 1: Saves executor output to a file.
-     * Creates an ExecutorOutput entity from command arguments and persists it using the executor output store service.
-     *
-     * @param executorOutputStore - The executor output store service
-     * @param args - Command arguments
-     * @param args.hint - Short hint for naming output files
-     * @param args.reasoning - Detailed reasoning and approach for completing the task
-     * @param args.finalAnswer - The final answer/solution to the task
-     * @param bulletIds - Array of playbook bullet IDs referenced during task execution
-     * @param toolUsage - Array of tool usage strings (e.g., ["Read:src/file.ts", "Bash:npm test"])
-     * @returns Object containing the executor output entity and file path where it was saved
-     */
-    private saveExecutorOutput;
-}