docstodev 1.0.0

package/docs/docs-to-dev.md

@@ -0,0 +1,111 @@
+# Rapport d'Analyse Technique DocsToDev
+
+> 📅 Généré le : 08/01/2026 19:36:56
+
+## 💡 Synthèse Métier (par MakazouIA)
+Voici les explications métier pour chaque fichier :
+
+* Le fichier `src/index.ts` utilise les dépendances pour initialiser l'application et charger les configurations nécessaires.
+* Le fichier `src/ai/analyzer.ts` utilise l'API Groq pour demander à l'IA de générer des descriptions métier claires à partir de données techniques brutes.
+* Le fichier `src/cli/index.ts` utilise la bibliothèque Commander pour créer une interface de ligne de commande permettant aux utilisateurs d'interagir avec l'application.
+* Le fichier `src/commands/classify.ts` utilise les informations de fichier pour déterminer le rôle métier de chaque fichier dans le projet.
+* Le fichier `src/commands/generateSummary.ts` utilise les données de projet pour générer un résumé global du projet avec un ton humain et bilingue.
+* Le fichier `src/commands/run.ts` utilise les dépendances pour analyser le code source, générer des rapports techniques et créer une représentation visuelle de la structure du projet.
+* Le fichier `src/exporters/html.ts` utilise les données de rapport pour générer une version HTML du rapport technique, avec mise en forme et liens vers les parties pertinentes du projet.
+
+En résumé, chaque fichier utilise ses dépendances pour accomplir une tâche spécifique dans le processus d'analyse et de documentation du projet.
+
+## 📂 Architecture des dossiers
+
+├─ [package-lock.json](../package-lock.json)
+├─ [package.json](../package.json)
+├─ [src/ai/analyzer.ts](../src/ai/analyzer.ts)
+├─ [src/cli/index.ts](../src/cli/index.ts)
+├─ [src/commands/classify.ts](../src/commands/classify.ts)
+├─ [src/commands/generateSummary.ts](../src/commands/generateSummary.ts)
+├─ [src/commands/run.ts](../src/commands/run.ts)
+├─ [src/exporters/html.ts](../src/exporters/html.ts)
+├─ [src/index.ts](../src/index.ts)
+└─ [tsconfig.json](../tsconfig.json)
+
+
+## 🔬 Analyse détaillée des composants
+
+### 📄 [`src/index.ts`](../src/index.ts)
+• **Densité et maintenance :** 1 lignes
+
+---
+
+### 📄 [`src/ai/analyzer.ts`](../src/ai/analyzer.ts)
+• **Densité et maintenance :** 46 lignes
+• **Capacités offertes :** `askAI`
+• **Collaborations sollicitées :**
+
+---
+
+### 📄 [`src/cli/index.ts`](../src/cli/index.ts)
+• **Densité et maintenance :** 70 lignes
+• **Collaborations sollicitées :**
+    - Utilise `commander` (External)
+    - Utilise `../commands/run.js` (Internal)
+    - Utilise `../commands/generateSummary.js` (Internal)
+    - Utilise `node:readline/promises` (Node.js)
+    - Utilise `node:process` (Node.js)
+    - Utilise `node:path` (Node.js)
+
+---
+
+### 📄 [`src/commands/classify.ts`](../src/commands/classify.ts)
+• **Densité et maintenance :** 40 lignes
+• **Capacités offertes :** `determineRole`
+• **Collaborations sollicitées :**
+    - Utilise `node:path` (Node.js)
+
+---
+
+### 📄 [`src/commands/generateSummary.ts`](../src/commands/generateSummary.ts)
+• **Densité et maintenance :** 60 lignes
+• **Capacités offertes :** `generateSummary`
+• **Collaborations sollicitées :**
+    - Utilise `node:fs` (Node.js)
+    - Utilise `node:path` (Node.js)
+
+---
+
+### 📄 [`src/commands/run.ts`](../src/commands/run.ts)
+• **Densité et maintenance :** 156 lignes
+• **Capacités offertes :** `runCommand`
+• **Collaborations sollicitées :**
+    - Utilise `globby` (External)
+    - Utilise `node:fs` (Node.js)
+    - Utilise `node:path` (Node.js)
+    - Utilise `puppeteer` (External)
+    - Utilise `../exporters/html.js` (Internal)
+    - Utilise `../ai/analyzer.js` (Internal)
+
+---
+
+### 📄 [`src/exporters/html.ts`](../src/exporters/html.ts)
+• **Densité et maintenance :** 142 lignes
+• **Capacités offertes :** `exportToHTML`
+• **Collaborations sollicitées :**
+    - Utilise `node:fs` (Node.js)
+    - Utilise `node:path` (Node.js)
+
+---
+
+## 📦 Inventaire des modules externes
+
+| Module | Type |
+| :--- | :--- |
+| `../ai/analyzer.js` | Internal |
+| `../commands/generateSummary.js` | Internal |
+| `../commands/run.js` | Internal |
+| `../exporters/html.js` | Internal |
+| `commander` | External |
+| `globby` | External |
+| `node:fs` | Node.js |
+| `node:path` | Node.js |
+| `node:process` | Node.js |
+| `node:readline/promises` | Node.js |
+| `puppeteer` | External |

