gitmem-mcp 0.2.0

package/dist/diagnostics/anonymizer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GitMem Anonymizer
+ *
+ * Strips PII from diagnostic data before it's collected.
+ * Built-in to collector, not post-process.
+ *
+ * Anonymization rules:
+ * - Supabase URL → https://*.supabase.co
+ * - API keys → configured: true/false
+ * - IP addresses → stripped
+ * - Scar/session/decision content → counts only
+ * - Error messages → URLs/keys stripped via regex
+ * - Cache paths → normalized to ~/.gitmem/...
+ * - Hostnames → excluded
+ * - Platform/Node version → included
+ *
+ * Issue: OD-584
+ */
+/**
+ * Anonymize a Supabase URL
+ */
+export declare function anonymizeSupabaseUrl(url: string | undefined): string;
+/**
+ * Check if an API key is configured (returns boolean, not the key)
+ */
+export declare function isApiKeyConfigured(key: string | undefined): boolean;
+/**
+ * Anonymize a file path
+ */
+export declare function anonymizePath(filepath: string): string;
+/**
+ * Anonymize an error message
+ */
+export declare function anonymizeError(error: Error | string): string;
+/**
+ * Anonymize arbitrary string content
+ */
+export declare function anonymizeString(content: string): string;
+/**
+ * Anonymize a cache key (preserve structure, strip values)
+ */
+export declare function anonymizeCacheKey(key: string): string;
+/**
+ * Safe environment info extraction
+ */
+export declare function getSafeEnvironmentInfo(): {
+    platform: string;
+    nodeVersion: string;
+    arch: string;
+};
+/**
+ * Anonymize tool call parameters
+ */
+export declare function anonymizeToolParams(params: Record<string, unknown> | undefined): Record<string, unknown>;
+//# sourceMappingURL=anonymizer.d.ts.map

package/dist/diagnostics/anonymizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anonymizer.d.ts","sourceRoot":"","sources":["../../src/diagnostics/anonymizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqCH;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAoBtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAuB5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgBvD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;CACd,CAMA;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCxG"}

package/dist/diagnostics/anonymizer.js

