byterover-cli 2.5.2 → 3.0.0

package/dist/server/core/interfaces/storage/i-onboarding-preference-store.d.ts

@@ -1,20 +0,0 @@
-/**
- * Store for onboarding preferences.
- * Used to persist when onboarding was last dismissed to implement
- * cooldown periods (e.g., show onboarding at most once per week).
- */
-export interface IOnboardingPreferenceStore {
-    /**
-     * Get the timestamp when onboarding was last dismissed.
-     * Returns undefined if never dismissed.
-     */
-    getLastDismissedAt(): Promise<number | undefined>;
-    /**
-     * Set the timestamp when onboarding was dismissed.
-     */
-    setLastDismissedAt(timestamp: number): Promise<void>;
-    /**
-     * Clear the stored preference.
-     */
-    clear(): Promise<void>;
-}

package/dist/server/core/interfaces/storage/i-onboarding-preference-store.js

@@ -1 +0,0 @@
-export {};

package/dist/server/infra/connectors/rules/legacy-rule-detector.d.ts

@@ -1,21 +0,0 @@
-import type { Agent } from '../../../core/domain/entities/agent.js';
-import type { ILegacyRuleDetector, LegacyRuleDetectionResult } from '../../../core/interfaces/services/i-legacy-rule-detector.js';
-export declare class LegacyRuleDetector implements ILegacyRuleDetector {
-    private static readonly SECTION_SEPARATOR_PATTERN;
-    private static readonly WORKFLOW_HEADER_PATTERN;
-    detectLegacyRules(content: string, agentName: Agent): LegacyRuleDetectionResult;
-    /**
-     * Attempts to find the start of a ByteRover rule section by working backwards from the footer.
-     *
-     * Strategy 3 (Conservative Multi-Pattern Match):
-     * 1. Look backwards for "# Workflow Instruction" header (most reliable)
-     * 2. If not found, look backwards for "---" separator before command reference
-     * 3. If still not found, return undefined (uncertain)
-     *
-     * @param lines All lines in the file.
-     * @param footerIndex Index of the line containing the footer tag (0-indexed).
-     * @param usedLineRanges Line ranges already claimed by detected sections.
-     * @returns Index of the start line (0-indexed), or undefined if uncertain.
-     */
-    private findSectionStart;
-}

package/dist/server/infra/connectors/rules/legacy-rule-detector.js