package/docs/report.html

@@ -0,0 +1,90 @@
+<!DOCTYPE html>
+<html lang="fr" data-theme="dark">
+<head>
+    <meta charset="UTF-8">
+    <title>DocsToDev | Rapport Technique</title>
+    <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500&family=Fira+Code:wght@400&display=swap" rel="stylesheet">
+    <script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js"></script>
+    <style>
+        :root[data-theme="dark"] {
+            --bg: #0d1117; --card: #161b22; --text: #c9d1d9; --text-dim: #8b949e;
+            --accent: #58a6ff; --border: #30363d; --code-bg: rgba(110, 118, 129, 0.2);
+            --code-text: #ff7b72; --h-color: #f0f6fc;
+        }
+        :root[data-theme="light"] {
+            --bg: #ffffff; --card: #f8f9fa; --text: #24292f; --text-dim: #57606a;
+            --accent: #0969da; --border: #d0d7de; --code-bg: #afb8c133;
+            --code-text: #cf222e; --h-color: #1b1f24;
+        }
+
+        body { font-family: 'Inter', sans-serif; background: var(--bg); color: var(--text); padding: 2rem; line-height: 1.6; font-weight: 300; transition: background 0.3s; }
+        .container { max-width: 1100px; margin: auto; }
+        
+        .controls { position: sticky; top: 10px; display: flex; gap: 1rem; margin-bottom: 2rem; z-index: 100; }
+        #search { flex: 1; padding: 12px 20px; border-radius: 25px; border: 1px solid var(--border); background: var(--card); color: var(--text); outline: none; font-weight: 300; box-shadow: 0 4px 12px rgba(0,0,0,0.1); }
+        .btn { padding: 10px 20px; border-radius: 25px; cursor: pointer; border: 1px solid var(--border); background: var(--card); color: var(--text); font-size: 0.8rem; text-transform: uppercase; letter-spacing: 1px; }
+        .pdf-btn { background: #238636; color: white; border: none; }
+
+        h1 { font-weight: 500; font-size: 2.2rem; color: var(--accent); letter-spacing: -1px; }
+        h2 { font-weight: 400; color: var(--h-color); border-bottom: 1px solid var(--border); padding-bottom: 10px; margin-top: 3.5rem; }
+        
+        .mermaid { background: var(--card); padding: 1.5rem; border-radius: 12px; border: 1px solid var(--border); margin: 1.5rem 0; overflow: auto; }
+        .component-card { background: var(--card); border: 1px solid var(--border); border-radius: 12px; padding: 1.5rem; margin-bottom: 1.5rem; }
+        .comp-title { margin: 0 0 1rem 0 !important; color: var(--accent) !important; font-weight: 400; font-size: 1.2rem; border-bottom: 1px solid var(--border); padding-bottom: 10px !important; }
+
+        .tree-line { font-family: 'Fira Code', monospace; font-size: 0.85rem; color: var(--text-dim); white-space: pre; line-height: 1.4; }
+        .branch { color: var(--accent); opacity: 0.7; }
+
+        .table-container { margin: 1.5rem 0; border-radius: 8px; border: 1px solid var(--border); overflow: hidden; }
+        table { width: 100%; border-collapse: collapse; font-size: 0.9rem; }
+        th { background: rgba(88, 166, 255, 0.05); color: var(--accent); font-weight: 500; text-align: left; padding: 12px; border-bottom: 1px solid var(--border); }
+        td { padding: 10px 12px; border-bottom: 1px solid var(--border); }
+
+        code { font-family: 'Fira Code', monospace; background: var(--code-bg); color: var(--code-text); padding: 2px 6px; border-radius: 4px; font-size: 0.9em; font-weight: 400; }
+        a { color: var(--accent); text-decoration: none; }
+        .list-item { margin-bottom: 8px; }
+        .list-item::before { content: "•"; color: var(--accent); margin-right: 12px; font-weight: bold; }
+        
+        @media print { .controls { display: none; } body { padding: 0; } .container { max-width: 100%; border: none; } }
+    </style>
+</head>
+<body>
+    <div class="container">
+        <div class="controls">
+            <input type="text" id="search" placeholder="Rechercher par nom, rôle, technologie...">
+            <button class="btn pdf-btn" onclick="window.print()">📥 Imprimer / PDF</button>
+            <button class="btn" onclick="toggleTheme()">🌓 Theme</button>
+        </div>
+
+        <h2>📊 Graphe des Dépendances</h2>
+        <div class="mermaid">
+            graph TD
+                index_ts --> run_js
+    index_ts --> generateSummary_js
+    run_ts --> html_js
+    run_ts --> analyzer_js
+
+        </div>
+
+        <div id="content-area"><h1>Rapport d'Analyse Technique DocsToDev</h1><p>> 📅 Généré le : 08/01/2026 19:36:56</p><h2>💡 Synthèse Métier (par MakazouIA)</h2><p>Voici les explications métier pour chaque fichier :</p><div class="list-item">Le fichier <code>src/index.ts</code> utilise les dépendances pour initialiser l'application et charger les configurations nécessaires.</div><div class="list-item">Le fichier <code>src/ai/analyzer.ts</code> utilise l'API Groq pour demander à l'IA de générer des descriptions métier claires à partir de données techniques brutes.</div><div class="list-item">Le fichier <code>src/cli/index.ts</code> utilise la bibliothèque Commander pour créer une interface de ligne de commande permettant aux utilisateurs d'interagir avec l'application.</div><div class="list-item">Le fichier <code>src/commands/classify.ts</code> utilise les informations de fichier pour déterminer le rôle métier de chaque fichier dans le projet.</div><div class="list-item">Le fichier <code>src/commands/generateSummary.ts</code> utilise les données de projet pour générer un résumé global du projet avec un ton humain et bilingue.</div><div class="list-item">Le fichier <code>src/commands/run.ts</code> utilise les dépendances pour analyser le code source, générer des rapports techniques et créer une représentation visuelle de la structure du projet.</div><div class="list-item">Le fichier <code>src/exporters/html.ts</code> utilise les données de rapport pour générer une version HTML du rapport technique, avec mise en forme et liens vers les parties pertinentes du projet.</div><p>En résumé, chaque fichier utilise ses dépendances pour accomplir une tâche spécifique dans le processus d'analyse et de documentation du projet.</p><h2>📂 Architecture des dossiers</h2><div class="tree-line"><span class="branch">├─</span> <a href="../package-lock.json">package-lock.json</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../package.json">package.json</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/ai/analyzer.ts">src/ai/analyzer.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/cli/index.ts">src/cli/index.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/commands/classify.ts">src/commands/classify.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/commands/generateSummary.ts">src/commands/generateSummary.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/commands/run.ts">src/commands/run.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/exporters/html.ts">src/exporters/html.ts</a></div><div class="tree-line"><span class="branch">├─</span> <a href="../src/index.ts">src/index.ts</a></div><div class="tree-line"><span class="branch">└─</span> <a href="../tsconfig.json">tsconfig.json</a></div><h2>🔬 Analyse détaillée des composants</h2><section class="component-card"><h3 class="comp-title">📄 <a href="../src/index.ts"><code>src/index.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 1 lignes</div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/ai/analyzer.ts"><code>src/ai/analyzer.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 46 lignes</div><div class="list-item"><strong>Capacités offertes :</strong> <code>askAI</code></div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/cli/index.ts"><code>src/cli/index.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 70 lignes</div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><div class="list-item">Utilise <code>commander</code> (External)</div><div class="list-item">Utilise <code>../commands/run.js</code> (Internal)</div><div class="list-item">Utilise <code>../commands/generateSummary.js</code> (Internal)</div><div class="list-item">Utilise <code>node:readline/promises</code> (Node.js)</div><div class="list-item">Utilise <code>node:process</code> (Node.js)</div><div class="list-item">Utilise <code>node:path</code> (Node.js)</div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/commands/classify.ts"><code>src/commands/classify.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 40 lignes</div><div class="list-item"><strong>Capacités offertes :</strong> <code>determineRole</code></div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><div class="list-item">Utilise <code>node:path</code> (Node.js)</div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/commands/generateSummary.ts"><code>src/commands/generateSummary.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 60 lignes</div><div class="list-item"><strong>Capacités offertes :</strong> <code>generateSummary</code></div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><div class="list-item">Utilise <code>node:fs</code> (Node.js)</div><div class="list-item">Utilise <code>node:path</code> (Node.js)</div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/commands/run.ts"><code>src/commands/run.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 156 lignes</div><div class="list-item"><strong>Capacités offertes :</strong> <code>runCommand</code></div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><div class="list-item">Utilise <code>globby</code> (External)</div><div class="list-item">Utilise <code>node:fs</code> (Node.js)</div><div class="list-item">Utilise <code>node:path</code> (Node.js)</div><div class="list-item">Utilise <code>puppeteer</code> (External)</div><div class="list-item">Utilise <code>../exporters/html.js</code> (Internal)</div><div class="list-item">Utilise <code>../ai/analyzer.js</code> (Internal)</div><p>---</p><section class="component-card"><h3 class="comp-title">📄 <a href="../src/exporters/html.ts"><code>src/exporters/html.ts</code></a></h3><div class="list-item"><strong>Densité et maintenance :</strong> 142 lignes</div><div class="list-item"><strong>Capacités offertes :</strong> <code>exportToHTML</code></div><div class="list-item"><strong>Collaborations sollicitées :</strong></div><div class="list-item">Utilise <code>node:fs</code> (Node.js)</div><div class="list-item">Utilise <code>node:path</code> (Node.js)</div><p>---</p><h2>📦 Inventaire des modules externes</h2><div class="table-container"><table><tr><th>Module</th><th>Type</th></tr><tr><td><code>../ai/analyzer.js</code></td><td>Internal</td></tr><tr><td><code>../commands/generateSummary.js</code></td><td>Internal</td></tr><tr><td><code>../commands/run.js</code></td><td>Internal</td></tr><tr><td><code>../exporters/html.js</code></td><td>Internal</td></tr><tr><td><code>commander</code></td><td>External</td></tr><tr><td><code>globby</code></td><td>External</td></tr><tr><td><code>node:fs</code></td><td>Node.js</td></tr><tr><td><code>node:path</code></td><td>Node.js</td></tr><tr><td><code>node:process</code></td><td>Node.js</td></tr><tr><td><code>node:readline/promises</code></td><td>Node.js</td></tr><tr><td><code>puppeteer</code></td><td>External</td></tr></table></div></section></div>
+    </div>
+
+    <script>
+        mermaid.initialize({ startOnLoad: true, theme: 'dark', securityLevel: 'loose' });
+        function toggleTheme() {
+            const html = document.documentElement;
+            const next = html.getAttribute('data-theme') === 'dark' ? 'light' : 'dark';
+            html.setAttribute('data-theme', next);
+            localStorage.setItem('docs-theme', next);
+        }
+        document.documentElement.setAttribute('data-theme', localStorage.getItem('docs-theme') || 'dark');
+
+        document.getElementById('search').addEventListener('input', (e) => {
+            const term = e.target.value.toLowerCase();
+            document.querySelectorAll('.component-card, .tree-line, .table-container').forEach(el => {
+                el.style.display = el.innerText.toLowerCase().includes(term) ? '' : 'none';
+            });
+        });
+    </script>
+</body>
+</html>

package/docs/summary.md

@@ -0,0 +1,16 @@
+# 📊 Vue d'ensemble du Projet – DocsToDev
+
+> 📅 **Rapport généré le :** 08/01/2026 19:37:19
+
+## 🚀 État des lieux
+Salut ! J'ai passé ton projet au peigne fin. Voici un résumé rapide de ce que j'ai trouvé :
+- **Volume traité :** 10 fichiers analysés avec succès.
+- **Diagnostic :** La structure est claire et l'analyse est complète. ✅
+
+## 🧭 Navigation Rapide
+Pour aller plus loin, tu peux consulter les documents suivants :
+- **[📂 Arborescence & Analyse](../docs/docs-to-dev.md)** : Pour comprendre la vocation de chaque fichier et les capacités du système.
+- **[💻 Code Source](../)** : Pour retourner explorer la racine de ton projet.
+
+---
+*DocsToDev – Ton allié pour une documentation technique vivante et intelligente.*

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "docstodev",
+  "version": "1.0.0",
+  "description": "Solution d’automatisation de documentation technique intelligente avec IA",
+  "type": "module",
+  "main": "dist/cli/index.js",
+  "bin": {
+    "docs-to-dev": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "npm run build && node dist/cli/index.js run",
+    "test": "vitest"
+  },
+  "keywords": [
+    "documentation",
+    "cli",
+    "ai",
+    "typescript",
+    "mermaid",
+    "pdf"
+  ],
+  "author": "Chadrack Massamba",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "dotenv": "^16.4.7",
+    "globby": "^14.0.2",
+    "puppeteer": "^24.1.1"
+  }
+}

