docstodev 1.0.0 → 1.0.3

package/docs/docs-to-dev.md

@@ -1,111 +0,0 @@
-# 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

@@ -1,90 +0,0 @@
-<!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

@@ -1,16 +0,0 @@
-# 📊 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/src/commands/classify.ts

@@ -1,40 +0,0 @@
-// 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;
-}