claude-brain 0.9.2 → 0.10.0

package/src/tools/schemas.ts

@@ -568,337 +568,15 @@ export const TOOLS = {
     }
   },
 
-  /**
-   * RATE_MEMORY
-   * Provide feedback on retrieved memories for adaptive learning
-   *
-   * Use this when:
-   * - A retrieved memory was helpful or not helpful
-   * - You want to improve future retrieval quality
-   * - The system should learn from retrieval feedback
-   *
-   * Feedback is used to adapt retrieval thresholds and weights
-   */
-  RATE_MEMORY: {
-    name: 'rate_memory',
-    description: 'Rate how helpful a retrieved memory was. This feedback helps improve future retrieval quality through adaptive learning. Rate 1-5 where 1=not helpful and 5=very helpful.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        memory_id: {
-          type: 'string',
-          description: 'ID of the memory to rate (from recall_similar or smart_context results)'
-        },
-        rating: {
-          type: 'number',
-          enum: [1, 2, 3, 4, 5],
-          description: 'Rating from 1 (not helpful) to 5 (very helpful)'
-        },
-        query: {
-          type: 'string',
-          description: 'The original query that retrieved this memory'
-        },
-        was_used: {
-          type: 'boolean',
-          description: 'Whether you actually used this memory in your response',
-          default: true
-        },
-        feedback_text: {
-          type: 'string',
-          description: 'Optional text explaining why this rating was given'
-        },
-        project_name: {
-          type: 'string',
-          description: 'Project this feedback relates to (optional)'
-        }
-      },
-      required: ['memory_id', 'rating', 'query']
-    }
-  },
-
-  /**
-   * SEARCH_KNOWLEDGE_GRAPH
-   * Search the knowledge graph for related entities, decisions, and relationships
-   *
-   * Use this when:
-   * - You want to find how technologies/decisions are connected
-   * - You need to explore relationships between entities
-   * - You want to find related decisions for a technology
-   */
-  SEARCH_KNOWLEDGE_GRAPH: {
-    name: 'search_knowledge_graph',
-    description: 'Searches the knowledge graph for related nodes and edges. Use this to explore relationships between technologies, decisions, and concepts.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        query: {
-          type: 'string',
-          description: 'Search query (technology name, concept, etc.)'
-        },
-        node_type: {
-          type: 'string',
-          enum: ['project', 'technology', 'concept', 'person', 'file', 'decision', 'pattern', 'correction', 'date'],
-          description: 'Filter by node type (optional)'
-        },
-        start_node_id: {
-          type: 'string',
-          description: 'Start from a specific node ID for graph expansion (optional)'
-        },
-        hops: {
-          type: 'number',
-          description: 'Number of hops to expand from matching nodes (default 2)',
-          default: 2
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum number of results (default 20)',
-          default: 20
-        }
-      }
-    }
-  },
-
-  /**
-   * GET_EPISODE
-   * Get a specific episode or the active episode for a project
-   *
-   * Use this when:
-   * - You want to review a past conversation session
-   * - You need to find what was discussed in an episode
-   * - You want to see the active episode for a project
-   */
-  GET_EPISODE: {
-    name: 'get_episode',
-    description: 'Get episode by ID or get active episode for project. Episodes represent conversation sessions with summaries and linked decisions.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        episode_id: {
-          type: 'string',
-          description: 'Specific episode ID to retrieve'
-        },
-        project_name: {
-          type: 'string',
-          description: 'Get active episode for this project'
-        }
-      }
-    }
-  },
-
-  /**
-   * LIST_EPISODES
-   * List recent episodes, filtered by project or status
-   *
-   * Use this when:
-   * - You want to see recent conversation sessions
-   * - You need to find past episodes for a project
-   * - You want to review episode summaries
-   */
-  LIST_EPISODES: {
-    name: 'list_episodes',
-    description: 'List recent episodes with summaries. Filter by project or status to find past conversation sessions.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        project_name: {
-          type: 'string',
-          description: 'Filter episodes by project (optional)'
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum number of episodes to return (default 10)',
-          default: 10
-        },
-        status: {
-          type: 'string',
-          enum: ['active', 'completed'],
-          description: 'Filter by episode status (optional)'
-        }
-      }
-    }
-  },
-  // =========================================================================
-  // Phase 15 - Advanced Intelligence & Temporal Reasoning
-  // =========================================================================
-
-  /**
-   * GET_DECISION_TIMELINE
-   * Build a chronological timeline of decisions
-   */
-  GET_DECISION_TIMELINE: {
-    name: 'get_decision_timeline',
-    description: 'Builds a chronological timeline of decisions, patterns, and corrections. Supports temporal expressions like "last month", "since January", etc. Use this to see how a project or topic has evolved over time.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        project_name: {
-          type: 'string',
-          description: 'Filter timeline by project (optional)'
-        },
-        topic: {
-          type: 'string',
-          description: 'Filter timeline by topic via semantic search (optional)'
-        },
-        time_range: {
-          type: 'string',
-          description: 'Natural language time range, e.g. "last month", "since January 2025", "this week" (optional)'
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum number of entries (default 50)',
-          default: 50
-        }
-      }
-    }
-  },
-
-  /**
-   * ANALYZE_DECISION_EVOLUTION
-   * Track how decisions on a topic change over time
-   */
-  ANALYZE_DECISION_EVOLUTION: {
-    name: 'analyze_decision_evolution',
-    description: 'Tracks how decisions on a specific topic have evolved over time. Shows changes, stability assessment, and current state. Use this to understand decision drift or consistency.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        topic: {
-          type: 'string',
-          description: 'The topic to analyze evolution for (e.g., "database choice", "authentication")'
-        },
-        project_name: {
-          type: 'string',
-          description: 'Filter by project (optional)'
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum decisions to analyze (default 20)',
-          default: 20
-        }
-      },
-      required: ['topic']
-    }
-  },
-
-  /**
-   * DETECT_TRENDS
-   * Detect emerging and declining technology/pattern trends
-   */
-  DETECT_TRENDS: {
-    name: 'detect_trends',
-    description: 'Detects emerging, stable, and declining trends across decisions. Identifies frequently mentioned technologies, concepts, and approaches, and whether they are gaining or losing momentum.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        project_name: {
-          type: 'string',
-          description: 'Filter by project (optional, analyzes all projects if omitted)'
-        },
-        period_days: {
-          type: 'number',
-          description: 'Analysis period in days (default 90)',
-          default: 90
-        },
-        min_occurrences: {
-          type: 'number',
-          description: 'Minimum occurrences to include (default 2)',
-          default: 2
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum trends to return (default 20)',
-          default: 20
-        }
-      }
-    }
-  },
-
-  /**
-   * WHAT_IF_ANALYSIS
-   * Counterfactual what-if analysis
-   */
-  WHAT_IF_ANALYSIS: {
-    name: 'what_if_analysis',
-    description: 'Performs what-if analysis: "What would happen if we changed X?" Finds all affected decisions, connected technologies, and assesses risk level. Uses knowledge graph for impact analysis.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        change: {
-          type: 'string',
-          description: 'The hypothetical change to analyze (e.g., "switch from React to Vue", "remove TypeScript")'
-        },
-        project_name: {
-          type: 'string',
-          description: 'Filter by project (optional)'
-        },
-        max_results: {
-          type: 'number',
-          description: 'Maximum affected decisions to return (default 20)',
-          default: 20
-        }
-      },
-      required: ['change']
-    }
-  },
-
-  /**
-   * GET_RECOMMENDATIONS
-   * Get intelligent recommendations based on history
-   */
-  GET_RECOMMENDATIONS: {
-    name: 'get_recommendations',
-    description: 'Provides intelligent recommendations based on past decisions, patterns, and corrections. Combines multiple knowledge sources to suggest best approaches for a given situation.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        query: {
-          type: 'string',
-          description: 'What you need recommendations for (e.g., "how to implement caching", "error handling approach")'
-        },
-        project_name: {
-          type: 'string',
-          description: 'Filter by project (optional)'
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum recommendations (default 10)',
-          default: 10
-        }
-      },
-      required: ['query']
-    }
-  },
-
-  /**
-   * FIND_CROSS_PROJECT_PATTERNS
-   * Find patterns common across multiple projects
-   */
-  FIND_CROSS_PROJECT_PATTERNS: {
-    name: 'find_cross_project_patterns',
-    description: 'Finds patterns and approaches that appear across multiple projects. Identifies shared technologies, common decisions, and transferable knowledge between projects.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        min_projects: {
-          type: 'number',
-          description: 'Minimum number of projects a pattern must appear in (default 2)',
-          default: 2
-        },
-        limit: {
-          type: 'number',
-          description: 'Maximum patterns to return (default 20)',
-          default: 20
-        },
-        query: {
-          type: 'string',
-          description: 'Optional query to focus the search (e.g., "authentication", "deployment")'
-        }
-      }
-    }
-  },
   // =========================================================================
   // Phase 16 - Unified Brain Tool
   // =========================================================================
+  // Phase 19: Removed 9 redundant MCP tools whose functionality is now
+  // absorbed into brain(). Removed: rate_memory, search_knowledge_graph,
+  // get_episode, list_episodes, get_decision_timeline,
+  // analyze_decision_evolution, detect_trends, what_if_analysis,
+  // get_recommendations, find_cross_project_patterns.
+  // The underlying modules are still available internally.
 
   /**
    * BRAIN