@korl3one/ccode 2.3.0 → 3.1.0

package/README.md

@@ -30,37 +30,39 @@ npm install -g @korl3one/ccode
 
 Every time you switch sessions, models, or tools when working with AI, **you lose your project context**. You end up re-explaining the architecture, previous decisions, and current state over and over again.
 
-## The solution
+And if you use multiple AI tools — Claude Code, Cursor, Gemini CLI, Copilot — you have to configure context files for each one manually.
 
-CCODE stores your project context **inside the repository**. One command generates professional documentation, architecture, rules, and a verifiable task checklist — all adapted to your project's actual complexity.
+## The solution
 
-Any developer or AI can read `.ccode/` and understand the project instantly.
+CCODE generates and maintains your project context **inside the repository**. One command produces professional documentation, architecture, rules, and a verifiable task checklist — all adapted to your project's actual complexity.
 
----
+Then it **syncs that context to every major AI tool** automatically.
 
-## Demo
+Any developer or AI can read your project and understand it instantly.
 
-### `ccode init` — Generate full project context
-
-<div align="center">
-<img src="assets/demo-init.svg" alt="ccode init demo" width="700"/>
-</div>
+---
 
-<br/>
+## Universal Context Sync
 
-### Persistent session — CCODE watches while you code
+This is what makes CCODE different. One command generates context files for **every major AI tool**:
 
-<div align="center">
-<img src="assets/demo-session.svg" alt="ccode session demo" width="700"/>
-</div>
+```bash
+ccode sync
+```
 
-<br/>
+```
+project/
+├── AGENTS.md                        ← Open Standard (60K+ repos)
+├── CLAUDE.md                        ← Claude Code
+├── GEMINI.md                        ← Gemini CLI
+├── .cursorrules                     ← Cursor
+├── .github/copilot-instructions.md  ← GitHub Copilot
+└── .ccode/context-export.md         ← Universal (copy/paste to any AI chat)
+```
 
-### `ccode doctor` — Project health check
+Each file is adapted to the tool's expected format. Your project context — architecture, rules, tasks, decisions — synced everywhere, from a single source of truth.
 
-<div align="center">
-<img src="assets/demo-doctor.svg" alt="ccode doctor demo" width="700"/>
-</div>
+No manual setup per tool. No copy-pasting between files. Context stays in sync automatically with `ccode init`, `ccode update`, and `ccode sync`.
 
 ---
 
@@ -71,12 +73,13 @@ Any developer or AI can read `.ccode/` and understand the project instantly.
 | | CCODE | Manual prompts |
 |---|:---:|:---:|
 | Persistent project context | ✅ | ❌ |
+| Universal context sync (5+ AI tools) | ✅ | ❌ |
 | Architecture adapted to complexity | ✅ | ❌ |
 | AI-ready documentation | ✅ | ❌ |
 | Verifiable task checklist | ✅ | ❌ |
 | Auto-detect file changes | ✅ | ❌ |
 | AI-powered task verification | ✅ | ❌ |
-| Works with 6 AI providers | ✅ | ❌ |
+| Zero-config AI provider detection | ✅ | ❌ |
 | Context lives in the repo (Git) | ✅ | ❌ |
 
 </div>
@@ -102,6 +105,8 @@ A step-by-step wizard asks about your project and an AI generates the full conte
 
 A simple login doesn't need microservice diagrams. CCODE is smart about it.
 
+After generation, context is automatically synced to all AI tools.
+
 ### 2. Persistent session
 
 After init, CCODE **stays active** — watching your project in real time:
@@ -129,21 +134,29 @@ CCODE compares **acceptance criteria** against **actual project files**:
 
 It doesn't guess — it verifies.
 
-### 4. Context export
+### 4. Context sync
+
+```bash
+ccode sync
+```
+
+Regenerates context files for every AI tool. Run it after making significant changes, or let `ccode update` handle it when you re-analyze the project.
+
+### 5. Context export
 
 ```bash
 ccode export
 ```
 
