@vyuhlabs/dxkit 1.5.0 → 1.6.0

package/dist/analyzers/developer/index.js

@@ -0,0 +1,168 @@
+"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.analyzeDevActivity = analyzeDevActivity;
+exports.formatDevReport = formatDevReport;
+/**
+ * Developer activity analyzer — public API.
+ * Orthogonal to health (no dimension score).
+ */
+const path = __importStar(require("path"));
+const detect_1 = require("../../detect");
+const runner_1 = require("../tools/runner");
+const timing_1 = require("../tools/timing");
+const gather_1 = require("./gather");
+function analyzeDevActivity(repoPath, since, options = {}) {
+    const verbose = !!options.verbose;
+    const stack = (0, detect_1.detect)(repoPath);
+    // Default: last 3 months
+    const sinceDate = since || new Date(Date.now() - 90 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10);
+    const summary = (0, timing_1.timed)('summary', verbose, () => (0, gather_1.gatherSummary)(repoPath, sinceDate));
+    const contributors = (0, timing_1.timed)('contributors', verbose, () => (0, gather_1.gatherContributors)(repoPath, sinceDate));
+    const commitQuality = (0, timing_1.timed)('commit-quality', verbose, () => (0, gather_1.gatherCommitQuality)(repoPath, sinceDate));
+    const hotFiles = (0, timing_1.timed)('hot-files', verbose, () => (0, gather_1.gatherHotFiles)(repoPath, sinceDate));
+    const velocity = (0, timing_1.timed)('velocity', verbose, () => (0, gather_1.gatherVelocity)(repoPath, sinceDate));
+    const nonMerge = summary.totalCommits - summary.mergeCommits;
+    const mergeRatio = summary.totalCommits > 0
+        ? Math.round((summary.mergeCommits / summary.totalCommits) * 1000) / 1000
+        : 0;
+    return {
+        repo: stack.projectName || path.basename(repoPath),
+        analyzedAt: new Date().toISOString(),
+        commitSha: (0, runner_1.run)('git rev-parse --short HEAD 2>/dev/null', repoPath),
+        branch: (0, runner_1.run)('git rev-parse --abbrev-ref HEAD 2>/dev/null', repoPath),
+        period: { since: sinceDate, until: new Date().toISOString().slice(0, 10) },
+        summary: {
+            totalCommits: summary.totalCommits,
+            nonMergeCommits: nonMerge,
+            mergeCommits: summary.mergeCommits,
+            mergeRatio,
+            contributors: contributors.length,
+        },
+        contributors,
+        commitQuality,
+        hotFiles,
+        velocity,
+        toolsUsed: ['git'],
+    };
+}
+function formatDevReport(report, elapsed) {
+    const L = [];
+    L.push('# Developer Activity Report');
+    L.push('');
+    L.push(`**Date:** ${report.analyzedAt.slice(0, 10)}`);
+    L.push(`**Period:** ${report.period.since} to ${report.period.until}`);
+    L.push(`**Repository:** ${report.repo}`);
+    L.push(`**Branch:** ${report.branch} (${report.commitSha})`);
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Executive summary
+    const s = report.summary;
+    L.push('## Executive Summary');
+    L.push('');
+    L.push(`**${s.totalCommits} commits** (${s.nonMergeCommits} non-merge, ${s.mergeCommits} merge) ` +
+        `from **${s.contributors} contributors**. ` +
+        `Merge ratio: ${(s.mergeRatio * 100).toFixed(1)}%. ` +
+        `Commit message quality: ${report.commitQuality.conventionalPercent}% conventional.`);
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Contributors
+    L.push('## 1. Developer Contributions');
+    L.push('');
+    L.push('| Rank | Developer | Commits | +Lines | -Lines | Net | Merges |');
+    L.push('|------|-----------|---------|--------|--------|-----|--------|');
+    report.contributors.forEach((c, i) => {
+        const total = c.commits + c.mergeCommits;
+        L.push(`| ${i + 1} | ${c.name} | ${total} | +${c.linesAdded.toLocaleString()} | -${c.linesRemoved.toLocaleString()} | ${c.netChange >= 0 ? '+' : ''}${c.netChange.toLocaleString()} | ${c.mergeCommits} |`);
+    });
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Commit quality
+    const q = report.commitQuality;
+    L.push('## 2. Commit Message Quality');
+    L.push('');
+    L.push('| Type | Count | % |');
+    L.push('|------|-------|---|');
+    L.push(`| Conventional (feat:, fix:, etc.) | ${q.conventional} | ${q.conventionalPercent}% |`);
+    L.push(`| Descriptive | ${q.descriptive} | ${q.total > 0 ? ((q.descriptive / q.total) * 100).toFixed(1) : 0}% |`);
+    L.push(`| Vague | ${q.vague} | ${q.total > 0 ? ((q.vague / q.total) * 100).toFixed(1) : 0}% |`);
+    L.push('');
+    if (q.conventionalPercent < 10) {
+        L.push('> **Poor commit message quality.** Consider adopting [Conventional Commits](https://www.conventionalcommits.org/) for automated changelogs and clearer git history.');
+    }
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Hot files
+    L.push('## 3. Hot Files (Most Changed)');
+    L.push('');
+    L.push('| File | Changes |');
+    L.push('|------|---------|');
+    for (const f of report.hotFiles) {
+        L.push(`| \`${f.path}\` | ${f.changes} |`);
+    }
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Velocity
+    L.push('## 4. Weekly Velocity');
+    L.push('');
+    if (report.velocity.length > 0) {
+        L.push('| Week | Commits |');
+        L.push('|------|---------|');
+        for (const v of report.velocity) {
+            const bar = '█'.repeat(Math.min(Math.round(v.commits / 2), 30));
+            L.push(`| ${v.week} | ${v.commits} ${bar} |`);
+        }
+        const avgPerWeek = report.velocity.length > 0
+            ? Math.round(report.velocity.reduce((sum, v) => sum + v.commits, 0) / report.velocity.length)
+            : 0;
+        L.push('');
+        L.push(`**Average:** ${avgPerWeek} commits/week.`);
+    }
+    L.push('');
+    L.push('---');
+    L.push('');
+    // Footer
+    L.push(`**Tools used:** ${report.toolsUsed.join(', ')}`);
+    L.push(`**Analysis time:** ${elapsed}s`);
+    L.push('');
+    L.push('*Generated by [VyuhLabs DXKit](https://www.npmjs.com/package/@vyuhlabs/dxkit)*');
+    return L.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzers/developer/index.js.map

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

package/dist/analyzers/developer/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Developer activity report types.
+ */
+export interface ContributorStats {
+    name: string;
+    commits: number;
+    linesAdded: number;
+    linesRemoved: number;
+    netChange: number;
+    mergeCommits: number;
+}
+export interface HotFile {
+    path: string;
+    changes: number;
+}
+export interface CommitQuality {
+    conventional: number;
+    descriptive: number;
+    vague: number;
+    total: number;
+    conventionalPercent: number;
+}
+export interface WeeklyVelocity {
+    week: string;
+    commits: number;
+}
+export interface DevReport {
+    repo: string;
+    analyzedAt: string;
+    commitSha: string;
+    branch: string;
+    period: {
+        since: string;
+        until: string;
+    };
+    summary: {
+        totalCommits: number;
+        nonMergeCommits: number;
+        mergeCommits: number;
+        mergeRatio: number;
+        contributors: number;
+    };
+    contributors: ContributorStats[];
+    commitQuality: CommitQuality;
+    hotFiles: HotFile[];
+    velocity: WeeklyVelocity[];
+    toolsUsed: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/analyzers/developer/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/analyzers/developer/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,aAAa,EAAE,aAAa,CAAC;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB"}

package/dist/analyzers/developer/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Developer activity report types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/analyzers/developer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/analyzers/developer/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/analyzers/docs/shallow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Documentation dimension — shallow score for health aggregation.
+ *
+ * Phase 3: delegates to scoring.ts (identical behavior).
+ * Future: may expand to include docstring coverage via graphify AST.
+ */
+import { HealthMetrics, DimensionScore } from '../types';
+export declare function scoreDocsDimension(m: HealthMetrics): DimensionScore;
+//# sourceMappingURL=shallow.d.ts.map

package/dist/analyzers/docs/shallow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallow.d.ts","sourceRoot":"","sources":["../../../src/analyzers/docs/shallow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,aAAa,GAAG,cAAc,CAEnE"}

package/dist/analyzers/docs/shallow.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreDocsDimension = scoreDocsDimension;
+const scoring_1 = require("../scoring");
+function scoreDocsDimension(m) {
+    return (0, scoring_1.scoreDocumentation)(m);
+}
+//# sourceMappingURL=shallow.js.map

package/dist/analyzers/docs/shallow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallow.js","sourceRoot":"","sources":["../../../src/analyzers/docs/shallow.ts"],"names":[],"mappings":";;AASA,gDAEC;AAJD,wCAAgD;AAEhD,SAAgB,kBAAkB,CAAC,CAAgB;IACjD,OAAO,IAAA,4BAAkB,EAAC,CAAC,CAAC,CAAC;AAC/B,CAAC"}

package/dist/analyzers/dx/shallow.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Developer Experience dimension — shallow score for health aggregation.
+ *
+ * Phase 3: delegates to scoring.ts (identical behavior).
+ * Future: may expand with more DX indicators (devcontainer, IDE config, etc).
+ */
+import { HealthMetrics, DimensionScore } from '../types';
+export declare function scoreDxDimension(m: HealthMetrics): DimensionScore;
+//# sourceMappingURL=shallow.d.ts.map

package/dist/analyzers/dx/shallow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallow.d.ts","sourceRoot":"","sources":["../../../src/analyzers/dx/shallow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAGzD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,aAAa,GAAG,cAAc,CAEjE"}

package/dist/analyzers/dx/shallow.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoreDxDimension = scoreDxDimension;
+const scoring_1 = require("../scoring");
+function scoreDxDimension(m) {
+    return (0, scoring_1.scoreDeveloperExperience)(m);
+}
+//# sourceMappingURL=shallow.js.map

package/dist/analyzers/dx/shallow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shallow.js","sourceRoot":"","sources":["../../../src/analyzers/dx/shallow.ts"],"names":[],"mappings":";;AASA,4CAEC;AAJD,wCAAsD;AAEtD,SAAgB,gBAAgB,CAAC,CAAgB;IAC/C,OAAO,IAAA,kCAAwB,EAAC,CAAC,CAAC,CAAC;AACrC,CAAC"}

package/dist/analyzers/evidence.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Generic evidence type used across all analyzers for detailed reports.
+ *
+ * A piece of evidence points at a specific location in the codebase that
+ * motivated a score deduction or remediation action. Tools produce evidence;
+ * formatters consume it.
+ *
+ * Distinct from SecurityFinding (security/types.ts) which adds severity + CWE
+ * for the security-specific findings pipeline.
+ */
+export interface Evidence {
+    /** Relative or absolute file path. */
+    file: string;
+    /** 1-indexed line number. Omit for file-level findings. */
+    line?: number;
+    /** Inclusive end line for a range. */
+    endLine?: number;
+    /** Optional code excerpt for human readers. Truncated to ~200 chars. */
+    snippet?: string;
+    /** Short stable id for the rule, e.g. "console-log", "god-file". */
+    rule: string;
+    /** Tool that produced this, e.g. "grep", "graphify", "jscpd". */
+    tool: string;
+    /** Optional one-line description shown to humans. */
+    message?: string;
+}
+/** A ranked list of offenders for a single metric (e.g. top god files). */
+export interface TopOffenders<T> {
+    /** Rule id this list is ranked by. */
+    rule: string;
+    /** Human-readable title for the list ("Files with most functions"). */
+    title: string;
+    /** Items sorted by severity/size descending. */
+    items: T[];
+}
+//# sourceMappingURL=evidence.d.ts.map

package/dist/analyzers/evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.d.ts","sourceRoot":"","sources":["../../src/analyzers/evidence.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ"}

package/dist/analyzers/evidence.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=evidence.js.map

package/dist/analyzers/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/analyzers/evidence.ts"],"names":[],"mappings":""}

package/dist/analyzers/health/actions.d.ts

@@ -0,0 +1,10 @@
+import { RankedAction } from '../remediation';
+import { HealthMetrics } from '../types';
+export interface DimensionPlan {
+    dimension: string;
+    baseline: number;
+    ideal: number;
+    actions: RankedAction<HealthMetrics>[];
+}
+export declare function buildHealthPlans(metrics: HealthMetrics): DimensionPlan[];
+//# sourceMappingURL=actions.d.ts.map

package/dist/analyzers/health/actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actions.d.ts","sourceRoot":"","sources":["../../../src/analyzers/health/actions.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAA2B,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA6RzC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,YAAY,CAAC,aAAa,CAAC,EAAE,CAAC;CACxC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,CA0BxE"}

package/dist/analyzers/health/actions.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildHealthPlans = buildHealthPlans;
+const remediation_1 = require("../remediation");
+const scoring_1 = require("../scoring");
+// ─── Testing dimension ──────────────────────────────────────────────────────
+function testingActions(m) {
+    const actions = [];
+    if (m.commentedCodeRatio !== null && m.commentedCodeRatio > 0.5) {
+        actions.push({
+            id: 'health.testing.restore-commented-tests',
+            title: 'Restore commented-out test files',
+            rationale: 'High commented-code ratio across test files indicates atrophied tests. See test-gaps-detailed.md.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, commentedCodeRatio: 0.1 }),
+        });
+    }
+    if (m.testFiles < m.sourceFiles * 0.1 && m.sourceFiles > 0) {
+        const target = Math.ceil(m.sourceFiles * 0.2);
+        actions.push({
+            id: 'health.testing.raise-test-ratio',
+            title: `Raise test-to-source ratio (${m.testFiles} tests for ${m.sourceFiles} source files)`,
+            rationale: 'Under 10% test-to-source ratio is critical. Start with top CRITICAL untested files — see test-gaps-detailed.md for the ranked list.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, testFiles: target }),
+        });
+    }
+    if (!m.coverageConfigExists) {
+        actions.push({
+            id: 'health.testing.add-coverage-config',
+            title: 'Add test coverage tooling',
+            rationale: 'No coverage config (nyc/c8/jest.coverage/coverage.py). Configure + set threshold.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, coverageConfigExists: true }),
+        });
+    }
+    return actions;
+}
+// ─── Quality dimension ──────────────────────────────────────────────────────
+function qualityActions(m) {
+    const actions = [];
+    if (m.consoleLogCount > 20) {
+        actions.push({
+            id: 'health.quality.remove-console',
+            title: `Remove console statements (${m.consoleLogCount})`,
+            rationale: 'See quality-review-detailed.md for top offender files.',
+            evidence: m.largestFilePath
+                ? [{ file: m.largestFilePath, rule: 'console-log', tool: 'grep' }]
+                : [],
+            patch: (cur) => ({ ...cur, consoleLogCount: 10 }),
+        });
+    }
+    if (m.anyTypeCount > 100 && m.lintTool?.includes('eslint')) {
+        actions.push({
+            id: 'health.quality.remove-any-types',
+            title: `Replace ${m.anyTypeCount} \`: any\` type annotations`,
+            rationale: 'Loose any-types defeat TypeScript. Most can be inferred or narrowed.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, anyTypeCount: 50 }),
+        });
+    }
+    if (m.lintErrors > 10) {
+        actions.push({
+            id: 'health.quality.fix-lint-errors',
+            title: `Fix ${m.lintErrors} lint errors`,
+            rationale: `Run \`${m.lintTool || 'lint'} --fix\` for auto-fixable ones.`,
+            evidence: [],
+            patch: (cur) => ({ ...cur, lintErrors: 0 }),
+        });
+    }
+    if (m.maxFunctionsInFile !== null && m.maxFunctionsInFile > 50) {
+        const ev = m.maxFunctionsFilePath
+            ? [
+                {
+                    file: m.maxFunctionsFilePath,
+                    rule: 'god-file',
+                    tool: 'graphify',
+                    message: `${m.maxFunctionsInFile} functions`,
+                },
+            ]
+            : [];
+        actions.push({
+            id: 'health.quality.split-god-file',
+            title: `Split densest file (${m.maxFunctionsInFile} functions)`,
+            rationale: 'Files with 50+ functions are hard to test and review.',
+            evidence: ev,
+            patch: (cur) => ({ ...cur, maxFunctionsInFile: 40 }),
+        });
+    }
+    return actions;
+}
+// ─── Documentation dimension ────────────────────────────────────────────────
+function docsActions(m) {
+    const actions = [];
+    if (!m.readmeExists || m.readmeLines < 50) {
+        actions.push({
+            id: 'health.docs.expand-readme',
+            title: m.readmeExists
+                ? `Expand README (currently ${m.readmeLines} lines)`
+                : 'Create a README.md',
+            rationale: 'README is the first impression. Target 50+ lines covering setup, run, test.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, readmeExists: true, readmeLines: 120 }),
+        });
+    }
+    if (!m.contributingExists) {
+        actions.push({
+            id: 'health.docs.add-contributing',
+            title: 'Add CONTRIBUTING.md',
+            rationale: 'Codifies contribution expectations, PR template, commit conventions.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, contributingExists: true }),
+        });
+    }
+    if (!m.architectureDocsExist) {
+        actions.push({
+            id: 'health.docs.add-architecture',
+            title: 'Add architecture/ADR documentation',
+            rationale: 'System design context prevents tribal-knowledge debt.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, architectureDocsExist: true }),
+        });
+    }
+    if (!m.apiDocsExist && (m.controllers > 0 || m.sourceFiles > 100)) {
+        actions.push({
+            id: 'health.docs.add-api-docs',
+            title: 'Add API documentation',
+            rationale: 'With controllers/routes present, API surface should be documented.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, apiDocsExist: true }),
+        });
+    }
+    return actions;
+}
+// ─── Security dimension ─────────────────────────────────────────────────────
+function securityActions(m) {
+    const actions = [];
+    if (m.secretFindings > 0) {
+        actions.push({
+            id: 'health.security.remove-secrets',
+            title: `Rotate & remove ${m.secretFindings} hardcoded secret${m.secretFindings === 1 ? '' : 's'}`,
+            rationale: 'Git history retains secrets — rotate credentials AND purge via git-filter-repo. See vulnerability-scan-detailed.md.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, secretFindings: 0 }),
+        });
+    }
+    if (m.privateKeyFiles > 0) {
+        actions.push({
+            id: 'health.security.remove-private-keys',
+            title: `Remove ${m.privateKeyFiles} private key file${m.privateKeyFiles === 1 ? '' : 's'} from git`,
+            rationale: 'Private keys in git are compromised. Rotate + remove + add to .gitignore.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, privateKeyFiles: 0 }),
+        });
+    }
+    if (m.depVulnCritical > 0 || m.depVulnHigh > 0) {
+        actions.push({
+            id: 'health.security.update-deps',
+            title: `Update vulnerable dependencies (${m.depVulnCritical}C ${m.depVulnHigh}H)`,
+            rationale: `Run \`${m.depAuditTool || 'audit tool'} fix\` or bump affected packages.`,
+            evidence: [],
+            patch: (cur) => ({
+                ...cur,
+                depVulnCritical: 0,
+                depVulnHigh: 0,
+                depVulnMedium: 0,
+                depVulnLow: 0,
+            }),
+        });
+    }
+    if (m.evalCount > 0) {
+        actions.push({
+            id: 'health.security.remove-eval',
+            title: `Remove ${m.evalCount} eval() call${m.evalCount === 1 ? '' : 's'}`,
+            rationale: 'eval() enables arbitrary code execution. Replace with explicit parsing.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, evalCount: 0 }),
+        });
+    }
+    return actions;
+}
+// ─── Maintainability dimension ──────────────────────────────────────────────
+function maintainabilityActions(m) {
+    const actions = [];
+    if (m.largestFileLines > 2000) {
+        actions.push({
+            id: 'health.maint.split-largest-file',
+            title: `Split ${m.largestFilePath} (${m.largestFileLines} lines)`,
+            rationale: 'Files over 2000 lines are too large for effective code review.',
+            evidence: m.largestFilePath
+                ? [{ file: m.largestFilePath, rule: 'large-file', tool: 'wc' }]
+                : [],
+            patch: (cur) => ({ ...cur, largestFileLines: 500 }),
+        });
+    }
+    if (m.nodeEngineVersion) {
+        const major = parseInt(m.nodeEngineVersion.match(/(\d+)/)?.[1] || '20');
+        if (major < 18) {
+            actions.push({
+                id: 'health.maint.upgrade-node',
+                title: `Upgrade Node engine (currently ${m.nodeEngineVersion})`,
+                rationale: 'Node < 18 is out of LTS. Upgrade package.json engines.node.',
+                evidence: [{ file: 'package.json', rule: 'outdated-node', tool: 'npm' }],
+                patch: (cur) => ({ ...cur, nodeEngineVersion: '>=20' }),
+            });
+        }
+    }
+    if (m.filesOver500Lines > 15) {
+        actions.push({
+            id: 'health.maint.reduce-large-files',
+            title: `Reduce ${m.filesOver500Lines} files > 500 lines`,
+            rationale: 'Large files are hard to navigate and review.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, filesOver500Lines: 5 }),
+        });
+    }
+    return actions;
+}
+// ─── Developer Experience dimension ─────────────────────────────────────────
+function dxActions(m) {
+    const actions = [];
+    if (m.ciConfigCount === 0) {
+        actions.push({
+            id: 'health.dx.add-ci',
+            title: 'Add CI configuration',
+            rationale: 'No CI on this branch — lint/test/typecheck should block merges. Add .github/workflows or equivalent.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, ciConfigCount: 1 }),
+        });
+    }
+    if (m.dockerConfigCount === 0) {
+        actions.push({
+            id: 'health.dx.add-dockerfile',
+            title: 'Add Dockerfile / containerization',
+            rationale: 'Containerized setup eliminates "works on my machine" onboarding friction.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, dockerConfigCount: 1 }),
+        });
+    }
+    if (m.precommitConfigCount === 0) {
+        actions.push({
+            id: 'health.dx.add-precommit',
+            title: 'Add pre-commit hooks (husky / pre-commit)',
+            rationale: 'Catch lint/format issues before code leaves the developer machine.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, precommitConfigCount: 1 }),
+        });
+    }
+    if (!m.envExampleExists) {
+        actions.push({
+            id: 'health.dx.add-env-example',
+            title: 'Add .env.example',
+            rationale: 'Documents required environment variables without leaking secrets.',
+            evidence: [],
+            patch: (cur) => ({ ...cur, envExampleExists: true }),
+        });
+    }
+    return actions;
+}
+function buildHealthPlans(metrics) {
+    const dims = [
+        { name: 'Testing', scorer: scoring_1.scoreTest, build: testingActions },
+        { name: 'Quality', scorer: scoring_1.scoreQuality, build: qualityActions },
+        { name: 'Documentation', scorer: scoring_1.scoreDocumentation, build: docsActions },
+        { name: 'Security', scorer: scoring_1.scoreSecurity, build: securityActions },
+        { name: 'Maintainability', scorer: scoring_1.scoreMaintainability, build: maintainabilityActions },
+        { name: 'Developer Experience', scorer: scoring_1.scoreDeveloperExperience, build: dxActions },
+    ];
+    return dims.map((d) => {
+        const baseline = d.scorer(metrics).score;
+        const actions = (0, remediation_1.rank)(d.build(metrics), metrics, d.scorer);
+        // "Ideal" = apply every action's patch in sequence, then score.
+        let ideal = metrics;
+        for (const a of actions)
+            ideal = a.patch(ideal);
+        return {
+            dimension: d.name,
+            baseline,
+            ideal: d.scorer(ideal).score,
+            actions,
+        };
+    });
+}
+//# sourceMappingURL=actions.js.map