gitmem-mcp 0.2.0

package/dist/services/transcript-chunker.js

@@ -0,0 +1,237 @@
+/**
+ * Transcript Chunking Service
+ *
+ * Parses JSONL session transcripts, chunks them intelligently,
+ * generates embeddings, and stores in orchestra_transcript_chunks.
+ *
+ * Issue: OD-540
+ */
+// OpenRouter API configuration (same as local-vector-search)
+const OPENROUTER_API_URL = "https://openrouter.ai/api/v1/embeddings";
+const EMBEDDING_MODEL = "openai/text-embedding-3-small";
+const EMBEDDING_DIM = 1536;
+// Chunking parameters
+const MAX_TOKENS_PER_CHUNK = 500;
+const TOKEN_OVERLAP = 50;
+const CHARS_PER_TOKEN = 4; // Rough estimate
+/**
+ * Normalize embedding vector (required for consistent similarity search)
+ */
+function normalize(vec) {
+    let magnitude = 0;
+    for (const v of vec) {
+        magnitude += v * v;
+    }
+    magnitude = Math.sqrt(magnitude);
+    if (magnitude === 0)
+        return vec;
+    return vec.map((v) => v / magnitude);
+}
+/**
+ * Generate embedding using OpenRouter API
+ */
+async function generateEmbedding(text) {
+    const apiKey = process.env.OPENROUTER_API_KEY;
+    if (!apiKey) {
+        throw new Error("OPENROUTER_API_KEY not configured");
+    }
+    const response = await fetch(OPENROUTER_API_URL, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({
+            model: EMBEDDING_MODEL,
+            input: text,
+        }),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`OpenRouter API error (${response.status}): ${errorText}`);
+    }
+    const data = (await response.json());
+    if (!data.data || data.data.length === 0) {
+        throw new Error("No embedding data in response");
+    }
+    const embedding = data.data[0].embedding;
+    if (embedding.length !== EMBEDDING_DIM) {
+        throw new Error(`Unexpected embedding dimensions: ${embedding.length}, expected ${EMBEDDING_DIM}`);
+    }
+    return normalize(embedding);
+}
+/**
+ * Extract text content from a transcript message
+ */
+function extractContent(msg) {
+    // Claude Code JSONL format: type is "user"/"assistant" and content is under msg.message
+    // Legacy/API format: type is "message" with role and content at top level
+    const role = msg.message?.role || msg.role;
+    const content = msg.message?.content || msg.content;
+    const msgType = msg.type;
+    // User messages (Claude Code: type="user", Legacy: type="message" role="user")
+    if ((msgType === "user" || (msgType === "message" && role === "user"))) {
+        if (typeof content === "string") {
+            return { text: content, type: "user_message" };
+        }
+        if (Array.isArray(content)) {
+            // Extract text blocks (skip tool_result blocks from user messages)
+            const textParts = content
+                .filter(c => c.type === "text" && c.text)
+                .map(c => c.text);
+            if (textParts.length > 0) {
+                return { text: textParts.join("\n"), type: "user_message" };
+            }
+        }
+    }
+    // Assistant messages (Claude Code: type="assistant", Legacy: type="message" role="assistant")
+    if ((msgType === "assistant" || (msgType === "message" && role === "assistant"))) {
+        if (typeof content === "string") {
+            return { text: content, type: "assistant_message" };
+        }
+        if (Array.isArray(content)) {
+            const textParts = content
+                .filter(c => c.type === "text" && c.text)
+                .map(c => c.text);
+            if (textParts.length > 0) {
+                return { text: textParts.join("\n"), type: "assistant_message" };
+            }
+            // Thinking blocks
+            const thinkingParts = content
+                .filter(c => c.type === "thinking" && c.thinking)
+                .map(c => c.thinking);
+            if (thinkingParts.length > 0) {
+                return { text: thinkingParts.join("\n"), type: "thinking" };
+            }
+        }
+    }
+    // Tool results (if we want to include them)
+    if (msg.type === "tool_result" && typeof content === "string") {
+        // Only include short tool results to avoid noise
+        if (content.length < 2000) {
+            return { text: content, type: "tool_result" };
+        }
+    }
+    return null;
+}
+/**
+ * Chunk text into overlapping segments
+ */
+function chunkText(text, maxTokens, overlap) {
+    const maxChars = maxTokens * CHARS_PER_TOKEN;
+    const overlapChars = overlap * CHARS_PER_TOKEN;
+    const chunks = [];
+    let start = 0;
+    while (start < text.length) {
+        const end = Math.min(start + maxChars, text.length);
+        chunks.push(text.slice(start, end));
+        // Move start forward by (maxChars - overlapChars)
+        start += maxChars - overlapChars;
+        // If we're within one overlap of the end, break to avoid tiny final chunk
+        if (start + overlapChars >= text.length) {
+            break;
+        }
+    }
+    return chunks;
+}
+/**
+ * Parse JSONL transcript and extract content
+ */
+function parseTranscript(jsonlContent) {
+    const lines = jsonlContent.trim().split("\n");
+    const extracted = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        try {
+            const msg = JSON.parse(line);
+            const content = extractContent(msg);
+            if (content) {
+                extracted.push(content);
+            }
+        }
+        catch (err) {
+            // Skip malformed lines
+            console.warn("[transcript-chunker] Failed to parse line:", err);
+        }
+    }
+    return extracted;
+}
+/**
+ * Process a transcript: parse, chunk, embed, and store
+ */
+export async function processTranscript(sessionId, transcriptContent, project = "orchestra_dev") {
+    try {
+        console.error(`[transcript-chunker] Processing transcript for session ${sessionId}`);
+        // 1. Parse transcript and extract content
+        const extracted = parseTranscript(transcriptContent);
+        console.error(`[transcript-chunker] Extracted ${extracted.length} content blocks`);
+        if (extracted.length === 0) {
+            return { success: true, chunksCreated: 0 };
+        }
+        // 2. Combine extracted content into chunks
+        const allChunks = [];
+        let globalChunkIndex = 0;
+        for (const { text, type } of extracted) {
+            // Chunk long content
+            const textChunks = chunkText(text, MAX_TOKENS_PER_CHUNK, TOKEN_OVERLAP);
+            for (const chunkText of textChunks) {
+                const tokenCount = Math.ceil(chunkText.length / CHARS_PER_TOKEN);
+                // Generate embedding (with retry logic for rate limits)
+                let embedding;
+                try {
+                    embedding = await generateEmbedding(chunkText);
+                }
+                catch (err) {
+                    console.error(`[transcript-chunker] Failed to generate embedding for chunk ${globalChunkIndex}:`, err);
+                    // Skip this chunk if embedding fails
+                    continue;
+                }
+                allChunks.push({
+                    session_id: sessionId,
+                    chunk_index: globalChunkIndex,
+                    content: chunkText,
+                    embedding,
+                    token_count: tokenCount,
+                    chunk_type: type,
+                });
+                globalChunkIndex++;
+                // Rate limiting: small delay between API calls
+                await new Promise(resolve => setTimeout(resolve, 100));
+            }
+        }
+        console.error(`[transcript-chunker] Generated ${allChunks.length} chunks with embeddings`);
+        // 3. Batch insert into database
+        if (allChunks.length > 0) {
+            // Use direct REST API for batch insert (more efficient than MCP)
+            const SUPABASE_URL = process.env.SUPABASE_URL || "";
+            const SUPABASE_KEY = process.env.SUPABASE_SERVICE_ROLE_KEY || "";
+            if (!SUPABASE_URL || !SUPABASE_KEY) {
+                throw new Error("Supabase configuration missing");
+            }
+            const restUrl = `${SUPABASE_URL}/rest/v1/orchestra_transcript_chunks`;
+            const response = await fetch(restUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${SUPABASE_KEY}`,
+                    "apikey": SUPABASE_KEY,
+                    "Prefer": "return=minimal", // Don't return inserted rows (faster)
+                },
+                body: JSON.stringify(allChunks),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`Failed to insert chunks: ${response.status} - ${errorText}`);
+            }
+            console.error(`[transcript-chunker] Successfully stored ${allChunks.length} chunks`);
+        }
+        return { success: true, chunksCreated: allChunks.length };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        console.error("[transcript-chunker] Error processing transcript:", errorMessage);
+        return { success: false, chunksCreated: 0, error: errorMessage };
+    }
+}
+//# sourceMappingURL=transcript-chunker.js.map

package/dist/services/transcript-chunker.js.map

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

package/dist/services/triple-writer.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Knowledge Triple Writer Service
+ *
+ * Phase 2: Rule-based extraction of knowledge triples from
+ * create_learning and create_decision operations.
+ *
+ * Design principles:
+ * - Fire-and-forget: never blocks the main tool response
+ * - High-confidence only: rule-based, no guessing
+ * - Uses directUpsert pattern from supabase-client.ts
+ */
+/** Controlled predicate vocabulary */
+type Predicate = "created_in" | "influenced_by" | "supersedes" | "demonstrates" | "affects_doc" | "created_thread" | "resolves_thread" | "relates_to_thread";
+interface TripleCandidate {
+    subject: string;
+    predicate: Predicate;
+    object: string;
+    source_type: string;
+    source_id: string;
+    source_linear_issue?: string;
+    domain?: string[];
+    project: string;
+    half_life_days: number;
+    created_by: string;
+}
+/**
+ * Normalize a persona label to its canonical form.
+ * Strips contextual suffixes like " - UX navigation clarity" or ": Prefers non-invasive..."
+ * Then maps to canonical short name if known.
+ *
+ * Examples:
+ *   "Elena Vos" → "Elena"
+ *   "Marcus - Architectural pattern" → "Marcus"
+ *   "Elena: Prefers non-invasive instrumentation" → "Elena"
+ *   "Chris Crawford - Process decision" → "Chris Crawford"
+ */
+export declare function normalizePersonaLabel(raw: string): string;
+/**
+ * Build a prefixed node label: "Persona: X" for known personas, "Agent: X" for agents.
+ * Normalizes persona names to canonical form.
+ */
+export declare function buildInfluencerLabel(rawName: string): string;
+export interface LearningTripleParams {
+    id: string;
+    learning_type: string;
+    title: string;
+    description: string;
+    scar_type?: string;
+    source_linear_issue?: string;
+    persona_name: string;
+    domain?: string[];
+    project: string;
+}
+/**
+ * Extract triples from a newly created learning using rule-based logic.
+ * Pure function — no side effects.
+ */
+export declare function extractLearningTriples(params: LearningTripleParams): TripleCandidate[];
+export interface DecisionTripleParams {
+    id: string;
+    title: string;
+    decision: string;
+    rationale: string;
+    personas_involved?: string[];
+    docs_affected?: string[];
+    linear_issue?: string;
+    session_id?: string;
+    project: string;
+    agent: string;
+}
+/**
+ * Extract triples from a newly created decision using rule-based logic.
+ * Pure function — no side effects.
+ */
+export declare function extractDecisionTriples(params: DecisionTripleParams): TripleCandidate[];
+/**
+ * Write triples to knowledge_triples table.
+ * Fire-and-forget: errors logged but never thrown to caller.
+ */
+export declare function writeTriples(candidates: TripleCandidate[]): Promise<number>;
+/**
+ * Generate and write triples for a newly created learning.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export declare function writeTriplesForLearning(params: LearningTripleParams): Promise<number>;
+/**
+ * Generate and write triples for a newly created decision.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export declare function writeTriplesForDecision(params: DecisionTripleParams): Promise<number>;
+export interface ThreadCreationTripleParams {
+    thread_id: string;
+    text: string;
+    linear_issue?: string;
+    session_id?: string;
+    project: string;
+    agent: string;
+}
+/**
+ * Extract triples from a newly created thread.
+ * Pure function — no side effects.
+ */
+export declare function extractThreadCreationTriples(params: ThreadCreationTripleParams): TripleCandidate[];
+export interface ThreadResolutionTripleParams {
+    thread_id: string;
+    text: string;
+    resolution_note?: string;
+    session_id?: string;
+    project: string;
+    agent: string;
+}
+/**
+ * Extract triples from a resolved thread.
+ * Pure function — no side effects.
+ */
+export declare function extractThreadResolutionTriples(params: ThreadResolutionTripleParams): TripleCandidate[];
+/**
+ * Generate and write triples for a newly created thread.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export declare function writeTriplesForThreadCreation(params: ThreadCreationTripleParams): Promise<number>;
+/**
+ * Generate and write triples for a resolved thread.
+ * Fire-and-forget — call with .catch(() => {}).
+ */
+export declare function writeTriplesForThreadResolution(params: ThreadResolutionTripleParams): Promise<number>;
+export {};
+//# sourceMappingURL=triple-writer.d.ts.map

package/dist/services/triple-writer.d.ts.map

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