@@ -1,106 +0,0 @@
-import { BRV_RULE_TAG } from '../shared/constants.js';
-export class LegacyRuleDetector {
-    static SECTION_SEPARATOR_PATTERN = /^---\s*$/;
-    static WORKFLOW_HEADER_PATTERN = /^#\sWorkflow Instruction$/;
-    detectLegacyRules(content, agentName) {
-        // Normalize line endings to handle CRLF
-        const normalizedContent = content.replaceAll('\r\n', '\n').replaceAll('\r', '\n');
-        const lines = normalizedContent.split('\n');
-        const footerTag = `${BRV_RULE_TAG} ${agentName}`;
-        const reliableMatches = [];
-        const uncertainMatches = [];
-        const usedLineRanges = [];
-        // Find all occurrences of the footer tag
-        for (const [index, line] of lines.entries()) {
-            // Use exact match to avoid matching partial agent names like "Github Copilot Extended"
-            if (line.trim() === footerTag) {
-                const footerIndex = index;
-                const footerLineNumber = footerIndex + 1;
-                // Try to find the start of this ByteRover section
-                const startIndex = this.findSectionStart(lines, footerIndex, usedLineRanges);
-                if (startIndex === undefined) {
-                    // Uncertain match - couldn't reliably determine start
-                    uncertainMatches.push({
-                        footerLine: footerLineNumber,
-                        reason: 'Could not reliably determine the start of the ByteRover rule section.',
-                    });
-                }
-                else {
-                    // Reliable match found
-                    const startLineNumber = startIndex + 1;
-                    const sectionContent = lines.slice(startIndex, footerIndex + 1).join('\n');
-                    reliableMatches.push({
-                        content: sectionContent,
-                        endLine: footerLineNumber,
-                        startLine: startLineNumber,
-                    });
-                    // Mark this range as used so it won't be reused by subsequent footers
-                    usedLineRanges.push({ end: footerIndex, start: startIndex });
-                }
-            }
-        }
-        return { reliableMatches, uncertainMatches };
-    }
-    /**
-     * Attempts to find the start of a ByteRover rule section by working backwards from the footer.
-     *
-     * Strategy 3 (Conservative Multi-Pattern Match):
-     * 1. Look backwards for "# Workflow Instruction" header (most reliable)
-     * 2. If not found, look backwards for "---" separator before command reference
-     * 3. If still not found, return undefined (uncertain)
-     *
-     * @param lines All lines in the file.
-     * @param footerIndex Index of the line containing the footer tag (0-indexed).
-     * @param usedLineRanges Line ranges already claimed by detected sections.
-     * @returns Index of the start line (0-indexed), or undefined if uncertain.
-     */
-    findSectionStart(lines, footerIndex, usedLineRanges) {
-        // Strategy 1: Look for "# Workflow Instruction" header (most reliable)
-        for (let i = footerIndex - 1; i >= 0; i--) {
-            if (LegacyRuleDetector.WORKFLOW_HEADER_PATTERN.test(lines[i])) {
-                // Check if this header is within any already-detected section
-                const isWithinUsedRange = usedLineRanges.some((range) => i >= range.start && i <= range.end);
-                if (!isWithinUsedRange) {
-                    return i;
-                }
-            }
-        }
-        // Strategy 2: Look for "---" separator
-        // We need to find the section separator that appears before the command reference
-        // and after the workflow content. This is less reliable but still useful.
-        const separatorIndices = [];
-        for (let i = footerIndex - 1; i >= 0; i--) {
-            if (LegacyRuleDetector.SECTION_SEPARATOR_PATTERN.test(lines[i])) {
-                separatorIndices.push(i);
-            }
-        }
-        // If we found at least one separator, use it as a fallback
-        // We want the one closest to the footer but before the "---" that precedes the footer
-        if (separatorIndices.length > 0) {
-            // The footer line should be preceded by "---", so we skip that one
-            // and look for the next separator going backwards
-            let candidateIndex;
-            for (const sepIndex of separatorIndices) {
-                const linesBetween = footerIndex - sepIndex;
-                if (linesBetween === 1) {
-                    // This is the separator right before the footer, skip it
-                    continue;
-                }
-                // Check if this separator is within any already-detected section
-                const isWithinUsedRange = usedLineRanges.some((range) => sepIndex >= range.start && sepIndex <= range.end);
-                if (isWithinUsedRange) {
-                    continue;
-                }
-                // This could be a section separator within the ByteRover content
-                // Use the first one we find (closest to footer)
-                candidateIndex = sepIndex + 1;
-                break;
-            }
-            if (candidateIndex !== undefined && candidateIndex < footerIndex) {
-                return candidateIndex;
-            }
-        }
-        // Strategy 3: Could not reliably determine start
-        return undefined;
-    }
-}

package/dist/server/infra/memory/http-memory-retrieval-service.d.ts

@@ -1,18 +0,0 @@
-import type { IMemoryRetrievalService, RetrieveParams } from '../../core/interfaces/services/i-memory-retrieval-service.js';
-import { RetrieveResult } from '../../core/domain/entities/retrieve-result.js';
-export type MemoryRetrievalServiceConfig = {
-    apiBaseUrl: string;
-    timeout?: number;
-};
-/**
- * HTTP implementation of IMemoryRetrievalService for ByteRover Memora service.
- * Handles retrieval of memories based on search queries.
- */
-export declare class HttpMemoryRetrievalService implements IMemoryRetrievalService {
-    private readonly config;
-    constructor(config: MemoryRetrievalServiceConfig);
-    retrieve(params: RetrieveParams): Promise<RetrieveResult>;
-    private buildQueryParams;
-    private mapToMemory;
-    private mapToRetrieveResult;
-}

