devmind 1.0.2 → 1.1.0

package/dist/commands/audit-design.js

@@ -0,0 +1,158 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { readFileSafe } from '../core/index.js';
+function isLikelyUiFile(filePath) {
+    const normalized = filePath.toLowerCase();
+    return (normalized.endsWith('.tsx') ||
+        normalized.endsWith('.jsx') ||
+        normalized.includes('/components/') ||
+        normalized.includes('/ui/') ||
+        normalized.includes('/pages/') ||
+        normalized.includes('/app/'));
+}
+function collectImports(content) {
+    const values = new Set();
+    const importFromRegex = /import\s+[^'"]*from\s+['"]([^'"]+)['"]/g;
+    const dynamicImportRegex = /import\(\s*['"]([^'"]+)['"]\s*\)/g;
+    let match;
+    while ((match = importFromRegex.exec(content)) !== null)
+        values.add(match[1]);
+    while ((match = dynamicImportRegex.exec(content)) !== null)
+        values.add(match[1]);
+    return [...values];
+}
+function isUiLibraryImport(value) {
+    const uiCandidates = [
+        '@mui/',
+        '@material-ui/',
+        'antd',
+        '@chakra-ui/',
+        'semantic-ui-react',
+        'rebass',
+        'theme-ui',
+        '@headlessui/',
+    ];
+    return uiCandidates.some((candidate) => value === candidate || value.startsWith(candidate));
+}
+export async function collectDesignAuditFindings(rootPath, designSystemPath, fileContents) {
+    const designFindings = [];
+    if (!fs.existsSync(designSystemPath))
+        return designFindings;
+    try {
+        const parsed = JSON.parse(await readFileSafe(designSystemPath));
+        const uiFileContents = new Map();
+        for (const [relPath, content] of fileContents.entries()) {
+            if (isLikelyUiFile(relPath) || relPath.endsWith('.css') || relPath.endsWith('.scss')) {
+                uiFileContents.set(relPath, content);
+            }
+        }
+        const bannedRules = (parsed.bannedRegexRules || []).filter((rule) => !!rule.pattern && !!rule.id);
+        const compiledBannedRules = bannedRules.flatMap((rule) => {
+            try {
+                return [
+                    {
+                        rule,
+                        regex: new RegExp(rule.pattern, 'm'),
+                    },
+                ];
+            }
+            catch {
+                designFindings.push({
+                    severity: 'warn',
+                    rule: rule.id,
+                    message: `Invalid regex pattern skipped: ${rule.pattern}`,
+                });
+                return [];
+            }
+        });
+        for (const [relPath, content] of uiFileContents.entries()) {
+            for (const { rule, regex } of compiledBannedRules) {
+                if (regex.test(content)) {
+                    designFindings.push({
+                        severity: 'error',
+                        rule: rule.id,
+                        file: relPath,
+                        message: rule.message || `Matched banned pattern: ${rule.pattern}`,
+                    });
+                }
+            }
+        }
+        const tokenSources = parsed.tokenSources || [];
+        for (const tokenSource of tokenSources) {
+            const abs = path.resolve(rootPath, tokenSource);
+            if (!fs.existsSync(abs)) {
+                designFindings.push({
+                    severity: 'warn',
+                    rule: 'token-source-missing',
+                    file: tokenSource,
+                    message: 'Token source path not found.',
+                });
+            }
+        }
+        const wrappers = parsed.requiredWrappers || [];
+        if (wrappers.length > 0) {
+            const appShellCandidates = [...uiFileContents.entries()].filter(([file]) => /(app|root|layout|provider)s?\.(tsx|jsx|ts|js)$/i.test(path.basename(file)));
+            const shellContent = appShellCandidates.map(([, content]) => content).join('\n');
+            for (const wrapper of wrappers) {
+                if (!shellContent.includes(wrapper)) {
+                    designFindings.push({
+                        severity: 'warn',
+                        rule: 'required-wrapper',
+                        message: `Required wrapper not detected in app/root/layout/provider files: ${wrapper}`,
+                    });
+                }
+            }
+        }
+        const allowList = parsed.allowedComponentImports || [];
+        if (allowList.length > 0) {
+            for (const [file, content] of uiFileContents.entries()) {
+                if (!isLikelyUiFile(file))
+                    continue;
+                const imports = collectImports(content);
+                const disallowed = imports.filter((value) => {
+                    if (!isUiLibraryImport(value))
+                        return false;
+                    return !allowList.some((allowed) => value === allowed || value.startsWith(`${allowed}/`));
+                });
+                for (const importPath of disallowed) {
+                    designFindings.push({
+                        severity: 'warn',
+                        rule: 'allowed-component-imports',
+                        file,
+                        message: `Import not in allowedComponentImports: ${importPath}`,
+                    });
+                }
+            }
+        }
+    }
+    catch (error) {
+        designFindings.push({
+            severity: 'error',
+            rule: 'profile-parse',
+            message: `Failed to parse design-system.json: ${error.message}`,
+        });
+    }
+    return designFindings;
+}
+export function buildDesignAuditReport(designSystemPath, findings) {
+    let designReport = '# Design System Audit Report\n\n';
+    designReport += `Generated: ${new Date().toISOString()}\n\n`;
+    designReport += `- Profile: \`${designSystemPath}\`\n`;
+    designReport += `- Findings: ${findings.length}\n`;
+    designReport += `- Errors: ${findings.filter((f) => f.severity === 'error').length}\n`;
+    designReport += `- Warnings: ${findings.filter((f) => f.severity === 'warn').length}\n\n`;
+    if (findings.length === 0) {
+        designReport += 'No design-system violations detected.\n';
+    }
+    else {
+        for (const finding of findings) {
+            designReport += `## ${finding.severity.toUpperCase()} - ${finding.rule}\n\n`;
+            designReport += `${finding.message}\n\n`;
+            if (finding.file) {
+                designReport += `File: \`${finding.file}\`\n\n`;
+            }
+        }
+    }
+    return designReport;
+}
+//# sourceMappingURL=audit-design.js.map

