@vyuhlabs/dxkit 1.5.0 → 1.6.0

package/dist/analyzers/quality/actions.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSlopActions = buildSlopActions;
+/** Build the candidate action list for the given metrics. */
+function buildSlopActions(m) {
+    const actions = [];
+    // 1. Delete committed stale files (.pyc, .swp, .bak, .orig, .tmp, .log)
+    if (m.staleFiles.length > 0) {
+        const evidence = m.staleFiles.map((f) => ({
+            file: f,
+            rule: 'stale-file',
+            tool: 'git',
+            message: 'Temp/backup file committed to git',
+        }));
+        actions.push({
+            id: 'slop.delete-stale-files',
+            title: `Delete ${m.staleFiles.length} stale file${m.staleFiles.length === 1 ? '' : 's'} from git`,
+            rationale: 'Temp/backup files (.pyc, .swp, .bak, .orig) in git add noise and suggest missing .gitignore rules.',
+            evidence,
+            patch: (cur) => ({ ...cur, staleFiles: [] }),
+        });
+    }
+    // 2. Remove console statements (down to <=20)
+    if (m.consoleLogCount > 20) {
+        const target = 20;
+        const evidence = (m.topConsoleFiles || []).map((f) => ({
+            file: f.file,
+            rule: 'console-log',
+            tool: 'grep',
+            message: `${f.count} console statements`,
+        }));
+        actions.push({
+            id: 'slop.remove-console-statements',
+            title: `Remove console statements (currently ${m.consoleLogCount}, target <=${target})`,
+            rationale: 'Console logging in production code indicates missing structured logging. Use a logger library instead.',
+            evidence,
+            patch: (cur) => ({ ...cur, consoleLogCount: target }),
+        });
+    }
+    // 3. Triage TODO/FIXME/HACK comments (down to <=20)
+    const hygieneTotal = m.todoCount + m.fixmeCount + m.hackCount;
+    if (hygieneTotal > 20) {
+        const evidence = (m.topTodoFiles || []).map((f) => ({
+            file: f.file,
+            rule: 'hygiene-marker',
+            tool: 'grep',
+            message: `${f.count} TODO/FIXME/HACK markers`,
+        }));
+        actions.push({
+            id: 'slop.triage-todos',
+            title: `Triage TODO/FIXME/HACK comments (${hygieneTotal} total — file issues or delete)`,
+            rationale: 'Unresolved markers suggest forgotten work. Convert real work to tracked issues; delete obsolete ones.',
+            evidence,
+            patch: (cur) => ({
+                ...cur,
+                todoCount: Math.min(cur.todoCount, 15),
+                fixmeCount: 0,
+                hackCount: 0,
+            }),
+        });
+    }
+    // 4. Split the densest file (god file)
+    if (m.maxFunctionsInFile !== null && m.maxFunctionsInFile > 50) {
+        const ev = m.maxFunctionsFilePath
+            ? [
+                {
+                    file: m.maxFunctionsFilePath,
+                    rule: 'god-file',
+                    tool: 'graphify',
+                    message: `${m.maxFunctionsInFile} functions in one file`,
+                },
+            ]
+            : [];
+        actions.push({
+            id: 'slop.split-god-file',
+            title: `Split the densest file (${m.maxFunctionsInFile} functions)`,
+            rationale: 'Files with >50 functions are hard to navigate, test, and review. Break into focused modules.',
+            evidence: ev,
+            patch: (cur) => ({ ...cur, maxFunctionsInFile: 40 }),
+        });
+    }
+    // 5. Remove dead imports
+    if (m.deadImportCount !== null && m.deadImportCount > 20) {
+        actions.push({
+            id: 'slop.remove-dead-imports',
+            title: `Remove ${m.deadImportCount} dead imports`,
+            rationale: 'Imports never called add cognitive load. Most editors auto-remove them.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, deadImportCount: 0 }),
+        });
+    }
+    // 6. Address large duplication
+    if (m.duplication && m.duplication.percentage > 5) {
+        const evidence = m.duplication.topClones?.flatMap((c) => [
+            {
+                file: c.a.file,
+                line: c.a.startLine,
+                endLine: c.a.endLine,
+                rule: 'duplicate-block',
+                tool: 'jscpd',
+                message: `${c.lines}-line clone with ${c.b.file}:${c.b.startLine}`,
+            },
+        ]) ?? [];
+        const target = 5;
+        actions.push({
+            id: 'slop.extract-duplicates',
+            title: `Extract shared code (duplication ${m.duplication.percentage}% → target ${target}%)`,
+            rationale: 'Duplicate blocks multiply maintenance cost. Extract into shared helpers/modules starting with the largest clones.',
+            evidence,
+            patch: (cur) => ({
+                ...cur,
+                duplication: cur.duplication ? { ...cur.duplication, percentage: target } : null,
+            }),
+        });
+    }
+    // 7. Unify JS/TS
+    if (m.mixedLanguages) {
+        actions.push({
+            id: 'slop.unify-js-ts',
+            title: 'Convert stray .js files to TypeScript',
+            rationale: 'Mixing .js and .ts in source defeats type-safety gains. Convert or move generated JS to /dist.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, mixedLanguages: false }),
+        });
+    }
+    // 8. Clear lint errors
+    if (m.lintErrors > 10) {
+        actions.push({
+            id: 'slop.fix-lint-errors',
+            title: `Fix ${m.lintErrors} lint errors`,
+            rationale: 'Lint errors often indicate real bugs. Most are auto-fixable.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, lintErrors: 0 }),
+        });
+    }
+    // 9. Reduce comment-heavy files
+    if (m.commentRatio !== null && m.commentRatio > 0.4) {
+        actions.push({
+            id: 'slop.reduce-comment-bloat',
+            title: `Reduce comment bloat (ratio ${(m.commentRatio * 100).toFixed(1)}%)`,
+            rationale: 'Very high comment ratios often signal commented-out code (should be deleted) or over-documentation.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, commentRatio: 0.2 }),
+        });
+    }
+    // 10. Address orphan modules
+    if (m.orphanModuleCount !== null && m.orphanModuleCount > 30) {
+        actions.push({
+            id: 'slop.remove-orphan-modules',
+            title: `Review ${m.orphanModuleCount} orphan modules (no inbound imports)`,
+            rationale: 'Modules never imported are dead code or entry points. Delete dead ones; document entry points.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, orphanModuleCount: 20 }),
+        });
+    }
+    return actions;
+}
+//# sourceMappingURL=actions.js.map

