forge-server 0.1.0

package/dist/tools/learning-tools.js

@@ -0,0 +1,158 @@
+// learning-tools.ts — B17
+// MCP tool handlers for knowledge retrieval and confidence management.
+// Tools: get_patterns, get_gotchas, boost_knowledge, decay_knowledge
+import { z } from 'zod';
+import { logger } from '../util/logger.js';
+// ---------------------------------------------------------------------------
+// Input schemas
+// ---------------------------------------------------------------------------
+export const getPatternsSchema = z.object({
+    domain: z.string().optional(),
+    min_confidence: z.number().min(0).max(1).default(0.5),
+    limit: z.number().int().min(1).max(50).default(20),
+});
+export const getGotchasSchema = z.object({
+    stack: z.array(z.string()).optional(),
+    min_confidence: z.number().min(0).max(1).default(0.3),
+    limit: z.number().int().min(1).max(50).default(20),
+});
+export const boostKnowledgeSchema = z.object({
+    knowledge_id: z.string().min(1, 'knowledge_id is required'),
+    amount: z.number().min(0).max(1).default(0.05),
+    reason: z.string().optional(),
+});
+export const decayKnowledgeSchema = z.object({
+    decay_rate: z.number().min(0).max(1).default(0.01),
+});
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createLearningTools(knowledgeSearch, confidenceManager, vectorStore) {
+    return {
+        'get_patterns': {
+            schema: getPatternsSchema,
+            description: 'Retrieve established code patterns from the knowledge base. PREFER THIS over ad-hoc code exploration when looking for "how do we do X in this codebase" — it returns curated, high-confidence patterns from past pipeline runs. Optionally filtered by domain/stack.',
+            handler: async (input) => {
+                try {
+                    const patterns = await knowledgeSearch.getPatterns(input.domain, input.limit, input.min_confidence);
+                    logger.debug('learning-tools.get_patterns: completed', {
+                        domain: input.domain,
+                        count: patterns.length,
+                    });
+                    return {
+                        patterns: patterns.map(p => ({
+                            title: p.title,
+                            content: p.content,
+                            confidence: p.confidence,
+                            stack_tags: Array.isArray(p.stack_tags) ? p.stack_tags : [],
+                            source_repo: p.source_repo ?? p.source_agent ?? 'unknown',
+                            times_confirmed: 1, // Qdrant payload doesn't track this yet
+                        })),
+                    };
+                }
+                catch (err) {
+                    logger.error('learning-tools.get_patterns: error', { error: String(err) });
+                    return {
+                        error: 'GET_PATTERNS_FAILED',
+                        message: String(err),
+                        patterns: [],
+                    };
+                }
+            },
+        },
+        'get_gotchas': {
+            schema: getGotchasSchema,
+            description: 'Retrieve known gotchas and pitfalls from the knowledge base. ALWAYS CHECK THIS before starting implementation in an indexed repo — avoids repeating past mistakes. Optionally filtered by stack tags.',
+            handler: async (input) => {
+                try {
+                    const gotchas = await knowledgeSearch.getGotchas(input.stack, input.limit, input.min_confidence);
+                    logger.debug('learning-tools.get_gotchas: completed', {
+                        stack: input.stack,
+                        count: gotchas.length,
+                    });
+                    return {
+                        gotchas: gotchas.map(g => ({
+                            title: g.title,
+                            content: g.content,
+                            confidence: g.confidence,
+                            stack_tags: Array.isArray(g.stack_tags) ? g.stack_tags : [],
+                            source_repo: g.source_repo ?? g.source_agent ?? 'unknown',
+                        })),
+                    };
+                }
+                catch (err) {
+                    logger.error('learning-tools.get_gotchas: error', { error: String(err) });
+                    return {
+                        error: 'GET_GOTCHAS_FAILED',
+                        message: String(err),
+                        gotchas: [],
+                    };
+                }
+            },
+        },
+        'boost_knowledge': {
+            schema: boostKnowledgeSchema,
+            description: 'Boost the confidence score of a specific knowledge item. Used by Knowledge Keeper when a knowledge item proves valuable.',
+            handler: async (input) => {
+                if (!confidenceManager || !vectorStore) {
+                    return {
+                        error: 'CONFIDENCE_UNAVAILABLE',
+                        message: 'ConfidenceManager or vector store not available. Qdrant may be down.',
+                    };
+                }
+                try {
+                    await confidenceManager.boost(vectorStore, input.knowledge_id, input.amount);
+                    logger.debug('learning-tools.boost_knowledge: completed', {
+                        knowledge_id: input.knowledge_id,
+                        amount: input.amount,
+                        reason: input.reason,
+                    });
+                    return {
+                        knowledge_id: input.knowledge_id,
+                        boosted: true,
+                        amount: input.amount,
+                        reason: input.reason,
+                    };
+                }
+                catch (err) {
+                    logger.error('learning-tools.boost_knowledge: error', { error: String(err) });
+                    return {
+                        error: 'BOOST_KNOWLEDGE_FAILED',
+                        message: String(err),
+                    };
+                }
+            },
+        },
+        'decay_knowledge': {
+            schema: decayKnowledgeSchema,
+            description: 'Apply time-based confidence decay to all knowledge items. Items not accessed within 30 days lose confidence. Used by Knowledge Keeper for maintenance.',
+            handler: async (input) => {
+                if (!confidenceManager || !vectorStore) {
+                    return {
+                        error: 'CONFIDENCE_UNAVAILABLE',
+                        message: 'ConfidenceManager or vector store not available. Qdrant may be down.',
+                    };
+                }
+                try {
+                    const decayedCount = await confidenceManager.decayAll(vectorStore, input.decay_rate);
+                    logger.debug('learning-tools.decay_knowledge: completed', {
+                        decay_rate: input.decay_rate,
+                        decayed_count: decayedCount,
+                    });
+                    return {
+                        decayed_count: decayedCount,
+                        decay_rate: input.decay_rate,
+                    };
+                }
+                catch (err) {
+                    logger.error('learning-tools.decay_knowledge: error', { error: String(err) });
+                    return {
+                        error: 'DECAY_KNOWLEDGE_FAILED',
+                        message: String(err),
+                    };
+                }
+            },
+        },
+    };
+}
+//# sourceMappingURL=learning-tools.js.map

