byterover-cli 1.7.2 → 2.0.0

package/dist/server/core/domain/errors/ace-error.d.ts

@@ -1,34 +0,0 @@
-/**
- * Base error for ACE operations
- */
-export declare class AceError extends Error {
-    readonly code?: string;
-    constructor(message: string, code?: string);
-}
-/**
- * Error when a bullet is not found
- */
-export declare class BulletNotFoundError extends AceError {
-    readonly bulletId: string;
-    constructor(bulletId: string);
-}
-/**
- * Error when a playbook is not found
- */
-export declare class PlaybookNotFoundError extends AceError {
-    readonly playbookPath: string;
-    constructor(playbookPath: string);
-}
-/**
- * Error when delta operation fails
- */
-export declare class DeltaOperationError extends AceError {
-    readonly operation: string;
-    constructor(operation: string, message: string);
-}
-/**
- * Error when playbook validation fails
- */
-export declare class PlaybookValidationError extends AceError {
-    constructor(message: string);
-}

package/dist/server/core/domain/errors/ace-error.js

@@ -1,53 +0,0 @@
-/**
- * Base error for ACE operations
- */
-export class AceError extends Error {
-    code;
-    constructor(message, code) {
-        super(message);
-        this.name = 'AceError';
-        this.code = code;
-    }
-}
-/**
- * Error when a bullet is not found
- */
-export class BulletNotFoundError extends AceError {
-    bulletId;
-    constructor(bulletId) {
-        super(`Bullet not found: ${bulletId}`, 'BULLET_NOT_FOUND');
-        this.name = 'BulletNotFoundError';
-        this.bulletId = bulletId;
-    }
-}
-/**
- * Error when a playbook is not found
- */
-export class PlaybookNotFoundError extends AceError {
-    playbookPath;
-    constructor(playbookPath) {
-        super(`Playbook not found: ${playbookPath}`, 'PLAYBOOK_NOT_FOUND');
-        this.name = 'PlaybookNotFoundError';
-        this.playbookPath = playbookPath;
-    }
-}
-/**
- * Error when delta operation fails
- */
-export class DeltaOperationError extends AceError {
-    operation;
-    constructor(operation, message) {
-        super(`Delta operation failed (${operation}): ${message}`, 'DELTA_OPERATION_FAILED');
-        this.name = 'DeltaOperationError';
-        this.operation = operation;
-    }
-}
-/**
- * Error when playbook validation fails
- */
-export class PlaybookValidationError extends AceError {
-    constructor(message) {
-        super(`Playbook validation failed: ${message}`, 'PLAYBOOK_VALIDATION_FAILED');
-        this.name = 'PlaybookValidationError';
-    }
-}

package/dist/server/core/domain/errors/brv-config-version-error.d.ts

@@ -1,16 +0,0 @@
-/**
- * Error thrown when the BrvConfig version is missing or incompatible.
- *
- * This error is used to detect outdated `.brv/config.json` files that need
- * to be reinitialized via `brv init`.
- */
-export declare class BrvConfigVersionError extends Error {
-    /** The version found in the config file, or undefined if missing. */
-    readonly currentVersion: string | undefined;
-    /** The version expected by the current CLI. */
-    readonly expectedVersion: string;
-    constructor(params: {
-        currentVersion: string | undefined;
-        expectedVersion: string;
-    });
-}

package/dist/server/core/domain/errors/brv-config-version-error.js

@@ -1,21 +0,0 @@
-/**
- * Error thrown when the BrvConfig version is missing or incompatible.
- *
- * This error is used to detect outdated `.brv/config.json` files that need
- * to be reinitialized via `brv init`.
- */
-export class BrvConfigVersionError extends Error {
-    /** The version found in the config file, or undefined if missing. */
-    currentVersion;
-    /** The version expected by the current CLI. */
-    expectedVersion;
-    constructor(params) {
-        const message = params.currentVersion
-            ? `Config version mismatch (found: ${params.currentVersion}, expected: ${params.expectedVersion}). Please run 'brv init' to reinitialize.`
-            : `Config version missing. Please run 'brv init' to reinitialize.`;
-        super(message);
-        this.name = 'BrvConfigVersionError';
-        this.currentVersion = params.currentVersion;
-        this.expectedVersion = params.expectedVersion;
-    }
-}

package/dist/server/core/domain/errors/core-process-error.d.ts