package/dist/analyzers/quality/actions.js.map

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

package/dist/analyzers/quality/detailed.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Detailed quality report — JSON schema + markdown formatter.
+ *
+ * The JSON is the canonical, agent-consumable artifact. The markdown is
+ * generated from the JSON so they never diverge.
+ */
+import { QualityReport, QualityMetrics } from './types';
+import { RankedAction } from '../remediation';
+export interface QualityDetailedReport extends QualityReport {
+    /** Schema version for agent consumers. Bump on breaking shape changes. */
+    schemaVersion: string;
+    /** Ranked remediation actions with simulated score deltas. */
+    actions: Array<RankedAction<QualityMetrics>>;
+}
+export declare function buildQualityDetailed(report: QualityReport): QualityDetailedReport;
+export declare function formatQualityDetailedMarkdown(detailed: QualityDetailedReport, elapsed: string): string;
+//# sourceMappingURL=detailed.d.ts.map

package/dist/analyzers/quality/detailed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detailed.d.ts","sourceRoot":"","sources":["../../../src/analyzers/quality/detailed.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACxD,OAAO,EAAE,YAAY,EAAQ,MAAM,gBAAgB,CAAC;AAIpD,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAC1D,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,OAAO,EAAE,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC;CAC9C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,GAAG,qBAAqB,CASjF;AAED,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,qBAAqB,EAC/B,OAAO,EAAE,MAAM,GACd,MAAM,CAiHR"}

