crewly 1.0.7 → 1.0.10

package/dist/cli/backend/src/services/memory/memory.service.d.ts

@@ -0,0 +1,306 @@
+/**
+ * Memory Service Coordinator
+ *
+ * Provides a unified interface for both agent-level and project-level memory services.
+ * Handles cross-cutting concerns like logging, validation, and combined context generation.
+ *
+ * @module services/memory/memory.service
+ */
+import { IAgentMemoryService } from './agent-memory.service.js';
+import { IProjectMemoryService } from './project-memory.service.js';
+import type { KnowledgeDocumentSummary } from '../../types/knowledge.types.js';
+import type { PatternCategory, GotchaSeverity } from '../../types/memory.types.js';
+/**
+ * Categories for the unified remember operation
+ */
+export type RememberCategory = 'fact' | 'pattern' | 'decision' | 'gotcha' | 'preference' | 'relationship';
+/**
+ * Scope for memory operations
+ */
+export type MemoryScope = 'agent' | 'project' | 'both';
+/**
+ * Parameters for the remember operation
+ */
+export interface RememberParams {
+    /** Agent identifier */
+    agentId: string;
+    /** Project path (required for project scope) */
+    projectPath?: string;
+    /** Content to remember */
+    content: string;
+    /** Category of memory */
+    category: RememberCategory;
+    /** Scope: agent or project */
+    scope: 'agent' | 'project';
+    /** Additional metadata */
+    metadata?: {
+        /** Task ID where this was learned */
+        taskId?: string;
+        /** Title for patterns/decisions/gotchas */
+        title?: string;
+        /** Pattern category */
+        patternCategory?: PatternCategory;
+        /** Code example */
+        example?: string;
+        /** Related files */
+        files?: string[];
+        /** Rationale for decisions */
+        rationale?: string;
+        /** Alternatives considered for decisions */
+        alternatives?: string[];
+        /** Areas affected by decisions */
+        affectedAreas?: string[];
+        /** Solution for gotchas */
+        solution?: string;
+        /** Severity for gotchas */
+        severity?: GotchaSeverity;
+        /** Relationship type */
+        relationshipType?: 'depends-on' | 'uses' | 'extends' | 'implements' | 'calls' | 'imported-by';
+        /** Target component for relationships */
+        targetComponent?: string;
+    };
+}
+/**
+ * Parameters for the recall operation
+ */
+export interface RecallParams {
+    /** Agent identifier */
+    agentId: string;
+    /** Project path (required for project/both scope) */
+    projectPath?: string;
+    /** Context/query for finding relevant memories */
+    context: string;
+    /** Scope: agent, project, or both */
+    scope: MemoryScope;
+    /** Maximum number of results */
+    limit?: number;
+}
+/**
+ * Result of a recall operation
+ */
+export interface RecallResult {
+    /** Memories from agent level */
+    agentMemories: string[];
+    /** Memories from project level */
+    projectMemories: string[];
+    /** Combined formatted result */
+    combined: string;
+    /** Matching knowledge documents (optional, from knowledge base search) */
+    knowledgeDocuments?: KnowledgeDocumentSummary[];
+}
+/**
+ * Parameters for recording a learning
+ */
+export interface LearningParams {
+    /** Agent identifier */
+    agentId: string;
+    /** Agent's role */
+    agentRole: string;
+    /** Project path */
+    projectPath: string;
+    /** The learning content */
+    learning: string;
+    /** Related task/ticket ID */
+    relatedTask?: string;
+    /** Related file paths */
+    relatedFiles?: string[];
+}
+/**
+ * Interface for the unified Memory Service
+ */
+export interface IMemoryService {
+    remember(params: RememberParams): Promise<string>;
+    recall(params: RecallParams): Promise<RecallResult>;
+    getFullContext(agentId: string, projectPath: string): Promise<string>;
+    recordLearning(params: LearningParams): Promise<void>;
+    initializeForSession(agentId: string, role: string, projectPath: string): Promise<void>;
+    getAgentMemoryService(): IAgentMemoryService;
+    getProjectMemoryService(): IProjectMemoryService;
+}
+/**
+ * Unified Memory Service Coordinator
+ *
+ * Provides a single entry point for all memory operations, coordinating
+ * between agent-level and project-level memory services.
+ *
+ * @example
+ * ```typescript
+ * const memoryService = MemoryService.getInstance();
+ *
+ * // Initialize for a session
+ * await memoryService.initializeForSession('dev-001', 'developer', '/path/to/project');
+ *
+ * // Remember something
+ * await memoryService.remember({
+ *   agentId: 'dev-001',
+ *   projectPath: '/path/to/project',
+ *   content: 'Always use async/await instead of callbacks',
+ *   category: 'pattern',
+ *   scope: 'project',
+ *   metadata: { title: 'Async Pattern' }
+ * });
+ *
+ * // Get full context for prompts
+ * const context = await memoryService.getFullContext('dev-001', '/path/to/project');
+ * ```
+ */
+export declare class MemoryService implements IMemoryService {
+    private static instance;
+    private readonly agentMemory;
+    private readonly projectMemory;
+    private readonly logger;
+    /**
+     * Creates a new MemoryService instance
+     */
+    private constructor();
+    /**
+     * Gets the singleton instance of MemoryService
+     *
+     * @returns The singleton MemoryService instance
+     */
+    static getInstance(): MemoryService;
+    /**
+     * Clears the singleton instance (useful for testing)
+     */
+    static clearInstance(): void;
+    /**
+     * Gets the underlying AgentMemoryService
+     *
+     * @returns The AgentMemoryService instance
+     */
+    getAgentMemoryService(): IAgentMemoryService;
+    /**
+     * Gets the underlying ProjectMemoryService
+     *
+     * @returns The ProjectMemoryService instance
+     */
+    getProjectMemoryService(): IProjectMemoryService;
+    /**
+     * Maps RememberCategory to RoleKnowledgeCategory for agent memory
+     */
+    private mapToKnowledgeCategory;
+    /**
+     * Parses a preference string into AgentPreferences
+     */
+    private parsePreference;
+    /**
+     * Checks if a learning is role-relevant (should be stored in agent memory)
+     */
+    private isRoleRelevant;
+    /**
+     * Filters memories by relevance to a context
+     */
+    private filterRelevant;
+    /**
+     * Formats search results into strings
+     */
+    private formatSearchResults;
+    /**
+     * Combines agent and project memories into a formatted string
+     */
+    private combineMemories;
+    /**
+     * Unified remember operation - stores content in appropriate memory
+     *
+     * @param params - Remember parameters
+     * @returns ID of the stored memory entry
+     *
+     * @example
+     * ```typescript
+     * // Remember a pattern for the project
+     * await memoryService.remember({
+     *   agentId: 'dev-001',
+     *   projectPath: '/path/to/project',
+     *   content: 'Use error wrapper for all API endpoints',
+     *   category: 'pattern',
+     *   scope: 'project',
+     *   metadata: {
+     *     title: 'API Error Handling',
+     *     patternCategory: 'api',
+     *     example: 'handleApiError(handler)'
+     *   }
+     * });
+     * ```
+     */
+    remember(params: RememberParams): Promise<string>;
+    /**
+     * Stores memory at agent level
+     */
+    private rememberForAgent;
+    /**
+     * Stores memory at project level
+     */
+    private rememberForProject;
+    /**
+     * Unified recall operation - retrieves relevant memories
+     *
+     * @param params - Recall parameters
+     * @returns Recall results from appropriate scopes
+     *
+     * @example
+     * ```typescript
+     * const memories = await memoryService.recall({
+     *   agentId: 'dev-001',
+     *   projectPath: '/path/to/project',
+     *   context: 'error handling in API endpoints',
+     *   scope: 'both',
+     *   limit: 10
+     * });
+     * console.log(memories.combined);
+     * ```
+     */
+    recall(params: RecallParams): Promise<RecallResult>;
+    /**
+     * Searches knowledge documents across global and project scopes.
+     *
+     * @param context - Search query text
+     * @param projectPath - Optional project path for project-scoped search
+     * @returns Combined and deduplicated knowledge document summaries
+     */
+    private searchKnowledgeDocuments;
+    /**
+     * Generates combined context from both agent and project memory
+     *
+     * @param agentId - Agent identifier
+     * @param projectPath - Project path
+     * @returns Combined context string for prompt injection
+     */
+    getFullContext(agentId: string, projectPath: string): Promise<string>;
+    /**
+     * Records a learning to both project learnings and potentially agent memory
+     *
+     * @param params - Learning parameters
+     */
+    recordLearning(params: LearningParams): Promise<void>;
+    /**
+     * Initializes memory for a new session
+     *
+     * @param agentId - Agent identifier
+     * @param role - Agent's role
+     * @param projectPath - Project path
+     */
+    initializeForSession(agentId: string, role: string, projectPath: string): Promise<void>;
+    /**
+     * Recalls knowledge from all agents that have worked on a project
+     *
+     * Reads the project's agents-index.json, then searches each agent's role
+     * knowledge for entries relevant to the given context. Results are merged,
+     * deduplicated, and sorted by relevance.
+     *
+     * @param projectPath - Absolute path to the project
+     * @param context - Search context for relevance filtering
+     * @param limit - Maximum number of results (default 20)
+     * @returns Array of formatted memory strings from all agents
+     *
+     * @example
+     * ```typescript
+     * const teamKnowledge = await memoryService.recallFromAllAgents(
+     *   '/projects/app',
+     *   'authentication middleware',
+     *   15,
+     * );
+     * ```
+     */
+    recallFromAllAgents(projectPath: string, context: string, limit?: number): Promise<string[]>;
+}
+//# sourceMappingURL=memory.service.d.ts.map

package/dist/cli/backend/src/services/memory/memory.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/memory/memory.service.ts"],"names":[],"mappings":"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"}