docstodev 1.1.1 → 2.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docstodev",
-  "version": "1.1.1",
+  "version": "2.0.1",
   "description": "Solution d’automatisation de documentation technique intelligente avec IA",
   "type": "module",
   "main": "dist/cli/index.js",
@@ -20,7 +20,7 @@
     "mermaid",
     "pdf"
   ],
-  "author": "Chadrack Massamba",
+  "author": "Chadrack Massamba | Espoir dev",
   "license": "ISC",
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/ai/analyzer.ts

@@ -1,28 +1,66 @@
 // Emplacement absolu : M:\workspace\extensions\docstodev\src\ai\analyzer.ts
 
-import "dotenv/config"; // Pour lire GROQ_API_KEY dans ton .env
+import "dotenv/config";
 
-export async function askAI(technicalContext: string) {
+export interface AIAnalysisOptions {
+    language?: "fr" | "en";
+    includeDesignSystem?: boolean;
+    includeRisks?: boolean;
+    includeRecommendations?: boolean;
+    detailLevel?: "brief" | "detailed" | "comprehensive";
+    focusAreas?: ("architecture" | "security" | "performance" | "maintainability")[];
+}
+
+export interface AIAnalysisResult {
+    summary: string;
+    projectGoal?: string;
+    designSystem?: {
+        primaryColors: string[];
+        typography?: string;
+        componentPatterns?: string[];
+    };
+    risks?: Array<{ level: "low" | "medium" | "high"; description: string }>;
+    recommendations?: string[];
+    rawAnalysis: string;
+}
+
+export async function askAI(
+    technicalContext: string,
+    options: AIAnalysisOptions = {}
+): Promise<string> {
+    const result = await askAIDetailed(technicalContext, options);
+    return result.rawAnalysis;
+}
+
+export async function askAIDetailed(
+    technicalContext: string,
+    options: AIAnalysisOptions = {}
+): Promise<AIAnalysisResult> {
+    const {
+        language = "fr",
+        includeDesignSystem = true,
+        includeRisks = true,
+        includeRecommendations = true,
+        detailLevel = "detailed",
+        focusAreas = ["architecture", "maintainability"]
+    } = options;
 
-    // clé par défaut gratuite
     const GROQ_API_KEY = process.env.GROQ_API_KEY || "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";
 
     if (!GROQ_API_KEY) {
-        return "⚠️ Erreur : Clé API Groq manquante dans le fichier .env";
+        return {
+            summary: "⚠️ Erreur : Clé API Groq manquante",
+            rawAnalysis: "⚠️ 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.
-- mentionnez les imports, technique ( "il y a une fonction X"), expliquez le BUT du fichier.
-- selon le nombre d'occurance précisez les couleurs qui reviennen souvent eu  suggérez un design systèm , pallette de couleur.
-- donnez une très bref description du but de l'ensemble du projet.
-`;
+    const systemPrompt = buildSystemPrompt(language, {
+        includeDesignSystem,
+        includeRisks,
+        includeRecommendations,
+        detailLevel,
+        focusAreas
+    });
 
     try {
         const resp = await fetch("https://api.groq.com/openai/v1/chat/completions", {
@@ -35,16 +73,217 @@ Instructions :
                 model: "llama-3.3-70b-versatile",
                 messages: [
                     { role: "system", content: systemPrompt },
-                    { role: "user", content: `Voici les données techniques du projet : \n${technicalContext}` }
+                    {
+                        role: "user",
+                        content: language === "fr"
+                            ? `Voici les données techniques du projet :\n\n${technicalContext}`
+                            : `Here is the technical project data:\n\n${technicalContext}`
+                    }
                 ],
                 temperature: 0.7,
+                max_tokens: detailLevel === "comprehensive" ? 4096 : detailLevel === "detailed" ? 2048 : 1024
             }),
         });
 
         const data = await resp.json();
-        return data.choices?.[0]?.message?.content || "Désolé, je n'ai pas pu analyser ce fichier.";
+        const rawAnalysis = data.choices?.[0]?.message?.content ||
+            (language === "fr" ? "Désolé, je n'ai pas pu analyser ce fichier." : "Sorry, I couldn't analyze this file.");
+
+        return parseAIResponse(rawAnalysis, options);
     } catch (error) {
         console.error("Erreur IA:", error);
-        return "Erreur lors de la connexion à l'intelligence artificielle.";
+        return {
+            summary: language === "fr"
+                ? "Erreur lors de la connexion à l'intelligence artificielle."
+                : "Error connecting to artificial intelligence.",
+            rawAnalysis: language === "fr"
+                ? "Erreur lors de la connexion à l'intelligence artificielle."
+                : "Error connecting to artificial intelligence."
+        };
+    }
+}
+
+function buildSystemPrompt(
+    language: "fr" | "en",
+    options: {
+        includeDesignSystem: boolean;
+        includeRisks: boolean;
+        includeRecommendations: boolean;
+        detailLevel: string;
+        focusAreas: string[];
+    }
+): string {
+    const { includeDesignSystem, includeRisks, includeRecommendations, detailLevel, focusAreas } = options;
+
+    if (language === "fr") {
+        return `
+Vous êtes **MakazouIA**, l'assistant IA de **DocsToDev**, créé par **Chadrack Massamba (EsporDev)**.
+Votre mission : Transformer des données techniques brutes en documentation métier claire et structurée.
+
+## 📋 Instructions Générales
+- Analysez les fichiers fournis et identifiez leur rôle métier précis.
+- Rédigez des descriptions concises mais complètes (${detailLevel === "brief" ? "1 phrase" : detailLevel === "detailed" ? "2-3 phrases" : "paragraphe complet"}).
+- Gardez un ton professionnel avec une touche amicale et une pointe d'humour du Congo-Brazzaville.
+- Mentionnez les imports importants et expliquez le BUT métier de chaque fichier, pas seulement la technique.
+
+## 🎯 Structure de Réponse Requise
+
+### 1. **But du Projet** (Section prioritaire)
+Rédigez UN paragraphe clair expliquant :
+- L'objectif principal du projet
+- Les problèmes qu'il résout
+- Le public cible ou cas d'usage
+
+${includeDesignSystem ? `
+### 2. **Design System Détecté**
+Analysez le code pour identifier :
+- **Palette de couleurs** : Couleurs primaires/secondaires utilisées (avec codes hex si possibles)
+- **Typographie** : Polices détectées
+- **Patterns de composants** : Patterns UI récurrents (cards, modals, forms, etc.)
+` : ""}
+
+${includeRisks ? `
+### 3. **⚠️ Risques Identifiés**
+Listez les risques potentiels classés par niveau :
+- 🔴 **Critique** : Problèmes majeurs (sécurité, architecture)
+- 🟡 **Moyen** : Points d'attention (dette technique, performance)
+- 🟢 **Faible** : Améliorations mineures
+
+Focus sur : ${focusAreas.join(", ")}
+` : ""}
+
+${includeRecommendations ? `
+### 4. **💡 Recommandations**
+Proposez 3-5 actions concrètes pour améliorer le projet :
+- Refactoring suggéré
+- Optimisations possibles
+- Bonnes pratiques à adopter
+` : ""}
+
+### 5. **Analyse Détaillée des Fichiers**
+Pour chaque fichier majeur, expliquez :
+- Son rôle métier principal
+- Ses dépendances clés
+- Son importance dans l'architecture globale
+
+## ⚡ Ton et Style
+- Soyez technique mais accessible
+- Utilisez des émojis judicieusement (📂 🔧 ⚠️ 💡)
+- Pas de jargon inutile, privilégiez la clarté
+`;
+    } else {
+        return `
+You are **MakazouIA**, the AI assistant of **DocsToDev**, created by **Chadrack Massamba (EsporDev)**.
+Your mission: Transform raw technical data into clear business documentation.
+
+## 📋 General Instructions
+- Analyze provided files and identify their precise business role.
+- Write concise yet complete descriptions (${detailLevel === "brief" ? "1 sentence" : detailLevel === "detailed" ? "2-3 sentences" : "full paragraph"}).
+- Keep a professional tone with a friendly touch and a hint of Congo-Brazzaville humor.
+- Mention important imports and explain the business PURPOSE of each file, not just the technical aspect.
+
+## 🎯 Required Response Structure
+
+### 1. **Project Goal** (Priority section)
+Write ONE clear paragraph explaining:
+- The main project objective
+- Problems it solves
+- Target audience or use cases
+
+${includeDesignSystem ? `
+### 2. **Detected Design System**
+Analyze code to identify:
+- **Color palette**: Primary/secondary colors used (with hex codes if possible)
+- **Typography**: Detected fonts
+- **Component patterns**: Recurring UI patterns (cards, modals, forms, etc.)
+` : ""}
+
+${includeRisks ? `
+### 3. **⚠️ Identified Risks**
+List potential risks classified by level:
+- 🔴 **Critical**: Major issues (security, architecture)
+- 🟡 **Medium**: Points of attention (technical debt, performance)
+- 🟢 **Low**: Minor improvements
+
+Focus on: ${focusAreas.join(", ")}
+` : ""}
+
+${includeRecommendations ? `
+### 4. **💡 Recommendations**
+Propose 3-5 concrete actions to improve the project:
+- Suggested refactoring
+- Possible optimizations
+- Best practices to adopt
+` : ""}
+
+### 5. **Detailed File Analysis**
+For each major file, explain:
+- Its main business role
+- Key dependencies
+- Its importance in the overall architecture
+
+## ⚡ Tone and Style
+- Be technical but accessible
+- Use emojis judiciously (📂 🔧 ⚠️ 💡)
+- No unnecessary jargon, prioritize clarity
+`;
     }
+}
+
+function parseAIResponse(rawAnalysis: string, options: AIAnalysisOptions): AIAnalysisResult {
+    const result: AIAnalysisResult = {
+        summary: "",
+        rawAnalysis
+    };
+
+    // Extraire le but du projet
+    const goalMatch = rawAnalysis.match(/(?:But du Projet|Project Goal)[:\s]*\n+([\s\S]*?)(?=\n#{2,}|\n\n[A-Z#]|$)/i);
+    if (goalMatch) {
+        result.projectGoal = goalMatch[1]?.trim() || "";
+    }
+
+    // Extraire le design system
+    if (options.includeDesignSystem) {
+        const designMatch = rawAnalysis.match(/(?:Design System|Palette)[:\s]*\n+([\s\S]*?)(?=\n#{2,}|\n\n[A-Z#]|$)/i);
+        if (designMatch) {
+            const colors = designMatch[1]?.match(/#[0-9A-Fa-f]{6}/g) || [];
+            result.designSystem = {
+                primaryColors: colors,
+                componentPatterns: []
+            };
+        }
+    }
+
+    // Extraire les risques
+    if (options.includeRisks) {
+        const risksMatch = rawAnalysis.match(/(?:Risques|Risks)[:\s]*\n+([\s\S]*?)(?=\n#{2,}|\n\n[A-Z#]|$)/i);
+        if (risksMatch) {
+            result.risks = [];
+            const criticalMatches = risksMatch[1]?.match(/🔴[^\n]+/g) || [];
+            const mediumMatches = risksMatch[1]?.match(/🟡[^\n]+/g) || [];
+            const lowMatches = risksMatch[1]?.match(/🟢[^\n]+/g) || [];
+
+            criticalMatches.forEach(r => result.risks!.push({ level: "high", description: r.replace(/🔴\s*/, "") }));
+            mediumMatches.forEach(r => result.risks!.push({ level: "medium", description: r.replace(/🟡\s*/, "") }));
+            lowMatches.forEach(r => result.risks!.push({ level: "low", description: r.replace(/🟢\s*/, "") }));
+        }
+    }
+
+    // Extraire les recommandations
+    if (options.includeRecommendations) {
+        const recoMatch = rawAnalysis.match(/(?:Recommandations|Recommendations)[:\s]*\n+([\s\S]*?)(?=\n#{2,}|\n\n[A-Z#]|$)/i);
+        if (recoMatch && recoMatch[1]) {
+            result.recommendations = recoMatch[1]
+                .split(/\n[-*•]/)
+                .map(r => r.trim())
+                .filter(r => r.length > 10);
+        } else {
+            result.recommendations = [];
+        }
+    }
+
+    // Résumé (premiers 200 caractères)
+    result.summary = rawAnalysis.substring(0, 200).trim() + "...";
+
+    return result;
 }

package/src/cli/index.ts

@@ -111,17 +111,18 @@ async function showBanner(lang: "fr" | "en"): Promise<void> {
   const banner = `
 ╔═══════════════════════════════════════════════════════╗
 ║                                                       ║
-║     ██████╗  ██████╗  ██████╗███████╗████████╗       ║
-║     ██╔══██╗██╔═══██╗██╔════╝██╔════╝╚══██╔══╝       ║
-║     ██║  ██║██║   ██║██║     ███████╗   ██║          ║
-║     ██║  ██║██║   ██║██║     ╚════██║   ██║          ║
-║     ██████╔╝╚██████╔╝╚██████╗███████║   ██║          ║
-║     ╚═════╝  ╚═════╝  ╚═════╝╚══════╝   ╚═╝  DEV     ║
+║     ██████╗  ██████╗  ██████╗███████╗████████╗        ║
+║     ██╔══██╗██╔═══██╗██╔════╝██╔════╝╚══██╔══╝        ║
+║     ██║  ██║██║   ██║██║     ███████╗   ██║           ║
+║     ██║  ██║██║   ██║██║     ╚════██║   ██║           ║
+║     ██████╔╝╚██████╔╝╚██████╗███████║   ██║           ║
+║     ╚═════╝  ╚═════╝  ╚═════╝╚══════╝   ╚═╝  DEV      ║
 ║                                                       ║
 ║        📚 Analyse Technique & Documentation          ║
-║                    Intelligente                       ║
+║                    Intelligent                        ║
 ║                                                       ║
 ╚═══════════════════════════════════════════════════════╝
+By EspoirDev Massamba Kiminou chadrack delmard
 `;
 
   console.clear();