@grafema/util 0.3.0-beta

package/dist/diagnostics/DiagnosticCollector.js

@@ -0,0 +1,133 @@
+/**
+ * DiagnosticCollector - Collects and filters diagnostics from plugin execution
+ *
+ * The DiagnosticCollector aggregates errors from PluginResult.errors[],
+ * converting both GrafemaError instances (with rich info) and plain Error
+ * instances (treated as generic errors) into unified Diagnostic entries.
+ *
+ * Usage:
+ *   const collector = new DiagnosticCollector();
+ *   collector.addFromPluginResult('INDEXING', 'JSModuleIndexer', result);
+ *
+ *   if (collector.hasFatal()) {
+ *     throw new Error('Fatal error detected');
+ *   }
+ *
+ *   console.log(collector.toDiagnosticsLog());
+ */
+import { GrafemaError } from '../errors/GrafemaError.js';
+/**
+ * DiagnosticCollector - collects, filters, and formats diagnostics
+ */
+export class DiagnosticCollector {
+    diagnostics = [];
+    /**
+     * Extract errors from PluginResult and add as diagnostics.
+     *
+     * GrafemaError instances provide rich info (code, severity, context, suggestion).
+     * Plain Error instances are treated as generic errors with code 'ERR_UNKNOWN'.
+     */
+    addFromPluginResult(phase, plugin, result) {
+        for (const error of result.errors) {
+            if (error instanceof GrafemaError) {
+                this.add({
+                    code: error.code,
+                    severity: error.severity,
+                    message: error.message,
+                    file: error.context.filePath,
+                    line: error.context.lineNumber,
+                    phase,
+                    plugin,
+                    suggestion: error.suggestion,
+                    // REG-332: Pass through resolution context
+                    resolutionChain: error.context.resolutionChain,
+                    failureReason: error.context.failureReason,
+                });
+            }
+            else {
+                // Plain Error - treat as generic error
+                this.add({
+                    code: 'ERR_UNKNOWN',
+                    severity: 'error',
+                    message: error.message,
+                    phase,
+                    plugin,
+                });
+            }
+        }
+    }
+    /**
+     * Add a diagnostic directly.
+     * Timestamp is set automatically.
+     */
+    add(diagnostic) {
+        this.diagnostics.push({
+            ...diagnostic,
+            timestamp: Date.now(),
+        });
+    }
+    /**
+     * Get all diagnostics.
+     * Returns a copy to prevent external modification.
+     */
+    getAll() {
+        return [...this.diagnostics];
+    }
+    /**
+     * Get diagnostics filtered by phase.
+     */
+    getByPhase(phase) {
+        return this.diagnostics.filter(d => d.phase === phase);
+    }
+    /**
+     * Get diagnostics filtered by plugin name (case-sensitive).
+     */
+    getByPlugin(plugin) {
+        return this.diagnostics.filter(d => d.plugin === plugin);
+    }
+    /**
+     * Get diagnostics filtered by error code.
+     */
+    getByCode(code) {
+        return this.diagnostics.filter(d => d.code === code);
+    }
+    /**
+     * Check if any fatal diagnostic exists.
+     * Fatal errors require immediate stop of analysis.
+     */
+    hasFatal() {
+        return this.diagnostics.some(d => d.severity === 'fatal');
+    }
+    /**
+     * Check if any error (including fatal) exists.
+     */
+    hasErrors() {
+        return this.diagnostics.some(d => d.severity === 'error' || d.severity === 'fatal');
+    }
+    /**
+     * Check if any warning exists.
+     */
+    hasWarnings() {
+        return this.diagnostics.some(d => d.severity === 'warning');
+    }
+    /**
+     * Get total count of diagnostics.
+     */
+    count() {
+        return this.diagnostics.length;
+    }
+    /**
+     * Format diagnostics as JSON lines (one JSON object per line).
+     * Suitable for .grafema/diagnostics.log file.
+     */
+    toDiagnosticsLog() {
+        return this.diagnostics.map(d => JSON.stringify(d)).join('\n');
+    }
+    /**
+     * Clear all diagnostics.
+     */
+    clear() {
+        this.diagnostics = [];
+    }
+}
+//# sourceMappingURL=DiagnosticCollector.js.map

package/dist/diagnostics/DiagnosticCollector.js.map

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

package/dist/diagnostics/DiagnosticReporter.d.ts

