byterover-cli 0.4.1 → 1.0.0

package/dist/infra/cipher/system-prompt/contributor-schemas.js

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+/**
+ * Base schema for all contributor configurations.
+ */
+const BaseContributorSchema = z.object({
+    enabled: z.boolean().optional().default(true).describe('Whether this contributor is enabled'),
+    id: z.string().min(1).describe('Unique identifier for this contributor'),
+    priority: z.number().int().nonnegative().describe('Execution priority (lower = first)'),
+});
+/**
+ * Schema for static contributors.
+ * Returns inline content directly.
+ */
+export const StaticContributorConfigSchema = BaseContributorSchema.extend({
+    content: z.string().min(1).describe('Static content to include in the prompt'),
+    type: z.literal('static'),
+}).strict();
+/**
+ * Schema for file contributors.
+ * Loads content from YAML files.
+ */
+export const FileContributorConfigSchema = BaseContributorSchema.extend({
+    filepath: z.string().min(1).describe('Path to YAML prompt file'),
+    options: z
+        .object({
+        cache: z.boolean().optional().default(true).describe('Whether to cache file contents'),
+        validateMtime: z.boolean().optional().default(true).describe('Whether to validate file modification time'),
+    })
+        .strict()
+        .optional(),
+    type: z.literal('file'),
+}).strict();
+/**
+ * Schema for memory contributor options.
+ */
+export const MemoryContributorOptionsSchema = z
+    .object({
+    includeTags: z.boolean().optional().default(true).describe('Whether to include tags in memory display'),
+    limit: z.number().int().positive().optional().default(20).describe('Maximum number of memories to include'),
+    pinnedOnly: z.boolean().optional().default(false).describe('Only include pinned memories'),
+})
+    .strict();
+/**
+ * Schema for memory contributors.
+ * Loads memories from the memory manager.
+ */
+export const MemoryContributorConfigSchema = BaseContributorSchema.extend({
+    options: MemoryContributorOptionsSchema.optional(),
+    type: z.literal('memory'),
+}).strict();
+/**
+ * Schema for environment contributors.
+ * Provides environment context (working directory, git status, etc.).
+ */
+export const EnvironmentContributorConfigSchema = BaseContributorSchema.extend({
+    type: z.literal('environment'),
+}).strict();
+/**
+ * Schema for datetime contributors.
+ * Provides current date and time.
+ */
+export const DateTimeContributorConfigSchema = BaseContributorSchema.extend({
+    type: z.literal('dateTime'),
+}).strict();
+/**
+ * Discriminated union schema for all contributor configurations.
+ */
+export const ContributorConfigSchema = z
+    .discriminatedUnion('type', [
+    StaticContributorConfigSchema,
+    FileContributorConfigSchema,
+    MemoryContributorConfigSchema,
+    EnvironmentContributorConfigSchema,
+    DateTimeContributorConfigSchema,
+])
+    .describe('System prompt contributor configuration');
+/**
+ * Schema for the system prompt manager configuration.
+ */
+export const SystemPromptManagerConfigSchema = z
+    .object({
+    contributors: z.array(ContributorConfigSchema).min(1).describe('Array of contributor configurations'),
+})
+    .strict()
+    .describe('System prompt manager configuration');

package/dist/infra/cipher/system-prompt/contributors/agent-prompt-contributor.d.ts

@@ -0,0 +1,59 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Options for agent prompt contributor configuration.
+ */
+export interface AgentPromptContributorOptions {
+    /** Base path for resolving relative file paths */
+    basePath?: string;
+    /** Whether to cache file contents (default: true) */
+    cache?: boolean;
+}
+/**
+ * Agent prompt contributor that loads agent-specific prompts from YAML files.
+ *
+ * This contributor reads the agent's prompt configuration from the agent registry
+ * and loads the corresponding YAML prompt file. It supports:
+ * - Loading prompts from the agent's `promptFile` configuration
+ * - Falling back to inline `prompt` if no promptFile is specified
+ * - Caching loaded prompts for performance
+ *
+ * The agent name is typically passed via the ContributorContext.
+ */
+export declare class AgentPromptContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly basePath;
+    private readonly cache;
+    private readonly useCache;
+    /**
+     * Creates a new agent prompt contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id: string, priority: number, options?: AgentPromptContributorOptions);
+    /**
+     * Loads and returns the agent-specific prompt content.
+     *
+     * The agent name should be provided in the context. If no agent name
+     * is specified, or the agent has no prompt configured, returns an empty string.
+     *
+     * @param context - Contributor context with agent name
+     * @returns Agent prompt content string
+     */
+    getContent(context: ContributorContext): Promise<string>;
+    /**
+     * Invalidate the cache for a specific file.
+     *
+     * @param filepath - Path to the file to invalidate
+     */
+    invalidateCache(filepath?: string): void;
+    /**
+     * Load prompt content from a YAML file.
+     *
+     * @param filepath - Path to the YAML prompt file
+     * @returns Prompt content string
+     */
+    private loadPromptFile;
+}

