@mcp-graph-workflow/mcp-graph 5.5.3 → 5.6.0

package/dist/core/rag/knowledge-linker.js

@@ -0,0 +1,107 @@
+/**
+ * Knowledge Linker — creates cross-source relationships between knowledge documents
+ * based on shared nodeId, tags, and source_id patterns.
+ *
+ * v1: Lightweight linking via metadata matching (no embedding similarity).
+ */
+import { generateId } from "../utils/id.js";
+import { now } from "../utils/time.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Link knowledge documents that share context (nodeId, tags, source patterns).
+ */
+export function linkBySharedContext(db) {
+    const docs = db
+        .prepare("SELECT id, source_type, source_id, metadata FROM knowledge_documents")
+        .all();
+    const parsed = docs.map((d) => ({
+        id: d.id,
+        sourceType: d.source_type,
+        sourceId: d.source_id,
+        metadata: d.metadata ? JSON.parse(d.metadata) : null,
+    }));
+    let relationsCreated = 0;
+    const insertRelation = db.prepare(`INSERT OR IGNORE INTO knowledge_relations (id, from_doc_id, to_doc_id, relation, score, created_at)
+     VALUES (?, ?, ?, ?, ?, ?)`);
+    const timestamp = now();
+    db.transaction(() => {
+        // Strategy 1: Link by shared nodeId (score 1.0)
+        const byNodeId = new Map();
+        for (const doc of parsed) {
+            const nodeId = doc.metadata?.nodeId;
+            if (nodeId) {
+                const group = byNodeId.get(nodeId) ?? [];
+                group.push(doc);
+                byNodeId.set(nodeId, group);
+            }
+        }
+        for (const [, group] of byNodeId) {
+            if (group.length < 2)
+                continue;
+            for (let i = 0; i < group.length; i++) {
+                for (let j = i + 1; j < group.length; j++) {
+                    const result = insertRelation.run(generateId("krel"), group[i].id, group[j].id, "related_to", 1.0, timestamp);
+                    if (result.changes > 0)
+                        relationsCreated++;
+                }
+            }
+        }
+        // Strategy 2: Link by shared tags (score 0.7)
+        const byTag = new Map();
+        for (const doc of parsed) {
+            const tags = doc.metadata?.tags;
+            if (tags && Array.isArray(tags)) {
+                for (const tag of tags) {
+                    const group = byTag.get(tag) ?? [];
+                    group.push(doc);
+                    byTag.set(tag, group);
+                }
+            }
+        }
+        for (const [, group] of byTag) {
+            if (group.length < 2)
+                continue;
+            for (let i = 0; i < group.length; i++) {
+                for (let j = i + 1; j < group.length; j++) {
+                    // Skip if already linked by nodeId
+                    if (group[i].id === group[j].id)
+                        continue;
+                    const result = insertRelation.run(generateId("krel"), group[i].id, group[j].id, "related_to", 0.7, timestamp);
+                    if (result.changes > 0)
+                        relationsCreated++;
+                }
+            }
+        }
+    })();
+    logger.info("Knowledge linking completed", { relationsCreated });
+    return { relationsCreated };
+}
+/**
+ * Find documents related to a given doc via knowledge_relations.
+ * Returns docs from different source types for cross-referencing.
+ */
+export function findCrossSourceContext(db, docId, limit = 10) {
+    const rows = db
+        .prepare(`SELECT kd.* FROM knowledge_relations kr
+       JOIN knowledge_documents kd ON kd.id = kr.to_doc_id
+       WHERE kr.from_doc_id = ?
+       UNION
+       SELECT kd.* FROM knowledge_relations kr
+       JOIN knowledge_documents kd ON kd.id = kr.from_doc_id
+       WHERE kr.to_doc_id = ?
+       LIMIT ?`)
+        .all(docId, docId, limit);
+    return rows.map((row) => ({
+        id: row.id,
+        sourceType: row.source_type,
+        sourceId: row.source_id,
+        title: row.title,
+        content: row.content,
+        contentHash: row.content_hash,
+        chunkIndex: row.chunk_index,
+        metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    }));
+}
+//# sourceMappingURL=knowledge-linker.js.map

package/dist/core/rag/knowledge-linker.js.map

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

