byterover-cli 1.8.0 → 2.1.0

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

@@ -1,54 +1,41 @@
-/**
- * Array of all supported Agents.
- */
-export const AGENT_VALUES = [
-    'Amp',
-    'Antigravity',
-    'Augment Code',
-    'Claude Code',
-    'Cline',
-    'Codex',
-    'Cursor',
-    'Gemini CLI',
-    'Github Copilot',
-    'Junie',
-    'Kilo Code',
-    'Kiro',
-    'Qoder',
-    'Qwen Code',
-    'Roo Code',
-    'Trae.ai',
-    'Warp',
-    'Windsurf',
-    'Zed',
-];
+export { AGENT_VALUES } from '../../../../shared/types/agent.js';
+// Re-import Agent for use in this file's type definitions
+import { AGENT_VALUES } from '../../../../shared/types/agent.js';
+const agentSet = new Set(AGENT_VALUES);
+export function isAgent(value) {
+    return agentSet.has(value);
+}
 /**
  * Single source of truth for agent connector configuration.
  * Defines which connectors each agent supports and which is the default.
  */
 export const AGENT_CONNECTOR_CONFIG = {
     Amp: {
-        default: 'mcp',
-        supported: ['rules', 'mcp'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Antigravity: {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
+    },
+    'Auggie CLI': {
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     'Augment Code': {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'mcp',
+        supported: ['rules', 'mcp'],
     },
     'Claude Code': {
         default: 'skill',
         supported: ['rules', 'hook', 'mcp', 'skill'],
     },
     Cline: {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'mcp',
+        supported: ['rules', 'mcp'],
     },
     Codex: {
-        default: 'mcp',
+        default: 'skill',
         supported: ['rules', 'mcp', 'skill'],
     },
     Cursor: {
@@ -56,48 +43,56 @@ export const AGENT_CONNECTOR_CONFIG = {
         supported: ['rules', 'mcp', 'skill'],
     },
     'Gemini CLI': {
-        default: 'mcp',
-        supported: ['rules', 'mcp'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     'Github Copilot': {
-        default: 'mcp',
+        default: 'skill',
         supported: ['rules', 'mcp', 'skill'],
     },
     Junie: {
-        default: 'mcp',
-        supported: ['rules', 'mcp'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     'Kilo Code': {
-        default: 'mcp',
-        supported: ['rules', 'mcp'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Kiro: {
-        default: 'mcp',
-        supported: ['rules', 'mcp'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
+    },
+    OpenClaw: {
+        default: 'skill',
+        supported: ['skill'],
+    },
+    OpenCode: {
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Qoder: {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     'Qwen Code': {
-        default: 'rules',
-        supported: ['rules'],
-    },
-    'Roo Code': {
         default: 'mcp',
         supported: ['rules', 'mcp'],
     },
+    'Roo Code': {
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
+    },
     'Trae.ai': {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Warp: {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Windsurf: {
-        default: 'rules',
-        supported: ['rules'],
+        default: 'skill',
+        supported: ['rules', 'mcp', 'skill'],
     },
     Zed: {
         default: 'mcp',

package/dist/server/core/domain/entities/brv-config.d.ts

@@ -2,7 +2,8 @@ import { Agent } from './agent.js';
 import { Space } from './space.js';
 /**
  * Parameters for creating a BrvConfig instance.
- * chatLogPath, cwd, and ide are optional to support partial configs (e.g., after login pre-select).
+ * chatLogPath, cwd, ide, and cloud fields (spaceId, spaceName, teamId, teamName)
+ * are optional to support local-only configs and partial configs.
  */
 export type BrvConfigParams = {
     chatLogPath?: string;
@@ -12,10 +13,10 @@ export type BrvConfigParams = {
     createdAt: string;
     cwd?: string;
     ide?: Agent;
-    spaceId: string;
-    spaceName: string;
-    teamId: string;
-    teamName: string;
+    spaceId?: string;
+    spaceName?: string;
+    teamId?: string;
+    teamName?: string;
     version: string;
 };
 /**
@@ -46,16 +47,24 @@ export declare class BrvConfig {
     readonly createdAt: string;
     readonly cwd?: string;
     readonly ide?: Agent;
-    readonly spaceId: string;
-    readonly spaceName: string;
-    readonly teamId: string;
-    readonly teamName: string;
+    readonly spaceId?: string;
+    readonly spaceName?: string;
+    readonly teamId?: string;
+    readonly teamName?: string;
     readonly version: string;
     constructor(params: BrvConfigParams);
+    /**
+     * Creates a minimal local-only BrvConfig (no cloud fields).
+     * Used for auto-init when .brv/ doesn't exist.
+     */
+    static createLocal(params: {
+        cwd: string;
+    }): BrvConfig;
     /**
      * Deserializes config from JSON format.
+     * Preserves the original version from the file (or defaults to '' if missing).
+     * Callers should check config.version and migrate if needed.
      * @throws Error if the JSON structure is invalid.
-     * @throws BrvConfigVersionError if version is missing or mismatched.
      */
     static fromJson(json: unknown): BrvConfig;
     /**
@@ -68,8 +77,20 @@ export declare class BrvConfig {
      * Does not include chatLogPath, cwd, or ide (agent selection happens in /init).
      */
     static partialFromSpace(params: PartialFromSpaceParams): BrvConfig;
+    /**
+     * Returns true when all cloud fields (spaceId, spaceName, teamId, teamName) are set.
+     */
+    isCloudConnected(): boolean;
     /**
      * Serializes the config to JSON format
      */
     toJson(): Record<string, unknown>;
+    /**
+     * Creates a new BrvConfig with space fields replaced, preserving all other fields.
+     */
+    withSpace(space: Space): BrvConfig;
+    /**
+     * Creates a new BrvConfig with version updated, preserving all other fields.
+     */
+    withVersion(version: string): BrvConfig;
 }

package/dist/server/core/domain/entities/brv-config.js

@@ -1,5 +1,4 @@
 import { BRV_CONFIG_VERSION } from '../../../constants.js';
-import { BrvConfigVersionError } from '../errors/brv-config-version-error.js';
 import { AGENT_VALUES } from './agent.js';
 /**
  * Type guard for Agent validation
@@ -21,13 +20,7 @@ const isCodingAgent = (value) => {
 const isBrvConfigJson = (json) => {
     if (typeof json !== 'object' || json === null)
         return false;
-    const requiredInputJsonKeys = [
-        'createdAt',
-        'spaceId',
-        'spaceName',
-        'teamId',
-        'teamName',
-    ];
+    const requiredInputJsonKeys = ['createdAt'];
     for (const key of requiredInputJsonKeys) {
         if (!(key in json) || typeof json[key] !== 'string') {
             return false;
@@ -41,6 +34,14 @@ const isBrvConfigJson = (json) => {
         return false;
     if (obj.ide !== undefined && !isCodingAgent(obj.ide))
         return false;
+    if (obj.spaceId !== undefined && typeof obj.spaceId !== 'string')
+        return false;
+    if (obj.spaceName !== undefined && typeof obj.spaceName !== 'string')
+        return false;
+    if (obj.teamId !== undefined && typeof obj.teamId !== 'string')
+        return false;
+    if (obj.teamName !== undefined && typeof obj.teamName !== 'string')
+        return false;
     if (obj.cipherAgentContext !== undefined && typeof obj.cipherAgentContext !== 'string')
         return false;
     if (obj.cipherAgentSystemPrompt !== undefined && typeof obj.cipherAgentSystemPrompt !== 'string')
@@ -72,18 +73,6 @@ export class BrvConfig {
         if (params.createdAt.trim().length === 0) {
             throw new Error('Created at cannot be empty');
         }
-        if (params.spaceId.trim().length === 0) {
-            throw new Error('Space ID cannot be empty');
-        }
-        if (params.spaceName.trim().length === 0) {
-            throw new Error('Space name cannot be empty');
-        }
-        if (params.teamId.trim().length === 0) {
-            throw new Error('Team ID cannot be empty');
-        }
-        if (params.teamName.trim().length === 0) {
-            throw new Error('Team name cannot be empty');
-        }
         this.chatLogPath = params.chatLogPath;
         this.cipherAgentContext = params.cipherAgentContext;
         this.cipherAgentModes = params.cipherAgentModes;
@@ -97,36 +86,32 @@ export class BrvConfig {
         this.teamName = params.teamName;
         this.version = params.version;
     }
+    /**
+     * Creates a minimal local-only BrvConfig (no cloud fields).
+     * Used for auto-init when .brv/ doesn't exist.
+     */
+    static createLocal(params) {
+        return new BrvConfig({
+            createdAt: new Date().toISOString(),
+            cwd: params.cwd,
+            version: BRV_CONFIG_VERSION,
+        });
+    }
     /**
      * Deserializes config from JSON format.
+     * Preserves the original version from the file (or defaults to '' if missing).
+     * Callers should check config.version and migrate if needed.
      * @throws Error if the JSON structure is invalid.
-     * @throws BrvConfigVersionError if version is missing or mismatched.
      */
     static fromJson(json) {
-        // Minimal check if json is an object
         if (typeof json !== 'object' || json === null || json === undefined) {
             throw new Error('BrvConfig JSON must be an object');
         }
-        // Check version FIRST (before full structure validation)
-        // This ensures outdated configs get a helpful version error
-        // instead of a generic structure error
-        const jsonObj = json;
-        const version = typeof jsonObj.version === 'string' ? jsonObj.version : undefined;
-        if (version === undefined) {
-            throw new BrvConfigVersionError({
-                currentVersion: undefined,
-                expectedVersion: BRV_CONFIG_VERSION,
-            });
-        }
-        if (version !== BRV_CONFIG_VERSION) {
-            throw new BrvConfigVersionError({
-                currentVersion: version,
-                expectedVersion: BRV_CONFIG_VERSION,
-            });
-        }
         if (!isBrvConfigJson(json)) {
             throw new Error('Invalid BrvConfig JSON structure');
         }
+        const jsonObj = json;
+        const version = typeof jsonObj.version === 'string' ? jsonObj.version : '';
         return new BrvConfig({ ...json, version });
     }
     /**
@@ -160,6 +145,12 @@ export class BrvConfig {
             version: BRV_CONFIG_VERSION,
         });
     }
+    /**
+     * Returns true when all cloud fields (spaceId, spaceName, teamId, teamName) are set.
+     */
+    isCloudConnected() {
+        return Boolean(this.spaceId && this.spaceName && this.teamId && this.teamName);
+    }
     /**
      * Serializes the config to JSON format
      */
@@ -179,4 +170,42 @@ export class BrvConfig {
             version: this.version,
         };
     }
+    /**
+     * Creates a new BrvConfig with space fields replaced, preserving all other fields.
+     */
+    withSpace(space) {
+        return new BrvConfig({
+            chatLogPath: this.chatLogPath,
+            cipherAgentContext: this.cipherAgentContext,
+            cipherAgentModes: this.cipherAgentModes,
+            cipherAgentSystemPrompt: this.cipherAgentSystemPrompt,
+            createdAt: new Date().toISOString(),
+            cwd: this.cwd,
+            ide: this.ide,
+            spaceId: space.id,
+            spaceName: space.name,
+            teamId: space.teamId,
+            teamName: space.teamName,
+            version: this.version,
+        });
+    }
+    /**
+     * Creates a new BrvConfig with version updated, preserving all other fields.
+     */
+    withVersion(version) {
+        return new BrvConfig({
+            chatLogPath: this.chatLogPath,
+            cipherAgentContext: this.cipherAgentContext,
+            cipherAgentModes: this.cipherAgentModes,
+            cipherAgentSystemPrompt: this.cipherAgentSystemPrompt,
+            createdAt: this.createdAt,
+            cwd: this.cwd,
+            ide: this.ide,
+            spaceId: this.spaceId,
+            spaceName: this.spaceName,
+            teamId: this.teamId,
+            teamName: this.teamName,
+            version,
+        });
+    }
 }

package/dist/server/core/domain/entities/connector-type.d.ts

@@ -1,11 +1 @@
-/**
- * Array of all supported connector types.
- * Each connector type represents a different method for integrating BRV with coding agents.
- *
- * - 'rules': Agent reads instructions from a rule file (e.g., CLAUDE.md)
- * - 'hook': Instructions are injected on each prompt via agent hooks
- * - 'mcp': Agent uses mcp tools to interact with brv
- * - 'skill': Agent reads skill files from a project subdirectory
- */
-export declare const CONNECTOR_TYPES: readonly ["rules", "hook", "mcp", "skill"];
-export type ConnectorType = (typeof CONNECTOR_TYPES)[number];
+export { CONNECTOR_TYPES, type ConnectorType } from '../../../../shared/types/connector-type.js';

package/dist/server/core/domain/entities/connector-type.js

@@ -1,10 +1 @@
-/**
- * Array of all supported connector types.
- * Each connector type represents a different method for integrating BRV with coding agents.
- *
- * - 'rules': Agent reads instructions from a rule file (e.g., CLAUDE.md)
- * - 'hook': Instructions are injected on each prompt via agent hooks
- * - 'mcp': Agent uses mcp tools to interact with brv
- * - 'skill': Agent reads skill files from a project subdirectory
- */
-export const CONNECTOR_TYPES = ['rules', 'hook', 'mcp', 'skill'];
+export { CONNECTOR_TYPES } from '../../../../shared/types/connector-type.js';

package/dist/server/core/domain/entities/context-tree-snapshot.d.ts

@@ -1,3 +1,5 @@
+export type { ContextTreeChanges } from '../../../../shared/types/context-tree-changes.js';
+import type { ContextTreeChanges } from '../../../../shared/types/context-tree-changes.js';
 /**
  * Represents a file's state in the context tree snapshot.
  */
@@ -7,17 +9,6 @@ export interface FileState {
     /** File size in bytes */
     size: number;
 }
-/**
- * Represents changes detected between current state and snapshot.
- */
-export interface ContextTreeChanges {
-    /** Files that exist now but not in snapshot */
-    added: string[];
-    /** Files that exist in snapshot but not now */
-    deleted: string[];
-    /** Files with different hash than snapshot */
-    modified: string[];
-}
 /**
  * Raw JSON structure for snapshot persistence.
  */

package/dist/server/core/domain/entities/curate-log-entry.d.ts

@@ -0,0 +1,41 @@
+export type CurateLogOperation = {
+    filePath?: string;
+    message?: string;
+    path: string;
+    status: 'failed' | 'success';
+    type: 'ADD' | 'DELETE' | 'MERGE' | 'UPDATE' | 'UPSERT';
+};
+export type CurateLogSummary = {
+    added: number;
+    deleted: number;
+    failed: number;
+    merged: number;
+    updated: number;
+};
+type CurateLogBase = {
+    id: string;
+    input: {
+        context?: string;
+        files?: string[];
+        folders?: string[];
+    };
+    operations: CurateLogOperation[];
+    startedAt: number;
+    summary: CurateLogSummary;
+    taskId: string;
+};
+export type CurateLogEntry = (CurateLogBase & {
+    completedAt: number;
+    error: string;
+    status: 'error';
+}) | (CurateLogBase & {
+    completedAt: number;
+    response?: string;
+    status: 'completed';
+}) | (CurateLogBase & {
+    completedAt: number;
+    status: 'cancelled';
+}) | (CurateLogBase & {
+    status: 'processing';
+});
+export {};

package/dist/server/core/domain/entities/curation-status.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Status of a curation process.
+ * Emitted after curate execution completes to enable status tracking.
+ */
+export interface CurationStatus {
+    /** Timestamp when curation completed (ISO 8601) */
+    completedAt: string;
+    /** Error message if failed */
+    error?: string;
+    /** Overall status */
+    status: 'failed' | 'partial' | 'success';
+    /** Summary from tools.curate() result */
+    summary: {
+        added: number;
+        deleted: number;
+        failed: number;
+        merged: number;
+        updated: number;
+    };
+    /** Unique task ID for this curation run */
+    taskId: string;
+    /** Verification results — did the files actually materialize? */
+    verification: {
+        checked: number;
+        confirmed: number;
+        missing: string[];
+    };
+}

package/dist/server/core/domain/entities/provider-config.d.ts

@@ -10,6 +10,10 @@
 export interface ConnectedProviderConfig {
     /** Currently active model for this provider */
     readonly activeModel?: string;
+    /** Context window size of the active model (from provider API, e.g. OpenRouter) */
+    readonly activeModelContextLength?: number;
+    /** Custom API base URL (for openai-compatible provider) */
+    readonly baseUrl?: string;
     /** When the provider was connected */
     readonly connectedAt: string;
     /** User's favorite models (for quick access) */
@@ -51,6 +55,14 @@ export declare class ProviderConfig {
      * Get the active model for a provider.
      */
     getActiveModel(providerId: string): string | undefined;
+    /**
+     * Get the context window size of the active model for a provider.
+     */
+    getActiveModelContextLength(providerId: string): number | undefined;
+    /**
+     * Get the custom base URL for a provider (e.g., openai-compatible).
+     */
+    getBaseUrl(providerId: string): string | undefined;
     /**
      * Get favorite models for a provider.
      */
@@ -70,7 +82,7 @@ export declare class ProviderConfig {
     /**
      * Create a new config with the active model changed for a provider.
      */
-    withActiveModel(providerId: string, modelId: string): ProviderConfig;
+    withActiveModel(providerId: string, modelId: string, contextLength?: number): ProviderConfig;
     /**
      * Create a new config with the active provider changed.
      */
@@ -84,6 +96,7 @@ export declare class ProviderConfig {
      */
     withProviderConnected(providerId: string, options?: {
         activeModel?: string;
+        baseUrl?: string;
     }): ProviderConfig;
     /**
      * Create a new config with a provider disconnected.

package/dist/server/core/domain/entities/provider-config.js

@@ -21,7 +21,7 @@ const isProviderConfigJson = (json) => {
  * Default configuration when no providers are connected.
  */
 export const DEFAULT_PROVIDER_CONFIG = {
-    activeProvider: 'byterover',
+    activeProvider: '',
     providers: {},
 };
 /**
@@ -61,6 +61,18 @@ export class ProviderConfig {
     getActiveModel(providerId) {
         return this.providers[providerId]?.activeModel;
     }
+    /**
+     * Get the context window size of the active model for a provider.
+     */
+    getActiveModelContextLength(providerId) {
+        return this.providers[providerId]?.activeModelContextLength;
+    }
+    /**
+     * Get the custom base URL for a provider (e.g., openai-compatible).
+     */
+    getBaseUrl(providerId) {
+        return this.providers[providerId]?.baseUrl;
+    }
     /**
      * Get favorite models for a provider.
      */
@@ -91,19 +103,17 @@ export class ProviderConfig {
     /**
      * Create a new config with the active model changed for a provider.
      */
-    withActiveModel(providerId, modelId) {
+    withActiveModel(providerId, modelId, contextLength) {
         const existingConfig = this.providers[providerId];
         if (!existingConfig) {
             return this;
         }
         // Add to recent models (at the front, deduplicated)
-        const recentModels = [
-            modelId,
-            ...existingConfig.recentModels.filter((m) => m !== modelId),
-        ].slice(0, MAX_RECENT_MODELS);
+        const recentModels = [modelId, ...existingConfig.recentModels.filter((m) => m !== modelId)].slice(0, MAX_RECENT_MODELS);
         const newProviderConfig = {
             ...existingConfig,
             activeModel: modelId,
+            activeModelContextLength: contextLength,
             recentModels,
         };
         return new ProviderConfig({
@@ -154,6 +164,7 @@ export class ProviderConfig {
         const existingConfig = this.providers[providerId];
         const newProviderConfig = {
             activeModel: options?.activeModel ?? existingConfig?.activeModel,
+            baseUrl: options?.baseUrl ?? existingConfig?.baseUrl,
             connectedAt: existingConfig?.connectedAt ?? new Date().toISOString(),
             favoriteModels: existingConfig?.favoriteModels ?? [],
             recentModels: existingConfig?.recentModels ?? [],

package/dist/server/core/domain/entities/provider-registry.d.ts

@@ -10,7 +10,7 @@
 export interface ProviderDefinition {
     /** URL where users can get an API key */
     readonly apiKeyUrl?: string;
-    /** API base URL (empty for internal providers) */
+    /** API base URL (empty for internal providers, SDK-managed for Google) */
     readonly baseUrl: string;
     /** Category for grouping in UI */
     readonly category: 'other' | 'popular';
@@ -18,6 +18,8 @@ export interface ProviderDefinition {
     readonly defaultModel?: string;
     /** Short description */
     readonly description: string;
+    /** Environment variable names to check for API key auto-detection */
+    readonly envVars?: readonly string[];
     /** Default headers for API requests */
     readonly headers: Readonly<Record<string, string>>;
     /** Unique provider identifier */