package/dist/infra/cipher/system-prompt/contributors/agent-prompt-contributor.js

@@ -0,0 +1,131 @@
+import { load as loadYaml } from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+import { getAgentRegistry } from '../../../../core/domain/cipher/agent/agent-registry.js';
+import { SystemPromptError } from '../../../../core/domain/cipher/errors/system-prompt-error.js';
+import { PromptCache } from '../prompt-cache.js';
+import { PromptConfigSchema } from '../schemas.js';
+/**
+ * Agent prompt contributor that loads agent-specific prompts from YAML files.
+ *
+ * This contributor reads the agent's prompt configuration from the agent registry
+ * and loads the corresponding YAML prompt file. It supports:
+ * - Loading prompts from the agent's `promptFile` configuration
+ * - Falling back to inline `prompt` if no promptFile is specified
+ * - Caching loaded prompts for performance
+ *
+ * The agent name is typically passed via the ContributorContext.
+ */
+export class AgentPromptContributor {
+    id;
+    priority;
+    basePath;
+    cache;
+    useCache;
+    /**
+     * Creates a new agent prompt contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id, priority, options = {}) {
+        this.id = id;
+        this.priority = priority;
+        this.basePath = options.basePath ?? '';
+        this.useCache = options.cache ?? true;
+        this.cache = new PromptCache({
+            maxSize: 20,
+            validateMtime: true,
+        });
+    }
+    /**
+     * Loads and returns the agent-specific prompt content.
+     *
+     * The agent name should be provided in the context. If no agent name
+     * is specified, or the agent has no prompt configured, returns an empty string.
+     *
+     * @param context - Contributor context with agent name
+     * @returns Agent prompt content string
+     */
+    async getContent(context) {
+        // Get agent name from context (extended property)
+        const { agentName } = context;
+        if (!agentName) {
+            // No agent specified, return empty
+            return '';
+        }
+        // Get agent from registry
+        const registry = getAgentRegistry();
+        const agent = registry.get(agentName);
+        if (!agent) {
+            // Unknown agent, return empty
+            return '';
+        }
+        // Check for inline prompt first (takes precedence if promptFile is not specified)
+        if (agent.prompt && !agent.promptFile) {
+            return agent.prompt;
+        }
+        // Load from promptFile if specified
+        if (agent.promptFile) {
+            return this.loadPromptFile(agent.promptFile);
+        }
+        // No prompt configured for this agent
+        return '';
+    }
+    /**
+     * Invalidate the cache for a specific file.
+     *
+     * @param filepath - Path to the file to invalidate
+     */
+    invalidateCache(filepath) {
+        if (filepath) {
+            const fullPath = this.basePath ? path.join(this.basePath, filepath) : filepath;
+            this.cache.invalidate(fullPath);
+        }
+    }
+    /**
+     * Load prompt content from a YAML file.
+     *
+     * @param filepath - Path to the YAML prompt file
+     * @returns Prompt content string
+     */
+    loadPromptFile(filepath) {
+        const fullPath = this.basePath ? path.join(this.basePath, filepath) : filepath;
+        // Check cache first
+        if (this.useCache) {
+            const cached = this.cache.get(fullPath);
+            if (cached?.prompt) {
+                return cached.prompt;
+            }
+        }
+        // Load from file
+        if (!fs.existsSync(fullPath)) {
+            throw SystemPromptError.fileNotFound(fullPath);
+        }
+        let yamlContent;
+        try {
+            yamlContent = fs.readFileSync(fullPath, 'utf8');
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            throw SystemPromptError.fileReadFailed(fullPath, reason);
+        }
+        const rawConfig = loadYaml(yamlContent);
+        // Validate with Zod schema
+        const parseResult = PromptConfigSchema.safeParse(rawConfig);
+        if (!parseResult.success) {
+            const errorMessages = parseResult.error.errors.map((err) => `${err.path.join('.')}: ${err.message}`).join('; ');
+            throw SystemPromptError.configInvalid(errorMessages, parseResult.error.errors);
+        }
+        const config = parseResult.data;
+        if (!config.prompt) {
+            throw SystemPromptError.configMissingField('prompt', fullPath);
+        }
+        // Cache the config
+        if (this.useCache) {
+            this.cache.set(fullPath, config);
+        }
+        return config.prompt;
+    }
+}

