byterover-cli 0.4.0 → 1.0.0

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

@@ -0,0 +1,25 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * DateTime contributor that provides current date and time.
+ *
+ * Returns the current date/time in ISO format wrapped in XML tags
+ * for clear delineation in the system prompt.
+ */
+export declare class DateTimeContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    /**
+     * Creates a new datetime contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     */
+    constructor(id: string, priority: number);
+    /**
+     * Returns the current date and time in ISO format.
+     *
+     * @param _context - Contributor context (unused)
+     * @returns Formatted datetime string with XML tags
+     */
+    getContent(_context: ContributorContext): Promise<string>;
+}

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

@@ -0,0 +1,29 @@
+/**
+ * DateTime contributor that provides current date and time.
+ *
+ * Returns the current date/time in ISO format wrapped in XML tags
+ * for clear delineation in the system prompt.
+ */
+export class DateTimeContributor {
+    id;
+    priority;
+    /**
+     * Creates a new datetime contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     */
+    constructor(id, priority) {
+        this.id = id;
+        this.priority = priority;
+    }
+    /**
+     * Returns the current date and time in ISO format.
+     *
+     * @param _context - Contributor context (unused)
+     * @returns Formatted datetime string with XML tags
+     */
+    async getContent(_context) {
+        return `<dateTime>Current date and time: ${new Date().toISOString()}</dateTime>`;
+    }
+}

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

@@ -0,0 +1,25 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Environment contributor that provides environment context.
+ *
+ * Formats the environment context (working directory, git status,
+ * platform info, file tree, etc.) for inclusion in the system prompt.
+ */
+export declare class EnvironmentContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    /**
+     * Creates a new environment contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     */
+    constructor(id: string, priority: number);
+    /**
+     * Formats and returns the environment context.
+     *
+     * @param context - Contributor context with environment context
+     * @returns Formatted environment context string, or empty string if not available
+     */
+    getContent(context: ContributorContext): Promise<string>;
+}

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

@@ -0,0 +1,54 @@
+/**
+ * Environment contributor that provides environment context.
+ *
+ * Formats the environment context (working directory, git status,
+ * platform info, file tree, etc.) for inclusion in the system prompt.
+ */
+export class EnvironmentContributor {
+    id;
+    priority;
+    /**
+     * Creates a new environment contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     */
+    constructor(id, priority) {
+        this.id = id;
+        this.priority = priority;
+    }
+    /**
+     * Formats and returns the environment context.
+     *
+     * @param context - Contributor context with environment context
+     * @returns Formatted environment context string, or empty string if not available
+     */
+    async getContent(context) {
+        if (!context.environmentContext) {
+            return '';
+        }
+        const env = context.environmentContext;
+        const dateOptions = {
+            day: 'numeric',
+            month: 'short',
+            weekday: 'short',
+            year: 'numeric',
+        };
+        const formattedDate = new Date().toLocaleDateString('en-US', dateOptions);
+        let result = '<env>\n';
+        result += `  Working directory: ${env.workingDirectory}\n`;
+        result += `  Is directory a git repo: ${env.isGitRepository ? 'Yes' : 'No'}\n`;
+        result += `  Platform: ${env.platform}\n`;
+        result += `  OS Version: ${env.osVersion}\n`;
+        result += `  Node Version: ${env.nodeVersion}\n`;
+        result += `  Today's date: ${formattedDate}\n`;
+        result += '</env>';
+        if (env.fileTree) {
+            result += '\n\n' + env.fileTree;
+        }
+        if (env.brvStructure) {
+            result += '\n\n' + env.brvStructure;
+        }
+        return result;
+    }
+}

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