@@ -0,0 +1,191 @@
+/**
+ * GitMem Anonymizer
+ *
+ * Strips PII from diagnostic data before it's collected.
+ * Built-in to collector, not post-process.
+ *
+ * Anonymization rules:
+ * - Supabase URL → https://*.supabase.co
+ * - API keys → configured: true/false
+ * - IP addresses → stripped
+ * - Scar/session/decision content → counts only
+ * - Error messages → URLs/keys stripped via regex
+ * - Cache paths → normalized to ~/.gitmem/...
+ * - Hostnames → excluded
+ * - Platform/Node version → included
+ *
+ * Issue: OD-584
+ */
+/**
+ * Regex patterns for sensitive data
+ */
+const PATTERNS = {
+    // API keys (common formats like sk_test_xxx, sk_live_xxx, sk-xxx)
+    API_KEY: /(?:sk|pk)[_-](?:test|live|or)?[_-]?[a-zA-Z0-9]{10,}/gi,
+    // Bearer tokens
+    BEARER_TOKEN: /Bearer\s+[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]*/gi,
+    // JWT tokens
+    JWT: /eyJ[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]+\.[A-Za-z0-9\-_]*/g,
+    // Supabase URLs
+    SUPABASE_URL: /https?:\/\/[a-z0-9-]+\.supabase\.co/gi,
+    // Generic URLs with potential secrets
+    URL_WITH_PARAMS: /https?:\/\/[^\s"']+\?[^\s"']*/gi,
+    // IP addresses (IPv4)
+    IPV4: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g,
+    // IP addresses (IPv6)
+    IPV6: /\b(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}\b/g,
+    // Email addresses
+    EMAIL: /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g,
+    // File paths (home directory)
+    HOME_PATH: /(?:\/Users\/[^\/\s]+|\/home\/[^\/\s]+|C:\\Users\\[^\\]+)/gi,
+    // UUIDs (may be session/user IDs)
+    UUID: /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi,
+};
+/**
+ * Anonymize a Supabase URL
+ */
+export function anonymizeSupabaseUrl(url) {
+    if (!url)
+        return "not_configured";
+    if (url.includes("supabase.co")) {
+        return "https://*.supabase.co";
+    }
+    // Local or custom URL
+    return "custom_url_configured";
+}
+/**
+ * Check if an API key is configured (returns boolean, not the key)
+ */
+export function isApiKeyConfigured(key) {
+    return Boolean(key && key.length > 0);
+}
+/**
+ * Anonymize a file path
+ */
+export function anonymizePath(filepath) {
+    if (!filepath)
+        return "";
+    // Replace home directory variations
+    let result = filepath
+        .replace(/\/Users\/[^\/]+/g, "~")
+        .replace(/\/home\/[^\/]+/g, "~")
+        .replace(/C:\\Users\\[^\\]+/gi, "~");
+    // Normalize .gitmem paths
+    if (result.includes(".gitmem") || result.includes(".cache/gitmem")) {
+        const gitmemIndex = result.indexOf(".gitmem");
+        const cacheIndex = result.indexOf(".cache/gitmem");
+        const startIndex = gitmemIndex !== -1 ? gitmemIndex : cacheIndex;
+        if (startIndex !== -1) {
+            result = "~/" + result.slice(startIndex);
+        }
+    }
+    return result;
+}
+/**
+ * Anonymize an error message
+ */
+export function anonymizeError(error) {
+    let message = typeof error === "string" ? error : error.message;
+    // Strip API keys
+    message = message.replace(PATTERNS.API_KEY, "[API_KEY]");
+    message = message.replace(PATTERNS.BEARER_TOKEN, "Bearer [TOKEN]");
+    message = message.replace(PATTERNS.JWT, "[JWT]");
+    // Strip URLs with potential secrets
+    message = message.replace(PATTERNS.SUPABASE_URL, "https://*.supabase.co");
+    message = message.replace(PATTERNS.URL_WITH_PARAMS, "[URL_REDACTED]");
+    // Strip IP addresses
+    message = message.replace(PATTERNS.IPV4, "[IP]");
+    message = message.replace(PATTERNS.IPV6, "[IP]");
+    // Strip email addresses
+    message = message.replace(PATTERNS.EMAIL, "[EMAIL]");
+    // Strip home paths
+    message = message.replace(PATTERNS.HOME_PATH, "~");
+    return message;
+}
+/**
+ * Anonymize arbitrary string content
+ */
+export function anonymizeString(content) {
+    if (!content)
+        return "";
+    let result = content;
+    // Apply all anonymization patterns
+    result = result.replace(PATTERNS.API_KEY, "[API_KEY]");
+    result = result.replace(PATTERNS.BEARER_TOKEN, "Bearer [TOKEN]");
+    result = result.replace(PATTERNS.JWT, "[JWT]");
+    result = result.replace(PATTERNS.SUPABASE_URL, "https://*.supabase.co");
+    result = result.replace(PATTERNS.IPV4, "[IP]");
+    result = result.replace(PATTERNS.IPV6, "[IP]");
+    result = result.replace(PATTERNS.EMAIL, "[EMAIL]");
+    result = result.replace(PATTERNS.HOME_PATH, "~");
+    return result;
+}
+/**
+ * Anonymize a cache key (preserve structure, strip values)
+ */
+export function anonymizeCacheKey(key) {
+    // Cache keys are like: scar_search:abc123:project:5 or decisions:myproject:10
+    // Keep the type, anonymize the middle parts, keep the last numeric part
+    const parts = key.split(":");
+    if (parts.length >= 3) {
+        // Keep first and last, hash the middle
+        return `${parts[0]}:[hash]:${parts.slice(2).join(":")}`;
+    }
+    else if (parts.length === 2) {
+        // Two parts like decisions:myproject - anonymize second
+        return `${parts[0]}:[hash]`;
+    }
+    return "[cache_key]";
+}
+/**
+ * Safe environment info extraction
+ */
+export function getSafeEnvironmentInfo() {
+    return {
+        platform: process.platform,
+        nodeVersion: process.version,
+        arch: process.arch,
+    };
+}
+/**
+ * Anonymize tool call parameters
+ */
+export function anonymizeToolParams(params) {
+    if (!params)
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(params)) {
+        // Skip content fields entirely
+        if (["description", "content", "message", "reflection", "rationale"].includes(key)) {
+            result[key] = "[content_redacted]";
+            continue;
+        }
+        // Anonymize string values
+        if (typeof value === "string") {
+            // Keep short identifiers, redact longer content
+            if (value.length > 50) {
+                result[key] = `[string:${value.length}chars]`;
+            }
+            else if (PATTERNS.API_KEY.test(value) || PATTERNS.EMAIL.test(value)) {
+                result[key] = "[redacted]";
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        else if (typeof value === "number" || typeof value === "boolean") {
+            result[key] = value;
+        }
+        else if (Array.isArray(value)) {
+            result[key] = `[array:${value.length}items]`;
+        }
+        else if (typeof value === "object" && value !== null) {
+            result[key] = "[object]";
+        }
+        else {
+            result[key] = "[unknown]";
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=anonymizer.js.map

package/dist/diagnostics/anonymizer.js.map

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

package/dist/diagnostics/channels.d.ts

@@ -0,0 +1,132 @@
+/**
+ * GitMem Diagnostics Channels
+ *
+ * Defines diagnostics_channel channels for zero-overhead instrumentation.
+ * When no subscriber is attached, publish() is essentially a no-op.
+ *
+ * Pattern reference: @ibm/telemetry-js
+ * Issue: OD-584
+ */
+import { channel, Channel } from "diagnostics_channel";
+/**
+ * Channel names for GitMem diagnostics
+ */
+export declare const CHANNEL_NAMES: {
+    readonly TOOL_CALL: "gitmem:tool:call";
+    readonly CACHE_HIT: "gitmem:cache:hit";
+    readonly CACHE_MISS: "gitmem:cache:miss";
+    readonly DB_QUERY: "gitmem:db:query";
+    readonly EMBEDDING_CALL: "gitmem:embedding:call";
+    readonly ERROR: "gitmem:error";
+};
+/**
+ * Tool call event payload
+ */
+export interface ToolCallEvent {
+    tool: string;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    success?: boolean;
+    error?: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Cache event payload
+ */
+export interface CacheEvent {
+    key: string;
+    type: "scar_search" | "decisions" | "wins" | "embeddings";
+    ageMs?: number;
+    sizeBytes?: number;
+}
+/**
+ * Database query event payload
+ */
+export interface DbQueryEvent {
+    operation: string;
+    table?: string;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    rowCount?: number;
+    success?: boolean;
+    error?: string;
+}
+/**
+ * Embedding call event payload
+ */
+export interface EmbeddingCallEvent {
+    provider: string;
+    model?: string;
+    inputLength: number;
+    startTime: number;
+    endTime?: number;
+    durationMs?: number;
+    success?: boolean;
+    error?: string;
+}
+/**
+ * Error event payload
+ */
+export interface ErrorEvent {
+    error: Error | string;
+    context: string;
+    timestamp: number;
+    severity: "warning" | "error" | "fatal";
+}
+/**
+ * Diagnostics channels singleton
+ */
+declare class DiagnosticsChannels {
+    readonly toolCall: Channel;
+    readonly cacheHit: Channel;
+    readonly cacheMiss: Channel;
+    readonly dbQuery: Channel;
+    readonly embeddingCall: Channel;
+    readonly error: Channel;
+    constructor();
+    /**
+     * Publish tool call start event
+     */
+    publishToolCallStart(tool: string, params?: Record<string, unknown>): ToolCallEvent;
+    /**
+     * Publish tool call end event
+     */
+    publishToolCallEnd(event: ToolCallEvent, success: boolean, error?: string): void;
+    /**
+     * Publish cache hit event
+     */
+    publishCacheHit(key: string, type: CacheEvent["type"], ageMs?: number, sizeBytes?: number): void;
+    /**
+     * Publish cache miss event
+     */
+    publishCacheMiss(key: string, type: CacheEvent["type"]): void;
+    /**
+     * Publish database query start event
+     */
+    publishDbQueryStart(operation: string, table?: string): DbQueryEvent;
+    /**
+     * Publish database query end event
+     */
+    publishDbQueryEnd(event: DbQueryEvent, success: boolean, rowCount?: number, error?: string): void;
+    /**
+     * Publish embedding call start event
+     */
+    publishEmbeddingStart(provider: string, inputLength: number, model?: string): EmbeddingCallEvent;
+    /**
+     * Publish embedding call end event
+     */
+    publishEmbeddingEnd(event: EmbeddingCallEvent, success: boolean, error?: string): void;
+    /**
+     * Publish error event
+     */
+    publishError(error: Error | string, context: string, severity?: ErrorEvent["severity"]): void;
+    /**
+     * Check if any channel has subscribers
+     */
+    hasSubscribers(): boolean;
+}
+export declare const diagnostics: DiagnosticsChannels;
+export { channel };
+//# sourceMappingURL=channels.d.ts.map

package/dist/diagnostics/channels.d.ts.map

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

package/dist/diagnostics/channels.js

@@ -0,0 +1,150 @@
+/**
+ * GitMem Diagnostics Channels
+ *
+ * Defines diagnostics_channel channels for zero-overhead instrumentation.
+ * When no subscriber is attached, publish() is essentially a no-op.
+ *
+ * Pattern reference: @ibm/telemetry-js
+ * Issue: OD-584
+ */
+import { channel } from "diagnostics_channel";
+/**
+ * Channel names for GitMem diagnostics
+ */
+export const CHANNEL_NAMES = {
+    TOOL_CALL: "gitmem:tool:call",
+    CACHE_HIT: "gitmem:cache:hit",
+    CACHE_MISS: "gitmem:cache:miss",
+    DB_QUERY: "gitmem:db:query",
+    EMBEDDING_CALL: "gitmem:embedding:call",
+    ERROR: "gitmem:error",
+};
+/**
+ * Diagnostics channels singleton
+ */
+class DiagnosticsChannels {
+    toolCall;
+    cacheHit;
+    cacheMiss;
+    dbQuery;
+    embeddingCall;
+    error;
+    constructor() {
+        this.toolCall = channel(CHANNEL_NAMES.TOOL_CALL);
+        this.cacheHit = channel(CHANNEL_NAMES.CACHE_HIT);
+        this.cacheMiss = channel(CHANNEL_NAMES.CACHE_MISS);
+        this.dbQuery = channel(CHANNEL_NAMES.DB_QUERY);
+        this.embeddingCall = channel(CHANNEL_NAMES.EMBEDDING_CALL);
+        this.error = channel(CHANNEL_NAMES.ERROR);
+    }
+    /**
+     * Publish tool call start event
+     */
+    publishToolCallStart(tool, params) {
+        const event = {
+            tool,
+            startTime: Date.now(),
+            params,
+        };
+        this.toolCall.publish(event);
+        return event;
+    }
+    /**
+     * Publish tool call end event
+     */
+    publishToolCallEnd(event, success, error) {
+        event.endTime = Date.now();
+        event.durationMs = event.endTime - event.startTime;
+        event.success = success;
+        event.error = error;
+        this.toolCall.publish(event);
+    }
+    /**
+     * Publish cache hit event
+     */
+    publishCacheHit(key, type, ageMs, sizeBytes) {
+        const event = { key, type, ageMs, sizeBytes };
+        this.cacheHit.publish(event);
+    }
+    /**
+     * Publish cache miss event
+     */
+    publishCacheMiss(key, type) {
+        const event = { key, type };
+        this.cacheMiss.publish(event);
+    }
+    /**
+     * Publish database query start event
+     */
+    publishDbQueryStart(operation, table) {
+        const event = {
+            operation,
+            table,
+            startTime: Date.now(),
+        };
+        this.dbQuery.publish(event);
+        return event;
+    }
+    /**
+     * Publish database query end event
+     */
+    publishDbQueryEnd(event, success, rowCount, error) {
+        event.endTime = Date.now();
+        event.durationMs = event.endTime - event.startTime;
+        event.success = success;
+        event.rowCount = rowCount;
+        event.error = error;
+        this.dbQuery.publish(event);
+    }
+    /**
+     * Publish embedding call start event
+     */
+    publishEmbeddingStart(provider, inputLength, model) {
+        const event = {
+            provider,
+            model,
+            inputLength,
+            startTime: Date.now(),
+        };
+        this.embeddingCall.publish(event);
+        return event;
+    }
+    /**
+     * Publish embedding call end event
+     */
+    publishEmbeddingEnd(event, success, error) {
+        event.endTime = Date.now();
+        event.durationMs = event.endTime - event.startTime;
+        event.success = success;
+        event.error = error;
+        this.embeddingCall.publish(event);
+    }
+    /**
+     * Publish error event
+     */
+    publishError(error, context, severity = "error") {
+        const event = {
+            error,
+            context,
+            timestamp: Date.now(),
+            severity,
+        };
+        this.error.publish(event);
+    }
+    /**
+     * Check if any channel has subscribers
+     */
+    hasSubscribers() {
+        return (this.toolCall.hasSubscribers ||
+            this.cacheHit.hasSubscribers ||
+            this.cacheMiss.hasSubscribers ||
+            this.dbQuery.hasSubscribers ||
+            this.embeddingCall.hasSubscribers ||
+            this.error.hasSubscribers);
+    }
+}
+// Singleton instance
+export const diagnostics = new DiagnosticsChannels();
+// Export channel for external subscription
+export { channel };
+//# sourceMappingURL=channels.js.map

package/dist/diagnostics/channels.js.map

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