package/dist/commands/audit-design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-design.js","sourceRoot":"","sources":["../../src/commands/audit-design.ts"],"names":[],"mappings":"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"}

package/dist/commands/audit-report.d.ts

@@ -0,0 +1,18 @@
+import type { DesignAuditFinding } from './audit-design.js';
+interface LearningItem {
+    timestamp: string;
+    category: string;
+    content: string;
+}
+interface AuditResult {
+    learning: LearningItem;
+    status: 'covered' | 'needs-review';
+    matchedFiles: string[];
+}
+export declare function buildLearningAuditReport(results: AuditResult[], covered: number, needsReview: number): string;
+export declare function summarizeDesignFindings(findings: DesignAuditFinding[]): {
+    findings: number;
+    errors: number;
+    warnings: number;
+};
+export {};

package/dist/commands/audit-report.js

@@ -0,0 +1,30 @@
+export function buildLearningAuditReport(results, covered, needsReview) {
+    let report = '# Learning Audit Report\n\n';
+    report += `Generated: ${new Date().toISOString()}\n\n`;
+    report += `- Total learnings: ${results.length}\n`;
+    report += `- Covered: ${covered}\n`;
+    report += `- Needs review: ${needsReview}\n\n`;
+    for (const item of results) {
+        report += `## ${item.status === 'covered' ? 'Covered' : 'Needs Review'} - ${item.learning.category}\n\n`;
+        report += `${item.learning.content}\n\n`;
+        if (item.matchedFiles.length > 0) {
+            report += 'Matched files:\n';
+            for (const file of item.matchedFiles) {
+                report += `- \`${file}\`\n`;
+            }
+            report += '\n';
+        }
+        else {
+            report += 'Matched files: none\n\n';
+        }
+    }
+    return report;
+}
+export function summarizeDesignFindings(findings) {
+    return {
+        findings: findings.length,
+        errors: findings.filter((f) => f.severity === 'error').length,
+        warnings: findings.filter((f) => f.severity === 'warn').length,
+    };
+}
+//# sourceMappingURL=audit-report.js.map