package/dist/server/infra/memory/http-memory-retrieval-service.js

@@ -1,64 +0,0 @@
-import { Memory } from '../../core/domain/entities/memory.js';
-import { RetrieveResult } from '../../core/domain/entities/retrieve-result.js';
-import { getErrorMessage } from '../../utils/error-helpers.js';
-import { AuthenticatedHttpClient } from '../http/authenticated-http-client.js';
-/**
- * HTTP implementation of IMemoryRetrievalService for ByteRover Memora service.
- * Handles retrieval of memories based on search queries.
- */
-export class HttpMemoryRetrievalService {
-    config;
-    constructor(config) {
-        this.config = {
-            ...config,
-            timeout: config.timeout ?? 30_000, // Default 30 seconds timeout (memory retrieval may be slower)
-        };
-    }
-    async retrieve(params) {
-        try {
-            const httpClient = new AuthenticatedHttpClient(params.sessionKey);
-            // Build query parameters
-            const queryParams = this.buildQueryParams(params);
-            const response = await httpClient.get(`${this.config.apiBaseUrl}/retrieve?${queryParams}`, {
-                timeout: this.config.timeout,
-            });
-            return this.mapToRetrieveResult(response);
-        }
-        catch (error) {
-            throw new Error(`Failed to retrieve memories: ${getErrorMessage(error)}`);
-        }
-    }
-    buildQueryParams(params) {
-        const queryParams = new URLSearchParams({
-            project_id: params.spaceId,
-            query: params.query,
-        });
-        // Add node_keys only if provided
-        if (params.nodeKeys !== undefined && params.nodeKeys.length > 0) {
-            queryParams.set('node_keys', params.nodeKeys.join(','));
-        }
-        return queryParams.toString();
-    }
-    mapToMemory(apiMemory) {
-        return new Memory({
-            bulletId: apiMemory.bullet_id,
-            childrenIds: apiMemory.children_ids,
-            content: apiMemory.content,
-            id: apiMemory.id,
-            metadataType: apiMemory.metadata_type,
-            nodeKeys: apiMemory.node_keys,
-            parentIds: apiMemory.parent_ids,
-            score: apiMemory.score,
-            section: apiMemory.section,
-            tags: apiMemory.tags,
-            timestamp: apiMemory.timestamp,
-            title: apiMemory.title,
-        });
-    }
-    mapToRetrieveResult(response) {
-        return new RetrieveResult({
-            memories: response.memories.map((m) => this.mapToMemory(m)),
-            relatedMemories: response.related_memories.map((m) => this.mapToMemory(m)),
-        });
-    }
-}

package/dist/server/infra/memory/http-memory-storage-service.d.ts

@@ -1,18 +0,0 @@
-import type { ConfirmUploadParams, GetPresignedUrlsParams, IMemoryStorageService } from '../../core/interfaces/services/i-memory-storage-service.js';
-import { PresignedUrlsResponse } from '../../core/domain/entities/presigned-urls-response.js';
-export type MemoryStorageServiceConfig = {
-    apiBaseUrl: string;
-    timeout?: number;
-};
-/**
- * HTTP implementation of IMemoryStorageService for ByteRover CoGit service.
- * Handles uploading playbooks to blob storage.
- */
-export declare class HttpMemoryStorageService implements IMemoryStorageService {
-    private readonly config;
-    constructor(config: MemoryStorageServiceConfig);
-    confirmUpload(params: ConfirmUploadParams): Promise<void>;
-    getPresignedUrls(params: GetPresignedUrlsParams): Promise<PresignedUrlsResponse>;
-    uploadFile(uploadUrl: string, content: string): Promise<void>;
-    private mapToPresignedUrls;
-}

package/dist/server/infra/memory/http-memory-storage-service.js

