docstodev 1.0.2 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docstodev",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Solution d’automatisation de documentation technique intelligente avec IA",
   "type": "module",
   "main": "dist/cli/index.js",

package/src/ai/analyzer.ts

@@ -19,7 +19,9 @@ 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.
+- 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.
 `;
 
     try {

package/src/analyzers/languageAnalyzer.ts

@@ -9,6 +9,7 @@ export interface FileAnalysisResult {
   types: string[];
   imports: Array<{ name: string; type: string; usage?: string | undefined }>;
   exports: string[];
+  structure?: Record<string, any>; // Pour les fichiers non-standards
 }
 
 // Analyseur TypeScript/JavaScript
@@ -25,7 +26,6 @@ class TSJSAnalyzer implements LanguageAnalyzer {
 
     const functions: string[] = [];
     const funcRegex = /(?:export\s+)?(?:async\s+)?function\s+([a-zA-Z0-9_]+)/g;
-    // Resetting regex because of global flag
     funcRegex.lastIndex = 0;
     while ((match = funcRegex.exec(content)) !== null) {
       if (match[1]) functions.push(match[1]);
@@ -266,6 +266,282 @@ class RustAnalyzer implements LanguageAnalyzer {
   }
 }
 
+// Analyseur HTML
+class HTMLAnalyzer implements LanguageAnalyzer {
+  extensions = [".html", ".htm"];
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const structure: Record<string, any> = {
+      tags: new Set<string>(),
+      ids: [] as string[],
+      classes: [] as string[],
+      scripts: [] as string[],
+      styles: [] as string[]
+    };
+
+    // Extraire les balises
+    const tagRegex = /<(\w+)/g;
+    let match: RegExpExecArray | null;
+    while ((match = tagRegex.exec(content)) !== null) {
+      if (match[1]) structure.tags.add(match[1].toLowerCase());
+    }
+
+    // Extraire les IDs
+    const idRegex = /id=["']([^"']+)["']/g;
+    while ((match = idRegex.exec(content)) !== null) {
+      if (match[1]) structure.ids.push(match[1]);
+    }
+
+    // Extraire les classes
+    const classRegex = /class=["']([^"']+)["']/g;
+    while ((match = classRegex.exec(content)) !== null) {
+      if (match[1]) {
+        structure.classes.push(...match[1].split(/\s+/).filter(Boolean));
+      }
+    }
+
+    // Extraire les scripts externes
+    const scriptRegex = /<script[^>]+src=["']([^"']+)["']/g;
+    while ((match = scriptRegex.exec(content)) !== null) {
+      if (match[1]) structure.scripts.push(match[1]);
+    }
+
+    // Extraire les stylesheets externes
+    const linkRegex = /<link[^>]+href=["']([^"']+\.css)["']/g;
+    while ((match = linkRegex.exec(content)) !== null) {
+      if (match[1]) structure.styles.push(match[1]);
+    }
+
+    structure.tags = Array.from(structure.tags);
+
+    return {
+      functions: [],
+      classes: structure.classes,
+      types: [],
+      imports: [
+        ...structure.scripts.map((s : string) => ({ name: s, type: 'Script' })),
+        ...structure.styles.map((s:string) => ({ name: s, type: 'Stylesheet' }))
+      ],
+      exports: [],
+      structure
+    };
+  }
+}
+
+// Analyseur CSS/SCSS/SASS
+class CSSAnalyzer implements LanguageAnalyzer {
+  extensions = [".css", ".scss", ".sass", ".less"];
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const structure: Record<string, any> = {
+      selectors: [] as string[],
+      ids: [] as string[],
+      classes: [] as string[],
+      variables: [] as string[],
+      mixins: [] as string[],
+      imports: [] as string[]
+    };
+
+    // Classes CSS
+    const classRegex = /\.([a-zA-Z0-9_-]+)/g;
+    let match: RegExpExecArray | null;
+    while ((match = classRegex.exec(content)) !== null) {
+      if (match[1] && !structure.classes.includes(match[1])) {
+        structure.classes.push(match[1]);
+      }
+    }
+
+    // IDs CSS
+    const idRegex = /#([a-zA-Z0-9_-]+)/g;
+    while ((match = idRegex.exec(content)) !== null) {
+      if (match[1] && !structure.ids.includes(match[1])) {
+        structure.ids.push(match[1]);
+      }
+    }
+
+    // Variables CSS/SCSS
+    const varRegex = /(?:--|\$)([a-zA-Z0-9_-]+)/g;
+    while ((match = varRegex.exec(content)) !== null) {
+      if (match[1] && !structure.variables.includes(match[1])) {
+        structure.variables.push(match[1]);
+      }
+    }
+
+    // Mixins SCSS
+    const mixinRegex = /@mixin\s+([a-zA-Z0-9_-]+)/g;
+    while ((match = mixinRegex.exec(content)) !== null) {
+      if (match[1]) structure.mixins.push(match[1]);
+    }
+
+    // Imports
+    const importRegex = /@import\s+['"]([^'"]+)['"]/g;
+    while ((match = importRegex.exec(content)) !== null) {
+      if (match[1]) structure.imports.push(match[1]);
+    }
+
+    return {
+      functions: structure.mixins,
+      classes: structure.classes,
+      types: [],
+      imports: structure.imports.map((i:string) => ({ name: i, type: 'CSS' })),
+      exports: [],
+      structure
+    };
+  }
+}
+
+// Analyseur PHP
+class PHPAnalyzer implements LanguageAnalyzer {
+  extensions = [".php"];
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const functions: string[] = [];
+    const funcRegex = /function\s+([a-zA-Z0-9_]+)\s*\(/g;
+    let match: RegExpExecArray | null;
+    while ((match = funcRegex.exec(content)) !== null) {
+      if (match[1]) functions.push(match[1]);
+    }
+
+    const classes: string[] = [];
+    const classRegex = /class\s+([a-zA-Z0-9_]+)/g;
+    while ((match = classRegex.exec(content)) !== null) {
+      if (match[1]) classes.push(match[1]);
+    }
+
+    const imports: Array<{ name: string; type: string; usage?: string | undefined }> = [];
+    const useRegex = /use\s+([a-zA-Z0-9_\\]+)/g;
+    while ((match = useRegex.exec(content)) !== null) {
+      if (match[1]) {
+        imports.push({ name: match[1], type: 'Composer' });
+      }
+    }
+
+    const requireRegex = /(?:require|include)(?:_once)?\s*['"]([^'"]+)['"]/g;
+    while ((match = requireRegex.exec(content)) !== null) {
+      if (match[1]) {
+        imports.push({ name: match[1], type: 'Local' });
+      }
+    }
+
+    return { functions, classes, types: [], imports, exports: [] };
+  }
+}
+
+// Analyseur Ruby
+class RubyAnalyzer implements LanguageAnalyzer {
+  extensions = [".rb"];
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const functions: string[] = [];
+    const funcRegex = /def\s+([a-zA-Z0-9_?!]+)/g;
+    let match: RegExpExecArray | null;
+    while ((match = funcRegex.exec(content)) !== null) {
+      if (match[1]) functions.push(match[1]);
+    }
+
+    const classes: string[] = [];
+    const classRegex = /class\s+([a-zA-Z0-9_]+)/g;
+    while ((match = classRegex.exec(content)) !== null) {
+      if (match[1]) classes.push(match[1]);
+    }
+
+    const imports: Array<{ name: string; type: string; usage?: string | undefined }> = [];
+    const requireRegex = /require\s+['"]([^'"]+)['"]/g;
+    while ((match = requireRegex.exec(content)) !== null) {
+      if (match[1]) {
+        imports.push({ name: match[1], type: 'Gem' });
+      }
+    }
+
+    return { functions, classes, types: [], imports, exports: [] };
+  }
+}
+
+// Analyseur SQL
+class SQLAnalyzer implements LanguageAnalyzer {
+  extensions = [".sql"];
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const structure: Record<string, any> = {
+      tables: [] as string[],
+      procedures: [] as string[],
+      functions: [] as string[],
+      views: [] as string[]
+    };
+
+    const tableRegex = /CREATE\s+TABLE\s+(?:IF\s+NOT\s+EXISTS\s+)?([a-zA-Z0-9_]+)/gi;
+    let match: RegExpExecArray | null;
+    while ((match = tableRegex.exec(content)) !== null) {
+      if (match[1]) structure.tables.push(match[1]);
+    }
+
+    const procRegex = /CREATE\s+(?:OR\s+REPLACE\s+)?PROCEDURE\s+([a-zA-Z0-9_]+)/gi;
+    while ((match = procRegex.exec(content)) !== null) {
+      if (match[1]) structure.procedures.push(match[1]);
+    }
+
+    const funcRegex = /CREATE\s+(?:OR\s+REPLACE\s+)?FUNCTION\s+([a-zA-Z0-9_]+)/gi;
+    while ((match = funcRegex.exec(content)) !== null) {
+      if (match[1]) structure.functions.push(match[1]);
+    }
+
+    const viewRegex = /CREATE\s+(?:OR\s+REPLACE\s+)?VIEW\s+([a-zA-Z0-9_]+)/gi;
+    while ((match = viewRegex.exec(content)) !== null) {
+      if (match[1]) structure.views.push(match[1]);
+    }
+
+    return {
+      functions: structure.functions,
+      classes: structure.tables,
+      types: structure.views,
+      imports: [],
+      exports: [],
+      structure
+    };
+  }
+}
+
+// Analyseur par défaut pour tous les autres fichiers
+class DefaultAnalyzer implements LanguageAnalyzer {
+  extensions = ["*"]; // Wildcard pour tous les fichiers
+
+  analyzeFile(content: string): FileAnalysisResult {
+    const lines = content.split(/\r?\n/);
+    const structure: Record<string, any> = {
+      lineCount: lines.length,
+      nonEmptyLines: lines.filter(l => l.trim().length > 0).length,
+      size: content.length,
+      hasCode: /[a-zA-Z0-9_]+\s*[=:({]/.test(content),
+      encoding: 'UTF-8'
+    };
+
+    // Détection basique de patterns communs
+    const patterns = {
+      functions: [] as string[],
+      variables: [] as string[],
+      comments: [] as string[]
+    };
+
+    // Détection générique de fonctions (pattern commun à beaucoup de langages)
+    const genericFuncRegex = /(?:function|func|def|fn|sub|procedure)\s+([a-zA-Z0-9_]+)/gi;
+    let match: RegExpExecArray | null;
+    while ((match = genericFuncRegex.exec(content)) !== null) {
+      if (match[1]) patterns.functions.push(match[1]);
+    }
+
+    structure.patterns = patterns;
+
+    return {
+      functions: patterns.functions,
+      classes: [],
+      types: [],
+      imports: [],
+      exports: [],
+      structure
+    };
+  }
+}
+
 // Registry des analyseurs
 const analyzers: LanguageAnalyzer[] = [
   new TSJSAnalyzer(),
@@ -273,16 +549,32 @@ const analyzers: LanguageAnalyzer[] = [
   new JavaAnalyzer(),
   new CSharpAnalyzer(),
   new GoAnalyzer(),
-  new RustAnalyzer()
+  new RustAnalyzer(),
+  new HTMLAnalyzer(),
+  new CSSAnalyzer(),
+  new PHPAnalyzer(),
+  new RubyAnalyzer(),
+  new SQLAnalyzer()
 ];
 
-export function getAnalyzer(filePath: string): LanguageAnalyzer | null {
+const defaultAnalyzer = new DefaultAnalyzer();
+
+export function getAnalyzer(filePath: string): LanguageAnalyzer {
   const lastDotIndex = filePath.lastIndexOf('.');
-  if (lastDotIndex === -1) return null;
+  if (lastDotIndex === -1) return defaultAnalyzer;
+  
   const ext = filePath.substring(lastDotIndex).toLowerCase();
-  return analyzers.find(a => a.extensions.includes(ext)) || null;
+  return analyzers.find(a => a.extensions.includes(ext)) || defaultAnalyzer;
 }
 
 export function getSupportedExtensions(): string[] {
   return analyzers.flatMap(a => a.extensions);
+}
+
+export function isExplicitlySupported(filePath: string): boolean {
+  const lastDotIndex = filePath.lastIndexOf('.');
+  if (lastDotIndex === -1) return false;
+  
+  const ext = filePath.substring(lastDotIndex).toLowerCase();
+  return analyzers.some(a => a.extensions.includes(ext));
 }

package/src/commands/generateSummary.ts

@@ -3,55 +3,145 @@
 import { writeFileSync, mkdirSync } from "node:fs";
 import path from "node:path";
 
+interface SummaryData {
+  totalFiles: number;
+  sourceFiles?: number;
+  totalComplexity?: number;
+  avgComplexity?: number;
+  totalDeps?: number;
+  topLanguages?: { lang: string; count: number }[];
+  criticalFiles?: string[];
+}
+
 /**
  * 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") {
+export function generateSummary(
+  docsDir: string, 
+  data: SummaryData | 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
+  // Support de l'ancien format (juste un nombre) et du nouveau format (objet complet)
+  const summaryData: SummaryData = typeof data === 'number' 
+    ? { totalFiles: data } 
+    : data;
 
-> 📅 **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 dateStr = new Date().toLocaleString(lang === "fr" ? "fr-FR" : "en-US", {
+    dateStyle: "full",
+    timeStyle: "short"
+  });
+  
+  const t = lang === "fr" ? {
+    title: "📊 Vue d'ensemble du Projet – DocsToDev",
+    genOn: "Rapport généré le",
+    status: "🚀 État des lieux",
+    intro: "Salut ! J'ai passé ton projet au peigne fin. Voici un résumé rapide de ce que j'ai trouvé :",
+    volume: "Volume traité",
+    filesAnalyzed: "fichiers analysés avec succès",
+    sourceFiles: "fichiers sources détectés",
+    diagnosis: "Diagnostic",
+    structureClear: "La structure est claire et l'analyse est complète. ✅",
+    metrics: "📈 Métriques clés",
+    complexity: "Complexité totale",
+    avgComplexity: "Complexité moyenne",
+    dependencies: "Dépendances uniques",
+    topLangs: "🔤 Langages détectés",
+    criticalFiles: "⚠️ Fichiers critiques (haute complexité)",
+    navigation: "🧭 Navigation Rapide",
+    navDesc: "Pour aller plus loin, tu peux consulter les documents suivants :",
+    treeLink: "📂 Arborescence & Analyse",
+    treeDesc: "Pour comprendre la vocation de chaque fichier et les capacités du système.",
+    codeLink: "💻 Code Source",
+    codeDesc: "Pour retourner explorer la racine de ton projet.",
+    footer: "DocsToDev – Ton allié pour une documentation technique vivante et intelligente."
+  } : {
+    title: "📊 Project Overview – DocsToDev",
+    genOn: "Generated on",
+    status: "🚀 Project Status",
+    intro: "Hey! I've scanned your entire codebase. Here's a quick summary of the findings:",
+    volume: "Volume processed",
+    filesAnalyzed: "files successfully analyzed",
+    sourceFiles: "source files detected",
+    diagnosis: "Diagnosis",
+    structureClear: "The structure is clear and the analysis is complete. ✅",
+    metrics: "📈 Key Metrics",
+    complexity: "Total complexity",
+    avgComplexity: "Average complexity",
+    dependencies: "Unique dependencies",
+    topLangs: "🔤 Languages Detected",
+    criticalFiles: "⚠️ Critical Files (high complexity)",
+    navigation: "🧭 Quick Navigation",
+    navDesc: "To dive deeper, check out these documents:",
+    treeLink: "📂 Tree & Analysis",
+    treeDesc: "Explore file purposes and system capabilities.",
+    codeLink: "💻 Source Code",
+    codeDesc: "Head back to the project root.",
+    footer: "DocsToDev – Your partner for living and intelligent technical documentation."
+  };
+  
+  let content = `# ${t.title}\n\n`;
+  content += `> 📅 **${t.genOn} :** ${dateStr}\n\n`;
+  
+  content += `## ${t.status}\n`;
+  content += `${t.intro}\n`;
+  content += `- **${t.volume} :** ${summaryData.totalFiles} ${t.filesAnalyzed}.\n`;
+  
+  if (summaryData.sourceFiles) {
+    content += `- **${t.sourceFiles} :** ${summaryData.sourceFiles} ${t.sourceFiles.toLowerCase()}.\n`;
+  }
+  
+  content += `- **${t.diagnosis} :** ${t.structureClear}\n\n`;
+  
+  // Métriques additionnelles si disponibles
+  if (summaryData.totalComplexity || summaryData.avgComplexity || summaryData.totalDeps) {
+    content += `## ${t.metrics}\n`;
+    
+    if (summaryData.totalComplexity) {
+      content += `- **${t.complexity} :** ${summaryData.totalComplexity}\n`;
+    }
+    
+    if (summaryData.avgComplexity) {
+      content += `- **${t.avgComplexity} :** ${summaryData.avgComplexity}\n`;
+    }
+    
+    if (summaryData.totalDeps) {
+      content += `- **${t.dependencies} :** ${summaryData.totalDeps}\n`;
+    }
+    
+    content += `\n`;
+  }
+  
+  // Langages détectés
+  if (summaryData.topLanguages && summaryData.topLanguages.length > 0) {
+    content += `## ${t.topLangs}\n`;
+    summaryData.topLanguages.forEach(({ lang, count }) => {
+      content += `- **${lang}** : ${count} ${lang === "fr" ? "fichiers" : "files"}\n`;
+    });
+    content += `\n`;
+  }
+  
+  // Fichiers critiques
+  if (summaryData.criticalFiles && summaryData.criticalFiles.length > 0) {
+    content += `## ${t.criticalFiles}\n`;
+    summaryData.criticalFiles.forEach(file => {
+      content += `- \`${file}\`\n`;
+    });
+    content += `\n`;
+  }
+  
+  content += `## ${t.navigation}\n`;
+  content += `${t.navDesc}\n`;
+  content += `- **[${t.treeLink}](../docs/docs-to-dev.md)** : ${t.treeDesc}\n`;
+  content += `- **[${t.codeLink}](../)** : ${t.codeDesc}\n\n`;
+  
+  content += `---\n`;
+  content += `*${t.footer}*\n`;
 
   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}`;