gitmem-mcp 0.2.0

package/dist/services/local-file-storage.js.map

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

package/dist/services/local-vector-search.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Local Vector Search Service
+ *
+ * Provides consistent, local semantic search using:
+ * - OpenRouter API for query embeddings (same model as ww-mcp)
+ * - Pure JavaScript cosine similarity (no native dependencies)
+ * - In-memory scar index (loaded once from Supabase)
+ *
+ * Solves the 500-employees-at-8AM problem:
+ * - No Supabase contention (data loaded once at startup)
+ * - Deterministic results (same model + same data = same results)
+ * - Per-container consistency (each loads same data)
+ *
+ * Issue: OD-473 (cache consistency)
+ */
+import type { Project, RelevantScar } from "../types/index.js";
+interface ScarRecord {
+    id: string;
+    title: string;
+    learning_type?: string;
+    description: string;
+    severity: string;
+    counter_arguments?: string[];
+    project?: string;
+    embedding?: number[];
+    why_this_matters?: string;
+    action_protocol?: string[];
+    self_check_criteria?: string[];
+}
+/**
+ * Cache metadata for staleness detection
+ */
+export interface CacheMetadata {
+    loadedAt: Date;
+    scarCount: number;
+    latestUpdatedAt: string | null;
+    ageMinutes: number;
+    isStale: boolean;
+}
+/**
+ * LocalVectorSearch class
+ *
+ * Manages an in-memory index for fast, consistent scar search.
+ * Uses pure JavaScript - no native dependencies.
+ */
+export declare class LocalVectorSearch {
+    private scars;
+    private initialized;
+    private initPromise;
+    private project;
+    private loadedAt;
+    private latestUpdatedAt;
+    private staleTtlMinutes;
+    constructor(project?: Project);
+    /**
+     * Set cache TTL for staleness detection
+     */
+    setTtlMinutes(minutes: number): void;
+    /**
+     * Initialize the search index with scars from Supabase
+     */
+    initialize(scars: ScarRecord[], latestUpdatedAt?: string): Promise<void>;
+    /**
+     * Force re-initialization with new scars (for flush/refresh)
+     */
+    reinitialize(scars: ScarRecord[], latestUpdatedAt?: string): Promise<void>;
+    private _doInitialize;
+    /**
+     * Check if the index is ready for queries
+     */
+    isReady(): boolean;
+    /**
+     * Get the number of indexed scars
+     */
+    getScarCount(): number;
+    /**
+     * Search for scars similar to the query
+     *
+     * Returns consistent results: same query = same results every time
+     */
+    search(query: string, k?: number): Promise<RelevantScar[]>;
+    /**
+     * Generate embedding for text using the shared embedding service.
+     * Supports multiple providers (OpenAI, OpenRouter, Ollama) via auto-detection.
+     */
+    private _embed;
+    /**
+     * Clear the index and release memory
+     */
+    clear(): void;
+    /**
+     * Get cache metadata for status/health checks
+     */
+    getCacheMetadata(): CacheMetadata | null;
+    /**
+     * Get the latest updated_at timestamp from loaded scars
+     */
+    getLatestUpdatedAt(): string | null;
+}
+/**
+ * Get the LocalVectorSearch instance for a project
+ */
+export declare function getLocalVectorSearch(project?: Project): LocalVectorSearch;
+/**
+ * Initialize local vector search with scars from Supabase
+ *
+ * Call this once at startup with pre-fetched scars
+ */
+export declare function initializeLocalSearch(scars: ScarRecord[], project?: Project, latestUpdatedAt?: string): Promise<void>;
+/**
+ * Reinitialize local search (for cache flush/refresh)
+ */
+export declare function reinitializeLocalSearch(scars: ScarRecord[], project?: Project, latestUpdatedAt?: string): Promise<void>;
+/**
+ * Search for scars using local vector search
+ *
+ * Falls back to empty results if not initialized
+ */
+export declare function localScarSearch(query: string, k?: number, project?: Project): Promise<RelevantScar[]>;
+/**
+ * Check if local search is ready
+ */
+export declare function isLocalSearchReady(project?: Project): boolean;
+/**
+ * Get cache metadata for a project
+ */
+export declare function getCacheMetadata(project?: Project): CacheMetadata | null;
+/**
+ * Set cache TTL for a project
+ */
+export declare function setCacheTtl(minutes: number, project?: Project): void;
+/**
+ * Clear the local search index
+ */
+export declare function clearLocalSearch(project?: Project): void;
+export {};
+//# sourceMappingURL=local-vector-search.d.ts.map

