gitmem-mcp 0.2.0

package/dist/tools/recall.test.js

@@ -0,0 +1,155 @@
+/**
+ * Tests for recall tool
+ */
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { recall } from "./recall.js";
+import * as supabase from "../services/supabase-client.js";
+// Mock the tier module to simulate pro/dev tier (Supabase available)
+vi.mock("../services/tier.js", () => ({
+    getTier: vi.fn().mockReturnValue("pro"),
+    hasSupabase: vi.fn().mockReturnValue(true),
+    hasVariants: vi.fn().mockReturnValue(false),
+    hasMetrics: vi.fn().mockReturnValue(false),
+    hasCacheManagement: vi.fn().mockReturnValue(true),
+    hasCompliance: vi.fn().mockReturnValue(false),
+    hasTranscripts: vi.fn().mockReturnValue(false),
+    hasBatchOperations: vi.fn().mockReturnValue(false),
+    hasEmbeddings: vi.fn().mockReturnValue(true),
+    hasAdvancedAgentDetection: vi.fn().mockReturnValue(false),
+    hasMultiProject: vi.fn().mockReturnValue(false),
+    hasEnforcementFields: vi.fn().mockReturnValue(false),
+    getTablePrefix: vi.fn().mockReturnValue("gitmem_"),
+    getTableName: vi.fn((base) => `gitmem_${base}`),
+}));
+// Mock the supabase client
+vi.mock("../services/supabase-client.js", () => ({
+    isConfigured: vi.fn(),
+    cachedScarSearch: vi.fn(), // OD-473: now uses cached version
+    upsertRecord: vi.fn().mockResolvedValue(undefined), // For metrics recording
+}));
+describe("recall", () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it("returns error when Supabase not configured", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(false);
+        const result = await recall({ plan: "deploy to production" });
+        expect(result.activated).toBe(false);
+        expect(result.formatted_response).toContain("not configured");
+    });
+    it("returns scars when found", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({
+            results: [
+                {
+                    id: "test-scar-1",
+                    title: "Test Scar",
+                    description: "This is a test scar about deployment",
+                    severity: "high",
+                    counter_arguments: ["You might think it's easy", "You might skip testing"],
+                    applies_when: ["deploying", "releasing"],
+                    similarity: 0.85,
+                },
+            ],
+            cache_hit: false,
+        });
+        const result = await recall({ plan: "deploy to production" });
+        expect(result.activated).toBe(true);
+        expect(result.scars).toHaveLength(1);
+        expect(result.scars[0].title).toBe("Test Scar");
+        expect(result.scars[0].severity).toBe("high");
+        expect(result.scars[0].similarity).toBe(0.85);
+        expect(result.formatted_response).toContain("INSTITUTIONAL MEMORY ACTIVATED");
+        expect(result.formatted_response).toContain("Test Scar");
+    });
+    it("returns empty when no scars found", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({ results: [], cache_hit: false });
+        const result = await recall({ plan: "unique task with no history" });
+        expect(result.activated).toBe(false);
+        expect(result.scars).toHaveLength(0);
+        expect(result.formatted_response).toContain("No relevant scars found");
+        expect(result.formatted_response).toContain("new territory");
+    });
+    it("uses default project and match_count", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({ results: [], cache_hit: false });
+        const result = await recall({ plan: "test plan" });
+        expect(result.project).toBe("orchestra_dev");
+        expect(result.match_count).toBe(3);
+        expect(supabase.cachedScarSearch).toHaveBeenCalledWith("test plan", 3, "orchestra_dev");
+    });
+    it("respects custom project and match_count", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({ results: [], cache_hit: false });
+        const result = await recall({
+            plan: "trading feature",
+            project: "weekend_warrior",
+            match_count: 5,
+        });
+        expect(result.project).toBe("weekend_warrior");
+        expect(result.match_count).toBe(5);
+        expect(supabase.cachedScarSearch).toHaveBeenCalledWith("trading feature", 5, "weekend_warrior");
+    });
+    it("handles search errors gracefully", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockRejectedValue(new Error("Network error"));
+        const result = await recall({ plan: "test plan" });
+        expect(result.activated).toBe(false);
+        expect(result.formatted_response).toContain("Error querying institutional memory");
+        expect(result.formatted_response).toContain("Network error");
+    });
+    it("includes performance data", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({ results: [], cache_hit: false });
+        const result = await recall({ plan: "test plan" });
+        expect(result.performance).toBeDefined();
+        expect(result.performance.latency_ms).toBeGreaterThanOrEqual(0);
+        expect(result.performance.target_ms).toBe(2000); // OD-429 target for recall
+        expect(result.performance.meets_target).toBe(true);
+        expect(result.performance.result_count).toBe(0);
+    });
+    it("includes memories_surfaced in performance when scars found", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({
+            results: [
+                { id: "scar-1", title: "Test", description: "Test", severity: "high", similarity: 0.9 },
+                { id: "scar-2", title: "Test 2", description: "Test 2", severity: "medium", similarity: 0.8 },
+            ],
+            cache_hit: true,
+            cache_age_ms: 5000,
+        });
+        const result = await recall({ plan: "test plan", match_count: 2 });
+        expect(result.performance.result_count).toBe(2);
+        expect(result.performance.memories_surfaced).toEqual(["scar-1", "scar-2"]);
+        expect(result.performance.similarity_scores).toEqual([0.9, 0.8]);
+        expect(result.performance.cache_hit).toBe(true);
+    });
+    it("formats severity with correct emoji", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({
+            results: [
+                { id: "1", title: "Critical Scar", description: "desc", severity: "critical", similarity: 0.9 },
+                { id: "2", title: "High Scar", description: "desc", severity: "high", similarity: 0.8 },
+                { id: "3", title: "Medium Scar", description: "desc", severity: "medium", similarity: 0.7 },
+            ],
+            cache_hit: false,
+        });
+        const result = await recall({ plan: "test", match_count: 3 });
+        expect(result.formatted_response).toContain("🔴");
+        expect(result.formatted_response).toContain("🟠");
+        expect(result.formatted_response).toContain("🟡");
+    });
+    it("includes cache_hit in performance data", async () => {
+        vi.mocked(supabase.isConfigured).mockReturnValue(true);
+        vi.mocked(supabase.cachedScarSearch).mockResolvedValue({
+            results: [],
+            cache_hit: true,
+            cache_age_ms: 12345,
+        });
+        const result = await recall({ plan: "test plan" });
+        expect(result.performance.cache_hit).toBe(true);
+        expect(result.performance.cache_age_ms).toBe(12345);
+    });
+});
+//# sourceMappingURL=recall.test.js.map