@@ -0,0 +1,60 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Options for file contributor configuration.
+ */
+export interface FileContributorOptions {
+    /** Base path for resolving relative file paths */
+    basePath?: string;
+    /** Whether to cache file contents (default: true) */
+    cache?: boolean;
+    /** Whether to render template variables (default: false) */
+    renderTemplate?: boolean;
+    /** Whether to validate file modification time (default: true) */
+    validateMtime?: boolean;
+}
+/**
+ * File contributor that loads prompt content from YAML files.
+ *
+ * Features:
+ * - Loads and parses YAML prompt files
+ * - Validates content using Zod schema
+ * - Caches content with optional mtime validation
+ */
+export declare class FileContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly basePath;
+    private readonly cache;
+    private readonly filepath;
+    private readonly renderTemplate;
+    private readonly useCache;
+    private readonly validateMtime;
+    /**
+     * Creates a new file contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param filepath - Path to the YAML prompt file
+     * @param options - Configuration options
+     */
+    constructor(id: string, priority: number, filepath: string, options?: FileContributorOptions);
+    /**
+     * Loads and returns the prompt content from the file.
+     *
+     * @param context - Contributor context with template variables
+     * @returns Prompt content string
+     */
+    getContent(context: ContributorContext): Promise<string>;
+    /**
+     * Invalidate the cache for this contributor's file.
+     */
+    invalidateCache(): void;
+    /**
+     * Render template variables in the prompt content.
+     *
+     * @param template - Template string with {{variable}} placeholders
+     * @param context - Contributor context with values
+     * @returns Rendered string
+     */
+    private renderTemplateVariables;
+}

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

@@ -0,0 +1,128 @@
+import { load as loadYaml } from 'js-yaml';
+import fs from 'node:fs';
+import path from 'node:path';
+import { SystemPromptError } from '../../../../core/domain/cipher/errors/system-prompt-error.js';
+import { PromptCache } from '../prompt-cache.js';
+import { PromptConfigSchema } from '../schemas.js';
+/**
+ * File contributor that loads prompt content from YAML files.
+ *
+ * Features:
+ * - Loads and parses YAML prompt files
+ * - Validates content using Zod schema
+ * - Caches content with optional mtime validation
+ */
+export class FileContributor {
+    id;
+    priority;
+    basePath;
+    cache;
+    filepath;
+    renderTemplate;
+    useCache;
+    validateMtime;
+    /**
+     * Creates a new file contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param filepath - Path to the YAML prompt file
+     * @param options - Configuration options
+     */
+    constructor(id, priority, filepath, options = {}) {
+        this.id = id;
+        this.priority = priority;
+        this.filepath = filepath;
+        this.basePath = options.basePath ?? '';
+        this.useCache = options.cache ?? true;
+        this.renderTemplate = options.renderTemplate ?? false;
+        this.validateMtime = options.validateMtime ?? true;
+        this.cache = new PromptCache({
+            maxSize: 50,
+            validateMtime: this.validateMtime,
+        });
+    }
+    /**
+     * Loads and returns the prompt content from the file.
+     *
+     * @param context - Contributor context with template variables
+     * @returns Prompt content string
+     */
+    async getContent(context) {
+        const fullPath = this.basePath ? path.join(this.basePath, this.filepath) : this.filepath;
+        // Check cache first (only for raw content, not rendered)
+        let prompt;
+        if (this.useCache) {
+            const cached = this.cache.get(fullPath);
+            if (cached?.prompt) {
+                prompt = cached.prompt;
+            }
+        }
+        // Load from file if not cached
+        if (!prompt) {
+            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);
+            }
+            prompt = config.prompt;
+        }
+        // Render template if enabled
+        if (this.renderTemplate) {
+            return this.renderTemplateVariables(prompt, context);
+        }
+        return prompt;
+    }
+    /**
+     * Invalidate the cache for this contributor's file.
+     */
+    invalidateCache() {
+        const fullPath = this.basePath ? path.join(this.basePath, this.filepath) : this.filepath;
+        this.cache.invalidate(fullPath);
+    }
+    /**
+     * Render template variables in the prompt content.
+     *
+     * @param template - Template string with {{variable}} placeholders
+     * @param context - Contributor context with values
+     * @returns Rendered string
+     */
+    renderTemplateVariables(template, context) {
+        let result = template;
+        // Build variables from context
+        /* eslint-disable camelcase */
+        const variables = {
+            available_markers: context.availableMarkers ? Object.keys(context.availableMarkers).join(', ') : '',
+            available_tools: context.availableTools?.join(', ') ?? '',
+            datetime: `<dateTime>Current date and time: ${new Date().toISOString()}</dateTime>`,
+        };
+        /* eslint-enable camelcase */
+        // Replace {{variable}} with values
+        for (const [key, value] of Object.entries(variables)) {
+            const regex = new RegExp(`{{\\s*${key}\\s*}}`, 'g');
+            result = result.replaceAll(regex, value ?? '');
+        }
+        return result;
+    }
+}

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

