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

package/dist/core/rag/chunk-text.js

@@ -94,6 +94,141 @@ function hardSplit(text, maxTokens, overlapTokens) {
     }
     return chunks;
 }
+/**
+ * Content-type-aware chunking strategy.
+ * Selects chunk size and splitting strategy based on source type.
+ */
+export function smartChunk(text, contentType, options) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [];
+    switch (contentType) {
+        case "docs":
+            return chunkByStrategy(trimmed, {
+                maxTokens: options?.maxTokens ?? 800,
+                overlapTokens: options?.overlapTokens ?? 80,
+                splitFn: splitPreservingCodeBlocks,
+            });
+        case "prd":
+        case "design":
+            return chunkByStrategy(trimmed, {
+                maxTokens: options?.maxTokens ?? 600,
+                overlapTokens: options?.overlapTokens ?? 60,
+                splitFn: splitByMarkdownHeaders,
+            });
+        case "memory":
+        case "ai_decision":
+        case "synthesis":
+            return chunkText(trimmed, {
+                maxTokens: options?.maxTokens ?? 300,
+                overlapTokens: options?.overlapTokens ?? 30,
+            });
+        case "code_context":
+            return chunkByStrategy(trimmed, {
+                maxTokens: options?.maxTokens ?? 500,
+                overlapTokens: options?.overlapTokens ?? 50,
+                splitFn: splitByCodeBoundaries,
+            });
+        case "web_capture":
+            return chunkText(trimmed, {
+                maxTokens: options?.maxTokens ?? 500,
+                overlapTokens: options?.overlapTokens ?? 50,
+            });
+        default:
+            return chunkText(trimmed, options);
+    }
+}
+/**
+ * Chunk text using a custom split function, then merge segments up to maxTokens.
+ */
+function chunkByStrategy(text, opts) {
+    const totalTokens = estimateTokens(text);
+    if (totalTokens <= opts.maxTokens) {
+        return [{ index: 0, content: text, tokens: totalTokens }];
+    }
+    const segments = opts.splitFn(text);
+    const chunks = [];
+    let current = [];
+    let currentTokens = 0;
+    for (const segment of segments) {
+        const segTokens = estimateTokens(segment);
+        // If single segment exceeds max, chunk it with default splitter
+        if (segTokens > opts.maxTokens && current.length === 0) {
+            const subChunks = chunkText(segment, {
+                maxTokens: opts.maxTokens,
+                overlapTokens: opts.overlapTokens,
+            });
+            for (const sc of subChunks) {
+                chunks.push({ index: chunks.length, content: sc.content, tokens: sc.tokens });
+            }
+            continue;
+        }
+        if (currentTokens + segTokens > opts.maxTokens && current.length > 0) {
+            const chunkContent = current.join("\n\n").trim();
+            if (chunkContent) {
+                chunks.push({
+                    index: chunks.length,
+                    content: chunkContent,
+                    tokens: estimateTokens(chunkContent),
+                });
+            }
+            current = [];
+            currentTokens = 0;
+        }
+        current.push(segment);
+        currentTokens += segTokens;
+    }
+    if (current.length > 0) {
+        const chunkContent = current.join("\n\n").trim();
+        if (chunkContent) {
+            chunks.push({
+                index: chunks.length,
+                content: chunkContent,
+                tokens: estimateTokens(chunkContent),
+            });
+        }
+    }
+    return chunks;
+}
+/**
+ * Split text preserving code blocks as atomic units.
+ */
+function splitPreservingCodeBlocks(text) {
+    const parts = [];
+    const codeBlockRegex = /```[\s\S]*?```/g;
+    let lastIndex = 0;
+    let match;
+    while ((match = codeBlockRegex.exec(text)) !== null) {
+        // Text before code block
+        const before = text.slice(lastIndex, match.index).trim();
+        if (before) {
+            parts.push(...before.split(/\n\n+/).filter((s) => s.trim()));
+        }
+        // Code block as atomic unit
+        parts.push(match[0]);
+        lastIndex = match.index + match[0].length;
+    }
+    // Remaining text
+    const remaining = text.slice(lastIndex).trim();
+    if (remaining) {
+        parts.push(...remaining.split(/\n\n+/).filter((s) => s.trim()));
+    }
+    return parts;
+}
+/**
+ * Split by markdown headers (h1, h2, h3).
+ */
+function splitByMarkdownHeaders(text) {
+    const sections = text.split(/(?=^#{1,3}\s)/m);
+    return sections.filter((s) => s.trim());
+}
+/**
+ * Split by code boundaries (function/class/export declarations).
+ */
+function splitByCodeBoundaries(text) {
+    const sections = text.split(/(?=\n(?:export\s+)?(?:function|class|interface|type|const|enum)\s)/);
+    return sections.filter((s) => s.trim());
+}
 /**
  * Build overlap sentences from the tail of the current sentence list.
  */

package/dist/core/rag/chunk-text.js.map

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

package/dist/core/rag/code-context-indexer.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Code Context Indexer — captures code analysis results (symbols, flows)
+ * into the knowledge store for RAG retrieval.
+ */
+import type { KnowledgeStore } from "../store/knowledge-store.js";
+export interface CodeSymbolInput {
+    name: string;
+    kind: string;
+    file: string;
+    exported: boolean;
+}
+export interface ProcessFlowInput {
+    name: string;
+    steps: string[];
+}
+export interface CodeAnalysisInput {
+    symbols: CodeSymbolInput[];
+    flows: ProcessFlowInput[];
+}
+export interface IndexResult {
+    documentsIndexed: number;
+}
+/**
+ * Index code analysis results into the knowledge store.
+ */
+export declare function indexCodeAnalysis(store: KnowledgeStore, analysis: CodeAnalysisInput): IndexResult;
+//# sourceMappingURL=code-context-indexer.d.ts.map

package/dist/core/rag/code-context-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-context-indexer.d.ts","sourceRoot":"","sources":["../../../src/core/rag/code-context-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,iBAAiB,GAC1B,WAAW,CAmDb"}

package/dist/core/rag/code-context-indexer.js

@@ -0,0 +1,53 @@
+/**
+ * Code Context Indexer — captures code analysis results (symbols, flows)
+ * into the knowledge store for RAG retrieval.
+ */
+import { logger } from "../utils/logger.js";
+/**
+ * Index code analysis results into the knowledge store.
+ */
+export function indexCodeAnalysis(store, analysis) {
+    let documentsIndexed = 0;
+    // Index symbols summary
+    if (analysis.symbols.length > 0) {
+        const symbolLines = analysis.symbols.map((s) => `- ${s.kind} ${s.name} (${s.file})${s.exported ? " [exported]" : ""}`);
+        const content = `# Code Symbols\n\n${symbolLines.join("\n")}`;
+        store.insert({
+            sourceType: "code_context",
+            sourceId: `code_symbols:${new Date().toISOString()}`,
+            title: `Code Symbols (${analysis.symbols.length} symbols)`,
+            content,
+            metadata: {
+                symbolCount: analysis.symbols.length,
+                files: [...new Set(analysis.symbols.map((s) => s.file))],
+                phase: "IMPLEMENT",
+                indexedAt: new Date().toISOString(),
+            },
+        });
+        documentsIndexed++;
+    }
+    // Index process flows
+    for (const flow of analysis.flows) {
+        const content = `# Process Flow: ${flow.name}\n\n${flow.steps.map((s) => `→ ${s}`).join("\n")}`;
+        store.insert({
+            sourceType: "code_context",
+            sourceId: `code_flow:${flow.name}`,
+            title: `Flow: ${flow.name}`,
+            content,
+            metadata: {
+                flowName: flow.name,
+                stepCount: flow.steps.length,
+                phase: "IMPLEMENT",
+                indexedAt: new Date().toISOString(),
+            },
+        });
+        documentsIndexed++;
+    }
+    logger.info("Code analysis indexed", {
+        symbols: analysis.symbols.length,
+        flows: analysis.flows.length,
+        documentsIndexed,
+    });
+    return { documentsIndexed };
+}
+//# sourceMappingURL=code-context-indexer.js.map

package/dist/core/rag/code-context-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-context-indexer.js","sourceRoot":"","sources":["../../../src/core/rag/code-context-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAuB5C;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,QAA2B;IAE3B,IAAI,gBAAgB,GAAG,CAAC,CAAC;IAEzB,wBAAwB;IACxB,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CACtC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,CAC7E,CAAC;QACF,MAAM,OAAO,GAAG,qBAAqB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAE9D,KAAK,CAAC,MAAM,CAAC;YACX,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE;YACpD,KAAK,EAAE,iBAAiB,QAAQ,CAAC,OAAO,CAAC,MAAM,WAAW;YAC1D,OAAO;YACP,QAAQ,EAAE;gBACR,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;gBACpC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxD,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;QACH,gBAAgB,EAAE,CAAC;IACrB,CAAC;IAED,sBAAsB;IACtB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,mBAAmB,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAEhG,KAAK,CAAC,MAAM,CAAC;YACX,UAAU,EAAE,cAAc;YAC1B,QAAQ,EAAE,aAAa,IAAI,CAAC,IAAI,EAAE;YAClC,KAAK,EAAE,SAAS,IAAI,CAAC,IAAI,EAAE;YAC3B,OAAO;YACP,QAAQ,EAAE;gBACR,QAAQ,EAAE,IAAI,CAAC,IAAI;gBACnB,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;gBAC5B,KAAK,EAAE,WAAW;gBAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC;SACF,CAAC,CAAC;QACH,gBAAgB,EAAE,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,uBAAuB,EAAE;QACnC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;QAChC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM;QAC5B,gBAAgB;KACjB,CAAC,CAAC;IAEH,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC9B,CAAC"}

package/dist/core/rag/decision-indexer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Decision Indexer — captures AI decisions/rationale when tasks complete.
+ * Indexes the explicit rationale from update_status(done) into knowledge store.
+ */
+import type { KnowledgeStore } from "../store/knowledge-store.js";
+export interface DecisionInput {
+    nodeId: string;
+    title: string;
+    rationale: string;
+    tags: string[];
+}
+export interface IndexResult {
+    documentsIndexed: number;
+    skippedDuplicates: number;
+}
+/**
+ * Index an AI decision into the knowledge store.
+ */
+export declare function indexDecision(store: KnowledgeStore, decision: DecisionInput): IndexResult;
+//# sourceMappingURL=decision-indexer.d.ts.map

package/dist/core/rag/decision-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-indexer.d.ts","sourceRoot":"","sources":["../../../src/core/rag/decision-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAGlE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,aAAa,GACtB,WAAW,CA0Bb"}

package/dist/core/rag/decision-indexer.js

@@ -0,0 +1,32 @@
+/**
+ * Decision Indexer — captures AI decisions/rationale when tasks complete.
+ * Indexes the explicit rationale from update_status(done) into knowledge store.
+ */
+import { logger } from "../utils/logger.js";
+/**
+ * Index an AI decision into the knowledge store.
+ */
+export function indexDecision(store, decision) {
+    const content = `# Decision: ${decision.title}\n\n${decision.rationale}`;
+    const sourceId = `ai_decision:${decision.nodeId}`;
+    const doc = store.insert({
+        sourceType: "ai_decision",
+        sourceId,
+        title: `Decision: ${decision.title}`,
+        content,
+        metadata: {
+            nodeId: decision.nodeId,
+            tags: decision.tags,
+            phase: "IMPLEMENT",
+            indexedAt: new Date().toISOString(),
+        },
+    });
+    // Check if it was a dedup hit (existing doc returned)
+    const isNew = doc.sourceId === sourceId;
+    logger.info("Decision indexed", { nodeId: decision.nodeId, docId: doc.id, isNew });
+    return {
+        documentsIndexed: isNew ? 1 : 0,
+        skippedDuplicates: isNew ? 0 : 1,
+    };
+}
+//# sourceMappingURL=decision-indexer.js.map

package/dist/core/rag/decision-indexer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-indexer.js","sourceRoot":"","sources":["../../../src/core/rag/decision-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAc5C;;GAEG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAqB,EACrB,QAAuB;IAEvB,MAAM,OAAO,GAAG,eAAe,QAAQ,CAAC,KAAK,OAAO,QAAQ,CAAC,SAAS,EAAE,CAAC;IACzE,MAAM,QAAQ,GAAG,eAAe,QAAQ,CAAC,MAAM,EAAE,CAAC;IAElD,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;QACvB,UAAU,EAAE,aAAa;QACzB,QAAQ;QACR,KAAK,EAAE,aAAa,QAAQ,CAAC,KAAK,EAAE;QACpC,OAAO;QACP,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,KAAK,EAAE,WAAW;YAClB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC;KACF,CAAC,CAAC;IAEH,sDAAsD;IACtD,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IAExC,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;IAEnF,OAAO;QACL,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC"}

package/dist/core/rag/journey-indexer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Journey Indexer — indexes journey maps (screens, edges, variants) into the knowledge store.
+ * Makes journey data discoverable via RAG queries so the AI can use it as context.
+ */
+import { KnowledgeStore } from "../store/knowledge-store.js";
+import { JourneyStore } from "../journey/journey-store.js";
+export interface JourneyIndexResult {
+    mapsIndexed: number;
+    documentsIndexed: number;
+}
+/**
+ * Index all journey maps from the database into the knowledge store.
+ * Each screen becomes a separate document, plus an overview doc per map.
+ */
+export declare function indexJourneyMaps(knowledgeStore: KnowledgeStore, journeyStore: JourneyStore): JourneyIndexResult;
+//# sourceMappingURL=journey-indexer.d.ts.map

package/dist/core/rag/journey-indexer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey-indexer.d.ts","sourceRoot":"","sources":["../../../src/core/rag/journey-indexer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAA6D,MAAM,6BAA6B,CAAC;AAItH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AA0GD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,GACzB,kBAAkB,CA6FpB"}

package/dist/core/rag/journey-indexer.js

@@ -0,0 +1,182 @@
+/**
+ * Journey Indexer — indexes journey maps (screens, edges, variants) into the knowledge store.
+ * Makes journey data discoverable via RAG queries so the AI can use it as context.
+ */
+import { chunkText } from "./chunk-text.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Format a single screen into a rich text representation for the knowledge store.
+ * Includes all contextual data: fields, CTAs, URL, type, connections.
+ */
+function formatScreenContent(screen, edges, allScreens) {
+    const lines = [];
+    lines.push(`# ${screen.title}`);
+    lines.push(`Type: ${screen.screenType}`);
+    if (screen.url)
+        lines.push(`URL: ${screen.url}`);
+    if (screen.description)
+        lines.push(`\n${screen.description}`);
+    // Form fields
+    if (screen.fields && screen.fields.length > 0) {
+        lines.push(`\n## Form Fields (${screen.fields.length})`);
+        for (const field of screen.fields) {
+            const req = field.required ? " *required*" : "";
+            const opts = field.options ? ` [${field.options.join(", ")}]` : "";
+            lines.push(`- ${field.label ?? field.name} (${field.type})${req}${opts}`);
+        }
+    }
+    // CTAs
+    if (screen.ctas && screen.ctas.length > 0) {
+        lines.push(`\n## CTAs`);
+        for (const cta of screen.ctas) {
+            lines.push(`- ${cta}`);
+        }
+    }
+    // Outgoing navigations
+    const outEdges = edges.filter((e) => e.from === screen.id);
+    if (outEdges.length > 0) {
+        lines.push(`\n## Navigates To`);
+        for (const edge of outEdges) {
+            const target = allScreens.get(edge.to);
+            const targetName = target ? target.title : edge.to;
+            lines.push(`- ${edge.label ?? edge.type} -> ${targetName}`);
+        }
+    }
+    // Incoming navigations
+    const inEdges = edges.filter((e) => e.to === screen.id);
+    if (inEdges.length > 0) {
+        lines.push(`\n## Reached From`);
+        for (const edge of inEdges) {
+            const source = allScreens.get(edge.from);
+            const sourceName = source ? source.title : edge.from;
+            lines.push(`- ${sourceName} via ${edge.label ?? edge.type}`);
+        }
+    }
+    // Metadata
+    if (screen.metadata && Object.keys(screen.metadata).length > 0) {
+        lines.push(`\n## Metadata`);
+        for (const [key, value] of Object.entries(screen.metadata)) {
+            lines.push(`- ${key}: ${JSON.stringify(value)}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Format the full journey map overview (summary of all screens and flows).
+ */
+function formatMapOverview(map) {
+    const lines = [];
+    lines.push(`# Journey Map: ${map.name}`);
+    if (map.url)
+        lines.push(`Site: ${map.url}`);
+    if (map.description)
+        lines.push(`\n${map.description}`);
+    lines.push(`\n## Screens (${map.screens.length})`);
+    for (const screen of map.screens) {
+        const fieldCount = screen.fields?.length ?? 0;
+        const ctaCount = screen.ctas?.length ?? 0;
+        lines.push(`- ${screen.title} [${screen.screenType}]${fieldCount > 0 ? ` ${fieldCount} fields` : ""}${ctaCount > 0 ? ` ${ctaCount} CTAs` : ""}`);
+    }
+    lines.push(`\n## User Flows (${map.edges.length} connections)`);
+    const screenMap = new Map(map.screens.map((s) => [s.id, s]));
+    for (const edge of map.edges) {
+        const from = screenMap.get(edge.from);
+        const to = screenMap.get(edge.to);
+        lines.push(`- ${from?.title ?? edge.from} -> ${to?.title ?? edge.to}: ${edge.label ?? edge.type}`);
+    }
+    if (map.variants.length > 0) {
+        lines.push(`\n## A/B Variants (${map.variants.length})`);
+        for (const variant of map.variants) {
+            const pathNames = variant.path.map((id) => screenMap.get(id)?.title ?? id);
+            lines.push(`- ${variant.name}: ${pathNames.join(" -> ")}`);
+            if (variant.description)
+                lines.push(`  ${variant.description}`);
+        }
+    }
+    return lines.join("\n");
+}
+/**
+ * Index all journey maps from the database into the knowledge store.
+ * Each screen becomes a separate document, plus an overview doc per map.
+ */
+export function indexJourneyMaps(knowledgeStore, journeyStore) {
+    const maps = journeyStore.listMaps();
+    if (maps.length === 0) {
+        logger.info("No journey maps to index");
+        return { mapsIndexed: 0, documentsIndexed: 0 };
+    }
+    // Clean previous journey knowledge — delete each map's documents
+    for (const mapSummary of maps) {
+        knowledgeStore.deleteBySource("journey", `journey:map:${mapSummary.id}`);
+        const map = journeyStore.getMap(mapSummary.id);
+        if (map) {
+            for (const screen of map.screens) {
+                knowledgeStore.deleteBySource("journey", `journey:screen:${screen.id}`);
+            }
+        }
+    }
+    let totalDocs = 0;
+    for (const mapSummary of maps) {
+        const map = journeyStore.getMap(mapSummary.id);
+        if (!map)
+            continue;
+        const screenMap = new Map(map.screens.map((s) => [s.id, s]));
+        // 1. Index the map overview
+        const overviewContent = formatMapOverview(map);
+        const overviewChunks = chunkText(overviewContent);
+        const overviewSourceId = `journey:map:${map.id}`;
+        knowledgeStore.insertChunks(overviewChunks.map((chunk) => ({
+            sourceType: "journey",
+            sourceId: overviewSourceId,
+            title: overviewChunks.length > 1
+                ? `Journey: ${map.name} [overview ${chunk.index + 1}/${overviewChunks.length}]`
+                : `Journey: ${map.name} [overview]`,
+            content: chunk.content,
+            chunkIndex: chunk.index,
+            metadata: {
+                mapId: map.id,
+                mapName: map.name,
+                url: map.url,
+                screenCount: map.screens.length,
+                edgeCount: map.edges.length,
+                variantCount: map.variants.length,
+                docType: "overview",
+            },
+        })));
+        totalDocs += overviewChunks.length;
+        // 2. Index each screen individually
+        for (const screen of map.screens) {
+            const screenContent = formatScreenContent(screen, map.edges, screenMap);
+            const screenChunks = chunkText(screenContent);
+            const screenSourceId = `journey:screen:${screen.id}`;
+            knowledgeStore.insertChunks(screenChunks.map((chunk) => ({
+                sourceType: "journey",
+                sourceId: screenSourceId,
+                title: screenChunks.length > 1
+                    ? `Journey: ${map.name} > ${screen.title} [${chunk.index + 1}/${screenChunks.length}]`
+                    : `Journey: ${map.name} > ${screen.title}`,
+                content: chunk.content,
+                chunkIndex: chunk.index,
+                metadata: {
+                    mapId: map.id,
+                    mapName: map.name,
+                    screenId: screen.id,
+                    screenType: screen.screenType,
+                    url: screen.url,
+                    fieldCount: screen.fields?.length ?? 0,
+                    ctaCount: screen.ctas?.length ?? 0,
+                    docType: "screen",
+                },
+            })));
+            totalDocs += screenChunks.length;
+        }
+        logger.info("Journey map indexed", {
+            mapId: map.id,
+            name: map.name,
+            screens: map.screens.length,
+            documents: totalDocs,
+        });
+    }
+    return { mapsIndexed: maps.length, documentsIndexed: totalDocs };
+}
+//# sourceMappingURL=journey-indexer.js.map

package/dist/core/rag/journey-indexer.js.map

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

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

@@ -0,0 +1,15 @@
+/**
+ * Knowledge Feedback — applies user/AI feedback to adjust quality scores.
+ *
+ * Actions:
+ * - helpful: +0.05 quality (cap 1.0)
+ * - unhelpful: -0.1 quality (floor 0.1)
+ * - outdated: set staleness_days = 999
+ */
+import type Database from "better-sqlite3";
+/**
+ * Apply feedback to a knowledge document.
+ * Records usage and adjusts quality_score accordingly.
+ */
+export declare function applyFeedback(db: Database.Database, docId: string, query: string, action: "helpful" | "unhelpful" | "outdated", context?: Record<string, unknown>): void;
+//# sourceMappingURL=knowledge-feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-feedback.d.ts","sourceRoot":"","sources":["../../../src/core/rag/knowledge-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAS3C;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,EAC5C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAgCN"}

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

@@ -0,0 +1,46 @@
+/**
+ * Knowledge Feedback — applies user/AI feedback to adjust quality scores.
+ *
+ * Actions:
+ * - helpful: +0.05 quality (cap 1.0)
+ * - unhelpful: -0.1 quality (floor 0.1)
+ * - outdated: set staleness_days = 999
+ */
+import { recordUsage } from "./knowledge-quality.js";
+import { logger } from "../utils/logger.js";
+const HELPFUL_BOOST = 0.05;
+const UNHELPFUL_PENALTY = 0.1;
+const QUALITY_MAX = 1.0;
+const QUALITY_MIN = 0.1;
+/**
+ * Apply feedback to a knowledge document.
+ * Records usage and adjusts quality_score accordingly.
+ */
+export function applyFeedback(db, docId, query, action, context) {
+    // Record the usage event
+    recordUsage(db, docId, query, action, context);
+    // Get current quality score
+    const row = db
+        .prepare("SELECT quality_score FROM knowledge_documents WHERE id = ?")
+        .get(docId);
+    if (!row) {
+        logger.warn("Feedback for unknown doc", { docId, action });
+        return;
+    }
+    let newScore = row.quality_score;
+    switch (action) {
+        case "helpful":
+            newScore = Math.min(QUALITY_MAX, newScore + HELPFUL_BOOST);
+            break;
+        case "unhelpful":
+            newScore = Math.max(QUALITY_MIN, newScore - UNHELPFUL_PENALTY);
+            break;
+        case "outdated":
+            db.prepare("UPDATE knowledge_documents SET staleness_days = 999 WHERE id = ?").run(docId);
+            newScore = Math.max(QUALITY_MIN, newScore - UNHELPFUL_PENALTY);
+            break;
+    }
+    db.prepare("UPDATE knowledge_documents SET quality_score = ? WHERE id = ?").run(newScore, docId);
+    logger.info("Feedback applied", { docId, action, oldScore: row.quality_score, newScore });
+}
+//# sourceMappingURL=knowledge-feedback.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-feedback.js","sourceRoot":"","sources":["../../../src/core/rag/knowledge-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,aAAa,GAAG,IAAI,CAAC;AAC3B,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAC9B,MAAM,WAAW,GAAG,GAAG,CAAC;AACxB,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAqB,EACrB,KAAa,EACb,KAAa,EACb,MAA4C,EAC5C,OAAiC;IAEjC,yBAAyB;IACzB,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAE/C,4BAA4B;IAC5B,MAAM,GAAG,GAAG,EAAE;SACX,OAAO,CAAC,4DAA4D,CAAC;SACrE,GAAG,CAAC,KAAK,CAA0C,CAAC;IAEvD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3D,OAAO;IACT,CAAC;IAED,IAAI,QAAQ,GAAG,GAAG,CAAC,aAAa,CAAC;IAEjC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,GAAG,aAAa,CAAC,CAAC;YAC3D,MAAM;QACR,KAAK,WAAW;YACd,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAAC;YAC/D,MAAM;QACR,KAAK,UAAU;YACb,EAAE,CAAC,OAAO,CAAC,kEAAkE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1F,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,GAAG,iBAAiB,CAAC,CAAC;YAC/D,MAAM;IACV,CAAC;IAED,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAEjG,MAAM,CAAC,IAAI,CAAC,kBAAkB,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC5F,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * 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 type Database from "better-sqlite3";
+import type { KnowledgeDocument } from "../../schemas/knowledge.schema.js";
+/**
+ * Link knowledge documents that share context (nodeId, tags, source patterns).
+ */
+export declare function linkBySharedContext(db: Database.Database): {
+    relationsCreated: number;
+};
+/**
+ * Find documents related to a given doc via knowledge_relations.
+ * Returns docs from different source types for cross-referencing.
+ */
+export declare function findCrossSourceContext(db: Database.Database, docId: string, limit?: number): KnowledgeDocument[];
+//# sourceMappingURL=knowledge-linker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge-linker.d.ts","sourceRoot":"","sources":["../../../src/core/rag/knowledge-linker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAY3E;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,CAoFvF;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,iBAAiB,EAAE,CAqCrB"}