package/src/ai/analyzer.ts

@@ -0,0 +1,46 @@
+// Emplacement absolu : M:\workspace\extensions\docstodev\src\ai\analyzer.ts
+
+import "dotenv/config"; // Pour lire GROQ_API_KEY dans ton .env
+
+export async function askAI(technicalContext: string) {
+    const GROQ_API_KEY = process.env.GROQ_API_KEY;
+
+    if (!GROQ_API_KEY) {
+        return "⚠️ Erreur : Clé API Groq manquante dans le fichier .env";
+    }
+
+    const systemPrompt = `
+Vous êtes MakazouIA, l'assistant IA de DocsToDev, créé par Chadrack Massamba (EsporDev).
+Votre mission : Transformer des données techniques brutes en descriptions métier claires.
+
+Instructions :
+- Vous allez recevoir une liste de fichiers, leurs rôles et leurs exports.
+- Pour chaque fichier, rédigez UNE SEULE phrase concise expliquant sa responsabilité métier.
+- Soyez pro, mais gardez votre touche amicale et votre pointe d'humour du Congo-Brazzaville.
+- Ne mentionnez pas de code technique (pas de "il y a une fonction X"), expliquez le BUT du fichier.
+`;
+
+    try {
+        const resp = await fetch("https://api.groq.com/openai/v1/chat/completions", {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${GROQ_API_KEY}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: "llama-3.3-70b-versatile",
+                messages: [
+                    { role: "system", content: systemPrompt },
+                    { role: "user", content: `Voici les données techniques du projet : \n${technicalContext}` }
+                ],
+                temperature: 0.7,
+            }),
+        });
+
+        const data = await resp.json();
+        return data.choices?.[0]?.message?.content || "Désolé, je n'ai pas pu analyser ce fichier.";
+    } catch (error) {
+        console.error("Erreur IA:", error);
+        return "Erreur lors de la connexion à l'intelligence artificielle.";
+    }
+}