@@ -1,27 +0,0 @@
-/**
- * Base error for Core process failures.
- */
-export declare class CoreProcessError extends Error {
-    constructor(message: string);
-}
-/**
- * Error thrown when Core process is already running.
- */
-export declare class CoreProcessAlreadyRunningError extends CoreProcessError {
-    constructor();
-}
-/**
- * Error thrown when instance lock cannot be acquired.
- */
-export declare class InstanceLockError extends CoreProcessError {
-    readonly existingPid?: number;
-    readonly existingPort?: number;
-    constructor(existingPid?: number, existingPort?: number);
-}
-/**
- * Error thrown when instance lock acquisition fails for unknown reason.
- */
-export declare class InstanceLockAcquisitionError extends CoreProcessError {
-    readonly reason?: string;
-    constructor(reason?: string);
-}

package/dist/server/core/domain/errors/core-process-error.js

@@ -1,43 +0,0 @@
-/**
- * Base error for Core process failures.
- */
-export class CoreProcessError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'CoreProcessError';
-    }
-}
-/**
- * Error thrown when Core process is already running.
- */
-export class CoreProcessAlreadyRunningError extends CoreProcessError {
-    constructor() {
-        super('Core process is already running');
-        this.name = 'CoreProcessAlreadyRunningError';
-    }
-}
-/**
- * Error thrown when instance lock cannot be acquired.
- */
-export class InstanceLockError extends CoreProcessError {
-    existingPid;
-    existingPort;
-    constructor(existingPid, existingPort) {
-        const details = existingPid && existingPort ? ` (pid: ${existingPid}, port: ${existingPort})` : '';
-        super(`Failed to acquire instance lock. Another instance is already running${details}`);
-        this.name = 'InstanceLockError';
-        this.existingPid = existingPid;
-        this.existingPort = existingPort;
-    }
-}
-/**
- * Error thrown when instance lock acquisition fails for unknown reason.
- */
-export class InstanceLockAcquisitionError extends CoreProcessError {
-    reason;
-    constructor(reason) {
-        super(`Failed to acquire instance lock${reason ? `: ${reason}` : ''}`);
-        this.name = 'InstanceLockAcquisitionError';
-        this.reason = reason;
-    }
-}

package/dist/server/core/domain/instance/index.d.ts

@@ -1 +0,0 @@
-export * from './types.js';

package/dist/server/core/domain/instance/index.js

@@ -1 +0,0 @@
-export * from './types.js';

package/dist/server/core/domain/instance/types.d.ts

@@ -1,57 +0,0 @@
-/**
- * Raw instance data as stored in instance.json.
- * Used for serialization/deserialization.
- *
- * NOTE: We don't store "status" - we check pid alive at runtime instead.
- * This avoids stale status when process crashes.
- */
-export type InstanceInfoJson = {
-    /** Current active session ID (for quick lookup without DB query) */
-    currentSessionId: null | string;
-    /** Process ID of the Core process */
-    pid: number;
-    /** Port the transport server is listening on */
-    port: number;
-    /** Timestamp when instance started (ms since epoch) */
-    startedAt: number;
-};
-/**
- * Instance information representing a BRV Core process.
- *
- * Architecture note (Section 7):
- * - File exists + pid alive  → instance đang chạy
- * - File exists + pid dead   → stale (crash), có thể overwrite
- * - File không có            → không có instance nào
- */
-export declare class InstanceInfo {
-    readonly currentSessionId: null | string;
-    readonly pid: number;
-    readonly port: number;
-    readonly startedAt: Date;
-    private constructor();
-    /**
-     * Creates a new instance info.
-     */
-    static create(data: {
-        currentSessionId?: null | string;
-        pid: number;
-        port: number;
-    }): InstanceInfo;
-    /**
-     * Creates instance info from JSON data (from instance.json file).
-     */
-    static fromJson(json: InstanceInfoJson): InstanceInfo;
-    /**
-     * Returns the transport URL for connecting to this instance.
-     * Uses 'localhost' instead of '127.0.0.1' for better sandbox compatibility.
-     */
-    getTransportUrl(): string;
-    /**
-     * Converts instance info to JSON for persistence.
-     */
-    toJson(): InstanceInfoJson;
-    /**
-     * Creates a new instance info with updated session ID.
-     */
-    withSessionId(sessionId: string): InstanceInfo;
-}

package/dist/server/core/domain/instance/types.js