@@ -1,72 +0,0 @@
-/* eslint-disable camelcase */
-import axios from 'axios';
-import { PresignedUrl } from '../../core/domain/entities/presigned-url.js';
-import { PresignedUrlsResponse } from '../../core/domain/entities/presigned-urls-response.js';
-import { getErrorMessage } from '../../utils/error-helpers.js';
-import { AuthenticatedHttpClient } from '../http/authenticated-http-client.js';
-import { ProxyConfig } from '../http/proxy-config.js';
-/**
- * HTTP implementation of IMemoryStorageService for ByteRover CoGit service.
- * Handles uploading playbooks to blob storage.
- */
-export class HttpMemoryStorageService {
-    config;
-    constructor(config) {
-        this.config = {
-            ...config,
-            timeout: config.timeout ?? 30_000, // Default 30 seconds timeout
-        };
-    }
-    async confirmUpload(params) {
-        try {
-            const httpClient = new AuthenticatedHttpClient(params.sessionKey);
-            const url = `${this.config.apiBaseUrl}/organizations/${params.teamId}/projects/${params.spaceId}/memory-processing/confirm-upload`;
-            const requestBody = {
-                request_id: params.requestId,
-            };
-            await httpClient.post(url, requestBody, {
-                timeout: this.config.timeout,
-            });
-        }
-        catch (error) {
-            throw new Error(`Failed to confirm upload: ${getErrorMessage(error)}`);
-        }
-    }
-    async getPresignedUrls(params) {
-        try {
-            const httpClient = new AuthenticatedHttpClient(params.sessionKey);
-            const url = `${this.config.apiBaseUrl}/organizations/${params.teamId}/projects/${params.spaceId}/memory-processing/presigned-urls`;
-            const requestBody = {
-                branch: params.branch,
-                file_names: params.fileNames,
-            };
-            const response = await httpClient.post(url, requestBody, {
-                timeout: this.config.timeout,
-            });
-            const presignedUrls = response.data.presigned_urls.map((presignedUrlData) => this.mapToPresignedUrls(presignedUrlData));
-            return new PresignedUrlsResponse(presignedUrls, response.data.request_id);
-        }
-        catch (error) {
-            throw new Error(`Failed to get presigned URLs: ${getErrorMessage(error)}`);
-        }
-    }
-    async uploadFile(uploadUrl, content) {
-        try {
-            await axios.put(uploadUrl, content, {
-                headers: {
-                    'Content-Type': 'application/json',
-                },
-                httpAgent: ProxyConfig.getProxyAgent(),
-                httpsAgent: ProxyConfig.getProxyAgent(),
-                proxy: false,
-                timeout: this.config.timeout,
-            });
-        }
-        catch (error) {
-            throw new Error(`Failed to upload file: ${getErrorMessage(error)}`);
-        }
-    }
-    mapToPresignedUrls(presignedUrlData) {
-        return new PresignedUrl(presignedUrlData.file_name, presignedUrlData.presigned_url);
-    }
-}

package/dist/server/infra/memory/memory-to-playbook-mapper.d.ts

@@ -1,33 +0,0 @@
-import type { Memory } from '../../core/domain/entities/memory.js';
-import type { RetrieveResult } from '../../core/domain/entities/retrieve-result.js';
-import { Bullet } from '../../core/domain/entities/bullet.js';
-import { Playbook } from '../../core/domain/entities/playbook.js';
-/**
- * Transforms a Memory entity into a Bullet entity for playbook storage.
- *
- * Mapping:
- * - memory.bulletId -> bullet.id
- * - memory.section -> bullet.section
- * - memory.content -> bullet.content
- * - memory.tags -> bullet.metadata.tags
- * - memory.nodeKeys -> bullet.metadata.relatedFiles
- * - memory.timestamp -> bullet.metadata.timestamp
- * - memory.id -> bullet.memoryId
- *
- * @param memory The Memory entity to transform
- * @returns A Bullet entity
- */
-export declare const transformMemoryToBullet: (memory: Memory) => Bullet;
-/**
- * Transforms a RetrieveResult into a Playbook.
- *
- * This function:
- * 1. Combines both memories and relatedMemories from the result
- * 2. Transforms each Memory into a Bullet
- * 3. Organizes bullets by section
- * 4. Creates a new Playbook with nextId set to 1 (reset value)
- *
- * @param result The RetrieveResult containing memories from Memora service
- * @returns A Playbook containing all retrieved memories as bullets
- */
-export declare const transformRetrieveResultToPlaybook: (result: RetrieveResult) => Playbook;

