gitmem-mcp 0.2.0

package/dist/tools/log.js

@@ -0,0 +1,157 @@
+/**
+ * log Tool (OD-561)
+ *
+ * Chronological listing of recent learnings, like `git log`.
+ * Pure read-only operation with no side effects.
+ *
+ * Uses directQuery to Supabase REST API (no ww-mcp dependency).
+ * Free tier reads from local .gitmem/ storage.
+ *
+ * Performance target: 500ms
+ */
+import * as supabase from "../services/supabase-client.js";
+import { hasSupabase } from "../services/tier.js";
+import { getStorage } from "../services/storage.js";
+import { Timer, recordMetrics, buildPerformanceData, buildComponentPerformance, } from "../services/metrics.js";
+import { v4 as uuidv4 } from "uuid";
+import { formatTimestamp } from "../services/timezone.js";
+// --- Implementation ---
+export async function log(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    const limit = params.limit || 10;
+    const project = params.project || "orchestra_dev";
+    const typeFilter = params.learning_type;
+    const severityFilter = params.severity;
+    const sinceDays = params.since;
+    // Compute since date if provided
+    let sinceDate;
+    if (sinceDays && sinceDays > 0) {
+        const d = new Date();
+        d.setDate(d.getDate() - sinceDays);
+        sinceDate = d.toISOString();
+    }
+    // FREE TIER: read from local storage
+    if (!hasSupabase()) {
+        try {
+            const queryTimer = new Timer();
+            const storage = getStorage();
+            const filters = {};
+            if (typeFilter)
+                filters.learning_type = typeFilter;
+            if (severityFilter)
+                filters.severity = severityFilter;
+            const records = await storage.query("learnings", {
+                filters,
+                order: "created_at.desc",
+                limit,
+            });
+            // Post-filter by since date (local storage doesn't support gte filters)
+            let filtered = records;
+            if (sinceDate) {
+                filtered = filtered.filter(r => r.created_at >= sinceDate);
+            }
+            filtered = filtered.slice(0, limit);
+            const queryLatencyMs = queryTimer.stop();
+            const latencyMs = timer.stop();
+            return {
+                entries: filtered.map(e => ({ ...e, created_at: formatTimestamp(e.created_at) })),
+                total: filtered.length,
+                filters: {
+                    project,
+                    learning_type: typeFilter,
+                    severity: severityFilter,
+                    since_days: sinceDays,
+                    since_date: sinceDate ? formatTimestamp(sinceDate) : undefined,
+                },
+                performance: buildPerformanceData("log", latencyMs, filtered.length, {
+                    search_mode: "local",
+                }),
+            };
+        }
+        catch (error) {
+            const latencyMs = timer.stop();
+            return {
+                entries: [],
+                total: 0,
+                filters: { project },
+                performance: buildPerformanceData("log", latencyMs, 0),
+            };
+        }
+    }
+    // PRO/DEV TIER: Direct Supabase REST query
+    if (!supabase.isConfigured()) {
+        const latencyMs = timer.stop();
+        return {
+            entries: [],
+            total: 0,
+            filters: { project },
+            performance: buildPerformanceData("log", latencyMs, 0),
+        };
+    }
+    try {
+        const queryTimer = new Timer();
+        // Build PostgREST filters
+        const filters = {
+            project,
+        };
+        if (typeFilter) {
+            filters.learning_type = typeFilter;
+        }
+        if (severityFilter) {
+            filters.severity = severityFilter;
+        }
+        if (sinceDate) {
+            filters.created_at = `gte.${sinceDate}`;
+        }
+        const records = await supabase.directQuery("orchestra_learnings", {
+            select: "id,title,learning_type,severity,created_at,source_linear_issue,project,persona_name",
+            filters,
+            order: "created_at.desc",
+            limit,
+        });
+        const queryLatencyMs = queryTimer.stop();
+        const latencyMs = timer.stop();
+        const breakdown = {
+            scar_search: buildComponentPerformance(queryLatencyMs, "supabase", true, "not_applicable"),
+        };
+        const perfData = buildPerformanceData("log", latencyMs, records.length, {
+            breakdown,
+            search_mode: "remote",
+        });
+        // Record metrics (fire and forget)
+        recordMetrics({
+            id: metricsId,
+            tool_name: "log",
+            tables_searched: ["orchestra_learnings"],
+            latency_ms: latencyMs,
+            result_count: records.length,
+            phase_tag: "ad_hoc",
+            metadata: { project, limit, typeFilter, severityFilter, sinceDays },
+        }).catch(() => { });
+        return {
+            entries: records.map(e => ({ ...e, created_at: formatTimestamp(e.created_at) })),
+            total: records.length,
+            filters: {
+                project,
+                learning_type: typeFilter,
+                severity: severityFilter,
+                since_days: sinceDays,
+                since_date: sinceDate ? formatTimestamp(sinceDate) : undefined,
+            },
+            performance: perfData,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error("[log] Query failed:", message);
+        const latencyMs = timer.stop();
+        return {
+            entries: [],
+            total: 0,
+            filters: { project },
+            performance: buildPerformanceData("log", latencyMs, 0),
+        };
+    }
+}
+//# sourceMappingURL=log.js.map

package/dist/tools/log.js.map

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

package/dist/tools/prepare-context.d.ts

@@ -0,0 +1,36 @@
+/**
+ * prepare_context Tool (GitMem v2 Phase 1 — OD-593)
+ *
+ * Bridge between global memory and agents that can't call recall directly.
+ * The lead agent calls this to generate a portable memory payload that
+ * gets injected into sub-agent prompts via the Task tool.
+ *
+ * Three format modes:
+ *   full    — Unlimited, rich markdown (same as recall output)
+ *   compact — ~500 tokens, severity + title + one-line per scar
+ *   gate    — ~100 tokens, only blocking scars, pass/fail
+ *
+ * No side effects: no variant assignment, no session state mutation,
+ * no surfaced scar tracking.
+ *
+ * Performance target: <500ms (same pipeline as search)
+ */
+import type { Project, PerformanceData } from "../types/index.js";
+export type PrepareContextFormat = "full" | "compact" | "gate";
+export interface PrepareContextParams {
+    plan: string;
+    format: PrepareContextFormat;
+    max_tokens?: number;
+    agent_role?: string;
+    project?: Project;
+}
+export interface PrepareContextResult {
+    memory_payload: string;
+    scars_included: number;
+    blocking_scars: number;
+    format: string;
+    token_estimate: number;
+    performance: PerformanceData;
+}
+export declare function prepareContext(params: PrepareContextParams): Promise<PrepareContextResult>;
+//# sourceMappingURL=prepare-context.d.ts.map

package/dist/tools/prepare-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-context.d.ts","sourceRoot":"","sources":["../../src/tools/prepare-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAaH,OAAO,KAAK,EAAE,OAAO,EAAwB,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIxF,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAmUD,wBAAsB,cAAc,CAClC,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC,CA4G/B"}

package/dist/tools/prepare-context.js

@@ -0,0 +1,353 @@
+/**
+ * prepare_context Tool (GitMem v2 Phase 1 — OD-593)
+ *
+ * Bridge between global memory and agents that can't call recall directly.
+ * The lead agent calls this to generate a portable memory payload that
+ * gets injected into sub-agent prompts via the Task tool.
+ *
+ * Three format modes:
+ *   full    — Unlimited, rich markdown (same as recall output)
+ *   compact — ~500 tokens, severity + title + one-line per scar
+ *   gate    — ~100 tokens, only blocking scars, pass/fail
+ *
+ * No side effects: no variant assignment, no session state mutation,
+ * no surfaced scar tracking.
+ *
+ * Performance target: <500ms (same pipeline as search)
+ */
+import * as supabase from "../services/supabase-client.js";
+import { localScarSearch, isLocalSearchReady } from "../services/local-vector-search.js";
+import { hasSupabase } from "../services/tier.js";
+import { getStorage } from "../services/storage.js";
+import { Timer, recordMetrics, buildPerformanceData, buildComponentPerformance, } from "../services/metrics.js";
+import { v4 as uuidv4 } from "uuid";
+// --- Token Estimation ---
+/**
+ * Estimate tokens from a string.
+ * Rough heuristic: ~4 characters per token for English text.
+ */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+// --- Severity Helpers ---
+const SEVERITY_EMOJI = {
+    critical: "🔴",
+    high: "🟠",
+    medium: "🟡",
+    low: "🟢",
+};
+const SEVERITY_LABEL = {
+    critical: "CRITICAL",
+    high: "HIGH",
+    medium: "MEDIUM",
+    low: "LOW",
+};
+const SEVERITY_ORDER = {
+    critical: 0,
+    high: 1,
+    medium: 2,
+    low: 3,
+};
+// --- Formatters ---
+/**
+ * Format scars in compact mode.
+ * One line per scar: emoji LABEL: Title — first sentence of description.
+ * Sorted by severity (critical first). Truncated to token budget.
+ */
+function formatCompact(scars, plan, maxTokens) {
+    const sorted = [...scars].sort((a, b) => (SEVERITY_ORDER[a.severity] ?? 3) - (SEVERITY_ORDER[b.severity] ?? 3));
+    const header = `[INSTITUTIONAL MEMORY — ${sorted.length} scars for: "${plan.slice(0, 60)}"]`;
+    const lines = [header];
+    let included = 0;
+    for (const scar of sorted) {
+        const emoji = SEVERITY_EMOJI[scar.severity] || "⚪";
+        const label = SEVERITY_LABEL[scar.severity] || "UNKNOWN";
+        const firstSentence = scar.description.split(/\.\s/)[0].slice(0, 120);
+        const line = `${emoji} ${label}: ${scar.title} — ${firstSentence}`;
+        // Check token budget before adding (always include at least one)
+        const candidate = [...lines, line].join("\n");
+        if (estimateTokens(candidate) > maxTokens && included > 0) {
+            break;
+        }
+        lines.push(line);
+        included++;
+    }
+    return { payload: lines.join("\n"), included };
+}
+/**
+ * Format scars in gate mode.
+ * Only blocking scars (required_verification.blocking === true).
+ * Returns PASS if none found.
+ */
+function formatGate(scars) {
+    const blockingScars = scars.filter((s) => s.required_verification?.blocking === true);
+    if (blockingScars.length === 0) {
+        return {
+            payload: "[MEMORY GATE: PASS — no blocking scars]",
+            blocking: 0,
+        };
+    }
+    const lines = [
+        `[MEMORY GATE: ${blockingScars.length} blocking scar${blockingScars.length === 1 ? "" : "s"}]`,
+    ];
+    for (const scar of blockingScars) {
+        const rv = scar.required_verification;
+        lines.push(`🚨 BLOCK: ${rv.when}`);
+        if (rv.queries && rv.queries.length > 0) {
+            for (const query of rv.queries) {
+                lines.push(`  RUN: ${query}`);
+            }
+        }
+        lines.push(`MUST SHOW: ${rv.must_show}`);
+    }
+    return { payload: lines.join("\n"), blocking: blockingScars.length };
+}
+/**
+ * Format scars in full mode.
+ * Rich markdown matching recall's formatResponse output.
+ * No token limit.
+ */
+function formatFull(scars, plan) {
+    if (scars.length === 0) {
+        return `[INSTITUTIONAL MEMORY — no relevant scars for: "${plan.slice(0, 100)}"]
+
+Proceed with caution — this may be new territory without documented lessons.`;
+    }
+    const lines = [
+        "⚠️ INSTITUTIONAL MEMORY ACTIVATED",
+        "",
+        `Found ${scars.length} relevant scar${scars.length === 1 ? "" : "s"} for your plan:`,
+        "",
+    ];
+    // Blocking verification requirements first
+    const blockingScars = scars.filter((s) => s.required_verification?.blocking);
+    if (blockingScars.length > 0) {
+        lines.push("═══════════════════════════════════════════════════════════════");
+        lines.push("🚨 **VERIFICATION REQUIRED BEFORE PROCEEDING**");
+        lines.push("═══════════════════════════════════════════════════════════════");
+        lines.push("");
+        for (const scar of blockingScars) {
+            const rv = scar.required_verification;
+            lines.push(`**${scar.title}**`);
+            lines.push(`*When:* ${rv.when}`);
+            lines.push("");
+            lines.push("**YOU MUST RUN:**");
+            for (const query of rv.queries) {
+                lines.push("```sql");
+                lines.push(query);
+                lines.push("```");
+            }
+            lines.push("");
+            lines.push(`**MUST SHOW:** ${rv.must_show}`);
+            lines.push("");
+        }
+        lines.push("═══════════════════════════════════════════════════════════════");
+        lines.push("");
+    }
+    for (const scar of scars) {
+        const emoji = SEVERITY_EMOJI[scar.severity] || "⚪";
+        lines.push(`${emoji} **${scar.title}** (${scar.severity}, score: ${(scar.similarity || 0).toFixed(2)})`);
+        lines.push(scar.description);
+        if (scar.counter_arguments && scar.counter_arguments.length > 0) {
+            lines.push("");
+            lines.push("*You might think:*");
+            for (const counter of scar.counter_arguments.slice(0, 2)) {
+                lines.push(`  - ${counter}`);
+            }
+        }
+        if (scar.why_this_matters) {
+            lines.push("");
+            lines.push(`**Why this matters:** ${scar.why_this_matters}`);
+        }
+        if (scar.action_protocol && scar.action_protocol.length > 0) {
+            lines.push("");
+            lines.push("**Action Protocol:**");
+            scar.action_protocol.forEach((step, i) => {
+                lines.push(`  ${i + 1}. ${step}`);
+            });
+        }
+        if (scar.self_check_criteria && scar.self_check_criteria.length > 0) {
+            lines.push("");
+            lines.push("**Self-Check:**");
+            for (const criterion of scar.self_check_criteria) {
+                lines.push(`  - [ ] ${criterion}`);
+            }
+        }
+        if (scar.source_linear_issue) {
+            lines.push(`*Source:* ${scar.source_linear_issue}`);
+        }
+        lines.push("");
+        lines.push("---");
+        lines.push("");
+    }
+    lines.push("**Acknowledge these lessons before proceeding.**");
+    return lines.join("\n");
+}
+// --- Build Result Helper ---
+function buildResult(scars, plan, format, maxTokens, timer, metricsId, project, search_mode, searchLatencyMs, network_call, cache_hit, cache_age_ms) {
+    let memory_payload;
+    let scars_included;
+    let blocking_scars;
+    switch (format) {
+        case "compact": {
+            const result = formatCompact(scars, plan, maxTokens);
+            memory_payload = result.payload;
+            scars_included = result.included;
+            blocking_scars = scars.filter((s) => s.required_verification?.blocking).length;
+            break;
+        }
+        case "gate": {
+            const result = formatGate(scars);
+            memory_payload = result.payload;
+            scars_included = result.blocking;
+            blocking_scars = result.blocking;
+            break;
+        }
+        case "full":
+        default: {
+            memory_payload = formatFull(scars, plan);
+            scars_included = scars.length;
+            blocking_scars = scars.filter((s) => s.required_verification?.blocking).length;
+            break;
+        }
+    }
+    const token_estimate = estimateTokens(memory_payload);
+    const latencyMs = timer.stop();
+    const breakdown = searchLatencyMs !== undefined
+        ? {
+            scar_search: buildComponentPerformance(searchLatencyMs, search_mode === "local" ? "local_cache" : "supabase", network_call ?? false, (network_call ?? false) ? "miss" : "hit"),
+        }
+        : undefined;
+    const perfData = buildPerformanceData("prepare_context", latencyMs, scars_included, {
+        memoriesSurfaced: scars.slice(0, scars_included).map((s) => s.id),
+        similarityScores: scars.slice(0, scars_included).map((s) => s.similarity || 0),
+        cache_hit: cache_hit ?? false,
+        cache_age_ms,
+        search_mode,
+        breakdown,
+    });
+    // Fire-and-forget metrics
+    recordMetrics({
+        id: metricsId,
+        tool_name: "prepare_context",
+        query_text: `prepare_context:${format}:${plan.slice(0, 80)}`,
+        tables_searched: search_mode === "local" ? [] : ["orchestra_learnings"],
+        latency_ms: latencyMs,
+        result_count: scars_included,
+        phase_tag: "recall",
+        metadata: {
+            tool: "prepare_context",
+            project,
+            format,
+            max_tokens: maxTokens,
+            agent_role: undefined, // Reserved for Phase 3
+            token_estimate,
+            blocking_scars,
+        },
+    }).catch(() => { });
+    return {
+        memory_payload,
+        scars_included,
+        blocking_scars,
+        format,
+        token_estimate,
+        performance: perfData,
+    };
+}
+// --- Main Implementation ---
+export async function prepareContext(params) {
+    const timer = new Timer();
+    const metricsId = uuidv4();
+    const plan = params.plan;
+    const format = params.format;
+    const project = params.project || "orchestra_dev";
+    const maxTokens = params.max_tokens || (format === "compact" ? 500 : format === "gate" ? 100 : 10000);
+    const matchCount = 5;
+    // FREE TIER: local keyword search
+    if (!hasSupabase()) {
+        try {
+            const storage = getStorage();
+            const rawResults = await storage.search(plan, matchCount);
+            const scars = rawResults.map((r) => ({
+                id: r.id,
+                title: r.title,
+                description: r.description || "",
+                severity: r.severity || "medium",
+                counter_arguments: r.counter_arguments || [],
+                similarity: r.similarity || 0,
+            }));
+            return buildResult(scars, plan, format, maxTokens, timer, metricsId, project, "local");
+        }
+        catch (error) {
+            const latencyMs = timer.stop();
+            return {
+                memory_payload: "[INSTITUTIONAL MEMORY — error loading scars]",
+                scars_included: 0,
+                blocking_scars: 0,
+                format,
+                token_estimate: 0,
+                performance: buildPerformanceData("prepare_context", latencyMs, 0),
+            };
+        }
+    }
+    // PRO/DEV TIER: vector search
+    if (!supabase.isConfigured()) {
+        const latencyMs = timer.stop();
+        return {
+            memory_payload: "[INSTITUTIONAL MEMORY — not configured]",
+            scars_included: 0,
+            blocking_scars: 0,
+            format,
+            token_estimate: 0,
+            performance: buildPerformanceData("prepare_context", latencyMs, 0),
+        };
+    }
+    try {
+        let rawScars = [];
+        let search_mode = "remote";
+        let network_call = true;
+        let cache_hit = false;
+        let cache_age_ms;
+        const searchTimer = new Timer();
+        if (isLocalSearchReady(project)) {
+            search_mode = "local";
+            cache_hit = true;
+            network_call = false;
+            const localResults = await localScarSearch(plan, matchCount, project);
+            rawScars = localResults.map((r) => ({
+                id: r.id,
+                title: r.title,
+                description: r.description,
+                severity: r.severity,
+                counter_arguments: r.counter_arguments,
+                similarity: r.similarity,
+                why_this_matters: r.why_this_matters,
+                action_protocol: r.action_protocol,
+                self_check_criteria: r.self_check_criteria,
+            }));
+        }
+        else {
+            search_mode = "remote";
+            const supabaseResult = await supabase.cachedScarSearch(plan, matchCount, project);
+            rawScars = supabaseResult.results;
+            cache_hit = supabaseResult.cache_hit;
+            cache_age_ms = supabaseResult.cache_age_ms;
+        }
+        const searchLatencyMs = searchTimer.stop();
+        return buildResult(rawScars, plan, format, maxTokens, timer, metricsId, project, search_mode, searchLatencyMs, network_call, cache_hit, cache_age_ms);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error("[prepare_context] Search failed:", message);
+        const latencyMs = timer.stop();
+        return {
+            memory_payload: `[INSTITUTIONAL MEMORY — error: ${message}]`,
+            scars_included: 0,
+            blocking_scars: 0,
+            format,
+            token_estimate: 0,
+            performance: buildPerformanceData("prepare_context", latencyMs, 0),
+        };
+    }
+}
+//# sourceMappingURL=prepare-context.js.map

package/dist/tools/prepare-context.js.map

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

package/dist/tools/promote-suggestion.d.ts

@@ -0,0 +1,25 @@
+/**
+ * promote_suggestion Tool (Phase 5: Implicit Thread Detection)
+ *
+ * Promotes a suggested thread to an actual open thread.
+ * 1. Load suggestions, find by ID
+ * 2. Create thread via createThread()
+ * 3. Mark suggestion as promoted with promoted_thread_id
+ * 4. Save updated suggestions
+ *
+ * Performance target: <1000ms (thread creation + file write)
+ */
+import type { ThreadObject, PerformanceData, Project, ThreadSuggestion } from "../types/index.js";
+export interface PromoteSuggestionParams {
+    suggestion_id: string;
+    project?: Project;
+}
+export interface PromoteSuggestionResult {
+    success: boolean;
+    thread?: ThreadObject;
+    suggestion?: ThreadSuggestion;
+    error?: string;
+    performance: PerformanceData;
+}
+export declare function promoteSuggestion(params: PromoteSuggestionParams): Promise<PromoteSuggestionResult>;
+//# sourceMappingURL=promote-suggestion.d.ts.map

package/dist/tools/promote-suggestion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promote-suggestion.d.ts","sourceRoot":"","sources":["../../src/tools/promote-suggestion.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAIlG,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,eAAe,CAAC;CAC9B;AAID,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,uBAAuB,CAAC,CAoDlC"}

package/dist/tools/promote-suggestion.js

@@ -0,0 +1,60 @@
+/**
+ * promote_suggestion Tool (Phase 5: Implicit Thread Detection)
+ *
+ * Promotes a suggested thread to an actual open thread.
+ * 1. Load suggestions, find by ID
+ * 2. Create thread via createThread()
+ * 3. Mark suggestion as promoted with promoted_thread_id
+ * 4. Save updated suggestions
+ *
+ * Performance target: <1000ms (thread creation + file write)
+ */
+import { loadSuggestions, saveSuggestions, promoteSuggestionById, } from "../services/thread-suggestions.js";
+import { createThread } from "./create-thread.js";
+import { Timer, buildPerformanceData, } from "../services/metrics.js";
+// --- Handler ---
+export async function promoteSuggestion(params) {
+    const timer = new Timer();
+    if (!params.suggestion_id) {
+        const latencyMs = timer.stop();
+        return {
+            success: false,
+            error: "suggestion_id is required",
+            performance: buildPerformanceData("promote_suggestion", latencyMs, 0),
+        };
+    }
+    const suggestions = loadSuggestions();
+    const target = suggestions.find((s) => s.id === params.suggestion_id && s.status === "pending");
+    if (!target) {
+        const latencyMs = timer.stop();
+        return {
+            success: false,
+            error: `Pending suggestion not found: "${params.suggestion_id}"`,
+            performance: buildPerformanceData("promote_suggestion", latencyMs, 0),
+        };
+    }
+    // Create the thread from the suggestion text
+    const threadResult = await createThread({
+        text: target.text,
+        project: params.project,
+    });
+    if (!threadResult.success || !threadResult.thread) {
+        const latencyMs = timer.stop();
+        return {
+            success: false,
+            error: `Thread creation failed: ${threadResult.error || "unknown"}`,
+            performance: buildPerformanceData("promote_suggestion", latencyMs, 0),
+        };
+    }
+    // Mark suggestion as promoted
+    promoteSuggestionById(params.suggestion_id, threadResult.thread.id, suggestions);
+    saveSuggestions(suggestions);
+    const latencyMs = timer.stop();
+    return {
+        success: true,
+        thread: threadResult.thread,
+        suggestion: target,
+        performance: buildPerformanceData("promote_suggestion", latencyMs, 1),
+    };
+}
+//# sourceMappingURL=promote-suggestion.js.map