package/dist/analyzers/quality/detailed.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildQualityDetailed = buildQualityDetailed;
+exports.formatQualityDetailedMarkdown = formatQualityDetailedMarkdown;
+const remediation_1 = require("../remediation");
+const actions_1 = require("./actions");
+const index_1 = require("./index");
+function buildQualityDetailed(report) {
+    const actions = (0, remediation_1.rank)((0, actions_1.buildSlopActions)(report.metrics), report.metrics, (m) => ({
+        score: (0, index_1.computeSlopScore)(m),
+    }));
+    return {
+        ...report,
+        schemaVersion: '10c.1',
+        actions,
+    };
+}
+function formatQualityDetailedMarkdown(detailed, elapsed) {
+    const L = [];
+    const m = detailed.metrics;
+    L.push('# Code Quality Review — Detailed');
+    L.push('');
+    L.push(`**Date:** ${detailed.analyzedAt.slice(0, 10)}`);
+    L.push(`**Repository:** ${detailed.repo}`);
+    L.push(`**Branch:** ${detailed.branch} (${detailed.commitSha})`);
+    L.push(`**Slop Score:** ${detailed.slopScore}/100`);
+    L.push(`**Schema version:** ${detailed.schemaVersion}`);
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Ranked actions
+    L.push('## Recommended Actions');
+    L.push('');
+    if (detailed.actions.length === 0) {
+        L.push('No remediation actions suggested — slop score has no actionable deductions.');
+    }
+    else {
+        L.push('Actions are ranked by projected score improvement. Each delta is computed by simulating the scorer with the patched metrics.');
+        L.push('');
+        L.push('| # | Action | Score Δ | Projected | Evidence |');
+        L.push('|---|--------|--------:|----------:|----------|');
+        detailed.actions.forEach((a, i) => {
+            const evSuffix = a.evidence.length
+                ? `${a.evidence.length} item${a.evidence.length === 1 ? '' : 's'}`
+                : '—';
+            L.push(`| ${i + 1} | ${a.title} | +${a.scoreDelta} | ${a.projectedScore}/100 | ${evSuffix} |`);
+        });
+        L.push('');
+        for (const a of detailed.actions) {
+            L.push(`### ${a.title} (+${a.scoreDelta})`);
+            L.push('');
+            L.push(`- **ID:** \`${a.id}\``);
+            L.push(`- **Baseline:** ${a.baselineScore}/100`);
+            L.push(`- **Projected:** ${a.projectedScore}/100`);
+            if (a.rationale)
+                L.push(`- **Why:** ${a.rationale}`);
+            if (a.evidence.length) {
+                L.push('- **Evidence:**');
+                for (const e of a.evidence.slice(0, 10)) {
+                    const loc = e.line ? `:${e.line}${e.endLine ? `-${e.endLine}` : ''}` : '';
+                    L.push(`  - \`${e.file}${loc}\` — ${e.message || e.rule}`);
+                }
+                if (a.evidence.length > 10) {
+                    L.push(`  - … and ${a.evidence.length - 10} more`);
+                }
+            }
+            L.push('');
+        }
+    }
+    L.push('---');
+    L.push('');
+    // Top duplicate clones
+    if (m.duplication?.topClones && m.duplication.topClones.length > 0) {
+        L.push('## Top Duplicate Clones');
+        L.push('');
+        L.push('| Lines | File A | File B |');
+        L.push('|------:|--------|--------|');
+        for (const c of m.duplication.topClones) {
+            L.push(`| ${c.lines} | \`${c.a.file}:${c.a.startLine}-${c.a.endLine}\` | \`${c.b.file}:${c.b.startLine}-${c.b.endLine}\` |`);
+        }
+        L.push('');
+        L.push('---');
+        L.push('');
+    }
+    // Top offenders
+    if (m.topConsoleFiles && m.topConsoleFiles.length > 0) {
+        L.push('## Files with Most Console Statements');
+        L.push('');
+        L.push('| File | Count |');
+        L.push('|------|------:|');
+        for (const f of m.topConsoleFiles)
+            L.push(`| \`${f.file}\` | ${f.count} |`);
+        L.push('');
+    }
+    if (m.topTodoFiles && m.topTodoFiles.length > 0) {
+        L.push('## Files with Most TODO/FIXME/HACK');
+        L.push('');
+        L.push('| File | Count |');
+        L.push('|------|------:|');
+        for (const f of m.topTodoFiles)
+            L.push(`| \`${f.file}\` | ${f.count} |`);
+        L.push('');
+    }
+    if (m.staleFiles.length > 0) {
+        L.push('## Stale Files Committed to Git');
+        L.push('');
+        for (const f of m.staleFiles)
+            L.push(`- \`${f}\``);
+        L.push('');
+    }
+    L.push('---');
+    L.push('');
+    L.push(`**Tools used:** ${detailed.toolsUsed.join(', ')}`);
+    if (detailed.toolsUnavailable.length > 0) {
+        L.push(`**Tools unavailable:** ${detailed.toolsUnavailable.join(', ')}`);
+    }
+    L.push(`**Analysis time:** ${elapsed}s`);
+    L.push('');
+    L.push('*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit) — detailed mode*');
+    return L.join('\n');
+}
+//# sourceMappingURL=detailed.js.map

