byterover-cli 1.8.0 → 2.1.0

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

@@ -14,6 +14,23 @@ 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>;
                 diagrams: z.ZodOptional<z.ZodArray<z.ZodObject<{
@@ -21,37 +38,37 @@ export declare const CurateInputSchema: z.ZodObject<{
                     title: z.ZodOptional<z.ZodString>;
                     type: z.ZodEnum<["mermaid", "plantuml", "ascii", "other"]>;
                 }, "strip", z.ZodTypeAny, {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }, {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }>, "many">>;
                 examples: z.ZodOptional<z.ZodString>;
-                features: 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" | "mermaid" | "plantuml" | "other";
+                    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" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -103,15 +120,25 @@ export declare const CurateInputSchema: z.ZodObject<{
             }>>;
             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[];
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -129,17 +156,25 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         }, {
+            tags?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -157,7 +192,6 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         }>>;
         domainContext: z.ZodOptional<z.ZodObject<{
@@ -180,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>;
@@ -226,14 +260,23 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags: string[];
+            keywords: string[];
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -251,7 +294,6 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         } | undefined;
         domainContext?: {
@@ -260,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;
@@ -280,14 +322,23 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -305,7 +356,6 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         } | undefined;
         domainContext?: {
@@ -314,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;
@@ -337,14 +387,23 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags: string[];
+            keywords: string[];
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -362,7 +421,6 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         } | undefined;
         domainContext?: {
@@ -371,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;
@@ -393,14 +451,23 @@ export declare const CurateInputSchema: z.ZodObject<{
         reason: string;
         title?: string | undefined;
         content?: {
+            tags?: string[] | undefined;
+            facts?: {
+                statement: string;
+                value?: string | undefined;
+                subject?: string | undefined;
+                category?: "environment" | "convention" | "other" | "personal" | "preference" | "project" | "team" | undefined;
+            }[] | undefined;
+            keywords?: string[] | undefined;
+            relations?: string[] | undefined;
             narrative?: {
                 structure?: string | undefined;
                 dependencies?: string | undefined;
-                features?: string | undefined;
+                highlights?: string | undefined;
                 rules?: string | undefined;
                 examples?: string | undefined;
                 diagrams?: {
-                    type: "ascii" | "mermaid" | "plantuml" | "other";
+                    type: "ascii" | "other" | "mermaid" | "plantuml";
                     content: string;
                     title?: string | undefined;
                 }[] | undefined;
@@ -418,7 +485,6 @@ export declare const CurateInputSchema: z.ZodObject<{
                     flags?: string | undefined;
                 }[] | undefined;
             } | undefined;
-            relations?: string[] | undefined;
             snippets?: string[] | undefined;
         } | undefined;
         domainContext?: {
@@ -427,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;
@@ -475,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';
 /**
@@ -15,9 +16,9 @@ const OperationType = z.enum(['ADD', 'UPDATE', 'UPSERT', 'MERGE', 'DELETE']);
  */
 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'),
+    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)'),
@@ -36,24 +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")'),
+        .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'),
-    features: z
+    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")'),
+        .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('Code structure documentation (e.g., "clients/redis_client.go")'),
+    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
@@ -61,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.
@@ -135,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,
@@ -369,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);
@@ -440,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);
@@ -773,22 +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
 
@@ -812,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"]
        },
@@ -859,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
 
@@ -940,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,
     };

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

@@ -0,0 +1,18 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+/**
+ * Configuration for expand knowledge tool.
+ */
+export interface ExpandKnowledgeToolConfig {
+    baseDirectory?: string;
+}
+/**
+ * Creates the expand knowledge tool.
+ *
+ * Retrieves full content from archived knowledge entries by reading the
+ * lossless .full.md file that the stub points to. No LLM call needed —
+ * purely file-based lookup.
+ *
+ * @param config - Optional configuration
+ * @returns Configured expand knowledge tool
+ */
+export declare function createExpandKnowledgeTool(config?: ExpandKnowledgeToolConfig): Tool;

package/dist/agent/infra/tools/implementations/expand-knowledge-tool.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+import { FileContextTreeArchiveService } from '../../../../server/infra/context-tree/file-context-tree-archive-service.js';
+import { ToolName } from '../../../core/domain/tools/constants.js';
+/**
+ * Input schema for expand knowledge tool.
+ */
+const ExpandKnowledgeInputSchema = z
+    .object({
+    stubPath: z
+        .string()
+        .min(1)
+        .describe('Path to the .stub.md file in _archived/. ' +
+        'This is the `path` field from search results where symbolKind === "archive_stub".'),
+})
+    .strict();
+/**
+ * Creates the expand knowledge tool.
+ *
+ * Retrieves full content from archived knowledge entries by reading the
+ * lossless .full.md file that the stub points to. No LLM call needed —
+ * purely file-based lookup.
+ *
+ * @param config - Optional configuration
+ * @returns Configured expand knowledge tool
+ */
+export function createExpandKnowledgeTool(config = {}) {
+    const archiveService = new FileContextTreeArchiveService();
+    return {
+        description: 'Retrieve full content from archived knowledge entries. ' +
+            'Use when search results include an archive_stub that you need to drill into.',
+        async execute(input, _context) {
+            const parsed = ExpandKnowledgeInputSchema.parse(input);
+            const result = await archiveService.drillDown(parsed.stubPath, config.baseDirectory);
+            return {
+                fullContent: result.fullContent,
+                originalPath: result.originalPath,
+                tokenCount: result.tokenCount,
+            };
+        },
+        id: ToolName.EXPAND_KNOWLEDGE,
+        inputSchema: ExpandKnowledgeInputSchema,
+    };
+}

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

@@ -0,0 +1,24 @@
+import type { Tool } from '../../../core/domain/tools/types.js';
+import type { IContentGenerator } from '../../../core/interfaces/i-content-generator.js';
+import type { ILogger } from '../../../core/interfaces/i-logger.js';
+import type { ITokenizer } from '../../../core/interfaces/i-tokenizer.js';
+/**
+ * Create the llm_map tool.
+ *
+ * Runs a parallel, non-agentic map over a JSONL file. For each item (line),
+ * makes a single LLM API call (no tools, no file I/O, no code execution)
+ * that must return one JSON value conforming to the provided output schema.
+ *
+ * Best for high-throughput, side-effect-free tasks (classification, scoring,
+ * extraction, summarization) where the full context can be included in the
+ * prompt and item JSON.
+ *
+ * @param generator - IContentGenerator for LLM calls
+ * @param workingDirectory - Project root directory
+ * @param options - Optional dependencies for ContextTreeStore
+ */
+export declare function createLlmMapTool(generator: IContentGenerator, workingDirectory: string, options?: {
+    logger?: ILogger;
+    maxContextTokens?: number;
+    tokenizer?: ITokenizer;
+}): Tool;