@@ -1,72 +0,0 @@
-import { TRANSPORT_HOST } from '../../../constants.js';
-/**
- * Instance information representing a BRV Core process.
- *
- * Architecture note (Section 7):
- * - File exists + pid alive  → instance đang chạy
- * - File exists + pid dead   → stale (crash), có thể overwrite
- * - File không có            → không có instance nào
- */
-export class InstanceInfo {
-    currentSessionId;
-    pid;
-    port;
-    startedAt;
-    constructor(data) {
-        this.currentSessionId = data.currentSessionId;
-        this.pid = data.pid;
-        this.port = data.port;
-        this.startedAt = data.startedAt;
-    }
-    /**
-     * Creates a new instance info.
-     */
-    static create(data) {
-        return new InstanceInfo({
-            currentSessionId: data.currentSessionId ?? null,
-            pid: data.pid,
-            port: data.port,
-            startedAt: new Date(),
-        });
-    }
-    /**
-     * Creates instance info from JSON data (from instance.json file).
-     */
-    static fromJson(json) {
-        return new InstanceInfo({
-            currentSessionId: json.currentSessionId,
-            pid: json.pid,
-            port: json.port,
-            startedAt: new Date(json.startedAt),
-        });
-    }
-    /**
-     * Returns the transport URL for connecting to this instance.
-     * Uses 'localhost' instead of '127.0.0.1' for better sandbox compatibility.
-     */
-    getTransportUrl() {
-        return `http://${TRANSPORT_HOST}:${this.port}`;
-    }
-    /**
-     * Converts instance info to JSON for persistence.
-     */
-    toJson() {
-        return {
-            currentSessionId: this.currentSessionId,
-            pid: this.pid,
-            port: this.port,
-            startedAt: this.startedAt.getTime(),
-        };
-    }
-    /**
-     * Creates a new instance info with updated session ID.
-     */
-    withSessionId(sessionId) {
-        return new InstanceInfo({
-            currentSessionId: sessionId,
-            pid: this.pid,
-            port: this.port,
-            startedAt: this.startedAt,
-        });
-    }
-}

package/dist/server/core/interfaces/instance/i-instance-discovery.d.ts

@@ -1,45 +0,0 @@
-import type { InstanceInfo } from '../../domain/instance/types.js';
-/**
- * Result of instance discovery.
- *
- * - no_instance: No .brv/ directory found in tree
- * - instance_crashed: Found instance.json but pid is dead
- */
-export type DiscoveryResult = {
-    found: false;
-    reason: 'instance_crashed' | 'no_instance';
-} | {
-    found: true;
-    instance: InstanceInfo;
-    projectRoot: string;
-};
-/**
- * Interface for discovering running instances via walk-up directory search.
- *
- * Architecture notes (Section 5 - Transport Discovery):
- * Walk up directory tree to find .brv/instance.json, verify pid alive.
- */
-export interface IInstanceDiscovery {
-    /**
-     * Discovers a running instance starting from the given directory.
-     *
-     * Walk-up algorithm:
-     * 1. Start from `fromDir`
-     * 2. Check if .brv/instance.json exists
-     * 3. If yes, verify pid is alive
-     * 4. If no, walk up to parent directory
-     * 5. Repeat until root or found
-     *
-     * @param fromDir - Starting directory (usually cwd)
-     * @returns DiscoveryResult with instance info and project root if found
-     */
-    discover: (fromDir: string) => Promise<DiscoveryResult>;
-    /**
-     * Finds the project root by walking up from a directory.
-     * Returns the directory containing .brv/ or undefined if not found.
-     *
-     * @param fromDir - Starting directory
-     * @returns Project root path or undefined
-     */
-    findProjectRoot: (fromDir: string) => Promise<string | undefined>;
-}

package/dist/server/core/interfaces/instance/i-instance-manager.d.ts

