byterover-cli 1.7.2 → 2.0.0

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

@@ -9,22 +9,191 @@
  * Order by priority for consistent display.
  */
 export const PROVIDER_REGISTRY = {
+    anthropic: {
+        apiKeyUrl: 'https://console.anthropic.com/settings/keys',
+        baseUrl: 'https://api.anthropic.com',
+        category: 'popular',
+        defaultModel: 'claude-sonnet-4-5-20250929',
+        description: 'Claude models by Anthropic',
+        envVars: ['ANTHROPIC_API_KEY'],
+        headers: {},
+        id: 'anthropic',
+        modelsEndpoint: '/v1/models',
+        name: 'Anthropic',
+        priority: 2,
+    },
     byterover: {
         baseUrl: '',
         category: 'popular',
-        description: 'Internal ByteRover LLM',
+        description: 'Built-in LLM, no API key required. Free tier available.',
         headers: {},
         id: 'byterover',
         modelsEndpoint: '',
         name: 'ByteRover',
         priority: 0,
     },
+    cerebras: {
+        apiKeyUrl: 'https://cloud.cerebras.ai/platform',
+        baseUrl: 'https://api.cerebras.ai/v1',
+        category: 'other',
+        defaultModel: 'gpt-oss-120b',
+        description: 'Fast inference on Cerebras hardware',
+        envVars: ['CEREBRAS_API_KEY'],
+        headers: {},
+        id: 'cerebras',
+        modelsEndpoint: '/models',
+        name: 'Cerebras',
+        priority: 14,
+    },
+    cohere: {
+        apiKeyUrl: 'https://dashboard.cohere.com/api-keys',
+        baseUrl: 'https://api.cohere.com/v2',
+        category: 'other',
+        defaultModel: 'command-a-03-2025',
+        description: 'Command models by Cohere',
+        envVars: ['COHERE_API_KEY'],
+        headers: {},
+        id: 'cohere',
+        modelsEndpoint: '/models',
+        name: 'Cohere',
+        priority: 11,
+    },
+    deepinfra: {
+        apiKeyUrl: 'https://deepinfra.com/dash/api_keys',
+        baseUrl: 'https://api.deepinfra.com/v1/openai',
+        category: 'other',
+        defaultModel: 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+        description: 'Affordable inference on open models',
+        envVars: ['DEEPINFRA_API_KEY'],
+        headers: {},
+        id: 'deepinfra',
+        modelsEndpoint: '/models',
+        name: 'DeepInfra',
+        priority: 10,
+    },
+    glm: {
+        apiKeyUrl: 'https://open.z.ai',
+        baseUrl: 'https://api.z.ai/api/paas/v4',
+        category: 'other',
+        defaultModel: 'glm-4.7',
+        description: 'GLM models by Zhipu AI',
+        envVars: ['ZHIPU_API_KEY'],
+        headers: {},
+        id: 'glm',
+        modelsEndpoint: '',
+        name: 'GLM (Z.AI)',
+        priority: 17,
+    },
+    google: {
+        apiKeyUrl: 'https://aistudio.google.com/apikey',
+        baseUrl: '',
+        category: 'popular',
+        defaultModel: 'gemini-2.5-flash',
+        description: 'Gemini models by Google',
+        envVars: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
+        headers: {},
+        id: 'google',
+        modelsEndpoint: '',
+        name: 'Google Gemini',
+        priority: 4,
+    },
+    'google-vertex': {
+        apiKeyUrl: 'https://console.cloud.google.com/iam-admin/serviceaccounts',
+        baseUrl: '',
+        category: 'popular',
+        defaultModel: 'gemini-2.5-flash',
+        description: 'Gemini via Google Cloud Vertex AI',
+        envVars: ['GOOGLE_APPLICATION_CREDENTIALS'],
+        headers: {},
+        id: 'google-vertex',
+        modelsEndpoint: '',
+        name: 'Google Vertex AI',
+        priority: 5,
+    },
+    groq: {
+        apiKeyUrl: 'https://console.groq.com/keys',
+        baseUrl: 'https://api.groq.com/openai/v1',
+        category: 'popular',
+        defaultModel: 'openai/gpt-oss-120b',
+        description: 'Fast inference on open models',
+        envVars: ['GROQ_API_KEY'],
+        headers: {},
+        id: 'groq',
+        modelsEndpoint: '/models',
+        name: 'Groq',
+        priority: 6,
+    },
+    minimax: {
+        apiKeyUrl: 'https://platform.minimax.io',
+        baseUrl: 'https://api.minimax.io/v1',
+        category: 'other',
+        defaultModel: 'MiniMax-M2',
+        description: 'MiniMax AI models',
+        envVars: ['MINIMAX_API_KEY'],
+        headers: {},
+        id: 'minimax',
+        modelsEndpoint: '',
+        name: 'MiniMax',
+        priority: 16,
+    },
+    mistral: {
+        apiKeyUrl: 'https://console.mistral.ai/api-keys',
+        baseUrl: 'https://api.mistral.ai/v1',
+        category: 'popular',
+        defaultModel: 'mistral-large-latest',
+        description: 'Mistral AI models',
+        envVars: ['MISTRAL_API_KEY'],
+        headers: {},
+        id: 'mistral',
+        modelsEndpoint: '/models',
+        name: 'Mistral',
+        priority: 7,
+    },
+    moonshot: {
+        apiKeyUrl: 'https://platform.moonshot.ai/console/api-keys',
+        baseUrl: 'https://api.moonshot.ai/v1',
+        category: 'other',
+        defaultModel: 'kimi-k2.5',
+        description: 'Kimi models by Moonshot AI',
+        envVars: ['MOONSHOT_API_KEY'],
+        headers: {},
+        id: 'moonshot',
+        modelsEndpoint: '',
+        name: 'Moonshot AI (Kimi)',
+        priority: 18,
+    },
+    openai: {
+        apiKeyUrl: 'https://platform.openai.com/api-keys',
+        baseUrl: 'https://api.openai.com/v1',
+        category: 'popular',
+        defaultModel: 'gpt-4.1',
+        description: 'GPT models by OpenAI',
+        envVars: ['OPENAI_API_KEY'],
+        headers: {},
+        id: 'openai',
+        modelsEndpoint: '/models',
+        name: 'OpenAI',
+        priority: 3,
+    },
+    'openai-compatible': {
+        baseUrl: '',
+        category: 'other',
+        defaultModel: 'llama3',
+        description: 'Connect any OpenAI-compatible endpoint (Ollama, LM Studio, etc.)',
+        envVars: ['OPENAI_COMPATIBLE_API_KEY'],
+        headers: {},
+        id: 'openai-compatible',
+        modelsEndpoint: '/models',
+        name: 'OpenAI Compatible',
+        priority: 20,
+    },
     openrouter: {
         apiKeyUrl: 'https://openrouter.ai/keys',
         baseUrl: 'https://openrouter.ai/api/v1',
         category: 'popular',
-        defaultModel: 'anthropic/claude-3.5-sonnet',
-        description: 'Access 200+ models',
+        defaultModel: 'anthropic/claude-sonnet-4.5',
+        description: 'Access 200+ models via aggregator',
+        envVars: ['OPENROUTER_API_KEY'],
         headers: {
             'HTTP-Referer': 'https://byterover.dev',
             'X-Title': 'byterover-cli',
@@ -34,11 +203,58 @@ export const PROVIDER_REGISTRY = {
         name: 'OpenRouter',
         priority: 1,
     },
-    // Future providers can be added here:
-    // anthropic: { ... },
-    // openai: { ... },
-    // google: { ... },
-    // groq: { ... },
+    perplexity: {
+        apiKeyUrl: 'https://www.perplexity.ai/settings/api',
+        baseUrl: 'https://api.perplexity.ai',
+        category: 'other',
+        defaultModel: 'sonar-pro',
+        description: 'Web search-augmented inference',
+        envVars: ['PERPLEXITY_API_KEY'],
+        headers: {},
+        id: 'perplexity',
+        modelsEndpoint: '',
+        name: 'Perplexity',
+        priority: 13,
+    },
+    togetherai: {
+        apiKeyUrl: 'https://api.together.ai/settings/api-keys',
+        baseUrl: 'https://api.together.xyz/v1',
+        category: 'other',
+        defaultModel: 'meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8',
+        description: 'Open-source model inference',
+        envVars: ['TOGETHER_API_KEY', 'TOGETHERAI_API_KEY'],
+        headers: {},
+        id: 'togetherai',
+        modelsEndpoint: '/models',
+        name: 'Together AI',
+        priority: 12,
+    },
+    vercel: {
+        apiKeyUrl: 'https://v0.dev/chat/settings/keys',
+        baseUrl: 'https://api.v0.dev/v1',
+        category: 'other',
+        defaultModel: 'v0-1.5-md',
+        description: 'Vercel AI-powered models',
+        envVars: ['VERCEL_API_KEY'],
+        headers: {},
+        id: 'vercel',
+        modelsEndpoint: '/models',
+        name: 'Vercel',
+        priority: 15,
+    },
+    xai: {
+        apiKeyUrl: 'https://console.x.ai',
+        baseUrl: 'https://api.x.ai/v1',
+        category: 'popular',
+        defaultModel: 'grok-3',
+        description: 'Grok models by xAI',
+        envVars: ['XAI_API_KEY'],
+        headers: {},
+        id: 'xai',
+        modelsEndpoint: '/models',
+        name: 'xAI (Grok)',
+        priority: 5,
+    },
 };
 /**
  * Get all providers sorted by priority.
@@ -69,6 +285,10 @@ export function providerRequiresApiKey(id) {
     const provider = getProviderById(id);
     if (!provider)
         return false;
-    // Internal providers (empty baseUrl) don't need API keys
-    return provider.baseUrl.length > 0;
+    // Internal providers (byterover) don't need API keys.
+    // Vertex AI uses Application Default Credentials, not API keys.
+    // OpenAI Compatible has optional API key (handled in provider-command).
+    if (id === 'byterover' || id === 'google-vertex' || id === 'openai-compatible')
+        return false;
+    return true;
 }

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

@@ -6,11 +6,15 @@ export declare const TaskErrorCode: {
     readonly AGENT_DISCONNECTED: "ERR_AGENT_DISCONNECTED";
     readonly AGENT_NOT_AVAILABLE: "ERR_AGENT_NOT_AVAILABLE";
     readonly AGENT_NOT_INITIALIZED: "ERR_AGENT_NOT_INITIALIZED";
+    readonly CONTEXT_TREE_NOT_INITIALIZED: "ERR_CONTEXT_TREE_NOT_INIT";
     readonly LLM_ERROR: "ERR_LLM_ERROR";
     readonly LLM_RATE_LIMIT: "ERR_LLM_RATE_LIMIT";
+    readonly LOCAL_CHANGES_EXIST: "ERR_LOCAL_CHANGES_EXIST";
     readonly NOT_AUTHENTICATED: "ERR_NOT_AUTHENTICATED";
-    readonly PROCESSOR_NOT_INIT: "ERR_PROCESSOR_NOT_INIT";
     readonly PROJECT_NOT_INIT: "ERR_PROJECT_NOT_INIT";
+    readonly PROVIDER_NOT_CONFIGURED: "ERR_PROVIDER_NOT_CONFIGURED";
+    readonly SPACE_NOT_CONFIGURED: "ERR_SPACE_NOT_CONFIGURED";
+    readonly SPACE_NOT_FOUND: "ERR_SPACE_NOT_FOUND";
     readonly TASK_CANCELLED: "ERR_TASK_CANCELLED";
     readonly TASK_EXECUTION: "ERR_TASK_EXECUTION";
     readonly TASK_TIMEOUT: "ERR_TASK_TIMEOUT";
@@ -54,15 +58,24 @@ export declare class AgentDisconnectedError extends TaskError {
 export declare class AgentNotInitializedError extends TaskError {
     constructor(reason?: string);
 }
-export declare class ProcessorNotInitError extends TaskError {
-    constructor();
-}
 export declare class NotAuthenticatedError extends TaskError {
     constructor();
 }
 export declare class ProjectNotInitError extends TaskError {
     constructor();
 }
+export declare class ContextTreeNotInitializedError extends TaskError {
+    constructor();
+}
 export declare class FileValidationError extends Error {
     constructor(message?: string);
 }
+export declare class LocalChangesExistError extends TaskError {
+    constructor(message?: string);
+}
+export declare class SpaceNotConfiguredError extends TaskError {
+    constructor();
+}
+export declare class SpaceNotFoundError extends TaskError {
+    constructor();
+}

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

@@ -7,14 +7,19 @@ export const TaskErrorCode = {
     AGENT_DISCONNECTED: 'ERR_AGENT_DISCONNECTED',
     AGENT_NOT_AVAILABLE: 'ERR_AGENT_NOT_AVAILABLE',
     AGENT_NOT_INITIALIZED: 'ERR_AGENT_NOT_INITIALIZED',
+    // Context tree errors
+    CONTEXT_TREE_NOT_INITIALIZED: 'ERR_CONTEXT_TREE_NOT_INIT',
     // LLM errors
     LLM_ERROR: 'ERR_LLM_ERROR',
     LLM_RATE_LIMIT: 'ERR_LLM_RATE_LIMIT',
+    LOCAL_CHANGES_EXIST: 'ERR_LOCAL_CHANGES_EXIST',
     // Auth/Init errors
     NOT_AUTHENTICATED: 'ERR_NOT_AUTHENTICATED',
     // Execution errors
-    PROCESSOR_NOT_INIT: 'ERR_PROCESSOR_NOT_INIT',
     PROJECT_NOT_INIT: 'ERR_PROJECT_NOT_INIT',
+    PROVIDER_NOT_CONFIGURED: 'ERR_PROVIDER_NOT_CONFIGURED',
+    SPACE_NOT_CONFIGURED: 'ERR_SPACE_NOT_CONFIGURED',
+    SPACE_NOT_FOUND: 'ERR_SPACE_NOT_FOUND',
     TASK_CANCELLED: 'ERR_TASK_CANCELLED',
     TASK_EXECUTION: 'ERR_TASK_EXECUTION',
     TASK_TIMEOUT: 'ERR_TASK_TIMEOUT',
@@ -60,6 +65,8 @@ export function serializeTaskError(error) {
         // Check for known error names and map to codes
         const codeMap = {
             AuthError: TaskErrorCode.NOT_AUTHENTICATED,
+            LlmGenerationError: TaskErrorCode.LLM_ERROR,
+            LlmRateLimitError: TaskErrorCode.LLM_RATE_LIMIT,
             RateLimitError: TaskErrorCode.LLM_RATE_LIMIT,
             TaskCancelledError: TaskErrorCode.TASK_CANCELLED,
             TimeoutError: TaskErrorCode.TASK_TIMEOUT,
@@ -93,31 +100,49 @@ export class AgentDisconnectedError extends TaskError {
 }
 export class AgentNotInitializedError extends TaskError {
     constructor(reason) {
-        super(reason ? `Agent not initialized: ${reason}` : 'Agent not initialized. Please complete login and setup first.', TaskErrorCode.AGENT_NOT_INITIALIZED);
+        super(reason ? `Agent failed to initialize: ${reason}` : "Agent failed to initialize. Run 'brv restart' to force a clean restart.", TaskErrorCode.AGENT_NOT_INITIALIZED);
         this.name = 'AgentNotInitializedError';
     }
 }
-export class ProcessorNotInitError extends TaskError {
-    constructor() {
-        super('TaskProcessor not initialized', TaskErrorCode.PROCESSOR_NOT_INIT);
-        this.name = 'ProcessorNotInitError';
-    }
-}
 export class NotAuthenticatedError extends TaskError {
     constructor() {
-        super('Not authenticated. Please run "brv login" first.', TaskErrorCode.NOT_AUTHENTICATED);
+        super('Not authenticated. Cloud sync features (push/pull/space) require login — local query and curate work without authentication.', TaskErrorCode.NOT_AUTHENTICATED);
         this.name = 'NotAuthenticatedError';
     }
 }
 export class ProjectNotInitError extends TaskError {
     constructor() {
-        super('Project not initialized. Please run "brv init" first.', TaskErrorCode.PROJECT_NOT_INIT);
+        super('Project not initialized. Run "brv restart" to reinitialize.', TaskErrorCode.PROJECT_NOT_INIT);
         this.name = 'ProjectNotInitError';
     }
 }
+export class ContextTreeNotInitializedError extends TaskError {
+    constructor() {
+        super('Context tree not initialized', TaskErrorCode.CONTEXT_TREE_NOT_INITIALIZED);
+        this.name = 'ContextTreeNotInitializedError';
+    }
+}
 export class FileValidationError extends Error {
     constructor(message = 'File validation failed. Please check file paths.') {
         super(message);
         this.name = 'FileValidationError';
     }
 }
+export class LocalChangesExistError extends TaskError {
+    constructor(message = 'Local changes exist. Run "brv push" to save your changes before pulling.') {
+        super(message, TaskErrorCode.LOCAL_CHANGES_EXIST);
+        this.name = 'LocalChangesExistError';
+    }
+}
+export class SpaceNotConfiguredError extends TaskError {
+    constructor() {
+        super('No space configured. Run "brv space list" to see available spaces, then "brv space switch --team <team> --name <space>" to select one.', TaskErrorCode.SPACE_NOT_CONFIGURED);
+        this.name = 'SpaceNotConfiguredError';
+    }
+}
+export class SpaceNotFoundError extends TaskError {
+    constructor() {
+        super('Space not found', TaskErrorCode.SPACE_NOT_FOUND);
+        this.name = 'SpaceNotFoundError';
+    }
+}

package/dist/server/core/domain/knowledge/markdown-writer.d.ts

@@ -1,24 +1,94 @@
 export interface RawConcept {
+    author?: string;
     changes?: string[];
     files?: string[];
     flow?: string;
+    patterns?: Array<{
+        description: string;
+        flags?: string;
+        pattern: string;
+    }>;
     task?: string;
     timestamp?: string;
 }
 export interface Narrative {
     dependencies?: string;
-    features?: string;
+    diagrams?: Array<{
+        content: string;
+        title?: string;
+        type: string;
+    }>;
+    examples?: string;
+    highlights?: string;
+    rules?: string;
     structure?: string;
 }
+export interface Fact {
+    category?: string;
+    statement: string;
+    subject?: string;
+    value?: string;
+}
+/**
+ * Scoring metadata for knowledge lifecycle management (FinMem-inspired).
+ * Stored in YAML frontmatter alongside existing fields.
+ */
+export interface FrontmatterScoring {
+    accessCount?: number;
+    createdAt?: string;
+    importance?: number;
+    maturity?: 'core' | 'draft' | 'validated';
+    recency?: number;
+    updateCount?: number;
+    updatedAt?: string;
+}
 export interface ContextData {
+    facts?: Fact[];
+    keywords: string[];
     name: string;
     narrative?: Narrative;
     rawConcept?: RawConcept;
     relations?: string[];
+    scoring?: FrontmatterScoring;
     snippets: string[];
+    tags: string[];
+}
+interface Frontmatter {
+    accessCount?: number;
+    createdAt?: string;
+    importance?: number;
+    keywords: string[];
+    maturity?: 'core' | 'draft' | 'validated';
+    recency?: number;
+    related: string[];
+    tags: string[];
+    title?: string;
+    updateCount?: number;
+    updatedAt?: string;
 }
+/**
+ * Parse content extracting relations from either frontmatter or legacy @ format.
+ * Returns parsed frontmatter metadata and the body content for further parsing.
+ */
+/**
+ * Extract scoring metadata from parsed frontmatter.
+ * Returns defaults for missing fields.
+ */
+export declare function extractScoring(fm: Frontmatter): FrontmatterScoring;
+/**
+ * Parse frontmatter from raw markdown content and return scoring metadata.
+ * Exported for use by search-knowledge-service to extract scoring without
+ * going through the full parseContent path.
+ */
+export declare function parseFrontmatterScoring(content: string): FrontmatterScoring | undefined;
+/**
+ * Replace scoring fields in existing markdown content without touching the body.
+ * If no frontmatter exists, returns the original content unchanged.
+ */
+export declare function updateScoringInContent(content: string, scoring: FrontmatterScoring): string;
 export declare const MarkdownWriter: {
     generateContext(data: ContextData): string;
     mergeContexts(sourceContent: string, targetContent: string): string;
     parseContent(content: string, name?: string): ContextData;
 };
+export {};