-Generates a single `.md` file with your full project context — ready to paste into **any AI chat** (ChatGPT, Claude, Gemini) without connecting an API.
+Three options: sync to all tools, export a universal `.md` for copy/paste into any AI chat, or pick specific tools.
 
-### 5. Project health check
+### 6. Project health check
 
 ```bash
 ccode doctor
 ```
 
-Like a linter, but for your project context. Checks files, AI connection, task status, and tells you what needs attention.
+Like a linter, but for your project context. Checks context files, AI connection, task status, export state, and tells you what needs attention.
 
 ---
 
@@ -153,35 +166,41 @@ Like a linter, but for your project context. Checks files, AI connection, task s
 
 | Provider | Models | Note |
 |----------|--------|------|
-| **Claude** (Anthropic) | Sonnet 4, Haiku 3.5, Opus 4 | Recommended |
-| **OpenAI** (ChatGPT) | GPT-4o, GPT-4o mini, GPT-4.1, o3-mini | Most popular |
-| **Google Gemini** | 2.5 Flash, 2.5 Pro, 2.0 Flash | Free tier available |
-| **DeepSeek** | Chat, Reasoner | Budget-friendly |
-| **Groq** | Llama 3.3 70B, Llama 3.1 8B, Mixtral | Ultra-fast, free tier |
-| **Ollama** | Any local model | Offline, no API key |
+| **Google Gemini** | 2.5 Flash, 2.5 Pro, 2.0 Flash | Free — just a Google account |
+| **Claude** (Anthropic) | Sonnet 4, Haiku 3.5, Opus 4 | Best quality |
 
 </div>
 
+CCODE auto-detects your provider:
+
+1. **Gemini CLI OAuth** — If you have `gemini` CLI installed and authenticated, it works instantly. Zero config.
+2. **Environment variables** — `GOOGLE_API_KEY` or `ANTHROPIC_API_KEY` detected automatically.
+3. **Manual setup** — Guided wizard with browser-based key generation as fallback.
+
 ---
 
 ## Available commands
 
 | Command | What it does |
 |---------|-------------|
-| `ccode init` | Interactive wizard — generates full project context |
-| `ccode update` | Re-analyze project and refresh context with AI |
-| `ccode export` | Export context as a single `.md` for any AI chat |
-| `ccode explain` | Quick project summary for onboarding |
-| `ccode doctor` | Health check — what's good, what's missing |
-| `ccode connect` | Configure AI provider and model |
+| `ccode init` | Interactive wizard — generates full project context + syncs to all AI tools |
+| `ccode sync` | Sync context to all AI tools (AGENTS.md, CLAUDE.md, .cursorrules, ...) |
+| `ccode update` | Re-analyze project with AI and refresh context |
+| `ccode export` | Export context — all tools, universal .md, or pick specific |
+| `ccode verify` | AI-powered task verification against actual project files |
 | `ccode status` | Dashboard with progress bar and stats |
-| `ccode verify` | AI-powered task verification |
+| `ccode doctor` | Health check — context files, AI connection, exports, tasks |
+| `ccode connect` | Configure or reconfigure AI provider |
+| `ccode explain` | Quick project summary for onboarding |
+| `ccode plan` | Generate or regenerate task checklist |
+| `ccode next` | Show and start the next pending task |
+| `ccode complete` | Mark active task as completed |
 
 ---
 
 ## What gets generated
 
-Everything lives in `.ccode/` inside your repository:
+### Source of truth (`.ccode/`)
 
 ```
 .ccode/
@@ -192,8 +211,21 @@ Everything lives in `.ccode/` inside your repository:
 ├── state.json          Active task, workflow stage
 ├── context.json        Project configuration
 ├── memory.md           Decision history
-└── config.json         AI provider config
+├── config.json         AI provider config
+└── context-export.md   Universal export
+```
+
+### Synced context files (project root)
+
 ```
+AGENTS.md                        Open Standard
+CLAUDE.md                        Claude Code
+GEMINI.md                        Gemini CLI
+.cursorrules                     Cursor
+.github/copilot-instructions.md  GitHub Copilot
+```
+
+All derived from `.ccode/`. One source, multiple outputs.
 
 ---
 
