gitmem-mcp 0.2.0

package/dist/services/thread-dedup.js

@@ -0,0 +1,113 @@
+/**
+ * Thread Deduplication Service (Phase 3)
+ *
+ * Pure functions for detecting duplicate threads by embedding similarity
+ * or normalized text equality. Zero I/O — all Supabase and embedding
+ * calls live in the caller (create-thread.ts).
+ *
+ * Strategy:
+ *   1. If embedding available: cosine similarity > 0.85 → duplicate
+ *   2. If embedding unavailable: normalized text equality → duplicate
+ *   3. If no existing threads: skip check
+ */
+// ---------- Constants ----------
+export const DEDUP_SIMILARITY_THRESHOLD = 0.85;
+// ---------- Core ----------
+/**
+ * Check if new thread text is a semantic duplicate of any existing open thread.
+ *
+ * @param newText - Trimmed thread text
+ * @param newEmbedding - Normalized embedding vector, or null if unavailable
+ * @param existingThreads - Open threads with optional embeddings
+ */
+export function checkDuplicate(newText, newEmbedding, existingThreads) {
+    if (existingThreads.length === 0) {
+        return {
+            is_duplicate: false,
+            matched_thread_id: null,
+            matched_text: null,
+            similarity: null,
+            method: "skipped",
+        };
+    }
+    // Embedding-based comparison
+    if (newEmbedding !== null) {
+        let bestSimilarity = -1;
+        let bestThread = null;
+        for (const thread of existingThreads) {
+            if (thread.embedding === null)
+                continue;
+            const sim = cosineSimilarity(newEmbedding, thread.embedding);
+            if (sim > bestSimilarity) {
+                bestSimilarity = sim;
+                bestThread = thread;
+            }
+        }
+        if (bestThread && bestSimilarity > DEDUP_SIMILARITY_THRESHOLD) {
+            return {
+                is_duplicate: true,
+                matched_thread_id: bestThread.thread_id,
+                matched_text: bestThread.text,
+                similarity: round(bestSimilarity, 4),
+                method: "embedding",
+            };
+        }
+        return {
+            is_duplicate: false,
+            matched_thread_id: null,
+            matched_text: null,
+            similarity: bestSimilarity >= 0 ? round(bestSimilarity, 4) : null,
+            method: "embedding",
+        };
+    }
+    // Text normalization fallback (conservative: exact match only)
+    const normalizedNew = normalizeText(newText);
+    for (const thread of existingThreads) {
+        if (normalizeText(thread.text) === normalizedNew) {
+            return {
+                is_duplicate: true,
+                matched_thread_id: thread.thread_id,
+                matched_text: thread.text,
+                similarity: null,
+                method: "text_normalization",
+            };
+        }
+    }
+    return {
+        is_duplicate: false,
+        matched_thread_id: null,
+        matched_text: null,
+        similarity: null,
+        method: "text_normalization",
+    };
+}
+// ---------- Helpers ----------
+/**
+ * Cosine similarity between two normalized vectors.
+ * Assumes vectors are already L2-normalized (dot product = cosine similarity).
+ */
+export function cosineSimilarity(a, b) {
+    if (a.length !== b.length)
+        return 0;
+    let dotProduct = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+    }
+    return dotProduct;
+}
+/**
+ * Normalize text for conservative text-only comparison.
+ * Lowercase, collapse whitespace, trim, strip trailing punctuation.
+ */
+export function normalizeText(text) {
+    return text
+        .toLowerCase()
+        .replace(/\s+/g, " ")
+        .trim()
+        .replace(/[.!?;:]+$/, "");
+}
+function round(value, decimals) {
+    const factor = 10 ** decimals;
+    return Math.round(value * factor) / factor;
+}
+//# sourceMappingURL=thread-dedup.js.map

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

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

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

