byterover-cli 1.7.2 → 2.0.0

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

@@ -14,23 +14,83 @@ export declare const CurateInputSchema: z.ZodObject<{
     basePath: z.ZodDefault<z.ZodString>;
     operations: z.ZodArray<z.ZodObject<{
         content: z.ZodOptional<z.ZodObject<{
+            facts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                category: z.ZodOptional<z.ZodEnum<["personal", "project", "preference", "convention", "team", "environment", "other"]>>;
+                statement: z.ZodString;
+                subject: z.ZodOptional<z.ZodString>;
+                value: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }, {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }>, "many">>;
+            keywords: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
             narrative: z.ZodOptional<z.ZodObject<{
                 dependencies: z.ZodOptional<z.ZodString>;
-                features: 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" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }, {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }>, "many">>;
+                examples: z.ZodOptional<z.ZodString>;
+                highlights: 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;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             }, {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    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,20 +99,49 @@ 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">>;
+            tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
         }, "strip", z.ZodTypeAny, {
+            tags: string[];
+            keywords: string[];
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -60,14 +149,35 @@ 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;
         }, {
+            tags?: string[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -75,8 +185,13 @@ 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;
         }>>;
         domainContext: z.ZodOptional<z.ZodObject<{
@@ -99,16 +214,16 @@ export declare const CurateInputSchema: z.ZodObject<{
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         }, {
             scope: {
                 included: string[];
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         }>>;
         mergeTarget: z.ZodOptional<z.ZodString>;
         mergeTargetTitle: z.ZodOptional<z.ZodString>;
@@ -145,10 +260,26 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags: string[];
+            keywords: string[];
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -156,8 +287,13 @@ 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;
         } | undefined;
         domainContext?: {
@@ -166,8 +302,8 @@ export declare const CurateInputSchema: z.ZodObject<{
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         } | undefined;
         mergeTarget?: string | undefined;
         mergeTargetTitle?: string | undefined;
@@ -186,10 +322,26 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags?: string[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -197,8 +349,13 @@ 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;
         } | undefined;
         domainContext?: {
@@ -207,8 +364,8 @@ export declare const CurateInputSchema: z.ZodObject<{
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         } | undefined;
         mergeTarget?: string | undefined;
         mergeTargetTitle?: string | undefined;
@@ -230,10 +387,26 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags: string[];
+            keywords: string[];
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -241,8 +414,13 @@ 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;
         } | undefined;
         domainContext?: {
@@ -251,8 +429,8 @@ export declare const CurateInputSchema: z.ZodObject<{
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         } | undefined;
         mergeTarget?: string | undefined;
         mergeTargetTitle?: string | undefined;
@@ -273,10 +451,26 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags?: string[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
+                rules?: string | undefined;
+                examples?: string | undefined;
+                diagrams?: {
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
+                    content: string;
+                    title?: string | undefined;
+                }[] | undefined;
             } | undefined;
             rawConcept?: {
                 timestamp?: string | undefined;
@@ -284,8 +478,13 @@ 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;
         } | undefined;
         domainContext?: {
@@ -294,8 +493,8 @@ export declare const CurateInputSchema: z.ZodObject<{
                 excluded?: string[] | undefined;
             };
             purpose: string;
-            ownership?: string | undefined;
             usage?: string | undefined;
+            ownership?: string | undefined;
         } | undefined;
         mergeTarget?: string | undefined;
         mergeTargetTitle?: string | undefined;
@@ -342,5 +541,5 @@ export interface CurateOutput {
  * Exported for use by CurateService in sandbox.
  */
 export declare function executeCurate(input: unknown, _context?: ToolExecutionContext): Promise<CurateOutput>;
-export declare function createCurateTool(): Tool;
+export declare function createCurateTool(workingDirectory?: string): Tool;
 export {};

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

@@ -1,8 +1,9 @@
 import { existsSync } from 'node:fs';
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { z } from 'zod';
 import { DirectoryManager } from '../../../../server/core/domain/knowledge/directory-manager.js';
-import { MarkdownWriter } from '../../../../server/core/domain/knowledge/markdown-writer.js';
+import { MarkdownWriter, parseFrontmatterScoring } from '../../../../server/core/domain/knowledge/markdown-writer.js';
+import { applyDefaultScoring, determineTier, recordCurateUpdate, } from '../../../../server/core/domain/knowledge/memory-scoring.js';
 import { toSnakeCase } from '../../../../server/utils/file-helpers.js';
 import { ToolName } from '../../../core/domain/tools/constants.js';
 /**
@@ -14,9 +15,15 @@ const OperationType = z.enum(['ADD', 'UPDATE', 'UPSERT', 'MERGE', 'DELETE']);
  * Raw Concept schema for structured metadata and technical footprint.
  */
 const RawConceptSchema = z.object({
-    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'),
+    author: z.string().optional().describe('Author or source attribution (e.g., "meowso", "Team Security")'),
+    changes: z.array(z.string()).optional().describe('What changes are induced by this concept (e.g., code changes, process updates, market shifts)'),
+    files: z.array(z.string()).optional().describe('Related documents, source files, or resources (e.g., source code paths, reports, data files)'),
+    flow: z.string().optional().describe('The process flow or workflow described by 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()
@@ -30,17 +37,46 @@ const NarrativeSchema = z.object({
     dependencies: z
         .string()
         .optional()
-        .describe('Dependency management information (e.g., "Singleton, init when service starts, hard dependency in smoke test")'),
-    features: z
+        .describe('Dependency or relationship information (e.g., prerequisite systems, required inputs, related components)'),
+    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'),
+    highlights: 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")'),
-    structure: z.string().optional().describe('Code structure documentation (e.g., "clients/redis_client.go")'),
+        .describe('Key highlights, capabilities, deliverables, or notable outcomes (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('Structural or organizational documentation (e.g., file layout, data schema, process hierarchy)'),
+});
+/**
+ * Fact schema for structured factual statements extracted during curation.
+ */
+const FactSchema = z.object({
+    category: z
+        .enum(['personal', 'project', 'preference', 'convention', 'team', 'environment', 'other'])
+        .optional()
+        .describe('Category of the fact (e.g., "personal", "project", "preference", "convention", "team", "environment")'),
+    statement: z
+        .string()
+        .describe('The full factual statement (e.g., "My name is Andy", "We use PostgreSQL 15")'),
+    subject: z
+        .string()
+        .optional()
+        .describe('What the fact is about in snake_case (e.g., "user_name", "database", "sprint_duration")'),
+    value: z
+        .string()
+        .optional()
+        .describe('The extracted value (e.g., "Andy", "PostgreSQL 15", "2 weeks")'),
 });
 /**
  * Content structure for ADD and UPDATE operations.
  */
 const ContentSchema = z.object({
+    facts: z.array(FactSchema).optional().describe('Factual statements extracted from content (e.g., personal info, project facts, preferences, conventions)'),
+    keywords: z.array(z.string()).default([]).describe('Keywords for search and discovery (e.g., ["jwt", "refresh_token", "rotation"])'),
     narrative: NarrativeSchema.optional().describe('Narrative section with descriptive and structural context'),
     rawConcept: RawConceptSchema.optional().describe('Raw concept section with metadata and technical footprint'),
     relations: z
@@ -48,6 +84,7 @@ const ContentSchema = z.object({
         .optional()
         .describe('Related topics using domain/topic/title.md or domain/topic/subtopic/title.md notation'),
     snippets: z.array(z.string()).optional().describe('Code/text snippets'),
+    tags: z.array(z.string()).default([]).describe('Tags for categorization and filtering (e.g., ["authentication", "security", "jwt"])'),
 });
 /**
  * Domain context schema for domain-level context.md files.
@@ -122,7 +159,17 @@ function filterValidFiles(content) {
     if (!content.rawConcept?.files || content.rawConcept.files.length === 0) {
         return content;
     }
-    const validFiles = content.rawConcept.files.filter((filePath) => existsSync(filePath));
+    const validFiles = content.rawConcept.files.filter((filePath) => {
+        // Skip filesystem validation for URLs and document references
+        if (filePath.includes('://')) {
+            return true;
+        }
+        // Skip entries that look like document references (no path separators, contain spaces)
+        if (!filePath.includes('/') && !filePath.includes('\\') && filePath.includes(' ')) {
+            return true;
+        }
+        return existsSync(filePath);
+    });
     // Return content with filtered files (empty array if none exist)
     return {
         ...content,
@@ -356,11 +403,15 @@ async function executeAdd(basePath, operation) {
         // Filter out non-existent files from rawConcept.files
         const filteredContent = filterValidFiles(content);
         const contextContent = MarkdownWriter.generateContext({
+            facts: filteredContent.facts,
+            keywords: filteredContent.keywords,
             name: title,
             narrative: filteredContent.narrative,
             rawConcept: filteredContent.rawConcept,
             relations: filteredContent.relations,
+            scoring: applyDefaultScoring(),
             snippets: filteredContent.snippets ?? [],
+            tags: filteredContent.tags,
         });
         const filename = `${toSnakeCase(title)}.md`;
         const contextPath = join(finalPath, filename);
@@ -427,14 +478,24 @@ async function executeUpdate(basePath, operation) {
             };
         }
         await createDomainContextIfMissing(basePath, parsed.domain, domainContext);
+        // Read existing file to preserve and update scoring metadata
+        const existingContent = await DirectoryManager.readFile(contextPath);
+        const existingScoring = existingContent ? parseFrontmatterScoring(existingContent) : undefined;
+        const updatedScoring = existingScoring ? recordCurateUpdate(existingScoring) : applyDefaultScoring();
+        const newTier = determineTier(updatedScoring.importance ?? 50, (updatedScoring.maturity ?? 'draft'));
+        const finalScoring = { ...updatedScoring, maturity: newTier };
         // Filter out non-existent files from rawConcept.files
         const filteredContent = filterValidFiles(content);
         const contextContent = MarkdownWriter.generateContext({
+            facts: filteredContent.facts,
+            keywords: filteredContent.keywords,
             name: title,
             narrative: filteredContent.narrative,
             rawConcept: filteredContent.rawConcept,
             relations: filteredContent.relations,
+            scoring: finalScoring,
             snippets: filteredContent.snippets ?? [],
+            tags: filteredContent.tags,
         });
         await DirectoryManager.writeFileAtomic(contextPath, contextContent);
         await ensureContextMd(basePath, parsed, topicContext, subtopicContext);
@@ -760,21 +821,27 @@ export async function executeCurate(input, _context) {
     /* eslint-enable no-await-in-loop */
     return { applied, summary };
 }
-export function createCurateTool() {
+export function createCurateTool(workingDirectory) {
     return {
         description: `Curate knowledge topics with atomic operations. This tool manages the knowledge structure using four operation types and supports a two-part context model: Raw Concept + Narrative.
 
-**Content Structure (Two-Part Model):**
-- **rawConcept**: Captures essential metadata and technical footprint
-  - task: What is the task related to this concept
-  - changes: Array of changes induced in the codebase
-  - files: Array of related files
-  - flow: The execution flow of this concept
+**Content Structure (Two-Part Model + Facts):**
+- **rawConcept**: Captures essential metadata and context footprint
+  - task: What is being documented
+  - changes: Array of changes or updates (e.g., code changes, process updates, market shifts)
+  - files: Related documents, source files, or resources
+  - flow: The process flow or workflow
   - timestamp: When created/modified (ISO 8601 format)
 - **narrative**: Captures descriptive and structural context
-  - structure: Code structure documentation
-  - dependencies: Dependency management information
-  - features: Feature documentation
+  - structure: Structural or organizational documentation
+  - dependencies: Dependency or relationship information
+  - highlights: Key highlights, capabilities, deliverables, or notable outcomes
+  - diagrams: Array of diagrams with {type: "mermaid"|"plantuml"|"ascii"|"other", content: string, title?: string} - preserve verbatim
+- **facts**: Array of factual statements extracted from content
+  - statement (required): The full fact text (e.g., "My name is Andy", "We use PostgreSQL 15")
+  - category (optional): "personal", "project", "preference", "convention", "team", "environment", "other"
+  - subject (optional): What the fact is about in snake_case (e.g., "user_name", "database")
+  - value (optional): The extracted value (e.g., "Andy", "PostgreSQL 15")
 - **snippets**: Code/text snippets (legacy support)
 - **relations**: Related topics using @domain/topic notation
 
@@ -798,7 +865,7 @@ export function createCurateTool() {
          narrative: {
            structure: "# Redis client\\n- clients/redis_client.go",
            dependencies: "# Redis client\\n- Singleton, init when service starts",
-           features: "# Authorization\\n- User permission can be stale for up to 300 seconds"
+           highlights: "# Authorization\\n- User permission can be stale for up to 300 seconds"
          },
          relations: ["structure/api-endpoints/validation.md", "structure/api-endpoints/error-handling/retry-logic.md"]
        },
@@ -845,7 +912,7 @@ export function createCurateTool() {
 - Domains are created dynamically based on the context being curated
 - Choose domain names that are semantically meaningful and descriptive
 - Domain names should be concise (1-3 words), use snake_case format
-- Examples of good domain names: authentication, api_design, data_models, error_handling, ui_components
+- Examples of good domain names: architecture, market_trends, risk_analysis, portfolio_management, error_handling
 - Before creating a new domain, check if existing domains could be reused
 - Group related topics under the same domain for better organization
 
@@ -926,7 +993,17 @@ export function createCurateTool() {
 **Backward Compatibility:** Existing context entries using only snippets and relations continue to work.
 
 **Output:** Returns applied operations with status (success/failed), filePath (for created/modified files), and a summary of counts.`,
-        execute: executeCurate,
+        async execute(input, context) {
+            if (workingDirectory) {
+                // Resolve relative basePath against working directory before executing
+                const parseResult = CurateInputSchema.safeParse(input);
+                if (parseResult.success) {
+                    parseResult.data.basePath = resolve(workingDirectory, parseResult.data.basePath);
+                    return executeCurate(parseResult.data, context);
+                }
+            }
+            return executeCurate(input, context);
+        },
         id: ToolName.CURATE,
         inputSchema: CurateInputSchema,
     };