@ginkoai/cli 1.0.0

package/dist/services/ai-service.js

@@ -0,0 +1,329 @@
+/**
+ * @fileType: service
+ * @status: current
+ * @updated: 2025-09-10
+ * @tags: [ai, api, claude, openai, insights]
+ * @related: [insight-extractor.ts, ../adapters/ai-adapter.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: []
+ */
+export class BaseAIService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+}
+/**
+ * Anthropic Claude API Service
+ */
+export class AnthropicService extends BaseAIService {
+    apiUrl = 'https://api.anthropic.com/v1/messages';
+    constructor(config) {
+        super(config);
+        if (!config.apiKey) {
+            throw new Error('Anthropic API key is required');
+        }
+    }
+    async generateCompletion(prompt) {
+        const response = await fetch(this.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': this.config.apiKey,
+                'anthropic-version': '2023-06-01'
+            },
+            body: JSON.stringify({
+                model: this.config.model || 'claude-3-5-sonnet-20241022',
+                max_tokens: this.config.maxTokens || 4096,
+                temperature: this.config.temperature || 0.7,
+                messages: [
+                    {
+                        role: 'user',
+                        content: prompt
+                    }
+                ]
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Anthropic API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        return {
+            content: data.content[0].text,
+            usage: {
+                promptTokens: data.usage?.input_tokens || 0,
+                completionTokens: data.usage?.output_tokens || 0,
+                totalTokens: (data.usage?.input_tokens || 0) + (data.usage?.output_tokens || 0)
+            },
+            model: data.model
+        };
+    }
+    async extractJSON(prompt) {
+        const enhancedPrompt = `${prompt}
+
+IMPORTANT: Return ONLY valid JSON without any markdown formatting, code blocks, or explanations. The response should be parseable by JSON.parse() directly.`;
+        const response = await this.generateCompletion(enhancedPrompt);
+        try {
+            // Clean up any potential markdown or code block formatting
+            let jsonStr = response.content.trim();
+            // Remove markdown code blocks if present
+            if (jsonStr.startsWith('```json')) {
+                jsonStr = jsonStr.slice(7);
+            }
+            if (jsonStr.startsWith('```')) {
+                jsonStr = jsonStr.slice(3);
+            }
+            if (jsonStr.endsWith('```')) {
+                jsonStr = jsonStr.slice(0, -3);
+            }
+            return JSON.parse(jsonStr.trim());
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from AI response: ${error}`);
+        }
+    }
+}
+/**
+ * OpenAI API Service
+ */
+export class OpenAIService extends BaseAIService {
+    apiUrl = 'https://api.openai.com/v1/chat/completions';
+    constructor(config) {
+        super(config);
+        if (!config.apiKey) {
+            throw new Error('OpenAI API key is required');
+        }
+    }
+    async generateCompletion(prompt) {
+        const response = await fetch(this.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiKey}`
+            },
+            body: JSON.stringify({
+                model: this.config.model || 'gpt-4-turbo-preview',
+                max_tokens: this.config.maxTokens || 4096,
+                temperature: this.config.temperature || 0.7,
+                messages: [
+                    {
+                        role: 'user',
+                        content: prompt
+                    }
+                ]
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        return {
+            content: data.choices[0].message.content,
+            usage: {
+                promptTokens: data.usage?.prompt_tokens || 0,
+                completionTokens: data.usage?.completion_tokens || 0,
+                totalTokens: data.usage?.total_tokens || 0
+            },
+            model: data.model
+        };
+    }
+    async extractJSON(prompt) {
+        const response = await fetch(this.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiKey}`
+            },
+            body: JSON.stringify({
+                model: this.config.model || 'gpt-4-turbo-preview',
+                max_tokens: this.config.maxTokens || 4096,
+                temperature: this.config.temperature || 0.7,
+                response_format: { type: 'json_object' },
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'You are a helpful assistant that always responds with valid JSON.'
+                    },
+                    {
+                        role: 'user',
+                        content: prompt
+                    }
+                ]
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`OpenAI API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        try {
+            return JSON.parse(data.choices[0].message.content);
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from AI response: ${error}`);
+        }
+    }
+}
+/**
+ * Grok AI Service (xAI)
+ */
+export class GrokService extends BaseAIService {
+    apiUrl = 'https://api.x.ai/v1/chat/completions';
+    constructor(config) {
+        super(config);
+        if (!config.apiKey) {
+            throw new Error('Grok API key is required');
+        }
+    }
+    async generateCompletion(prompt) {
+        const response = await fetch(this.apiUrl, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.apiKey}`
+            },
+            body: JSON.stringify({
+                model: this.config.model || 'grok-beta',
+                max_tokens: this.config.maxTokens || 4096,
+                temperature: this.config.temperature || 0.7,
+                messages: [
+                    {
+                        role: 'system',
+                        content: 'You are Grok, a helpful AI assistant with a sense of humor and deep technical knowledge.'
+                    },
+                    {
+                        role: 'user',
+                        content: prompt
+                    }
+                ]
+            })
+        });
+        if (!response.ok) {
+            const error = await response.text();
+            throw new Error(`Grok API error: ${response.status} - ${error}`);
+        }
+        const data = await response.json();
+        return {
+            content: data.choices[0].message.content,
+            usage: {
+                promptTokens: data.usage?.prompt_tokens || 0,
+                completionTokens: data.usage?.completion_tokens || 0,
+                totalTokens: data.usage?.total_tokens || 0
+            },
+            model: data.model
+        };
+    }
+    async extractJSON(prompt) {
+        const enhancedPrompt = `${prompt}
+
+IMPORTANT: Return ONLY valid JSON without any markdown formatting, code blocks, or explanations. The response should be parseable by JSON.parse() directly.`;
+        const response = await this.generateCompletion(enhancedPrompt);
+        try {
+            // Clean up any potential markdown or code block formatting
+            let jsonStr = response.content.trim();
+            // Remove markdown code blocks if present
+            if (jsonStr.startsWith('```json')) {
+                jsonStr = jsonStr.slice(7);
+            }
+            if (jsonStr.startsWith('```')) {
+                jsonStr = jsonStr.slice(3);
+            }
+            if (jsonStr.endsWith('```')) {
+                jsonStr = jsonStr.slice(0, -3);
+            }
+            return JSON.parse(jsonStr.trim());
+        }
+        catch (error) {
+            throw new Error(`Failed to parse JSON from Grok response: ${error}`);
+        }
+    }
+}
+/**
+ * Mock AI Service for testing
+ */
+export class MockAIService extends BaseAIService {
+    async generateCompletion(prompt) {
+        // Return mock response based on prompt content
+        return {
+            content: 'Mock AI response for: ' + prompt.slice(0, 100),
+            usage: {
+                promptTokens: 100,
+                completionTokens: 50,
+                totalTokens: 150
+            },
+            model: 'mock-model'
+        };
+    }
+    async extractJSON(prompt) {
+        // Return mock insights for testing
+        if (prompt.includes('insight')) {
+            return [
+                {
+                    type: 'gotcha',
+                    title: 'Mock insight from AI service',
+                    problem: 'Test problem description',
+                    solution: 'Test solution description',
+                    impact: 'Saves time in testing',
+                    reusabilityScore: 0.8,
+                    timeSaving: 60,
+                    codeExample: {
+                        language: 'typescript',
+                        before: 'const old = true;',
+                        after: 'const new = false;'
+                    },
+                    prevention: 'Always test your code',
+                    tags: ['test', 'mock', 'development']
+                }
+            ];
+        }
+        return {};
+    }
+}
+/**
+ * Factory function to create AI service based on environment
+ */
+export function createAIService(config) {
+    // Check environment variables for API keys
+    const anthropicKey = process.env.ANTHROPIC_API_KEY;
+    const openaiKey = process.env.OPENAI_API_KEY;
+    const grokKey = process.env.GROK_API_KEY || process.env.XAI_API_KEY;
+    // Determine provider based on available keys or config
+    let provider = 'mock';
+    let apiKey;
+    if (config?.provider) {
+        provider = config.provider;
+        apiKey = config.apiKey;
+    }
+    else if (anthropicKey) {
+        provider = 'anthropic';
+        apiKey = anthropicKey;
+    }
+    else if (openaiKey) {
+        provider = 'openai';
+        apiKey = openaiKey;
+    }
+    else if (grokKey) {
+        provider = 'grok';
+        apiKey = grokKey;
+    }
+    const finalConfig = {
+        provider,
+        apiKey,
+        ...config
+    };
+    switch (provider) {
+        case 'anthropic':
+            return new AnthropicService(finalConfig);
+        case 'openai':
+            return new OpenAIService(finalConfig);
+        case 'grok':
+            return new GrokService(finalConfig);
+        case 'mock':
+        default:
+            return new MockAIService(finalConfig);
+    }
+}
+//# sourceMappingURL=ai-service.js.map

package/dist/services/ai-service.js.map

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

package/dist/services/context-search.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @fileType: service
+ * @status: current
+ * @updated: 2025-09-09
+ * @tags: [search, context, modules, index]
+ * @related: [./module-generator.ts, ../types/session.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+import { InsightType } from '../types/session.js';
+export interface SearchOptions {
+    tags?: string[];
+    type?: InsightType;
+    relevance?: 'critical' | 'high' | 'medium' | 'low';
+    minTimeSaving?: number;
+    createdAfter?: Date;
+    searchText?: string;
+    limit?: number;
+}
+export interface SearchResult {
+    module: IndexedModule;
+    score: number;
+    matches: {
+        tags?: string[];
+        title?: boolean;
+        problem?: boolean;
+        solution?: boolean;
+        branch?: boolean;
+        error?: boolean;
+    };
+}
+export interface IndexedModule {
+    filename: string;
+    type: InsightType;
+    tags: string[];
+    relevance: string;
+    created: string;
+    updated?: string;
+    sessionId?: string;
+    timeSaving?: number;
+    title?: string;
+    summary?: string;
+}
+/**
+ * Service for searching and retrieving context modules
+ */
+export declare class ContextSearch {
+    private index;
+    private modulesDir;
+    private indexPath;
+    constructor(ginkoDir: string);
+    /**
+     * Load the index into memory for fast searching
+     */
+    loadIndex(): Promise<void>;
+    /**
+     * Search for modules matching criteria
+     */
+    search(options: SearchOptions): Promise<SearchResult[]>;
+    /**
+     * Quick search by tags (most common use case)
+     */
+    searchByTags(tags: string[]): Promise<IndexedModule[]>;
+    /**
+     * Search by type
+     */
+    searchByType(type: InsightType): Promise<IndexedModule[]>;
+    /**
+     * Get modules relevant to current work
+     */
+    getRelevantModules(context: {
+        branch?: string;
+        files?: string[];
+        errors?: string[];
+    }): Promise<IndexedModule[]>;
+    /**
+     * Full-text search across module content
+     */
+    searchFullText(query: string): Promise<SearchResult[]>;
+    /**
+     * Calculate match score for a module
+     */
+    private calculateMatchScore;
+    /**
+     * Calculate text match score
+     */
+    private calculateTextMatchScore;
+    /**
+     * Get specific matches for a module
+     */
+    private getMatches;
+    /**
+     * Enrich index with content from module files
+     */
+    private enrichIndexWithModuleContent;
+}
+//# sourceMappingURL=context-search.d.ts.map

package/dist/services/context-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-search.d.ts","sourceRoot":"","sources":["../../src/services/context-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACnD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,KAAK,CAAC,EAAE,OAAO,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,MAAM;IAK5B;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAiChC;;OAEG;IACG,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAuB7D;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK5D;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAK/D;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE;QAChC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA6B5B;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkC5D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA0E3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA6B/B;;OAEG;IACH,OAAO,CAAC,UAAU;IAalB;;OAEG;YACW,4BAA4B;CA6B3C"}