@@ -0,0 +1,77 @@
+/**
+ * Thread Lifecycle Manager (OD-thread-lifecycle)
+ *
+ * Core logic for thread lifecycle management:
+ * - ID generation, migration from plain strings to ThreadObject
+ * - Aggregation across sessions (replaces aggregateOpenThreads)
+ * - Resolution by ID or text match
+ * - Local file persistence (.gitmem/threads.json)
+ */
+import type { ThreadObject } from "../types/index.js";
+/**
+ * Generate a thread ID: "t-" + 8 hex chars
+ */
+export declare function generateThreadId(): string;
+/**
+ * Migrate a plain string thread to a ThreadObject.
+ */
+export declare function migrateStringThread(text: string, sourceSession?: string): ThreadObject;
+/**
+ * Normalize a mixed array of strings and ThreadObjects into ThreadObject[].
+ * Handles backward compatibility with existing plain string threads.
+ */
+export declare function normalizeThreads(raw: (string | ThreadObject)[], sourceSession?: string): ThreadObject[];
+interface SessionRecord {
+    id: string;
+    session_date: string;
+    open_threads?: (string | ThreadObject)[];
+    close_compliance?: Record<string, unknown> | null;
+}
+interface AggregateResult {
+    open: ThreadObject[];
+    recently_resolved: ThreadObject[];
+}
+/**
+ * Aggregate threads across recent closed sessions.
+ * Replaces the old aggregateOpenThreads() function.
+ *
+ * Returns:
+ * - open: deduplicated open threads
+ * - recently_resolved: threads resolved in the most recent session
+ */
+export declare function aggregateThreads(sessions: SessionRecord[], maxSessions?: number, maxAgeDays?: number): AggregateResult;
+/**
+ * Find a thread by exact ID.
+ */
+export declare function findThreadById(threads: ThreadObject[], id: string): ThreadObject | null;
+/**
+ * Find a thread by case-insensitive substring match on text.
+ * Returns the first match.
+ */
+export declare function findThreadByText(threads: ThreadObject[], query: string): ThreadObject | null;
+/**
+ * Resolve a thread in a list. Returns the resolved thread or null if not found.
+ * Mutates the thread object in place.
+ */
+export declare function resolveThread(threads: ThreadObject[], options: {
+    threadId?: string;
+    textMatch?: string;
+    sessionId?: string;
+    resolutionNote?: string;
+}): ThreadObject | null;
+/**
+ * Load threads from .gitmem/threads.json.
+ * Returns empty array if file doesn't exist or is invalid.
+ */
+export declare function loadThreadsFile(): ThreadObject[];
+/**
+ * Save threads to .gitmem/threads.json.
+ */
+export declare function saveThreadsFile(threads: ThreadObject[]): void;
+/**
+ * Merge two thread lists, preferring resolved state.
+ * Used to merge session-close payload with mid-session resolutions.
+ */
+export declare function mergeThreadStates(incoming: ThreadObject[], current: ThreadObject[]): ThreadObject[];
+export {};
+//# sourceMappingURL=thread-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread-manager.d.ts","sourceRoot":"","sources":["../../src/services/thread-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAgB,MAAM,mBAAmB,CAAC;AAIpE;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAQtF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,EAC9B,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,EAAE,CA+DhB;AAID,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACnD;AAED,UAAU,eAAe;IACvB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,iBAAiB,EAAE,YAAY,EAAE,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EAAE,EACzB,WAAW,SAAI,EACf,UAAU,SAAK,GACd,eAAe,CAwCjB;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAEvF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAG5F;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,YAAY,EAAE,EACvB,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,YAAY,GAAG,IAAI,CAkBrB;AAWD;;;GAGG;AACH,wBAAgB,eAAe,IAAI,YAAY,EAAE,CAWhD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAO7D;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE,YAAY,EAAE,GACtB,YAAY,EAAE,CA8BhB"}

package/dist/services/thread-manager.js