package/src/cli/index.ts

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+// Emplacement absolu : M:\workspace\extensions\docstodev\src\cli\index.ts
+
+import { Command } from "commander";
+import { runCommand } from "../commands/run.js";
+import { generateSummary } from "../commands/generateSummary.js";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import path from "node:path";
+
+const program = new Command();
+
+// Configuration de base du CLI
+program
+  .name("docs-to-dev")
+  .description("DocsToDev CLI - Analyse technique & Documentation intelligente")
+  .version("1.0.0");
+
+program
+  .command("run")
+  .description("Lancer le cycle complet d'analyse et de documentation")
+  .option("-l, --lang <lang>", "Langue forcée du rapport (fr | en)")
+  .action(async (options) => {
+    let lang: "fr" | "en";
+
+    // --- 1. Gestion de la Langue ---
+    if (options.lang === "fr" || options.lang === "en") {
+      lang = options.lang;
+    } else {
+      const rl = readline.createInterface({ input, output });
+      console.log("\n🌍 Bienvenue dans DocsToDev / Welcome to DocsToDev");
+      
+      let answer = "";
+      while (!["fr", "en"].includes(answer.toLowerCase())) {
+        answer = await rl.question("👉 Choisissez votre langue / Choose your language (fr/en) : ");
+      }
+      rl.close();
+      lang = answer.toLowerCase() as "fr" | "en";
+    }
+
+    // --- 2. Interface Utilisateur (Console) ---
+    const messages = {
+      fr: { start: "🚀 Démarrage de l'analyse approfondie...", success: "✨ Documentation générée avec succès dans /docs !" },
+      en: { start: "🚀 Starting deep analysis...", success: "✨ Documentation successfully generated in /docs!" }
+    }[lang];
+
+    console.log(`\n${messages.start} [${lang.toUpperCase()}]\n`);
+
+    try {
+      // --- 3. Exécution du Moteur (runCommand) ---
+      // Analyse statique + MakazouIA + Export HTML
+      const fileCount = await runCommand(lang);
+
+      // --- 4. Génération du Résumé ---
+      generateSummary("docs", fileCount || 0, lang);
+
+      console.log(`\n${messages.success}`);
+      console.log(`📂 Dossier : ${process.cwd()}${path.sep}docs\n`);
+      
+    } catch (error) {
+      const errorMsg = lang === "fr" 
+        ? "❌ Une erreur est survenue lors de l'analyse :" 
+        : "❌ An error occurred during analysis:";
+      console.error(errorMsg, error);
+      process.exit(1);
+    }
+  });
+
+program.parse(process.argv);