package/dist/infra/cipher/system-prompt/contributors/companion-contributor.d.ts

@@ -0,0 +1,54 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Options for companion contributor configuration.
+ */
+export interface CompanionContributorOptions {
+    /** Base path for resolving relative file paths */
+    basePath?: string;
+}
+/**
+ * Companion contributor that discovers and loads companion prompts.
+ *
+ * Discovers files matching the pattern `{commandType}-*.yml` and
+ * loads their prompt content.
+ *
+ * Features:
+ * - Automatic discovery of companion prompts by commandType
+ * - Loads and concatenates multiple companion files
+ * - Graceful handling of missing files
+ */
+export declare class CompanionContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly basePath;
+    /**
+     * Creates a new companion contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id: string, priority: number, options?: CompanionContributorOptions);
+    /**
+     * Discovers and loads companion prompts based on commandType.
+     *
+     * @param context - Contributor context with commandType
+     * @returns Concatenated companion prompt content
+     */
+    getContent(context: ContributorContext): Promise<string>;
+    /**
+     * Discover companion prompt files for a given commandType.
+     * Looks for files matching the pattern: {commandType}-*.yml
+     *
+     * @param commandType - The command type (e.g., 'query', 'curate')
+     * @returns Array of filenames matching the pattern
+     */
+    private discoverCompanionPrompts;
+    /**
+     * Load and parse a prompt YAML file.
+     *
+     * @param filename - Filename to load
+     * @returns Prompt content or null if not found
+     */
+    private loadPromptFile;
+}

package/dist/infra/cipher/system-prompt/contributors/companion-contributor.js

@@ -0,0 +1,107 @@
+import { load as loadYaml } from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { SystemPromptError } from '../../../../core/domain/cipher/errors/system-prompt-error.js';
+/**
+ * Companion contributor that discovers and loads companion prompts.
+ *
+ * Discovers files matching the pattern `{commandType}-*.yml` and
+ * loads their prompt content.
+ *
+ * Features:
+ * - Automatic discovery of companion prompts by commandType
+ * - Loads and concatenates multiple companion files
+ * - Graceful handling of missing files
+ */
+export class CompanionContributor {
+    id;
+    priority;
+    basePath;
+    /**
+     * Creates a new companion contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id, priority, options = {}) {
+        this.id = id;
+        this.priority = priority;
+        // Default to resources/prompts directory
+        const currentDir = path.dirname(fileURLToPath(import.meta.url));
+        this.basePath = options.basePath ?? path.join(currentDir, '../../../../resources/prompts');
+    }
+    /**
+     * Discovers and loads companion prompts based on commandType.
+     *
+     * @param context - Contributor context with commandType
+     * @returns Concatenated companion prompt content
+     */
+    async getContent(context) {
+        if (!context.commandType) {
+            return '';
+        }
+        const companionFiles = this.discoverCompanionPrompts(context.commandType);
+        if (companionFiles.length === 0) {
+            return '';
+        }
+        const contents = [];
+        for (const filename of companionFiles) {
+            try {
+                const content = this.loadPromptFile(filename);
+                if (content) {
+                    contents.push(content);
+                }
+            }
+            catch {
+                // Silently skip files that fail to load
+            }
+        }
+        return contents.join('\n\n');
+    }
+    /**
+     * Discover companion prompt files for a given commandType.
+     * Looks for files matching the pattern: {commandType}-*.yml
+     *
+     * @param commandType - The command type (e.g., 'query', 'curate')
+     * @returns Array of filenames matching the pattern
+     */
+    discoverCompanionPrompts(commandType) {
+        const companionPrompts = [];
+        try {
+            const files = fs.readdirSync(this.basePath);
+            const pattern = new RegExp(`^${commandType}-.*\\.yml$`);
+            const matchingFiles = files.filter((file) => pattern.test(file));
+            for (const file of matchingFiles) {
+                companionPrompts.push(file);
+            }
+        }
+        catch {
+            // Return empty array if directory doesn't exist or can't be read
+        }
+        return companionPrompts.sort();
+    }
+    /**
+     * Load and parse a prompt YAML file.
+     *
+     * @param filename - Filename to load
+     * @returns Prompt content or null if not found
+     */
+    loadPromptFile(filename) {
+        const fullPath = path.join(this.basePath, filename);
+        if (!fs.existsSync(fullPath)) {
+            return null;
+        }
+        let yamlContent;
+        try {
+            yamlContent = fs.readFileSync(fullPath, 'utf8');
+        }
+        catch (error) {
+            const reason = error instanceof Error ? error.message : String(error);
+            throw SystemPromptError.fileReadFailed(fullPath, reason);
+        }
+        const config = loadYaml(yamlContent);
+        return config.prompt ?? null;
+    }
+}