package/dist/server/infra/memory/memory-to-playbook-mapper.js

@@ -1,51 +0,0 @@
-import { Bullet } from '../../core/domain/entities/bullet.js';
-import { Playbook } from '../../core/domain/entities/playbook.js';
-/**
- * Transforms a Memory entity into a Bullet entity for playbook storage.
- *
- * Mapping:
- * - memory.bulletId -> bullet.id
- * - memory.section -> bullet.section
- * - memory.content -> bullet.content
- * - memory.tags -> bullet.metadata.tags
- * - memory.nodeKeys -> bullet.metadata.relatedFiles
- * - memory.timestamp -> bullet.metadata.timestamp
- * - memory.id -> bullet.memoryId
- *
- * @param memory The Memory entity to transform
- * @returns A Bullet entity
- */
-export const transformMemoryToBullet = (memory) => {
-    const metadata = {
-        relatedFiles: [...memory.nodeKeys],
-        tags: [...memory.tags],
-        timestamp: memory.timestamp,
-    };
-    return new Bullet(memory.bulletId, memory.section, memory.content, metadata, memory.id);
-};
-/**
- * Transforms a RetrieveResult into a Playbook.
- *
- * This function:
- * 1. Combines both memories and relatedMemories from the result
- * 2. Transforms each Memory into a Bullet
- * 3. Organizes bullets by section
- * 4. Creates a new Playbook with nextId set to 1 (reset value)
- *
- * @param result The RetrieveResult containing memories from Memora service
- * @returns A Playbook containing all retrieved memories as bullets
- */
-export const transformRetrieveResultToPlaybook = (result) => {
-    const bulletsMap = new Map();
-    const sectionsMap = new Map();
-    const allMemories = [...result.memories, ...result.relatedMemories];
-    for (const memory of allMemories) {
-        const bullet = transformMemoryToBullet(memory);
-        bulletsMap.set(bullet.id, bullet);
-        if (!sectionsMap.has(bullet.section)) {
-            sectionsMap.set(bullet.section, []);
-        }
-        sectionsMap.get(bullet.section).push(bullet.id);
-    }
-    return new Playbook(bulletsMap, sectionsMap, bulletsMap.size + 1);
-};

package/dist/server/infra/storage/file-onboarding-preference-store.d.ts

@@ -1,10 +0,0 @@
-import type { IOnboardingPreferenceStore } from '../../core/interfaces/storage/i-onboarding-preference-store.js';
-/**
- * Onboarding preference store implementation using a lock file.
- * Stores last dismissed timestamp in XDG data directory.
- */
-export declare class FileOnboardingPreferenceStore implements IOnboardingPreferenceStore {
-    clear(): Promise<void>;
-    getLastDismissedAt(): Promise<number | undefined>;
-    setLastDismissedAt(timestamp: number): Promise<void>;
-}

package/dist/server/infra/storage/file-onboarding-preference-store.js

@@ -1,45 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
-import { getGlobalDataDir } from '../../utils/global-data-path.js';
-const ONBOARDING_LOCK_FILE = join(getGlobalDataDir(), '.onboarding-dismissed');
-/**
- * Onboarding preference store implementation using a lock file.
- * Stores last dismissed timestamp in XDG data directory.
- */
-export class FileOnboardingPreferenceStore {
-    async clear() {
-        try {
-            if (existsSync(ONBOARDING_LOCK_FILE)) {
-                rmSync(ONBOARDING_LOCK_FILE);
-            }
-        }
-        catch {
-            // Ignore errors
-        }
-    }
-    async getLastDismissedAt() {
-        try {
-            if (!existsSync(ONBOARDING_LOCK_FILE)) {
-                return undefined;
-            }
-            const content = readFileSync(ONBOARDING_LOCK_FILE, 'utf8').trim();
-            const timestamp = Number.parseInt(content, 10);
-            return Number.isNaN(timestamp) ? undefined : timestamp;
-        }
-        catch {
-            return undefined;
-        }
-    }
-    async setLastDismissedAt(timestamp) {
-        try {
-            const parentDir = dirname(ONBOARDING_LOCK_FILE);
-            if (!existsSync(parentDir)) {
-                mkdirSync(parentDir, { recursive: true });
-            }
-            writeFileSync(ONBOARDING_LOCK_FILE, String(timestamp), 'utf8');
-        }
-        catch {
-            // Silently ignore errors - onboarding preference is non-critical
-        }
-    }
-}