package/dist/core/rag/knowledge-quality.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Knowledge Quality Engine — scores, decays, and tracks knowledge relevance.
+ *
+ * Quality score is a composite (0–1) based on:
+ * - Freshness (0.3): exponential decay from created_at, half-life 30 days
+ * - Source reliability (0.3): static weight per source_type
+ * - Usage frequency (0.2): normalized usage_count (log scale)
+ * - Content richness (0.2): content length relative to average
+ */
+import type Database from "better-sqlite3";
+import type { KnowledgeDocument, KnowledgeSourceType } from "../../schemas/knowledge.schema.js";
+/**
+ * Get the reliability weight for a knowledge source type.
+ */
+export declare function getSourceReliabilityWeight(sourceType: KnowledgeSourceType): number;
+/**
+ * Calculate a composite quality score (0–1) for a knowledge document.
+ */
+export declare function calculateQualityScore(doc: KnowledgeDocument): number;
+/**
+ * Record a usage event for a knowledge document.
+ * Inserts into knowledge_usage_log and increments usage_count + last_accessed_at.
+ */
+export declare function recordUsage(db: Database.Database, docId: string, query: string, action: string, context?: Record<string, unknown>): void;
+/**
+ * Batch update staleness_days and quality_score for all knowledge documents.
+ */
+export declare function decayStaleKnowledge(db: Database.Database): {
+    updated: number;
+};
+//# sourceMappingURL=knowledge-quality.d.ts.map

package/dist/core/rag/knowledge-quality.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-quality.d.ts","sourceRoot":"","sources":["../../../src/core/rag/knowledge-quality.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AA6BhG;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,mBAAmB,GAAG,MAAM,CAElF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,iBAAiB,GAAG,MAAM,CAapE;AAqCD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAYN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAwC9E"}

package/dist/core/rag/knowledge-quality.js

@@ -0,0 +1,127 @@
+/**
+ * Knowledge Quality Engine — scores, decays, and tracks knowledge relevance.
+ *
+ * Quality score is a composite (0–1) based on:
+ * - Freshness (0.3): exponential decay from created_at, half-life 30 days
+ * - Source reliability (0.3): static weight per source_type
+ * - Usage frequency (0.2): normalized usage_count (log scale)
+ * - Content richness (0.2): content length relative to average
+ */
+import { now } from "../utils/time.js";
+import { logger } from "../utils/logger.js";
+const FRESHNESS_WEIGHT = 0.3;
+const RELIABILITY_WEIGHT = 0.3;
+const USAGE_WEIGHT = 0.2;
+const RICHNESS_WEIGHT = 0.2;
+/** Half-life in days for freshness decay */
+const FRESHNESS_HALF_LIFE_DAYS = 30;
+/** Average content length baseline (chars) for richness scoring */
+const AVG_CONTENT_LENGTH = 500;
+const SOURCE_RELIABILITY = {
+    docs: 0.9,
+    prd: 0.85,
+    memory: 0.8,
+    skill: 0.75,
+    web_capture: 0.7,
+    sprint_plan: 0.7,
+    code_context: 0.65,
+    ai_decision: 0.6,
+    validation_result: 0.6,
+    synthesis: 0.55,
+    phase_summary: 0.5,
+};
+/**
+ * Get the reliability weight for a knowledge source type.
+ */
+export function getSourceReliabilityWeight(sourceType) {
+    return SOURCE_RELIABILITY[sourceType] ?? 0.5;
+}
+/**
+ * Calculate a composite quality score (0–1) for a knowledge document.
+ */
+export function calculateQualityScore(doc) {
+    const freshness = calculateFreshness(doc.createdAt);
+    const reliability = getSourceReliabilityWeight(doc.sourceType);
+    const usage = calculateUsageScore(doc.usageCount ?? 0);
+    const richness = calculateRichness(doc.content);
+    const score = FRESHNESS_WEIGHT * freshness +
+        RELIABILITY_WEIGHT * reliability +
+        USAGE_WEIGHT * usage +
+        RICHNESS_WEIGHT * richness;
+    return Math.max(0, Math.min(1, score));
+}
+/**
+ * Freshness score: exponential decay with 30-day half-life.
+ * Returns 1.0 for brand-new docs, 0.5 at 30 days, ~0.25 at 60 days.
+ */
+function calculateFreshness(createdAt) {
+    const ageMs = Date.now() - new Date(createdAt).getTime();
+    const ageDays = Math.max(0, ageMs / (24 * 60 * 60 * 1000));
+    return Math.pow(0.5, ageDays / FRESHNESS_HALF_LIFE_DAYS);
+}
+/**
+ * Usage score: logarithmic scale. More usage = higher score, with diminishing returns.
+ * 0 usage → 0.0, 1 usage → 0.5, 10 usage → 0.83, 100 usage → 1.0
+ */
+function calculateUsageScore(usageCount) {
+    if (usageCount <= 0)
+        return 0;
+    return Math.min(1, Math.log10(usageCount + 1) / 2);
+}
+/**
+ * Content richness score: longer content scores higher, up to a cap.
+ */
+function calculateRichness(content) {
+    const ratio = content.length / AVG_CONTENT_LENGTH;
+    return Math.min(1, ratio);
+}
+/**
+ * Calculate staleness in days from a date string.
+ */
+function calculateStalenessDays(createdAt) {
+    const ageMs = Date.now() - new Date(createdAt).getTime();
+    return Math.max(0, Math.floor(ageMs / (24 * 60 * 60 * 1000)));
+}
+/**
+ * Record a usage event for a knowledge document.
+ * Inserts into knowledge_usage_log and increments usage_count + last_accessed_at.
+ */
+export function recordUsage(db, docId, query, action, context) {
+    const timestamp = now();
+    db.prepare("INSERT INTO knowledge_usage_log (doc_id, query, action, context, created_at) VALUES (?, ?, ?, ?, ?)").run(docId, query, action, context ? JSON.stringify(context) : null, timestamp);
+    db.prepare("UPDATE knowledge_documents SET usage_count = usage_count + 1, last_accessed_at = ? WHERE id = ?").run(timestamp, docId);
+    logger.debug("Knowledge usage recorded", { docId, action });
+}
+/**
+ * Batch update staleness_days and quality_score for all knowledge documents.
+ */
+export function decayStaleKnowledge(db) {
+    const rows = db
+        .prepare("SELECT id, source_type, content, content_hash, created_at, usage_count FROM knowledge_documents")
+        .all();
+    const update = db.prepare("UPDATE knowledge_documents SET staleness_days = ?, quality_score = ? WHERE id = ?");
+    let updated = 0;
+    db.transaction(() => {
+        for (const row of rows) {
+            const stalenessDays = calculateStalenessDays(row.created_at);
+            const doc = {
+                id: row.id,
+                sourceType: row.source_type,
+                sourceId: "",
+                title: "",
+                content: row.content,
+                contentHash: row.content_hash,
+                chunkIndex: 0,
+                createdAt: row.created_at,
+                updatedAt: row.created_at,
+                usageCount: row.usage_count,
+            };
+            const qualityScore = calculateQualityScore(doc);
+            update.run(stalenessDays, qualityScore, row.id);
+            updated++;
+        }
+    })();
+    logger.info("Knowledge staleness decay completed", { updated });
+    return { updated };
+}
+//# sourceMappingURL=knowledge-quality.js.map