package/dist/infra/cipher/system-prompt/contributors/context-tree-structure-contributor.d.ts

@@ -0,0 +1,68 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Options for context tree structure contributor.
+ */
+export interface ContextTreeStructureContributorOptions {
+    /** Maximum depth for traversing the context tree (default: 5) */
+    maxDepth?: number;
+    /** Maximum number of entries to include (default: 200) */
+    maxEntries?: number;
+    /** Working directory path (default: process.cwd()) */
+    workingDirectory?: string;
+}
+/**
+ * Context tree structure contributor that injects the .brv/context-tree structure
+ * into the system prompt for query and curate commands.
+ *
+ * This gives the plan agent and sub-agents immediate awareness of available
+ * context files before performing any search operations.
+ *
+ * Based on Anthropic's best practices for context engineering:
+ * - Pre-injecting structural context reduces search iterations
+ * - Agents can make better decisions about where to look
+ * - Reduces token waste from exploratory searches
+ */
+export declare class ContextTreeStructureContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly maxDepth;
+    private readonly maxEntries;
+    private readonly workingDirectory;
+    /**
+     * Creates a new context tree structure contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id: string, priority: number, options?: ContextTreeStructureContributorOptions);
+    /**
+     * Generates the context tree structure content.
+     *
+     * Only generates content for query and curate commands where
+     * context tree awareness is important for the agent's operation.
+     *
+     * @param context - Contributor context with command type
+     * @returns Formatted context tree structure, or empty string if not applicable
+     */
+    getContent(context: ContributorContext): Promise<string>;
+    /**
+     * Builds the context tree structure as a formatted string.
+     *
+     * @param contextTreePath - Path to the context tree directory
+     * @returns Formatted context tree structure
+     */
+    private buildContextTreeStructure;
+    /**
+     * Builds a message when the context tree is empty.
+     */
+    private buildEmptyContextTreeMessage;
+    /**
+     * Builds a message when no context tree exists.
+     */
+    private buildNoContextTreeMessage;
+    /**
+     * Recursively traverses the context tree and builds the structure lines.
+     */
+    private traverseContextTree;
+}

package/dist/infra/cipher/system-prompt/contributors/context-tree-structure-contributor.js