package/dist/analyzers/quality/detailed.js.map

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

package/dist/analyzers/quality/gather.d.ts

@@ -0,0 +1,38 @@
+import { DuplicationStats, FileOffender } from './types';
+export declare function gatherDuplication(cwd: string): {
+    stats: DuplicationStats | null;
+    toolUsed: string | null;
+};
+export declare function gatherStructuralMetrics(cwd: string): {
+    maxFunctionsInFile: number | null;
+    maxFunctionsFilePath: string | null;
+    avgCohesion: number | null;
+    communityCount: number | null;
+    functionCount: number | null;
+    deadImportCount: number | null;
+    orphanModuleCount: number | null;
+    toolUsed: string | null;
+};
+export declare function gatherCommentRatio(cwd: string): {
+    ratio: number | null;
+    toolUsed: string | null;
+};
+/** Collect per-file top offenders for detailed reports. Slow — only call when needed. */
+export declare function gatherHygieneTopOffenders(cwd: string): {
+    topConsoleFiles: FileOffender[];
+    topTodoFiles: FileOffender[];
+};
+export declare function gatherHygieneMarkers(cwd: string): {
+    todoCount: number;
+    fixmeCount: number;
+    hackCount: number;
+    consoleLogCount: number;
+    staleFiles: string[];
+    mixedLanguages: boolean;
+};
+export declare function gatherLintMetrics(cwd: string): Promise<{
+    errors: number;
+    warnings: number;
+    tool: string | null;
+}>;
+//# sourceMappingURL=gather.d.ts.map

package/dist/analyzers/quality/gather.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gather.d.ts","sourceRoot":"","sources":["../../../src/analyzers/quality/gather.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAc,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AA4CrE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC9C,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAwCA;AAyCD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG;IACpD,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CA+BA;AAID,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG;IAC/C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAkBA;AAID,yFAAyF;AACzF,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG;IACtD,eAAe,EAAE,YAAY,EAAE,CAAC;IAChC,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAKA;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;CACzB,CA4DA;AAID,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5D,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB,CAAC,CAcD"}

package/dist/analyzers/quality/gather.js