@@ -0,0 +1,13 @@
+export { AgentPromptContributor } from './agent-prompt-contributor.js';
+export type { AgentPromptContributorOptions } from './agent-prompt-contributor.js';
+export { CompanionContributor } from './companion-contributor.js';
+export type { CompanionContributorOptions } from './companion-contributor.js';
+export { ContextTreeStructureContributor } from './context-tree-structure-contributor.js';
+export type { ContextTreeStructureContributorOptions } from './context-tree-structure-contributor.js';
+export { DateTimeContributor } from './datetime-contributor.js';
+export { EnvironmentContributor } from './environment-contributor.js';
+export { FileContributor } from './file-contributor.js';
+export type { FileContributorOptions } from './file-contributor.js';
+export { MemoryContributor } from './memory-contributor.js';
+export type { MemoryContributorOptions } from './memory-contributor.js';
+export { StaticContributor } from './static-contributor.js';

package/dist/infra/cipher/system-prompt/contributors/index.js

@@ -0,0 +1,8 @@
+export { AgentPromptContributor } from './agent-prompt-contributor.js';
+export { CompanionContributor } from './companion-contributor.js';
+export { ContextTreeStructureContributor } from './context-tree-structure-contributor.js';
+export { DateTimeContributor } from './datetime-contributor.js';
+export { EnvironmentContributor } from './environment-contributor.js';
+export { FileContributor } from './file-contributor.js';
+export { MemoryContributor } from './memory-contributor.js';
+export { StaticContributor } from './static-contributor.js';

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

@@ -0,0 +1,40 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Options for memory contributor configuration.
+ */
+export interface MemoryContributorOptions {
+    /** Whether to include tags in memory display (default: true) */
+    includeTags?: boolean;
+    /** Maximum number of memories to include (default: 20) */
+    limit?: number;
+    /** Only include pinned memories (default: false) */
+    pinnedOnly?: boolean;
+}
+/**
+ * Memory contributor that loads agent memories.
+ *
+ * Retrieves memories from the memory manager and formats them
+ * for inclusion in the system prompt.
+ */
+export declare class MemoryContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly includeTags;
+    private readonly limit;
+    private readonly pinnedOnly;
+    /**
+     * Creates a new memory contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param options - Configuration options
+     */
+    constructor(id: string, priority: number, options?: MemoryContributorOptions);
+    /**
+     * Loads and formats memories from the memory manager.
+     *
+     * @param context - Contributor context with memory manager
+     * @returns Formatted memories string, or empty string if no memories
+     */
+    getContent(context: ContributorContext): Promise<string>;
+}

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

@@ -0,0 +1,56 @@
+/**
+ * Memory contributor that loads agent memories.
+ *
+ * Retrieves memories from the memory manager and formats them
+ * for inclusion in the system prompt.
+ */
+export class MemoryContributor {
+    id;
+    priority;
+    includeTags;
+    limit;
+    pinnedOnly;
+    /**
+     * Creates a new memory 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.includeTags = options.includeTags ?? true;
+        this.limit = options.limit ?? 20;
+        this.pinnedOnly = options.pinnedOnly ?? false;
+    }
+    /**
+     * Loads and formats memories from the memory manager.
+     *
+     * @param context - Contributor context with memory manager
+     * @returns Formatted memories string, or empty string if no memories
+     */
+    async getContent(context) {
+        if (!context.memoryManager) {
+            return '';
+        }
+        try {
+            const memories = await context.memoryManager.list({
+                limit: this.limit,
+                ...(this.pinnedOnly && { pinned: true }),
+            });
+            if (!memories || memories.length === 0) {
+                return '';
+            }
+            const items = memories.map((memory) => {
+                const tags = this.includeTags && memory.tags?.length ? ` [${memory.tags.join(', ')}]` : '';
+                return `- ${memory.content}${tags}`;
+            });
+            return `\n# Agent Memories\n${items.join('\n')}\n`;
+        }
+        catch {
+            // Silently return empty string on error to not break prompt generation
+            return '';
+        }
+    }
+}

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

@@ -0,0 +1,26 @@
+import type { ContributorContext, SystemPromptContributor } from '../../../../core/domain/cipher/system-prompt/types.js';
+/**
+ * Static contributor that returns inline content.
+ *
+ * Use this for fixed prompt content that doesn't change at runtime.
+ */
+export declare class StaticContributor implements SystemPromptContributor {
+    readonly id: string;
+    readonly priority: number;
+    private readonly content;
+    /**
+     * Creates a new static contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param content - Static content to return
+     */
+    constructor(id: string, priority: number, content: string);
+    /**
+     * Returns the static content.
+     *
+     * @param _context - Contributor context (unused)
+     * @returns Static content string
+     */
+    getContent(_context: ContributorContext): Promise<string>;
+}

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

