mcp-adr-analysis-server

Instructions

Implementation Reference

• src/tools/conversation-memory-tool.ts:17-88 (handler)

  The core handler function for the 'expand_memory' tool. Retrieves full analysis content from a tiered response expandable ID using ConversationMemoryManager, formats it with metadata, related turns, and knowledge graph context.
  export async function expandMemory( args: { expandableId: string; section?: string; includeContext?: boolean; }, memoryManager: ConversationMemoryManager ): Promise<CallToolResult> { try { const request: MemoryExpansionRequest = { expandableId: args.expandableId, ...(args.section ? { section: args.section } : {}), includeContext: args.includeContext ?? true, }; const result = await memoryManager.expandContent(request); // Format the expanded content let output = `# Expanded Content: ${args.expandableId}\n\n`; // Show section or full content if (args.section && result.content.sections[args.section]) { output += `## Section: ${args.section}\n\n`; output += result.content.sections[args.section]; } else { output += `## Full Analysis\n\n`; output += result.content.content; } // Add metadata output += `\n\n---\n\n`; output += `**Tool**: ${result.content.metadata.toolName}\n`; output += `**Timestamp**: ${result.content.metadata.timestamp}\n`; output += `**Token Count**: ${result.content.metadata.tokenCount}\n`; // Add related turns if included if (result.relatedTurns && result.relatedTurns.length > 0) { output += `\n## Related Conversation Turns\n\n`; result.relatedTurns.forEach(turn => { output += `- **Turn ${turn.turnNumber}** (${turn.timestamp}): `; output += `${turn.request.toolName || 'message'}\n`; }); } // Add knowledge graph context if included if (result.knowledgeGraphContext && result.knowledgeGraphContext.length > 0) { output += `\n## Knowledge Graph Context\n\n`; result.knowledgeGraphContext.forEach(context => { output += `- **${context.intent}**: ${context.outcome} (${context.timestamp})\n`; }); } return { content: [ { type: 'text', text: output, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ Failed to expand content: ${error instanceof Error ? error.message : String(error)}`, }, ], isError: true, }; } }
• src/types/conversation-memory.ts:146-152 (schema)

  Type definition for MemoryExpansionRequest, which defines the input parameters for the expandMemory handler (expandableId, section, includeContext).
  export interface MemoryExpansionRequest { /** Expandable ID from tiered response */ expandableId: string; /** Optional: specific section to expand */ section?: string;
• src/tools/tool-catalog.ts:900-919 (registration)

  Metadata and approximate schema registration for the 'expand_memory' tool in the central tool catalog used for discovery and ListTools responses.
  TOOL_CATALOG.set('expand_memory', { name: 'expand_memory', shortDescription: 'Expand memory with new context', fullDescription: 'Expands memory with additional context information.', category: 'memory', complexity: 'simple', tokenCost: { min: 300, max: 800 }, hasCEMCPDirective: true, // Phase 4.3: Simple tool - memory storage relatedTools: ['memory_loading', 'get_memory_stats'], keywords: ['memory', 'expand', 'add', 'context'], requiresAI: false, inputSchema: { type: 'object', properties: { key: { type: 'string' }, value: { type: 'object' }, }, required: ['key', 'value'], }, });
• src/tools/conversation-memory-tool.ts:17-88 (helper)

  Function signature and dependencies showing integration with ConversationMemoryManager.
  export async function expandMemory( args: { expandableId: string; section?: string; includeContext?: boolean; }, memoryManager: ConversationMemoryManager ): Promise<CallToolResult> { try { const request: MemoryExpansionRequest = { expandableId: args.expandableId, ...(args.section ? { section: args.section } : {}), includeContext: args.includeContext ?? true, }; const result = await memoryManager.expandContent(request); // Format the expanded content let output = `# Expanded Content: ${args.expandableId}\n\n`; // Show section or full content if (args.section && result.content.sections[args.section]) { output += `## Section: ${args.section}\n\n`; output += result.content.sections[args.section]; } else { output += `## Full Analysis\n\n`; output += result.content.content; } // Add metadata output += `\n\n---\n\n`; output += `**Tool**: ${result.content.metadata.toolName}\n`; output += `**Timestamp**: ${result.content.metadata.timestamp}\n`; output += `**Token Count**: ${result.content.metadata.tokenCount}\n`; // Add related turns if included if (result.relatedTurns && result.relatedTurns.length > 0) { output += `\n## Related Conversation Turns\n\n`; result.relatedTurns.forEach(turn => { output += `- **Turn ${turn.turnNumber}** (${turn.timestamp}): `; output += `${turn.request.toolName || 'message'}\n`; }); } // Add knowledge graph context if included if (result.knowledgeGraphContext && result.knowledgeGraphContext.length > 0) { output += `\n## Knowledge Graph Context\n\n`; result.knowledgeGraphContext.forEach(context => { output += `- **${context.intent}**: ${context.outcome} (${context.timestamp})\n`; }); } return { content: [ { type: 'text', text: output, }, ], }; } catch (error) { return { content: [ { type: 'text', text: `❌ Failed to expand content: ${error instanceof Error ? error.message : String(error)}`, }, ], isError: true, }; } }
• src/utils/server-context-generator.ts:320-322 (helper)

  Reference listing of the tool in server context generator with accurate description matching handler purpose.
  { name: 'expand_memory', description: 'Retrieve and expand stored content from tiered responses',