gitmem-mcp 0.2.0

package/dist/tools/create-thread.d.ts

@@ -0,0 +1,42 @@
+/**
+ * create_thread Tool
+ *
+ * Create an open thread outside of session close. Threads track
+ * unresolved work items that carry across sessions.
+ *
+ * OD-620: Writes to Supabase (source of truth) + local file (cache).
+ * Falls back to local-only if Supabase is unavailable.
+ *
+ * Phase 3: Semantic dedup gate — before creating, checks existing open
+ * threads by embedding cosine similarity (> 0.85 threshold). Returns
+ * existing thread instead of creating a duplicate.
+ *
+ * Performance target: <500ms (Supabase write + file write)
+ */
+import type { ThreadObject, PerformanceData, Project } from "../types/index.js";
+export interface CreateThreadParams {
+    /** Thread description */
+    text: string;
+    /** Associated Linear issue (optional) */
+    linear_issue?: string;
+    /** Project namespace (default: orchestra_dev) */
+    project?: Project;
+}
+export interface CreateThreadResult {
+    success: boolean;
+    thread?: ThreadObject;
+    error?: string;
+    total_open: number;
+    supabase_synced: boolean;
+    performance: PerformanceData;
+    /** Phase 3: true when dedup gate found an existing duplicate */
+    deduplicated?: boolean;
+    /** Phase 3: dedup gate details */
+    dedup?: {
+        method: "embedding" | "text_normalization" | "skipped";
+        similarity: number | null;
+        matched_thread_id: string | null;
+    };
+}
+export declare function createThread(params: CreateThreadParams): Promise<CreateThreadResult>;
+//# sourceMappingURL=create-thread.d.ts.map

package/dist/tools/create-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-thread.d.ts","sourceRoot":"","sources":["../../src/tools/create-thread.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAyBH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAIhF,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,eAAe,CAAC;IAC7B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,MAAM,EAAE,WAAW,GAAG,oBAAoB,GAAG,SAAS,CAAC;QACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;KAClC,CAAC;CACH;AAID,wBAAsB,YAAY,CAChC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,kBAAkB,CAAC,CA4K7B"}

package/dist/tools/create-thread.js

