@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/report/human-check.js

@@ -0,0 +1,249 @@
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+function col(c, t) { return `${c}${t}${RESET}`; }
+function dim(t) { return col(DIM, t); }
+function bold(t) { return col(BOLD, t); }
+const MAX_FLAT = 10;
+const MAX_GROUPED_FILES = 10;
+const MAX_ITEMS_PER_FILE = 5;
+const SCOPING_THRESHOLD = 500;
+function truncHint(remaining, total) {
+    if (remaining > SCOPING_THRESHOLD || total > SCOPING_THRESHOLD) {
+        return dim(`... and ${remaining} more — try --workspace <name> or --changed-since main to scope`);
+    }
+    return dim(`... and ${remaining} more (--format json for full list)`);
+}
+function sectionHeader(title, count, level = 'error') {
+    const bullet = level === 'error' ? col(RED, '●') : level === 'warn' ? col(YELLOW, '●') : col(CYAN, '●');
+    return `${bullet} ${bold(`${title} (${count})`)}`;
+}
+function categoryHeader(label) {
+    const bar = '─'.repeat(37);
+    return dim(`── ${label} ${bar}`);
+}
+export function formatUnusedFiles(files, opts = {}) {
+    if (files.length === 0)
+        return [];
+    const max = opts.maxFlatItems ?? opts.top ?? MAX_FLAT;
+    const total = files.length;
+    const lines = [sectionHeader('Unused files', total)];
+    const shown = files.slice(0, max);
+    for (const f of shown) {
+        lines.push(`  ${f.filePath}`);
+    }
+    if (total > max) {
+        lines.push(`  ${truncHint(total - max, total)}`);
+    }
+    lines.push('');
+    return lines;
+}
+function groupByFile(items) {
+    const map = new Map();
+    for (const item of items) {
+        const arr = map.get(item.filePath) ?? [];
+        arr.push(item);
+        map.set(item.filePath, arr);
+    }
+    return map;
+}
+export function formatUnusedExports(exports, opts = {}) {
+    if (exports.length === 0)
+        return [];
+    const maxFiles = opts.maxGroupedFiles ?? opts.top ?? MAX_GROUPED_FILES;
+    const maxPerFile = opts.maxItemsPerFile ?? MAX_ITEMS_PER_FILE;
+    const total = exports.length;
+    const lines = [sectionHeader('Unused exports', total)];
+    const byFile = groupByFile(exports);
+    const sorted = [...byFile.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    const shownFiles = sorted.slice(0, maxFiles);
+    for (const [filePath, items] of shownFiles) {
+        lines.push(`  ${filePath}`);
+        const shownItems = items.slice(0, maxPerFile);
+        for (const e of shownItems) {
+            const tag = e.isReExport ? dim(' (re-export)') : '';
+            lines.push(`    ${dim(`:${e.line}`)} ${bold(e.exportName)}${tag}`);
+        }
+        if (items.length > maxPerFile) {
+            lines.push(`    ${dim(`... and ${items.length - maxPerFile} more`)}`);
+        }
+    }
+    const hiddenFiles = sorted.length - shownFiles.length;
+    if (hiddenFiles > 0) {
+        const hiddenItems = sorted.slice(maxFiles).reduce((s, [, v]) => s + v.length, 0);
+        lines.push(`  ${dim(`... and ${hiddenItems} more in ${hiddenFiles} file${hiddenFiles === 1 ? '' : 's'}`)}`);
+    }
+    lines.push('');
+    return lines;
+}
+export function formatUnusedDeps(deps) {
+    if (deps.length === 0)
+        return [];
+    const lines = [sectionHeader('Unused dependencies', deps.length)];
+    for (const d of deps) {
+        const workspaces = d.usedInWorkspaces.length > 0
+            ? dim(` (imported in ${d.usedInWorkspaces.join(', ')})`)
+            : '';
+        lines.push(`  ${bold(d.name)}${workspaces}`);
+    }
+    lines.push('');
+    return lines;
+}
+export function formatUnusedMembers(members, title = 'Unused class members') {
+    if (members.length === 0)
+        return [];
+    const total = members.length;
+    const lines = [sectionHeader(title, total)];
+    const byFile = groupByFile(members);
+    const sorted = [...byFile.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    const shownFiles = sorted.slice(0, MAX_GROUPED_FILES);
+    for (const [filePath, items] of shownFiles) {
+        lines.push(`  ${filePath}`);
+        for (const m of items.slice(0, MAX_ITEMS_PER_FILE)) {
+            lines.push(`    ${dim(`:${m.line}`)} ${bold(`${m.parentName}.${m.memberName}`)}`);
+        }
+        if (items.length > MAX_ITEMS_PER_FILE) {
+            lines.push(`    ${dim(`... and ${items.length - MAX_ITEMS_PER_FILE} more`)}`);
+        }
+    }
+    const hiddenFiles = sorted.length - shownFiles.length;
+    if (hiddenFiles > 0) {
+        const hiddenItems = sorted.slice(MAX_GROUPED_FILES).reduce((s, [, v]) => s + v.length, 0);
+        lines.push(`  ${dim(`... and ${hiddenItems} more in ${hiddenFiles} file${hiddenFiles === 1 ? '' : 's'}`)}`);
+    }
+    lines.push('');
+    return lines;
+}
+export function formatUnresolvedImports(imports) {
+    if (imports.length === 0)
+        return [];
+    const total = imports.length;
+    const lines = [sectionHeader('Unresolved imports', total)];
+    const byFile = groupByFile(imports);
+    const sorted = [...byFile.entries()].sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+    const shownFiles = sorted.slice(0, MAX_GROUPED_FILES);
+    for (const [filePath, items] of shownFiles) {
+        lines.push(`  ${filePath}`);
+        for (const i of items.slice(0, MAX_ITEMS_PER_FILE)) {
+            lines.push(`    ${dim(`:${i.line}`)} ${bold(i.specifier)}`);
+        }
+        if (items.length > MAX_ITEMS_PER_FILE) {
+            lines.push(`    ${dim(`... and ${items.length - MAX_ITEMS_PER_FILE} more`)}`);
+        }
+    }
+    const hiddenFiles = sorted.length - shownFiles.length;
+    if (hiddenFiles > 0) {
+        const hiddenItems = sorted.slice(MAX_GROUPED_FILES).reduce((s, [, v]) => s + v.length, 0);
+        lines.push(`  ${dim(`... and ${hiddenItems} more in ${hiddenFiles} file${hiddenFiles === 1 ? '' : 's'}`)}`);
+    }
+    lines.push('');
+    return lines;
+}
+export function buildCheckHumanLines(results, opts = {}) {
+    const lines = [];
+    const unusedFileSet = new Set(results.unusedFiles.map(f => f.filePath));
+    const filteredExports = results.unusedExports.filter(e => !unusedFileSet.has(e.filePath));
+    const filteredTypes = results.unusedTypes.filter(e => !unusedFileSet.has(e.filePath));
+    const hasUnusedCode = results.unusedFiles.length > 0 ||
+        filteredExports.length > 0 ||
+        filteredTypes.length > 0 ||
+        results.unusedEnumMembers.length > 0 ||
+        results.unusedClassMembers.length > 0;
+    const hasDeps = results.unusedDependencies.length > 0 ||
+        results.unusedDevDependencies.length > 0 ||
+        results.unresolvedImports.length > 0 ||
+        results.unlistedDependencies.length > 0 ||
+        results.typeOnlyDependencies.length > 0 ||
+        results.testOnlyDependencies.length > 0;
+    const hasStructure = results.duplicateExports.length > 0 ||
+        results.circularDependencies.length > 0 ||
+        results.boundaryViolations.length > 0;
+    if (hasUnusedCode) {
+        lines.push(categoryHeader('Unused Code'));
+        lines.push('');
+        lines.push(...formatUnusedFiles(results.unusedFiles, opts));
+        lines.push(...formatUnusedExports(filteredExports, opts));
+        if (filteredTypes.length > 0) {
+            const typeLines = formatUnusedExports(filteredTypes, opts);
+            if (typeLines.length > 0) {
+                typeLines[0] = sectionHeader('Unused type exports', filteredTypes.length);
+            }
+            lines.push(...typeLines);
+        }
+        lines.push(...formatUnusedMembers(results.unusedEnumMembers, 'Unused enum members'));
+        lines.push(...formatUnusedMembers(results.unusedClassMembers, 'Unused class members'));
+    }
+    if (hasDeps) {
+        lines.push(categoryHeader('Dependencies'));
+        lines.push('');
+        lines.push(...formatUnusedDeps(results.unusedDependencies));
+        if (results.unusedDevDependencies.length > 0) {
+            const devLines = formatUnusedDeps(results.unusedDevDependencies);
+            if (devLines.length > 0)
+                devLines[0] = sectionHeader('Unused devDependencies', results.unusedDevDependencies.length);
+            lines.push(...devLines);
+        }
+        lines.push(...formatUnresolvedImports(results.unresolvedImports));
+        if (results.unlistedDependencies.length > 0) {
+            lines.push(sectionHeader('Unlisted dependencies', results.unlistedDependencies.length));
+            for (const d of results.unlistedDependencies) {
+                lines.push(`  ${bold(d.name)}`);
+            }
+            lines.push('');
+        }
+        if (results.typeOnlyDependencies.length > 0) {
+            lines.push(sectionHeader('Type-only dependencies (consider moving to devDependencies)', results.typeOnlyDependencies.length));
+            for (const d of results.typeOnlyDependencies) {
+                lines.push(`  ${bold(d.name)}`);
+            }
+            lines.push('');
+        }
+        if (results.testOnlyDependencies.length > 0) {
+            lines.push(sectionHeader('Test-only production dependencies (consider moving to devDependencies)', results.testOnlyDependencies.length));
+            for (const d of results.testOnlyDependencies) {
+                lines.push(`  ${bold(d.name)}`);
+            }
+            lines.push('');
+        }
+    }
+    if (hasStructure) {
+        lines.push(categoryHeader('Structure'));
+        lines.push('');
+        if (results.duplicateExports.length > 0) {
+            lines.push(sectionHeader('Duplicate exports', results.duplicateExports.length));
+            for (const dup of results.duplicateExports.slice(0, MAX_FLAT)) {
+                const locs = dup.locations.map(l => `${l.filePath}:${l.line}`).join(' ↔ ');
+                lines.push(`  ${bold(dup.exportName)}  ${dim(locs)}`);
+            }
+            lines.push('');
+        }
+        if (results.circularDependencies.length > 0) {
+            lines.push(sectionHeader('Circular dependencies', results.circularDependencies.length));
+            for (const c of results.circularDependencies.slice(0, MAX_FLAT)) {
+                lines.push(`  ${c.cycle.join(dim(' → '))}`);
+            }
+            lines.push('');
+        }
+        if (results.boundaryViolations.length > 0) {
+            lines.push(sectionHeader('Boundary violations', results.boundaryViolations.length));
+            for (const v of results.boundaryViolations.slice(0, MAX_FLAT)) {
+                lines.push(`  ${v.fromPath}:${v.line} ${dim('→')} ${v.toPath} ${dim(`(${v.fromZone} → ${v.toZone})`)}`);
+            }
+            lines.push('');
+        }
+    }
+    if (results.staleSuppressions.length > 0) {
+        lines.push(categoryHeader('Maintenance'));
+        lines.push('');
+        lines.push(sectionHeader('Stale suppressions', results.staleSuppressions.length));
+        for (const s of results.staleSuppressions.slice(0, MAX_FLAT)) {
+            lines.push(`  ${s.filePath}:${s.commentLine}  ${dim(s.issueKind ?? 'unknown')}`);
+        }
+        lines.push('');
+    }
+    return lines;
+}
+//# sourceMappingURL=human-check.js.map

package/dist/src/report/human-check.js.map

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

package/dist/src/report/human-dupes.d.ts

@@ -0,0 +1,27 @@
+import type { PipelineDuplicationStats } from '../duplicates/detect/statistics.js';
+export interface HumanDupesOptions {
+    maxGroups?: number;
+    showSnippets?: boolean;
+}
+export interface CloneInstance {
+    filePath: string;
+    startLine: number;
+    endLine: number;
+}
+export interface CloneGroup {
+    id: number;
+    instances: CloneInstance[];
+    duplicatedLines: number;
+}
+export interface CloneFamily {
+    files: string[];
+    groups: CloneGroup[];
+    totalDuplicatedLines: number;
+    suggestions: Array<{
+        description: string;
+    }>;
+}
+export declare function formatCloneGroup(group: CloneGroup, idx: number): string[];
+export declare function buildDuplicationHumanLines(stats: PipelineDuplicationStats, groups: CloneGroup[], opts?: HumanDupesOptions): string[];
+export declare function buildDuplicationFamilyLines(families: CloneFamily[], opts?: HumanDupesOptions): string[];
+//# sourceMappingURL=human-dupes.d.ts.map

package/dist/src/report/human-dupes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-dupes.d.ts","sourceRoot":"","sources":["../../../src/report/human-dupes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAiBnF,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,KAAK,CAAC;QAAE,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7C;AAYD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAmBzE;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,EAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,EAAE,CAkCV;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,WAAW,EAAE,EACvB,IAAI,GAAE,iBAAsB,GAC3B,MAAM,EAAE,CA0BV"}

package/dist/src/report/human-dupes.js

@@ -0,0 +1,92 @@
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const DIM = '\x1b[2m';
+const RED = '\x1b[31m';
+const YELLOW = '\x1b[33m';
+const CYAN = '\x1b[36m';
+function col(c, t) { return `${c}${t}${RESET}`; }
+function dim(t) { return col(DIM, t); }
+function bold(t) { return col(BOLD, t); }
+const DOCS_DUPLICATION = 'https://docs.fallow.tools/explanations/duplication';
+const MAX_CLONE_GROUPS = 10;
+const MAX_FLAT = 10;
+function thousands(n) {
+    return n.toLocaleString('en-US');
+}
+function splitDirFilename(path) {
+    const idx = path.lastIndexOf('/');
+    if (idx < 0)
+        return ['', path];
+    return [path.slice(0, idx + 1), path.slice(idx + 1)];
+}
+export function formatCloneGroup(group, idx) {
+    const lines = [];
+    const lc = group.duplicatedLines;
+    const lcStr = thousands(lc).padStart(5);
+    const lcColored = lc > 1000
+        ? col(RED, col(BOLD, lcStr))
+        : lc > 100
+            ? col(YELLOW, lcStr)
+            : dim(lcStr);
+    const plural = group.instances.length === 1 ? 'instance' : 'instances';
+    lines.push(`  ${lcColored} lines  ${group.instances.length} ${plural}`);
+    for (const inst of group.instances) {
+        const [dir, filename] = splitDirFilename(inst.filePath);
+        lines.push(`    ${dim(dir)}${filename}:${inst.startLine}-${inst.endLine}`);
+    }
+    lines.push('');
+    return lines;
+}
+export function buildDuplicationHumanLines(stats, groups, opts = {}) {
+    if (groups.length === 0)
+        return [];
+    const lines = [];
+    const maxGroups = opts.maxGroups ?? MAX_CLONE_GROUPS;
+    const sorted = [...groups].sort((a, b) => b.duplicatedLines - a.duplicatedLines);
+    const totalGroups = sorted.length;
+    const shown = sorted.slice(0, maxGroups);
+    lines.push(`${col(CYAN, '●')} ${col(CYAN, col(BOLD, `Duplicates (${totalGroups} clone group${totalGroups === 1 ? '' : 's'})`))}`);
+    lines.push('');
+    for (let i = 0; i < shown.length; i++) {
+        lines.push(...formatCloneGroup(shown[i], i));
+    }
+    if (totalGroups > maxGroups) {
+        lines.push(`  ${dim(`... and ${totalGroups - maxGroups} more clone groups`)}`);
+    }
+    lines.push(`  ${dim(`Identical code blocks detected via suffix-array analysis — ${DOCS_DUPLICATION}#clone-groups`)}`);
+    lines.push('');
+    if (stats.duplicatedLines > 0) {
+        const pct = stats.duplicationPct.toFixed(1);
+        lines.push(`  ${dim(`Duplicated: ${thousands(stats.duplicatedLines)} lines (${pct}%), ${stats.cloneGroups} clone group${stats.cloneGroups === 1 ? '' : 's'}`)}`);
+        lines.push('');
+    }
+    if (groups.length > 0) {
+        lines.push(`  ${dim('Run with --output json for machine-readable output')}`);
+    }
+    return lines;
+}
+export function buildDuplicationFamilyLines(families, opts = {}) {
+    const multi = families.filter(f => f.groups.length > 1);
+    if (multi.length === 0)
+        return [];
+    const lines = [];
+    lines.push(`${col(YELLOW, '●')} ${col(YELLOW, col(BOLD, `Clone families (${multi.length} with multiple groups)`))}`);
+    lines.push('');
+    const shown = multi.slice(0, MAX_FLAT);
+    for (const family of shown) {
+        const fileList = family.files.join(', ');
+        lines.push(`  ${bold(String(family.groups.length))} groups, ${bold(thousands(family.totalDuplicatedLines))} lines across ${fileList}`);
+        for (const s of family.suggestions) {
+            lines.push(`    ${col(YELLOW, '→')} ${dim(s.description)}`);
+        }
+        lines.push('');
+    }
+    if (multi.length > MAX_FLAT) {
+        lines.push(`  ${dim(`... and ${multi.length - MAX_FLAT} more families`)}`);
+        lines.push('');
+    }
+    lines.push(`  ${dim(`Groups of related clones across the same files — ${DOCS_DUPLICATION}#clone-families`)}`);
+    lines.push('');
+    return lines;
+}
+//# sourceMappingURL=human-dupes.js.map

package/dist/src/report/human-dupes.js.map

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

package/dist/src/report/human-health.d.ts

@@ -0,0 +1,12 @@
+import type { CoverageGapData } from '../health/scoring-types.js';
+import type { FileScore, VitalSigns } from '../health/health-report-types.js';
+export interface HumanHealthOptions {
+    hotspotLimit?: number;
+    coverageGapLimit?: number;
+    noColor?: boolean;
+}
+export declare function formatVitalSignsSection(vitals: VitalSigns): string[];
+export declare function formatHotspotSection(scores: FileScore[], limit?: number): string[];
+export declare function formatCoverageGapSection(gaps: CoverageGapData[], limit?: number): string[];
+export declare function buildHealthHumanLines(scores: FileScore[], vitals: VitalSigns, opts?: HumanHealthOptions): string[];
+//# sourceMappingURL=human-health.d.ts.map

package/dist/src/report/human-health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human-health.d.ts","sourceRoot":"","sources":["../../../src/report/human-health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA8BD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CA+EpE;AAYD,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,SAAwB,GAAG,MAAM,EAAE,CAqBjG;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,KAAK,SAA6B,GAAG,MAAM,EAAE,CAwB9G;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE,UAAU,EAClB,IAAI,GAAE,kBAAuB,GAC5B,MAAM,EAAE,CAaV"}

package/dist/src/report/human-health.js

@@ -0,0 +1,121 @@
+const DEFAULT_HOTSPOT_LIMIT = 20;
+const DEFAULT_COVERAGE_GAP_LIMIT = 20;
+function vitalStatus(value, warnThreshold, critThreshold, higherIsBetter = false) {
+    if (higherIsBetter) {
+        if (value >= warnThreshold)
+            return 'OK';
+        if (value >= critThreshold)
+            return 'WARNING';
+        return 'CRITICAL';
+    }
+    if (value <= warnThreshold)
+        return 'OK';
+    if (value <= critThreshold)
+        return 'WARNING';
+    return 'CRITICAL';
+}
+function statusIcon(status) {
+    if (status === 'OK')
+        return '✓';
+    if (status === 'WARNING')
+        return '⚠';
+    return '✗';
+}
+function formatVitalLine(label, status, detail) {
+    const icon = statusIcon(status);
+    const suffix = detail ? ` (${detail})` : '';
+    return `  ${icon} ${label}: ${status}${suffix}`;
+}
+export function formatVitalSignsSection(vitals) {
+    const lines = [];
+    lines.push('\n── Vital Signs ──');
+    const complexityStatus = vitalStatus(vitals.avgCyclomatic, 1.5, 5.5);
+    lines.push(formatVitalLine('Avg Complexity', complexityStatus, complexityStatus !== 'OK' ? `avg ${vitals.avgCyclomatic.toFixed(1)}, threshold 1.5` : undefined));
+    const p90Status = vitalStatus(vitals.p90Cyclomatic, 10, 20);
+    lines.push(formatVitalLine('P90 Complexity', p90Status, p90Status !== 'OK' ? `p90 ${vitals.p90Cyclomatic}, threshold 10` : undefined));
+    const maintStatus = vitalStatus(vitals.maintainabilityAvg, 70, 40, true);
+    lines.push(formatVitalLine('Maintainability', maintStatus, maintStatus !== 'OK' ? `avg ${vitals.maintainabilityAvg.toFixed(1)}, threshold 70` : undefined));
+    const dupStatus = vitalStatus(vitals.duplicationPct, 5, 15);
+    lines.push(formatVitalLine('Duplication', dupStatus, `${vitals.duplicationPct.toFixed(1)}%`));
+    const deadFileStatus = vitalStatus(vitals.deadFilePct, 5, 25);
+    lines.push(formatVitalLine('Dead Files', deadFileStatus, `${vitals.deadFilePct.toFixed(1)}%`));
+    const deadExportStatus = vitalStatus(vitals.deadExportPct, 5, 25);
+    lines.push(formatVitalLine('Dead Exports', deadExportStatus, `${vitals.deadExportPct.toFixed(1)}%`));
+    const hotspotStatus = vitals.hotspotCount > 10 ? 'CRITICAL' : vitals.hotspotCount > 3 ? 'WARNING' : 'OK';
+    lines.push(formatVitalLine('Hotspots', hotspotStatus, `${vitals.hotspotCount} hotspot${vitals.hotspotCount !== 1 ? 's' : ''}`));
+    if (vitals.unusedDepCount > 0) {
+        const udStatus = vitalStatus(vitals.unusedDepCount, 0, 5);
+        lines.push(formatVitalLine('Unused Deps', udStatus, `${vitals.unusedDepCount}`));
+    }
+    if (vitals.circularDepCount > 0) {
+        const cdStatus = vitalStatus(vitals.circularDepCount, 0, 3);
+        lines.push(formatVitalLine('Circular Deps', cdStatus, `${vitals.circularDepCount}`));
+    }
+    const couplingStatus = vitalStatus(vitals.couplingHighPct, 5, 15);
+    lines.push(formatVitalLine('High Coupling', couplingStatus, `${vitals.couplingHighPct.toFixed(1)}%`));
+    return lines;
+}
+function computeHotspotScore(score) {
+    let s = 0;
+    if (score.complexityDensity !== undefined)
+        s += score.complexityDensity * 30;
+    if (score.crapMax !== undefined)
+        s += Math.min(score.crapMax / 100, 1) * 25;
+    if (score.deadCodeRatio !== undefined)
+        s += score.deadCodeRatio * 20;
+    if (score.fanIn !== undefined)
+        s += Math.min(score.fanIn / 50, 1) * 15;
+    if (score.maintainabilityIndex !== undefined)
+        s += Math.max(0, (100 - score.maintainabilityIndex) / 100) * 10;
+    return Math.min(s, 100);
+}
+export function formatHotspotSection(scores, limit = DEFAULT_HOTSPOT_LIMIT) {
+    if (scores.length === 0)
+        return [];
+    const sorted = [...scores]
+        .map((s) => ({ score: s, value: computeHotspotScore(s) }))
+        .sort((a, b) => b.value - a.value)
+        .slice(0, limit);
+    const lines = [];
+    lines.push('\n── Hotspots ──');
+    for (const { score, value } of sorted) {
+        const scoreStr = value.toFixed(1).padStart(5);
+        lines.push(`  ${scoreStr}  ${score.path}`);
+    }
+    if (scores.length > limit) {
+        lines.push(`  ... and ${scores.length - limit} more (use --format json for full list)`);
+    }
+    return lines;
+}
+export function formatCoverageGapSection(gaps, limit = DEFAULT_COVERAGE_GAP_LIMIT) {
+    if (gaps.length === 0)
+        return [];
+    const sorted = [...gaps].sort((a, b) => a.coveragePct - b.coveragePct).slice(0, limit);
+    const lines = [];
+    lines.push('\n── Coverage Gaps ──');
+    for (const gap of sorted) {
+        const pctStr = `${gap.coveragePct.toFixed(1)}%`.padStart(6);
+        lines.push(`  ${pctStr}  ${gap.filePath}`);
+        if (gap.uncoveredFunctions.length > 0) {
+            const shown = gap.uncoveredFunctions.slice(0, 3);
+            const extra = gap.uncoveredFunctions.length - shown.length;
+            const fnList = shown.join(', ') + (extra > 0 ? `, +${extra} more` : '');
+            lines.push(`         uncovered: ${fnList}`);
+        }
+    }
+    if (gaps.length > limit) {
+        lines.push(`  ... and ${gaps.length - limit} more`);
+    }
+    return lines;
+}
+export function buildHealthHumanLines(scores, vitals, opts = {}) {
+    const lines = [];
+    lines.push('\n── Health Report ──');
+    const vitalLines = formatVitalSignsSection(vitals);
+    lines.push(...vitalLines);
+    const hotspotLimit = opts.hotspotLimit ?? DEFAULT_HOTSPOT_LIMIT;
+    const hotspotLines = formatHotspotSection(scores, hotspotLimit);
+    lines.push(...hotspotLines);
+    return lines;
+}
+//# sourceMappingURL=human-health.js.map

package/dist/src/report/human-health.js.map

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

package/dist/src/report/human.d.ts

@@ -0,0 +1,46 @@
+export interface HumanDeadCodeFinding {
+    filePath: string;
+    symbol?: string;
+    kind: string;
+    line?: number;
+}
+export interface HumanHealthFinding {
+    filePath: string;
+    functionName: string;
+    startLine: number;
+    cyclomatic: number;
+    cognitive: number;
+    crapScore: number;
+    severity: string;
+}
+export interface HumanDuplicationGroup {
+    groupId: number;
+    instances: Array<{
+        filePath: string;
+        startLine: number;
+        endLine: number;
+    }>;
+    duplicatedLines: number;
+}
+export interface HumanTraceEntry {
+    from: string;
+    to: string;
+    reason: string;
+}
+export declare function buildDeadCodeHumanLines(findings: HumanDeadCodeFinding[], root?: string): string[];
+export declare function buildHealthHumanLines(findings: HumanHealthFinding[], root?: string): string[];
+export declare function buildDuplicationHumanLines(groups: HumanDuplicationGroup[], root?: string): string[];
+export declare function buildExportTraceHumanLines(trace: {
+    exportName: string;
+    filePath: string;
+    consumers: HumanTraceEntry[];
+}): string[];
+export declare function buildFileTraceHumanLines(trace: {
+    filePath: string;
+    importedBy: HumanTraceEntry[];
+}): string[];
+export declare function buildDependencyTraceHumanLines(trace: {
+    packageName: string;
+    usedIn: HumanTraceEntry[];
+}): string[];
+//# sourceMappingURL=human.d.ts.map

package/dist/src/report/human.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"human.d.ts","sourceRoot":"","sources":["../../../src/report/human.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,oBAAoB,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE,CAY7F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE,CAWzF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,qBAAqB,EAAE,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE,CAY/F;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAUlI;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAU7G;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,GAAG,MAAM,EAAE,CAUlH"}