package/dist/commands/audit-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-report.js","sourceRoot":"","sources":["../../src/commands/audit-report.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,wBAAwB,CAAC,OAAsB,EAAE,OAAe,EAAE,WAAmB;IACnG,IAAI,MAAM,GAAG,6BAA6B,CAAC;IAC3C,MAAM,IAAI,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;IACvD,MAAM,IAAI,sBAAsB,OAAO,CAAC,MAAM,IAAI,CAAC;IACnD,MAAM,IAAI,cAAc,OAAO,IAAI,CAAC;IACpC,MAAM,IAAI,mBAAmB,WAAW,MAAM,CAAC;IAE/C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,IAAI,MAAM,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,MAAM,CAAC;QACzG,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,MAAM,CAAC;QACzC,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,kBAAkB,CAAC;YAC7B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACrC,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC;YAC9B,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,yBAAyB,CAAC;QACtC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAA8B;IAKpE,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,MAAM;QACzB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;QAC7D,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;KAC/D,CAAC;AACJ,CAAC"}

package/dist/commands/audit-source.d.ts

@@ -0,0 +1,21 @@
+export interface AnalyzeCacheEntry {
+    mtimeMs: number;
+    size: number;
+    matches: string[];
+    content?: string;
+}
+export interface LoadedAuditSources {
+    fileContents: Map<string, string>;
+    fileSignatures: Map<string, string>;
+    cacheReused: number;
+    diskReads: number;
+}
+interface LoadAuditSourcesOptions {
+    files: string[];
+    rootPath: string;
+    analyzeCache: Record<string, AnalyzeCacheEntry>;
+    batchSize?: number;
+}
+export declare function loadAuditSources(options: LoadAuditSourcesOptions): Promise<LoadedAuditSources>;
+export declare function buildProjectFingerprint(fileSignatures: Map<string, string>): string;
+export {};

package/dist/commands/audit-source.js