package/dist/core/rag/knowledge-quality.js.map

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

package/dist/core/rag/knowledge-synthesizer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Knowledge Synthesizer — generates derived knowledge by analyzing patterns
+ * across existing knowledge documents.
+ *
+ * This is the "self-learning" layer: the system creates new knowledge from
+ * patterns found in AI decisions, sprint reports, and validation results.
+ */
+import type Database from "better-sqlite3";
+export interface SynthesisResult {
+    synthesized: number;
+    strategies: Record<string, number>;
+}
+/**
+ * Run all synthesis strategies and store derived knowledge.
+ */
+export declare function runSynthesisCycle(db: Database.Database): SynthesisResult;
+//# sourceMappingURL=knowledge-synthesizer.d.ts.map

package/dist/core/rag/knowledge-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-synthesizer.d.ts","sourceRoot":"","sources":["../../../src/core/rag/knowledge-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,eAAe,CAiBxE"}

package/dist/core/rag/knowledge-synthesizer.js

@@ -0,0 +1,115 @@
+/**
+ * Knowledge Synthesizer — generates derived knowledge by analyzing patterns
+ * across existing knowledge documents.
+ *
+ * This is the "self-learning" layer: the system creates new knowledge from
+ * patterns found in AI decisions, sprint reports, and validation results.
+ */
+import { KnowledgeStore } from "../store/knowledge-store.js";
+import { logger } from "../utils/logger.js";
+const MIN_DOCS_FOR_SYNTHESIS = 3;
+/**
+ * Run all synthesis strategies and store derived knowledge.
+ */
+export function runSynthesisCycle(db) {
+    const store = new KnowledgeStore(db);
+    let synthesized = 0;
+    const strategies = {};
+    // Strategy 1: Error/Decision pattern detection from ai_decision docs
+    const decisionCount = synthesizeDecisionPatterns(db, store);
+    strategies.decisionPatterns = decisionCount;
+    synthesized += decisionCount;
+    // Strategy 2: Sprint trend analysis from sprint_plan docs
+    const sprintCount = synthesizeSprintTrends(db, store);
+    strategies.sprintTrends = sprintCount;
+    synthesized += sprintCount;
+    logger.info("Synthesis cycle complete", { synthesized, strategies });
+    return { synthesized, strategies };
+}
+/**
+ * Strategy 1: Detect patterns in AI decisions by grouping by shared tags.
+ * When multiple decisions share a tag, synthesize a "pattern" document.
+ */
+function synthesizeDecisionPatterns(db, store) {
+    const decisions = db
+        .prepare("SELECT id, title, content, metadata FROM knowledge_documents WHERE source_type = 'ai_decision'")
+        .all();
+    if (decisions.length < MIN_DOCS_FOR_SYNTHESIS)
+        return 0;
+    // Group by tags
+    const byTag = new Map();
+    for (const dec of decisions) {
+        const meta = dec.metadata ? JSON.parse(dec.metadata) : {};
+        const tags = (meta.tags ?? []);
+        for (const tag of tags) {
+            const group = byTag.get(tag) ?? [];
+            group.push({ title: dec.title, content: dec.content });
+            byTag.set(tag, group);
+        }
+    }
+    let synthesized = 0;
+    for (const [tag, group] of byTag) {
+        if (group.length < MIN_DOCS_FOR_SYNTHESIS)
+            continue;
+        const summaryLines = group.map((d) => `- ${d.title}: ${d.content.slice(0, 200)}`);
+        const content = `# Pattern Synthesis: "${tag}"\n\nFound ${group.length} decisions related to "${tag}":\n\n${summaryLines.join("\n")}\n\n## Insight\nMultiple decisions share the "${tag}" theme. Consider creating a shared strategy or guideline for this topic.`;
+        const sourceId = `synthesis:pattern:${tag}`;
+        store.insert({
+            sourceType: "synthesis",
+            sourceId,
+            title: `Pattern: ${tag} (${group.length} decisions)`,
+            content,
+            metadata: {
+                strategy: "decision_patterns",
+                tag,
+                decisionCount: group.length,
+                phase: "REVIEW",
+                indexedAt: new Date().toISOString(),
+            },
+        });
+        synthesized++;
+    }
+    return synthesized;
+}
+/**
+ * Strategy 2: Analyze sprint plan trends across multiple sprints.
+ */
+function synthesizeSprintTrends(db, store) {
+    const sprints = db
+        .prepare("SELECT content, metadata FROM knowledge_documents WHERE source_type = 'sprint_plan' ORDER BY created_at")
+        .all();
+    if (sprints.length < MIN_DOCS_FOR_SYNTHESIS)
+        return 0;
+    const velocities = [];
+    for (const sprint of sprints) {
+        const meta = sprint.metadata ? JSON.parse(sprint.metadata) : {};
+        if (typeof meta.velocity === "number") {
+            velocities.push(meta.velocity);
+        }
+    }
+    if (velocities.length < 2)
+        return 0;
+    const avgVelocity = velocities.reduce((a, b) => a + b, 0) / velocities.length;
+    const trend = velocities.length >= 2
+        ? velocities[velocities.length - 1] - velocities[0]
+        : 0;
+    const trendDirection = trend > 0 ? "improving" : trend < 0 ? "declining" : "stable";
+    const content = `# Sprint Velocity Trend Analysis\n\nAnalyzed ${velocities.length} sprints.\n\n- Average velocity: ${avgVelocity.toFixed(1)}\n- Trend: ${trendDirection} (${trend > 0 ? "+" : ""}${trend.toFixed(1)})\n- Latest velocity: ${velocities[velocities.length - 1]}\n\n## Recommendation\n${trendDirection === "improving" ? "Velocity is improving. Consider slightly increasing sprint capacity." : trendDirection === "declining" ? "Velocity is declining. Investigate blockers and reduce WIP." : "Velocity is stable. Current capacity planning is well-calibrated."}`;
+    const sourceId = `synthesis:sprint_trend:${new Date().toISOString()}`;
+    store.insert({
+        sourceType: "synthesis",
+        sourceId,
+        title: `Sprint Trend: ${trendDirection} (avg ${avgVelocity.toFixed(1)})`,
+        content,
+        metadata: {
+            strategy: "sprint_trends",
+            sprintCount: sprints.length,
+            avgVelocity,
+            trend: trendDirection,
+            phase: "PLAN",
+            indexedAt: new Date().toISOString(),
+        },
+    });
+    return 1;
+}
+//# sourceMappingURL=knowledge-synthesizer.js.map

