code-auditor-mcp 4.1.0 → 5.0.1

package/dist/services/CodeMapGenerator.d.ts

@@ -64,9 +64,16 @@ export interface DependencyInfo {
     usedBy: string[];
     unusedInFiles: string[];
 }
+/**
+ * Generates terminal-friendly code maps from indexed code data.
+ */
 export declare class CodeMapGenerator {
     /**
-     * Generates a complete code map for the project
+     * Generates a complete code map for the project.
+     *
+     * @param projectPath - The project path the map describes.
+     * @param options - Optional flags controlling which sections are included.
+     * @returns The code map stats, file groups, and dependencies.
      */
     generateCodeMap(projectPath: string, options?: CodeMapOptions): Promise<{
         stats: CodeMapStats;
@@ -75,8 +82,12 @@ export declare class CodeMapGenerator {
         documentation?: DocumentationMetrics;
     }>;
     /**
-     * Generates a paginated code map and stores sections in database
-     * Returns summary with section references
+     * Generates a paginated code map and stores sections in database.
+     * Returns summary with section references.
+     *
+     * @param projectPath - The project path the map describes.
+     * @param options - Optional flags controlling which sections are included.
+     * @returns The map ID, section summary, and a quick preview.
      */
     generatePaginatedCodeMap(projectPath: string, options?: CodeMapOptions): Promise<{
         mapId: string;
@@ -92,7 +103,11 @@ export declare class CodeMapGenerator {
         quickPreview: string;
     }>;
     /**
-     * Formats the code map as terminal-friendly text
+     * Formats the code map as terminal-friendly text.
+     *
+     * @param codeMap - The generated code map to format.
+     * @param options - Optional flags controlling section inclusion.
+     * @returns The formatted terminal text.
      */
     formatAsText(codeMap: Awaited<ReturnType<CodeMapGenerator['generateCodeMap']>>, options?: CodeMapOptions): string;
     private calculateProjectStats;
@@ -121,10 +136,6 @@ export declare class CodeMapGenerator {
      * and design token data.
      */
     private queryStyleStats;
-    /**
-     * Format the styles intelligence section as terminal-friendly text.
-     */
-    private formatStylesSection;
     /**
      * Query risk-ranked functions from the graph cache.
      */
@@ -137,17 +148,5 @@ export declare class CodeMapGenerator {
      * Query import-graph architecture data: communities, purity, Martin metrics.
      */
     private queryArchitectureStats;
-    /**
-     * Format the architecture section as terminal-friendly text.
-     */
-    private formatArchitectureSection;
-    /**
-     * Query coverage statistics from the DB for the code-map coverage section (Spec 15 R4).
-     */
-    private queryCoverageStats;
-    /**
-     * Format the coverage section as terminal-friendly text (Spec 15 R4).
-     */
-    private formatCoverageSection;
 }
 //# sourceMappingURL=CodeMapGenerator.d.ts.map

package/dist/services/CodeMapGenerator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CodeMapGenerator.d.ts","sourceRoot":"","sources":["../../src/services/CodeMapGenerator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CodeMapGenerator.d.ts","sourceRoot":"","sources":["../../src/services/CodeMapGenerator.ts"],"names":[],"mappings":"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"}

package/dist/services/CodeMapGenerator.js

@@ -6,9 +6,16 @@ import { getAllFunctions, getDatabase } from '../codeIndexService.js';
 import { CodeIndexDB } from '../codeIndexDB.js';
 import path from 'path';
 import { randomBytes } from 'crypto';
+/**
+ * Generates terminal-friendly code maps from indexed code data.
+ */
 export class CodeMapGenerator {
     /**
-     * Generates a complete code map for the project
+     * Generates a complete code map for the project.
+     *
+     * @param projectPath - The project path the map describes.
+     * @param options - Optional flags controlling which sections are included.
+     * @returns The code map stats, file groups, and dependencies.
      */
     async generateCodeMap(projectPath, options = {}) {
         const functions = await getAllFunctions();
@@ -27,8 +34,12 @@ export class CodeMapGenerator {
         };
     }
     /**
-     * Generates a paginated code map and stores sections in database
-     * Returns summary with section references
+     * Generates a paginated code map and stores sections in database.
+     * Returns summary with section references.
+     *
+     * @param projectPath - The project path the map describes.
+     * @param options - Optional flags controlling which sections are included.
+     * @returns The map ID, section summary, and a quick preview.
      */
     async generatePaginatedCodeMap(projectPath, options = {}) {
         // Generate the full code map data
@@ -41,7 +52,7 @@ export class CodeMapGenerator {
         const sections = await this.createCodeMapSections(fullMap, options);
         const sectionInfo = [];
         for (const [sectionType, content] of Object.entries(sections)) {
-            await db.storeCodeMapSection(mapId, sectionType, content.text, content.metadata);
+            await db.codeMap.storeCodeMapSection(mapId, sectionType, content.text, content.metadata);
             sectionInfo.push({
                 type: sectionType,
                 description: content.description,
@@ -61,7 +72,11 @@ export class CodeMapGenerator {
         };
     }
     /**
-     * Formats the code map as terminal-friendly text
+     * Formats the code map as terminal-friendly text.
+     *
+     * @param codeMap - The generated code map to format.
+     * @param options - Optional flags controlling section inclusion.
+     * @returns The formatted terminal text.
      */
     formatAsText(codeMap, options = {}) {
         const lines = [];
@@ -390,7 +405,7 @@ export class CodeMapGenerator {
             const styleStats = await this.queryStyleStats();
             if (styleStats.totalDeclarations > 0) {
                 sections.styles = {
-                    text: this.formatStylesSection(styleStats),
+                    text: formatStylesSection(styleStats),
                     description: "Style intelligence — mechanism usage, property histograms, and tokens",
                     metadata: {
                         totalDeclarations: styleStats.totalDeclarations,
@@ -426,7 +441,7 @@ export class CodeMapGenerator {
             const archStats = await this.queryArchitectureStats();
             if (archStats.communityCount > 0 || archStats.martinEntries.length > 0) {
                 sections.architecture = {
-                    text: this.formatArchitectureSection(archStats),
+                    text: formatArchitectureSection(archStats),
                     description: "Import-graph architecture — communities, directory purity, and Martin instability metrics",
                     metadata: {
                         communityCount: archStats.communityCount,
@@ -441,10 +456,10 @@ export class CodeMapGenerator {
         }
         // Coverage section (Spec 15 R4) — coverage by risk decile
         try {
-            const coverageStats = await this.queryCoverageStats();
+            const coverageStats = await queryCoverageStats();
             if (coverageStats.byRiskDecile.length > 0) {
                 sections.coverage = {
-                    text: this.formatCoverageSection(coverageStats),
+                    text: formatCoverageSection(coverageStats),
                     description: "Test coverage by risk decile — measured or static-reach coverage data",
                     metadata: {
                         totalFunctions: coverageStats.totalFunctions,
@@ -615,60 +630,6 @@ export class CodeMapGenerator {
             zIndexes: zIndexRows.map(r => ({ value: r.normalized_value, count: r.cnt, files: r.files })),
         };
     }
-    /**
-     * Format the styles intelligence section as terminal-friendly text.
-     */
-    formatStylesSection(stats) {
-        const lines = [];
-        lines.push('🎨 STYLE INTELLIGENCE\n');
-        // Total
-        lines.push(`Declarations indexed: ${stats.totalDeclarations}`);
-        // Mechanism summary
-        lines.push('');
-        lines.push('Mechanism          Count');
-        lines.push('─────────          ──────');
-        for (const m of stats.mechanisms) {
-            const label = (m.mechanism || '(unknown)').padEnd(18);
-            lines.push(`${label} ${m.cnt}`);
-        }
-        // Property histogram
-        if (stats.properties.length > 0) {
-            lines.push('');
-            lines.push('Property               Count  Distinct values');
-            lines.push('────────               ─────  ───────────────');
-            for (const p of stats.properties) {
-                const label = p.property.padEnd(22);
-                const cnt = String(p.cnt).padStart(5);
-                lines.push(`${label} ${cnt}  ${p.distinct_values}`);
-            }
-        }
-        // Z-index inventory
-        if (stats.zIndexes.length > 0) {
-            lines.push('');
-            lines.push(`Z-index inventory (${stats.zIndexes.length} distinct values)`);
-            for (const z of stats.zIndexes) {
-                lines.push(`  z-index: ${z.value} (used ${z.count}×)`);
-            }
-        }
-        // Token bypass
-        if (stats.bypassCount > 0) {
-            lines.push('');
-            lines.push(`⚠️  Token bypass: ${stats.bypassCount} declaration(s) match known token values without referencing the token`);
-        }
-        // Top tokens
-        if (stats.tokens.length > 0) {
-            lines.push('');
-            lines.push('Design tokens (top 20)');
-            lines.push('Token                    Value                 Used');
-            lines.push('─────                    ─────                 ────');
-            for (const t of stats.tokens) {
-                const name = t.name.substring(0, 24).padEnd(24);
-                const val = t.value.substring(0, 20).padEnd(20);
-                lines.push(`${name} ${val} ${t.usage_count}×`);
-            }
-        }
-        return lines.join('\n');
-    }
     // ── Graph risk (Spec 14) ─────────────────────────────────────────────
     /**
      * Query risk-ranked functions from the graph cache.
@@ -738,150 +699,209 @@ export class CodeMapGenerator {
             martinEntries: martinEntries.slice(0, 15),
         };
     }
-    /**
-     * Format the architecture section as terminal-friendly text.
-     */
-    formatArchitectureSection(stats) {
-        const lines = [];
-        lines.push('🏗️  ARCHITECTURE\n');
-        // Community overview
-        lines.push(`Communities detected: ${stats.communityCount}`);
-        lines.push(`Structure-agreement score: ${stats.agreementScore.toFixed(2)} (1.0 = directories match communities)\n`);
-        // Split candidates
-        if (stats.splitCandidates.length > 0) {
-            lines.push('Split candidates (directories spanning multiple communities):');
-            for (const s of stats.splitCandidates) {
-                lines.push(`  ${s.directory} — ${s.communities.length} communities: ${s.communities.map((c, i) => `C${c}(${s.fileCounts[i]})`).join(', ')}`);
-            }
-            lines.push('');
+}
+// ---------------------------------------------------------------------------
+// Section formatters + stats queries extracted from `CodeMapGenerator` so the
+// class stays under the class-size method ceiling. They are pure over their
+// arguments (or the singleton DB) and called from `createCodeMapSections`.
+// ---------------------------------------------------------------------------
+/**
+ * Format the styles intelligence section as terminal-friendly text.
+ */
+function formatStylesSection(stats) {
+    const lines = [];
+    lines.push('🎨 STYLE INTELLIGENCE\n');
+    // Total
+    lines.push(`Declarations indexed: ${stats.totalDeclarations}`);
+    // Mechanism summary
+    lines.push('');
+    lines.push('Mechanism          Count');
+    lines.push('─────────          ──────');
+    for (const m of stats.mechanisms) {
+        const label = (m.mechanism || '(unknown)').padEnd(18);
+        lines.push(`${label} ${m.cnt}`);
+    }
+    // Property histogram
+    if (stats.properties.length > 0) {
+        lines.push('');
+        lines.push('Property               Count  Distinct values');
+        lines.push('────────               ─────  ───────────────');
+        for (const p of stats.properties) {
+            const label = p.property.padEnd(22);
+            const cnt = String(p.cnt).padStart(5);
+            lines.push(`${label} ${cnt}  ${p.distinct_values}`);
         }
-        // Merge candidates
-        if (stats.mergeCandidates.length > 0) {
-            lines.push('Merge candidates (one community dominating multiple directories):');
-            for (const m of stats.mergeCandidates) {
-                lines.push(`  Community ${m.community} — ${m.directories.length} dirs: ${m.directories.join(', ')} (${m.fileCount} files)`);
-            }
-            lines.push('');
+    }
+    // Z-index inventory
+    if (stats.zIndexes.length > 0) {
+        lines.push('');
+        lines.push(`Z-index inventory (${stats.zIndexes.length} distinct values)`);
+        for (const z of stats.zIndexes) {
+            lines.push(`  z-index: ${z.value} (used ${z.count}×)`);
         }
-        // Martin metrics
-        if (stats.martinEntries.length > 0) {
-            lines.push('Martin instability metrics (top 15 by distance from main sequence):');
-            lines.push('Directory              Ce   Ca     I      A      D');
-            lines.push('─────────              ──   ──   ─────  ─────  ─────');
-            for (const m of stats.martinEntries) {
-                const dir = m.directory.substring(0, 22).padEnd(22);
-                const ce = String(m.ce).padStart(2);
-                const ca = String(m.ca).padStart(4);
-                const inst = m.instability.toFixed(3).padStart(5);
-                const abst = m.abstractness.toFixed(3).padStart(5);
-                const dist = m.distanceFromMain.toFixed(3).padStart(5);
-                lines.push(`${dir} ${ce}  ${ca}  ${inst}  ${abst}  ${dist}`);
-            }
+    }
+    // Token bypass
+    if (stats.bypassCount > 0) {
+        lines.push('');
+        lines.push(`⚠️  Token bypass: ${stats.bypassCount} declaration(s) match known token values without referencing the token`);
+    }
+    // Top tokens
+    if (stats.tokens.length > 0) {
+        lines.push('');
+        lines.push('Design tokens (top 20)');
+        lines.push('Token                    Value                 Used');
+        lines.push('─────                    ─────                 ────');
+        for (const t of stats.tokens) {
+            const name = t.name.substring(0, 24).padEnd(24);
+            const val = t.value.substring(0, 20).padEnd(20);
+            lines.push(`${name} ${val} ${t.usage_count}×`);
         }
-        return lines.join('\n');
     }
-    /**
-     * Query coverage statistics from the DB for the code-map coverage section (Spec 15 R4).
-     */
-    async queryCoverageStats() {
-        const db = CodeIndexDB.getInstance();
-        const rawDb = db.rawDb;
-        const totalResult = rawDb
-            .prepare('SELECT COUNT(*) as cnt FROM functions WHERE exported = 1')
-            .get();
-        const totalFunctions = totalResult?.cnt ?? 0;
-        let coveredFunctions = 0;
-        try {
-            const coverageResult = rawDb
-                .prepare('SELECT COUNT(DISTINCT function_name || \'|\' || file_path) as cnt FROM coverage_data')
-                .get();
-            coveredFunctions = coverageResult?.cnt ?? 0;
+    return lines.join('\n');
+}
+/**
+ * Format the architecture section as terminal-friendly text.
+ */
+function formatArchitectureSection(stats) {
+    const lines = [];
+    lines.push('🏗️  ARCHITECTURE\n');
+    // Community overview
+    lines.push(`Communities detected: ${stats.communityCount}`);
+    lines.push(`Structure-agreement score: ${stats.agreementScore.toFixed(2)} (1.0 = directories match communities)\n`);
+    // Split candidates
+    if (stats.splitCandidates.length > 0) {
+        lines.push('Split candidates (directories spanning multiple communities):');
+        for (const s of stats.splitCandidates) {
+            lines.push(`  ${s.directory} — ${s.communities.length} communities: ${s.communities.map((c, i) => `C${c}(${s.fileCounts[i]})`).join(', ')}`);
         }
-        catch {
-            // coverage_data table may not exist yet
+        lines.push('');
+    }
+    // Merge candidates
+    if (stats.mergeCandidates.length > 0) {
+        lines.push('Merge candidates (one community dominating multiple directories):');
+        for (const m of stats.mergeCandidates) {
+            lines.push(`  Community ${m.community} — ${m.directories.length} dirs: ${m.directories.join(', ')} (${m.fileCount} files)`);
         }
-        const coverageRate = totalFunctions > 0 ? coveredFunctions / totalFunctions : 0;
-        // Build risk decile breakdown
-        const byRiskDecile = [];
-        try {
-            const riskResult = rawDb
-                .prepare(`WITH ranked AS (
-          SELECT f.function_name, f.file_path, h.risk_score,
-            NTILE(10) OVER (ORDER BY h.risk_score DESC) AS decile
-          FROM functions f
-          JOIN hotspot_scores h ON h.function_id = f.function_id
-          WHERE f.exported = 1
-        ), decile_stats AS (
-          SELECT decile, COUNT(*) as total,
-            SUM(CASE WHEN cd.function_name IS NOT NULL THEN 1 ELSE 0 END) as covered
-          FROM ranked r
-          LEFT JOIN coverage_data cd ON cd.function_name = r.function_name AND cd.file_path = r.file_path
-          GROUP BY decile
-        )
-        SELECT * FROM decile_stats ORDER BY decile`)
-                .all();
-            for (const row of riskResult) {
-                byRiskDecile.push({
-                    decile: row.decile,
-                    covered: row.covered,
-                    total: row.total,
-                    rate: row.total > 0 ? row.covered / row.total : 0,
-                });
-            }
+        lines.push('');
+    }
+    // Martin metrics
+    if (stats.martinEntries.length > 0) {
+        lines.push('Martin instability metrics (top 15 by distance from main sequence):');
+        lines.push('Directory              Ce   Ca     I      A      D');
+        lines.push('─────────              ──   ──   ─────  ─────  ─────');
+        for (const m of stats.martinEntries) {
+            const dir = m.directory.substring(0, 22).padEnd(22);
+            const ce = String(m.ce).padStart(2);
+            const ca = String(m.ca).padStart(4);
+            const inst = m.instability.toFixed(3).padStart(5);
+            const abst = m.abstractness.toFixed(3).padStart(5);
+            const dist = m.distanceFromMain.toFixed(3).padStart(5);
+            lines.push(`${dir} ${ce}  ${ca}  ${inst}  ${abst}  ${dist}`);
         }
-        catch {
-            // hotspot_scores or coverage_data may not exist
+    }
+    return lines.join('\n');
+}
+/**
+ * Format the coverage section as terminal-friendly text (Spec 15 R4).
+ */
+function formatCoverageSection(stats) {
+    const lines = [];
+    lines.push('🧪 COVERAGE\n');
+    const pct = (stats.coverageRate * 100).toFixed(1);
+    lines.push(`Functions: ${stats.totalFunctions} total, ${stats.coveredFunctions} covered (${pct}%)\n`);
+    if (stats.byRiskDecile.length > 0) {
+        lines.push('Coverage rate by risk decile (1 = highest risk):');
+        lines.push('Decile  Covered/Total  Rate    Bar');
+        lines.push('──────  ─────────────  ──────  ────────────────────');
+        for (const d of stats.byRiskDecile) {
+            const label = `#${String(d.decile).padStart(2)}`;
+            const counts = `${String(d.covered).padStart(3)}/${String(d.total).padStart(3)}`;
+            const rate = (d.rate * 100).toFixed(0).padStart(3) + '%';
+            const barLen = Math.round(d.rate * 20);
+            const bar = '█'.repeat(barLen) + '░'.repeat(20 - barLen);
+            lines.push(` ${label}    ${counts}          ${rate}   ${bar}`);
         }
-        // Untested top-decile functions
-        const untestedTopDecile = [];
-        try {
-            const untested = db.getUntestedTopDecile(0.1);
-            for (const fn of untested) {
-                untestedTopDecile.push({
-                    functionName: fn.functionName,
-                    filePath: fn.filePath,
-                    riskScore: fn.riskScore,
-                });
-            }
+        lines.push('');
+    }
+    if (stats.untestedTopDecile.length > 0) {
+        lines.push(`Untested high-risk functions (top ${stats.untestedTopDecile.length}):`);
+        for (const fn of stats.untestedTopDecile.slice(0, 10)) {
+            const score = fn.riskScore.toFixed(4);
+            lines.push(`  ${fn.functionName}  (${fn.filePath})  risk=${score}`);
         }
-        catch {
-            // DB method may throw if tables don't exist
+        if (stats.untestedTopDecile.length > 10) {
+            lines.push(`  ... and ${stats.untestedTopDecile.length - 10} more`);
         }
-        return { totalFunctions, coveredFunctions, coverageRate, byRiskDecile, untestedTopDecile };
     }
-    /**
-     * Format the coverage section as terminal-friendly text (Spec 15 R4).
-     */
-    formatCoverageSection(stats) {
-        const lines = [];
-        lines.push('🧪 COVERAGE\n');
-        const pct = (stats.coverageRate * 100).toFixed(1);
-        lines.push(`Functions: ${stats.totalFunctions} total, ${stats.coveredFunctions} covered (${pct}%)\n`);
-        if (stats.byRiskDecile.length > 0) {
-            lines.push('Coverage rate by risk decile (1 = highest risk):');
-            lines.push('Decile  Covered/Total  Rate    Bar');
-            lines.push('──────  ─────────────  ──────  ────────────────────');
-            for (const d of stats.byRiskDecile) {
-                const label = `#${String(d.decile).padStart(2)}`;
-                const counts = `${String(d.covered).padStart(3)}/${String(d.total).padStart(3)}`;
-                const rate = (d.rate * 100).toFixed(0).padStart(3) + '%';
-                const barLen = Math.round(d.rate * 20);
-                const bar = '█'.repeat(barLen) + '░'.repeat(20 - barLen);
-                lines.push(` ${label}    ${counts}          ${rate}   ${bar}`);
-            }
-            lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Query coverage statistics from the DB for the code-map coverage section (Spec 15 R4).
+ */
+async function queryCoverageStats() {
+    const db = CodeIndexDB.getInstance();
+    const rawDb = db.rawDb;
+    const totalResult = rawDb
+        .prepare('SELECT COUNT(*) as cnt FROM functions WHERE exported = 1')
+        .get();
+    const totalFunctions = totalResult?.cnt ?? 0;
+    let coveredFunctions = 0;
+    try {
+        const coverageResult = rawDb
+            .prepare('SELECT COUNT(DISTINCT function_name || \'|\' || file_path) as cnt FROM coverage_data')
+            .get();
+        coveredFunctions = coverageResult?.cnt ?? 0;
+    }
+    catch {
+        // coverage_data table may not exist yet
+    }
+    const coverageRate = totalFunctions > 0 ? coveredFunctions / totalFunctions : 0;
+    // Build risk decile breakdown
+    const byRiskDecile = [];
+    try {
+        const riskResult = rawDb
+            .prepare(`WITH ranked AS (
+        SELECT f.function_name, f.file_path, h.risk_score,
+          NTILE(10) OVER (ORDER BY h.risk_score DESC) AS decile
+        FROM functions f
+        JOIN hotspot_scores h ON h.function_id = f.function_id
+        WHERE f.exported = 1
+      ), decile_stats AS (
+        SELECT decile, COUNT(*) as total,
+          SUM(CASE WHEN cd.function_name IS NOT NULL THEN 1 ELSE 0 END) as covered
+        FROM ranked r
+        LEFT JOIN coverage_data cd ON cd.function_name = r.function_name AND cd.file_path = r.file_path
+        GROUP BY decile
+      )
+      SELECT * FROM decile_stats ORDER BY decile`)
+            .all();
+        for (const row of riskResult) {
+            byRiskDecile.push({
+                decile: row.decile,
+                covered: row.covered,
+                total: row.total,
+                rate: row.total > 0 ? row.covered / row.total : 0,
+            });
         }
-        if (stats.untestedTopDecile.length > 0) {
-            lines.push(`Untested high-risk functions (top ${stats.untestedTopDecile.length}):`);
-            for (const fn of stats.untestedTopDecile.slice(0, 10)) {
-                const score = fn.riskScore.toFixed(4);
-                lines.push(`  ${fn.functionName}  (${fn.filePath})  risk=${score}`);
-            }
-            if (stats.untestedTopDecile.length > 10) {
-                lines.push(`  ... and ${stats.untestedTopDecile.length - 10} more`);
-            }
+    }
+    catch {
+        // hotspot_scores or coverage_data may not exist
+    }
+    // Untested top-decile functions
+    const untestedTopDecile = [];
+    try {
+        const untested = db.coverage.getUntestedTopDecile(0.1);
+        for (const fn of untested) {
+            untestedTopDecile.push({
+                functionName: fn.functionName,
+                filePath: fn.filePath,
+                riskScore: fn.riskScore,
+            });
         }
-        return lines.join('\n');
     }
+    catch {
+        // DB method may throw if tables don't exist
+    }
+    return { totalFunctions, coveredFunctions, coverageRate, byRiskDecile, untestedTopDecile };
 }
 //# sourceMappingURL=CodeMapGenerator.js.map