@@ -202,8 +234,8 @@ Everything lives in `.ccode/` inside your repository:
 ```
 src/
 ├── cli/           Session, branding, file watcher
-├── core/          Context engine, tasks, prompt builder
-├── ai/            6 provider adapters (Adapter pattern)
+├── core/          Context engine, tasks, prompt builder, exports
+├── ai/            Provider adapters (Adapter pattern)
 └── utils/         File system abstraction
 ```
 
@@ -215,7 +247,11 @@ src/
 
 See [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions.
 
-Adding a new AI provider? Just implement `IAIProvider`, add it to the manager switch, done. Zero changes to the rest of the system.
+Adding a new AI provider? Implement `IAIProvider`, add it to the manager, done.
+
+Adding a new export format? Add a method to `ContextExporter`, register the format, done.
+
+Zero changes to the rest of the system in both cases.
 
 ---
 
@@ -223,16 +259,15 @@ Adding a new AI provider? Just implement `IAIProvider`, add it to the manager sw
 
 | Resource | Link |
 |----------|------|
-| Learning guide (6 modules, QP2C) | [docs/learning/](docs/learning/README.md) |
 | Engineering roles | [AGENTS.md](AGENTS.md) |
 | Technical competencies | [SKILLS.md](SKILLS.md) |
-| YouTube tutorials | [@CreativeCode25](https://www.youtube.com/@CreativeCode25) |
+| YouTube | [@CreativeCode25](https://www.youtube.com/@CreativeCode25) |
 
 ---
 
 <div align="center">
 
-### If CCODE helps you, consider giving it a star ⭐
+### If CCODE helps you, consider giving it a star
 
 It helps the project grow and reach more developers.
 

package/dist/ai/claude.d.ts

@@ -3,7 +3,8 @@ import { IAIProvider, IAIConfig } from './provider.js';
  * Adaptador para Claude (Anthropic).
  */
 export declare class ClaudeAdapter implements IAIProvider {
-    private config;
+    private apiKey;
+    private model;
     constructor(config: IAIConfig);
     getName(): string;
     generate(prompt: string): Promise<string>;

package/dist/ai/claude.js

@@ -3,32 +3,35 @@ import axios from 'axios';
  * Adaptador para Claude (Anthropic).
  */
 export class ClaudeAdapter {
-    config;
+    apiKey;
+    model;
     constructor(config) {
-        this.config = {
-            apiKey: config.apiKey || '',
-            model: config.model || 'claude-sonnet-4-20250514',
-            baseUrl: config.baseUrl || 'https://api.anthropic.com/v1/messages',
-        };
+        this.apiKey = config.apiKey || '';
+        this.model = config.model || 'claude-sonnet-4-20250514';
     }
     getName() {
-        return `Claude (${this.config.model})`;
+        return `Claude (${this.model})`;
     }
     async generate(prompt) {
-        if (!this.config.apiKey) {
+        if (!this.apiKey) {
             throw new Error('API Key de Anthropic no configurada.');
         }
-        const response = await axios.post(this.config.baseUrl, {
-            model: this.config.model,
+        const response = await axios.post('https://api.anthropic.com/v1/messages', {
+            model: this.model,
             max_tokens: 8096,
             messages: [{ role: 'user', content: prompt }],
         }, {
             headers: {
-                'x-api-key': this.config.apiKey,
+                'x-api-key': this.apiKey,
                 'anthropic-version': '2023-06-01',
                 'content-type': 'application/json',
             },
+            timeout: 120000,
         });
-        return response.data.content[0].text;
+        const text = response.data?.content?.[0]?.text;
+        if (!text) {
+            throw new Error('Claude respondio pero sin contenido. Intenta de nuevo.');
+        }
+        return text;
     }
 }

package/dist/ai/gemini.d.ts

@@ -1,10 +1,22 @@
 import { IAIProvider, IAIConfig } from './provider.js';
 /**
  * Adaptador para Google Gemini.
+ * Soporta API Key y OAuth token (de Gemini CLI).
  */
 export declare class GeminiAdapter implements IAIProvider {
-    private config;
+    private apiKey;
+    private oauthToken;
+    private model;
     constructor(config: IAIConfig);
     getName(): string;
+    /**
+     * Try to read OAuth token from Gemini CLI installation.
+     */
+    static readOAuthToken(): string | null;
+    /**
+     * Check if Gemini CLI is installed and authenticated.
+     */
+    static isAvailable(): boolean;
+    setOAuthToken(token: string): void;
     generate(prompt: string): Promise<string>;
 }

package/dist/ai/gemini.js

@@ -1,31 +1,78 @@
 import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
 /**
  * Adaptador para Google Gemini.
+ * Soporta API Key y OAuth token (de Gemini CLI).
  */
 export class GeminiAdapter {
-    config;
+    apiKey;
+    oauthToken;
+    model;
     constructor(config) {
-        this.config = {
-            apiKey: config.apiKey || '',
-            model: config.model || 'gemini-2.5-flash',
-            baseUrl: config.baseUrl || 'https://generativelanguage.googleapis.com/v1beta/models',
-        };
+        this.apiKey = config.apiKey || '';
+        this.oauthToken = '';
+        this.model = config.model || 'gemini-2.5-flash';
     }
     getName() {
-        return `Gemini (${this.config.model})`;
+        return `Gemini (${this.model})`;
+    }
+    /**
+     * Try to read OAuth token from Gemini CLI installation.
+     */
+    static readOAuthToken() {
+        try {
+            const credsPath = path.join(os.homedir(), '.gemini', 'oauth_creds.json');
+            if (!fs.existsSync(credsPath))
+                return null;
+            const creds = JSON.parse(fs.readFileSync(credsPath, 'utf-8'));
+            if (creds.access_token && typeof creds.access_token === 'string') {
+                return creds.access_token;
+            }
+        }
+        catch {
+            // ignore
+        }
+        return null;
+    }
+    /**
+     * Check if Gemini CLI is installed and authenticated.
+     */
+    static isAvailable() {
+        return GeminiAdapter.readOAuthToken() !== null;
+    }
+    setOAuthToken(token) {
+        this.oauthToken = token;
     }
     async generate(prompt) {
-        if (!this.config.apiKey) {
-            throw new Error('API Key de Google AI no configurada.');
+        const baseUrl = `https://generativelanguage.googleapis.com/v1beta/models/${this.model}:generateContent`;
+        let url;
+        let headers;
+        if (this.oauthToken) {
+            // Use OAuth token from Gemini CLI
+            url = baseUrl;
+            headers = {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.oauthToken}`,
+            };
+        }
+        else if (this.apiKey) {
+            // Use API key
+            url = `${baseUrl}?key=${this.apiKey}`;
+            headers = { 'Content-Type': 'application/json' };
+        }
+        else {
+            throw new Error('No hay credenciales de Gemini configuradas.');
         }
-        const url = `${this.config.baseUrl}/${this.config.model}:generateContent?key=${this.config.apiKey}`;
         const response = await axios.post(url, {
             contents: [{ parts: [{ text: prompt }] }],
             generationConfig: { maxOutputTokens: 8096 },
-        }, {
-            headers: { 'Content-Type': 'application/json' },
-            timeout: 120000,
-        });
-        return response.data.candidates[0].content.parts[0].text;
+        }, { headers, timeout: 120000 });
+        const text = response.data?.candidates?.[0]?.content?.parts?.[0]?.text;
+        if (!text) {
+            throw new Error('Gemini respondio pero sin contenido. Intenta de nuevo.');
+        }
+        return text;
     }
 }

package/dist/ai/manager.d.ts

@@ -1,18 +1,37 @@
 import { IAIProvider } from './provider.js';
-export type ProviderName = 'claude' | 'openai' | 'gemini' | 'deepseek' | 'groq' | 'ollama';
+export type ProviderName = 'claude' | 'gemini';
 export interface ICCODEConfig {
     provider: ProviderName;
     apiKey?: string;
     model?: string;
-    baseUrl?: string;
+    authType?: 'api-key' | 'oauth';
 }
-/**
- * Gestiona la configuración y conexión con proveedores de IA.
- */
+export declare const PROVIDER_INFO: Record<ProviderName, {
+    name: string;
+    keyUrl: string;
+    envVars: string[];
+    models: Array<{
+        name: string;
+        value: string;
+    }>;
+}>;
 export declare class AIManager {
     private static readonly CONFIG_FILE;
     static loadConfig(): Promise<ICCODEConfig | null>;
     static saveConfig(config: ICCODEConfig): Promise<void>;
     static getProvider(config: ICCODEConfig): IAIProvider;
-    static testConnection(config: ICCODEConfig): Promise<boolean>;
+    static testConnection(config: ICCODEConfig): Promise<{
+        ok: boolean;
+        error?: string;
+    }>;
+    /**
+     * Auto-detect the best available provider.
+     * Priority: 1) Gemini CLI OAuth, 2) env vars, 3) null
+     */
+    static autoDetect(): {
+        provider: ProviderName;
+        authType: 'oauth' | 'api-key';
+        apiKey?: string;
+        source: string;
+    } | null;
 }

package/dist/ai/manager.js

@@ -1,14 +1,30 @@
 import * as path from 'path';
+import axios from 'axios';
 import { ClaudeAdapter } from './claude.js';
-import { OpenAIAdapter } from './openai.js';
 import { GeminiAdapter } from './gemini.js';
-import { DeepSeekAdapter } from './deepseek.js';
-import { GroqAdapter } from './groq.js';
-import { OllamaAdapter } from './ollama.js';
 import { FileUtils } from '../utils/files.js';
-/**
- * Gestiona la configuración y conexión con proveedores de IA.
- */
+export const PROVIDER_INFO = {
+    gemini: {
+        name: 'Google Gemini',
+        keyUrl: 'https://aistudio.google.com/apikey',
+        envVars: ['GOOGLE_API_KEY', 'GEMINI_API_KEY'],
+        models: [
+            { name: 'Gemini 2.5 Flash (recomendado, gratis)', value: 'gemini-2.5-flash' },
+            { name: 'Gemini 2.5 Pro (maxima calidad)', value: 'gemini-2.5-pro' },
+            { name: 'Gemini 2.0 Flash (rapido)', value: 'gemini-2.0-flash' },
+        ],
+    },
+    claude: {
+        name: 'Claude (Anthropic)',
+        keyUrl: 'https://console.anthropic.com/settings/keys',
+        envVars: ['ANTHROPIC_API_KEY'],
+        models: [
+            { name: 'Claude Sonnet 4 (recomendado)', value: 'claude-sonnet-4-20250514' },
+            { name: 'Claude Haiku 3.5 (rapido)', value: 'claude-haiku-4-5-20251001' },
+            { name: 'Claude Opus 4 (maxima calidad)', value: 'claude-opus-4-20250514' },
+        ],
+    },
+};
 export class AIManager {
     static CONFIG_FILE = '.ccode/config.json';
     static async loadConfig() {
@@ -24,18 +40,18 @@ export class AIManager {
     }
     static getProvider(config) {
         switch (config.provider) {
+            case 'gemini': {
+                const adapter = new GeminiAdapter({ apiKey: config.apiKey, model: config.model });
+                // If using OAuth from Gemini CLI
+                if (config.authType === 'oauth') {
+                    const token = GeminiAdapter.readOAuthToken();
+                    if (token)
+                        adapter.setOAuthToken(token);
+                }
+                return adapter;
+            }
             case 'claude':
                 return new ClaudeAdapter({ apiKey: config.apiKey, model: config.model });
-            case 'openai':
-                return new OpenAIAdapter({ apiKey: config.apiKey, model: config.model });
-            case 'gemini':
-                return new GeminiAdapter({ apiKey: config.apiKey, model: config.model });
-            case 'deepseek':
-                return new DeepSeekAdapter({ apiKey: config.apiKey, model: config.model });
-            case 'groq':
-                return new GroqAdapter({ apiKey: config.apiKey, model: config.model });
-            case 'ollama':
-                return new OllamaAdapter({ model: config.model, baseUrl: config.baseUrl });
             default:
                 throw new Error(`Proveedor desconocido: ${config.provider}`);
         }
@@ -43,11 +59,57 @@ export class AIManager {
     static async testConnection(config) {
         try {
             const provider = this.getProvider(config);
-            await provider.generate('Responde únicamente con la palabra "ok".');
-            return true;
+            const result = await provider.generate('Responde unicamente con la palabra "ok".');
+            if (!result || result.trim().length === 0) {
+                return { ok: false, error: 'La IA respondio pero el contenido esta vacio.' };
+            }
+            return { ok: true };
         }
-        catch {
-            return false;
+        catch (err) {
+            if (axios.isAxiosError(err)) {
+                const status = err.response?.status;
+                const data = err.response?.data;
+                if (status === 401 || status === 403) {
+                    return { ok: false, error: `Credenciales invalidas (HTTP ${status}). Verifica tu autenticacion.` };
+                }
+                if (status === 404) {
+                    return { ok: false, error: 'Modelo no encontrado. Verifica el nombre del modelo.' };
+                }
+                if (status === 429) {
+                    return { ok: false, error: 'Rate limit. Espera unos segundos e intenta de nuevo.' };
+                }
+                if (err.code === 'ECONNREFUSED' || err.code === 'ENOTFOUND') {
+                    return { ok: false, error: 'Sin conexion a internet.' };
+                }
+                if (err.code === 'ETIMEDOUT' || err.message?.includes('timeout')) {
+                    return { ok: false, error: 'Timeout: la IA no respondio a tiempo.' };
+                }
+                const msg = typeof data === 'object' && data?.error?.message
+                    ? data.error.message
+                    : `Error HTTP ${status || 'desconocido'}`;
+                return { ok: false, error: msg };
+            }
+            return { ok: false, error: err instanceof Error ? err.message : String(err) };
         }
     }
+    /**
+     * Auto-detect the best available provider.
+     * Priority: 1) Gemini CLI OAuth, 2) env vars, 3) null
+     */
+    static autoDetect() {
+        // 1. Gemini CLI installed and authenticated
+        if (GeminiAdapter.isAvailable()) {
+            return { provider: 'gemini', authType: 'oauth', source: 'Gemini CLI' };
+        }
+        // 2. Environment variables
+        for (const [provider, info] of Object.entries(PROVIDER_INFO)) {
+            for (const envVar of info.envVars) {
+                const value = process.env[envVar];
+                if (value && value.length > 10) {
+                    return { provider: provider, authType: 'api-key', apiKey: value, source: envVar };
+                }
+            }
+        }
+        return null;
+    }
 }

package/dist/cli/brand.js

@@ -27,7 +27,7 @@ export function showLogo() {
     LOGO_LINES.forEach((line, i) => {
         console.log(chalk.hex(GRADIENT[i])(line));
     });
-    console.log(c.dim('  Context-Persistent AI Development  v2.0'));
+    console.log(c.dim('  Context-Persistent AI Development  v3.0'));
     console.log('');
 }
 // ─── Componentes UI ─────────────────────────────────────────────────