package/src/commands/classify.ts

@@ -0,0 +1,40 @@
+// Emplacement absolu : M:\workspace\extensions\docstodev\src\commands\classify.ts
+import path from "node:path";
+
+export function determineRole(filePath: string, content: string, lang: "fr" | "en" = "fr"): string {
+    const fileName = path.basename(filePath).toLowerCase();
+    const ext = path.extname(filePath);
+
+    const roles = {
+        fr: {
+            cli: "Lanceur CLI",
+            logic: "Logique Métier / Service",
+            ui: "Interface Utilisateur (UI)",
+            api: "Point d'Entrée API",
+            config: "Configuration Système",
+            unknown: "Inconnu"
+        },
+        en: {
+            cli: "CLI Entry Point",
+            logic: "Business Logic / Service",
+            ui: "User Interface (UI)",
+            api: "API Endpoint",
+            config: "System Configuration",
+            unknown: "Unknown"
+        }
+    };
+
+    const t = roles[lang];
+
+    if (filePath.includes("cli") || fileName === "index.ts") return t.cli;
+    
+    if (filePath.includes("commands") || content.includes("export function")) return t.logic;
+
+    if (content.includes("react") || ext === ".tsx") return t.ui;
+
+    if (content.includes("NextResponse") || filePath.includes("api/")) return t.api;
+
+    if (fileName.includes("config") || ext === ".json") return t.config;
+
+    return t.unknown;
+}