@@ -1,58 +0,0 @@
-import type { InstanceInfo } from '../../domain/instance/types.js';
-/**
- * Result of attempting to acquire an instance lock.
- */
-export type AcquireResult = {
-    acquired: false;
-    existingInstance: InstanceInfo;
-    reason: 'already_running';
-} | {
-    acquired: true;
-    instance: InstanceInfo;
-};
-/**
- * Interface for managing instance lifecycle.
- *
- * Architecture notes (Section 6 - Instance Lock):
- * - 1 FOLDER = 1 TRANSPORT SERVER
- * - Handles acquire/release semantics for instance.json
- * - Verifies PID to detect crashed instances (no status field needed)
- */
-export interface IInstanceManager {
-    /**
-     * Attempts to acquire an instance lock for the given project root.
-     *
-     * Flow:
-     * 1. Check if instance.json exists
-     * 2. If exists and pid alive → return already_running
-     * 3. If exists but stale (pid dead) → overwrite
-     * 4. Create new instance.json
-     *
-     * @param projectRoot - Root directory containing .brv/
-     * @param port - Port the transport server will use
-     * @returns AcquireResult indicating success or existing instance
-     */
-    acquire: (projectRoot: string, port: number) => Promise<AcquireResult>;
-    /**
-     * Reads instance info from the project root.
-     * Returns undefined if instance.json doesn't exist.
-     *
-     * @param projectRoot - Root directory containing .brv/
-     */
-    load: (projectRoot: string) => Promise<InstanceInfo | undefined>;
-    /**
-     * Releases the instance lock by deleting instance.json.
-     *
-     * Called during graceful shutdown.
-     *
-     * @param projectRoot - Root directory containing .brv/
-     */
-    release: (projectRoot: string) => Promise<void>;
-    /**
-     * Updates the current session ID in instance.json.
-     *
-     * @param projectRoot - Root directory containing .brv/
-     * @param sessionId - New session ID to set
-     */
-    updateSessionId: (projectRoot: string, sessionId: string) => Promise<void>;
-}

package/dist/server/core/interfaces/instance/index.d.ts

@@ -1,2 +0,0 @@
-export * from './i-instance-discovery.js';
-export * from './i-instance-manager.js';

package/dist/server/core/interfaces/instance/index.js

@@ -1,2 +0,0 @@
-export * from './i-instance-discovery.js';
-export * from './i-instance-manager.js';

package/dist/server/core/interfaces/noop-implementations.d.ts

@@ -1,53 +0,0 @@
-/**
- * NoOp Implementations for Core Interfaces
- *
- * These are used by CoreProcess when creating UseCases for Transport mode.
- * Transport mode receives auth/config directly and doesn't use these stores,
- * so NoOp implementations are sufficient.
- */
-import type { AuthToken } from '../domain/entities/auth-token.js';
-import type { BrvConfig } from '../domain/entities/brv-config.js';
-import type { EventName, PropertyDict } from '../domain/entities/event.js';
-import type { ITokenStore } from './auth/i-token-store.js';
-import type { ConfirmOptions, FileSelectorItem, FileSelectorOptions, InputOptions, ITerminal, SearchOptions, SelectOptions } from './services/i-terminal.js';
-import type { ITrackingService } from './services/i-tracking-service.js';
-import type { IProjectConfigStore } from './storage/i-project-config-store.js';
-/**
- * NoOp Terminal - Does nothing, used for headless Transport mode.
- */
-export declare class NoOpTerminal implements ITerminal {
-    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;
-}
-/**
- * NoOp Tracking Service - Does nothing, used for headless Transport mode.
- */
-export declare class NoOpTrackingService implements ITrackingService {
-    track(_eventName: EventName, _properties?: PropertyDict): Promise<void>;
-}
-/**
- * NoOp Token Store - Always returns undefined, used when Core loads auth separately.
- * In Transport mode, auth is passed directly to UseCases.
- */
-export declare class NoOpTokenStore implements ITokenStore {
-    clear(): Promise<void>;
-    load(): Promise<AuthToken | undefined>;
-    save(_token: AuthToken): Promise<void>;
-}
-/**
- * NoOp Project Config Store - Always returns undefined, used when Core loads config separately.
- * In Transport mode, brvConfig is passed directly to UseCases.
- */
-export declare class NoOpProjectConfigStore implements IProjectConfigStore {
-    exists(_directory?: string): Promise<boolean>;
-    read(_directory?: string): Promise<BrvConfig | undefined>;
-    write(_config: BrvConfig, _directory?: string): Promise<void>;
-}

package/dist/server/core/interfaces/noop-implementations.js

@@ -1,62 +0,0 @@
-/**
- * NoOp Implementations for Core Interfaces
- *
- * These are used by CoreProcess when creating UseCases for Transport mode.
- * Transport mode receives auth/config directly and doesn't use these stores,
- * so NoOp implementations are sufficient.
- */
-/**
- * NoOp Terminal - Does nothing, used for headless Transport mode.
- */
-export class NoOpTerminal {
-    actionStart(_message) { }
-    actionStop(_message) { }
-    async confirm(_options) {
-        return false;
-    }
-    error(_message) { }
-    async fileSelector(_options) {
-        return null;
-    }
-    async input(_options) {
-        return '';
-    }
-    log(_message) { }
-    async search(_options) {
-        throw new Error('NoOpTerminal: search not supported in headless mode');
-    }
-    async select(_options) {
-        throw new Error('NoOpTerminal: select not supported in headless mode');
-    }
-    warn(_message) { }
-}
-/**
- * NoOp Tracking Service - Does nothing, used for headless Transport mode.
- */
-export class NoOpTrackingService {
-    async track(_eventName, _properties) { }
-}
-/**
- * NoOp Token Store - Always returns undefined, used when Core loads auth separately.
- * In Transport mode, auth is passed directly to UseCases.
- */
-export class NoOpTokenStore {
-    async clear() { }
-    async load() {
-        return undefined;
-    }
-    async save(_token) { }
-}
-/**
- * NoOp Project Config Store - Always returns undefined, used when Core loads config separately.
- * In Transport mode, brvConfig is passed directly to UseCases.
- */
-export class NoOpProjectConfigStore {
-    async exists(_directory) {
-        return false;
-    }
-    async read(_directory) {
-        return undefined;
-    }
-    async write(_config, _directory) { }
-}