package/dist/core/rag/knowledge-synthesizer.js.map

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

package/dist/core/rag/memory-rag-query.d.ts

@@ -10,8 +10,8 @@
  */
 import type { SqliteStore } from "../store/sqlite-store.js";
 export interface MemoryRagOptions {
-    /** Search mode: fts (keyword), semantic (embeddings), hybrid (both) */
-    mode?: "fts" | "semantic" | "hybrid";
+    /** Search mode: fts (keyword), semantic (embeddings), hybrid (both), multi (multi-strategy) */
+    mode?: "fts" | "semantic" | "hybrid" | "multi";
     /** Maximum results to return */
     limit?: number;
 }
@@ -25,7 +25,7 @@ export interface MemoryRagResultItem {
 }
 export interface MemoryRagResult {
     query: string;
-    mode: "fts" | "semantic" | "hybrid";
+    mode: "fts" | "semantic" | "hybrid" | "multi";
     results: MemoryRagResultItem[];
     totalMemoryDocuments: number;
 }

package/dist/core/rag/memory-rag-query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-rag-query.d.ts","sourceRoot":"","sources":["../../../src/core/rag/memory-rag-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAM5D,MAAM,WAAW,gBAAgB;IAC/B,uEAAuE;IACvE,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IACrC,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAKD;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CAwE1B"}
+{"version":3,"file":"memory-rag-query.d.ts","sourceRoot":"","sources":["../../../src/core/rag/memory-rag-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAO5D,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC/C,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,GAAG,UAAU,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC9C,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAKD;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC,CA0F1B"}

package/dist/core/rag/memory-rag-query.js

@@ -11,6 +11,7 @@
 import { KnowledgeStore } from "../store/knowledge-store.js";
 import { EmbeddingStore } from "./embedding-store.js";
 import { indexAllEmbeddings, semanticSearch } from "./rag-pipeline.js";
+import { multiStrategySearch } from "./multi-strategy-retrieval.js";
 import { logger } from "../utils/logger.js";
 /** Source types to include in memory queries (backward compat with "serena") */
 const MEMORY_SOURCE_TYPES = new Set(["memory", "serena"]);
@@ -28,6 +29,23 @@ export async function queryMemories(store, query, options) {
     }
     const results = [];
     const seenIds = new Set();
+    // Multi-strategy search (combines FTS, graph, quality, recency)
+    if (mode === "multi") {
+        const multiResults = multiStrategySearch(store.getDb(), query, { limit });
+        for (const r of multiResults) {
+            if (!MEMORY_SOURCE_TYPES.has(r.sourceType))
+                continue;
+            results.push({
+                id: r.id,
+                title: r.title,
+                content: r.content,
+                sourceId: r.sourceId,
+                score: r.score,
+                method: "fts",
+            });
+        }
+        return { query, mode, results: results.slice(0, limit), totalMemoryDocuments };
+    }
     // FTS search
     if (mode === "fts" || mode === "hybrid") {
         const ftsResults = knowledgeStore.search(query, limit);

package/dist/core/rag/memory-rag-query.js.map

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

package/dist/core/rag/multi-strategy-retrieval.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Multi-Strategy Retrieval — combines FTS5, graph traversal, quality scoring,
+ * and recency boost into a unified search pipeline.
+ *
+ * Strategies:
+ * 1. FTS5 + BM25 (weight 0.4)
+ * 2. Graph traversal via knowledge_relations (weight 0.3)
+ * 3. Recency boost (weight 0.2)
+ * 4. Quality score multiplier (weight 0.1)
+ *
+ * Results merged via Reciprocal Rank Fusion (RRF).
+ */
+import type Database from "better-sqlite3";
+export interface RankedResult {
+    id: string;
+    sourceType: string;
+    sourceId: string;
+    title: string;
+    content: string;
+    score: number;
+    qualityScore: number;
+    strategies: string[];
+}
+interface SearchOptions {
+    limit?: number;
+    minQuality?: number;
+    phase?: string;
+}
+/**
+ * Reciprocal Rank Fusion — merge multiple ranked lists into one.
+ * score = Σ(1 / (k + rank_i))
+ */
+export declare function reciprocalRankFusion(rankedLists: Array<Array<{
+    id: string;
+    score: number;
+}>>): Array<{
+    id: string;
+    rrfScore: number;
+}>;
+/**
+ * Multi-strategy knowledge search combining FTS, graph relations,
+ * quality scoring, and recency.
+ */
+export declare function multiStrategySearch(db: Database.Database, query: string, options?: SearchOptions): RankedResult[];
+export {};
+//# sourceMappingURL=multi-strategy-retrieval.d.ts.map

package/dist/core/rag/multi-strategy-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-strategy-retrieval.d.ts","sourceRoot":"","sources":["../../../src/core/rag/multi-strategy-retrieval.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,GACvD,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAczC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,EAAE,CAmHhB"}