package/dist/tools/learning-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-tools.js","sourceRoot":"","sources":["../../src/tools/learning-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/memory-tools.d.ts

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import type { VectorStore, GraphStore } from '../storage/interfaces.js';
+import type { MemoryBridge } from '../context/memory.js';
+export declare const saveObservationSchema: z.ZodObject<{
+    content: z.ZodString;
+    symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    repo_id: z.ZodOptional<z.ZodString>;
+    importance: z.ZodDefault<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    category: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural", "working"]>>;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+    importance: number;
+    tags?: string[] | undefined;
+    repo_id?: string | undefined;
+    type?: "episodic" | "semantic" | "procedural" | "working" | undefined;
+    category?: string | undefined;
+    symbols?: string[] | undefined;
+}, {
+    content: string;
+    tags?: string[] | undefined;
+    repo_id?: string | undefined;
+    type?: "episodic" | "semantic" | "procedural" | "working" | undefined;
+    category?: string | undefined;
+    importance?: number | undefined;
+    symbols?: string[] | undefined;
+}>;
+export declare const searchMemorySchema: z.ZodObject<{
+    query: z.ZodString;
+    repo_id: z.ZodOptional<z.ZodString>;
+    session_id: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    score_threshold: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    score_threshold: number;
+    query: string;
+    repo_id?: string | undefined;
+    session_id?: string | undefined;
+}, {
+    query: string;
+    repo_id?: string | undefined;
+    session_id?: string | undefined;
+    limit?: number | undefined;
+    score_threshold?: number | undefined;
+}>;
+export declare const getSessionContextSchema: z.ZodObject<{
+    query: z.ZodOptional<z.ZodString>;
+    session_count: z.ZodDefault<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    session_count: number;
+    query?: string | undefined;
+}, {
+    limit?: number | undefined;
+    query?: string | undefined;
+    session_count?: number | undefined;
+}>;
+export declare function createMemoryTools(memoryBridge: MemoryBridge, vectorStore: VectorStore | null, graphStore: GraphStore | null): {
+    save_observation: {
+        schema: z.ZodObject<{
+            content: z.ZodString;
+            symbols: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            repo_id: z.ZodOptional<z.ZodString>;
+            importance: z.ZodDefault<z.ZodNumber>;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            category: z.ZodOptional<z.ZodString>;
+            type: z.ZodOptional<z.ZodEnum<["episodic", "semantic", "procedural", "working"]>>;
+        }, "strip", z.ZodTypeAny, {
+            content: string;
+            importance: number;
+            tags?: string[] | undefined;
+            repo_id?: string | undefined;
+            type?: "episodic" | "semantic" | "procedural" | "working" | undefined;
+            category?: string | undefined;
+            symbols?: string[] | undefined;
+        }, {
+            content: string;
+            tags?: string[] | undefined;
+            repo_id?: string | undefined;
+            type?: "episodic" | "semantic" | "procedural" | "working" | undefined;
+            category?: string | undefined;
+            importance?: number | undefined;
+            symbols?: string[] | undefined;
+        }>;
+        description: string;
+        handler: (input: z.infer<typeof saveObservationSchema>) => Promise<{
+            error: string;
+            message: string;
+            stored: boolean;
+            id?: undefined;
+            linked_symbols?: undefined;
+            unresolved_symbols?: undefined;
+        } | {
+            id: string;
+            stored: boolean;
+            linked_symbols: string[];
+            unresolved_symbols: string[];
+            error?: undefined;
+            message?: undefined;
+        }>;
+    };
+    search_memory: {
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            repo_id: z.ZodOptional<z.ZodString>;
+            session_id: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodNumber>;
+            score_threshold: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            score_threshold: number;
+            query: string;
+            repo_id?: string | undefined;
+            session_id?: string | undefined;
+        }, {
+            query: string;
+            repo_id?: string | undefined;
+            session_id?: string | undefined;
+            limit?: number | undefined;
+            score_threshold?: number | undefined;
+        }>;
+        description: string;
+        handler: (input: z.infer<typeof searchMemorySchema>) => Promise<{
+            results: {
+                content: string;
+                created_at: number;
+                relevance_score: number;
+                session_id: string | undefined;
+            }[];
+            error?: undefined;
+            message?: undefined;
+        } | {
+            error: string;
+            message: string;
+            results: never[];
+        }>;
+    };
+    get_session_context: {
+        schema: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            session_count: z.ZodDefault<z.ZodNumber>;
+            limit: z.ZodDefault<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            limit: number;
+            session_count: number;
+            query?: string | undefined;
+        }, {
+            limit?: number | undefined;
+            query?: string | undefined;
+            session_count?: number | undefined;
+        }>;
+        description: string;
+        handler: (input: z.infer<typeof getSessionContextSchema>) => Promise<{
+            error: string;
+            message: string;
+            current_session: null;
+            recent_sessions: never[];
+        } | {
+            current_session: {
+                session_id: string;
+                started_at: number;
+                uptime_seconds: number;
+                observation_count: number;
+            };
+            recent_sessions: {
+                session_id: string;
+                started_at: number;
+                observations: {
+                    id: string;
+                    content: string;
+                    relevance_score: number;
+                    is_stale: boolean;
+                }[];
+            }[];
+            error?: undefined;
+            message?: undefined;
+        }>;
+    };
+};
+//# sourceMappingURL=memory-tools.d.ts.map