@@ -0,0 +1,250 @@
+/**
+ * Thread Lifecycle Manager (OD-thread-lifecycle)
+ *
+ * Core logic for thread lifecycle management:
+ * - ID generation, migration from plain strings to ThreadObject
+ * - Aggregation across sessions (replaces aggregateOpenThreads)
+ * - Resolution by ID or text match
+ * - Local file persistence (.gitmem/threads.json)
+ */
+import * as fs from "fs";
+import * as path from "path";
+import * as crypto from "crypto";
+// ---------- ID Generation ----------
+/**
+ * Generate a thread ID: "t-" + 8 hex chars
+ */
+export function generateThreadId() {
+    return "t-" + crypto.randomBytes(4).toString("hex");
+}
+// ---------- Migration ----------
+/**
+ * Migrate a plain string thread to a ThreadObject.
+ */
+export function migrateStringThread(text, sourceSession) {
+    return {
+        id: generateThreadId(),
+        text,
+        status: "open",
+        created_at: new Date().toISOString(),
+        ...(sourceSession && { source_session: sourceSession }),
+    };
+}
+/**
+ * Normalize a mixed array of strings and ThreadObjects into ThreadObject[].
+ * Handles backward compatibility with existing plain string threads.
+ */
+export function normalizeThreads(raw, sourceSession) {
+    return raw.map((item) => {
+        if (typeof item === "string") {
+            // Try to parse JSON thread objects (some sessions store {item, context} or full ThreadObject)
+            if (item.startsWith("{")) {
+                try {
+                    const parsed = JSON.parse(item);
+                    // If it looks like a ThreadObject already, use it
+                    if (parsed.id && parsed.text && parsed.status) {
+                        return parsed;
+                    }
+                    // Handle {id, status, note} format — "note" is an alias for "text"
+                    // This format appears when threads carry forward between sessions
+                    if (parsed.id && parsed.note && parsed.status) {
+                        return {
+                            id: parsed.id,
+                            text: parsed.note,
+                            status: parsed.status,
+                            created_at: parsed.created_at || new Date().toISOString(),
+                            ...(sourceSession && { source_session: sourceSession }),
+                            ...(parsed.resolved_at && { resolved_at: parsed.resolved_at }),
+                        };
+                    }
+                    // Legacy format: {item, context} or {text, status} without id
+                    return migrateStringThread(parsed.item || parsed.text || parsed.note || item, sourceSession);
+                }
+                catch {
+                    // Not valid JSON, treat as plain text
+                }
+            }
+            return migrateStringThread(item, sourceSession);
+        }
+        // Already a ThreadObject — but validate and repair common field issues
+        const obj = item;
+        // Fix objects with "note" instead of "text" (agent writes {id, status, note})
+        if (!obj.text && obj.note && typeof obj.note === "string") {
+            return {
+                ...item,
+                text: obj.note,
+            };
+        }
+        // Fix objects where "text" is a JSON string containing a thread
+        if (typeof obj.text === "string" && obj.text.startsWith("{")) {
+            try {
+                const inner = JSON.parse(obj.text);
+                if (inner.id && (inner.text || inner.note)) {
+                    return {
+                        id: inner.id,
+                        text: inner.text || inner.note,
+                        status: inner.status || item.status,
+                        created_at: inner.created_at || item.created_at || new Date().toISOString(),
+                        ...(sourceSession && { source_session: sourceSession }),
+                        ...(inner.resolved_at && { resolved_at: inner.resolved_at }),
+                    };
+                }
+            }
+            catch {
+                // Not valid JSON in text field, keep as-is
+            }
+        }
+        return item;
+    });
+}
+/**
+ * Aggregate threads across recent closed sessions.
+ * Replaces the old aggregateOpenThreads() function.
+ *
+ * Returns:
+ * - open: deduplicated open threads
+ * - recently_resolved: threads resolved in the most recent session
+ */
+export function aggregateThreads(sessions, maxSessions = 5, maxAgeDays = 14) {
+    const cutoffDate = new Date();
+    cutoffDate.setDate(cutoffDate.getDate() - maxAgeDays);
+    const cutoffStr = cutoffDate.toISOString().split("T")[0];
+    const closedSessions = sessions
+        .filter((s) => s.close_compliance != null && s.session_date >= cutoffStr)
+        .slice(0, maxSessions);
+    const seenText = new Set();
+    const seenIds = new Set();
+    const open = [];
+    const recentlyResolved = [];
+    for (const session of closedSessions) {
+        const rawThreads = session.open_threads || [];
+        const normalized = normalizeThreads(rawThreads, session.id);
+        for (const thread of normalized) {
+            // Skip PROJECT STATE threads (handled separately via OD-534)
+            if (thread.text.startsWith("PROJECT STATE:"))
+                continue;
+            // Deduplicate by both thread ID and text content
+            const key = thread.text.toLowerCase().trim();
+            if (!key || seenText.has(key) || seenIds.has(thread.id))
+                continue;
+            seenText.add(key);
+            seenIds.add(thread.id);
+            if (thread.status === "resolved") {
+                recentlyResolved.push(thread);
+            }
+            else {
+                open.push(thread);
+            }
+        }
+    }
+    return { open, recently_resolved: recentlyResolved };
+}
+// ---------- Thread Resolution ----------
+/**
+ * Find a thread by exact ID.
+ */
+export function findThreadById(threads, id) {
+    return threads.find((t) => t.id === id) || null;
+}
+/**
+ * Find a thread by case-insensitive substring match on text.
+ * Returns the first match.
+ */
+export function findThreadByText(threads, query) {
+    const lowerQuery = query.toLowerCase().trim();
+    return threads.find((t) => t.text.toLowerCase().includes(lowerQuery)) || null;
+}
+/**
+ * Resolve a thread in a list. Returns the resolved thread or null if not found.
+ * Mutates the thread object in place.
+ */
+export function resolveThread(threads, options) {
+    let thread = null;
+    if (options.threadId) {
+        thread = findThreadById(threads, options.threadId);
+    }
+    else if (options.textMatch) {
+        thread = findThreadByText(threads, options.textMatch);
+    }
+    if (!thread)
+        return null;
+    if (thread.status === "resolved")
+        return thread; // Already resolved
+    thread.status = "resolved";
+    thread.resolved_at = new Date().toISOString();
+    if (options.sessionId)
+        thread.resolved_by_session = options.sessionId;
+    if (options.resolutionNote)
+        thread.resolution_note = options.resolutionNote;
+    return thread;
+}
+// ---------- Local File Persistence ----------
+const THREADS_FILENAME = "threads.json";
+function getThreadsFilePath() {
+    const gitmemDir = path.join(process.cwd(), ".gitmem");
+    return path.join(gitmemDir, THREADS_FILENAME);
+}
+/**
+ * Load threads from .gitmem/threads.json.
+ * Returns empty array if file doesn't exist or is invalid.
+ */
+export function loadThreadsFile() {
+    try {
+        const filePath = getThreadsFilePath();
+        if (!fs.existsSync(filePath))
+            return [];
+        const content = fs.readFileSync(filePath, "utf-8");
+        const data = JSON.parse(content);
+        if (!Array.isArray(data))
+            return [];
+        return data;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Save threads to .gitmem/threads.json.
+ */
+export function saveThreadsFile(threads) {
+    const gitmemDir = path.join(process.cwd(), ".gitmem");
+    if (!fs.existsSync(gitmemDir)) {
+        fs.mkdirSync(gitmemDir, { recursive: true });
+    }
+    const filePath = path.join(gitmemDir, THREADS_FILENAME);
+    fs.writeFileSync(filePath, JSON.stringify(threads, null, 2));
+}
+// ---------- Merge ----------
+/**
+ * Merge two thread lists, preferring resolved state.
+ * Used to merge session-close payload with mid-session resolutions.
+ */
+export function mergeThreadStates(incoming, current) {
+    const byId = new Map();
+    // Start with current state (may have mid-session resolutions)
+    for (const t of current) {
+        byId.set(t.id, t);
+    }
+    // Merge incoming — new threads get added, existing threads prefer resolved state
+    for (const t of incoming) {
+        const existing = byId.get(t.id);
+        if (!existing) {
+            byId.set(t.id, t);
+        }
+        else if (t.status === "resolved" && existing.status === "open") {
+            // Incoming says resolved — update
+            byId.set(t.id, t);
+        }
+        // If existing is resolved and incoming is open, keep resolved
+    }
+    // Also merge by text for threads that have different IDs (migration scenario)
+    const textIndex = new Map(); // text -> id
+    for (const [id, t] of byId) {
+        const key = t.text.toLowerCase().trim();
+        if (!textIndex.has(key)) {
+            textIndex.set(key, id);
+        }
+    }
+    return Array.from(byId.values());
+}
+//# sourceMappingURL=thread-manager.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * 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 type { ThreadWithEmbedding } from "./thread-dedup.js";
+import type { ThreadSuggestion, Project } from "../types/index.js";
+export declare const SESSION_SIMILARITY_THRESHOLD = 0.7;
+export declare const THREAD_MATCH_THRESHOLD = 0.8;
+export declare const SUGGESTION_MATCH_THRESHOLD = 0.8;
+export declare const MIN_EVIDENCE_SESSIONS = 3;
+export interface SessionEmbeddingRecord {
+    session_id: string;
+    session_title: string;
+    embedding: number[];
+}
+/**
+ * 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 declare function detectSuggestedThreads(currentSession: {
+    session_id: string;
+    title: string;
+    embedding: number[];
+}, recentSessions: SessionEmbeddingRecord[], openThreadEmbeddings: ThreadWithEmbedding[], existingSuggestions: ThreadSuggestion[]): ThreadSuggestion[];
+/**
+ * Promote a suggestion to an open thread.
+ * Mutates the suggestion in-place and returns it, or null if not found.
+ */
+export declare function promoteSuggestionById(id: string, threadId: string, suggestions: ThreadSuggestion[]): ThreadSuggestion | null;
+/**
+ * Dismiss a suggestion. Increments dismissed_count.
+ * Mutates the suggestion in-place and returns it, or null if not found.
+ */
+export declare function dismissSuggestionById(id: string, suggestions: ThreadSuggestion[]): ThreadSuggestion | null;
+/**
+ * Filter to only pending suggestions (not promoted/dismissed).
+ * Excludes suggestions dismissed 3+ times (permanently suppressed).
+ */
+export declare function getPendingSuggestions(suggestions: ThreadSuggestion[]): ThreadSuggestion[];
+/**
+ * Load suggestions from .gitmem/suggested-threads.json.
+ * Returns empty array if file doesn't exist or is corrupted.
+ */
+export declare function loadSuggestions(): ThreadSuggestion[];
+/**
+ * Save suggestions to .gitmem/suggested-threads.json.
+ */
+export declare function saveSuggestions(suggestions: ThreadSuggestion[]): void;
+/**
+ * Fetch recent session embeddings from Supabase for clustering comparison.
+ * Returns null if Supabase is unavailable.
+ */
+export declare function loadRecentSessionEmbeddings(project?: Project, days?: number, limit?: number): Promise<SessionEmbeddingRecord[] | null>;
+export declare function generateSuggestionId(): string;
+//# sourceMappingURL=thread-suggestions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"thread-suggestions.d.ts","sourceRoot":"","sources":["../../src/services/thread-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAInE,eAAO,MAAM,4BAA4B,MAAO,CAAC;AACjD,eAAO,MAAM,sBAAsB,MAAO,CAAC;AAC3C,eAAO,MAAM,0BAA0B,MAAO,CAAC;AAC/C,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAMvC,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAID;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,EAC1E,cAAc,EAAE,sBAAsB,EAAE,EACxC,oBAAoB,EAAE,mBAAmB,EAAE,EAC3C,mBAAmB,EAAE,gBAAgB,EAAE,GACtC,gBAAgB,EAAE,CA4EpB;AAID;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,gBAAgB,EAAE,GAC9B,gBAAgB,GAAG,IAAI,CAQzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,gBAAgB,EAAE,GAC9B,gBAAgB,GAAG,IAAI,CAQzB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,gBAAgB,EAAE,GAC9B,gBAAgB,EAAE,CAIpB;AAID;;;GAGG;AACH,wBAAgB,eAAe,IAAI,gBAAgB,EAAE,CAapD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAcrE;AAsBD;;;GAGG;AACH,wBAAsB,2BAA2B,CAC/C,OAAO,GAAE,OAAyB,EAClC,IAAI,GAAE,MAAW,EACjB,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,sBAAsB,EAAE,GAAG,IAAI,CAAC,CAgD1C;AAID,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C"}