bibest-code 2.0.0

package/bibest-code.js

@@ -0,0 +1,437 @@
+#!/usr/bin/env node
+// ============================================================
+// BIBEST CODE v2.0.0 — Agent CLI propulsé par Claude
+// © BIBI ONDOUA — Tous droits réservés
+// ============================================================
+
+import Anthropic from "@anthropic-ai/sdk";
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+import { exec } from "child_process";
+import { promisify } from "util";
+
+const execAsync = promisify(exec);
+const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
+
+// ── Couleurs & styles ──────────────────────────────────────
+const C = {
+  reset: "\x1b[0m",
+  bold: "\x1b[1m",
+  dim: "\x1b[2m",
+  italic: "\x1b[3m",
+  underline: "\x1b[4m",
+  cyan: "\x1b[36m",
+  cyanBright: "\x1b[96m",
+  green: "\x1b[32m",
+  greenBright: "\x1b[92m",
+  yellow: "\x1b[33m",
+  yellowBright: "\x1b[93m",
+  red: "\x1b[31m",
+  redBright: "\x1b[91m",
+  magenta: "\x1b[35m",
+  magentaBright: "\x1b[95m",
+  blue: "\x1b[34m",
+  blueBright: "\x1b[94m",
+  white: "\x1b[37m",
+  whiteBright: "\x1b[97m",
+  gray: "\x1b[90m",
+  bgCyan: "\x1b[46m",
+  bgBlue: "\x1b[44m",
+  bgGreen: "\x1b[42m",
+  bgRed: "\x1b[41m",
+  bgMagenta: "\x1b[45m",
+  bgYellow: "\x1b[43m",
+};
+
+const W = process.stdout.columns || 80;
+const line = (char = "─", color = C.gray) => color + char.repeat(W) + C.reset;
+const pad = (text, width) => text + " ".repeat(Math.max(0, width - stripAnsi(text).length));
+const stripAnsi = (str) => str.replace(/\x1b\[[0-9;]*m/g, "");
+const center = (text, color = "") => {
+  const len = stripAnsi(text).length;
+  const spaces = Math.max(0, Math.floor((W - len) / 2));
+  return " ".repeat(spaces) + color + text + C.reset;
+};
+const box = (lines, borderColor = C.cyanBright) => {
+  const maxLen = Math.max(...lines.map(l => stripAnsi(l).length));
+  const w = maxLen + 4;
+  console.log(borderColor + "╔" + "═".repeat(w) + "╗" + C.reset);
+  lines.forEach(l => {
+    const padded = pad(l, maxLen);
+    console.log(borderColor + "║  " + C.reset + padded + "  " + borderColor + "║" + C.reset);
+  });
+  console.log(borderColor + "╚" + "═".repeat(w) + "╝" + C.reset);
+};
+
+// ── État global ────────────────────────────────────────────
+let sessionStats = { messages: 0, filesCreated: 0, filesRead: 0, commandsRun: 0, tokens: 0 };
+let currentModel = "claude-sonnet-4-6";
+let sessionStart = new Date();
+const HISTORY_FILE = path.join(process.env.USERPROFILE || process.env.HOME || ".", ".bibest-code-history.json");
+
+// ── Header principal ───────────────────────────────────────
+function showHeader() {
+  console.clear();
+  console.log();
+  console.log(center("██████╗ ██╗██████╗ ███████╗███████╗████████╗", C.cyanBright + C.bold));
+  console.log(center("██╔══██╗██║██╔══██╗██╔════╝██╔════╝╚══██╔══╝", C.cyanBright + C.bold));
+  console.log(center("██████╔╝██║██████╔╝█████╗  ███████╗   ██║   ", C.cyan + C.bold));
+  console.log(center("██╔══██╗██║██╔══██╗██╔══╝  ╚════██║   ██║   ", C.blue + C.bold));
+  console.log(center("██████╔╝██║██████╔╝███████╗███████║   ██║   ", C.blueBright + C.bold));
+  console.log(center("╚═════╝ ╚═╝╚═════╝ ╚══════╝╚══════╝   ╚═╝   ", C.gray + C.bold));
+  console.log(center("██████╗ ██████╗ ██████╗ ███████╗", C.magentaBright + C.bold));
+  console.log(center("██╔════╝██╔═══██╗██╔══██╗██╔════╝", C.magenta + C.bold));
+  console.log(center("██║     ██║   ██║██║  ██║█████╗  ", C.magentaBright + C.bold));
+  console.log(center("██║     ██║   ██║██║  ██║██╔══╝  ", C.magenta + C.bold));
+  console.log(center("╚██████╗╚██████╔╝██████╔╝███████╗", C.magentaBright + C.bold));
+  console.log(center(" ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝", C.gray + C.bold));
+  console.log();
+  console.log(line("═", C.cyanBright));
+  console.log(center("🤖  Agent CLI de développement propulsé par Claude AI  🚀", C.whiteBright + C.bold));
+  console.log(center("© BIBI ONDOUA — Tous droits réservés — v2.0.0", C.gray));
+  console.log(line("═", C.cyanBright));
+  console.log();
+}
+
+// ── Barre de statut ────────────────────────────────────────
+function showStatus() {
+  const now = new Date();
+  const uptime = Math.floor((now - sessionStart) / 1000);
+  const mins = Math.floor(uptime / 60).toString().padStart(2, "0");
+  const secs = (uptime % 60).toString().padStart(2, "0");
+  const cwd = process.cwd().replace(process.env.USERPROFILE || "", "~");
+
+  const items = [
+    `${C.greenBright}●${C.reset} ${C.gray}Connecté${C.reset}`,
+    `${C.cyan}⚡${C.reset} ${C.whiteBright}${currentModel}${C.reset}`,
+    `${C.yellow}📁${C.reset} ${C.gray}${cwd}${C.reset}`,
+    `${C.magenta}⏱${C.reset} ${C.gray}${mins}:${secs}${C.reset}`,
+    `${C.blue}💬${C.reset} ${C.gray}${sessionStats.messages} msgs${C.reset}`,
+  ];
+
+  console.log(line("─", C.gray));
+  console.log(" " + items.join(`  ${C.gray}│${C.reset}  `));
+  console.log(line("─", C.gray));
+}
+
+// ── Menu d'aide ────────────────────────────────────────────
+function showHelp() {
+  console.log();
+  box([
+    `${C.yellowBright + C.bold}BIBEST CODE — Commandes disponibles${C.reset}`,
+    "",
+    `${C.cyanBright}/help${C.reset}          ${C.gray}Afficher cette aide${C.reset}`,
+    `${C.cyanBright}/clear${C.reset}         ${C.gray}Effacer l'écran${C.reset}`,
+    `${C.cyanBright}/history${C.reset}       ${C.gray}Voir l'historique des sessions${C.reset}`,
+    `${C.cyanBright}/stats${C.reset}         ${C.gray}Statistiques de la session${C.reset}`,
+    `${C.cyanBright}/model${C.reset}         ${C.gray}Changer de modèle Claude${C.reset}`,
+    `${C.cyanBright}/cd <dossier>${C.reset}  ${C.gray}Changer de répertoire${C.reset}`,
+    `${C.cyanBright}/ls${C.reset}            ${C.gray}Lister le répertoire courant${C.reset}`,
+    `${C.cyanBright}/reset${C.reset}         ${C.gray}Réinitialiser la conversation${C.reset}`,
+    `${C.cyanBright}/exit${C.reset}          ${C.gray}Quitter BIBEST CODE${C.reset}`,
+    "",
+    `${C.gray}Exemples de tâches :${C.reset}`,
+    `${C.green}▶${C.reset} ${C.italic}crée une API REST en Express${C.reset}`,
+    `${C.green}▶${C.reset} ${C.italic}analyse et corrige les bugs de mon projet${C.reset}`,
+    `${C.green}▶${C.reset} ${C.italic}écris des tests unitaires pour app.js${C.reset}`,
+    `${C.green}▶${C.reset} ${C.italic}optimise les performances de ce code${C.reset}`,
+  ], C.cyanBright);
+  console.log();
+}
+
+// ── Statistiques ───────────────────────────────────────────
+function showStats() {
+  console.log();
+  box([
+    `${C.yellowBright + C.bold}📊 Statistiques de session${C.reset}`,
+    "",
+    `${C.cyan}Messages envoyés   :${C.reset} ${C.whiteBright}${sessionStats.messages}${C.reset}`,
+    `${C.cyan}Fichiers créés     :${C.reset} ${C.greenBright}${sessionStats.filesCreated}${C.reset}`,
+    `${C.cyan}Fichiers lus       :${C.reset} ${C.blueBright}${sessionStats.filesRead}${C.reset}`,
+    `${C.cyan}Commandes exécutées:${C.reset} ${C.yellowBright}${sessionStats.commandsRun}${C.reset}`,
+    `${C.cyan}Modèle actuel      :${C.reset} ${C.magentaBright}${currentModel}${C.reset}`,
+  ], C.yellowBright);
+  console.log();
+}
+
+// ── Sélecteur de modèle ────────────────────────────────────
+async function selectModel(rl) {
+  const models = [
+    { id: "claude-opus-4-6", label: "Claude Opus 4.6", desc: "Le plus puissant — tâches complexes" },
+    { id: "claude-sonnet-4-6", label: "Claude Sonnet 4.6", desc: "Équilibre puissance/vitesse (recommandé)" },
+    { id: "claude-haiku-4-5", label: "Claude Haiku 4.5", desc: "Ultra rapide — tâches simples" },
+  ];
+
+  console.log();
+  box([
+    `${C.yellowBright + C.bold}🤖 Choisir un modèle Claude${C.reset}`,
+    "",
+    ...models.map((m, i) => `${C.cyanBright}${i + 1}.${C.reset} ${C.whiteBright}${m.label}${C.reset}  ${C.gray}${m.desc}${C.reset}${m.id === currentModel ? `  ${C.greenBright}← actuel${C.reset}` : ""}`),
+  ], C.yellowBright);
+
+  return new Promise((resolve) => {
+    process.stdout.write(`\n${C.yellow}Choix (1-3) : ${C.reset}`);
+    rl.once("line", (input) => {
+      const idx = parseInt(input.trim()) - 1;
+      if (idx >= 0 && idx < models.length) {
+        currentModel = models[idx].id;
+        console.log(`\n${C.greenBright}✅ Modèle changé → ${C.bold}${models[idx].label}${C.reset}\n`);
+      } else {
+        console.log(`\n${C.gray}Annulé.${C.reset}\n`);
+      }
+      resolve();
+    });
+  });
+}
+
+// ── Historique sessions ────────────────────────────────────
+function saveHistory(history) {
+  try {
+    const data = { date: new Date().toISOString(), model: currentModel, stats: sessionStats, messages: history.slice(-20) };
+    let all = [];
+    if (fs.existsSync(HISTORY_FILE)) all = JSON.parse(fs.readFileSync(HISTORY_FILE, "utf8"));
+    all.unshift(data);
+    if (all.length > 10) all = all.slice(0, 10);
+    fs.writeFileSync(HISTORY_FILE, JSON.stringify(all, null, 2));
+  } catch {}
+}
+
+function showHistory() {
+  console.log();
+  try {
+    if (!fs.existsSync(HISTORY_FILE)) { console.log(`${C.gray}  Aucun historique disponible.${C.reset}\n`); return; }
+    const all = JSON.parse(fs.readFileSync(HISTORY_FILE, "utf8"));
+    box([
+      `${C.yellowBright + C.bold}📜 Historique des sessions${C.reset}`,
+      "",
+      ...all.map((s, i) => {
+        const d = new Date(s.date).toLocaleString("fr-FR");
+        return `${C.cyanBright}${i + 1}.${C.reset} ${C.whiteBright}${d}${C.reset}  ${C.gray}${s.model} — ${s.stats.messages} msgs — ${s.stats.filesCreated} fichiers${C.reset}`;
+      }),
+    ], C.blueBright);
+  } catch { console.log(`${C.gray}  Erreur lecture historique.${C.reset}`); }
+  console.log();
+}
+
+// ── Outils ─────────────────────────────────────────────────
+const tools = [
+  { name: "read_file", description: "Lire le contenu d'un fichier", input_schema: { type: "object", properties: { path: { type: "string", description: "Chemin du fichier" } }, required: ["path"] } },
+  { name: "write_file", description: "Créer ou écrire dans un fichier", input_schema: { type: "object", properties: { path: { type: "string" }, content: { type: "string" } }, required: ["path", "content"] } },
+  { name: "list_files", description: "Lister les fichiers d'un répertoire", input_schema: { type: "object", properties: { path: { type: "string" } }, required: ["path"] } },
+  { name: "run_command", description: "Exécuter une commande shell", input_schema: { type: "object", properties: { command: { type: "string" } }, required: ["command"] } },
+  { name: "delete_file", description: "Supprimer un fichier", input_schema: { type: "object", properties: { path: { type: "string" } }, required: ["path"] } },
+  { name: "create_directory", description: "Créer un dossier", input_schema: { type: "object", properties: { path: { type: "string" } }, required: ["path"] } },
+];
+
+const toolIcons = { read_file: "📄", write_file: "✏️ ", list_files: "📁", run_command: "⚡", delete_file: "🗑️ ", create_directory: "📂" };
+
+async function executeTool(name, input) {
+  try {
+    switch (name) {
+      case "read_file": {
+        const content = fs.readFileSync(input.path, "utf8");
+        sessionStats.filesRead++;
+        console.log(`    ${C.blueBright}└─${C.reset} ${C.gray}${input.path} (${content.length} chars)${C.reset}`);
+        return content;
+      }
+      case "write_file": {
+        const dir = path.dirname(input.path);
+        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+        fs.writeFileSync(input.path, input.content, "utf8");
+        sessionStats.filesCreated++;
+        console.log(`    ${C.greenBright}└─${C.reset} ${C.gray}${input.path}${C.reset}`);
+        return `Fichier écrit: ${input.path}`;
+      }
+      case "list_files": {
+        const files = fs.readdirSync(input.path);
+        console.log(`    ${C.blueBright}└─${C.reset} ${C.gray}${files.length} entrées${C.reset}`);
+        return files.map(f => {
+          const full = path.join(input.path, f);
+          const stat = fs.statSync(full);
+          return `${stat.isDirectory() ? "[DIR] " : "      "}${f}`;
+        }).join("\n");
+      }
+      case "run_command": {
+        sessionStats.commandsRun++;
+        console.log(`    ${C.yellowBright}└─${C.reset} ${C.gray}${input.command}${C.reset}`);
+        const { stdout, stderr } = await execAsync(input.command, { timeout: 30000, cwd: process.cwd() });
+        return (stdout + (stderr ? "\nSTDERR: " + stderr : "")).trim() || "(aucune sortie)";
+      }
+      case "delete_file": {
+        fs.unlinkSync(input.path);
+        console.log(`    ${C.redBright}└─${C.reset} ${C.gray}${input.path}${C.reset}`);
+        return `Supprimé: ${input.path}`;
+      }
+      case "create_directory": {
+        fs.mkdirSync(input.path, { recursive: true });
+        console.log(`    ${C.greenBright}└─${C.reset} ${C.gray}${input.path}${C.reset}`);
+        return `Dossier créé: ${input.path}`;
+      }
+      default: return `Outil inconnu: ${name}`;
+    }
+  } catch (e) { return `ERREUR: ${e.message}`; }
+}
+
+// ── Animation de chargement ────────────────────────────────
+function startSpinner(text) {
+  const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+  let i = 0;
+  const timer = setInterval(() => {
+    process.stdout.write(`\r  ${C.cyanBright}${frames[i % frames.length]}${C.reset} ${C.gray}${text}${C.reset}   `);
+    i++;
+  }, 80);
+  return () => { clearInterval(timer); process.stdout.write("\r" + " ".repeat(60) + "\r"); };
+}
+
+// ── Agent principal ────────────────────────────────────────
+async function runAgent(userMessage, history) {
+  sessionStats.messages++;
+  history.push({ role: "user", content: userMessage });
+
+  const stopSpinner = startSpinner("BIBEST CODE réfléchit...");
+
+  try {
+    while (true) {
+      const response = await client.messages.create({
+        model: currentModel,
+        max_tokens: 8096,
+        system: `Tu es BIBEST CODE, un agent de développement expert créé par BIBI ONDOUA.
+Tu peux lire/écrire des fichiers, exécuter des commandes shell, créer des projets complets.
+Répertoire de travail actuel: ${process.cwd()}
+Réponds toujours en français sauf demande contraire.
+Sois efficace, précis et professionnel. Utilise les outils pour accomplir les tâches concrètement.
+Après chaque action, donne un résumé clair de ce qui a été fait.`,
+        tools,
+        messages: history,
+      });
+
+      stopSpinner();
+      history.push({ role: "assistant", content: response.content });
+
+      let hasToolUse = false;
+      const toolResults = [];
+
+      for (const block of response.content) {
+        if (block.type === "text" && block.text) {
+          console.log();
+          console.log(line("─", C.gray));
+          const lines = block.text.split("\n");
+          lines.forEach(l => {
+            if (l.startsWith("# ")) console.log(`  ${C.yellowBright + C.bold}${l.substring(2)}${C.reset}`);
+            else if (l.startsWith("## ")) console.log(`  ${C.cyanBright + C.bold}${l.substring(3)}${C.reset}`);
+            else if (l.startsWith("- ") || l.startsWith("• ")) console.log(`  ${C.cyan}▸${C.reset} ${C.white}${l.substring(2)}${C.reset}`);
+            else if (l.startsWith("```")) console.log(`  ${C.gray}${l}${C.reset}`);
+            else if (l.trim() === "") console.log();
+            else console.log(`  ${C.whiteBright}${l}${C.reset}`);
+          });
+          console.log(line("─", C.gray));
+        }
+        if (block.type === "tool_use") {
+          hasToolUse = true;
+          const icon = toolIcons[block.name] || "🔧";
+          console.log(`\n  ${icon} ${C.magentaBright + C.bold}${block.name}${C.reset} ${C.gray}en cours...${C.reset}`);
+          const result = await executeTool(block.name, block.input);
+          toolResults.push({ type: "tool_result", tool_use_id: block.id, content: result });
+        }
+      }
+
+      if (hasToolUse) {
+        history.push({ role: "user", content: toolResults });
+        const stop2 = startSpinner("Traitement des résultats...");
+        setTimeout(stop2, 100);
+        continue;
+      }
+      break;
+    }
+  } catch (e) {
+    stopSpinner();
+    throw e;
+  }
+}
+
+// ── Prompt décoré ──────────────────────────────────────────
+function showPrompt() {
+  const cwd = path.basename(process.cwd());
+  process.stdout.write(
+    `\n ${C.gray}[${C.cyanBright}${cwd}${C.gray}]${C.reset} ${C.yellowBright + C.bold}❯${C.reset} `
+  );
+}
+
+// ── Main ───────────────────────────────────────────────────
+async function main() {
+  showHeader();
+
+  if (!process.env.ANTHROPIC_API_KEY) {
+    box([
+      `${C.redBright + C.bold}❌ Clé API manquante${C.reset}`,
+      "",
+      `Lance cette commande d'abord :`,
+      `${C.yellowBright}$env:ANTHROPIC_API_KEY="sk-ant-..."${C.reset}`,
+    ], C.redBright);
+    process.exit(1);
+  }
+
+  showStatus();
+  showHelp();
+
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  const history = [];
+
+  const prompt = () => {
+    showPrompt();
+    rl.question("", async (input) => {
+      const t = input.trim();
+      if (!t) return prompt();
+
+      // Commandes internes
+      if (t === "/exit" || t === "exit") {
+        saveHistory(history);
+        console.log();
+        box([
+          `${C.cyanBright + C.bold}👋 Merci d'avoir utilisé BIBEST CODE${C.reset}`,
+          "",
+          `${C.gray}Session sauvegardée — À bientôt !${C.reset}`,
+          `${C.gray}© BIBI ONDOUA — Tous droits réservés${C.reset}`,
+        ], C.cyanBright);
+        console.log();
+        process.exit(0);
+      }
+      if (t === "/help") { showHelp(); return prompt(); }
+      if (t === "/clear") { showHeader(); showStatus(); return prompt(); }
+      if (t === "/stats") { showStats(); return prompt(); }
+      if (t === "/history") { showHistory(); return prompt(); }
+      if (t === "/reset") { history.length = 0; console.log(`\n  ${C.greenBright}✅ Conversation réinitialisée${C.reset}\n`); return prompt(); }
+      if (t === "/ls") {
+        const files = fs.readdirSync(process.cwd());
+        console.log();
+        files.forEach(f => {
+          const stat = fs.statSync(f);
+          console.log(`  ${stat.isDirectory() ? C.blueBright + "📁" : C.gray + "📄"} ${C.whiteBright}${f}${C.reset}`);
+        });
+        console.log();
+        return prompt();
+      }
+      if (t.startsWith("/cd ")) {
+        const dir = t.substring(4).trim();
+        try { process.chdir(dir); console.log(`\n  ${C.greenBright}✅ Répertoire: ${process.cwd()}${C.reset}\n`); }
+        catch { console.log(`\n  ${C.redBright}❌ Dossier introuvable: ${dir}${C.reset}\n`); }
+        return prompt();
+      }
+      if (t.startsWith("/model")) { await selectModel(rl); return prompt(); }
+
+      // Message pour l'agent
+      try {
+        await runAgent(t, history);
+      } catch (e) {
+        console.log();
+        box([`${C.redBright}❌ Erreur: ${e.message}${C.reset}`], C.redBright);
+      }
+      prompt();
+    });
+  };
+
+  prompt();
+}
+
+main();

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "bibest-code",
+  "version": "2.0.0",
+  "description": "Agent CLI de developpement propulse par Claude AI",
+  "main": "bibest-code.js",
+  "type": "module",
+  "bin": {
+    "bibest-code": "./bibest-code.js"
+  },
+  "keywords": ["ai", "cli", "claude", "agent", "developer-tools"],
+  "author": "BIBI ONDOUA <b.ondoua00@gmail.com>",
+  "license": "ISC",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.39.0",
+    "readline-sync": "^1.4.10"
+  }
+}