@@ -0,0 +1,57 @@
+import * as path from 'path';
+import * as fsPromises from 'fs/promises';
+import { createHash } from 'crypto';
+const DEFAULT_BATCH_SIZE = 48;
+export async function loadAuditSources(options) {
+    const batchSize = options.batchSize ?? DEFAULT_BATCH_SIZE;
+    const fileContents = new Map();
+    const fileSignatures = new Map();
+    let cacheReused = 0;
+    let diskReads = 0;
+    for (let i = 0; i < options.files.length; i += batchSize) {
+        const batch = options.files.slice(i, i + batchSize);
+        const batchResults = await Promise.all(batch.map(async (relPath) => {
+            const absPath = path.join(options.rootPath, relPath);
+            let stat;
+            try {
+                stat = await fsPromises.stat(absPath);
+            }
+            catch {
+                return null;
+            }
+            const signature = `${stat.size}:${stat.mtimeMs}`;
+            const cached = options.analyzeCache[relPath];
+            if (cached?.content !== undefined && stat.mtimeMs === cached.mtimeMs && stat.size === cached.size) {
+                return { relPath, signature, content: cached.content, reused: true };
+            }
+            try {
+                const content = await fsPromises.readFile(absPath, 'utf-8');
+                return { relPath, signature, content, reused: false };
+            }
+            catch {
+                return { relPath, signature, content: null, reused: false };
+            }
+        }));
+        for (const result of batchResults) {
+            if (!result)
+                continue;
+            fileSignatures.set(result.relPath, result.signature);
+            if (result.content === null)
+                continue;
+            fileContents.set(result.relPath, result.content);
+            if (result.reused)
+                cacheReused += 1;
+            else
+                diskReads += 1;
+        }
+    }
+    return { fileContents, fileSignatures, cacheReused, diskReads };
+}
+export function buildProjectFingerprint(fileSignatures) {
+    const stable = [...fileSignatures.entries()]
+        .sort((a, b) => a[0].localeCompare(b[0]))
+        .map(([file, sig]) => `${file}:${sig}`)
+        .join('|');
+    return createHash('sha256').update(stable, 'utf8').digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=audit-source.js.map

package/dist/commands/audit-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-source.js","sourceRoot":"","sources":["../../src/commands/audit-source.ts"],"names":[],"mappings":"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"}

package/dist/commands/audit.d.ts

@@ -2,6 +2,7 @@ interface AuditOptions {
     output?: string;
     path?: string;
     json?: boolean;
+    profile?: boolean;
 }
 export declare function audit(options: AuditOptions): Promise<void>;
 export {};

package/dist/commands/audit.js

@@ -1,7 +1,10 @@
 import * as path from 'path';
 import * as fs from 'fs';
-import { glob } from 'glob';
-import { logger, ensureDir, readFileSafe, writeFileSafe } from '../core/index.js';
+import { createHash } from 'crypto';
+import { logger, ensureDir, readFileSafe, writeFileSafe, createProfiler, readCacheJson, writeCacheJson, getSourceFilesWithCache, parseLearningEntries, } from '../core/index.js';
+import { loadAuditSources, buildProjectFingerprint } from './audit-source.js';
+import { collectDesignAuditFindings, buildDesignAuditReport, } from './audit-design.js';
+import { buildLearningAuditReport, summarizeDesignFindings } from './audit-report.js';
 const STOPWORDS = new Set([
     'with',
     'from',
@@ -34,26 +37,6 @@ const STOPWORDS = new Set([
     'more',
     'less',
 ]);
-function parseLearnings(content) {
-    const sections = content
-        .split('\n---')
-        .map((section) => section.trim())
-        .filter((section) => section.startsWith('## '));
-    const parsed = [];
-    for (const section of sections) {
-        const lines = section.split('\n').filter((line) => line.trim().length > 0);
-        const header = lines[0].replace(/^##\s+/, '');
-        const match = header.match(/^(.+?)\s+-\s+(.+)$/);
-        if (!match)
-            continue;
-        parsed.push({
-            timestamp: match[1].trim(),
-            category: match[2].trim(),
-            content: lines.slice(1).join(' ').trim(),
-        });
-    }
-    return parsed;
-}
 function buildKeywords(text) {
     const tokens = text
         .toLowerCase()
@@ -63,18 +46,27 @@ function buildKeywords(text) {
         .filter((token) => token.length >= 4 && !STOPWORDS.has(token));
     return [...new Set(tokens)].slice(0, 6);
 }
-function hasKeywordCoverage(content, keywords) {
-    const lc = content.toLowerCase();
+function hasKeywordCoverageLowercase(lowercaseContent, keywords) {
     let hits = 0;
     for (const keyword of keywords) {
-        if (lc.includes(keyword))
+        if (lowercaseContent.includes(keyword))
             hits += 1;
         if (hits >= 2)
             return true;
     }
     return false;
 }
+function buildLearningKey(learning) {
+    return createHash('sha256')
+        .update(`${learning.timestamp}|${learning.category}|${learning.content}`, 'utf8')
+        .digest('hex')
+        .slice(0, 16);
+}
+function normalizeMatchedFiles(files) {
+    return [...new Set(files)].sort((a, b) => a.localeCompare(b));
+}
 export async function audit(options) {
+    const profiler = createProfiler(!!options.profile);
     const outputDir = options.output || '.devmind';
     const rootPath = path.resolve(options.path || '.');
     const learnPath = path.join(outputDir, 'memory', 'LEARN.md');
@@ -84,76 +76,170 @@ export async function audit(options) {
         return;
     }
     const learnContent = await readFileSafe(learnPath);
-    const learnings = parseLearnings(learnContent);
+    const learnings = parseLearningEntries(learnContent).map((entry) => ({
+        ...entry,
+        content: entry.content.replace(/\s+/g, ' ').trim(),
+    }));
     if (learnings.length === 0) {
         logger.warn('No learnings found to audit.');
         return;
     }
-    const files = await glob('**/*.{ts,tsx,js,jsx,py,go,java,rb,php,rs}', {
-        cwd: rootPath,
+    const sourceList = await profiler.section('audit.listSources', async () => getSourceFilesWithCache({
+        outputDir,
+        rootPath,
+        includeGlob: '**/*.{ts,tsx,js,jsx,py,go,java,rb,php,rs,css,scss}',
         ignore: ['node_modules/**', '.git/**', '.devmind/**', 'dist/**', 'build/**'],
-        nodir: true,
+    }));
+    const files = sourceList.files;
+    const analyzeCache = await profiler.section('audit.loadAnalyzeCache', async () => {
+        const cachePath = path.join(outputDir, 'cache', 'analyze-cache.json');
+        const parsed = await readCacheJson(cachePath);
+        return parsed?.files || {};
     });
-    const fileContents = new Map();
-    for (const relPath of files) {
-        const absPath = path.join(rootPath, relPath);
-        try {
-            fileContents.set(relPath, fs.readFileSync(absPath, 'utf-8'));
-        }
-        catch {
-            // Ignore unreadable files.
+    const sourceData = await profiler.section('audit.readSources', async () => loadAuditSources({
+        files,
+        rootPath,
+        analyzeCache,
+    }));
+    const { fileContents, fileSignatures, cacheReused, diskReads } = sourceData;
+    const projectFingerprint = buildProjectFingerprint(fileSignatures);
+    const coverageCachePath = path.join(outputDir, 'cache', 'audit-coverage.json');
+    const existingCoverageCache = await profiler.section('audit.loadCoverageCache', async () => {
+        const parsed = await readCacheJson(coverageCachePath);
+        if (!parsed || parsed.version !== 1 || typeof parsed.items !== 'object') {
+            return {
+                version: 1,
+                projectFingerprint,
+                items: {},
+            };
         }
-    }
+        return parsed;
+    });
+    const coverageCache = existingCoverageCache.projectFingerprint === projectFingerprint
+        ? existingCoverageCache
+        : {
+            version: 1,
+            projectFingerprint,
+            items: {},
+        };
     const results = [];
-    for (const learning of learnings) {
-        const keywords = buildKeywords(learning.content);
-        const matchedFiles = [];
-        if (keywords.length > 0) {
-            for (const [relPath, content] of fileContents.entries()) {
-                if (hasKeywordCoverage(content, keywords)) {
-                    matchedFiles.push(relPath);
-                    if (matchedFiles.length >= 5)
-                        break;
+    let coverageCacheHits = 0;
+    let coverageCacheMisses = 0;
+    await profiler.section('audit.learningCoverage', async () => {
+        const lowerContents = new Map();
+        for (const [relPath, content] of fileContents.entries()) {
+            lowerContents.set(relPath, content.toLowerCase());
+        }
+        const keywordFileCache = new Map();
+        const getFilesForKeyword = (keyword) => {
+            const cached = keywordFileCache.get(keyword);
+            if (cached)
+                return cached;
+            const matched = [];
+            for (const [relPath, lc] of lowerContents.entries()) {
+                if (lc.includes(keyword))
+                    matched.push(relPath);
+            }
+            keywordFileCache.set(keyword, matched);
+            return matched;
+        };
+        for (const learning of learnings) {
+            const learningKey = buildLearningKey(learning);
+            const cachedCoverage = coverageCache.items[learningKey];
+            if (cachedCoverage) {
+                const normalized = normalizeMatchedFiles(cachedCoverage.matchedFiles || []);
+                coverageCacheHits += 1;
+                results.push({
+                    learning,
+                    status: cachedCoverage.status,
+                    matchedFiles: normalized,
+                });
+                coverageCache.items[learningKey] = {
+                    status: cachedCoverage.status,
+                    matchedFiles: normalized,
+                };
+                continue;
+            }
+            coverageCacheMisses += 1;
+            const keywords = buildKeywords(learning.content);
+            const matchedFiles = [];
+            if (keywords.length > 0) {
+                const prioritizedKeywords = [...keywords].sort((a, b) => getFilesForKeyword(a).length - getFilesForKeyword(b).length);
+                const primaryCandidates = getFilesForKeyword(prioritizedKeywords[0]);
+                for (const relPath of primaryCandidates) {
+                    const lc = lowerContents.get(relPath);
+                    if (!lc)
+                        continue;
+                    if (hasKeywordCoverageLowercase(lc, keywords)) {
+                        matchedFiles.push(relPath);
+                        if (matchedFiles.length >= 5)
+                            break;
+                    }
                 }
             }
+            const normalizedMatchedFiles = normalizeMatchedFiles(matchedFiles);
+            results.push({
+                learning,
+                status: normalizedMatchedFiles.length > 0 ? 'covered' : 'needs-review',
+                matchedFiles: normalizedMatchedFiles,
+            });
+            coverageCache.items[learningKey] = {
+                status: normalizedMatchedFiles.length > 0 ? 'covered' : 'needs-review',
+                matchedFiles: normalizedMatchedFiles,
+            };
         }
-        results.push({
-            learning,
-            status: matchedFiles.length > 0 ? 'covered' : 'needs-review',
-            matchedFiles,
+    });
+    await profiler.section('audit.writeCoverageCache', async () => {
+        await writeCacheJson(coverageCachePath, coverageCache, {
+            compressAboveBytes: 512 * 1024,
+            pretty: false,
         });
-    }
+    });
     const covered = results.filter((r) => r.status === 'covered').length;
     const needsReview = results.length - covered;
     const reportPath = path.join(outputDir, 'analysis', 'AUDIT_REPORT.md');
     await ensureDir(path.dirname(reportPath));
-    let report = '# Learning Audit Report\n\n';
-    report += `Generated: ${new Date().toISOString()}\n\n`;
-    report += `- Total learnings: ${results.length}\n`;
-    report += `- Covered: ${covered}\n`;
-    report += `- Needs review: ${needsReview}\n\n`;
-    for (const item of results) {
-        report += `## ${item.status === 'covered' ? 'Covered' : 'Needs Review'} - ${item.learning.category}\n\n`;
-        report += `${item.learning.content}\n\n`;
-        if (item.matchedFiles.length > 0) {
-            report += 'Matched files:\n';
-            for (const file of item.matchedFiles) {
-                report += `- \`${file}\`\n`;
-            }
-            report += '\n';
-        }
-        else {
-            report += 'Matched files: none\n\n';
-        }
+    const report = buildLearningAuditReport(results, covered, needsReview);
+    await profiler.section('audit.writeLearningReport', async () => writeFileSafe(reportPath, report));
+    let designFindings = [];
+    const designSystemPath = path.join(outputDir, 'design-system.json');
+    const designReportPath = path.join(outputDir, 'analysis', 'DESIGN_SYSTEM_AUDIT.md');
+    if (fs.existsSync(designSystemPath)) {
+        designFindings = await collectDesignAuditFindings(rootPath, designSystemPath, fileContents);
+        designFindings.sort((a, b) => a.severity.localeCompare(b.severity) ||
+            a.rule.localeCompare(b.rule) ||
+            (a.file || '').localeCompare(b.file || '') ||
+            a.message.localeCompare(b.message));
+    }
+    if (fs.existsSync(designSystemPath)) {
+        const designReport = buildDesignAuditReport(designSystemPath, designFindings);
+        await profiler.section('audit.writeDesignReport', async () => writeFileSafe(designReportPath, designReport));
     }
-    await writeFileSafe(reportPath, report);
     if (options.json) {
-        console.log(JSON.stringify({
+        const profile = profiler.report();
+        const payload = {
             total: results.length,
             covered,
             needsReview,
             report: reportPath,
-        }, null, 2));
+            sourceCache: {
+                reused: cacheReused,
+                diskReads,
+            },
+            coverageCache: {
+                reused: coverageCacheHits,
+                recomputed: coverageCacheMisses,
+            },
+            sourceListCache: sourceList.cacheHit,
+            designSystem: fs.existsSync(designSystemPath)
+                ? {
+                    report: designReportPath,
+                    ...summarizeDesignFindings(designFindings),
+                }
+                : null,
+            ...(profile ? { profile } : {}),
+        };
+        console.log(JSON.stringify(payload, null, 2));
         return;
     }
     logger.info('Learning audit complete.');
@@ -161,5 +247,20 @@ export async function audit(options) {
     logger.info(`Covered: ${covered}`);
     logger.info(`Needs review: ${needsReview}`);
     logger.info(`Report: ${reportPath}`);
+    logger.info(`Source cache reuse: ${cacheReused}, disk reads: ${diskReads}`);
+    logger.info(`Coverage cache: ${coverageCacheHits} reused, ${coverageCacheMisses} recomputed`);
+    logger.info(`Source list cache: ${sourceList.cacheHit ? 'hit' : 'miss'}`);
+    if (fs.existsSync(designSystemPath)) {
+        logger.info(`Design system findings: ${designFindings.length}`);
+        logger.info(`Design report: ${designReportPath}`);
+    }
+    const profile = profiler.report();
+    if (profile) {
+        logger.info('Performance Profile');
+        logger.info(`Total: ${profile.totalMs.toFixed(1)}ms`);
+        for (const step of profile.steps) {
+            logger.info(`- ${step.name}: ${step.ms.toFixed(1)}ms`);
+        }
+    }
 }
 //# sourceMappingURL=audit.js.map