package/dist/services/local-vector-search.d.ts.map

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

package/dist/services/local-vector-search.js

@@ -0,0 +1,311 @@
+/**
+ * Local Vector Search Service
+ *
+ * Provides consistent, local semantic search using:
+ * - OpenRouter API for query embeddings (same model as ww-mcp)
+ * - Pure JavaScript cosine similarity (no native dependencies)
+ * - In-memory scar index (loaded once from Supabase)
+ *
+ * Solves the 500-employees-at-8AM problem:
+ * - No Supabase contention (data loaded once at startup)
+ * - Deterministic results (same model + same data = same results)
+ * - Per-container consistency (each loads same data)
+ *
+ * Issue: OD-473 (cache consistency)
+ */
+import { embed as generateEmbedding, getEmbeddingDim, isEmbeddingAvailable } from "./embedding.js";
+// Embedding dimension — read from provider config at runtime
+const getExpectedDim = () => getEmbeddingDim() || 1536;
+/**
+ * Compute cosine similarity between two vectors
+ * Assumes vectors are already normalized (dot product = cosine similarity)
+ */
+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 a vector to unit length
+ */
+function normalize(vec) {
+    let magnitude = 0;
+    for (const v of vec) {
+        magnitude += v * v;
+    }
+    magnitude = Math.sqrt(magnitude);
+    if (magnitude === 0)
+        return vec;
+    return vec.map((v) => v / magnitude);
+}
+/**
+ * LocalVectorSearch class
+ *
+ * Manages an in-memory index for fast, consistent scar search.
+ * Uses pure JavaScript - no native dependencies.
+ */
+export class LocalVectorSearch {
+    scars = [];
+    initialized = false;
+    initPromise = null;
+    project;
+    // Cache metadata
+    loadedAt = null;
+    latestUpdatedAt = null;
+    staleTtlMinutes = 15;
+    constructor(project = "orchestra_dev") {
+        this.project = project;
+    }
+    /**
+     * Set cache TTL for staleness detection
+     */
+    setTtlMinutes(minutes) {
+        this.staleTtlMinutes = Math.max(1, minutes);
+    }
+    /**
+     * Initialize the search index with scars from Supabase
+     */
+    async initialize(scars, latestUpdatedAt) {
+        if (this.initialized)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.initPromise = this._doInitialize(scars, latestUpdatedAt);
+        return this.initPromise;
+    }
+    /**
+     * Force re-initialization with new scars (for flush/refresh)
+     */
+    async reinitialize(scars, latestUpdatedAt) {
+        this.scars = [];
+        this.initialized = false;
+        this.initPromise = null;
+        this.loadedAt = null;
+        this.latestUpdatedAt = null;
+        await this.initialize(scars, latestUpdatedAt);
+    }
+    async _doInitialize(scars, latestUpdatedAt) {
+        const startTime = Date.now();
+        console.error(`[local-vector] Initializing with ${scars.length} scars...`);
+        // Parse and filter scars with valid embeddings
+        // Note: Supabase REST API returns embeddings as JSON strings, not arrays
+        const scarsWithEmbeddings = [];
+        for (const scar of scars) {
+            if (!scar.embedding)
+                continue;
+            // Parse embedding if it's a string (Supabase REST API returns vector as JSON string)
+            let embedding;
+            if (typeof scar.embedding === 'string') {
+                try {
+                    embedding = JSON.parse(scar.embedding);
+                }
+                catch {
+                    console.warn(`[local-vector] Failed to parse embedding for scar ${scar.id}`);
+                    continue;
+                }
+            }
+            else if (Array.isArray(scar.embedding)) {
+                embedding = scar.embedding;
+            }
+            else {
+                continue;
+            }
+            // Validate embedding dimensions (accept any valid length, store for comparison)
+            const expectedDim = getExpectedDim();
+            if (embedding.length !== expectedDim && embedding.length !== 1536) {
+                console.warn(`[local-vector] Scar ${scar.id} has unexpected embedding dimension: ${embedding.length}`);
+                continue;
+            }
+            scarsWithEmbeddings.push({ scar, parsedEmbedding: embedding });
+        }
+        if (scarsWithEmbeddings.length === 0) {
+            console.warn("[local-vector] No scars with valid embeddings found");
+            this.initialized = true;
+            this.loadedAt = new Date();
+            return;
+        }
+        console.error(`[local-vector] ${scarsWithEmbeddings.length} scars have valid embeddings`);
+        // Store scars with normalized embeddings
+        this.scars = scarsWithEmbeddings.map(({ scar, parsedEmbedding }) => ({
+            scar,
+            embedding: normalize(parsedEmbedding),
+        }));
+        // Track cache metadata
+        this.loadedAt = new Date();
+        this.latestUpdatedAt = latestUpdatedAt || null;
+        this.initialized = true;
+        const elapsed = Date.now() - startTime;
+        console.error(`[local-vector] Initialized in ${elapsed}ms`);
+    }
+    /**
+     * Check if the index is ready for queries
+     */
+    isReady() {
+        return this.initialized && this.scars.length > 0;
+    }
+    /**
+     * Get the number of indexed scars
+     */
+    getScarCount() {
+        return this.scars.length;
+    }
+    /**
+     * Search for scars similar to the query
+     *
+     * Returns consistent results: same query = same results every time
+     */
+    async search(query, k = 5) {
+        if (!this.isReady()) {
+            console.warn("[local-vector] Index not ready, returning empty results");
+            return [];
+        }
+        const startTime = Date.now();
+        // Generate query embedding locally
+        const queryEmbedding = await this._embed(query);
+        // Compute similarities to all scars
+        const scored = this.scars.map((indexed) => ({
+            scar: indexed.scar,
+            similarity: cosineSimilarity(queryEmbedding, indexed.embedding),
+        }));
+        // Sort by similarity (descending) and take top k
+        scored.sort((a, b) => b.similarity - a.similarity);
+        const topK = scored.slice(0, k);
+        // Map to result format
+        const results = topK.map(({ scar, similarity }) => ({
+            id: scar.id,
+            title: scar.title,
+            learning_type: scar.learning_type || "scar",
+            description: scar.description,
+            severity: scar.severity || "medium",
+            counter_arguments: scar.counter_arguments || [],
+            similarity: Math.round(similarity * 1000) / 1000, // 3 decimal places
+            // OD-508: Include enriched fields for LLM-cooperative enforcement
+            why_this_matters: scar.why_this_matters,
+            action_protocol: scar.action_protocol,
+            self_check_criteria: scar.self_check_criteria,
+        }));
+        const elapsed = Date.now() - startTime;
+        console.error(`[local-vector] Search completed in ${elapsed}ms, found ${results.length} results`);
+        return results;
+    }
+    /**
+     * Generate embedding for text using the shared embedding service.
+     * Supports multiple providers (OpenAI, OpenRouter, Ollama) via auto-detection.
+     */
+    async _embed(text) {
+        if (!isEmbeddingAvailable()) {
+            throw new Error("No embedding provider configured (set OPENAI_API_KEY, OPENROUTER_API_KEY, or OLLAMA_URL)");
+        }
+        const result = await generateEmbedding(text);
+        if (!result) {
+            throw new Error("Embedding generation returned null");
+        }
+        // Result is already normalized by the embedding service
+        return result;
+    }
+    /**
+     * Clear the index and release memory
+     */
+    clear() {
+        this.scars = [];
+        this.initialized = false;
+        this.initPromise = null;
+        this.loadedAt = null;
+        this.latestUpdatedAt = null;
+        console.error("[local-vector] Index cleared");
+    }
+    /**
+     * Get cache metadata for status/health checks
+     */
+    getCacheMetadata() {
+        if (!this.loadedAt)
+            return null;
+        const now = new Date();
+        const ageMs = now.getTime() - this.loadedAt.getTime();
+        const ageMinutes = Math.floor(ageMs / 60000);
+        return {
+            loadedAt: this.loadedAt,
+            scarCount: this.scars.length,
+            latestUpdatedAt: this.latestUpdatedAt,
+            ageMinutes,
+            isStale: ageMinutes >= this.staleTtlMinutes,
+        };
+    }
+    /**
+     * Get the latest updated_at timestamp from loaded scars
+     */
+    getLatestUpdatedAt() {
+        return this.latestUpdatedAt;
+    }
+}
+// Singleton instances per project
+const instances = new Map();
+/**
+ * Get the LocalVectorSearch instance for a project
+ */
+export function getLocalVectorSearch(project = "orchestra_dev") {
+    let instance = instances.get(project);
+    if (!instance) {
+        instance = new LocalVectorSearch(project);
+        instances.set(project, instance);
+    }
+    return instance;
+}
+/**
+ * Initialize local vector search with scars from Supabase
+ *
+ * Call this once at startup with pre-fetched scars
+ */
+export async function initializeLocalSearch(scars, project = "orchestra_dev", latestUpdatedAt) {
+    const instance = getLocalVectorSearch(project);
+    await instance.initialize(scars, latestUpdatedAt);
+}
+/**
+ * Reinitialize local search (for cache flush/refresh)
+ */
+export async function reinitializeLocalSearch(scars, project = "orchestra_dev", latestUpdatedAt) {
+    const instance = getLocalVectorSearch(project);
+    await instance.reinitialize(scars, latestUpdatedAt);
+}
+/**
+ * Search for scars using local vector search
+ *
+ * Falls back to empty results if not initialized
+ */
+export async function localScarSearch(query, k = 5, project = "orchestra_dev") {
+    const instance = getLocalVectorSearch(project);
+    return instance.search(query, k);
+}
+/**
+ * Check if local search is ready
+ */
+export function isLocalSearchReady(project = "orchestra_dev") {
+    const instance = instances.get(project);
+    return instance?.isReady() ?? false;
+}
+/**
+ * Get cache metadata for a project
+ */
+export function getCacheMetadata(project = "orchestra_dev") {
+    const instance = instances.get(project);
+    return instance?.getCacheMetadata() ?? null;
+}
+/**
+ * Set cache TTL for a project
+ */
+export function setCacheTtl(minutes, project = "orchestra_dev") {
+    const instance = getLocalVectorSearch(project);
+    instance.setTtlMinutes(minutes);
+}
+/**
+ * Clear the local search index
+ */
+export function clearLocalSearch(project = "orchestra_dev") {
+    const instance = instances.get(project);
+    instance?.clear();
+}
+//# sourceMappingURL=local-vector-search.js.map