package/dist/tools/memory-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.d.ts","sourceRoot":"","sources":["../../src/tools/memory-tools.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAczD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;EAQhC,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;EAM7B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;EAIlC,CAAC;AAMH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,WAAW,GAAG,IAAI,EAC/B,UAAU,EAAE,UAAU,GAAG,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAMF,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBA2DrC,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAoClC,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;EA8DnE"}

package/dist/tools/memory-tools.js

@@ -0,0 +1,197 @@
+// memory-tools.ts — Swarm Learning Phase 1
+// MCP tool handlers for observation persistence and session memory.
+// Tools: save_observation, search_memory, get_session_context
+import { z } from 'zod';
+import { saveObservation } from '../memory/observation-store.js';
+import { getCurrentSessionId, getRecentSessionObservations, persistSessionMarker, getSessionInfo, } from '../memory/session-tracker.js';
+import { logger } from '../util/logger.js';
+// ---------------------------------------------------------------------------
+// Input schemas
+// ---------------------------------------------------------------------------
+export const saveObservationSchema = z.object({
+    content: z.string().min(1, 'content is required'),
+    symbols: z.array(z.string()).optional(),
+    repo_id: z.string().optional(),
+    importance: z.number().min(0).max(1).default(0.5),
+    tags: z.array(z.string()).optional(),
+    category: z.string().optional(),
+    type: z.enum(['episodic', 'semantic', 'procedural', 'working']).optional(),
+});
+export const searchMemorySchema = z.object({
+    query: z.string().min(1, 'query is required'),
+    repo_id: z.string().optional(),
+    session_id: z.string().optional(),
+    limit: z.number().int().min(1).max(50).default(10),
+    score_threshold: z.number().min(0).max(1).default(0.3),
+});
+export const getSessionContextSchema = z.object({
+    query: z.string().optional(),
+    session_count: z.number().int().min(1).max(10).default(3),
+    limit: z.number().int().min(1).max(50).default(20),
+});
+// ---------------------------------------------------------------------------
+// Tool factory
+// ---------------------------------------------------------------------------
+export function createMemoryTools(memoryBridge, vectorStore, graphStore) {
+    return {
+        'save_observation': {
+            schema: saveObservationSchema,
+            description: 'Save an observation (learning, finding, decision) to the memory system. ALWAYS USE THIS to persist important discoveries, decisions, and gotchas — they become searchable by future agents and sessions. Optionally links to code symbols in the graph.',
+            handler: async (input) => {
+                // Guard: need at least vector store to save
+                if (!vectorStore) {
+                    return {
+                        error: 'VECTOR_STORE_UNAVAILABLE',
+                        message: 'Cannot save observations without Qdrant. Observation discarded.',
+                        stored: false,
+                    };
+                }
+                try {
+                    // Use a no-op graph store if FalkorDB is unavailable
+                    const effectiveGraphStore = graphStore ?? createNoOpGraphStore();
+                    const result = await saveObservation({
+                        content: input.content,
+                        symbols: input.symbols,
+                        repoId: input.repo_id,
+                        importance: input.importance,
+                        tags: input.tags,
+                        category: input.category,
+                        sessionId: getCurrentSessionId(),
+                        type: input.type,
+                        source: 'forge',
+                    }, vectorStore, effectiveGraphStore, graphStore
+                        ? { writeVector: true, writeGraphNode: true, defaultNamespace: 'default' }
+                        : { writeVector: true, writeGraphNode: false, defaultNamespace: 'default' });
+                    logger.debug('memory-tools.save_observation: completed', {
+                        id: result.id,
+                        stored: result.stored,
+                        linkedSymbols: result.linkedSymbols.length,
+                    });
+                    return {
+                        id: result.id,
+                        stored: result.stored,
+                        linked_symbols: result.linkedSymbols,
+                        unresolved_symbols: result.unresolvedSymbols,
+                    };
+                }
+                catch (err) {
+                    logger.error('memory-tools.save_observation: error', { error: String(err) });
+                    return {
+                        error: 'SAVE_OBSERVATION_FAILED',
+                        message: String(err),
+                        stored: false,
+                    };
+                }
+            },
+        },
+        'search_memory': {
+            schema: searchMemorySchema,
+            description: 'Semantic search over observations and memories. PREFER THIS over searching CLAUDE.md or memory files for past learnings — it searches all persisted observations across sessions with vector similarity ranking.',
+            handler: async (input) => {
+                try {
+                    const results = await memoryBridge.searchMemories(input.query, {
+                        repoId: input.repo_id,
+                        sessionId: input.session_id,
+                        limit: input.limit,
+                        scoreThreshold: input.score_threshold,
+                    });
+                    logger.debug('memory-tools.search_memory: completed', {
+                        query: input.query.slice(0, 80),
+                        resultCount: results.length,
+                    });
+                    return {
+                        results: results.map(r => ({
+                            content: r.content,
+                            created_at: r.createdAt,
+                            relevance_score: r.relevanceScore,
+                            session_id: r.sessionId,
+                        })),
+                    };
+                }
+                catch (err) {
+                    logger.error('memory-tools.search_memory: error', { error: String(err) });
+                    return {
+                        error: 'SEARCH_MEMORY_FAILED',
+                        message: String(err),
+                        results: [],
+                    };
+                }
+            },
+        },
+        'get_session_context': {
+            schema: getSessionContextSchema,
+            description: 'Get context from the current and recent sessions, including observations made during this session and previous ones. Use at the START of a session to recall what was learned previously.',
+            handler: async (input) => {
+                if (!vectorStore) {
+                    return {
+                        error: 'VECTOR_STORE_UNAVAILABLE',
+                        message: 'Session context requires Qdrant.',
+                        current_session: null,
+                        recent_sessions: [],
+                    };
+                }
+                try {
+                    // Ensure current session is discoverable
+                    await persistSessionMarker(vectorStore);
+                    // Get current session info
+                    const currentSession = getSessionInfo();
+                    // Get recent observations across sessions
+                    const sessionGroups = await getRecentSessionObservations(vectorStore, {
+                        query: input.query,
+                        sessionCount: input.session_count,
+                        limit: input.limit,
+                    });
+                    logger.debug('memory-tools.get_session_context: completed', {
+                        currentSession: currentSession.sessionId,
+                        sessionGroupCount: sessionGroups.length,
+                    });
+                    return {
+                        current_session: {
+                            session_id: currentSession.sessionId,
+                            started_at: currentSession.startedAt,
+                            uptime_seconds: currentSession.uptimeSeconds,
+                            observation_count: currentSession.observationCount,
+                        },
+                        recent_sessions: sessionGroups.map(g => ({
+                            session_id: g.sessionId,
+                            started_at: g.startedAt,
+                            observations: g.observations.map(o => ({
+                                id: o.id,
+                                content: o.content,
+                                relevance_score: o.relevance_score,
+                                is_stale: o.is_stale,
+                            })),
+                        })),
+                    };
+                }
+                catch (err) {
+                    logger.error('memory-tools.get_session_context: error', { error: String(err) });
+                    return {
+                        error: 'GET_SESSION_CONTEXT_FAILED',
+                        message: String(err),
+                        current_session: null,
+                        recent_sessions: [],
+                    };
+                }
+            },
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// No-op graph store for when FalkorDB is unavailable
+// ---------------------------------------------------------------------------
+function createNoOpGraphStore() {
+    return {
+        connect: async () => { },
+        disconnect: async () => { },
+        isHealthy: async () => false,
+        query: async () => ({ nodes: [], edges: [], raw: [] }),
+        upsertNode: async () => { },
+        upsertEdge: async () => { },
+        deleteFile: async () => { },
+        deleteRepo: async () => { },
+        getCounts: async () => ({ totalNodes: 0, totalEdges: 0, byLabel: {} }),
+        ensureIndexes: async () => { },
+    };
+}
+//# sourceMappingURL=memory-tools.js.map

package/dist/tools/memory-tools.js.map

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