@@ -0,0 +1,180 @@
+/**
+ * create_thread Tool
+ *
+ * Create an open thread outside of session close. Threads track
+ * unresolved work items that carry across sessions.
+ *
+ * OD-620: Writes to Supabase (source of truth) + local file (cache).
+ * Falls back to local-only if Supabase is unavailable.
+ *
+ * Phase 3: Semantic dedup gate — before creating, checks existing open
+ * threads by embedding cosine similarity (> 0.85 threshold). Returns
+ * existing thread instead of creating a duplicate.
+ *
+ * Performance target: <500ms (Supabase write + file write)
+ */
+import { v4 as uuidv4 } from "uuid";
+import { getThreads, setThreads, getCurrentSession } from "../services/session-state.js";
+import { generateThreadId, loadThreadsFile, saveThreadsFile, } from "../services/thread-manager.js";
+import { createThreadInSupabase, loadOpenThreadEmbeddings, touchThreadsInSupabase, } from "../services/thread-supabase.js";
+import { checkDuplicate } from "../services/thread-dedup.js";
+import { embed, isEmbeddingAvailable } from "../services/embedding.js";
+import { writeTriplesForThreadCreation } from "../services/triple-writer.js";
+import { getAgentIdentity } from "../services/agent-detection.js";
+import { Timer, recordMetrics, buildPerformanceData, } from "../services/metrics.js";
+import { formatThreadForDisplay } from "../services/timezone.js";
+// --- Handler ---
+export async function createThread(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    if (!params.text || !params.text.trim()) {
+        const latencyMs = timer.stop();
+        return {
+            success: false,
+            error: "Thread text is required",
+            total_open: 0,
+            supabase_synced: false,
+            performance: buildPerformanceData("create_thread", latencyMs, 0),
+        };
+    }
+    const session = getCurrentSession();
+    const sessionId = session?.sessionId;
+    const project = params.project || "orchestra_dev";
+    const trimmedText = params.text.trim();
+    // Phase 3: Generate embedding for new text (best-effort)
+    let newEmbedding = null;
+    if (isEmbeddingAvailable()) {
+        try {
+            newEmbedding = await embed(trimmedText);
+        }
+        catch (err) {
+            console.error("[create-thread] Embedding generation failed (continuing without):", err instanceof Error ? err.message : err);
+        }
+    }
+    // Phase 3: Load existing open threads with embeddings for dedup check
+    let existingThreads = [];
+    const loadedFromSupabase = await loadOpenThreadEmbeddings(project);
+    if (loadedFromSupabase) {
+        existingThreads = loadedFromSupabase;
+    }
+    else {
+        // Supabase unavailable: use local threads for text-only fallback
+        const localThreads = loadThreadsFile().filter((t) => t.status === "open");
+        existingThreads = localThreads.map((t) => ({
+            thread_id: t.id,
+            text: t.text,
+            embedding: null,
+        }));
+    }
+    // Phase 3: Run dedup check
+    const dedupResult = checkDuplicate(trimmedText, newEmbedding, existingThreads);
+    // If duplicate found, touch existing thread and return it
+    if (dedupResult.is_duplicate && dedupResult.matched_thread_id) {
+        // Touch the existing thread to keep it vital
+        await touchThreadsInSupabase([dedupResult.matched_thread_id]);
+        const fileThreads = loadThreadsFile();
+        const totalOpen = fileThreads.filter((t) => t.status === "open").length;
+        // Find the existing thread to return
+        const existingThread = fileThreads.find((t) => t.id === dedupResult.matched_thread_id) || {
+            id: dedupResult.matched_thread_id,
+            text: dedupResult.matched_text || trimmedText,
+            status: "open",
+            created_at: new Date().toISOString(),
+        };
+        const latencyMs = timer.stop();
+        recordMetrics({
+            id: metricsId,
+            tool_name: "create_thread",
+            query_text: `dedup:${dedupResult.matched_thread_id}`,
+            tables_searched: ["orchestra_threads"],
+            latency_ms: latencyMs,
+            result_count: 0,
+            phase_tag: "ad_hoc",
+            metadata: {
+                dedup_blocked: true,
+                dedup_method: dedupResult.method,
+                dedup_similarity: dedupResult.similarity,
+                matched_thread_id: dedupResult.matched_thread_id,
+            },
+        }).catch(() => { });
+        return {
+            success: true,
+            thread: formatThreadForDisplay(existingThread),
+            total_open: totalOpen,
+            supabase_synced: true,
+            performance: buildPerformanceData("create_thread", latencyMs, 0),
+            deduplicated: true,
+            dedup: {
+                method: dedupResult.method,
+                similarity: dedupResult.similarity,
+                matched_thread_id: dedupResult.matched_thread_id,
+            },
+        };
+    }
+    // Not a duplicate — create new thread
+    const thread = {
+        id: generateThreadId(),
+        text: trimmedText,
+        status: "open",
+        created_at: new Date().toISOString(),
+        ...(sessionId && { source_session: sessionId }),
+    };
+    // OD-620: Write to Supabase (source of truth) with embedding — non-blocking on failure
+    let supabaseSynced = false;
+    const embeddingJson = newEmbedding ? JSON.stringify(newEmbedding) : null;
+    const supabaseResult = await createThreadInSupabase(thread, project, embeddingJson);
+    if (supabaseResult) {
+        supabaseSynced = true;
+    }
+    // Update in-memory session state if active
+    let threads = getThreads();
+    if (threads.length > 0) {
+        threads.push(thread);
+        setThreads(threads);
+    }
+    // Always persist to local file (cache, works with or without active session)
+    const fileThreads = loadThreadsFile();
+    fileThreads.push(thread);
+    saveThreadsFile(fileThreads);
+    const totalOpen = fileThreads.filter((t) => t.status === "open").length;
+    const latencyMs = timer.stop();
+    const perfData = buildPerformanceData("create_thread", latencyMs, 1);
+    recordMetrics({
+        id: metricsId,
+        tool_name: "create_thread",
+        query_text: `create:${thread.id}`,
+        tables_searched: supabaseSynced ? ["orchestra_threads"] : [],
+        latency_ms: latencyMs,
+        result_count: 1,
+        phase_tag: "ad_hoc",
+        metadata: {
+            thread_id: thread.id,
+            has_session: !!sessionId,
+            supabase_synced: supabaseSynced,
+            embedding_generated: newEmbedding !== null,
+        },
+    }).catch(() => { });
+    // Phase 4: Knowledge graph triples (fire-and-forget)
+    writeTriplesForThreadCreation({
+        thread_id: thread.id,
+        text: trimmedText,
+        linear_issue: params.linear_issue,
+        session_id: sessionId,
+        project,
+        agent: getAgentIdentity(),
+    }).catch(() => { });
+    return {
+        success: true,
+        thread: formatThreadForDisplay(thread),
+        total_open: totalOpen,
+        supabase_synced: supabaseSynced,
+        performance: perfData,
+        deduplicated: false,
+        dedup: {
+            method: dedupResult.method,
+            similarity: dedupResult.similarity,
+            matched_thread_id: null,
+        },
+    };
+}
+//# sourceMappingURL=create-thread.js.map

package/dist/tools/create-thread.js.map

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