@@ -0,0 +1,279 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.gatherDuplication = gatherDuplication;
+exports.gatherStructuralMetrics = gatherStructuralMetrics;
+exports.gatherCommentRatio = gatherCommentRatio;
+exports.gatherHygieneTopOffenders = gatherHygieneTopOffenders;
+exports.gatherHygieneMarkers = gatherHygieneMarkers;
+exports.gatherLintMetrics = gatherLintMetrics;
+/**
+ * Quality gathering — one function per tool, all accessed via registry.
+ *
+ * PRINCIPLE: Every external tool is accessed via findTool(TOOL_DEFS.xxx).
+ * No direct binary paths. No ad-hoc execSync calls for tools.
+ * If a tool isn't in tool-registry.ts, it can't be used here.
+ *
+ * Tool boundaries:
+ *   jscpd     → duplicate code detection
+ *   graphify  → structural complexity (god files, dead code, cohesion)
+ *   cloc      → comment-to-code ratio
+ *   eslint    → lint errors/warnings (when available)
+ *   grep      → hygiene markers (TODO, FIXME, HACK, console.log)
+ */
+const fs = __importStar(require("fs"));
+const runner_1 = require("../tools/runner");
+const tool_registry_1 = require("../tools/tool-registry");
+const exclusions_1 = require("../tools/exclusions");
+const graphify_1 = require("../tools/graphify");
+const cloc_1 = require("../tools/cloc");
+const languages_1 = require("../../languages");
+/** Extract top N clone pairs sorted by size descending. */
+function topClonesFrom(duplicates, limit = 15) {
+    return duplicates
+        .filter((d) => d.firstFile?.name && d.secondFile?.name && d.lines)
+        .map((d) => ({
+        lines: d.lines || 0,
+        tokens: d.tokens || 0,
+        a: {
+            file: d.firstFile.name,
+            startLine: d.firstFile.start || 0,
+            endLine: d.firstFile.end || 0,
+        },
+        b: {
+            file: d.secondFile.name,
+            startLine: d.secondFile.start || 0,
+            endLine: d.secondFile.end || 0,
+        },
+    }))
+        .sort((x, y) => y.lines - x.lines)
+        .slice(0, limit);
+}
+function gatherDuplication(cwd) {
+    const status = (0, tool_registry_1.findTool)(tool_registry_1.TOOL_DEFS.jscpd, cwd);
+    if (!status.available || !status.path)
+        return { stats: null, toolUsed: null };
+    const reportDir = `/tmp/dxkit-jscpd-${Date.now()}`;
+    // Key flags:
+    // --gitignore: respect .gitignore (skips node_modules/dist/build if listed)
+    // --pattern: only scan source files (not configs, markdown, etc.)
+    // Without --gitignore, jscpd crawls into node_modules and OOMs on large repos.
+    (0, runner_1.run)(`${status.path} --reporters json --output '${reportDir}' --gitignore --pattern '**/*.{ts,tsx,js,jsx,py,go,rs,cs}' --min-lines 5 --min-tokens 50 '${cwd}' > /dev/null 2>&1`, cwd, 300000);
+    const reportRaw = (0, runner_1.run)(`cat '${reportDir}/jscpd-report.json' 2>/dev/null`, cwd);
+    (0, runner_1.run)(`rm -rf '${reportDir}'`, cwd);
+    if (!reportRaw)
+        return { stats: null, toolUsed: 'jscpd' };
+    try {
+        const data = JSON.parse(reportRaw);
+        const t = data.statistics?.total;
+        if (!t)
+            return { stats: null, toolUsed: 'jscpd' };
+        const duplicates = data.duplicates || [];
+        return {
+            stats: {
+                totalLines: t.lines,
+                duplicatedLines: t.duplicatedLines,
+                percentage: Math.round(t.percentage * 100) / 100,
+                cloneCount: duplicates.length,
+                topClones: topClonesFrom(duplicates),
+            },
+            toolUsed: 'jscpd',
+        };
+    }
+    catch {
+        return { stats: null, toolUsed: 'jscpd' };
+    }
+}
+// ─── grep: per-file hygiene offender counts ─────────────────────────────────
+/**
+ * Count matches per file and return the top N offenders.
+ * Uses `grep -rc` which emits `file:count` per matched file.
+ */
+function grepPerFile(cwd, pattern, limit = 10) {
+    const patternFile = `/tmp/dxkit-qgrep-${Date.now()}-${Math.random().toString(36).slice(2)}.pat`;
+    fs.writeFileSync(patternFile, pattern);
+    const excludeDirs = (0, exclusions_1.getGrepExcludeDirFlags)(cwd);
+    const raw = (0, runner_1.run)(`grep -rcEf '${patternFile}' ${excludeDirs} --include='*.ts' --include='*.tsx' --include='*.js' --include='*.jsx' --include='*.py' --include='*.go' . 2>/dev/null`, cwd, 60000);
+    try {
+        fs.unlinkSync(patternFile);
+    }
+    catch {
+        /* ignore */
+    }
+    if (!raw)
+        return [];
+    const offenders = [];
+    for (const line of raw.split('\n')) {
+        const idx = line.lastIndexOf(':');
+        if (idx < 0)
+            continue;
+        const file = line.slice(0, idx);
+        const count = parseInt(line.slice(idx + 1), 10);
+        if (!count || !file)
+            continue;
+        // grep's --exclude-dir is basename-only; use centralized predicate to
+        // drop multi-segment path exclusions (public/assets) + file patterns.
+        if ((0, exclusions_1.isExcludedPath)(cwd, file.replace(/^\.\//, '')))
+            continue;
+        offenders.push({ file, count });
+    }
+    offenders.sort((a, b) => b.count - a.count);
+    return offenders.slice(0, limit);
+}
+// ─── graphify: structural complexity ────────────────────────────────────────
+function gatherStructuralMetrics(cwd) {
+    // Reuse graphify data from health metrics if already gathered,
+    // otherwise just report null. Graphify runs during health orchestration,
+    // not re-run per deep analyzer (too slow to run twice).
+    // The quality report inherits these from the health pipeline.
+    // For standalone `vyuh-dxkit quality`, we gather them fresh.
+    const result = (0, graphify_1.gatherGraphifyMetrics)(cwd);
+    if (result.functionCount !== undefined && result.functionCount !== null) {
+        return {
+            maxFunctionsInFile: result.maxFunctionsInFile ?? null,
+            maxFunctionsFilePath: result.maxFunctionsFilePath ?? null,
+            avgCohesion: result.avgCohesion ?? null,
+            communityCount: result.communityCount ?? null,
+            functionCount: result.functionCount ?? null,
+            deadImportCount: result.deadImportCount ?? null,
+            orphanModuleCount: result.orphanModuleCount ?? null,
+            toolUsed: 'graphify',
+        };
+    }
+    return {
+        maxFunctionsInFile: null,
+        maxFunctionsFilePath: null,
+        avgCohesion: null,
+        communityCount: null,
+        functionCount: null,
+        deadImportCount: null,
+        orphanModuleCount: null,
+        toolUsed: result.toolsUnavailable ? null : 'graphify',
+    };
+}
+// ─── cloc: comment ratio ────────────────────────────────────────────────────
+function gatherCommentRatio(cwd) {
+    const status = (0, tool_registry_1.findTool)(tool_registry_1.TOOL_DEFS.cloc, cwd);
+    if (!status.available)
+        return { ratio: null, toolUsed: null };
+    const result = (0, cloc_1.gatherClocMetrics)(cwd);
+    if (result.clocLanguages && Array.isArray(result.clocLanguages)) {
+        let totalCode = 0;
+        let totalComment = 0;
+        for (const lang of result.clocLanguages) {
+            totalCode += lang.code;
+            totalComment += lang.comment;
+        }
+        const ratio = totalCode + totalComment > 0 ? totalComment / (totalCode + totalComment) : 0;
+        return { ratio: Math.round(ratio * 1000) / 1000, toolUsed: 'cloc' };
+    }
+    return { ratio: null, toolUsed: null };
+}
+// ─── grep: hygiene markers ──────────────────────────────────────────────────
+/** Collect per-file top offenders for detailed reports. Slow — only call when needed. */
+function gatherHygieneTopOffenders(cwd) {
+    return {
+        topConsoleFiles: grepPerFile(cwd, 'console\\.(log|error|warn)'),
+        topTodoFiles: grepPerFile(cwd, '(TODO|FIXME|HACK)'),
+    };
+}
+function gatherHygieneMarkers(cwd) {
+    // Sum match counts across source files, excluding vendored paths.
+    // grep --exclude-dir handles basename dirs (node_modules etc.) at traversal.
+    // Path-based exclusions (public/assets, static/js) are post-filtered because
+    // grep's --exclude-dir only matches basenames, not paths.
+    function grepCountSimple(pattern) {
+        const patternFile = `/tmp/dxkit-qgrep-${Date.now()}-${Math.random().toString(36).slice(2)}.pat`;
+        fs.writeFileSync(patternFile, pattern);
+        const excludeDirs = (0, exclusions_1.getGrepExcludeDirFlags)(cwd);
+        const result = (0, runner_1.run)(`grep -rcEf '${patternFile}' ${excludeDirs} --include='*.ts' --include='*.tsx' --include='*.js' --include='*.jsx' --include='*.py' --include='*.go' . 2>/dev/null`, cwd, 60000);
+        try {
+            fs.unlinkSync(patternFile);
+        }
+        catch {
+            /* ignore */
+        }
+        if (!result)
+            return 0;
+        let total = 0;
+        for (const line of result.split('\n')) {
+            const idx = line.lastIndexOf(':');
+            if (idx < 0)
+                continue;
+            const file = line.slice(0, idx);
+            const count = parseInt(line.slice(idx + 1), 10);
+            if (!count || !file)
+                continue;
+            // Centralized filter — same predicate used by security/quality/tests.
+            if ((0, exclusions_1.isExcludedPath)(cwd, file.replace(/^\.\//, '')))
+                continue;
+            total += count;
+        }
+        return total;
+    }
+    // Stale files: vim swap, backup, temp files tracked in git
+    const staleRaw = (0, runner_1.run)(`git ls-files '*.swp' '*.swo' '*.bak' '*.orig' '*.tmp' '*.log' '*.pyc' 2>/dev/null`, cwd);
+    const staleFiles = staleRaw ? staleRaw.split('\n').filter((l) => l.trim()) : [];
+    // Mixed languages: .js files alongside .ts in same source directories (not config files at root)
+    const jsInSrc = (0, runner_1.run)("find . -path '*/src/*.js' -not -path '*/node_modules/*' -not -path '*/dist/*' -not -name '*.min.js' 2>/dev/null | head -5", cwd);
+    const tsInSrc = (0, runner_1.run)("find . -path '*/src/*.ts' -not -path '*/node_modules/*' -not -path '*/dist/*' 2>/dev/null | head -1", cwd);
+    const mixedLanguages = !!(jsInSrc && tsInSrc);
+    return {
+        todoCount: grepCountSimple('TODO'),
+        fixmeCount: grepCountSimple('FIXME'),
+        hackCount: grepCountSimple('HACK'),
+        consoleLogCount: grepCountSimple('console\\.(log|error|warn)'),
+        staleFiles,
+        mixedLanguages,
+    };
+}
+// ─── lint errors (via language registry) ─────────────────────────────────────
+async function gatherLintMetrics(cwd) {
+    // Dispatch through language registry — first language with a lint result wins.
+    for (const lang of (0, languages_1.detectActiveLanguages)(cwd)) {
+        if (!lang.gatherMetrics)
+            continue;
+        const result = await lang.gatherMetrics(cwd);
+        if (result.lintTool) {
+            return {
+                errors: result.lintErrors ?? 0,
+                warnings: result.lintWarnings ?? 0,
+                tool: result.lintTool ?? null,
+            };
+        }
+    }
+    return { errors: 0, warnings: 0, tool: null };
+}
+//# sourceMappingURL=gather.js.map