projscan 4.3.1 → 4.5.0

package/dist/reporters/markdownAuditReporter.js

@@ -0,0 +1,27 @@
+export function reportAuditMarkdown(report) {
+    const lines = [];
+    lines.push('# Vulnerability Audit');
+    lines.push('');
+    if (!report.available) {
+        lines.push(`_${report.reason ?? 'audit unavailable'}_`);
+        console.log(lines.join('\n'));
+        return;
+    }
+    const s = report.summary;
+    const total = s.critical + s.high + s.moderate + s.low + s.info;
+    lines.push(`**${total}** findings - ${s.critical} critical · ${s.high} high · ${s.moderate} moderate · ${s.low} low · ${s.info} info`);
+    lines.push('');
+    if (report.findings.length === 0) {
+        lines.push('_No known vulnerabilities._');
+        console.log(lines.join('\n'));
+        return;
+    }
+    lines.push('| Severity | Package | Title | Fix |');
+    lines.push('| --- | --- | --- | --- |');
+    for (const f of report.findings) {
+        const title = f.url ? `[${f.title}](${f.url})` : f.title;
+        lines.push(`| ${f.severity} | \`${f.name}\` | ${title} | ${f.fixAvailable ? 'yes' : 'no'} |`);
+    }
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=markdownAuditReporter.js.map

package/dist/reporters/markdownAuditReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownAuditReporter.js","sourceRoot":"","sources":["../../src/reporters/markdownAuditReporter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,mBAAmB,CAAC,MAAmB;IACrD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACpC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,mBAAmB,GAAG,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;IACzB,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;IAChE,KAAK,CAAC,IAAI,CACR,KAAK,KAAK,iBAAiB,CAAC,CAAC,QAAQ,eAAe,CAAC,CAAC,IAAI,WAAW,CAAC,CAAC,QAAQ,eAAe,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,OAAO,CAC3H,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9B,OAAO;IACT,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,QAAQ,CAAC,CAAC,IAAI,QAAQ,KAAK,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAChG,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/reporters/markdownDependencyReporter.d.ts

@@ -0,0 +1,2 @@
+import type { DependencyReport } from '../types.js';
+export declare function reportDependenciesMarkdown(report: DependencyReport): void;

package/dist/reporters/markdownDependencyReporter.js

@@ -0,0 +1,33 @@
+export function reportDependenciesMarkdown(report) {
+    const lines = ['# Dependency Report', ''];
+    lines.push(`- Production: **${report.totalDependencies}** packages`);
+    lines.push(`- Development: **${report.totalDevDependencies}** packages`);
+    if (report.licenses) {
+        lines.push('');
+        lines.push('## License Summary');
+        lines.push(`- Known: **${report.licenses.packages.length - report.licenses.unknown.length}**`);
+        lines.push(`- Unknown: **${report.licenses.unknown.length}**`);
+        lines.push(`- Copyleft: **${report.licenses.copyleft.length}**`);
+        for (const [license, count] of Object.entries(report.licenses.byLicense)) {
+            lines.push(`- ${license}: ${count}`);
+        }
+    }
+    if (report.sizes && report.sizes.largest.length > 0) {
+        lines.push('');
+        lines.push('## Installed Package Sizes');
+        lines.push(`- Total: **${report.sizes.formattedTotal}**`);
+        lines.push(`- Missing: **${report.sizes.missing.length}**`);
+        for (const entry of report.sizes.largest) {
+            lines.push(`- \`${entry.name}\` ${entry.version}: ${entry.formatted} (${entry.scope})`);
+        }
+    }
+    if (report.risks.length > 0) {
+        lines.push('');
+        lines.push('## Risks');
+        for (const risk of report.risks) {
+            lines.push(`- **${risk.name}**: ${risk.reason} (${risk.severity})`);
+        }
+    }
+    console.log(lines.join('\n'));
+}
+//# sourceMappingURL=markdownDependencyReporter.js.map

package/dist/reporters/markdownDependencyReporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownDependencyReporter.js","sourceRoot":"","sources":["../../src/reporters/markdownDependencyReporter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,0BAA0B,CAAC,MAAwB;IACjE,MAAM,KAAK,GAAa,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,iBAAiB,aAAa,CAAC,CAAC;IACrE,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,oBAAoB,aAAa,CAAC,CAAC;IAEzE,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/F,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC/D,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;QACjE,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzE,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,KAAK,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC;QAC5D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAChC,CAAC"}

package/dist/reporters/markdownDiffReporter.d.ts

@@ -0,0 +1,2 @@
+import type { DiffResult } from '../types.js';
+export declare function reportDiffMarkdown(diff: DiffResult): void;

package/dist/reporters/markdownDiffReporter.js

@@ -0,0 +1,65 @@
+export function reportDiffMarkdown(diff) {
+    const delta = diff.scoreDelta > 0 ? `+${diff.scoreDelta}` : String(diff.scoreDelta);
+    const arrow = diff.scoreDelta > 0 ? '↑' : diff.scoreDelta < 0 ? '↓' : '-';
+    const lines = [
+        '# Health Diff',
+        '',
+        '| Metric | Before | After | Delta |',
+        '| --- | --- | --- | --- |',
+        `| Score | ${diff.before.score} | ${diff.after.score} | ${delta} ${arrow} |`,
+        `| Grade | ${diff.before.grade} | ${diff.after.grade} | |`,
+    ];
+    appendIssueSections(lines, diff);
+    appendHotspotSections(lines, diff);
+    console.log(lines.join('\n'));
+}
+function appendIssueSections(lines, diff) {
+    if (diff.resolvedIssues.length > 0) {
+        lines.push('', '## Resolved', '');
+        for (const title of diff.resolvedIssues) {
+            lines.push(`- ✅ ${title}`);
+        }
+    }
+    if (diff.newIssues.length > 0) {
+        lines.push('', '## New Issues', '');
+        for (const title of diff.newIssues) {
+            lines.push(`- ❌ ${title}`);
+        }
+    }
+}
+function appendHotspotSections(lines, diff) {
+    if (!diff.hotspotDiff)
+        return;
+    const hd = diff.hotspotDiff;
+    if (hd.rose.length > 0)
+        appendRoseSection(lines, hd.rose);
+    if (hd.appeared.length > 0)
+        appendAppearedSection(lines, hd.appeared);
+    if (hd.fell.length > 0)
+        appendFellSection(lines, hd.fell);
+}
+function appendRoseSection(lines, rose) {
+    lines.push('', '## Hotspots Worsening', '');
+    lines.push('| File | Before | After | Δ |');
+    lines.push('| --- | ---: | ---: | ---: |');
+    for (const d of rose) {
+        lines.push(`| \`${d.relativePath}\` | ${d.beforeScore?.toFixed(1)} | ${d.afterScore?.toFixed(1)} | +${d.scoreDelta.toFixed(1)} |`);
+    }
+}
+function appendAppearedSection(lines, appeared) {
+    lines.push('', '## Newly Risky Files', '');
+    lines.push('| File | Score |');
+    lines.push('| --- | ---: |');
+    for (const d of appeared) {
+        lines.push(`| \`${d.relativePath}\` | ${d.afterScore?.toFixed(1)} |`);
+    }
+}
+function appendFellSection(lines, fell) {
+    lines.push('', '## Hotspots Improving', '');
+    lines.push('| File | Before | After | Δ |');
+    lines.push('| --- | ---: | ---: | ---: |');
+    for (const d of fell) {
+        lines.push(`| \`${d.relativePath}\` | ${d.beforeScore?.toFixed(1)} | ${d.afterScore?.toFixed(1)} | ${d.scoreDelta.toFixed(1)} |`);
+    }
+}
+//# sourceMappingURL=markdownDiffReporter.js.map

package/dist/reporters/markdownDiffReporter.js.map

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

package/dist/reporters/markdownFileReporter.d.ts

@@ -0,0 +1,2 @@
+import type { FileInspection } from '../types.js';
+export declare function reportFileMarkdown(insp: FileInspection): void;

package/dist/reporters/markdownFileReporter.js

@@ -0,0 +1,92 @@
+export function reportFileMarkdown(insp) {
+    const lines = [`# File: ${insp.relativePath}`, ''];
+    if (!insp.exists) {
+        lines.push(`> ${insp.reason ?? 'File unavailable.'}`);
+        console.log(lines.join('\n'));
+        return;
+    }
+    appendFileSummary(lines, insp);
+    appendFileHotspot(lines, insp);
+    appendFileIssues(lines, insp);
+    appendFilePotentialIssues(lines, insp);
+    appendFileImports(lines, insp);
+    appendFileExports(lines, insp);
+    appendFileFunctions(lines, insp);
+    console.log(lines.join('\n'));
+}
+function appendFileSummary(lines, insp) {
+    lines.push(`**Purpose:** ${insp.purpose}`);
+    lines.push(`**Lines:** ${insp.lineCount}  |  **Size:** ${insp.sizeBytes} B`);
+    if (typeof insp.cyclomaticComplexity === 'number') {
+        lines.push(`**Cyclomatic complexity:** ${insp.cyclomaticComplexity}`);
+    }
+    if (typeof insp.fanIn === 'number' || typeof insp.fanOut === 'number') {
+        lines.push(`**Coupling:** fan-in ${insp.fanIn ?? '-'}, fan-out ${insp.fanOut ?? '-'}`);
+    }
+}
+function appendFileHotspot(lines, insp) {
+    if (!insp.hotspot)
+        return;
+    const h = insp.hotspot;
+    lines.push('', '## Risk', '');
+    lines.push(`- **Risk score:** ${h.riskScore.toFixed(1)}`);
+    lines.push(`- **Commits:** ${h.churn}`);
+    const primary = h.primaryAuthor
+        ? ` (primary: ${h.primaryAuthor}, ${Math.round(h.primaryAuthorShare * 100)}%)`
+        : '';
+    lines.push(`- **Authors:** ${h.distinctAuthors}${primary}`);
+    if (h.daysSinceLastChange !== null) {
+        lines.push(`- **Last change:** ${h.daysSinceLastChange} days ago`);
+    }
+    if (h.busFactorOne)
+        lines.push('- ⚠️ **Bus factor 1** - only one author has touched this.');
+    if (h.reasons.length > 0)
+        lines.push(`- ${h.reasons.join(', ')}`);
+}
+function appendFileIssues(lines, insp) {
+    if (insp.issues.length === 0)
+        return;
+    lines.push('', '## Related Issues', '');
+    for (const issue of insp.issues) {
+        const icon = issue.severity === 'error' ? '❌' : issue.severity === 'warning' ? '⚠️' : 'ℹ️';
+        lines.push(`- ${icon} **${issue.title}** - ${issue.description}`);
+    }
+}
+function appendFilePotentialIssues(lines, insp) {
+    if (insp.potentialIssues.length === 0)
+        return;
+    lines.push('', '## Potential Issues', '');
+    for (const issue of insp.potentialIssues)
+        lines.push(`- ⚠️ ${issue}`);
+}
+function appendFileImports(lines, insp) {
+    if (insp.imports.length === 0)
+        return;
+    lines.push('', '## Dependencies', '');
+    for (const imp of insp.imports) {
+        lines.push(`- \`${imp.source}\`${imp.isRelative ? ' (local)' : ''}`);
+    }
+}
+function appendFileExports(lines, insp) {
+    if (insp.exports.length === 0)
+        return;
+    lines.push('', '## Exports', '');
+    for (const exp of insp.exports) {
+        lines.push(`- \`${exp.name}\` (${exp.type})`);
+    }
+}
+function appendFileFunctions(lines, insp) {
+    if (!insp.functions || insp.functions.length === 0)
+        return;
+    lines.push('', '## Functions (top by CC)', '');
+    lines.push('| CC | Fan-in | Name | Lines |');
+    lines.push('| ---: | ---: | --- | --- |');
+    for (const fn of insp.functions.slice(0, 20)) {
+        const fi = typeof fn.fanIn === 'number' ? String(fn.fanIn) : '-';
+        lines.push(`| ${fn.cyclomaticComplexity} | ${fi} | \`${fn.name}\` | L${fn.line}-${fn.endLine} |`);
+    }
+    if (insp.functions.length > 20) {
+        lines.push('', `_... and ${insp.functions.length - 20} more_`);
+    }
+}
+//# sourceMappingURL=markdownFileReporter.js.map

package/dist/reporters/markdownFileReporter.js.map

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

package/dist/reporters/markdownFixGuidanceReporter.d.ts

@@ -0,0 +1,8 @@
+import type { FixSuggestion, IssueExplanation } from '../types.js';
+export declare function reportFixSuggestMarkdown(result: {
+    matched: boolean;
+    fix?: FixSuggestion;
+    reason?: string;
+    synthetic?: boolean;
+}): void;
+export declare function reportExplainIssueMarkdown(e: IssueExplanation): void;

package/dist/reporters/markdownFixGuidanceReporter.js

@@ -0,0 +1,95 @@
+export function reportFixSuggestMarkdown(result) {
+    const lines = ['# Fix Suggestion', ''];
+    if (!result.matched || !result.fix) {
+        lines.push(`> ${result.reason ?? 'No suggestion available.'}`);
+        console.log(lines.join('\n'));
+        return;
+    }
+    appendFixSuggestion(lines, result.fix, result.synthetic === true);
+    console.log(lines.join('\n'));
+}
+function appendFixSuggestion(lines, fix, synthetic) {
+    appendFixIntro(lines, fix, synthetic);
+    appendFixWhere(lines, fix);
+    appendFixAction(lines, fix);
+    appendFixRelatedFiles(lines, fix);
+    appendFixReferences(lines, fix);
+}
+function appendFixIntro(lines, fix, synthetic) {
+    lines.push(`**${fix.headline}**`, '');
+    lines.push(`_severity: ${fix.severity} · category: ${fix.category} · issue: \`${fix.issueId}\`${synthetic ? ' (synthetic)' : ''}_`, '');
+    lines.push('## Why', '', fix.why, '');
+}
+function appendFixWhere(lines, fix) {
+    if (fix.where.length > 0) {
+        lines.push('## Where', '');
+        for (const w of fix.where) {
+            const loc = w.line ? `${w.file}:${w.line}` : w.file;
+            lines.push(`- \`${loc}\``);
+        }
+        lines.push('');
+    }
+}
+function appendFixAction(lines, fix) {
+    lines.push('## Action', '', fix.instruction, '');
+    if (fix.suggestedTest)
+        lines.push('## Verify', '', fix.suggestedTest, '');
+}
+function appendFixRelatedFiles(lines, fix) {
+    if (fix.relatedFiles && fix.relatedFiles.length > 0) {
+        lines.push('## Related files', '');
+        for (const f of fix.relatedFiles)
+            lines.push(`- \`${f}\``);
+        lines.push('');
+    }
+}
+function appendFixReferences(lines, fix) {
+    if (fix.references && fix.references.length > 0) {
+        lines.push('## References', '');
+        for (const r of fix.references)
+            lines.push(`- ${r}`);
+        lines.push('');
+    }
+}
+export function reportExplainIssueMarkdown(e) {
+    const lines = [`# Issue: ${e.title}`, ''];
+    lines.push(`_severity: ${e.severity} · category: ${e.category} · id: \`${e.issueId}\`_`, '');
+    lines.push(`**${e.headline}**`, '');
+    appendIssueExcerpt(lines, e);
+    appendIssueRelatedIssues(lines, e);
+    appendIssueSimilarFixes(lines, e);
+    appendIssueSuggestedAction(lines, e);
+    console.log(lines.join('\n'));
+}
+function appendIssueExcerpt(lines, e) {
+    if (e.excerpt) {
+        lines.push(`## Code (\`${e.excerpt.file}\` L${e.excerpt.startLine}-${e.excerpt.endLine})`, '', '```');
+        for (const l of e.excerpt.lines)
+            lines.push(l);
+        lines.push('```', '');
+    }
+}
+function appendIssueRelatedIssues(lines, e) {
+    if (e.relatedIssues.length > 0) {
+        lines.push('## Related issues in the same area', '');
+        for (const r of e.relatedIssues)
+            lines.push(`- \`${r.id}\`: ${r.title}`);
+        lines.push('');
+    }
+}
+function appendIssueSimilarFixes(lines, e) {
+    if (e.similarFixes.length > 0) {
+        lines.push('## Past commits referencing this rule', '');
+        for (const f of e.similarFixes)
+            lines.push(`- ${f.sha.slice(0, 7)} (${f.date}) ${f.subject}`);
+        lines.push('');
+    }
+}
+function appendIssueSuggestedAction(lines, e) {
+    if (e.fix) {
+        lines.push('## Suggested action', '', e.fix.instruction, '');
+        if (e.fix.suggestedTest)
+            lines.push('**Verify:** ' + e.fix.suggestedTest, '');
+    }
+}
+//# sourceMappingURL=markdownFixGuidanceReporter.js.map

package/dist/reporters/markdownFixGuidanceReporter.js.map

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

package/dist/reporters/markdownImpactReporter.d.ts

@@ -0,0 +1,2 @@
+import type { ImpactReport } from '../types.js';
+export declare function reportImpactMarkdown(report: ImpactReport): void;

package/dist/reporters/markdownImpactReporter.js

@@ -0,0 +1,52 @@
+export function reportImpactMarkdown(report) {
+    const lines = [`# Impact: ${report.target.kind} \`${report.target.value}\``, ''];
+    if (!report.available) {
+        appendUnavailableImpact(lines, report);
+    }
+    else {
+        appendAvailableImpact(lines, report);
+    }
+    console.log(lines.join('\n'));
+}
+function appendUnavailableImpact(lines, report) {
+    lines.push(`> ${report.reason ?? 'Impact unavailable.'}`);
+}
+function appendAvailableImpact(lines, report) {
+    appendSymbolImpactDetails(lines, report);
+    appendReachableSummary(lines, report);
+    appendReachableFiles(lines, report);
+}
+function appendSymbolImpactDetails(lines, report) {
+    if (report.target.kind !== 'symbol')
+        return;
+    lines.push(`_definitions: ${report.definitionFiles.length} · direct callers: ${report.directCallers.length}_`, '');
+    appendDefinitionFiles(lines, report);
+}
+function appendDefinitionFiles(lines, report) {
+    if (report.definitionFiles.length === 0)
+        return;
+    lines.push('## Defined in', '');
+    for (const f of report.definitionFiles)
+        lines.push(`- \`${f}\``);
+    lines.push('');
+}
+function appendReachableSummary(lines, report) {
+    lines.push(`**${report.totalReachable}** file(s) reachable within distance ${report.maxDistance}${report.truncated ? ' (truncated; more files exist beyond)' : ''}.`, '');
+}
+function appendReachableFiles(lines, report) {
+    if (report.reachable.length === 0) {
+        lines.push('_No reachable files._');
+        return;
+    }
+    lines.push('| Distance | File |', '| ---: | --- |');
+    for (const n of report.reachable.slice(0, 200)) {
+        lines.push(`| ${n.distance} | \`${n.file}\` |`);
+    }
+    appendReachableOverflow(lines, report);
+}
+function appendReachableOverflow(lines, report) {
+    if (report.reachable.length > 200) {
+        lines.push('', `_... and ${report.reachable.length - 200} more_`);
+    }
+}
+//# sourceMappingURL=markdownImpactReporter.js.map

package/dist/reporters/markdownImpactReporter.js.map

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

package/dist/reporters/markdownReporter.d.ts

@@ -1,27 +1,21 @@
-import type { AnalysisReport, AuditReport, CoverageJoinedReport, CouplingReport, Issue, FileExplanation, FileInspection, ArchitectureLayer, DirectoryNode, DependencyReport, DiffResult, HotspotReport, OutdatedReport, PrDiffReport, ReviewReport, FixSuggestion, ImpactReport, IssueExplanation, UpgradePreview, WorkspaceInfo } from '../types.js';
-export declare function reportAnalysisMarkdown(report: AnalysisReport): void;
+import type { CoverageJoinedReport, CouplingReport, Issue, FileExplanation, ArchitectureLayer, DirectoryNode, HotspotReport, OutdatedReport, PrDiffReport, WorkspaceInfo } from '../types.js';
+export { reportDiffMarkdown } from './markdownDiffReporter.js';
+export { reportFileMarkdown } from './markdownFileReporter.js';
+export { reportReviewMarkdown } from './markdownReviewReporter.js';
+export { reportDependenciesMarkdown } from './markdownDependencyReporter.js';
+export { reportExplainIssueMarkdown, reportFixSuggestMarkdown, } from './markdownFixGuidanceReporter.js';
+export { reportImpactMarkdown } from './markdownImpactReporter.js';
+export { reportUpgradeMarkdown } from './markdownUpgradeReporter.js';
+export { reportAuditMarkdown } from './markdownAuditReporter.js';
+export { reportAnalysisMarkdown } from './markdownAnalysisReporter.js';
 export declare function reportHealthMarkdown(issues: Issue[]): void;
 export declare function reportCiMarkdown(issues: Issue[], threshold: number): void;
-export declare function reportDiffMarkdown(diff: DiffResult): void;
 export declare function reportExplanationMarkdown(explanation: FileExplanation): void;
 export declare function reportDiagramMarkdown(layers: ArchitectureLayer[]): void;
 export declare function reportStructureMarkdown(tree: DirectoryNode): void;
-export declare function reportDependenciesMarkdown(report: DependencyReport): void;
-export declare function reportFileMarkdown(insp: FileInspection): void;
 export declare function reportHotspotsMarkdown(report: HotspotReport): void;
 export declare function reportCouplingMarkdown(report: CouplingReport): void;
 export declare function reportPrDiffMarkdown(report: PrDiffReport): void;
-export declare function reportImpactMarkdown(report: ImpactReport): void;
-export declare function reportFixSuggestMarkdown(result: {
-    matched: boolean;
-    fix?: FixSuggestion;
-    reason?: string;
-    synthetic?: boolean;
-}): void;
-export declare function reportExplainIssueMarkdown(e: IssueExplanation): void;
-export declare function reportReviewMarkdown(report: ReviewReport): void;
 export declare function reportWorkspacesMarkdown(info: WorkspaceInfo): void;
 export declare function reportOutdatedMarkdown(report: OutdatedReport): void;
-export declare function reportAuditMarkdown(report: AuditReport): void;
-export declare function reportUpgradeMarkdown(preview: UpgradePreview): void;
 export declare function reportCoverageMarkdown(report: CoverageJoinedReport): void;