@@ -0,0 +1,122 @@
+/**
+ * DiagnosticReporter - Formats diagnostics for output
+ *
+ * Supports multiple output formats:
+ * - text: Human-readable format with severity indicators
+ * - json: Machine-readable JSON format for CI integration
+ * - csv: Spreadsheet-compatible format
+ *
+ * Usage:
+ *   const reporter = new DiagnosticReporter(collector);
+ *   console.log(reporter.report({ format: 'text', includeSummary: true }));
+ *   console.log(reporter.summary());
+ */
+import type { Diagnostic, DiagnosticCollector } from './DiagnosticCollector.js';
+/**
+ * Report output options
+ */
+export interface ReportOptions {
+    format: 'text' | 'json' | 'csv';
+    includeSummary?: boolean;
+    includeTrace?: boolean;
+}
+/**
+ * Options for strict mode formatting (REG-332)
+ */
+export interface StrictFormatOptions {
+    /** Show resolution chain (hybrid: auto-show for ≤3 errors, hide for more) */
+    verbose?: boolean;
+    /** REG-332: Number of errors suppressed by grafema-ignore comments */
+    suppressedCount?: number;
+}
+/**
+ * Summary statistics
+ */
+export interface SummaryStats {
+    total: number;
+    fatal: number;
+    errors: number;
+    warnings: number;
+    info: number;
+}
+/**
+ * Category count with metadata
+ */
+export interface CategoryCount {
+    code: string;
+    count: number;
+    name: string;
+    checkCommand: string;
+}
+/**
+ * Summary statistics with category breakdown
+ */
+export interface CategorizedSummaryStats extends SummaryStats {
+    byCode: CategoryCount[];
+}
+/**
+ * DiagnosticReporter - formats diagnostics for different output formats
+ */
+export declare class DiagnosticReporter {
+    private collector;
+    constructor(collector: DiagnosticCollector);
+    /**
+     * Generate a formatted report of all diagnostics.
+     */
+    report(options: ReportOptions): string;
+    /**
+     * Generate a human-readable summary of diagnostic counts.
+     */
+    summary(): string;
+    /**
+     * Generate a categorized summary with actionable commands.
+     */
+    categorizedSummary(): string;
+    /**
+     * Get diagnostic statistics by severity.
+     */
+    getStats(): SummaryStats;
+    /**
+     * Get diagnostic statistics grouped by category.
+     */
+    getCategorizedStats(): CategorizedSummaryStats;
+    /**
+     * Format strict mode errors with enhanced context (REG-332).
+     * Shows resolution chain and context-aware suggestions.
+     *
+     * Uses hybrid progressive disclosure:
+     * - ≤3 errors: show chain by default
+     * - >3 errors: hide chain unless verbose=true
+     *
+     * @param diagnostics - The fatal diagnostics from strict mode
+     * @param options - Formatting options
+     * @returns Formatted string for CLI output
+     */
+    formatStrict(diagnostics: Diagnostic[], options?: StrictFormatOptions): string;
+    /**
+     * Generate human-readable text report.
+     */
+    private textReport;
+    /**
+     * Generate JSON report.
+     */
+    private jsonReport;
+    /**
+     * Generate CSV report.
+     */
+    private csvReport;
+    /**
+     * Get severity indicator for text output.
+     */
+    private getSeverityIcon;
+    /**
+     * Format file location for display.
+     */
+    private formatLocation;
+    /**
+     * Escape a value for CSV output.
+     * Wraps in quotes and escapes internal quotes.
+     */
+    private csvEscape;
+}
+//# sourceMappingURL=DiagnosticReporter.d.ts.map

package/dist/diagnostics/DiagnosticReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticReporter.d.ts","sourceRoot":"","sources":["../../src/diagnostics/DiagnosticReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,YAAY;IAC3D,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,mBAAmB;IAElD;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM;IAYtC;;OAEG;IACH,OAAO,IAAI,MAAM;IAsBjB;;OAEG;IACH,kBAAkB,IAAI,MAAM;IA0C5B;;OAEG;IACH,QAAQ,IAAI,YAAY;IAWxB;;OAEG;IACH,mBAAmB,IAAI,uBAAuB;IAwC9C;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM;IA+DlF;;OAEG;IACH,OAAO,CAAC,UAAU;IA0BlB;;OAEG;IACH,OAAO,CAAC,UAAU;IAelB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,eAAe;IAevB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;;OAGG;IACH,OAAO,CAAC,SAAS;CAKlB"}

package/dist/diagnostics/DiagnosticReporter.js

