gitmem-mcp 0.2.0

package/dist/services/thread-supabase.js

@@ -0,0 +1,459 @@
+/**
+ * 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 * as supabase from "./supabase-client.js";
+import { hasSupabase } from "./tier.js";
+import { computeLifecycleStatus, detectThreadClass } from "./thread-vitality.js";
+// ---------- Mapping Helpers ----------
+/**
+ * Map a local ThreadObject to a Supabase row for insert/upsert.
+ */
+export function threadObjectToRow(thread, project = "orchestra_dev", embedding) {
+    const now = new Date();
+    const createdAt = thread.created_at || now.toISOString();
+    const threadClass = detectThreadClass(thread.text);
+    // Phase 6: Use lifecycle status for new threads (will be "emerging" if < 24h old)
+    const { lifecycle_status, vitality } = computeLifecycleStatus({
+        last_touched_at: createdAt,
+        touch_count: 1,
+        created_at: createdAt,
+        thread_class: threadClass,
+        current_status: mapStatusToSupabase(thread.status),
+    }, now);
+    return {
+        thread_id: thread.id, // "t-XXXXXXXX" -> thread_id column
+        text: thread.text,
+        status: thread.status === "resolved" ? "resolved" : lifecycle_status,
+        thread_class: threadClass,
+        vitality_score: vitality.vitality_score,
+        last_touched_at: createdAt,
+        touch_count: 1,
+        created_at: createdAt,
+        resolved_at: thread.resolved_at || null,
+        resolution_note: thread.resolution_note || null,
+        source_session: thread.source_session || null,
+        resolved_by_session: thread.resolved_by_session || null,
+        project,
+        metadata: {},
+        ...(embedding != null && { embedding }),
+    };
+}
+/**
+ * Map a Supabase row to a local ThreadObject.
+ */
+export function rowToThreadObject(row) {
+    return {
+        id: row.thread_id, // thread_id column -> ThreadObject.id
+        text: row.text,
+        status: mapStatusFromSupabase(row.status),
+        created_at: row.created_at,
+        ...(row.resolved_at && { resolved_at: row.resolved_at }),
+        ...(row.source_session && { source_session: row.source_session }),
+        ...(row.resolved_by_session && { resolved_by_session: row.resolved_by_session }),
+        ...(row.resolution_note && { resolution_note: row.resolution_note }),
+    };
+}
+/**
+ * Map local ThreadObject status ("open"|"resolved") to Supabase status.
+ * Phase 1: "open" -> "active", "resolved" -> "resolved"
+ */
+function mapStatusToSupabase(status) {
+    if (status === "open")
+        return "active";
+    if (status === "resolved")
+        return "resolved";
+    // Pass through any Supabase-native statuses
+    return status;
+}
+/**
+ * Map Supabase status to local ThreadObject status.
+ * Phase 1: Any non-resolved status -> "open"
+ */
+function mapStatusFromSupabase(status) {
+    if (status === "resolved")
+        return "resolved";
+    return "open"; // emerging, active, cooling, dormant, archived -> "open" for backward compat
+}
+// ---------- CRUD Operations ----------
+/**
+ * Create a thread in Supabase.
+ * Returns the created row or null if Supabase is unavailable.
+ */
+export async function createThreadInSupabase(thread, project = "orchestra_dev", embedding) {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return null;
+    }
+    try {
+        const row = threadObjectToRow(thread, project, embedding);
+        const result = await supabase.directUpsert("orchestra_threads", row);
+        console.error(`[thread-supabase] Created thread ${thread.id} in Supabase`);
+        return result;
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to create thread:", error instanceof Error ? error.message : error);
+        return null;
+    }
+}
+/**
+ * Resolve a thread in Supabase by thread_id.
+ * Updates status, resolved_at, resolution_note, resolved_by_session.
+ * Returns true if update succeeded.
+ */
+export async function resolveThreadInSupabase(threadId, options = {}) {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return false;
+    }
+    try {
+        // First, find the UUID primary key for this thread_id
+        const rows = await supabase.directQuery("orchestra_threads", {
+            select: "id,thread_id",
+            filters: { thread_id: threadId },
+            limit: 1,
+        });
+        if (rows.length === 0) {
+            console.error(`[thread-supabase] Thread ${threadId} not found in Supabase (will proceed with local-only)`);
+            return false;
+        }
+        const uuid = rows[0].id;
+        const patchData = {
+            status: "resolved",
+            resolved_at: options.resolvedAt || new Date().toISOString(),
+        };
+        if (options.resolutionNote) {
+            patchData.resolution_note = options.resolutionNote;
+        }
+        if (options.resolvedBySession) {
+            patchData.resolved_by_session = options.resolvedBySession;
+        }
+        await supabase.directPatch("orchestra_threads", { id: uuid }, patchData);
+        console.error(`[thread-supabase] Resolved thread ${threadId} in Supabase`);
+        return true;
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to resolve thread:", error instanceof Error ? error.message : error);
+        return false;
+    }
+}
+/**
+ * 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 async function listThreadsFromSupabase(project = "orchestra_dev", options = {}) {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return null;
+    }
+    try {
+        const filters = {
+            project,
+        };
+        // Apply status filter unless including all
+        if (!options.includeResolved && options.statusFilter) {
+            if (options.statusFilter === "open") {
+                // "open" in local status = all non-terminal Supabase statuses
+                filters.status = "not.in.(resolved,archived)";
+            }
+            else if (options.statusFilter === "resolved") {
+                filters.status = "resolved";
+            }
+            else {
+                // Pass through any Supabase-native status
+                filters.status = options.statusFilter;
+            }
+        }
+        else if (!options.includeResolved) {
+            // Default: exclude resolved and archived
+            filters.status = "not.in.(resolved,archived)";
+        }
+        const rows = await supabase.directQuery("orchestra_threads_lite", {
+            select: "*",
+            filters,
+            order: "vitality_score.desc,last_touched_at.desc",
+            limit: 100,
+        });
+        console.error(`[thread-supabase] Listed ${rows.length} threads from Supabase`);
+        return rows.map(rowToThreadObject);
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to list threads:", error instanceof Error ? error.message : error);
+        return 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 async function loadActiveThreadsFromSupabase(project = "orchestra_dev") {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return null;
+    }
+    try {
+        // Get all non-archived threads (both active and recently resolved)
+        const rows = await supabase.directQuery("orchestra_threads_lite", {
+            select: "*",
+            filters: {
+                project,
+                status: "not.in.(archived,dormant)",
+            },
+            order: "vitality_score.desc,last_touched_at.desc",
+            limit: 100,
+        });
+        const now = new Date();
+        const open = [];
+        const recentlyResolved = [];
+        const displayInfo = [];
+        // Deduplicate by text content (mirrors aggregateThreads logic)
+        const seenText = new Set();
+        const seenIds = new Set();
+        // Recently resolved = resolved in last 14 days
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 14);
+        const cutoffStr = cutoff.toISOString();
+        for (const row of rows) {
+            // Deduplicate by both thread ID and normalized text
+            const key = (row.text || "").toLowerCase().trim();
+            if (seenIds.has(row.id) || (key && seenText.has(key)))
+                continue;
+            seenIds.add(row.id);
+            if (key)
+                seenText.add(key);
+            const thread = rowToThreadObject(row);
+            if (row.status === "resolved") {
+                if (row.resolved_at && row.resolved_at >= cutoffStr) {
+                    recentlyResolved.push(thread);
+                }
+                // Older resolved threads are skipped
+            }
+            else {
+                open.push(thread);
+                // Phase 6: Compute lifecycle display info for open threads
+                const lastTouched = new Date(row.last_touched_at);
+                const daysSinceTouch = Math.max((now.getTime() - lastTouched.getTime()) / (1000 * 60 * 60 * 24), 0);
+                const { lifecycle_status } = computeLifecycleStatus({
+                    last_touched_at: row.last_touched_at,
+                    touch_count: row.touch_count,
+                    created_at: row.created_at,
+                    thread_class: row.thread_class || "backlog",
+                    current_status: row.status,
+                    dormant_since: row.metadata?.dormant_since,
+                }, now);
+                displayInfo.push({
+                    thread,
+                    vitality_score: row.vitality_score,
+                    lifecycle_status,
+                    thread_class: row.thread_class || "backlog",
+                    days_since_touch: Math.round(daysSinceTouch),
+                });
+            }
+        }
+        const dupsRemoved = rows.length - open.length - recentlyResolved.length;
+        console.error(`[thread-supabase] Loaded ${open.length} open, ${recentlyResolved.length} recently resolved threads from Supabase (${dupsRemoved} duplicates removed)`);
+        return { open, recentlyResolved, displayInfo };
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to load active threads:", error instanceof Error ? error.message : error);
+        return 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 async function touchThreadsInSupabase(threadIds) {
+    if (!hasSupabase() || !supabase.isConfigured() || threadIds.length === 0) {
+        return;
+    }
+    for (const threadId of threadIds) {
+        try {
+            // Fetch current state (need created_at and thread_class for vitality recomputation)
+            const rows = await supabase.directQuery("orchestra_threads", {
+                select: "id,touch_count,created_at,thread_class,status",
+                filters: { thread_id: threadId },
+                limit: 1,
+            });
+            if (rows.length === 0)
+                continue;
+            const row = rows[0];
+            // Skip resolved/archived threads — no point recomputing vitality
+            if (row.status === "resolved" || row.status === "archived")
+                continue;
+            const now = new Date();
+            const newTouchCount = (row.touch_count || 0) + 1;
+            const nowIso = now.toISOString();
+            // Recompute lifecycle status (Phase 6: includes emerging/archival logic)
+            const { lifecycle_status, vitality } = computeLifecycleStatus({
+                last_touched_at: nowIso,
+                touch_count: newTouchCount,
+                created_at: row.created_at,
+                thread_class: row.thread_class || "backlog",
+                current_status: row.status,
+                dormant_since: row.metadata?.dormant_since,
+            }, now);
+            // Track dormant_since in metadata for archival computation
+            const metadata = { ...(row.metadata || {}) };
+            if (lifecycle_status === "dormant" && row.status !== "dormant") {
+                metadata.dormant_since = nowIso;
+            }
+            else if (lifecycle_status !== "dormant") {
+                delete metadata.dormant_since;
+            }
+            await supabase.directPatch("orchestra_threads", { id: row.id }, {
+                touch_count: newTouchCount,
+                last_touched_at: nowIso,
+                vitality_score: vitality.vitality_score,
+                status: lifecycle_status,
+                metadata,
+            });
+        }
+        catch (error) {
+            console.error(`[thread-supabase] Failed to touch thread ${threadId}:`, error instanceof Error ? error.message : error);
+            // Continue with other threads
+        }
+    }
+}
+/**
+ * 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 async function syncThreadsToSupabase(threads, project = "orchestra_dev", sessionId) {
+    if (!hasSupabase() || !supabase.isConfigured() || threads.length === 0) {
+        return;
+    }
+    for (const thread of threads) {
+        try {
+            // Check if thread exists in Supabase
+            const existing = await supabase.directQuery("orchestra_threads", {
+                select: "id,thread_id,status",
+                filters: { thread_id: thread.id },
+                limit: 1,
+            });
+            if (existing.length === 0) {
+                // New thread — create it
+                await createThreadInSupabase(thread, project);
+            }
+            else if (thread.status === "resolved" && existing[0].status !== "resolved") {
+                // Thread was resolved during this session
+                await resolveThreadInSupabase(thread.id, {
+                    resolvedAt: thread.resolved_at,
+                    resolutionNote: thread.resolution_note,
+                    resolvedBySession: thread.resolved_by_session || sessionId,
+                });
+            }
+            else {
+                // Existing thread, just touch it
+                await touchThreadsInSupabase([thread.id]);
+            }
+        }
+        catch (error) {
+            console.error(`[thread-supabase] Failed to sync thread ${thread.id}:`, error instanceof Error ? error.message : error);
+            // Continue with other threads
+        }
+    }
+}
+// ---------- Archival (Phase 6) ----------
+/**
+ * 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 async function archiveDormantThreads(project = "orchestra_dev", dormantDays = 30) {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return { archived_count: 0, archived_ids: [] };
+    }
+    try {
+        // Fetch dormant threads
+        const rows = await supabase.directQuery("orchestra_threads", {
+            select: "id,thread_id,metadata",
+            filters: {
+                project,
+                status: "dormant",
+            },
+            limit: 100,
+        });
+        const now = new Date();
+        const archived_ids = [];
+        for (const row of rows) {
+            const dormantSince = row.metadata?.dormant_since;
+            if (!dormantSince)
+                continue;
+            const dormantStart = new Date(dormantSince);
+            const daysDormant = (now.getTime() - dormantStart.getTime()) / (1000 * 60 * 60 * 24);
+            if (daysDormant >= dormantDays) {
+                await supabase.directPatch("orchestra_threads", { id: row.id }, {
+                    status: "archived",
+                });
+                archived_ids.push(row.thread_id);
+            }
+        }
+        if (archived_ids.length > 0) {
+            console.error(`[thread-supabase] Auto-archived ${archived_ids.length} dormant threads: ${archived_ids.join(", ")}`);
+        }
+        return { archived_count: archived_ids.length, archived_ids };
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to archive dormant threads:", error instanceof Error ? error.message : error);
+        return { archived_count: 0, archived_ids: [] };
+    }
+}
+// ---------- Embedding Queries (Phase 3) ----------
+/**
+ * Parse embedding from Supabase REST API 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;
+}
+/**
+ * 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 async function loadOpenThreadEmbeddings(project = "orchestra_dev") {
+    if (!hasSupabase() || !supabase.isConfigured()) {
+        return null;
+    }
+    try {
+        const rows = await supabase.directQuery("orchestra_threads", {
+            select: "thread_id,text,embedding",
+            filters: {
+                project,
+                status: "not.in.(resolved,archived)",
+            },
+            limit: 100,
+        });
+        console.error(`[thread-supabase] Loaded ${rows.length} thread embeddings for dedup`);
+        return rows.map((row) => ({
+            thread_id: row.thread_id,
+            text: row.text,
+            embedding: parseEmbedding(row.embedding),
+        }));
+    }
+    catch (error) {
+        console.error("[thread-supabase] Failed to load thread embeddings:", error instanceof Error ? error.message : error);
+        return null;
+    }
+}
+//# sourceMappingURL=thread-supabase.js.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * Thread Vitality Scoring (Phase 2) + Lifecycle State Machine (Phase 6)
+ *
+ * Computes vitality from recency + frequency (two of four eventual components).
+ * Importance and relevance deferred to Phases 3-4 (knowledge graph + per-session embeddings).
+ *
+ * Formula: vitality = W_recency * recency + W_frequency * frequency
+ *
+ * Phase 2 weights (renormalized from 4-component to 2-component):
+ *   recency:   0.55  (original 0.30 / 0.55 total)
+ *   frequency: 0.45  (original 0.25 / 0.55 total)
+ *
+ * Recency: exponential decay based on thread_class half-life
+ *   operational: 3-day half-life (short-lived tasks)
+ *   backlog: 21-day half-life (long-running concerns)
+ *
+ * Frequency: log-scaled touch count normalized against thread age
+ *   log(touch_count + 1) / log(max(days_alive, 0.01) + 1)
+ *
+ * Status thresholds:
+ *   vitality > 0.5  → "active"
+ *   0.2 <= v <= 0.5 → "cooling"
+ *   vitality < 0.2  → "dormant"
+ *
+ * Phase 6 Lifecycle:
+ *   EMERGING (< 24h old) → ACTIVE → COOLING → DORMANT → ARCHIVED (30+ days dormant)
+ *   Any state → RESOLVED (explicit resolve)
+ */
+export type ThreadClass = "operational" | "backlog";
+export type VitalityStatus = "emerging" | "active" | "cooling" | "dormant";
+export interface VitalityInput {
+    last_touched_at: string;
+    touch_count: number;
+    created_at: string;
+    thread_class: ThreadClass;
+}
+export interface VitalityResult {
+    vitality_score: number;
+    status: VitalityStatus;
+    recency_component: number;
+    frequency_component: number;
+}
+export type LifecycleStatus = "emerging" | "active" | "cooling" | "dormant" | "archived";
+export interface LifecycleInput extends VitalityInput {
+    current_status: string;
+    dormant_since?: string;
+}
+export declare const EMERGING_WINDOW_HOURS = 24;
+export declare const ARCHIVAL_DORMANT_DAYS = 30;
+export declare function computeVitality(input: VitalityInput, now?: Date): VitalityResult;
+/**
+ * Compute the full lifecycle status for a thread.
+ * Wraps vitality scoring with age-based emerging window and archival logic.
+ *
+ * State machine:
+ *   EMERGING (< 24h) → ACTIVE → COOLING → DORMANT → ARCHIVED (30+ days dormant)
+ *   Any state → RESOLVED (handled externally by resolve_thread)
+ */
+export declare function computeLifecycleStatus(input: LifecycleInput, now?: Date): {
+    lifecycle_status: LifecycleStatus;
+    vitality: VitalityResult;
+};
+export declare function vitalityToStatus(score: number): VitalityStatus;
+export declare function detectThreadClass(text: string): ThreadClass;
+//# sourceMappingURL=thread-vitality.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread-vitality.d.ts","sourceRoot":"","sources":["../../src/services/thread-vitality.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE3E,MAAM,WAAW,aAAa;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAGD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzF,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAoBD,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAUxC,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,IAAI,GAAG,cAAc,CA6BhF;AAID;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,GAAG,CAAC,EAAE,IAAI,GACT;IAAE,gBAAgB,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAqCjE;AAyCD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAI9D;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAM3D"}