@ginkoai/cli 1.0.0

package/dist/adapters/detector.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, ai-detection, adapters]
+ * @priority: high
+ * @complexity: medium
+ */
+export type AIModel = 'claude' | 'gpt4' | 'grok' | 'gemini' | 'llama' | 'universal';
+export interface AIEnvironment {
+    model: AIModel;
+    confidence: number;
+    reason: string;
+}
+/**
+ * Detect which AI model is being used based on environment
+ */
+export declare function detectAIModel(): AIEnvironment;
+/**
+ * Get optimal settings for detected AI model
+ */
+export declare function getModelDefaults(model: AIModel): {
+    format: string;
+    colors: boolean;
+    emojis: boolean;
+    verbosity: string;
+    contextWindow: number;
+};
+//# sourceMappingURL=detector.d.ts.map

package/dist/adapters/detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detector.d.ts","sourceRoot":"","sources":["../../src/adapters/detector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;AAEpF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAuE7C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO;;;;;;EAwD9C"}

package/dist/adapters/detector.js

@@ -0,0 +1,132 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, ai-detection, adapters]
+ * @priority: high
+ * @complexity: medium
+ */
+/**
+ * Detect which AI model is being used based on environment
+ */
+export function detectAIModel() {
+    // Check for explicit environment variable
+    if (process.env.GINKO_AI_MODEL) {
+        return {
+            model: process.env.GINKO_AI_MODEL,
+            confidence: 1.0,
+            reason: 'Explicitly set via GINKO_AI_MODEL'
+        };
+    }
+    // Check for MCP (Claude)
+    if (process.env.MCP_SERVER_URL || process.env.CLAUDE_CODE) {
+        return {
+            model: 'claude',
+            confidence: 0.9,
+            reason: 'MCP environment detected'
+        };
+    }
+    // Check for OpenAI
+    if (process.env.OPENAI_API_KEY || process.env.OPENAI_API_BASE) {
+        return {
+            model: 'gpt4',
+            confidence: 0.9,
+            reason: 'OpenAI environment detected'
+        };
+    }
+    // Check for Grok (xAI)
+    if (process.env.GROK_API_KEY || process.env.XAI_API_KEY) {
+        return {
+            model: 'grok',
+            confidence: 0.9,
+            reason: 'Grok (xAI) environment detected'
+        };
+    }
+    // Check for Google AI
+    if (process.env.GOOGLE_AI_KEY || process.env.GEMINI_API_KEY) {
+        return {
+            model: 'gemini',
+            confidence: 0.9,
+            reason: 'Google AI environment detected'
+        };
+    }
+    // Check for local LLM indicators
+    if (process.env.OLLAMA_HOST || process.env.LLAMA_SERVER) {
+        return {
+            model: 'llama',
+            confidence: 0.8,
+            reason: 'Local LLM server detected'
+        };
+    }
+    // Check parent process name
+    const parentProcess = process.env.TERM_PROGRAM || process.env.SHELL || '';
+    if (parentProcess.toLowerCase().includes('cursor')) {
+        return {
+            model: 'gpt4',
+            confidence: 0.7,
+            reason: 'Cursor IDE detected'
+        };
+    }
+    // Default to universal
+    return {
+        model: 'universal',
+        confidence: 0.5,
+        reason: 'No specific AI environment detected'
+    };
+}
+/**
+ * Get optimal settings for detected AI model
+ */
+export function getModelDefaults(model) {
+    switch (model) {
+        case 'claude':
+            return {
+                format: 'markdown',
+                colors: true,
+                emojis: true,
+                verbosity: 'normal',
+                contextWindow: 200000
+            };
+        case 'gpt4':
+            return {
+                format: 'json',
+                colors: false,
+                emojis: false,
+                verbosity: 'structured',
+                contextWindow: 128000
+            };
+        case 'grok':
+            return {
+                format: 'markdown',
+                colors: true,
+                emojis: true,
+                verbosity: 'witty',
+                contextWindow: 128000
+            };
+        case 'gemini':
+            return {
+                format: 'xml',
+                colors: false,
+                emojis: false,
+                verbosity: 'hierarchical',
+                contextWindow: 1000000
+            };
+        case 'llama':
+            return {
+                format: 'minimal',
+                colors: false,
+                emojis: false,
+                verbosity: 'compressed',
+                contextWindow: 32000
+            };
+        default:
+            return {
+                format: 'text',
+                colors: true,
+                emojis: true,
+                verbosity: 'normal',
+                contextWindow: 100000
+            };
+    }
+}
+//# sourceMappingURL=detector.js.map

