byterover-cli 1.7.1 → 1.8.0

package/README.md

@@ -125,8 +125,9 @@ The terminal UI includes:
 - **Activity Log**: Real-time task status and execution progress
 - **Streaming Output**: Live responses with markdown rendering (headings, lists, blockquotes, code blocks)
 - **Reasoning Display**: View agent thinking process with streamed reasoning blocks
-- **File References**: Type `@` in curate mode to browse and attach files
-- **PDF Support**: Reference and extract text from PDF files using `@` (100 pages default, 200 max)
+- **File & Folder References**: Type `@` in curate mode to browse and attach files or entire folders
+- **PDF & Office Support**: Reference and extract text from PDF, Word (.docx), Excel (.xlsx), and PowerPoint (.pptx) files using `@` (PDF: 100 pages default, 200 max)
+- **Structured Content Preservation**: Curated context retains diagrams (Mermaid, PlantUML, ASCII art), tables, procedures, and code examples in full fidelity
 - **Dynamic Domains**: Automatically creates new knowledge domains as your context tree grows
 - **Session Persistence**: Sessions auto-resume after restart
 - **Expandable Views**: Press `Ctrl+O` to expand messages or logs to full-screen with vim-style navigation
@@ -140,9 +141,10 @@ The terminal UI includes:
 | `Ctrl+O` | Expand message or log to full-screen |
 | `j` / `k` | Scroll down/up in expanded view |
 | `g` / `G` | Jump to top/bottom in expanded view |
-| `Esc` or `q` | Exit expanded view |
+| `Esc` | Cancel streaming responses and long-running commands / exit expanded view |
+| `q` | Exit expanded view |
 | `/` | Show command suggestions |
-| `@` | Browse files (in curate mode) |
+| `@` | Browse files and folders (in curate mode) |
 
 ## CLI Commands
 