package/dist/tools/recall.test.js.map

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

package/dist/tools/record-scar-usage-batch.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Batch Scar Usage Recording Tool
+ * Records multiple scar usages in a single call for improved session close performance
+ */
+import type { RecordScarUsageBatchParams, RecordScarUsageBatchResult } from "../types/index.js";
+/**
+ * Records multiple scar usages in a single batch operation
+ */
+export declare function recordScarUsageBatch(params: RecordScarUsageBatchParams): Promise<RecordScarUsageBatchResult>;
+//# sourceMappingURL=record-scar-usage-batch.d.ts.map

package/dist/tools/record-scar-usage-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-scar-usage-batch.d.ts","sourceRoot":"","sources":["../../src/tools/record-scar-usage-batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,0BAA0B,EAC1B,0BAA0B,EAG3B,MAAM,mBAAmB,CAAC;AA0E3B;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,0BAA0B,CAAC,CAuGrC"}

package/dist/tools/record-scar-usage-batch.js

@@ -0,0 +1,153 @@
+/**
+ * Batch Scar Usage Recording Tool
+ * Records multiple scar usages in a single call for improved session close performance
+ */
+import { v4 as uuidv4 } from "uuid";
+import * as supabase from "../services/supabase-client.js";
+import { Timer, recordMetrics, buildPerformanceData } from "../services/metrics.js";
+const TARGET_LATENCY_MS = 2000; // Target for batch operation
+/**
+ * Resolves a scar identifier (UUID or title/description) to a UUID
+ * @param identifier - UUID or title/description to resolve
+ * @param project - Project filter
+ * @returns UUID or null if not found
+ */
+async function resolveScarIdentifier(identifier, project) {
+    // If it looks like a UUID, return as-is
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidRegex.test(identifier)) {
+        return identifier;
+    }
+    // Otherwise, query by title or description
+    try {
+        const filters = {};
+        if (project) {
+            filters.project = project;
+        }
+        // Try exact title match first
+        const titleResult = await supabase.listRecords({
+            table: "orchestra_learnings",
+            columns: "id,title,description,scar_type,severity",
+            filters: { ...filters, title: identifier },
+            limit: 1,
+        });
+        if (titleResult && titleResult.length > 0) {
+            return titleResult[0].id;
+        }
+        // Try partial title match (get more records to search)
+        const partialResult = await supabase.listRecords({
+            table: "orchestra_learnings",
+            columns: "id,title,description,scar_type,severity",
+            filters: { ...filters },
+            limit: 100,
+        });
+        if (partialResult) {
+            // Find by case-insensitive contains
+            const match = partialResult.find((record) => record.title.toLowerCase().includes(identifier.toLowerCase()) ||
+                record.description?.toLowerCase().includes(identifier.toLowerCase()));
+            if (match) {
+                return match.id;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        console.error(`[record-scar-usage-batch] Error resolving identifier "${identifier}":`, error);
+        return null;
+    }
+}
+/**
+ * Records multiple scar usages in a single batch operation
+ */
+export async function recordScarUsageBatch(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    const usageIds = [];
+    const failedIdentifiers = [];
+    let resolvedCount = 0;
+    try {
+        // Resolve all scar identifiers to UUIDs in parallel
+        const resolutionPromises = params.scars.map(async (entry) => {
+            const scarId = await resolveScarIdentifier(entry.scar_identifier, params.project);
+            return { entry, scarId };
+        });
+        const resolvedScars = await Promise.all(resolutionPromises);
+        // Build usage records for all successfully resolved scars
+        const usageRecords = resolvedScars
+            .filter(({ scarId }) => scarId !== null)
+            .map(({ entry, scarId }) => {
+            const usageId = uuidv4();
+            return {
+                id: usageId,
+                scar_id: scarId,
+                issue_id: entry.issue_id || null,
+                issue_identifier: entry.issue_identifier || null,
+                session_id: entry.session_id || null, // OD-552: Session tracking
+                agent: entry.agent || null, // OD-552: Agent identity
+                surfaced_at: entry.surfaced_at,
+                acknowledged_at: entry.acknowledged_at || null,
+                referenced: entry.reference_type !== "none",
+                reference_type: entry.reference_type,
+                reference_context: entry.reference_context,
+                execution_successful: entry.execution_successful ?? null,
+                created_at: new Date().toISOString(),
+            };
+        });
+        // Track failed resolutions
+        resolvedScars.forEach(({ entry, scarId }) => {
+            if (scarId === null) {
+                failedIdentifiers.push(entry.scar_identifier);
+            }
+            else {
+                resolvedCount++;
+            }
+        });
+        // Insert all usage records in parallel
+        const insertPromises = usageRecords.map(async (record) => {
+            const result = await supabase.directUpsert("scar_usage", record);
+            return result?.id || null;
+        });
+        const insertResults = await Promise.all(insertPromises);
+        usageIds.push(...insertResults.filter((id) => id !== null));
+        const latencyMs = timer.stop();
+        const perfData = buildPerformanceData("record_scar_usage_batch", latencyMs, usageIds.length);
+        // Record metrics asynchronously
+        recordMetrics({
+            id: metricsId,
+            tool_name: "record_scar_usage_batch",
+            tables_searched: ["scar_usage", "orchestra_learnings"],
+            latency_ms: latencyMs,
+            result_count: usageIds.length,
+            phase_tag: "scar_tracking",
+            metadata: {
+                total_scars: params.scars.length,
+                resolved_count: resolvedCount,
+                failed_count: failedIdentifiers.length,
+            },
+        }).catch(() => {
+            // Swallow errors - metrics are non-critical
+        });
+        return {
+            success: true,
+            usage_ids: usageIds,
+            resolved_count: resolvedCount,
+            failed_count: failedIdentifiers.length,
+            failed_identifiers: failedIdentifiers.length > 0 ? failedIdentifiers : undefined,
+            performance: perfData,
+        };
+    }
+    catch (error) {
+        const latencyMs = timer.stop();
+        const perfData = buildPerformanceData("record_scar_usage_batch", latencyMs, 0);
+        console.error("[record-scar-usage-batch] Error recording batch:", error);
+        return {
+            success: false,
+            usage_ids: usageIds,
+            resolved_count: resolvedCount,
+            failed_count: params.scars.length - resolvedCount,
+            failed_identifiers: failedIdentifiers.length > 0 ? failedIdentifiers : undefined,
+            performance: perfData,
+        };
+    }
+}
+//# sourceMappingURL=record-scar-usage-batch.js.map

package/dist/tools/record-scar-usage-batch.js.map

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

package/dist/tools/record-scar-usage.d.ts

@@ -0,0 +1,14 @@
+/**
+ * record_scar_usage Tool
+ *
+ * Track scar application for effectiveness measurement.
+ * Records to scar_usage table.
+ *
+ * Performance target: <1000ms (OD-429)
+ */
+import type { RecordScarUsageParams, RecordScarUsageResult } from "../types/index.js";
+/**
+ * Execute record_scar_usage tool
+ */
+export declare function recordScarUsage(params: RecordScarUsageParams): Promise<RecordScarUsageResult>;
+//# sourceMappingURL=record-scar-usage.d.ts.map

package/dist/tools/record-scar-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-scar-usage.d.ts","sourceRoot":"","sources":["../../src/tools/record-scar-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC,CAgFhC"}

package/dist/tools/record-scar-usage.js

@@ -0,0 +1,94 @@
+/**
+ * record_scar_usage Tool
+ *
+ * Track scar application for effectiveness measurement.
+ * Records to scar_usage table.
+ *
+ * Performance target: <1000ms (OD-429)
+ */
+import { v4 as uuidv4 } from "uuid";
+import * as supabase from "../services/supabase-client.js";
+import { hasSupabase } from "../services/tier.js";
+import { getStorage } from "../services/storage.js";
+import { Timer, recordMetrics, buildPerformanceData, } from "../services/metrics.js";
+/**
+ * Execute record_scar_usage tool
+ */
+export async function recordScarUsage(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    const usageId = uuidv4();
+    const usageData = {
+        id: usageId,
+        scar_id: params.scar_id,
+        issue_id: params.issue_id || null,
+        issue_identifier: params.issue_identifier || null,
+        session_id: params.session_id || null, // OD-552: Session tracking
+        agent: params.agent || null, // OD-552: Agent identity
+        surfaced_at: params.surfaced_at,
+        acknowledged_at: params.acknowledged_at || null,
+        referenced: params.reference_type !== "none",
+        reference_type: params.reference_type,
+        reference_context: params.reference_context,
+        execution_successful: params.execution_successful ?? null,
+        created_at: new Date().toISOString(),
+    };
+    try {
+        const breakdown = {};
+        if (hasSupabase()) {
+            const upsertStart = Date.now();
+            await supabase.directUpsert("scar_usage", usageData);
+            breakdown.upsert = {
+                latency_ms: Date.now() - upsertStart,
+                source: "supabase",
+                cache_status: "not_applicable",
+                network_call: true,
+            };
+        }
+        else {
+            const upsertStart = Date.now();
+            await getStorage().upsert("scar_usage", usageData);
+            breakdown.upsert = {
+                latency_ms: Date.now() - upsertStart,
+                source: "memory",
+                cache_status: "not_applicable",
+                network_call: false,
+            };
+        }
+        const latencyMs = timer.stop();
+        const perfData = buildPerformanceData("record_scar_usage", latencyMs, 1, {
+            breakdown,
+        });
+        // Record metrics
+        recordMetrics({
+            id: metricsId,
+            tool_name: "record_scar_usage",
+            tables_searched: ["scar_usage"],
+            latency_ms: latencyMs,
+            result_count: 1,
+            phase_tag: "scar_tracking",
+            linear_issue: params.issue_identifier,
+            memories_surfaced: [params.scar_id],
+            metadata: {
+                reference_type: params.reference_type,
+                execution_successful: params.execution_successful,
+            },
+        }).catch(() => { });
+        return {
+            success: true,
+            usage_id: usageId,
+            performance: perfData,
+        };
+    }
+    catch (error) {
+        console.error("[record_scar_usage] Failed:", error);
+        const latencyMs = timer.stop();
+        const perfData = buildPerformanceData("record_scar_usage", latencyMs, 0);
+        return {
+            success: false,
+            usage_id: "",
+            performance: perfData,
+        };
+    }
+}
+//# sourceMappingURL=record-scar-usage.js.map

package/dist/tools/record-scar-usage.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * resolve_thread Tool (OD-thread-lifecycle, OD-621)
+ *
+ * Mark an open thread as resolved. Supports resolution by:
+ * - thread_id: exact match (preferred)
+ * - text_match: case-insensitive substring match (fallback)
+ *
+ * OD-621: Updates Supabase (source of truth) + local file (cache).
+ * Falls back to local-only if Supabase is unavailable or thread
+ * doesn't exist in Supabase.
+ *
+ * Performance target: <500ms (Supabase update + file write)
+ */
+import type { ResolveThreadParams, ResolveThreadResult } from "../types/index.js";
+export declare function resolveThread(params: ResolveThreadParams): Promise<ResolveThreadResult>;
+//# sourceMappingURL=resolve-thread.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-thread.d.ts","sourceRoot":"","sources":["../../src/tools/resolve-thread.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAElF,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CA0F9B"}

package/dist/tools/resolve-thread.js

@@ -0,0 +1,102 @@
+/**
+ * resolve_thread Tool (OD-thread-lifecycle, OD-621)
+ *
+ * Mark an open thread as resolved. Supports resolution by:
+ * - thread_id: exact match (preferred)
+ * - text_match: case-insensitive substring match (fallback)
+ *
+ * OD-621: Updates Supabase (source of truth) + local file (cache).
+ * Falls back to local-only if Supabase is unavailable or thread
+ * doesn't exist in Supabase.
+ *
+ * Performance target: <500ms (Supabase update + file write)
+ */
+import { v4 as uuidv4 } from "uuid";
+import { getThreads, getCurrentSession } from "../services/session-state.js";
+import { resolveThread as resolveThreadInList, loadThreadsFile, saveThreadsFile, } from "../services/thread-manager.js";
+import { resolveThreadInSupabase } from "../services/thread-supabase.js";
+import { writeTriplesForThreadResolution } 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";
+export async function resolveThread(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    // Validate: need at least one of thread_id or text_match
+    if (!params.thread_id && !params.text_match) {
+        const latencyMs = timer.stop();
+        return {
+            success: false,
+            error: "Either thread_id or text_match is required",
+            performance: buildPerformanceData("resolve_thread", latencyMs, 0),
+        };
+    }
+    // Load threads from session state, fall back to file
+    let threads = getThreads();
+    let fromFile = false;
+    if (threads.length === 0) {
+        threads = loadThreadsFile();
+        fromFile = true;
+    }
+    const session = getCurrentSession();
+    const sessionId = session?.sessionId;
+    // Resolve the thread locally (in-memory / file)
+    const resolved = resolveThreadInList(threads, {
+        threadId: params.thread_id,
+        textMatch: params.text_match,
+        sessionId,
+        resolutionNote: params.resolution_note,
+    });
+    if (!resolved) {
+        const latencyMs = timer.stop();
+        const searchKey = params.thread_id || params.text_match;
+        return {
+            success: false,
+            error: `Thread not found: "${searchKey}"`,
+            performance: buildPerformanceData("resolve_thread", latencyMs, 0),
+        };
+    }
+    // Persist to local file (cache)
+    saveThreadsFile(threads);
+    // OD-621: Update Supabase (source of truth) — graceful fallback on failure
+    let supabaseSynced = false;
+    const supabaseSuccess = await resolveThreadInSupabase(resolved.id, {
+        resolvedAt: resolved.resolved_at,
+        resolutionNote: resolved.resolution_note,
+        resolvedBySession: resolved.resolved_by_session || sessionId,
+    });
+    if (supabaseSuccess) {
+        supabaseSynced = true;
+    }
+    const latencyMs = timer.stop();
+    const perfData = buildPerformanceData("resolve_thread", latencyMs, 1);
+    recordMetrics({
+        id: metricsId,
+        tool_name: "resolve_thread",
+        query_text: `resolve:${params.thread_id || "text:" + params.text_match}`,
+        tables_searched: supabaseSynced ? ["orchestra_threads"] : [],
+        latency_ms: latencyMs,
+        result_count: 1,
+        phase_tag: "ad_hoc",
+        metadata: {
+            thread_id: resolved.id,
+            resolution_note: params.resolution_note,
+            supabase_synced: supabaseSynced,
+        },
+    }).catch(() => { });
+    // Phase 4: Knowledge graph triples (fire-and-forget)
+    writeTriplesForThreadResolution({
+        thread_id: resolved.id,
+        text: resolved.text,
+        resolution_note: params.resolution_note,
+        session_id: sessionId,
+        project: "orchestra_dev",
+        agent: getAgentIdentity(),
+    }).catch(() => { });
+    return {
+        success: true,
+        resolved_thread: formatThreadForDisplay(resolved),
+        performance: perfData,
+    };
+}
+//# sourceMappingURL=resolve-thread.js.map

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

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

package/dist/tools/save-transcript.d.ts

@@ -0,0 +1,29 @@
+/**
+ * save_transcript Tool
+ *
+ * Save full session transcript to Supabase storage for training data,
+ * post-mortems, and pattern mining.
+ *
+ * Issue: OD-467
+ */
+import type { Project, PerformanceData } from "../types/index.js";
+export interface SaveTranscriptParams {
+    session_id: string;
+    transcript: string;
+    format?: "json" | "markdown";
+    project?: Project;
+}
+export interface SaveTranscriptResult {
+    success: boolean;
+    transcript_path?: string;
+    size_bytes?: number;
+    size_kb?: number;
+    estimated_tokens?: number;
+    error?: string;
+    performance: PerformanceData;
+}
+/**
+ * Execute save_transcript tool
+ */
+export declare function saveTranscript(params: SaveTranscriptParams): Promise<SaveTranscriptResult>;
+//# sourceMappingURL=save-transcript.d.ts.map

package/dist/tools/save-transcript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-transcript.d.ts","sourceRoot":"","sources":["../../src/tools/save-transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAwB,MAAM,mBAAmB,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA0F/B"}