@archpilotlabs/archpilot 0.2.2 → 0.2.3

package/dist/core/src/architectureHealthHistory.js

@@ -0,0 +1,208 @@
+"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.getArchitectureHealthHistoryPath = getArchitectureHealthHistoryPath;
+exports.createArchitectureHealthSnapshot = createArchitectureHealthSnapshot;
+exports.buildArchitectureHealthTrend = buildArchitectureHealthTrend;
+exports.buildArchitectureHealthTrendFromSnapshotScores = buildArchitectureHealthTrendFromSnapshotScores;
+exports.readArchitectureHealthHistory = readArchitectureHealthHistory;
+exports.appendArchitectureHealthSnapshot = appendArchitectureHealthSnapshot;
+const path = __importStar(require("node:path"));
+const node_fs_1 = require("node:fs");
+const historyVersion = 1;
+const defaultMaxSnapshots = 100;
+function clampScore(score) {
+    if (!Number.isFinite(score)) {
+        return 0;
+    }
+    if (score < 0) {
+        return 0;
+    }
+    if (score > 100) {
+        return 100;
+    }
+    return Math.round(score);
+}
+function clampCount(value) {
+    if (!Number.isFinite(value) || value < 0) {
+        return 0;
+    }
+    return Math.floor(value);
+}
+function normalizeCategoryScores(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return {};
+    }
+    const normalized = Object.entries(value)
+        .filter(([category]) => category.trim().length > 0)
+        .map(([category, score]) => [category, clampScore(Number(score))])
+        .sort(([left], [right]) => left.localeCompare(right))
+        .reduce((accumulator, [category, score]) => {
+        accumulator[category] = score;
+        return accumulator;
+    }, {});
+    return normalized;
+}
+function normalizeSnapshot(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return undefined;
+    }
+    const typed = value;
+    if (typeof typed.generatedAtUtc !== 'string' || typed.generatedAtUtc.trim().length === 0) {
+        return undefined;
+    }
+    return {
+        generatedAtUtc: typed.generatedAtUtc,
+        overallScore: clampScore(Number(typed.overallScore)),
+        categoryScores: normalizeCategoryScores(typed.categoryScores),
+        totalChecks: clampCount(Number(typed.totalChecks)),
+        errors: clampCount(Number(typed.errors)),
+        warnings: clampCount(Number(typed.warnings)),
+        info: clampCount(Number(typed.info)),
+        passed: clampCount(Number(typed.passed)),
+    };
+}
+function normalizeHistory(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return { version: historyVersion, snapshots: [] };
+    }
+    const typed = value;
+    const snapshotsRaw = Array.isArray(typed.snapshots) ? typed.snapshots : [];
+    const snapshots = snapshotsRaw
+        .map((entry) => normalizeSnapshot(entry))
+        .filter((entry) => !!entry)
+        .sort((left, right) => left.generatedAtUtc.localeCompare(right.generatedAtUtc));
+    return {
+        version: historyVersion,
+        snapshots,
+    };
+}
+function getArchitectureHealthHistoryPath(workspaceRoot) {
+    return path.join(workspaceRoot, '.archpilot', 'history', 'health-history.json');
+}
+function createArchitectureHealthSnapshot(input) {
+    return {
+        generatedAtUtc: input.generatedAtUtc,
+        overallScore: clampScore(input.overallScore),
+        categoryScores: normalizeCategoryScores(input.categoryScores),
+        totalChecks: clampCount(input.totalChecks),
+        errors: clampCount(input.errors),
+        warnings: clampCount(input.warnings),
+        info: clampCount(input.info),
+        passed: clampCount(input.passed),
+    };
+}
+function buildArchitectureHealthTrend(history) {
+    const ordered = [...history.snapshots].sort((left, right) => left.generatedAtUtc.localeCompare(right.generatedAtUtc));
+    if (ordered.length === 0) {
+        return {
+            currentScore: 0,
+            trendDirection: 'no-history',
+        };
+    }
+    const current = ordered[ordered.length - 1];
+    if (ordered.length === 1) {
+        return {
+            currentScore: current.overallScore,
+            trendDirection: 'no-history',
+        };
+    }
+    const previous = ordered[ordered.length - 2];
+    const delta = current.overallScore - previous.overallScore;
+    return {
+        currentScore: current.overallScore,
+        previousScore: previous.overallScore,
+        delta,
+        trendDirection: delta > 0 ? 'improving' : delta < 0 ? 'declining' : 'stable',
+    };
+}
+function buildArchitectureHealthTrendFromSnapshotScores(currentScore, previousScore) {
+    if (previousScore === undefined) {
+        return {
+            currentScore,
+            trendDirection: 'no-history',
+        };
+    }
+    const delta = currentScore - previousScore;
+    return {
+        currentScore,
+        previousScore,
+        delta,
+        trendDirection: delta > 0 ? 'improving' : delta < 0 ? 'declining' : 'stable',
+    };
+}
+async function readArchitectureHealthHistory(workspaceRoot) {
+    const historyPath = getArchitectureHealthHistoryPath(workspaceRoot);
+    try {
+        const content = await node_fs_1.promises.readFile(historyPath, { encoding: 'utf8' });
+        const parsed = JSON.parse(content);
+        return { history: normalizeHistory(parsed), recoveredFromInvalidHistory: false };
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {
+                history: { version: historyVersion, snapshots: [] },
+                recoveredFromInvalidHistory: false,
+            };
+        }
+        return {
+            history: { version: historyVersion, snapshots: [] },
+            recoveredFromInvalidHistory: true,
+        };
+    }
+}
+async function appendArchitectureHealthSnapshot(workspaceRoot, snapshot, options) {
+    const maxSnapshots = options?.maxSnapshots ?? defaultMaxSnapshots;
+    const historyPath = getArchitectureHealthHistoryPath(workspaceRoot);
+    const loaded = await readArchitectureHealthHistory(workspaceRoot);
+    const snapshots = [...loaded.history.snapshots, snapshot]
+        .sort((left, right) => left.generatedAtUtc.localeCompare(right.generatedAtUtc))
+        .slice(-Math.max(1, maxSnapshots));
+    const history = {
+        version: historyVersion,
+        snapshots,
+    };
+    await node_fs_1.promises.mkdir(path.dirname(historyPath), { recursive: true });
+    await node_fs_1.promises.writeFile(historyPath, `${JSON.stringify(history, null, 2)}\n`, {
+        encoding: 'utf8',
+    });
+    return {
+        historyPath,
+        history,
+        trend: buildArchitectureHealthTrend(history),
+        recoveredFromInvalidHistory: loaded.recoveredFromInvalidHistory,
+    };
+}
+//# sourceMappingURL=architectureHealthHistory.js.map

package/dist/core/src/architectureHealthHistory.js.map

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