package/src/commands/generateSummary.ts

@@ -0,0 +1,60 @@
+// Emplacement absolu : M:\workspace\extensions\docstodev\src\commands\generateSummary.ts
+
+import { writeFileSync, mkdirSync } from "node:fs";
+import path from "node:path";
+
+/**
+ * Génère un résumé global du projet avec un ton humain et bilingue.
+ */
+export function generateSummary(docsDir: string, totalFiles: number, lang: "fr" | "en" = "fr") {
+  mkdirSync(docsDir, { recursive: true });
+
+  const dateStr = new Date().toLocaleString();
+  
+  // Contenu bilingue avec un ton "Expert & Humain"
+  const content = lang === "fr" 
+    ? `# 📊 Vue d'ensemble du Projet – DocsToDev
+
+> 📅 **Rapport généré le :** ${dateStr}
+
+## 🚀 État des lieux
+Salut ! J'ai passé ton projet au peigne fin. Voici un résumé rapide de ce que j'ai trouvé :
+- **Volume traité :** ${totalFiles} fichiers analysés avec succès.
+- **Diagnostic :** La structure est claire et l'analyse est complète. ✅
+
+## 🧭 Navigation Rapide
+Pour aller plus loin, tu peux consulter les documents suivants :
+- **[📂 Arborescence & Analyse](../docs/docs-to-dev.md)** : Pour comprendre la vocation de chaque fichier et les capacités du système.
+- **[💻 Code Source](../)** : Pour retourner explorer la racine de ton projet.
+
+---
+*DocsToDev – Ton allié pour une documentation technique vivante et intelligente.*
+`
+    : `# 📊 Project Overview – DocsToDev
+
+> 📅 **Generated on:** ${dateStr}
+
+## 🚀 Project Status
+Hey! I've scanned your entire codebase. Here's a quick summary of the findings:
+- **Volume processed:** ${totalFiles} files successfully analyzed.
+- **Diagnosis:** The structure is clear and the analysis is complete. ✅
+
+## 🧭 Quick Navigation
+To dive deeper, check out these documents:
+- **[📂 Tree & Analysis](../docs/docs-to-dev.md)**: Explore file purposes and system capabilities.
+- **[💻 Source Code](../)**: Head back to the project root.
+
+---
+*DocsToDev – Your partner for living and intelligent technical documentation.*
+`;
+
+  const outputPath = path.join(docsDir, "summary.md");
+  writeFileSync(outputPath, content);
+  
+  // Log de succès bilingue
+  const successMsg = lang === "fr" 
+    ? `📑 Résumé humain généré avec succès : ${outputPath}`
+    : `📑 Human-friendly summary successfully generated: ${outputPath}`;
+    
+  console.log(successMsg);
+}

