@komatikai/trailhead 4.1.0 → 4.2.2

package/dist/shared/release-ready.d.ts

@@ -0,0 +1,27 @@
+import type { CiSummary, GateDecision, GateEvaluation, GateMode } from "./types.js";
+export interface ReleaseReadyInput {
+    gateMode: GateMode;
+    gateDecision: GateDecision;
+    riskScore: number;
+    riskThreshold: number;
+    healthScore: number;
+    healthChecksConfigured: boolean;
+    ciSummary?: CiSummary | null;
+    freezeActive: boolean;
+    freezeMessage?: string;
+    policyFindings?: string[];
+    requireSecurityClear?: boolean;
+    securityBlocked?: boolean;
+}
+export interface ReleaseReadyResult {
+    releaseReady: boolean;
+    reasons: string[];
+}
+/**
+ * Composite release readiness decision (ADR-006).
+ */
+export declare function computeReleaseReady(input: ReleaseReadyInput): ReleaseReadyResult;
+export declare function applyReleaseReadyToEvaluation(evaluation: GateEvaluation, result: ReleaseReadyResult, gateMode: GateMode): GateEvaluation;
+export declare function checkConclusionForEvaluation(evaluation: GateEvaluation): "success" | "neutral" | "failure";
+export declare function shouldBlockMerge(evaluation: GateEvaluation): boolean;
+export declare function resolveCheckName(gateMode: GateMode, configuredName?: string): string;

package/dist/shared/release-ready.js

@@ -0,0 +1,97 @@
+/**
+ * Composite release readiness decision (ADR-006).
+ */
+export function computeReleaseReady(input) {
+    const reasons = [];
+    if (input.gateMode === "risk-only") {
+        if (input.gateDecision === "block") {
+            reasons.push("Risk/policy gate decision is BLOCK");
+        }
+        else if (input.gateDecision === "warn") {
+            reasons.push("Risk/policy gate decision is WARN (non-blocking in risk-only mode)");
+        }
+        return {
+            releaseReady: input.gateDecision !== "block",
+            reasons,
+        };
+    }
+    if (input.ciSummary) {
+        if (!input.ciSummary.allRequiredPassed) {
+            const failed = input.ciSummary.checks.filter((c) => c.required &&
+                (c.status === "fail" || c.status === "missing" || c.status === "stale"));
+            for (const check of failed) {
+                reasons.push(`Required CI check "${check.name}" is ${check.status.toUpperCase()}`);
+            }
+        }
+        if (input.ciSummary.pendingCount > 0) {
+            reasons.push(`${input.ciSummary.pendingCount} required CI check(s) still pending`);
+        }
+    }
+    if (input.gateDecision === "block") {
+        reasons.push("Risk/policy gate decision is BLOCK");
+    }
+    if (input.riskScore > input.riskThreshold) {
+        reasons.push(`Risk score ${input.riskScore} exceeds threshold ${input.riskThreshold}`);
+    }
+    if (input.freezeActive) {
+        reasons.push(`Release freeze active${input.freezeMessage ? `: ${input.freezeMessage}` : ""}`);
+    }
+    if (input.healthChecksConfigured && input.healthScore < 50) {
+        reasons.push(`Health score ${input.healthScore} below minimum (50)`);
+    }
+    if (input.requireSecurityClear && input.securityBlocked) {
+        reasons.push("Security gate requires clearance — blocking alerts present");
+    }
+    const blockingFindings = (input.policyFindings ?? []).filter((f) => /blocking|requires|exceeds|configured to block/i.test(f));
+    if (blockingFindings.length > 0 && input.gateDecision === "block") {
+        for (const finding of blockingFindings.slice(0, 3)) {
+            if (!reasons.includes(finding))
+                reasons.push(finding);
+        }
+    }
+    const releaseReady = reasons.length === 0;
+    return { releaseReady, reasons };
+}
+export function applyReleaseReadyToEvaluation(evaluation, result, gateMode) {
+    return {
+        ...evaluation,
+        releaseReady: result.releaseReady,
+        releaseReadyReasons: result.reasons.length > 0 ? result.reasons : undefined,
+        gateMode,
+    };
+}
+export function checkConclusionForEvaluation(evaluation) {
+    const mode = evaluation.gateMode ?? "risk-only";
+    if (mode === "advisory") {
+        return "neutral";
+    }
+    if (mode === "release-ready") {
+        return evaluation.releaseReady ? "success" : "failure";
+    }
+    switch (evaluation.gateDecision) {
+        case "allow":
+            return "success";
+        case "warn":
+            return "neutral";
+        case "block":
+            return "failure";
+        default: {
+            const _exhaustive = evaluation.gateDecision;
+            return "failure";
+        }
+    }
+}
+export function shouldBlockMerge(evaluation) {
+    const mode = evaluation.gateMode ?? "risk-only";
+    if (mode === "advisory")
+        return false;
+    if (mode === "release-ready")
+        return evaluation.releaseReady === false;
+    return evaluation.gateDecision === "block";
+}
+export function resolveCheckName(gateMode, configuredName) {
+    if (gateMode === "risk-only")
+        return "Trailhead";
+    return configuredName ?? "Trailhead — Release Ready";
+}
+//# sourceMappingURL=release-ready.js.map

package/dist/shared/release-ready.js.map

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