@eduardbar/drift 1.4.0 → 1.5.0

package/dist/doctor.js

@@ -1,10 +1,11 @@
 import { existsSync, readdirSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import kleur from 'kleur';
+import { OUTPUT_SCHEMA, withOutputMetadata } from './output-metadata.js';
 const SOURCE_EXTENSIONS = new Set(['.ts', '.tsx', '.js', '.jsx']);
 const IGNORED_DIRECTORIES = new Set(['node_modules', '.git', 'dist', '.next', 'coverage']);
 const DECIMAL_RADIX = 10;
-const MIN_SUPPORTED_NODE_MAJOR = 18;
+const MIN_SUPPORTED_NODE_MAJOR = 20;
 const LOW_MEMORY_SOURCE_FILE_THRESHOLD = 500;
 const DRIFT_CONFIG_CANDIDATES = [
     'drift.config.ts',
@@ -92,7 +93,7 @@ function printConsoleReport(report) {
     process.stdout.write(`${kleur.bold().white('drift doctor')} ${kleur.gray('- environment diagnostics')}\n\n`);
     const nodeStatus = report.node.supported
         ? `${icons.check} ${kleur.green('Node runtime supported')}`
-        : `${icons.warn} ${kleur.yellow('Node runtime below recommended minimum (>=18)')}`;
+        : `${icons.warn} ${kleur.yellow('Node runtime below supported minimum (>=20)')}`;
     process.stdout.write(`${nodeStatus} ${kleur.gray(`(${report.node.version})`)}\n`);
     if (report.project.packageJsonFound) {
         process.stdout.write(`${icons.check} package.json found\n`);
@@ -120,10 +121,16 @@ function printConsoleReport(report) {
     }
     process.stdout.write('\n');
 }
+export function formatDoctorJsonObject(report) {
+    return withOutputMetadata(report, OUTPUT_SCHEMA.doctor);
+}
+export function formatDoctorJson(report) {
+    return JSON.stringify(formatDoctorJsonObject(report), null, 2);
+}
 export async function runDoctor(projectPath, options) {
     const report = buildDoctorReport(projectPath);
     if (options?.json) {
-        process.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
+        process.stdout.write(`${formatDoctorJson(report)}\n`);
     }
     else {
         printConsoleReport(report);

package/dist/guard-baseline.d.ts

@@ -0,0 +1,12 @@
+import type { GuardBaseline, IssueSeverity } from './guard-types.js';
+export interface NormalizedBaseline {
+    score?: number;
+    totalIssues?: number;
+    bySeverity: Partial<Record<IssueSeverity, number>>;
+}
+export declare function normalizeBaseline(baseline: GuardBaseline): NormalizedBaseline;
+export declare function readBaselineFromFile(projectPath: string, baselinePath?: string): {
+    baseline: NormalizedBaseline;
+    path: string;
+} | undefined;
+//# sourceMappingURL=guard-baseline.d.ts.map

package/dist/guard-baseline.js

@@ -0,0 +1,57 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+function parseNumber(value) {
+    return typeof value === 'number' && !Number.isNaN(value) ? value : undefined;
+}
+function firstDefinedNumber(values) {
+    for (const value of values) {
+        const parsed = parseNumber(value);
+        if (parsed !== undefined) {
+            return parsed;
+        }
+    }
+    return undefined;
+}
+function normalizeSeverity(baseline, severity) {
+    const summaryBySeverity = baseline.summary?.[`${severity}s`];
+    return firstDefinedNumber([
+        baseline.bySeverity?.[severity],
+        severity === 'error' ? baseline.errors : undefined,
+        severity === 'warning' ? baseline.warnings : undefined,
+        severity === 'info' ? baseline.infos : undefined,
+        summaryBySeverity,
+    ]);
+}
+function hasAnchor(baseline) {
+    if (baseline.score !== undefined || baseline.totalIssues !== undefined) {
+        return true;
+    }
+    const severities = ['error', 'warning', 'info'];
+    return severities.some((severity) => baseline.bySeverity[severity] !== undefined);
+}
+export function normalizeBaseline(baseline) {
+    const normalized = {
+        score: parseNumber(baseline.score),
+        totalIssues: parseNumber(baseline.totalIssues),
+        bySeverity: {
+            error: normalizeSeverity(baseline, 'error'),
+            warning: normalizeSeverity(baseline, 'warning'),
+            info: normalizeSeverity(baseline, 'info'),
+        },
+    };
+    if (!hasAnchor(normalized)) {
+        throw new Error('Invalid guard baseline: expected score, totalIssues, or severity counters (error/warning/info).');
+    }
+    return normalized;
+}
+export function readBaselineFromFile(projectPath, baselinePath) {
+    const resolvedBaselinePath = resolve(projectPath, baselinePath ?? 'drift-baseline.json');
+    if (!existsSync(resolvedBaselinePath))
+        return undefined;
+    const raw = JSON.parse(readFileSync(resolvedBaselinePath, 'utf8'));
+    return {
+        baseline: normalizeBaseline(raw),
+        path: resolvedBaselinePath,
+    };
+}
+//# sourceMappingURL=guard-baseline.js.map

package/dist/guard-metrics.d.ts

@@ -0,0 +1,6 @@
+import type { DriftDiff, DriftReport } from './types.js';
+import type { GuardMetrics } from './guard-types.js';
+import type { NormalizedBaseline } from './guard-baseline.js';
+export declare function buildMetricsFromDiff(diff: DriftDiff): GuardMetrics;
+export declare function buildMetricsFromBaseline(current: DriftReport, baseline: NormalizedBaseline): GuardMetrics;
+//# sourceMappingURL=guard-metrics.d.ts.map

package/dist/guard-metrics.js

@@ -0,0 +1,39 @@
+function createSeverityDelta() {
+    return {
+        error: 0,
+        warning: 0,
+        info: 0,
+    };
+}
+function applySeverityDelta(delta, issues, direction) {
+    for (const issue of issues) {
+        delta[issue.severity] += direction;
+    }
+}
+function countSeverityDeltaFromDiff(diff) {
+    const severityDelta = createSeverityDelta();
+    for (const file of diff.files) {
+        applySeverityDelta(severityDelta, file.newIssues, 1);
+        applySeverityDelta(severityDelta, file.resolvedIssues, -1);
+    }
+    return severityDelta;
+}
+export function buildMetricsFromDiff(diff) {
+    return {
+        scoreDelta: diff.totalDelta,
+        totalIssuesDelta: diff.newIssuesCount - diff.resolvedIssuesCount,
+        severityDelta: countSeverityDeltaFromDiff(diff),
+    };
+}
+export function buildMetricsFromBaseline(current, baseline) {
+    return {
+        scoreDelta: current.totalScore - (baseline.score ?? current.totalScore),
+        totalIssuesDelta: current.totalIssues - (baseline.totalIssues ?? current.totalIssues),
+        severityDelta: {
+            error: current.summary.errors - (baseline.bySeverity.error ?? current.summary.errors),
+            warning: current.summary.warnings - (baseline.bySeverity.warning ?? current.summary.warnings),
+            info: current.summary.infos - (baseline.bySeverity.info ?? current.summary.infos),
+        },
+    };
+}
+//# sourceMappingURL=guard-metrics.js.map

package/dist/guard-types.d.ts

@@ -1,4 +1,4 @@
-import type { DriftAnalysisOptions, DriftDiff, DriftIssue, DriftReport } from './types.js';
+import type { DriftAnalysisOptions, DriftDiff, DriftIssue, DriftOutputMetadata, DriftReport } from './types.js';
 export type IssueSeverity = DriftIssue['severity'];
 export interface GuardBaseline {
     score?: number;
@@ -54,4 +54,5 @@ export interface GuardResult {
     current: DriftReport;
     diff?: DriftDiff;
 }
+export type GuardResultJson = GuardResult & DriftOutputMetadata;
 //# sourceMappingURL=guard-types.d.ts.map

package/dist/guard.d.ts

@@ -1,4 +1,4 @@
-import type { GuardEvaluation, GuardMetrics, GuardOptions, GuardResult, GuardThresholds } from './guard-types.js';
+import type { GuardEvaluation, GuardMetrics, GuardOptions, GuardResult, GuardResultJson, GuardThresholds } from './guard-types.js';
 interface GuardEvalInput {
     metrics: GuardMetrics;
     budget?: number;
@@ -9,6 +9,8 @@ interface GuardEvalInput {
     };
 }
 export declare function evaluateGuard(input: GuardEvalInput): GuardEvaluation;
+export declare function formatGuardJsonObject(result: GuardResult): GuardResultJson;
+export declare function formatGuardJson(result: GuardResult): string;
 export declare function runGuard(targetPath: string, options?: GuardOptions): Promise<GuardResult>;
 export {};
 //# sourceMappingURL=guard.d.ts.map

package/dist/guard.js

@@ -1,45 +1,12 @@
-import { existsSync, readFileSync } from 'node:fs';
 import { relative, resolve } from 'node:path';
 import { analyzeProject } from './analyzer.js';
 import { loadConfig } from './config.js';
 import { computeDiff } from './diff.js';
 import { cleanupTempDir, extractFilesAtRef } from './git.js';
+import { normalizeBaseline, readBaselineFromFile } from './guard-baseline.js';
+import { buildMetricsFromBaseline, buildMetricsFromDiff } from './guard-metrics.js';
+import { OUTPUT_SCHEMA, withOutputMetadata } from './output-metadata.js';
 import { buildReport } from './reporter.js';
-function parseNumber(value) {
-    return typeof value === 'number' && !Number.isNaN(value) ? value : undefined;
-}
-function normalizeBaseline(baseline) {
-    const bySeverityFromRoot = baseline.bySeverity;
-    const bySeverity = {
-        error: parseNumber(bySeverityFromRoot?.error) ?? parseNumber(baseline.errors) ?? parseNumber(baseline.summary?.errors),
-        warning: parseNumber(bySeverityFromRoot?.warning) ?? parseNumber(baseline.warnings) ?? parseNumber(baseline.summary?.warnings),
-        info: parseNumber(bySeverityFromRoot?.info) ?? parseNumber(baseline.infos) ?? parseNumber(baseline.summary?.infos),
-    };
-    const normalized = {
-        score: parseNumber(baseline.score),
-        totalIssues: parseNumber(baseline.totalIssues),
-        bySeverity,
-    };
-    const hasAnyAnchor = normalized.score !== undefined ||
-        normalized.totalIssues !== undefined ||
-        normalized.bySeverity.error !== undefined ||
-        normalized.bySeverity.warning !== undefined ||
-        normalized.bySeverity.info !== undefined;
-    if (!hasAnyAnchor) {
-        throw new Error('Invalid guard baseline: expected score, totalIssues, or severity counters (error/warning/info).');
-    }
-    return normalized;
-}
-function readBaselineFromFile(projectPath, baselinePath) {
-    const resolvedBaselinePath = resolve(projectPath, baselinePath ?? 'drift-baseline.json');
-    if (!existsSync(resolvedBaselinePath))
-        return undefined;
-    const raw = JSON.parse(readFileSync(resolvedBaselinePath, 'utf8'));
-    return {
-        baseline: normalizeBaseline(raw),
-        path: resolvedBaselinePath,
-    };
-}
 function remapBaseReportPaths(baseReport, tempDir, projectPath) {
     return {
         ...baseReport,
@@ -49,40 +16,6 @@ function remapBaseReportPaths(baseReport, tempDir, projectPath) {
         })),
     };
 }
-function countSeverityDeltaFromDiff(diff) {
-    const severityDelta = {
-        error: 0,
-        warning: 0,
-        info: 0,
-    };
-    for (const file of diff.files) {
-        for (const issue of file.newIssues) {
-            severityDelta[issue.severity] += 1;
-        }
-        for (const issue of file.resolvedIssues) {
-            severityDelta[issue.severity] -= 1;
-        }
-    }
-    return severityDelta;
-}
-function buildMetricsFromDiff(diff) {
-    return {
-        scoreDelta: diff.totalDelta,
-        totalIssuesDelta: diff.newIssuesCount - diff.resolvedIssuesCount,
-        severityDelta: countSeverityDeltaFromDiff(diff),
-    };
-}
-function buildMetricsFromBaseline(current, baseline) {
-    return {
-        scoreDelta: current.totalScore - (baseline.score ?? current.totalScore),
-        totalIssuesDelta: current.totalIssues - (baseline.totalIssues ?? current.totalIssues),
-        severityDelta: {
-            error: current.summary.errors - (baseline.bySeverity.error ?? current.summary.errors),
-            warning: current.summary.warnings - (baseline.bySeverity.warning ?? current.summary.warnings),
-            info: current.summary.infos - (baseline.bySeverity.info ?? current.summary.infos),
-        },
-    };
-}
 function addCheck(checks, input) {
     checks.push({
         id: input.id,
@@ -138,6 +71,12 @@ export function evaluateGuard(input) {
         checks,
     };
 }
+export function formatGuardJsonObject(result) {
+    return withOutputMetadata(result, OUTPUT_SCHEMA.guard);
+}
+export function formatGuardJson(result) {
+    return JSON.stringify(formatGuardJsonObject(result), null, 2);
+}
 export async function runGuard(targetPath, options = {}) {
     const runtimeState = await initializeGuardRuntime(targetPath, options);
     const { projectPath, config, currentReport } = runtimeState;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export type { GuardBaseline, GuardThresholds, GuardOptions, GuardMetrics, GuardC
 export { generateReview, formatReviewMarkdown } from './review.js';
 export { runDoctor } from './doctor.js';
 export type { DoctorOptions } from './doctor.js';
-export { buildTrustReport, formatTrustConsole, formatTrustMarkdown, formatTrustJson, resolveTrustGatePolicy, evaluateTrustGate, shouldFailByMaxRisk, shouldFailTrustGate, normalizeMergeRiskLevel, MERGE_RISK_ORDER, } from './trust.js';
+export { buildTrustReport, formatTrustConsole, formatTrustMarkdown, formatTrustJsonObject, formatTrustJson, resolveTrustGatePolicy, evaluateTrustGate, shouldFailByMaxRisk, shouldFailTrustGate, normalizeMergeRiskLevel, MERGE_RISK_ORDER, } from './trust.js';
 export type { TrustGateOptions, TrustGatePolicyResolutionOptions, TrustGatePolicyResolutionStep, TrustGateEvaluation, } from './trust.js';
 export { computeTrustKpis, computeTrustKpisFromReports, formatTrustKpiConsole, formatTrustKpiJson, } from './trust-kpi.js';
 export { toSarif, diffToSarif } from './sarif.js';

package/dist/index.js

@@ -4,7 +4,7 @@ export { computeDiff } from './diff.js';
 export { runGuard, evaluateGuard } from './guard.js';
 export { generateReview, formatReviewMarkdown } from './review.js';
 export { runDoctor } from './doctor.js';
-export { buildTrustReport, formatTrustConsole, formatTrustMarkdown, formatTrustJson, resolveTrustGatePolicy, evaluateTrustGate, shouldFailByMaxRisk, shouldFailTrustGate, normalizeMergeRiskLevel, MERGE_RISK_ORDER, } from './trust.js';
+export { buildTrustReport, formatTrustConsole, formatTrustMarkdown, formatTrustJsonObject, formatTrustJson, resolveTrustGatePolicy, evaluateTrustGate, shouldFailByMaxRisk, shouldFailTrustGate, normalizeMergeRiskLevel, MERGE_RISK_ORDER, } from './trust.js';
 export { computeTrustKpis, computeTrustKpisFromReports, formatTrustKpiConsole, formatTrustKpiJson, } from './trust-kpi.js';
 export { toSarif, diffToSarif } from './sarif.js';
 export { generateArchitectureMap, generateArchitectureSvg } from './map.js';

package/dist/init.js

@@ -130,7 +130,7 @@ jobs:
 
       - uses: actions/setup-node@v4
         with:
-          node-version: 18
+          node-version: 20
 
       - name: Install drift
         run: npm install -g @eduardbar/drift

package/dist/output-metadata.d.ts

@@ -2,6 +2,8 @@ export declare const OUTPUT_SCHEMA: {
     readonly report: "schemas/drift-report.v1.json";
     readonly trust: "schemas/drift-trust.v1.json";
     readonly ai: "schemas/drift-ai-output.v1.json";
+    readonly doctor: "schemas/drift-doctor.v1.json";
+    readonly guard: "schemas/drift-guard.v1.json";
 };
 type OutputMetadata = {
     $schema: string;

package/dist/output-metadata.js

@@ -6,6 +6,8 @@ export const OUTPUT_SCHEMA = {
     report: 'schemas/drift-report.v1.json',
     trust: 'schemas/drift-trust.v1.json',
     ai: 'schemas/drift-ai-output.v1.json',
+    doctor: 'schemas/drift-doctor.v1.json',
+    guard: 'schemas/drift-guard.v1.json',
 };
 export function withOutputMetadata(payload, schema) {
     return {

package/dist/trust.d.ts

@@ -1,4 +1,4 @@
-import type { DriftDiff, DriftReport, DriftTrustReport, MergeRiskLevel } from './types.js';
+import type { DriftDiff, DriftReport, DriftTrustReport, DriftTrustReportJson, MergeRiskLevel } from './types.js';
 import type { SnapshotEntry } from './snapshot.js';
 import type { TrustGateOptions } from './trust-policy.js';
 export { MERGE_RISK_ORDER, detectBranchName, explainTrustGatePolicy, formatTrustGatePolicyExplanation, normalizeMergeRiskLevel, resolveTrustGatePolicy, } from './trust-policy.js';
@@ -29,6 +29,7 @@ export interface TrustGateEvaluation {
 export declare function buildTrustReport(report: DriftReport, options?: BuildTrustOptions): DriftTrustReport;
 export declare function formatTrustConsole(trust: DriftTrustReport): string;
 export declare function formatTrustMarkdown(trust: DriftTrustReport): string;
+export declare function formatTrustJsonObject(trust: DriftTrustReport): DriftTrustReportJson;
 export declare function formatTrustJson(trust: DriftTrustReport): string;
 export declare function renderTrustOutput(trust: DriftTrustReport, options?: TrustRenderOptions): string;
 export declare function shouldFailByMaxRisk(actual: MergeRiskLevel, allowedMaxRisk: MergeRiskLevel): boolean;

package/dist/trust.js

@@ -109,7 +109,7 @@ export function formatTrustMarkdown(trust) {
     }
     return sections.join('\n');
 }
-function formatTrustJsonObject(trust) {
+export function formatTrustJsonObject(trust) {
     return withOutputMetadata(trust, OUTPUT_SCHEMA.trust);
 }
 export function formatTrustJson(trust) {

package/dist/types.d.ts

@@ -4,6 +4,6 @@ export type { LayerDefinition, ModuleBoundary, DriftPerformanceConfig, DriftAnal
 export type { DriftConfig } from './types/app.js';
 export type { PluginRuleContext, DriftPluginRule, DriftPlugin, LoadedPlugin, PluginLoadError, PluginLoadWarning, } from './types/plugin.js';
 export type { FileDiff, DriftDiff, HistoricalAnalysis, TrendDataPoint, BlameAttribution, DriftTrendReport, DriftBlameReport, } from './types/diff.js';
-export type { GuardBaseline, GuardThresholds, GuardOptions, GuardMetrics, GuardCheck, GuardEvaluation, GuardResult, } from './guard-types.js';
+export type { GuardBaseline, GuardThresholds, GuardOptions, GuardMetrics, GuardCheck, GuardEvaluation, GuardResult, GuardResultJson, } from './guard-types.js';
 export type { SarifLevel, DriftSarifRule, DriftSarifResult, DriftSarifRun, DriftSarifLog, } from './sarif.js';
 //# sourceMappingURL=types.d.ts.map

package/docs/AGENTS.md

@@ -10,7 +10,7 @@ Esta guia define como colaborar en `drift` para mantener calidad tecnica, consis
 
 ### Stack real
 
-- Runtime: Node.js 18+
+- Runtime: Node.js 20.x and 22.x (LTS)
 - Lenguaje: TypeScript (`type: module`)
 - Analisis AST: `ts-morph`
 - CLI: `commander`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eduardbar/drift",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "AI Code Audit CLI for merge trust in AI-assisted PRs",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,10 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "benchmark": "node --import tsx src/benchmark.ts",
-    "smoke:repo": "node ./scripts/smoke-repo.mjs"
+    "smoke:repo": "node ./scripts/smoke-repo.mjs",
+    "check:runtime-policy": "node ./scripts/check-runtime-policy.mjs",
+    "check:docs-drift": "node ./scripts/check-docs-drift.mjs",
+    "check:perf-budget": "node ./scripts/check-performance-budget.mjs"
   },
   "keywords": [
     "vibe-coding",
@@ -28,6 +31,9 @@
   ],
   "author": "eduardbar",
   "license": "MIT",
+  "engines": {
+    "node": "^20.0.0 || ^22.0.0"
+  },
   "homepage": "https://github.com/eduardbar/drift#readme",
   "repository": {
     "type": "git",
@@ -43,9 +49,9 @@
   },
   "devDependencies": {
     "@types/node": "^25.3.0",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@vitest/coverage-v8": "^4.1.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.2"
   }
 }

package/schemas/drift-doctor.v1.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "schemas/drift-doctor.v1.json",
+  "title": "drift doctor v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "$schema",
+    "toolVersion",
+    "targetPath",
+    "node",
+    "project"
+  ],
+  "properties": {
+    "$schema": {
+      "const": "schemas/drift-doctor.v1.json"
+    },
+    "toolVersion": {
+      "type": "string"
+    },
+    "targetPath": {
+      "type": "string"
+    },
+    "node": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["version", "major", "supported"],
+      "properties": {
+        "version": { "type": "string" },
+        "major": { "type": "number" },
+        "supported": { "type": "boolean" }
+      }
+    },
+    "project": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "packageJsonFound",
+        "esm",
+        "tsconfigFound",
+        "sourceFilesCount",
+        "lowMemorySuggested",
+        "driftConfigFile"
+      ],
+      "properties": {
+        "packageJsonFound": { "type": "boolean" },
+        "esm": { "type": "boolean" },
+        "tsconfigFound": { "type": "boolean" },
+        "sourceFilesCount": { "type": "number" },
+        "lowMemorySuggested": { "type": "boolean" },
+        "driftConfigFile": {
+          "type": ["string", "null"]
+        }
+      }
+    }
+  }
+}