gitmem-mcp 0.2.0

package/dist/services/storage.js

@@ -0,0 +1,92 @@
+/**
+ * Unified Storage Abstraction
+ *
+ * Routes to LocalFileStorage (free tier) or Supabase (pro/dev tier)
+ * based on the detected tier. Tools call getStorage() instead of
+ * importing supabase-client directly.
+ */
+import { hasSupabase, getTableName } from "./tier.js";
+/**
+ * Supabase storage backend (pro/dev tier)
+ */
+class SupabaseStorage {
+    async query(collection, options = {}) {
+        // Dynamic import to avoid loading Supabase in free tier
+        const supabase = await import("./supabase-client.js");
+        const table = getTableName(collection);
+        return supabase.directQuery(table, {
+            select: options.select || "*",
+            filters: options.filters || {},
+            order: options.order,
+            limit: options.limit,
+        });
+    }
+    async get(collection, id) {
+        const results = await this.query(collection, {
+            filters: { id: `eq.${id}` },
+            limit: 1,
+        });
+        return results[0] || null;
+    }
+    async upsert(collection, data) {
+        const supabase = await import("./supabase-client.js");
+        const table = getTableName(collection);
+        return supabase.directUpsert(table, data);
+    }
+    async search(query, k = 5) {
+        // For pro/dev, local vector search is handled separately in recall.ts
+        // This is a fallback that uses Supabase scar search via MCP
+        const supabase = await import("./supabase-client.js");
+        try {
+            const results = await supabase.scarSearch(query, k);
+            return Array.isArray(results) ? results : [];
+        }
+        catch (error) {
+            console.error("[storage] Supabase search failed:", error);
+            return [];
+        }
+    }
+}
+/**
+ * Local file storage backend (free tier)
+ */
+class LocalStorage {
+    async query(collection, options = {}) {
+        const { getLocalFileStorage } = await import("./local-file-storage.js");
+        const storage = getLocalFileStorage();
+        return storage.list(collection, options);
+    }
+    async get(collection, id) {
+        const { getLocalFileStorage } = await import("./local-file-storage.js");
+        const storage = getLocalFileStorage();
+        return storage.get(collection, id);
+    }
+    async upsert(collection, data) {
+        const { getLocalFileStorage } = await import("./local-file-storage.js");
+        const storage = getLocalFileStorage();
+        return storage.upsert(collection, data);
+    }
+    async search(query, k = 5) {
+        const { getLocalFileStorage } = await import("./local-file-storage.js");
+        const storage = getLocalFileStorage();
+        return storage.keywordSearch(query, k);
+    }
+}
+// Singleton
+let _storage = null;
+/**
+ * Get the storage backend for the current tier
+ */
+export function getStorage() {
+    if (!_storage) {
+        _storage = hasSupabase() ? new SupabaseStorage() : new LocalStorage();
+    }
+    return _storage;
+}
+/**
+ * Reset storage (for testing)
+ */
+export function resetStorage() {
+    _storage = null;
+}
+//# sourceMappingURL=storage.js.map

package/dist/services/storage.js.map

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