package/test.js

@@ -0,0 +1 @@
+console.log("bibest-code fonctionne !");

package/todo-api/.env.example

@@ -0,0 +1,3 @@
+# Variables d'environnement — Todo API
+PORT=3000
+NODE_ENV=development

package/todo-api/README.md

@@ -0,0 +1,136 @@
+# 📝 Todo List — REST API
+
+> API REST complète construite avec **Express.js** | par **BIBEST CODE — BIBI ONDOUA**
+
+---
+
+## 🚀 Installation & démarrage
+
+```bash
+# 1. Installer les dépendances
+npm install
+
+# 2. Démarrer en développement (rechargement auto)
+npm run dev
+
+# 3. Démarrer en production
+npm start
+```
+
+Le serveur écoute sur **http://localhost:3000**
+
+---
+
+## 📂 Structure du projet
+
+```
+todo-api/
+├── src/
+│   ├── server.js                  # Point d'entrée
+│   ├── routes/
+│   │   └── todoRoutes.js          # Définition des routes
+│   ├── controllers/
+│   │   └── todoController.js      # Logique métier CRUD
+│   ├── middlewares/
+│   │   ├── validate.js            # Validation des données
+│   │   └── errorHandler.js        # Gestion des erreurs
+│   └── data/
+│       └── todos.js               # Stockage en mémoire
+├── package.json
+├── .env.example
+└── README.md
+```
+
+---
+
+## 🔗 Endpoints
+
+| Méthode  | Route                      | Description                            |
+|----------|----------------------------|----------------------------------------|
+| `GET`    | `/api/todos`               | Lister tous les todos                  |
+| `GET`    | `/api/todos/:id`           | Récupérer un todo par ID               |
+| `POST`   | `/api/todos`               | Créer un nouveau todo                  |
+| `PUT`    | `/api/todos/:id`           | Remplacer complètement un todo         |
+| `PATCH`  | `/api/todos/:id`           | Mettre à jour partiellement un todo    |
+| `PATCH`  | `/api/todos/:id/toggle`    | Basculer le statut `completed`         |
+| `DELETE` | `/api/todos/:id`           | Supprimer un todo                      |
+| `DELETE` | `/api/todos`               | Supprimer tous les todos complétés     |
+
+---
+
+## 🔍 Paramètres de requête (GET /api/todos)
+
+| Paramètre   | Type    | Valeurs possibles                     | Exemple                     |
+|-------------|---------|---------------------------------------|-----------------------------|
+| `completed` | boolean | `true` \| `false`                     | `?completed=false`          |
+| `priority`  | string  | `low` \| `medium` \| `high`           | `?priority=high`            |
+| `search`    | string  | texte libre                           | `?search=express`           |
+| `sort`      | string  | `createdAt` \| `updatedAt` \| `title` | `?sort=title`               |
+| `order`     | string  | `asc` \| `desc`                       | `?order=asc`                |
+| `page`      | number  | entier positif (défaut: 1)            | `?page=2`                   |
+| `limit`     | number  | entier positif (défaut: 10)           | `?limit=5`                  |
+
+---
+
+## 📋 Modèle de données
+
+```json
+{
+  "id":          "uuid-v4",
+  "title":       "string (requis, max 100 chars)",
+  "description": "string (optionnel, max 500 chars)",
+  "completed":   "boolean (défaut: false)",
+  "priority":    "low | medium | high (défaut: medium)",
+  "createdAt":   "ISO date",
+  "updatedAt":   "ISO date"
+}
+```
+
+---
+
+## 💡 Exemples de requêtes
+
+### Créer un todo
+```bash
+curl -X POST http://localhost:3000/api/todos \
+  -H "Content-Type: application/json" \
+  -d '{"title": "Ma tâche", "description": "Description ici", "priority": "high"}'
+```
+
+### Lister avec filtres
+```bash
+curl "http://localhost:3000/api/todos?completed=false&priority=high&sort=createdAt&order=desc&page=1&limit=5"
+```
+
+### Mettre à jour partiellement
+```bash
+curl -X PATCH http://localhost:3000/api/todos/:id \
+  -H "Content-Type: application/json" \
+  -d '{"completed": true}'
+```
+
+### Basculer le statut
+```bash
+curl -X PATCH http://localhost:3000/api/todos/:id/toggle
+```
+
+### Supprimer tous les complétés
+```bash
+curl -X DELETE http://localhost:3000/api/todos
+```
+
+---
+
+## 📦 Dépendances
+
+| Package    | Rôle                                      |
+|------------|-------------------------------------------|
+| `express`  | Framework HTTP                            |
+| `uuid`     | Génération d'identifiants uniques         |
+| `cors`     | Gestion des requêtes cross-origin         |
+| `morgan`   | Logger HTTP                               |
+| `nodemon`  | Rechargement automatique (dev)            |
+
+---
+
+*BIBEST CODE — by BIBI ONDOUA*