@korl3one/ccode 2.3.0 → 3.1.0

package/dist/core/exports.js

@@ -0,0 +1,303 @@
+import * as path from 'path';
+import { FileUtils } from '../utils/files.js';
+import { TaskEngine } from './tasks.js';
+/**
+ * ContextExporter: genera archivos de contexto para cada herramienta de IA.
+ *
+ * Lee la fuente de verdad (.ccode/) y produce exports específicos:
+ * - AGENTS.md      → Estándar abierto (Linux Foundation)
+ * - CLAUDE.md      → Claude Code
+ * - GEMINI.md      → Gemini CLI
+ * - .cursorrules   → Cursor
+ * - copilot-instructions.md → GitHub Copilot
+ *
+ * Cada export se adapta al formato y expectativas de la herramienta destino.
+ */
+export class ContextExporter {
+    ccodePath;
+    projectRoot;
+    // Formatos soportados y sus rutas relativas al root del proyecto
+    static FORMATS = {
+        agents: { file: 'AGENTS.md', label: 'AGENTS.md (Open Standard)' },
+        claude: { file: 'CLAUDE.md', label: 'CLAUDE.md (Claude Code)' },
+        gemini: { file: 'GEMINI.md', label: 'GEMINI.md (Gemini CLI)' },
+        cursor: { file: '.cursorrules', label: '.cursorrules (Cursor)' },
+        copilot: { file: '.github/copilot-instructions.md', label: 'copilot-instructions.md (GitHub Copilot)' },
+    };
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot || process.cwd();
+        this.ccodePath = path.join(this.projectRoot, '.ccode');
+    }
+    /**
+     * Lee todos los archivos de contexto de .ccode/
+     */
+    async readSources() {
+        const project = await FileUtils.readFileSafe(path.join(this.ccodePath, 'project.md'));
+        const architecture = await FileUtils.readFileSafe(path.join(this.ccodePath, 'architecture.md'));
+        const rules = await FileUtils.readFileSafe(path.join(this.ccodePath, 'rules.md'));
+        const memory = await FileUtils.readFileSafe(path.join(this.ccodePath, 'memory.md'));
+        const taskEngine = new TaskEngine();
+        await taskEngine.load();
+        const tasks = taskEngine.getTasks();
+        const stats = taskEngine.getStats();
+        let projectName = 'Proyecto';
+        try {
+            const ctx = await FileUtils.readJson(path.join(this.ccodePath, 'context.json'));
+            if (ctx.name)
+                projectName = ctx.name;
+        }
+        catch { /* ignore */ }
+        return { project, architecture, rules, memory, tasks, stats, projectName };
+    }
+    /**
+     * Formatea las tareas como lista legible.
+     */
+    formatTasks(tasks, style) {
+        if (tasks.length === 0)
+            return 'No hay tareas definidas.';
+        return tasks.map(t => {
+            if (style === 'checkbox') {
+                const check = t.status === 'completed' ? 'x' : ' ';
+                return `- [${check}] **${t.id}** ${t.title}`;
+            }
+            const icon = t.status === 'completed' ? 'DONE' :
+                t.status === 'in_progress' ? 'IN PROGRESS' :
+                    t.status === 'failed' ? 'FAILED' : 'PENDING';
+            return `- [${icon}] ${t.id}: ${t.title}`;
+        }).join('\n');
+    }
+    /**
+     * Genera AGENTS.md — Estándar abierto compatible con múltiples herramientas.
+     * Sigue la convención de AGENTS.md (Linux Foundation / AAIF).
+     */
+    async generateAgentsMd() {
+        const { project, architecture, rules, tasks, stats, projectName } = await this.readSources();
+        return `# ${projectName}
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Development Guidelines
+
+${rules}
+
+## Current Status
+
+Progress: ${stats.completed}/${stats.total} tasks completed
+
+${this.formatTasks(tasks, 'checkbox')}
+
+## Notes for AI Agents
+
+- This project uses CCODE for context management
+- All context files live in \`.ccode/\` — that is the source of truth
+- Do not modify \`.ccode/\` files directly; use \`ccode update\` instead
+- Follow the development guidelines above when making changes
+- Check task status before starting new work
+`;
+    }
+    /**
+     * Genera CLAUDE.md — Optimizado para Claude Code.
+     * Claude Code lee este archivo automáticamente del root del proyecto.
+     */
+    async generateClaudeMd() {
+        const { project, architecture, rules, tasks, stats, memory, projectName } = await this.readSources();
+        const activeTasks = tasks.filter(t => t.status !== 'completed');
+        const activeSection = activeTasks.length > 0
+            ? activeTasks.map(t => {
+                const status = t.status === 'in_progress' ? '(in progress)' : '';
+                return `- ${t.id}: ${t.title} ${status}\n  Criteria: ${t.description}`;
+            }).join('\n')
+            : 'All tasks completed.';
+        return `# ${projectName}
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Rules
+
+${rules}
+
+## Progress (${stats.completed}/${stats.total})
+
+${this.formatTasks(tasks, 'checkbox')}
+
+## Pending Work
+
+${activeSection}
+
+## Decision History
+
+${memory}
+`;
+    }
+    /**
+     * Genera GEMINI.md — Para Gemini CLI.
+     */
+    async generateGeminiMd() {
+        const { project, architecture, rules, tasks, stats, projectName } = await this.readSources();
+        return `# ${projectName}
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Guidelines
+
+${rules}
+
+## Task Progress (${stats.completed}/${stats.total})
+
+${this.formatTasks(tasks, 'checkbox')}
+`;
+    }
+    /**
+     * Genera .cursorrules — Instrucciones para Cursor IDE.
+     * Cursor lee este archivo del root del proyecto automáticamente.
+     */
+    async generateCursorRules() {
+        const { project, architecture, rules, tasks, stats, projectName } = await this.readSources();
+        // Cursor rules tiende a ser más conciso y directivo
+        const pendingTasks = tasks.filter(t => t.status !== 'completed');
+        const pendingSection = pendingTasks.length > 0
+            ? pendingTasks.map(t => `- ${t.title}`).join('\n')
+            : 'All tasks completed.';
+        return `# ${projectName}
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Rules
+
+${rules}
+
+## Current Tasks (${stats.completed}/${stats.total} done)
+
+${pendingSection}
+`;
+    }
+    /**
+     * Genera copilot-instructions.md — Para GitHub Copilot.
+     * Se ubica en .github/copilot-instructions.md
+     */
+    async generateCopilotInstructions() {
+        const { project, architecture, rules, projectName } = await this.readSources();
+        // Copilot instructions es más enfocado en reglas de código
+        return `# ${projectName}
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Coding Guidelines
+
+${rules}
+`;
+    }
+    /**
+     * Genera el export universal (.ccode/context-export.md).
+     */
+    async generateUniversalExport() {
+        const { project, architecture, rules, memory, tasks, stats } = await this.readSources();
+        const taskList = tasks.map(t => {
+            const icon = t.status === 'completed' ? '[DONE]' :
+                t.status === 'in_progress' ? '[IN PROGRESS]' : '[PENDING]';
+            return `${icon} ${t.id} [${t.priority.toUpperCase()}] ${t.title}`;
+        }).join('\n');
+        return `# CCODE — Project Context Export
+
+## Project
+
+${project}
+
+## Architecture
+
+${architecture}
+
+## Development Rules
+
+${rules}
+
+## Task Progress (${stats.completed}/${stats.total} completed)
+
+${taskList}
+
+## Decision History
+
+${memory}
+`;
+    }
+    /**
+     * Genera y escribe un formato específico.
+     */
+    async exportFormat(format) {
+        const info = ContextExporter.FORMATS[format];
+        if (!info)
+            throw new Error(`Formato desconocido: ${format}`);
+        let content;
+        switch (format) {
+            case 'agents':
+                content = await this.generateAgentsMd();
+                break;
+            case 'claude':
+                content = await this.generateClaudeMd();
+                break;
+            case 'gemini':
+                content = await this.generateGeminiMd();
+                break;
+            case 'cursor':
+                content = await this.generateCursorRules();
+                break;
+            case 'copilot':
+                content = await this.generateCopilotInstructions();
+                break;
+            default: throw new Error(`Formato desconocido: ${format}`);
+        }
+        const filePath = path.join(this.projectRoot, info.file);
+        // Asegurar que el directorio padre exista (para .github/)
+        await FileUtils.ensureDir(path.dirname(filePath));
+        await FileUtils.writeFile(filePath, content);
+        return filePath;
+    }
+    /**
+     * Exporta todos los formatos de una vez.
+     * Retorna la lista de archivos generados.
+     */
+    async exportAll() {
+        const results = [];
+        for (const [format, info] of Object.entries(ContextExporter.FORMATS)) {
+            await this.exportFormat(format);
+            results.push({ format, file: info.file, label: info.label });
+        }
+        // También generar el export universal
+        const universalContent = await this.generateUniversalExport();
+        await FileUtils.writeFile(path.join(this.ccodePath, 'context-export.md'), universalContent);
+        results.push({ format: 'universal', file: '.ccode/context-export.md', label: 'Export Universal' });
+        return results;
+    }
+    /**
+     * Verifica qué formatos ya existen en el proyecto.
+     */
+    async detectExisting() {
+        const existing = [];
+        for (const [format, info] of Object.entries(ContextExporter.FORMATS)) {
+            if (await FileUtils.exists(path.join(this.projectRoot, info.file))) {
+                existing.push(format);
+            }
+        }
+        return existing;
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@korl3one/ccode",
-  "version": "2.3.0",
-  "description": "CLI de contexto persistente para desarrollo asistido por IA. Genera documentacion, arquitectura, reglas y tareas verificables.",
+  "version": "3.1.0",
+  "description": "Persistent context CLI for AI-assisted development. Generates documentation, architecture, rules, and tasks — synced to Claude Code, Gemini CLI, Cursor, Copilot, and AGENTS.md.",
   "type": "module",
   "main": "dist/cli/index.js",
   "bin": {
@@ -19,6 +19,7 @@
     "ai",
     "cli",
     "context",
+    "context-engineering",
     "development",
     "assistant",
     "typescript",
@@ -27,9 +28,13 @@
     "architecture",
     "tasks",
     "claude",
-    "ollama",
+    "gemini",
+    "cursor",
+    "copilot",
+    "agents-md",
     "llm",
-    "persistent-context"
+    "persistent-context",
+    "context-sync"
   ],
   "author": "Johannes Moreno <korl3one>",
   "license": "ISC",

package/dist/ai/deepseek.d.ts

@@ -1,11 +0,0 @@
-import { IAIProvider, IAIConfig } from './provider.js';
-/**
- * Adaptador para DeepSeek.
- * Usa formato compatible con OpenAI.
- */
-export declare class DeepSeekAdapter implements IAIProvider {
-    private config;
-    constructor(config: IAIConfig);
-    getName(): string;
-    generate(prompt: string): Promise<string>;
-}

package/dist/ai/deepseek.js

@@ -1,35 +0,0 @@
-import axios from 'axios';
-/**
- * Adaptador para DeepSeek.
- * Usa formato compatible con OpenAI.
- */
-export class DeepSeekAdapter {
-    config;
-    constructor(config) {
-        this.config = {
-            apiKey: config.apiKey || '',
-            model: config.model || 'deepseek-chat',
-            baseUrl: config.baseUrl || 'https://api.deepseek.com/v1/chat/completions',
-        };
-    }
-    getName() {
-        return `DeepSeek (${this.config.model})`;
-    }
-    async generate(prompt) {
-        if (!this.config.apiKey) {
-            throw new Error('API Key de DeepSeek no configurada.');
-        }
-        const response = await axios.post(this.config.baseUrl, {
-            model: this.config.model,
-            max_tokens: 8096,
-            messages: [{ role: 'user', content: prompt }],
-        }, {
-            headers: {
-                'Authorization': `Bearer ${this.config.apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            timeout: 120000,
-        });
-        return response.data.choices[0].message.content;
-    }
-}

package/dist/ai/groq.d.ts

@@ -1,11 +0,0 @@
-import { IAIProvider, IAIConfig } from './provider.js';
-/**
- * Adaptador para Groq (inferencia ultra-rápida).
- * Usa formato compatible con OpenAI.
- */
-export declare class GroqAdapter implements IAIProvider {
-    private config;
-    constructor(config: IAIConfig);
-    getName(): string;
-    generate(prompt: string): Promise<string>;
-}

package/dist/ai/groq.js

@@ -1,35 +0,0 @@
-import axios from 'axios';
-/**
- * Adaptador para Groq (inferencia ultra-rápida).
- * Usa formato compatible con OpenAI.
- */
-export class GroqAdapter {
-    config;
-    constructor(config) {
-        this.config = {
-            apiKey: config.apiKey || '',
-            model: config.model || 'llama-3.3-70b-versatile',
-            baseUrl: config.baseUrl || 'https://api.groq.com/openai/v1/chat/completions',
-        };
-    }
-    getName() {
-        return `Groq (${this.config.model})`;
-    }
-    async generate(prompt) {
-        if (!this.config.apiKey) {
-            throw new Error('API Key de Groq no configurada.');
-        }
-        const response = await axios.post(this.config.baseUrl, {
-            model: this.config.model,
-            max_tokens: 8096,
-            messages: [{ role: 'user', content: prompt }],
-        }, {
-            headers: {
-                'Authorization': `Bearer ${this.config.apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            timeout: 60000,
-        });
-        return response.data.choices[0].message.content;
-    }
-}

package/dist/ai/ollama.d.ts

@@ -1,10 +0,0 @@
-import { IAIProvider, IAIConfig } from './provider.js';
-/**
- * Adaptador para Ollama (local).
- */
-export declare class OllamaAdapter implements IAIProvider {
-    private config;
-    constructor(config: IAIConfig);
-    getName(): string;
-    generate(prompt: string): Promise<string>;
-}

package/dist/ai/ollama.js

@@ -1,27 +0,0 @@
-import axios from 'axios';
-/**
- * Adaptador para Ollama (local).
- */
-export class OllamaAdapter {
-    config;
-    constructor(config) {
-        this.config = {
-            model: config.model || 'llama3',
-            baseUrl: config.baseUrl || 'http://localhost:11434/api/generate',
-        };
-    }
-    getName() {
-        return `Ollama (${this.config.model})`;
-    }
-    async generate(prompt) {
-        const response = await axios.post(this.config.baseUrl, {
-            model: this.config.model,
-            prompt,
-            stream: false,
-        }, {
-            headers: { 'Content-Type': 'application/json' },
-            timeout: 120000,
-        });
-        return response.data.response;
-    }
-}

package/dist/ai/openai.d.ts

@@ -1,10 +0,0 @@
-import { IAIProvider, IAIConfig } from './provider.js';
-/**
- * Adaptador para OpenAI (ChatGPT).
- */
-export declare class OpenAIAdapter implements IAIProvider {
-    private config;
-    constructor(config: IAIConfig);
-    getName(): string;
-    generate(prompt: string): Promise<string>;
-}

package/dist/ai/openai.js

@@ -1,34 +0,0 @@
-import axios from 'axios';
-/**
- * Adaptador para OpenAI (ChatGPT).
- */
-export class OpenAIAdapter {
-    config;
-    constructor(config) {
-        this.config = {
-            apiKey: config.apiKey || '',
-            model: config.model || 'gpt-4o',
-            baseUrl: config.baseUrl || 'https://api.openai.com/v1/chat/completions',
-        };
-    }
-    getName() {
-        return `OpenAI (${this.config.model})`;
-    }
-    async generate(prompt) {
-        if (!this.config.apiKey) {
-            throw new Error('API Key de OpenAI no configurada.');
-        }
-        const response = await axios.post(this.config.baseUrl, {
-            model: this.config.model,
-            max_tokens: 8096,
-            messages: [{ role: 'user', content: prompt }],
-        }, {
-            headers: {
-                'Authorization': `Bearer ${this.config.apiKey}`,
-                'Content-Type': 'application/json',
-            },
-            timeout: 120000,
-        });
-        return response.data.choices[0].message.content;
-    }
-}