package/dist/services/supabase-client.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Supabase MCP Client
+ *
+ * HTTP client for ww-mcp Edge Function following the pattern from
+ * agents/coda/src/services/supabase-mcp.js
+ *
+ * Uses JSON-RPC 2.0 protocol over HTTPS.
+ * Integrates with CacheService for performance (OD-473).
+ */
+import type { Project, SupabaseListOptions, SupabaseSearchOptions } from "../types/index.js";
+/**
+ * Check if Supabase is configured
+ */
+export declare function isConfigured(): boolean;
+/**
+ * List records from a table with optional filters
+ */
+export declare function listRecords<T = unknown>(options: SupabaseListOptions): Promise<T[]>;
+/**
+ * Get a single record by ID
+ */
+export declare function getRecord<T = unknown>(table: string, id: string): Promise<T | null>;
+/**
+ * Upsert (insert or update) a record
+ */
+export declare function upsertRecord<T = unknown>(table: string, data: Record<string, unknown>): Promise<T>;
+/**
+ * Semantic search across tables
+ */
+export declare function semanticSearch<T = unknown>(options: SupabaseSearchOptions): Promise<T[]>;
+/**
+ * Query Supabase REST API directly (bypasses ww-mcp)
+ *
+ * Used for bulk operations like loading all scars with embeddings.
+ * ww-mcp doesn't return embeddings by default to avoid bloated responses,
+ * but for local vector search we need them.
+ */
+export declare function directQuery<T = unknown>(table: string, options?: {
+    select?: string;
+    filters?: Record<string, string>;
+    order?: string;
+    limit?: number;
+}): Promise<T[]>;
+/**
+ * Paginated fetch — retrieves ALL matching rows using PostgREST Range headers.
+ * Use instead of directQuery when the result set may exceed a single page.
+ *
+ * @param pageSize  Rows per request (default 1000)
+ * @param maxRows   Safety cap to prevent runaway queries (default 10000)
+ */
+export declare function directQueryAll<T = unknown>(table: string, options?: {
+    select?: string;
+    filters?: Record<string, string>;
+    order?: string;
+}, pageSize?: number, maxRows?: number): Promise<T[]>;
+/**
+ * Knowledge triple from knowledge_triples table (OD-466)
+ */
+export interface KnowledgeTriple {
+    subject: string;
+    predicate: string;
+    object: string;
+    event_time: string;
+    decay_weight: number;
+    half_life_days: number;
+    decay_floor: number;
+    source_id: string;
+}
+/**
+ * Fetch related knowledge triples for a set of scar IDs (OD-466)
+ *
+ * Queries knowledge_triples table where source_id matches any of the provided scar IDs.
+ * Returns triples grouped by source_id for easy attachment to scars.
+ */
+export declare function fetchRelatedTriples(scarIds: string[]): Promise<Map<string, KnowledgeTriple[]>>;
+/**
+ * Upsert a record directly to Supabase REST API (bypasses ww-mcp)
+ *
+ * Used for tests where ww-mcp authentication is problematic.
+ * Uses Supabase REST API's upsert capability with Prefer: resolution=merge-duplicates.
+ */
+export declare function directUpsert<T = unknown>(table: string, data: Record<string, unknown>): Promise<T>;
+/**
+ * Patch (partial update) existing records in Supabase REST API.
+ *
+ * Uses HTTP PATCH for true partial updates — only the provided fields are
+ * modified.  Unlike directUpsert (POST + merge-duplicates), this does NOT
+ * try to INSERT first, so NOT NULL columns that aren't changing can be
+ * omitted from `data`.
+ *
+ * @param table   Target table name
+ * @param filters PostgREST filter to identify the row(s) to update
+ * @param data    Fields to update (partial — omitted columns stay unchanged)
+ */
+export declare function directPatch<T = unknown>(table: string, filters: Record<string, string>, data: Record<string, unknown>): Promise<T[]>;
+/**
+ * Load all learnings with embeddings directly from Supabase
+ *
+ * This bypasses ww-mcp because we need the embedding vectors for local search.
+ * Returns learnings (scars, patterns, wins, anti-patterns) with full embedding data.
+ *
+ * NOTE: Changed from "scars only" to "all learning types" (OD-542 related fix)
+ */
+export declare function loadScarsWithEmbeddings<T = unknown>(project: string, limit?: number): Promise<T[]>;
+/**
+ * Scar search with severity weighting
+ */
+export declare function scarSearch<T = unknown>(query: string, matchCount?: number, project?: Project): Promise<T[]>;
+/**
+ * Scar search with caching (OD-473)
+ *
+ * Returns cached results if available, otherwise fetches and caches.
+ */
+export declare function cachedScarSearch<T = unknown>(query: string, matchCount?: number, project?: Project): Promise<{
+    results: T[];
+    cache_hit: boolean;
+    cache_age_ms?: number;
+}>;
+/**
+ * List records with caching for decisions (OD-473)
+ */
+export declare function cachedListDecisions<T = unknown>(project?: Project, limit?: number): Promise<{
+    data: T[];
+    cache_hit: boolean;
+    cache_age_ms?: number;
+}>;
+/**
+ * List records with caching for wins
+ */
+export declare function cachedListWins<T = unknown>(project?: Project, limit?: number, columns?: string): Promise<{
+    data: T[];
+    cache_hit: boolean;
+    cache_age_ms?: number;
+}>;
+/**
+ * Upload a file to Supabase Storage
+ */
+export declare function uploadFile(bucket: string, path: string, content: string | Buffer, contentType?: string): Promise<{
+    path: string;
+}>;
+/**
+ * Download a file from Supabase Storage
+ */
+export declare function downloadFile(bucket: string, path: string): Promise<string>;
+/**
+ * Save a session transcript to storage
+ */
+export declare function saveTranscript(sessionId: string, transcript: string, metadata?: {
+    project?: string;
+    agent?: string;
+    format?: "json" | "markdown";
+}): Promise<{
+    transcript_path: string;
+    size_bytes: number;
+}>;
+/**
+ * Retrieve a session transcript from storage
+ */
+export declare function getTranscript(sessionId: string): Promise<{
+    transcript: string;
+    path: string;
+} | null>;
+//# sourceMappingURL=supabase-client.d.ts.map

package/dist/services/supabase-client.d.ts.map

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