@@ -194,9 +196,17 @@ Get your API key at [app.byterover.dev/settings/keys](https://app.byterover.dev/
 
 **Curate flags:**
 - `-f, --files <path>`: Include specific files (max 5, can be repeated)
+- `-d, --folder <path>`: Folder path to pack and analyze (can be repeated)
 - `--headless`: Run in headless mode
 - `--format <text|json>`: Output format (default: text)
 
+**Curate examples:**
+```bash
+brv curate "Auth uses JWT with 24h expiry" -f src/middleware/auth.ts
+brv curate --folder src/auth/
+brv curate "Analyze auth module" -d src/auth/
+```
+
 ### Cloud Sync
 
 | Command | Description |
@@ -282,6 +292,11 @@ The context tree organizes knowledge into:
 - **Topics**: Specific subjects within domains (e.g., Authentication, Components)
 - **Context Files**: Markdown files containing your actual knowledge
 
+### Query Intelligence
+
+- **Tiered responses**: Queries are answered via a 4-tier system—cached results return instantly, high-confidence matches skip the LLM entirely, and complex queries use an optimized agentic loop
+- **Out-of-domain detection**: When a topic isn't covered in your context tree, ByteRover tells you clearly instead of guessing, and suggests using `/curate` to add the missing knowledge
+
 ## Supported AI Agents
 
 ByteRover integrates with 19 AI coding agents:
@@ -369,7 +384,7 @@ The model browser shows:
 | Command | Description |
 |---------|-------------|
 | `/status` | Show CLI status and project information |
-| `/curate [context] @files` | Curate context to the context tree |
+| `/curate [context] @files @folders` | Curate context to the context tree |
 | `/query <question>` | Query and retrieve information from the context tree |
 
 **Curate examples:**
@@ -377,6 +392,7 @@ The model browser shows:
 /curate                                    # Interactive mode
 /curate "Auth uses JWT tokens"             # Autonomous mode with text
 /curate "API docs" @src/api.ts @README.md  # With file references (max 5, supports PDF)
+/curate "Project structure" @src/          # With folder reference
 ```
 
 **Query example:**

package/dist/agent/core/domain/tools/constants.d.ts

@@ -3,29 +3,14 @@
  * These constants ensure type safety and prevent typos.
  */
 export declare const ToolName: {
-    readonly BASH_EXEC: 'bash_exec';
-    readonly BASH_OUTPUT: 'bash_output';
-    readonly BATCH: 'batch';
     readonly CODE_EXEC: 'code_exec';
-    readonly CREATE_KNOWLEDGE_TOPIC: 'create_knowledge_topic';
     readonly CURATE: 'curate';
-    readonly DELETE_MEMORY: 'delete_memory';
-    readonly EDIT_FILE: 'edit_file';
-    readonly EDIT_MEMORY: 'edit_memory';
     readonly GLOB_FILES: 'glob_files';
     readonly GREP_CONTENT: 'grep_content';
-    readonly KILL_PROCESS: 'kill_process';
     readonly LIST_DIRECTORY: 'list_directory';
-    readonly LIST_MEMORIES: 'list_memories';
     readonly READ_FILE: 'read_file';
-    readonly READ_MEMORY: 'read_memory';
-    readonly READ_TODOS: 'read_todos';
-    readonly SEARCH_HISTORY: 'search_history';
     readonly SEARCH_KNOWLEDGE: 'search_knowledge';
-    readonly SPEC_ANALYZE: 'spec_analyze';
     readonly WRITE_FILE: 'write_file';
-    readonly WRITE_MEMORY: 'write_memory';
-    readonly WRITE_TODOS: 'write_todos';
 };
 /**
  * Union type of all known tool names.

package/dist/agent/core/domain/tools/constants.js

@@ -3,27 +3,12 @@
  * These constants ensure type safety and prevent typos.
  */
 export const ToolName = {
-    BASH_EXEC: 'bash_exec',
-    BASH_OUTPUT: 'bash_output',
-    BATCH: 'batch',
     CODE_EXEC: 'code_exec',
-    CREATE_KNOWLEDGE_TOPIC: 'create_knowledge_topic',
     CURATE: 'curate',
-    DELETE_MEMORY: 'delete_memory',
-    EDIT_FILE: 'edit_file',
-    EDIT_MEMORY: 'edit_memory',
     GLOB_FILES: 'glob_files',
     GREP_CONTENT: 'grep_content',
-    KILL_PROCESS: 'kill_process',
     LIST_DIRECTORY: 'list_directory',
-    LIST_MEMORIES: 'list_memories',
     READ_FILE: 'read_file',
-    READ_MEMORY: 'read_memory',
-    READ_TODOS: 'read_todos',
-    SEARCH_HISTORY: 'search_history',
     SEARCH_KNOWLEDGE: 'search_knowledge',
-    SPEC_ANALYZE: 'spec_analyze',
     WRITE_FILE: 'write_file',
-    WRITE_MEMORY: 'write_memory',
-    WRITE_TODOS: 'write_todos',
 };

package/dist/agent/core/interfaces/i-cipher-agent.d.ts

@@ -15,6 +15,12 @@ export interface ExecutionContext {
     fileReferenceInstructions?: string;
     /** Whether running in JSON input mode (headless with conversation history) */
     isJsonInputMode?: boolean;
+    /** Override maxIterations for this execution (e.g., 2 for queries with pre-fetched context) */
+    maxIterations?: number;
+    /** Override maxTokens for this execution (e.g., 1024 for queries) */
+    maxTokens?: number;
+    /** Override temperature for this execution (e.g., 0.3 for factual queries) */
+    temperature?: number;
 }
 /**
  * Agent execution state (string union for external consumers).

package/dist/agent/core/interfaces/i-curate-service.d.ts

@@ -6,12 +6,20 @@
  * Raw concept metadata for a knowledge topic.
  */
 export interface CurateRawConcept {
+    /** Author or source attribution */
+    author?: string;
     /** What changes in the codebase are induced by this concept */
     changes?: string[];
     /** Which files are related to this concept */
     files?: string[];
     /** What is the flow included in this concept */
     flow?: string;
+    /** Regex or validation patterns with descriptions */
+    patterns?: Array<{
+        description: string;
+        flags?: string;
+        pattern: string;
+    }>;
     /** What is the task related to this concept */
     task?: string;
     /** When the concept was created or modified (ISO 8601 format) */
@@ -23,8 +31,12 @@ export interface CurateRawConcept {
 export interface CurateNarrative {
     /** Dependency management information */
     dependencies?: string;
+    /** Examples and use cases */
+    examples?: string;
     /** Feature documentation for this concept */
     features?: string;
+    /** Exact rules, constraints, or guidelines - preserved verbatim */
+    rules?: string;
     /** Code structure documentation */
     structure?: string;
 }

package/dist/agent/infra/llm/internal-llm-service.d.ts

@@ -62,6 +62,8 @@ export interface LLMServiceConfig {
  * - Handle retry logic (handled by RetryableContentGenerator decorator)
  */
 export declare class ByteRoverLLMService implements ILLMService {
+    /** Cached base system prompt (everything built by SystemPromptManager) for reuse across iterations */
+    private cachedBasePrompt;
     private readonly compactionService?;
     private readonly config;
     private readonly contextManager;
@@ -70,6 +72,8 @@ export declare class ByteRoverLLMService implements ILLMService {
     private readonly generator;
     private readonly logger;
     private readonly loopDetector;
+    /** Flag indicating memory was modified by tools during this task, requiring prompt rebuild */
+    private memoryDirtyFlag;
     private readonly memoryManager?;
     private readonly metadataHandler;
     private readonly mutex;
@@ -348,6 +352,15 @@ export declare class ByteRoverLLMService implements ILLMService {
      * @param taskId - Task ID from usecase for billing tracking (passed to subagents)
      */
     private handleToolCalls;
+    /**
+     * Replace the DateTime section in a cached system prompt with a fresh timestamp.
+     * DateTimeContributor wraps its output in <dateTime>...</dateTime> XML tags,
+     * enabling reliable regex replacement without rebuilding the entire prompt.
+     *
+     * @param cachedPrompt - Previously cached system prompt
+     * @returns Updated prompt with fresh DateTime
+     */
+    private refreshDateTime;
     /**
      * Validate LLM configuration using Zod schema.
      *

package/dist/agent/infra/llm/internal-llm-service.js

@@ -36,6 +36,8 @@ const TARGET_MESSAGE_TOKEN_UTILIZATION = 0.7;
  * - Handle retry logic (handled by RetryableContentGenerator decorator)
  */
 export class ByteRoverLLMService {
+    /** Cached base system prompt (everything built by SystemPromptManager) for reuse across iterations */
+    cachedBasePrompt = null;
     compactionService;
     config;
     contextManager;
@@ -44,6 +46,8 @@ export class ByteRoverLLMService {
     generator;
     logger;
     loopDetector;
+    /** Flag indicating memory was modified by tools during this task, requiring prompt rebuild */
+    memoryDirtyFlag = false;
     memoryManager;
     metadataHandler;
     mutex = new AsyncMutex();
@@ -148,13 +152,17 @@ export class ByteRoverLLMService {
      * @returns Final assistant response
      */
     async completeTask(textInput, options) {
+        // Reset per-task prompt cache (each task gets a fresh prompt on its first iteration)
+        this.cachedBasePrompt = null;
+        this.memoryDirtyFlag = false;
         // Extract options with defaults
         const { executionContext, fileData, imageData, signal, stream, taskId } = options ?? {};
         // Get filtered tools based on command type (e.g., only read-only tools for 'query')
         const toolSet = this.toolManager.getToolsForCommand(options?.executionContext?.commandType);
-        // Create state machine with configured limits
+        // Create state machine with configured limits (per-invocation overrides via ExecutionContext)
+        const effectiveMaxIterations = executionContext?.maxIterations ?? this.config.maxIterations;
         const maxTimeMs = this.config.timeout ?? 600_000; // 10 min default
-        const stateMachine = new AgentStateMachine(this.config.maxIterations, maxTimeMs);
+        const stateMachine = new AgentStateMachine(effectiveMaxIterations, maxTimeMs);
         stateMachine.transition(AgentState.EXECUTING);
         // Agentic loop with state machine
         while (!stateMachine.isTerminal()) {
@@ -295,10 +303,13 @@ export class ByteRoverLLMService {
     buildGenerateContentRequest(options) {
         // Get internal messages from context manager
         const messages = this.contextManager.getMessages();
+        // Apply per-invocation overrides from ExecutionContext (e.g., query-optimized config)
+        const effectiveMaxTokens = options.executionContext?.maxTokens ?? this.config.maxTokens;
+        const effectiveTemperature = options.executionContext?.temperature ?? this.config.temperature;
         return {
             config: {
-                maxTokens: this.config.maxTokens,
-                temperature: this.config.temperature,
+                maxTokens: effectiveMaxTokens,
+                temperature: effectiveTemperature,
             },
             contents: messages,
             executionContext: options.executionContext,
@@ -560,23 +571,35 @@ export class ByteRoverLLMService {
         for (const marker of markersSet) {
             availableMarkers[marker] = marker;
         }
-        // Build environment context for system prompt
-        const environmentContext = await this.environmentBuilder.build({
-            includeBrvStructure: true,
-            includeFileTree: true,
-            maxFileTreeDepth: 3,
-            maxFileTreeEntries: 100,
-            workingDirectory: this.workingDirectory,
-        });
-        let systemPrompt = await this.systemPromptManager.build({
-            availableMarkers,
-            availableTools,
-            commandType: executionContext?.commandType,
-            conversationMetadata: executionContext?.conversationMetadata,
-            environmentContext,
-            fileReferenceInstructions: executionContext?.fileReferenceInstructions,
-            memoryManager: this.memoryManager,
-        });
+        // Build base system prompt (cached across iterations within the same task)
+        const needsFullRebuild = iterationCount === 0 || this.cachedBasePrompt === null || this.memoryDirtyFlag;
+        let basePrompt;
+        if (needsFullRebuild) {
+            // Full rebuild: first iteration, no cache, or memory was modified by tools
+            const environmentContext = await this.environmentBuilder.build({
+                includeBrvStructure: true,
+                includeFileTree: true,
+                maxFileTreeDepth: 3,
+                maxFileTreeEntries: 100,
+                workingDirectory: this.workingDirectory,
+            });
+            basePrompt = await this.systemPromptManager.build({
+                availableMarkers,
+                availableTools,
+                commandType: executionContext?.commandType,
+                conversationMetadata: executionContext?.conversationMetadata,
+                environmentContext,
+                fileReferenceInstructions: executionContext?.fileReferenceInstructions,
+                memoryManager: this.memoryManager,
+            });
+            this.cachedBasePrompt = basePrompt;
+            this.memoryDirtyFlag = false;
+        }
+        else {
+            // Cache hit: reuse base prompt, only refresh the DateTime section
+            basePrompt = this.refreshDateTime(this.cachedBasePrompt);
+        }
+        let systemPrompt = basePrompt;
         // Determine which reflection prompt to add (only highest priority is chosen)
         const reflectionType = this.determineReflectionType(iterationCount, executionContext?.commandType);
         // Add reflection prompt if eligible (hierarchical: only one reflection per iteration)
@@ -939,6 +962,11 @@ export class ByteRoverLLMService {
             };
             this.contextManager.updateToolCallState(toolCall.id, runningState);
         }
+        // Check if any memory-modifying tools are being called (invalidates cached system prompt)
+        const memoryModifyingTools = new Set(['delete_memory', 'edit_memory', 'write_memory']);
+        if (lastMessage.toolCalls.some((tc) => memoryModifyingTools.has(tc.function.name))) {
+            this.memoryDirtyFlag = true;
+        }
         // Step 3: Execute all tool calls in parallel (pass taskId for subagent billing)
         const parallelResults = await Promise.allSettled(lastMessage.toolCalls.map((toolCall) => this.executeToolCallParallel(toolCall, taskId)));
         // Step 4: Update tool part states with results (in order)
@@ -1002,6 +1030,18 @@ export class ByteRoverLLMService {
             }
         }
     }
+    /**
+     * Replace the DateTime section in a cached system prompt with a fresh timestamp.
+     * DateTimeContributor wraps its output in <dateTime>...</dateTime> XML tags,
+     * enabling reliable regex replacement without rebuilding the entire prompt.
+     *
+     * @param cachedPrompt - Previously cached system prompt
+     * @returns Updated prompt with fresh DateTime
+     */
+    refreshDateTime(cachedPrompt) {
+        const freshDateTime = `<dateTime>Current date and time: ${new Date().toISOString()}</dateTime>`;
+        return cachedPrompt.replace(/<dateTime>[\S\s]*?<\/dateTime>/, freshDateTime);
+    }
     /**
      * Validate LLM configuration using Zod schema.
      *

package/dist/agent/infra/sandbox/local-sandbox.js

@@ -27,8 +27,15 @@ let esbuildModule;
  */
 function transpileTypeScript(code) {
     if (!esbuildModule) {
-        // Use esmRequire to load esbuild - works in both ESM and CJS environments
-        esbuildModule = esmRequire('esbuild');
+        try {
+            // Use esmRequire to load esbuild - works in both ESM and CJS environments
+            esbuildModule = esmRequire('esbuild');
+        }
+        catch (error) {
+            throw new Error('TypeScript transpilation is unavailable. The esbuild package is not installed.\n' +
+                'Please run: npm install esbuild\n' +
+                `Original error: ${error instanceof Error ? error.message : String(error)}`);
+        }
     }
     // Use 'esm' format which produces clean JavaScript without module system wrappers
     // For type-only TypeScript (interfaces, type annotations), this just strips types

package/dist/agent/infra/tools/implementations/curate-tool.d.ts

@@ -16,21 +16,64 @@ export declare const CurateInputSchema: z.ZodObject<{
         content: z.ZodOptional<z.ZodObject<{
             narrative: z.ZodOptional<z.ZodObject<{
                 dependencies: z.ZodOptional<z.ZodString>;
+                diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    content: z.ZodString;
+                    title: z.ZodOptional<z.ZodString>;
+                    type: z.ZodEnum<["mermaid", "plantuml", "ascii", "other"]>;
+                }, "strip", z.ZodTypeAny, {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }, {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }>, "many">>;
+                examples: z.ZodOptional<z.ZodString>;
                 features: z.ZodOptional<z.ZodString>;
+                rules: z.ZodOptional<z.ZodString>;
                 structure: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             }, {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             }>>;
             rawConcept: z.ZodOptional<z.ZodObject<{
+                author: z.ZodOptional<z.ZodString>;
                 changes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 files: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
                 flow: z.ZodOptional<z.ZodString>;
+                patterns: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    description: z.ZodString;
+                    flags: z.ZodOptional<z.ZodString>;
+                    pattern: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }, {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }>, "many">>;
                 task: z.ZodOptional<z.ZodString>;
                 timestamp: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
@@ -39,12 +82,24 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             }, {
                 timestamp?: string | undefined;
                 files?: string[] | undefined;
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             }>>;
             relations: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
             snippets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
@@ -53,6 +108,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -60,6 +122,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;
@@ -68,6 +136,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -75,6 +150,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;
@@ -149,6 +230,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -156,6 +244,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;
@@ -190,6 +284,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -197,6 +298,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;
@@ -234,6 +341,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -241,6 +355,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;
@@ -277,6 +397,13 @@ export declare const CurateInputSchema: z.ZodObject<{
                 structure?: string | undefined;
                 dependencies?: string | undefined;
                 features?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -284,6 +411,12 @@ export declare const CurateInputSchema: z.ZodObject<{
                 task?: string | undefined;
                 changes?: string[] | undefined;
                 flow?: string | undefined;
+                author?: string | undefined;
+                patterns?: {
+                    description: string;
+                    pattern: string;
+                    flags?: string | undefined;
+                }[] | undefined;
             } | undefined;
             relations?: string[] | undefined;
             snippets?: string[] | undefined;

package/dist/agent/infra/tools/implementations/curate-tool.js

@@ -14,9 +14,15 @@ const OperationType = z.enum(['ADD', 'UPDATE', 'UPSERT', 'MERGE', 'DELETE']);
  * Raw Concept schema for structured metadata and technical footprint.
  */
 const RawConceptSchema = z.object({
+    author: z.string().optional().describe('Author or source attribution (e.g., "meowso", "Team Security")'),
     changes: z.array(z.string()).optional().describe('What changes in the codebase are induced by this concept'),
     files: z.array(z.string()).optional().describe('Which files are related to this concept'),
     flow: z.string().optional().describe('What is the flow included in this concept'),
+    patterns: z.array(z.object({
+        description: z.string().describe('What this pattern matches or validates'),
+        flags: z.string().optional().describe('Pattern flags (e.g., "gi" for regex)'),
+        pattern: z.string().describe('The exact pattern string (e.g., regex pattern)')
+    })).optional().describe('Regex or validation patterns related to this concept'),
     task: z.string().optional().describe('What is the task related to this concept'),
     timestamp: z
         .string()
@@ -31,10 +37,17 @@ const NarrativeSchema = z.object({
         .string()
         .optional()
         .describe('Dependency management information (e.g., "Singleton, init when service starts, hard dependency in smoke test")'),
+    diagrams: z.array(z.object({
+        content: z.string().describe('The full diagram content (Mermaid code, PlantUML code, or ASCII art) - preserved verbatim'),
+        title: z.string().optional().describe('Optional title or label for the diagram'),
+        type: z.enum(['mermaid', 'plantuml', 'ascii', 'other']).describe('Diagram type for proper rendering'),
+    })).optional().describe('Diagrams found in source content - Mermaid, PlantUML, ASCII art, sequence diagrams. Preserve verbatim.'),
+    examples: z.string().optional().describe('Concrete examples and use cases demonstrating the concept'),
     features: z
         .string()
         .optional()
         .describe('Feature documentation for this concept (e.g., "User permission can be stale for up to 300 seconds due to Redis cache")'),
+    rules: z.string().optional().describe('Exact rules, constraints, or guidelines - preserved verbatim from source'),
     structure: z.string().optional().describe('Code structure documentation (e.g., "clients/redis_client.go")'),
 });
 /**
@@ -775,6 +788,7 @@ export function createCurateTool() {
   - structure: Code structure documentation
   - dependencies: Dependency management information
   - features: Feature documentation
+  - diagrams: Array of diagrams with {type: "mermaid"|"plantuml"|"ascii"|"other", content: string, title?: string} - preserve verbatim
 - **snippets**: Code/text snippets (legacy support)
 - **relations**: Related topics using @domain/topic notation