@@ -0,0 +1,300 @@
+/**
+ * DiagnosticReporter - Formats diagnostics for output
+ *
+ * Supports multiple output formats:
+ * - text: Human-readable format with severity indicators
+ * - json: Machine-readable JSON format for CI integration
+ * - csv: Spreadsheet-compatible format
+ *
+ * Usage:
+ *   const reporter = new DiagnosticReporter(collector);
+ *   console.log(reporter.report({ format: 'text', includeSummary: true }));
+ *   console.log(reporter.summary());
+ */
+import { CODE_TO_CATEGORY } from './categories.js';
+/**
+ * DiagnosticReporter - formats diagnostics for different output formats
+ */
+export class DiagnosticReporter {
+    collector;
+    constructor(collector) {
+        this.collector = collector;
+    }
+    /**
+     * Generate a formatted report of all diagnostics.
+     */
+    report(options) {
+        const diagnostics = this.collector.getAll();
+        if (options.format === 'json') {
+            return this.jsonReport(diagnostics, options);
+        }
+        else if (options.format === 'csv') {
+            return this.csvReport(diagnostics);
+        }
+        else {
+            return this.textReport(diagnostics, options);
+        }
+    }
+    /**
+     * Generate a human-readable summary of diagnostic counts.
+     */
+    summary() {
+        const stats = this.getStats();
+        if (stats.total === 0) {
+            return 'No issues found.';
+        }
+        const parts = [];
+        if (stats.fatal > 0) {
+            parts.push(`Fatal: ${stats.fatal}`);
+        }
+        if (stats.errors > 0) {
+            parts.push(`Errors: ${stats.errors}`);
+        }
+        if (stats.warnings > 0) {
+            parts.push(`Warnings: ${stats.warnings}`);
+        }
+        return parts.join(', ');
+    }
+    /**
+     * Generate a categorized summary with actionable commands.
+     */
+    categorizedSummary() {
+        const stats = this.getCategorizedStats();
+        if (stats.total === 0) {
+            return 'No issues found.';
+        }
+        const lines = [];
+        // Severity totals (same format as summary())
+        const severityParts = [];
+        if (stats.fatal > 0) {
+            severityParts.push(`Fatal: ${stats.fatal}`);
+        }
+        if (stats.errors > 0) {
+            severityParts.push(`Errors: ${stats.errors}`);
+        }
+        if (stats.warnings > 0) {
+            severityParts.push(`Warnings: ${stats.warnings}`);
+        }
+        lines.push(severityParts.join(', '));
+        // Top 5 categories
+        const topCategories = stats.byCode.slice(0, 5);
+        for (const category of topCategories) {
+            lines.push(`  - ${category.count} ${category.name} (run \`${category.checkCommand}\`)`);
+        }
+        // "Other issues" if more than 5 categories
+        if (stats.byCode.length > 5) {
+            const remainingCount = stats.byCode.slice(5).reduce((sum, cat) => sum + cat.count, 0);
+            const issueWord = remainingCount === 1 ? 'other issue' : 'other issues';
+            lines.push(`  - ${remainingCount} ${issueWord}`);
+        }
+        // Footer
+        lines.push('');
+        lines.push('Run `grafema check --all` for full diagnostics.');
+        return lines.join('\n');
+    }
+    /**
+     * Get diagnostic statistics by severity.
+     */
+    getStats() {
+        const diagnostics = this.collector.getAll();
+        return {
+            total: diagnostics.length,
+            fatal: diagnostics.filter(d => d.severity === 'fatal').length,
+            errors: diagnostics.filter(d => d.severity === 'error').length,
+            warnings: diagnostics.filter(d => d.severity === 'warning').length,
+            info: diagnostics.filter(d => d.severity === 'info').length,
+        };
+    }
+    /**
+     * Get diagnostic statistics grouped by category.
+     */
+    getCategorizedStats() {
+        const diagnostics = this.collector.getAll();
+        // Get severity stats
+        const severityStats = {
+            total: diagnostics.length,
+            fatal: diagnostics.filter(d => d.severity === 'fatal').length,
+            errors: diagnostics.filter(d => d.severity === 'error').length,
+            warnings: diagnostics.filter(d => d.severity === 'warning').length,
+            info: diagnostics.filter(d => d.severity === 'info').length,
+        };
+        // Group by code
+        const codeMap = new Map();
+        for (const diag of diagnostics) {
+            const count = codeMap.get(diag.code) || 0;
+            codeMap.set(diag.code, count + 1);
+        }
+        // Convert to CategoryCount array with metadata
+        const byCode = [];
+        for (const [code, count] of codeMap.entries()) {
+            const category = CODE_TO_CATEGORY[code];
+            byCode.push({
+                code,
+                count,
+                name: category?.name || code,
+                checkCommand: category?.checkCommand || 'grafema check --all',
+            });
+        }
+        // Sort by count descending
+        byCode.sort((a, b) => b.count - a.count);
+        return {
+            ...severityStats,
+            byCode,
+        };
+    }
+    /**
+     * Format strict mode errors with enhanced context (REG-332).
+     * Shows resolution chain and context-aware suggestions.
+     *
+     * Uses hybrid progressive disclosure:
+     * - ≤3 errors: show chain by default
+     * - >3 errors: hide chain unless verbose=true
+     *
+     * @param diagnostics - The fatal diagnostics from strict mode
+     * @param options - Formatting options
+     * @returns Formatted string for CLI output
+     */
+    formatStrict(diagnostics, options = {}) {
+        const lines = [];
+        // Hybrid: show chain for ≤3 errors unless explicitly set
+        const showChain = options.verbose ?? diagnostics.length <= 3;
+        for (const diag of diagnostics) {
+            // Header: CODE file:line
+            const location = diag.file
+                ? diag.line
+                    ? `${diag.file}:${diag.line}`
+                    : diag.file
+                : '';
+            lines.push(`${diag.code} ${location}`);
+            lines.push('');
+            // Message
+            lines.push(`  ${diag.message}`);
+            // Resolution chain (if showing and present)
+            if (showChain && diag.resolutionChain && diag.resolutionChain.length > 0) {
+                lines.push('');
+                lines.push('  Resolution chain:');
+                for (const step of diag.resolutionChain) {
+                    const stepLocation = step.file
+                        ? step.line
+                            ? ` (${step.file}:${step.line})`
+                            : ` (${step.file})`
+                        : '';
+                    lines.push(`    ${step.step} -> ${step.result}${stepLocation}`);
+                }
+            }
+            // Suggestion (if present)
+            if (diag.suggestion) {
+                lines.push('');
+                lines.push(`  Suggestion: ${diag.suggestion}`);
+            }
+            lines.push('');
+            lines.push('---');
+            lines.push('');
+        }
+        // Remove trailing separator
+        if (lines.length > 0) {
+            lines.splice(-3);
+        }
+        // Add hint about verbose mode if chain hidden
+        if (!showChain && diagnostics.some(d => d.resolutionChain && d.resolutionChain.length > 0)) {
+            lines.push('');
+            lines.push('  Run with --verbose to see resolution chains.');
+        }
+        // REG-332: Show suppression summary if any errors were suppressed
+        if (options.suppressedCount && options.suppressedCount > 0) {
+            lines.push('');
+            lines.push(`  ${options.suppressedCount} error(s) suppressed by grafema-ignore comments.`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate human-readable text report.
+     */
+    textReport(diagnostics, options) {
+        if (diagnostics.length === 0) {
+            return 'No issues found.';
+        }
+        const lines = [];
+        for (const diag of diagnostics) {
+            const icon = this.getSeverityIcon(diag.severity);
+            const location = this.formatLocation(diag);
+            lines.push(`${icon} ${diag.code} ${location} ${diag.message}`);
+            if (diag.suggestion) {
+                lines.push(`   Suggestion: ${diag.suggestion}`);
+            }
+        }
+        if (options.includeSummary) {
+            lines.push('');
+            lines.push(this.summary());
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Generate JSON report.
+     */
+    jsonReport(diagnostics, options) {
+        const result = {
+            diagnostics,
+        };
+        if (options.includeSummary) {
+            result.summary = this.getStats();
+        }
+        return JSON.stringify(result, null, 2);
+    }
+    /**
+     * Generate CSV report.
+     */
+    csvReport(diagnostics) {
+        const header = 'severity,code,file,line,message,plugin,phase,suggestion';
+        const rows = diagnostics.map(d => [
+            d.severity,
+            d.code,
+            d.file || '',
+            d.line || '',
+            this.csvEscape(d.message),
+            d.plugin,
+            d.phase,
+            d.suggestion ? this.csvEscape(d.suggestion) : '',
+        ].join(','));
+        return [header, ...rows].join('\n');
+    }
+    /**
+     * Get severity indicator for text output.
+     */
+    getSeverityIcon(severity) {
+        switch (severity) {
+            case 'fatal':
+                return '[FATAL]';
+            case 'error':
+                return '[ERROR]';
+            case 'warning':
+                return '[WARN]';
+            case 'info':
+                return '[INFO]';
+            default:
+                return '[?]';
+        }
+    }
+    /**
+     * Format file location for display.
+     */
+    formatLocation(diag) {
+        if (!diag.file) {
+            return '';
+        }
+        if (diag.line) {
+            return `(${diag.file}:${diag.line})`;
+        }
+        return `(${diag.file})`;
+    }
+    /**
+     * Escape a value for CSV output.
+     * Wraps in quotes and escapes internal quotes.
+     */
+    csvEscape(value) {
+        // Always quote to handle commas and special characters
+        const escaped = value.replace(/"/g, '""');
+        return `"${escaped}"`;
+    }
+}
+//# sourceMappingURL=DiagnosticReporter.js.map

package/dist/diagnostics/DiagnosticReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticReporter.js","sourceRoot":"","sources":["../../src/diagnostics/DiagnosticReporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAiDnD;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACT;IAApB,YAAoB,SAA8B;QAA9B,cAAS,GAAT,SAAS,CAAqB;IAAG,CAAC;IAEtD;;OAEG;IACH,MAAM,CAAC,OAAsB;QAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAE5C,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE9B,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAEzC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,6CAA6C;QAC7C,MAAM,aAAa,GAAa,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACpB,aAAa,CAAC,IAAI,CAAC,UAAU,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,aAAa,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACvB,aAAa,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAErC,mBAAmB;QACnB,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/C,KAAK,MAAM,QAAQ,IAAI,aAAa,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,WAAW,QAAQ,CAAC,YAAY,KAAK,CAAC,CAAC;QAC1F,CAAC;QAED,2CAA2C;QAC3C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACtF,MAAM,SAAS,GAAG,cAAc,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,OAAO,cAAc,IAAI,SAAS,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,SAAS;QACT,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAE9D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5C,OAAO;YACL,KAAK,EAAE,WAAW,CAAC,MAAM;YACzB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YAC7D,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YAC9D,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;YAClE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;SAC5D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAE5C,qBAAqB;QACrB,MAAM,aAAa,GAAiB;YAClC,KAAK,EAAE,WAAW,CAAC,MAAM;YACzB,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YAC7D,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM;YAC9D,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,MAAM;YAClE,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,MAAM;SAC5D,CAAC;QAEF,gBAAgB;QAChB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;QAED,+CAA+C;QAC/C,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC9C,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,KAAK;gBACL,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,IAAI;gBAC5B,YAAY,EAAE,QAAQ,EAAE,YAAY,IAAI,qBAAqB;aAC9D,CAAC,CAAC;QACL,CAAC;QAED,2BAA2B;QAC3B,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAEzC,OAAO;YACL,GAAG,aAAa;YAChB,MAAM;SACP,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;OAWG;IACH,YAAY,CAAC,WAAyB,EAAE,UAA+B,EAAE;QACvE,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,yDAAyD;QACzD,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,CAAC;QAE7D,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,yBAAyB;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI;gBACxB,CAAC,CAAC,IAAI,CAAC,IAAI;oBACT,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;oBAC7B,CAAC,CAAC,IAAI,CAAC,IAAI;gBACb,CAAC,CAAC,EAAE,CAAC;YACP,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAEf,UAAU;YACV,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAEhC,4CAA4C;YAC5C,IAAI,SAAS,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;gBAClC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;oBACxC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI;wBAC5B,CAAC,CAAC,IAAI,CAAC,IAAI;4BACT,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG;4BAChC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,GAAG;wBACrB,CAAC,CAAC,EAAE,CAAC;oBACP,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,GAAG,YAAY,EAAE,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YAED,0BAA0B;YAC1B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACjD,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QAED,4BAA4B;QAC5B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAED,8CAA8C;QAC9C,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;YAC3F,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC/D,CAAC;QAED,kEAAkE;QAClE,IAAI,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;YAC3D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,eAAe,kDAAkD,CAAC,CAAC;QAC7F,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,WAAyB,EAAE,OAAsB;QAClE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAE3C,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YAE/D,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACK,UAAU,CAAC,WAAyB,EAAE,OAAsB;QAClE,MAAM,MAAM,GAGR;YACF,WAAW;SACZ,CAAC;QAEF,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;YAC3B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACK,SAAS,CAAC,WAAyB;QACzC,MAAM,MAAM,GAAG,yDAAyD,CAAC;QACzE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAC/B;YACE,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,IAAI,IAAI,EAAE;YACZ,CAAC,CAAC,IAAI,IAAI,EAAE;YACZ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;YACzB,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,KAAK;YACP,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE;SACjD,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ,CAAC;QACF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAgC;QACtD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,OAAO;gBACV,OAAO,SAAS,CAAC;YACnB,KAAK,OAAO;gBACV,OAAO,SAAS,CAAC;YACnB,KAAK,SAAS;gBACZ,OAAO,QAAQ,CAAC;YAClB,KAAK,MAAM;gBACT,OAAO,QAAQ,CAAC;YAClB;gBACE,OAAO,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAgB;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;QACvC,CAAC;QACD,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACK,SAAS,CAAC,KAAa;QAC7B,uDAAuD;QACvD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,OAAO,GAAG,CAAC;IACxB,CAAC;CACF"}

package/dist/diagnostics/DiagnosticWriter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * DiagnosticWriter - Writes diagnostics to .grafema/diagnostics.log
+ *
+ * Writes diagnostics in JSON lines format (one JSON object per line).
+ * This format is:
+ * - Easy to parse line-by-line
+ * - Appendable without reading entire file
+ * - Compatible with streaming tools (grep, jq, etc.)
+ *
+ * Usage:
+ *   const writer = new DiagnosticWriter();
+ *   await writer.write(collector, '/project/.grafema');
+ */
+import type { DiagnosticCollector } from './DiagnosticCollector.js';
+/**
+ * DiagnosticWriter - writes diagnostics.log file
+ */
+export declare class DiagnosticWriter {
+    /**
+     * Write all diagnostics to .grafema/diagnostics.log
+     *
+     * Creates the directory if it doesn't exist.
+     * Overwrites existing file.
+     */
+    write(collector: DiagnosticCollector, grafemaDir: string): Promise<void>;
+    /**
+     * Get the path to the diagnostics.log file
+     */
+    getLogPath(grafemaDir: string): string;
+}
+//# sourceMappingURL=DiagnosticWriter.d.ts.map

package/dist/diagnostics/DiagnosticWriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticWriter.d.ts","sourceRoot":"","sources":["../../src/diagnostics/DiagnosticWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;GAEG;AACH,qBAAa,gBAAgB;IAC3B;;;;;OAKG;IACG,KAAK,CAAC,SAAS,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9E;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAGvC"}

package/dist/diagnostics/DiagnosticWriter.js

@@ -0,0 +1,44 @@
+/**
+ * DiagnosticWriter - Writes diagnostics to .grafema/diagnostics.log
+ *
+ * Writes diagnostics in JSON lines format (one JSON object per line).
+ * This format is:
+ * - Easy to parse line-by-line
+ * - Appendable without reading entire file
+ * - Compatible with streaming tools (grep, jq, etc.)
+ *
+ * Usage:
+ *   const writer = new DiagnosticWriter();
+ *   await writer.write(collector, '/project/.grafema');
+ */
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+/**
+ * DiagnosticWriter - writes diagnostics.log file
+ */
+export class DiagnosticWriter {
+    /**
+     * Write all diagnostics to .grafema/diagnostics.log
+     *
+     * Creates the directory if it doesn't exist.
+     * Overwrites existing file.
+     */
+    async write(collector, grafemaDir) {
+        const logPath = this.getLogPath(grafemaDir);
+        // Create directory if it doesn't exist
+        const dir = dirname(logPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Write diagnostics as JSON lines
+        const content = collector.toDiagnosticsLog();
+        writeFileSync(logPath, content, 'utf-8');
+    }
+    /**
+     * Get the path to the diagnostics.log file
+     */
+    getLogPath(grafemaDir) {
+        return join(grafemaDir, 'diagnostics.log');
+    }
+}
+//# sourceMappingURL=DiagnosticWriter.js.map

package/dist/diagnostics/DiagnosticWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiagnosticWriter.js","sourceRoot":"","sources":["../../src/diagnostics/DiagnosticWriter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAIrC;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAC3B;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,SAA8B,EAAE,UAAkB;QAC5D,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAE5C,uCAAuC;QACvC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,kCAAkC;QAClC,MAAM,OAAO,GAAG,SAAS,CAAC,gBAAgB,EAAE,CAAC;QAC7C,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,UAAkB;QAC3B,OAAO,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC;IAC7C,CAAC;CACF"}