package/src/commands/run.ts

@@ -0,0 +1,156 @@
+// Emplacement absolu : M:\workspace\extensions\docstodev\src\commands\run.ts
+import { globby } from "globby";
+import { writeFileSync, readFileSync, existsSync, mkdirSync } from "node:fs";
+import path from "node:path";
+import puppeteer from "puppeteer";
+import { exportToHTML } from "../exporters/html.js";
+import { askAI } from "../ai/analyzer.js";
+
+type TreeNode = { [key: string]: TreeNode | null };
+
+const i18n = {
+    fr: {
+        role: "Vocation du fichier",
+        density: "Densité et maintenance",
+        exports: "Capacités offertes",
+        imports: "Collaborations sollicitées",
+        structure: "Architecture des dossiers",
+        deps: "Inventaire des modules externes",
+        aiTitle: "Synthèse Métier (par MakazouIA)",
+        genAt: "Généré le",
+        reportTitle: "Rapport d'Analyse Technique DocsToDev"
+    },
+    en: {
+        role: "File Purpose",
+        density: "Density & Maintenance",
+        exports: "Capabilities offered",
+        imports: "External services",
+        structure: "Project Architecture",
+        deps: "External Modules Inventory",
+        aiTitle: "Business Insights (by MakazouIA)",
+        genAt: "Generated on",
+        reportTitle: "DocsToDev Technical Report"
+    }
+};
+
+function buildTree(files: string[]): TreeNode {
+    const root: TreeNode = {};
+    for (const file of files) {
+        const parts = file.split(path.sep);
+        let current = root;
+        for (const part of parts) {
+            if (!current[part]) current[part] = {};
+            current = current[part] as TreeNode;
+        }
+    }
+    return root;
+}
+
+function renderTree(tree: TreeNode, prefix = "", currentPath = ""): string {
+    const entries = Object.keys(tree).sort();
+    let output = "";
+    entries.forEach((key, index) => {
+        const isLast = index === entries.length - 1;
+        const connector = isLast ? "└─ " : "├─ ";
+        const child = tree[key];
+        const fullPath = currentPath ? `${currentPath}/${key}` : key;
+        const isFile = !child || Object.keys(child).length === 0;
+        const label = isFile ? `[${key}](../${fullPath.replace(/\\/g, '/')})` : `**${key}/**`;
+        output += `${prefix}${connector}${label}\n`;
+        if (child && Object.keys(child).length > 0) {
+            output += renderTree(child, prefix + (isLast ? "    " : "│   "), fullPath);
+        }
+    });
+    return output;
+}
+
+export async function runCommand(language: "fr" | "en" = "fr"): Promise<number> {
+    const t = i18n[language];
+    console.log(language === "fr" ? "🚀 DocsToDev : Analyse Deep Scan & Graphe..." : "🚀 DocsToDev: Deep Scan & Graph analysis...");
+
+    const files = await globby(["**/*"], {
+        gitignore: true,
+        ignore: ["**/node_modules/**", "**/.git/**", "**/dist/**", "**/docs/**"]
+    });
+
+    const docsDir = "docs";
+    if (!existsSync(docsDir)) mkdirSync(docsDir, { recursive: true });
+
+    let aiContext = `Analyse ces fichiers pour DocsToDev. Explique pourquoi ils utilisent leurs dépendances. Format: "Utilise [X] pour [Y]".\n\n`;
+    let detailContent = `## 🔬 Analyse détaillée des composants\n\n`;
+    let mermaidGraph = "";
+    const allDeps = new Map<string, string>();
+
+    for (const file of files) {
+        const ext = path.extname(file);
+        if (![".ts", ".js", ".tsx", ".jsx"].includes(ext)) continue;
+        
+        const content = readFileSync(file, "utf-8");
+        const lines = content.split(/\r?\n/);
+        const fileNameSanitized = path.basename(file).replace(/\./g, '_');
+
+        const exports = lines
+            .filter(l => l.startsWith("export "))
+            .map(l => l.match(/(?:function|const|class|type|interface)\s+([a-zA-Z0-9_]+)/)?.[1])
+            .filter(Boolean) as string[];
+
+        const importLines = lines.filter(l => l.trim().startsWith("import "));
+        
+        detailContent += `### 📄 [\`${file}\`](../${file.replace(/\\/g, '/')})\n`;
+        detailContent += `• **${t.density} :** ${lines.length} lignes\n`;
+        if (exports.length > 0) detailContent += `• **${t.exports} :** ${exports.map(e => `\`${e}\``).join(", ")}\n`;
+
+        if (importLines.length > 0) {
+            detailContent += `• **${t.imports} :**\n`;
+            importLines.forEach(line => {
+                const match = line.match(/from ['"]([^'"]+)['"]/);
+                if (match?.[1]) {
+                    const name = match[1];
+                    const type = name.startsWith('.') ? 'Internal' : (name.startsWith('node:') ? 'Node.js' : 'External');
+                    allDeps.set(name, type);
+                    detailContent += `    - Utilise \`${name}\` (${type})\n`;
+                    
+                    if (type === 'Internal') {
+                        const targetName = path.basename(name).replace(/\./g, '_');
+                        mermaidGraph += `    ${fileNameSanitized} --> ${targetName}\n`;
+                    }
+                }
+            });
+        }
+        detailContent += `\n---\n\n`;
+        aiContext += `FICHIER: ${file}\nEXPORTS: ${exports.join(",")}\nCODE:\n${lines.slice(0, 40).join("\n")}\n\n`;
+    }
+
+    const aiSummary = await askAI(aiContext) || "Synthèse IA indisponible.";
+
+    let finalMD = `# ${t.reportTitle}\n\n`;
+    finalMD += `> 📅 ${t.genAt} : ${new Date().toLocaleString()}\n\n`;
+    finalMD += `## 💡 ${t.aiTitle}\n${aiSummary}\n\n`;
+    finalMD += `## 📂 ${t.structure}\n\n${renderTree(buildTree(files))}\n\n`;
+    finalMD += detailContent;
+    finalMD += `## 📦 ${t.deps}\n\n| Module | Type |\n| :--- | :--- |\n`;
+    Array.from(allDeps.entries()).sort().forEach(([n, ty]) => finalMD += `| \`${n}\` | ${ty} |\n`);
+
+    writeFileSync(path.join(docsDir, "docs-to-dev.md"), finalMD);
+    exportToHTML(docsDir, finalMD, mermaidGraph, language);
+
+    console.log("📄 Génération du PDF automatique...");
+    await generatePDF(path.join(docsDir, "report.html"), path.join(docsDir, "report.pdf"));
+
+    return files.length;
+}
+
+async function generatePDF(htmlPath: string, outputPath: string) {
+    try {
+        const browser = await puppeteer.launch({ headless: true });
+        const page = await browser.newPage();
+        await page.goto(`file://${path.resolve(htmlPath)}`, { waitUntil: "networkidle0" });
+        await page.pdf({ 
+            path: outputPath, 
+            format: 'A4', 
+            printBackground: true, 
+            margin: { top: '1cm', bottom: '1cm', left: '1cm', right: '1cm' } 
+        });
+        await browser.close();
+    } catch (e) { console.error("Erreur PDF:", e); }
+}