package/dist/adapters/detector.js.map

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

package/dist/adapters/generic-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [adapter, generic, fallback, ai]
+ * @related: [ai-adapter.ts, ai-instructions-template.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: []
+ */
+import { BaseAiAdapter } from './ai-adapter.js';
+export declare class GenericAdapter extends BaseAiAdapter {
+    name: string;
+    fileExtension: string;
+    getModelSpecificSections(): string;
+    getQuickReferenceCommands(): string;
+}
+//# sourceMappingURL=generic-adapter.d.ts.map

package/dist/adapters/generic-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/generic-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,cAAe,SAAQ,aAAa;IAC/C,IAAI,SAAQ;IACZ,aAAa,SAAW;IAExB,wBAAwB,IAAI,MAAM;IAelC,yBAAyB,IAAI,MAAM;CAOpC"}

package/dist/adapters/generic-adapter.js

@@ -0,0 +1,37 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [adapter, generic, fallback, ai]
+ * @related: [ai-adapter.ts, ai-instructions-template.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: []
+ */
+import { BaseAiAdapter } from './ai-adapter.js';
+export class GenericAdapter extends BaseAiAdapter {
+    name = 'AI';
+    fileExtension = 'AI.md';
+    getModelSpecificSections() {
+        return `
+## AI Assistant Guidelines
+
+### General Best Practices
+- Be clear and specific with requests
+- Provide context when needed
+- Break complex tasks into smaller steps
+
+### Code Collaboration
+- Share complete code files when possible
+- Specify language and framework versions
+- Include error messages verbatim`;
+    }
+    getQuickReferenceCommands() {
+        return `
+### AI Quick Reference
+- **New features**: Provide clear requirements
+- **Bug fixes**: Include full error messages
+- **Refactoring**: Explain the goal clearly`;
+    }
+}
+//# sourceMappingURL=generic-adapter.js.map

package/dist/adapters/generic-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-adapter.js","sourceRoot":"","sources":["../../src/adapters/generic-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/C,IAAI,GAAG,IAAI,CAAC;IACZ,aAAa,GAAG,OAAO,CAAC;IAExB,wBAAwB;QACtB,OAAO;;;;;;;;;;;kCAWuB,CAAC;IACjC,CAAC;IAED,yBAAyB;QACvB,OAAO;;;;4CAIiC,CAAC;IAC3C,CAAC;CACF"}

package/dist/adapters/gpt4.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, adapter, gpt4, json]
+ * @priority: high
+ * @complexity: low
+ */
+import { AIAdapter, SessionInfo, HandoffInfo } from './base.js';
+export declare class GPT4Adapter extends AIAdapter {
+    /**
+     * GPT-4 prefers structured JSON for function calling
+     */
+    formatSessionStart(info: SessionInfo): string;
+    formatHandoffCreated(info: HandoffInfo): string;
+    formatStatus(status: any): string;
+    formatError(error: Error): string;
+    formatSuccess(message: string): string;
+}
+//# sourceMappingURL=gpt4.d.ts.map

package/dist/adapters/gpt4.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpt4.d.ts","sourceRoot":"","sources":["../../src/adapters/gpt4.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEhE,qBAAa,WAAY,SAAQ,SAAS;IACxC;;OAEG;IACH,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAqC7C,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IA2B/C,YAAY,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM;IAyBjC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM;IAYjC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;CAUvC"}

package/dist/adapters/gpt4.js

@@ -0,0 +1,114 @@
+/**
+ * @fileType: adapter
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, adapter, gpt4, json]
+ * @priority: high
+ * @complexity: low
+ */
+import { AIAdapter } from './base.js';
+export class GPT4Adapter extends AIAdapter {
+    /**
+     * GPT-4 prefers structured JSON for function calling
+     */
+    formatSessionStart(info) {
+        const response = {
+            status: 'session_started',
+            session: {
+                id: info.sessionId,
+                mode: info.mode,
+                branch: info.branch,
+                resumed: !!info.lastUpdated,
+                last_updated: info.lastUpdated?.toISOString() || null,
+                summary: info.summary || null
+            },
+            actions: {
+                save_progress: 'ginko handoff [message]',
+                check_status: 'ginko status',
+                manage_context: 'ginko context'
+            },
+            privacy: {
+                data_location: 'local',
+                analytics: false,
+                network_required: false
+            }
+        };
+        if (this.options.format === 'json') {
+            return JSON.stringify(response, null, 2);
+        }
+        // Fallback to structured text
+        return [
+            `Session: ${info.sessionId}`,
+            `Mode: ${info.mode}`,
+            `Branch: ${info.branch}`,
+            info.summary ? `Task: ${info.summary}` : '',
+            'Privacy: local-only'
+        ].filter(Boolean).join('\n');
+    }
+    formatHandoffCreated(info) {
+        const response = {
+            status: 'handoff_created',
+            handoff: {
+                mode: info.mode,
+                files_modified: info.filesModified,
+                next_steps: info.nextSteps,
+                location: '.ginko/sessions/current.md'
+            },
+            privacy: {
+                stored_locally: true,
+                sent_to_server: false
+            }
+        };
+        if (this.options.format === 'json') {
+            return JSON.stringify(response, null, 2);
+        }
+        return [
+            'Handoff created',
+            `Mode: ${info.mode}`,
+            `Files: ${info.filesModified}`,
+            'Location: .ginko/sessions/'
+        ].join('\n');
+    }
+    formatStatus(status) {
+        const response = {
+            project: status.project,
+            session: status.session,
+            git: status.git,
+            privacy: status.privacy,
+            commands: {
+                start: 'ginko start',
+                handoff: 'ginko handoff',
+                status: 'ginko status'
+            }
+        };
+        if (this.options.format === 'json') {
+            return JSON.stringify(response, null, 2);
+        }
+        return [
+            `Project: ${status.project.name}`,
+            `Session: ${status.session.active ? 'active' : 'none'}`,
+            `Git: ${status.git.branch} (${status.git.modified} modified)`,
+            `Privacy: ${status.privacy.analytics ? 'analytics on' : 'all local'}`
+        ].join('\n');
+    }
+    formatError(error) {
+        if (this.options.format === 'json') {
+            return JSON.stringify({
+                error: true,
+                message: error.message,
+                type: error.name
+            }, null, 2);
+        }
+        return `ERROR: ${error.message}`;
+    }
+    formatSuccess(message) {
+        if (this.options.format === 'json') {
+            return JSON.stringify({
+                success: true,
+                message: message
+            }, null, 2);
+        }
+        return `SUCCESS: ${message}`;
+    }
+}
+//# sourceMappingURL=gpt4.js.map

package/dist/adapters/gpt4.js.map

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

package/dist/adapters/grok-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-10
+ * @tags: [adapter, grok, xai, ai]
+ * @related: [ai-adapter.ts, ai-instructions-template.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { BaseAiAdapter } from './ai-adapter.js';
+export declare class GrokAdapter extends BaseAiAdapter {
+    name: string;
+    fileExtension: string;
+    getModelSpecificSections(): string;
+    getQuickReferenceCommands(): string;
+}
+//# sourceMappingURL=grok-adapter.d.ts.map

package/dist/adapters/grok-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/grok-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,WAAY,SAAQ,aAAa;IAC5C,IAAI,SAAU;IACd,aAAa,SAAa;IAE1B,wBAAwB,IAAI,MAAM;IAuClC,yBAAyB,IAAI,MAAM;CAwCpC"}

package/dist/adapters/grok-adapter.js

@@ -0,0 +1,94 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-09-10
+ * @tags: [adapter, grok, xai, ai]
+ * @related: [ai-adapter.ts, ai-instructions-template.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { BaseAiAdapter } from './ai-adapter.js';
+export class GrokAdapter extends BaseAiAdapter {
+    name = 'Grok';
+    fileExtension = 'GROK.md';
+    getModelSpecificSections() {
+        return `
+## How to Use This Guide with Grok
+
+### Starting a Session
+1. **Run in terminal**: \`ginko start\`
+2. **Set API key**: \`export GROK_API_KEY=your-key\` or \`export XAI_API_KEY=your-key\`
+3. **Run handoff**: \`ginko handoff\` to extract insights with Grok
+4. **Begin with**: "Let's continue working on [task] with Grok's assistance"
+
+### During Development
+- **Save progress**: Run \`ginko handoff\` in terminal periodically
+- **Grok analyzes**: Session changes, patterns, and insights
+- **Context modules**: Generated automatically in \`.ginko/context/modules/\`
+
+### Grok-Specific Features
+
+#### Humor & Personality
+- Grok has a distinctive personality with humor
+- Can provide entertaining yet accurate technical explanations
+- Balances professionalism with wit
+
+#### Real-Time Knowledge
+- Access to current information through X platform
+- Up-to-date with latest tech trends and discussions
+- Can reference recent developments in tech
+
+#### Technical Depth
+- Strong understanding of complex systems
+- Excellent at explaining intricate concepts simply
+- Good at identifying non-obvious connections
+
+### Best Practices with Grok
+- Embrace Grok's humor while staying focused on tasks
+- Ask for explanations "in Grok style" for memorable learning
+- Use for both serious analysis and creative problem-solving
+- Leverage real-time knowledge for current tech questions`;
+    }
+    getQuickReferenceCommands() {
+        return `
+### Grok Quick Reference
+- **API setup**: \`export GROK_API_KEY=your-key\`
+- **Humor mode**: Ask Grok to "explain with humor"
+- **Deep dive**: Request "technical deep dive" for complex topics
+- **Current events**: Ask about "latest developments in [topic]"
+- **Creative solutions**: "Give me an unconventional approach"
+
+## 🧠 Context Reflexes for Grok
+
+### Grok-Enhanced Reflexes
+
+1. **"Actually, here's a better way" Reflex** 🚀
+   - Grok suggests unconventional but effective approaches
+   - Triggers: Seeing standard patterns, complex problems
+   - Example: "The typical approach would be X, but considering Y, let's try..."
+
+2. **"This reminds me of..." Reflex** 🔗
+   - Grok connects to broader tech context and trends
+   - Triggers: Implementation decisions, architecture choices
+   - Example: "This is similar to how Discord solved scaling with..."
+
+3. **"Let me be real with you" Reflex** 💭
+   - Grok provides honest assessment when something's off
+   - Triggers: Over-engineering, wrong approach, confusion
+   - Example: "Honestly, this is getting complex. The simple solution is..."
+
+4. **"Fun fact" Learning Reflex** 💡
+   - Grok makes insights memorable with context
+   - Triggers: Discovering patterns, solving problems
+   - Example: "Fun fact: This bug happens because JavaScript's sort() treats numbers as strings by default."
+
+### Grok Work Modes
+- **Exploration mode**: Reflexes encourage creative solutions
+- **Reality check mode**: Reflexes provide honest feedback
+- **Learning mode**: Reflexes include memorable context
+
+Grok's reflexes blend technical expertise with personality for memorable collaboration.`;
+    }
+}
+//# sourceMappingURL=grok-adapter.js.map

package/dist/adapters/grok-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grok-adapter.js","sourceRoot":"","sources":["../../src/adapters/grok-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,OAAO,WAAY,SAAQ,aAAa;IAC5C,IAAI,GAAG,MAAM,CAAC;IACd,aAAa,GAAG,SAAS,CAAC;IAE1B,wBAAwB;QACtB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0DAmC+C,CAAC;IACzD,CAAC;IAED,yBAAyB;QACvB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wFAqC6E,CAAC;IACvF,CAAC;CACF"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, adapters, factory]
+ * @priority: high
+ * @complexity: low
+ */
+import { AIAdapter } from './base.js';
+/**
+ * Get the appropriate adapter for the current environment
+ */
+export declare function getAdapter(forceDetect?: boolean): Promise<AIAdapter>;
+export { AIAdapter } from './base.js';
+export { detectAIModel, getModelDefaults } from './detector.js';
+export type { AIModel, AIEnvironment } from './detector.js';
+export type { OutputOptions, SessionInfo, HandoffInfo } from './base.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,EAAE,SAAS,EAAiB,MAAM,WAAW,CAAC;AAMrD;;GAEG;AACH,wBAAsB,UAAU,CAAC,WAAW,GAAE,OAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAwDjF;AAGD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAChE,YAAY,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5D,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,71 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-08-27
+ * @tags: [cli, adapters, factory]
+ * @priority: high
+ * @complexity: low
+ */
+import { ClaudeAdapter } from './claude.js';
+import { GPT4Adapter } from './gpt4.js';
+import { UniversalAdapter } from './universal.js';
+import { detectAIModel, getModelDefaults } from './detector.js';
+import fs from 'fs-extra';
+import path from 'path';
+let cachedAdapter = null;
+/**
+ * Get the appropriate adapter for the current environment
+ */
+export async function getAdapter(forceDetect = false) {
+    if (cachedAdapter && !forceDetect) {
+        return cachedAdapter;
+    }
+    // Load config if exists
+    let configuredOptions = {};
+    try {
+        const ginkoDir = path.join(process.cwd(), '.ginko');
+        if (await fs.pathExists(ginkoDir)) {
+            const config = await fs.readJSON(path.join(ginkoDir, 'config.json'));
+            if (config.ai?.output) {
+                configuredOptions = config.ai.output;
+            }
+        }
+    }
+    catch (e) {
+        // Config not found, use defaults
+    }
+    // Detect AI model
+    const detected = detectAIModel();
+    const defaults = getModelDefaults(detected.model);
+    // Merge options (config overrides defaults)
+    const options = {
+        ...defaults,
+        ...configuredOptions
+    };
+    // Check for format override from command line
+    if (process.env.GINKO_OUTPUT_FORMAT) {
+        options.format = process.env.GINKO_OUTPUT_FORMAT;
+    }
+    // Create appropriate adapter
+    switch (detected.model) {
+        case 'claude':
+            cachedAdapter = new ClaudeAdapter(options);
+            break;
+        case 'gpt4':
+            cachedAdapter = new GPT4Adapter(options);
+            break;
+        default:
+            cachedAdapter = new UniversalAdapter(options);
+    }
+    // Log detection if verbose
+    if (process.env.GINKO_DEBUG) {
+        console.log(`[Ginko] AI detected: ${detected.model} (confidence: ${detected.confidence})`);
+        console.log(`[Ginko] Reason: ${detected.reason}`);
+        console.log(`[Ginko] Output format: ${options.format}`);
+    }
+    return cachedAdapter;
+}
+// Export types and utilities
+export { AIAdapter } from './base.js';
+export { detectAIModel, getModelDefaults } from './detector.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,IAAI,aAAa,GAAqB,IAAI,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,cAAuB,KAAK;IAC3D,IAAI,aAAa,IAAI,CAAC,WAAW,EAAE,CAAC;QAClC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,wBAAwB;IACxB,IAAI,iBAAiB,GAA2B,EAAE,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;QACpD,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;YACrE,IAAI,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC;gBACtB,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC;YACvC,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,iCAAiC;IACnC,CAAC;IAED,kBAAkB;IAClB,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,4CAA4C;IAC5C,MAAM,OAAO,GAAkB;QAC7B,GAAG,QAAQ;QACX,GAAG,iBAAiB;KACJ,CAAC;IAEnB,8CAA8C;IAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,CAAC;QACpC,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAA0B,CAAC;IAC1D,CAAC;IAED,6BAA6B;IAC7B,QAAQ,QAAQ,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,QAAQ;YACX,aAAa,GAAG,IAAI,aAAa,CAAC,OAAO,CAAC,CAAC;YAC3C,MAAM;QAER,KAAK,MAAM;YACT,aAAa,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM;QAER;YACE,aAAa,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,2BAA2B;IAC3B,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,wBAAwB,QAAQ,CAAC,KAAK,iBAAiB,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAC;QAC3F,OAAO,CAAC,GAAG,CAAC,mBAAmB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,0BAA0B,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,6BAA6B;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}

package/dist/adapters/openai-adapter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileType: model
+ * @status: current
+ * @updated: 2025-08-28
+ * @tags: [adapter, openai, gpt, ai]
+ * @related: [ai-adapter.ts, ai-instructions-template.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: []
+ */
+import { BaseAiAdapter } from './ai-adapter.js';
+export declare class OpenAIAdapter extends BaseAiAdapter {
+    name: string;
+    fileExtension: string;
+    getModelSpecificSections(): string;
+    getQuickReferenceCommands(): string;
+}
+//# sourceMappingURL=openai-adapter.d.ts.map

package/dist/adapters/openai-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-adapter.d.ts","sourceRoot":"","sources":["../../src/adapters/openai-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,aAAc,SAAQ,aAAa;IAC9C,IAAI,SAAS;IACb,aAAa,SAAY;IAEzB,wBAAwB,IAAI,MAAM;IAyElC,yBAAyB,IAAI,MAAM;CASpC"}