package/dist/server/infra/terminal/headless-terminal.d.ts

@@ -1,91 +0,0 @@
-import type { ConfirmOptions, FileSelectorItem, FileSelectorOptions, InputOptions, ITerminal, SearchOptions, SelectOptions } from '../../core/interfaces/services/i-terminal.js';
-/**
- * Output format for headless terminal.
- * - 'text': Human-readable text output
- * - 'json': NDJSON (newline-delimited JSON) for machine parsing
- */
-export type HeadlessOutputFormat = 'json' | 'text';
-/**
- * JSON message types for structured output.
- */
-export type HeadlessMessageType = 'action_start' | 'action_stop' | 'error' | 'log' | 'result' | 'warning';
-/**
- * Structured JSON output message.
- */
-export interface HeadlessJsonMessage {
-    actionId?: string;
-    id: string;
-    message: string;
-    timestamp: string;
-    type: HeadlessMessageType;
-}
-/**
- * Options for creating a HeadlessTerminal.
- */
-export interface HeadlessTerminalOptions {
-    /**
-     * Stream for errors (defaults to process.stderr).
-     */
-    errorStream?: NodeJS.WritableStream;
-    /**
-     * If true, throw HeadlessPromptError when a prompt cannot be answered.
-     * If false, use sensible defaults (first choice, false for confirm, etc.)
-     * @default true
-     */
-    failOnPrompt?: boolean;
-    /**
-     * Output format: 'text' for human readable, 'json' for machine parsing.
-     * @default 'text'
-     */
-    outputFormat?: HeadlessOutputFormat;
-    /**
-     * Stream for output (defaults to process.stdout).
-     */
-    outputStream?: NodeJS.WritableStream;
-    /**
-     * Default values for prompts, keyed by prompt message or prompt type.
-     * Used to answer prompts automatically in headless mode.
-     */
-    promptDefaults?: Record<string, unknown>;
-}
-/**
- * Terminal implementation for headless/non-interactive mode.
- * Outputs to stdout/stderr and handles prompts via defaults or fails gracefully.
- */
-export declare class HeadlessTerminal implements ITerminal {
-    private currentActionId;
-    private readonly errorOutput;
-    private readonly failOnPrompt;
-    private readonly output;
-    private readonly outputFormat;
-    private readonly promptDefaults;
-    constructor(options?: HeadlessTerminalOptions);
-    actionStart(message: string): void;
-    actionStop(message?: string): void;
-    confirm(options: ConfirmOptions): Promise<boolean>;
-    error(message: string): void;
-    fileSelector(options: FileSelectorOptions): Promise<FileSelectorItem | null>;
-    input(options: InputOptions): Promise<string>;
-    log(message?: string): void;
-    search<T>(options: SearchOptions<T>): Promise<T>;
-    select<T>(options: SelectOptions<T>): Promise<T>;
-    warn(message: string): void;
-    /**
-     * Write final response with success/error status.
-     */
-    writeFinalResponse(response: {
-        command: string;
-        data?: unknown;
-        error?: {
-            code: string;
-            message: string;
-        };
-        success: boolean;
-    }): void;
-    /**
-     * Write final result in JSON format (convenience method for commands).
-     */
-    writeResult(data: Record<string, unknown>): void;
-    private getDefault;
-    private writeJson;
-}