@@ -0,0 +1,31 @@
+/**
+ * Static contributor that returns inline content.
+ *
+ * Use this for fixed prompt content that doesn't change at runtime.
+ */
+export class StaticContributor {
+    id;
+    priority;
+    content;
+    /**
+     * Creates a new static contributor.
+     *
+     * @param id - Unique identifier for this contributor
+     * @param priority - Execution priority (lower = first)
+     * @param content - Static content to return
+     */
+    constructor(id, priority, content) {
+        this.id = id;
+        this.priority = priority;
+        this.content = content;
+    }
+    /**
+     * Returns the static content.
+     *
+     * @param _context - Contributor context (unused)
+     * @returns Static content string
+     */
+    async getContent(_context) {
+        return this.content;
+    }
+}

package/dist/infra/cipher/system-prompt/environment-context-builder.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Environment context information for system prompts.
+ * Provides the Cipher agent with awareness of its operating environment.
+ */
+export interface EnvironmentContext {
+    /** Formatted .brv directory structure explanation */
+    brvStructure: string;
+    /** Formatted project file tree */
+    fileTree: string;
+    /** Whether the working directory is a git repository */
+    isGitRepository: boolean;
+    /** Node.js version */
+    nodeVersion: string;
+    /** Operating system version */
+    osVersion: string;
+    /** Operating system platform (darwin, linux, win32) */
+    platform: string;
+    /** Absolute path to the working directory */
+    workingDirectory: string;
+}
+/**
+ * Options for building environment context.
+ * @deprecated Use ValidatedEnvironmentContextOptions from schemas.ts instead
+ */
+export interface EnvironmentContextOptions {
+    /** Whether to include .brv structure explanation (default: true) */
+    includeBrvStructure?: boolean;
+    /** Whether to include file tree (default: true) */
+    includeFileTree?: boolean;
+    /** Maximum depth for file tree traversal (default: 3) */
+    maxFileTreeDepth?: number;
+    /** Maximum number of entries in file tree (default: 100) */
+    maxFileTreeEntries?: number;
+    /** Working directory path */
+    workingDirectory: string;
+}
+/**
+ * Builds environment context for system prompts.
+ *
+ * Gathers information about:
+ * - Working directory
+ * - Git repository status
+ * - Platform and OS version
+ * - Project file tree
+ * - .brv directory structure
+ */
+export declare class EnvironmentContextBuilder {
+    /**
+     * Build the complete environment context.
+     *
+     * @param options - Configuration options
+     * @returns Environment context object
+     */
+    build(options: EnvironmentContextOptions): Promise<EnvironmentContext>;
+    /**
+     * Build an explanation of the .brv directory structure.
+     *
+     * @param dir - Working directory path
+     * @returns Formatted .brv structure explanation
+     */
+    private buildBrvStructure;
+    /**
+     * Build a formatted file tree of the project.
+     *
+     * @param dir - Root directory to start from
+     * @param maxDepth - Maximum traversal depth
+     * @param maxEntries - Maximum number of entries to include
+     * @returns Formatted file tree string
+     */
+    private buildFileTree;
+    /**
+     * Check if a directory is a git repository.
+     *
+     * @param dir - Directory path to check
+     * @returns True if the directory contains a .git folder
+     */
+    private detectGitRepository;
+    /**
+     * Get description for a .brv directory.
+     *
+     * @param name - Directory name
+     * @returns Description string
+     */
+    private getBrvDirectoryDescription;
+    /**
+     * Get description for a .brv file.
+     *
+     * @param name - File name
+     * @returns Description string
+     */
+    private getBrvFileDescription;
+    /**
+     * Check if a file or directory should be excluded from the tree.
+     *
+     * @param name - File or directory name
+     * @returns True if should be excluded
+     */
+    private shouldExclude;
+    /**
+     * Recursively traverse a directory and build tree lines.
+     *
+     * @param options - Traversal options
+     * @param options.dir - Current directory path
+     * @param options.maxDepth - Maximum depth to traverse
+     * @param options.maxEntries - Maximum entries to include
+     * @param options.currentDepth - Current traversal depth
+     * @param options.entriesCount - Counter for entries added (mutable object with value property)
+     * @param options.truncatedCount - Counter for truncated entries (mutable object with value property)
+     * @param options.lines - Array to append lines to
+     */
+    private traverseDirectory;
+}