package/dist/services/local-vector-search.js.map

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

package/dist/services/metrics.d.ts

@@ -0,0 +1,104 @@
+/**
+ * GitMem Performance Metrics Service
+ *
+ * Tracks latency, result counts, and relevance signals for all GitMem tools.
+ * Implements OD-429 instrumentation layer.
+ */
+/**
+ * Tool names that can be tracked
+ */
+export type ToolName = "recall" | "search" | "log" | "session_start" | "session_refresh" | "session_close" | "create_learning" | "create_decision" | "record_scar_usage" | "record_scar_usage_batch" | "save_transcript" | "get_transcript" | "analyze" | "graph_traverse" | "prepare_context" | "absorb_observations" | "list_threads" | "resolve_thread" | "create_thread" | "confirm_scars" | "cleanup_threads";
+/**
+ * Phase tags for context
+ */
+export type PhaseTag = "session_start" | "session_refresh" | "session_close" | "recall" | "learning_capture" | "decision_capture" | "scar_tracking" | "ad_hoc";
+/**
+ * Agent identities
+ */
+export type AgentIdentity = "CLI" | "DAC" | "CODA-1" | "Brain_Local" | "Brain_Cloud";
+/**
+ * Metrics data for a query
+ */
+export interface QueryMetrics {
+    id: string;
+    session_id?: string;
+    agent?: AgentIdentity;
+    tool_name: ToolName;
+    query_text?: string;
+    tables_searched?: string[];
+    latency_ms: number;
+    result_count: number;
+    similarity_scores?: number[];
+    context_bytes?: number;
+    phase_tag?: PhaseTag;
+    linear_issue?: string;
+    memories_surfaced?: string[];
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Performance targets from OD-429
+ */
+export declare const PERFORMANCE_TARGETS: Record<ToolName, number>;
+/**
+ * Timer utility for tracking operation duration
+ */
+export declare class Timer {
+    private startTime;
+    private endTime?;
+    constructor();
+    stop(): number;
+    elapsed(): number;
+}
+/**
+ * Track a query and record metrics
+ */
+export declare function recordMetrics(metrics: QueryMetrics): Promise<void>;
+/**
+ * Re-export performance types from types/index.ts
+ * OD-489: Enhanced instrumentation for test harness validation
+ */
+export type { PerformanceData, PerformanceBreakdown, ComponentPerformance, DataSource, CacheStatus, } from "../types/index.js";
+import type { PerformanceData, PerformanceBreakdown, ComponentPerformance, DataSource, CacheStatus } from "../types/index.js";
+/**
+ * Build component performance data (OD-489)
+ */
+export declare function buildComponentPerformance(latencyMs: number, source: DataSource, networkCall: boolean, cacheStatus?: CacheStatus): ComponentPerformance;
+/**
+ * Count network calls from breakdown (OD-489)
+ */
+export declare function countNetworkCalls(breakdown?: PerformanceBreakdown): number;
+export declare function buildPerformanceData(toolName: ToolName, latencyMs: number, resultCount: number, options?: {
+    memoriesSurfaced?: string[];
+    similarityScores?: number[];
+    cache_hit?: boolean;
+    cache_age_ms?: number;
+    search_mode?: "local" | "remote";
+    breakdown?: PerformanceBreakdown;
+}): PerformanceData;
+/**
+ * Calculate response size in bytes (approximate)
+ */
+export declare function calculateContextBytes(data: unknown): number;
+/**
+ * Wrap an async operation with timing and metrics
+ */
+export declare function withMetrics<T>(toolName: ToolName, operation: () => Promise<T>, options?: {
+    sessionId?: string;
+    agent?: AgentIdentity;
+    queryText?: string;
+    tablesSearched?: string[];
+    phaseTag?: PhaseTag;
+    linearIssue?: string;
+}): Promise<{
+    result: T;
+    metrics: QueryMetrics;
+}>;
+/**
+ * Update metrics with relevance data (called at session close)
+ */
+export declare function updateRelevanceData(sessionId: string, memoriesApplied: string[]): Promise<void>;
+/**
+ * Detect re-query pattern (similar query with different terms)
+ */
+export declare function detectRequery(sessionId: string, currentQuery: string, toolName: ToolName): Promise<boolean>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/services/metrics.d.ts.map

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