package/dist/server/core/interfaces/services/i-tracking-service.d.ts

@@ -1,21 +0,0 @@
-import { EventName, PropertyDict } from '../../domain/entities/event.js';
-/**
- * Service interface for tracking user actions and system events.
- *
- * Provides a unified contract for event tracking and analytics throughout the application.
- * Implementations should be non-blocking and handle failures gracefully to avoid impacting
- * user operations.
- */
-export interface ITrackingService {
-    /**
-     * Tracks a named event with optional metadata.
-     *
-     * This method should be asynchronous and non-blocking. Implementations should log
-     * errors internally rather than throwing, to prevent tracking failures from disrupting
-     * user operations.
-     *
-     * @param eventName - The name of the event to track. Must be one of the predefined EventName values.
-     * @param properties - Optional metadata to attach to the event as key-value pairs. All values must be strings.
-     */
-    track(eventName: EventName, properties?: PropertyDict): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-connectors-use-case.d.ts

@@ -1,3 +0,0 @@
-export interface IConnectorsUseCase {
-    run(): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-curate-use-case.d.ts

@@ -1,14 +0,0 @@
-export interface CurateUseCaseRunOptions {
-    apiKey?: string;
-    context?: string;
-    files?: string[];
-    /** Folder references to pack and analyze (triggers folder pack flow) */
-    folders?: string[];
-    format?: 'json' | 'text';
-    headless?: boolean;
-    model?: string;
-    verbose?: boolean;
-}
-export interface ICurateUseCase {
-    run(options: CurateUseCaseRunOptions): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-init-use-case.d.ts

@@ -1,11 +0,0 @@
-export interface InitUseCaseRunOptions {
-    force: boolean;
-    format?: 'json' | 'text';
-    /** Space ID for headless mode (skips interactive selection) */
-    spaceId?: string;
-    /** Team ID for headless mode (skips interactive selection) */
-    teamId?: string;
-}
-export interface IInitUseCase {
-    run(options: InitUseCaseRunOptions): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-login-use-case.d.ts

@@ -1,6 +0,0 @@
-export interface LoginUseCaseRunOptions {
-    apiKey?: string;
-}
-export interface ILoginUseCase {
-    run(options: LoginUseCaseRunOptions): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-logout-use-case.d.ts

@@ -1,5 +0,0 @@
-export interface ILogoutUseCase {
-    run: (options: {
-        skipConfirmation: boolean;
-    }) => Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-pull-use-case.d.ts

@@ -1,7 +0,0 @@
-export interface PullUseCaseRunOptions {
-    branch: string;
-    format?: 'json' | 'text';
-}
-export interface IPullUseCase {
-    run: (options: PullUseCaseRunOptions) => Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-push-use-case.d.ts

@@ -1,8 +0,0 @@
-export interface PushUseCaseRunOptions {
-    branch: string;
-    format?: 'json' | 'text';
-    skipConfirmation: boolean;
-}
-export interface IPushUseCase {
-    run(options: PushUseCaseRunOptions): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-query-use-case.d.ts

@@ -1,11 +0,0 @@
-export interface QueryUseCaseRunOptions {
-    apiKey?: string;
-    format?: 'json' | 'text';
-    headless?: boolean;
-    model?: string;
-    query: string;
-    verbose?: boolean;
-}
-export interface IQueryUseCase {
-    run(options: QueryUseCaseRunOptions): Promise<void>;
-}

package/dist/server/core/interfaces/usecase/i-reset-use-case.d.ts

@@ -1,6 +0,0 @@
-export interface IResetUseCase {
-    run(options: {
-        directory?: string;
-        skipConfirmation: boolean;
-    }): Promise<void>;
-}