gitmem-mcp 0.2.0

package/dist/services/thread-suggestions.js

@@ -0,0 +1,243 @@
+/**
+ * Thread Suggestions Service (Phase 5: Implicit Thread Detection)
+ *
+ * Detects recurring session topics not captured by existing threads.
+ * Core detection is pure (no I/O). File persistence and Supabase
+ * queries are separate functions called by the session lifecycle.
+ *
+ * Algorithm:
+ *   1. Compare current session embedding against recent sessions
+ *   2. If 3+ sessions are similar AND no matching open thread exists
+ *      → create a thread suggestion
+ *   3. Suggestions surfaced at session_start, managed via promote/dismiss
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+import { getGitmemDir } from "./gitmem-dir.js";
+import { directQuery } from "./supabase-client.js";
+import { hasSupabase } from "./tier.js";
+import { cosineSimilarity } from "./thread-dedup.js";
+// ---------- Constants ----------
+export const SESSION_SIMILARITY_THRESHOLD = 0.70;
+export const THREAD_MATCH_THRESHOLD = 0.80;
+export const SUGGESTION_MATCH_THRESHOLD = 0.80;
+export const MIN_EVIDENCE_SESSIONS = 3;
+const SUGGESTIONS_FILENAME = "suggested-threads.json";
+// ---------- Pure Detection ----------
+/**
+ * Detect suggested threads from session embedding clustering.
+ * Pure function — no I/O, no side effects.
+ *
+ * Returns the full updated suggestions list (existing + any new/updated).
+ */
+export function detectSuggestedThreads(currentSession, recentSessions, openThreadEmbeddings, existingSuggestions) {
+    const now = new Date().toISOString();
+    // Step 1: Find historical sessions similar to current
+    const similarSessions = [];
+    let totalSimilarity = 0;
+    for (const session of recentSessions) {
+        // Skip self
+        if (session.session_id === currentSession.session_id)
+            continue;
+        const sim = cosineSimilarity(currentSession.embedding, session.embedding);
+        if (sim >= SESSION_SIMILARITY_THRESHOLD) {
+            similarSessions.push(session);
+            totalSimilarity += sim;
+        }
+    }
+    // Step 2: Need at least 2 similar historical sessions (3+ total including current)
+    if (similarSessions.length < MIN_EVIDENCE_SESSIONS - 1) {
+        return existingSuggestions;
+    }
+    const avgSimilarity = totalSimilarity / similarSessions.length;
+    // Step 3: Check if any open thread already covers this topic
+    for (const thread of openThreadEmbeddings) {
+        if (thread.embedding === null)
+            continue;
+        const sim = cosineSimilarity(currentSession.embedding, thread.embedding);
+        if (sim >= THREAD_MATCH_THRESHOLD) {
+            // Topic is already captured by an existing thread — no suggestion
+            return existingSuggestions;
+        }
+    }
+    // Step 4: Check if any existing pending suggestion matches
+    const updated = [...existingSuggestions];
+    for (const suggestion of updated) {
+        if (suggestion.status !== "pending")
+            continue;
+        if (suggestion.embedding === null)
+            continue;
+        const sim = cosineSimilarity(currentSession.embedding, suggestion.embedding);
+        if (sim >= SUGGESTION_MATCH_THRESHOLD) {
+            // Update existing suggestion with new evidence
+            if (!suggestion.evidence_sessions.includes(currentSession.session_id)) {
+                suggestion.evidence_sessions.push(currentSession.session_id);
+                suggestion.similarity_score = round((suggestion.similarity_score + avgSimilarity) / 2, 4);
+                suggestion.updated_at = now;
+            }
+            return updated;
+        }
+    }
+    // Step 5: No existing match — create new suggestion
+    const evidenceIds = [
+        currentSession.session_id,
+        ...similarSessions.map((s) => s.session_id),
+    ];
+    const newSuggestion = {
+        id: generateSuggestionId(),
+        text: currentSession.title,
+        embedding: currentSession.embedding,
+        evidence_sessions: evidenceIds,
+        similarity_score: round(avgSimilarity, 4),
+        status: "pending",
+        dismissed_count: 0,
+        created_at: now,
+        updated_at: now,
+    };
+    updated.push(newSuggestion);
+    return updated;
+}
+// ---------- State Management (Pure) ----------
+/**
+ * Promote a suggestion to an open thread.
+ * Mutates the suggestion in-place and returns it, or null if not found.
+ */
+export function promoteSuggestionById(id, threadId, suggestions) {
+    const suggestion = suggestions.find((s) => s.id === id);
+    if (!suggestion)
+        return null;
+    suggestion.status = "promoted";
+    suggestion.promoted_thread_id = threadId;
+    suggestion.updated_at = new Date().toISOString();
+    return suggestion;
+}
+/**
+ * Dismiss a suggestion. Increments dismissed_count.
+ * Mutates the suggestion in-place and returns it, or null if not found.
+ */
+export function dismissSuggestionById(id, suggestions) {
+    const suggestion = suggestions.find((s) => s.id === id);
+    if (!suggestion)
+        return null;
+    suggestion.status = "dismissed";
+    suggestion.dismissed_count += 1;
+    suggestion.updated_at = new Date().toISOString();
+    return suggestion;
+}
+/**
+ * Filter to only pending suggestions (not promoted/dismissed).
+ * Excludes suggestions dismissed 3+ times (permanently suppressed).
+ */
+export function getPendingSuggestions(suggestions) {
+    return suggestions.filter((s) => s.status === "pending" && s.dismissed_count < 3);
+}
+// ---------- File I/O ----------
+/**
+ * Load suggestions from .gitmem/suggested-threads.json.
+ * Returns empty array if file doesn't exist or is corrupted.
+ */
+export function loadSuggestions() {
+    try {
+        const gitmemDir = getGitmemDir();
+        const filePath = path.join(gitmemDir, SUGGESTIONS_FILENAME);
+        if (!fs.existsSync(filePath))
+            return [];
+        const content = fs.readFileSync(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save suggestions to .gitmem/suggested-threads.json.
+ */
+export function saveSuggestions(suggestions) {
+    try {
+        const gitmemDir = getGitmemDir();
+        if (!fs.existsSync(gitmemDir)) {
+            fs.mkdirSync(gitmemDir, { recursive: true });
+        }
+        const filePath = path.join(gitmemDir, SUGGESTIONS_FILENAME);
+        fs.writeFileSync(filePath, JSON.stringify(suggestions, null, 2), "utf-8");
+    }
+    catch (error) {
+        console.error("[thread-suggestions] Failed to save suggestions:", error instanceof Error ? error.message : error);
+    }
+}
+// ---------- Supabase Query ----------
+/**
+ * Parse embedding from Supabase REST response.
+ * REST returns vector columns as JSON strings, not arrays.
+ */
+function parseEmbedding(raw) {
+    if (raw === null || raw === undefined)
+        return null;
+    if (Array.isArray(raw))
+        return raw;
+    if (typeof raw === "string") {
+        try {
+            const parsed = JSON.parse(raw);
+            if (Array.isArray(parsed))
+                return parsed;
+        }
+        catch {
+            // Invalid JSON
+        }
+    }
+    return null;
+}
+/**
+ * Fetch recent session embeddings from Supabase for clustering comparison.
+ * Returns null if Supabase is unavailable.
+ */
+export async function loadRecentSessionEmbeddings(project = "orchestra_dev", days = 30, limit = 20) {
+    if (!hasSupabase()) {
+        return null;
+    }
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - days);
+        const cutoffStr = cutoff.toISOString().split("T")[0]; // YYYY-MM-DD
+        const rows = await directQuery("orchestra_sessions", {
+            select: "id,session_title,embedding",
+            filters: {
+                project,
+                session_date: `gte.${cutoffStr}`,
+            },
+            order: "created_at.desc",
+            limit,
+        });
+        // Filter to rows that have embeddings
+        const records = [];
+        for (const row of rows) {
+            const emb = parseEmbedding(row.embedding);
+            if (emb && row.session_title) {
+                records.push({
+                    session_id: row.id,
+                    session_title: row.session_title,
+                    embedding: emb,
+                });
+            }
+        }
+        console.error(`[thread-suggestions] Loaded ${records.length} session embeddings (${rows.length} rows, last ${days} days)`);
+        return records;
+    }
+    catch (error) {
+        console.error("[thread-suggestions] Failed to load session embeddings:", error instanceof Error ? error.message : error);
+        return null;
+    }
+}
+// ---------- Helpers ----------
+export function generateSuggestionId() {
+    return "ts-" + crypto.randomBytes(4).toString("hex");
+}
+function round(value, decimals) {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=thread-suggestions.js.map

package/dist/services/thread-suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread-suggestions.js","sourceRoot":"","sources":["../../src/services/thread-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIrD,kCAAkC;AAElC,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,IAAI,CAAC;AAC3C,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAEvC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAUtD,uCAAuC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,cAA0E,EAC1E,cAAwC,EACxC,oBAA2C,EAC3C,mBAAuC;IAEvC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,sDAAsD;IACtD,MAAM,eAAe,GAA6B,EAAE,CAAC;IACrD,IAAI,eAAe,GAAG,CAAC,CAAC;IAExB,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,YAAY;QACZ,IAAI,OAAO,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU;YAAE,SAAS;QAE/D,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,IAAI,GAAG,IAAI,4BAA4B,EAAE,CAAC;YACxC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,eAAe,IAAI,GAAG,CAAC;QACzB,CAAC;IACH,CAAC;IAED,mFAAmF;IACnF,IAAI,eAAe,CAAC,MAAM,GAAG,qBAAqB,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,GAAG,eAAe,CAAC,MAAM,CAAC;IAE/D,6DAA6D;IAC7D,KAAK,MAAM,MAAM,IAAI,oBAAoB,EAAE,CAAC;QAC1C,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;YAAE,SAAS;QACxC,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QACzE,IAAI,GAAG,IAAI,sBAAsB,EAAE,CAAC;YAClC,kEAAkE;YAClE,OAAO,mBAAmB,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,2DAA2D;IAC3D,MAAM,OAAO,GAAG,CAAC,GAAG,mBAAmB,CAAC,CAAC;IACzC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;QACjC,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QAC9C,IAAI,UAAU,CAAC,SAAS,KAAK,IAAI;YAAE,SAAS;QAE5C,MAAM,GAAG,GAAG,gBAAgB,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,GAAG,IAAI,0BAA0B,EAAE,CAAC;YACtC,+CAA+C;YAC/C,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,QAAQ,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtE,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;gBAC7D,UAAU,CAAC,gBAAgB,GAAG,KAAK,CACjC,CAAC,UAAU,CAAC,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,EACjD,CAAC,CACF,CAAC;gBACF,UAAU,CAAC,UAAU,GAAG,GAAG,CAAC;YAC9B,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,MAAM,WAAW,GAAG;QAClB,cAAc,CAAC,UAAU;QACzB,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;KAC5C,CAAC;IAEF,MAAM,aAAa,GAAqB;QACtC,EAAE,EAAE,oBAAoB,EAAE;QAC1B,IAAI,EAAE,cAAc,CAAC,KAAK;QAC1B,SAAS,EAAE,cAAc,CAAC,SAAS;QACnC,iBAAiB,EAAE,WAAW;QAC9B,gBAAgB,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QACzC,MAAM,EAAE,SAAS;QACjB,eAAe,EAAE,CAAC;QAClB,UAAU,EAAE,GAAG;QACf,UAAU,EAAE,GAAG;KAChB,CAAC;IAEF,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,gDAAgD;AAEhD;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,QAAgB,EAChB,WAA+B;IAE/B,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC;IAC/B,UAAU,CAAC,kBAAkB,GAAG,QAAQ,CAAC;IACzC,UAAU,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,EAAU,EACV,WAA+B;IAE/B,MAAM,UAAU,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,UAAU,CAAC,MAAM,GAAG,WAAW,CAAC;IAChC,UAAU,CAAC,eAAe,IAAI,CAAC,CAAC;IAChC,UAAU,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAA+B;IAE/B,OAAO,WAAW,CAAC,MAAM,CACvB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,CACvD,CAAC;AACJ,CAAC;AAED,iCAAiC;AAEjC;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAC;QAExC,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAA+B;IAC7D,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC5D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,kDAAkD,EAClD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;IACJ,CAAC;AACH,CAAC;AAED,uCAAuC;AAEvC;;;GAGG;AACH,SAAS,cAAc,CAAC,GAAyC;IAC/D,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,UAAmB,eAAe,EAClC,OAAe,EAAE,EACjB,QAAgB,EAAE;IAElB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa;QAEnE,MAAM,IAAI,GAAG,MAAM,WAAW,CAI3B,oBAAoB,EAAE;YACvB,MAAM,EAAE,4BAA4B;YACpC,OAAO,EAAE;gBACP,OAAO;gBACP,YAAY,EAAE,OAAO,SAAS,EAAE;aACjC;YACD,KAAK,EAAE,iBAAiB;YACxB,KAAK;SACN,CAAC,CAAC;QAEH,sCAAsC;QACtC,MAAM,OAAO,GAA6B,EAAE,CAAC;QAC7C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAC1C,IAAI,GAAG,IAAI,GAAG,CAAC,aAAa,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC;oBACX,UAAU,EAAE,GAAG,CAAC,EAAE;oBAClB,aAAa,EAAE,GAAG,CAAC,aAAa;oBAChC,SAAS,EAAE,GAAG;iBACf,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,CAAC,KAAK,CACX,+BAA+B,OAAO,CAAC,MAAM,wBAAwB,IAAI,CAAC,MAAM,eAAe,IAAI,QAAQ,CAC5G,CAAC;QACF,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CACX,yDAAyD,EACzD,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAC/C,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,gCAAgC;AAEhC,MAAM,UAAU,oBAAoB;IAClC,OAAO,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,QAAgB;IAC5C,MAAM,MAAM,GAAG,EAAE,IAAI,QAAQ,CAAC;IAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;AAC7C,CAAC"}

package/dist/services/thread-supabase.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Thread Supabase Service (OD-620, OD-621, OD-622, OD-623, OD-624)
+ *
+ * Provides Supabase CRUD operations for the orchestra_threads table.
+ * Supabase is the source of truth; local .gitmem/threads.json is a cache.
+ *
+ * Uses directQuery/directUpsert (PostgREST) like other Supabase operations
+ * in this codebase. Graceful fallback: if Supabase is unreachable, callers
+ * fall back to local file operations.
+ */
+import type { LifecycleStatus } from "./thread-vitality.js";
+import type { ThreadWithEmbedding } from "./thread-dedup.js";
+import type { ThreadObject, Project } from "../types/index.js";
+/** Shape of a row in orchestra_threads / orchestra_threads_lite */
+export interface ThreadRow {
+    id: string;
+    thread_id: string;
+    text: string;
+    status: string;
+    thread_class: string;
+    vitality_score: number;
+    last_touched_at: string;
+    touch_count: number;
+    created_at: string;
+    updated_at: string;
+    resolved_at: string | null;
+    resolution_note: string | null;
+    source_session: string | null;
+    resolved_by_session: string | null;
+    related_issues: string[] | null;
+    domain: string[] | null;
+    project: string;
+    metadata: Record<string, unknown>;
+}
+/** Display-enriched thread info for session_start (Phase 6) */
+export interface ThreadDisplayInfo {
+    thread: ThreadObject;
+    vitality_score: number;
+    lifecycle_status: LifecycleStatus;
+    thread_class: string;
+    days_since_touch: number;
+}
+/**
+ * Map a local ThreadObject to a Supabase row for insert/upsert.
+ */
+export declare function threadObjectToRow(thread: ThreadObject, project?: Project, embedding?: string | null): Record<string, unknown>;
+/**
+ * Map a Supabase row to a local ThreadObject.
+ */
+export declare function rowToThreadObject(row: ThreadRow): ThreadObject;
+/**
+ * Create a thread in Supabase.
+ * Returns the created row or null if Supabase is unavailable.
+ */
+export declare function createThreadInSupabase(thread: ThreadObject, project?: Project, embedding?: string | null): Promise<ThreadRow | null>;
+/**
+ * Resolve a thread in Supabase by thread_id.
+ * Updates status, resolved_at, resolution_note, resolved_by_session.
+ * Returns true if update succeeded.
+ */
+export declare function resolveThreadInSupabase(threadId: string, options?: {
+    resolvedAt?: string;
+    resolutionNote?: string;
+    resolvedBySession?: string;
+}): Promise<boolean>;
+/**
+ * List threads from Supabase with project filter.
+ * Uses orchestra_threads_lite view (no embedding column).
+ * Returns null if Supabase is unavailable (caller should fall back to local).
+ */
+export declare function listThreadsFromSupabase(project?: Project, options?: {
+    statusFilter?: string;
+    includeResolved?: boolean;
+}): Promise<ThreadObject[] | null>;
+/**
+ * Load active (non-archived, non-resolved) threads from Supabase for session_start.
+ * Uses orchestra_threads_lite view ordered by vitality_score DESC.
+ * Returns null if Supabase is unavailable.
+ */
+export declare function loadActiveThreadsFromSupabase(project?: Project): Promise<{
+    open: ThreadObject[];
+    recentlyResolved: ThreadObject[];
+    displayInfo: ThreadDisplayInfo[];
+} | null>;
+/**
+ * Touch threads in Supabase — increment touch_count and update last_touched_at.
+ * Called during session_close for threads that were referenced during the session.
+ */
+export declare function touchThreadsInSupabase(threadIds: string[]): Promise<void>;
+/**
+ * Batch create/update threads in Supabase.
+ * Used by session_close to sync thread state.
+ * New threads (not in Supabase) get created; existing threads get touched.
+ */
+export declare function syncThreadsToSupabase(threads: ThreadObject[], project?: Project, sessionId?: string): Promise<void>;
+/**
+ * Archive dormant threads that have been dormant for 30+ days.
+ * Reads metadata.dormant_since to determine eligibility.
+ * Called at session_start as fire-and-forget.
+ */
+export declare function archiveDormantThreads(project?: Project, dormantDays?: number): Promise<{
+    archived_count: number;
+    archived_ids: string[];
+}>;
+/**
+ * Load open threads WITH embeddings from Supabase for dedup comparison.
+ * Uses the full orchestra_threads table (not _lite view) to include embedding column.
+ * Returns null if Supabase is unavailable.
+ */
+export declare function loadOpenThreadEmbeddings(project?: Project): Promise<ThreadWithEmbedding[] | null>;
+//# sourceMappingURL=thread-supabase.d.ts.map

package/dist/services/thread-supabase.d.ts.map

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