@@ -0,0 +1,179 @@
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Context tree structure contributor that injects the .brv/context-tree structure
+ * into the system prompt for query and curate commands.
+ *
+ * This gives the plan agent and sub-agents immediate awareness of available
+ * context files before performing any search operations.
+ *
+ * Based on Anthropic's best practices for context engineering:
+ * - Pre-injecting structural context reduces search iterations
+ * - Agents can make better decisions about where to look
+ * - Reduces token waste from exploratory searches
+ */
+export class ContextTreeStructureContributor {
+    id;
+    priority;
+    maxDepth;
+    maxEntries;
+    workingDirectory;
+    /**
+     * Creates a new context tree structure contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id, priority, options = {}) {
+        this.id = id;
+        this.priority = priority;
+        this.maxDepth = options.maxDepth ?? 5;
+        this.maxEntries = options.maxEntries ?? 200;
+        this.workingDirectory = options.workingDirectory ?? process.cwd();
+    }
+    /**
+     * Generates the context tree structure content.
+     *
+     * Only generates content for query and curate commands where
+     * context tree awareness is important for the agent's operation.
+     *
+     * @param context - Contributor context with command type
+     * @returns Formatted context tree structure, or empty string if not applicable
+     */
+    async getContent(context) {
+        // Only inject for query and curate commands
+        if (context.commandType !== 'query' && context.commandType !== 'curate') {
+            return '';
+        }
+        const contextTreePath = path.join(this.workingDirectory, '.brv', 'context-tree');
+        // Check if context tree exists
+        if (!fs.existsSync(contextTreePath)) {
+            return this.buildNoContextTreeMessage();
+        }
+        return this.buildContextTreeStructure(contextTreePath);
+    }
+    /**
+     * Builds the context tree structure as a formatted string.
+     *
+     * @param contextTreePath - Path to the context tree directory
+     * @returns Formatted context tree structure
+     */
+    buildContextTreeStructure(contextTreePath) {
+        const entriesCount = { value: 0 };
+        const truncatedCount = { value: 0 };
+        const lines = [];
+        // Build the tree
+        this.traverseContextTree({
+            currentDepth: 0,
+            dir: contextTreePath,
+            entriesCount,
+            lines,
+            maxDepth: this.maxDepth,
+            maxEntries: this.maxEntries,
+            relativePath: '',
+            truncatedCount,
+        });
+        if (lines.length === 0) {
+            return this.buildEmptyContextTreeMessage();
+        }
+        // Build the final output
+        const parts = [
+            '<context-tree-structure>',
+            '## Current Context Tree Structure',
+            '',
+            'The following is the current hierarchy of curated knowledge in `.brv/context-tree/`:',
+            '',
+            '```',
+            '.brv/context-tree/',
+            ...lines,
+            '```',
+        ];
+        if (truncatedCount.value > 0) {
+            parts.push('', `[${truncatedCount.value} additional entries not shown]`);
+        }
+        parts.push('', '## Structure Guide', '- Each top-level folder is a **domain** (e.g., `code_style/`, `design/`, `structure/`)', '- Inside domains are **topics** as `.md` files or subfolders with `context.md`', '- `context.md` files contain the curated knowledge content', '', '## Usage', '- **Query commands**: Search ONLY within this context tree structure', '- **Curate commands**: Check existing content here before creating new topics', '</context-tree-structure>');
+        return parts.join('\n');
+    }
+    /**
+     * Builds a message when the context tree is empty.
+     */
+    buildEmptyContextTreeMessage() {
+        return [
+            '<context-tree-structure>',
+            '## Context Tree Status: Empty',
+            '',
+            'The context tree at `.brv/context-tree/` exists but contains no curated content yet.',
+            '',
+            '**For curate commands**: You can create new knowledge topics in any domain.',
+            '**For query commands**: No context is available to search.',
+            '</context-tree-structure>',
+        ].join('\n');
+    }
+    /**
+     * Builds a message when no context tree exists.
+     */
+    buildNoContextTreeMessage() {
+        return [
+            '<context-tree-structure>',
+            '## Context Tree Status: Not Initialized',
+            '',
+            'The `.brv/context-tree/` directory does not exist.',
+            'Run `/init` to initialize the ByteRover project and create the context tree.',
+            '</context-tree-structure>',
+        ].join('\n');
+    }
+    /**
+     * Recursively traverses the context tree and builds the structure lines.
+     */
+    traverseContextTree(options) {
+        const { currentDepth, dir, entriesCount, lines, maxDepth, maxEntries, relativePath, truncatedCount } = options;
+        if (currentDepth >= maxDepth) {
+            return;
+        }
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        // Filter and sort: directories first, then alphabetically
+        const filteredEntries = entries
+            .filter((entry) => !entry.name.startsWith('.'))
+            .sort((a, b) => {
+            if (a.isDirectory() && !b.isDirectory())
+                return -1;
+            if (!a.isDirectory() && b.isDirectory())
+                return 1;
+            return a.name.localeCompare(b.name);
+        });
+        const indent = '  '.repeat(currentDepth + 1);
+        for (const entry of filteredEntries) {
+            if (entriesCount.value >= maxEntries) {
+                truncatedCount.value += filteredEntries.length - filteredEntries.indexOf(entry);
+                break;
+            }
+            entriesCount.value++;
+            const entryRelativePath = relativePath ? `${relativePath}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                lines.push(`${indent}${entry.name}/`);
+                this.traverseContextTree({
+                    currentDepth: currentDepth + 1,
+                    dir: path.join(dir, entry.name),
+                    entriesCount,
+                    lines,
+                    maxDepth,
+                    maxEntries,
+                    relativePath: entryRelativePath,
+                    truncatedCount,
+                });
+            }
+            else {
+                // Add annotation for context.md files
+                const annotation = entry.name === 'context.md' ? ' (knowledge content)' : '';
+                lines.push(`${indent}${entry.name}${annotation}`);
+            }
+        }
+    }
+}