@komatikai/trailhead 3.0.3 → 4.2.2

package/dist/shared/doctor.js

@@ -0,0 +1,308 @@
+import fs from "node:fs";
+import path from "node:path";
+import { checkNameMatches } from "./ci-core.js";
+import { parseRepoConfigContent } from "./config-core.js";
+import { resolveCheckName } from "./release-ready.js";
+const CONFIG_CANDIDATES = [".trailhead.yml", ".deployguard.yml"];
+export function findConfigPath(cwd) {
+    for (const name of CONFIG_CANDIDATES) {
+        const candidate = path.join(cwd, name);
+        if (fs.existsSync(candidate))
+            return candidate;
+    }
+    return null;
+}
+export function loadRepoConfig(cwd) {
+    const configPath = findConfigPath(cwd);
+    if (!configPath) {
+        return {
+            configPath: null,
+            config: null,
+            error: "No .trailhead.yml or .deployguard.yml found",
+        };
+    }
+    const content = fs.readFileSync(configPath, "utf8");
+    const config = parseRepoConfigContent(content);
+    if (!config) {
+        return {
+            configPath,
+            config: null,
+            error: `Failed to parse ${path.basename(configPath)} — check YAML structure and schema fields`,
+        };
+    }
+    return { configPath, config };
+}
+export function collectConfiguredChecks(config) {
+    const names = new Set();
+    for (const context of config.contexts) {
+        for (const name of context.ci?.required_checks ?? []) {
+            names.add(name);
+        }
+        for (const name of context.ci?.optional_checks ?? []) {
+            names.add(name);
+        }
+    }
+    return [...names];
+}
+export function validateConfigStructure(config, configPath) {
+    const findings = [];
+    const fileName = path.basename(configPath);
+    const gateMode = config.gate.mode;
+    if (gateMode !== "risk-only" && config.schema_version < 2) {
+        findings.push({
+            severity: "warn",
+            code: "schema_version",
+            message: `${fileName} uses schema_version ${config.schema_version} with gate.mode=${gateMode} — consider schema_version: 2 and contexts[]`,
+        });
+    }
+    const risk = config.thresholds.risk;
+    const warn = config.thresholds.warn;
+    if (risk !== undefined && warn !== undefined && warn >= risk) {
+        findings.push({
+            severity: "warn",
+            code: "threshold_order",
+            message: `warn threshold (${warn}) should be lower than risk threshold (${risk})`,
+        });
+    }
+    if (gateMode !== "risk-only") {
+        if (config.contexts.length === 0) {
+            findings.push({
+                severity: "error",
+                code: "missing_contexts",
+                message: "release-ready/advisory mode requires at least one contexts[] entry with ci.required_checks",
+            });
+        }
+        for (const context of config.contexts) {
+            const required = context.ci?.required_checks ?? [];
+            if (required.length === 0) {
+                findings.push({
+                    severity: "warn",
+                    code: "empty_required_checks",
+                    message: `Context "${context.name}" has no ci.required_checks — release-ready may not wait for CI`,
+                });
+            }
+        }
+    }
+    const gateCheck = resolveCheckName(gateMode, config.gate.check_name);
+    if (gateMode !== "risk-only" && !gateCheck.includes("Release Ready")) {
+        findings.push({
+            severity: "info",
+            code: "custom_check_name",
+            message: `Branch protection should require check name "${gateCheck}"`,
+        });
+    }
+    return findings;
+}
+export function compareConfiguredChecks(configuredChecks, observedChecks) {
+    if (observedChecks.length === 0) {
+        return [];
+    }
+    const findings = [];
+    const observed = [...new Set(observedChecks)];
+    for (const configured of configuredChecks) {
+        const matched = observed.some((actual) => checkNameMatches(configured, actual));
+        if (!matched) {
+            findings.push({
+                severity: "warn",
+                code: "unknown_check_name",
+                message: `Configured check "${configured}" did not match any recent GitHub check run`,
+            });
+        }
+    }
+    const selfChecks = new Set([
+        "Trailhead",
+        "Trailhead — Release Ready",
+        resolveCheckName("release-ready"),
+        resolveCheckName("risk-only"),
+    ]);
+    for (const actual of observed) {
+        if (selfChecks.has(actual))
+            continue;
+        const referenced = configuredChecks.some((configured) => checkNameMatches(configured, actual));
+        if (!referenced) {
+            findings.push({
+                severity: "info",
+                code: "unconfigured_check",
+                message: `GitHub check "${actual}" is not referenced in contexts[].ci (optional unless required)`,
+            });
+        }
+    }
+    return findings;
+}
+export function parseRepoRef(input) {
+    const match = input.match(/^([^/]+)\/([^/]+)$/);
+    if (!match)
+        return null;
+    return { owner: match[1], repo: match[2] };
+}
+async function githubRequest(token, url) {
+    const response = await fetch(url, {
+        headers: {
+            Accept: "application/vnd.github+json",
+            Authorization: `Bearer ${token}`,
+            "X-GitHub-Api-Version": "2022-11-28",
+        },
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => "");
+        return {
+            ok: false,
+            status: response.status,
+            message: body || response.statusText,
+        };
+    }
+    return { ok: true, data: (await response.json()) };
+}
+async function resolveCommitSha(token, repoRef, ref) {
+    if (ref)
+        return ref;
+    const pulls = await githubRequest(token, `https://api.github.com/repos/${repoRef.owner}/${repoRef.repo}/pulls?state=open&per_page=1`);
+    if (pulls.ok && pulls.data[0]?.head.sha) {
+        return pulls.data[0].head.sha;
+    }
+    const repo = await githubRequest(token, `https://api.github.com/repos/${repoRef.owner}/${repoRef.repo}`);
+    if (!repo.ok)
+        return null;
+    const branch = await githubRequest(token, `https://api.github.com/repos/${repoRef.owner}/${repoRef.repo}/branches/${encodeURIComponent(repo.data.default_branch)}`);
+    return branch.ok ? branch.data.commit.sha : null;
+}
+export async function fetchObservedCheckNames(options) {
+    const sha = await resolveCommitSha(options.token, options.repo, options.ref);
+    if (!sha) {
+        return { checks: [], error: "Could not resolve a commit SHA for check lookup" };
+    }
+    const names = new Set();
+    let page = 1;
+    while (true) {
+        const result = await githubRequest(options.token, `https://api.github.com/repos/${options.repo.owner}/${options.repo.repo}/commits/${sha}/check-runs?per_page=100&page=${page}`);
+        if (!result.ok) {
+            return {
+                checks: [],
+                error: `GitHub Checks API failed (HTTP ${result.status})`,
+            };
+        }
+        for (const run of result.data.check_runs) {
+            names.add(run.name);
+        }
+        if (result.data.check_runs.length < 100)
+            break;
+        page += 1;
+    }
+    return { checks: [...names].sort() };
+}
+export async function runDoctor(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const loaded = loadRepoConfig(cwd);
+    const findings = [];
+    if (!loaded.configPath || !loaded.config) {
+        findings.push({
+            severity: "error",
+            code: "config_missing",
+            message: loaded.error ?? "Configuration file not found",
+        });
+        return {
+            configPath: loaded.configPath,
+            configValid: false,
+            gateMode: "risk-only",
+            expectedCheckName: "Trailhead",
+            configuredChecks: [],
+            observedChecks: [],
+            findings,
+            ok: false,
+        };
+    }
+    const config = loaded.config;
+    const gateMode = config.gate.mode;
+    const expectedCheckName = resolveCheckName(gateMode, config.gate.check_name);
+    const configuredChecks = collectConfiguredChecks(config);
+    findings.push(...validateConfigStructure(config, loaded.configPath));
+    let observedChecks = [];
+    if (!options.offline) {
+        const token = options.githubToken ?? process.env.GITHUB_TOKEN ?? "";
+        const repoInput = options.repo ?? process.env.GITHUB_REPOSITORY ?? "";
+        const repoRef = parseRepoRef(repoInput);
+        if (!token) {
+            findings.push({
+                severity: "info",
+                code: "offline_checks",
+                message: "Set GITHUB_TOKEN (or pass --token) to compare configured checks against GitHub",
+            });
+        }
+        else if (!repoRef) {
+            findings.push({
+                severity: "info",
+                code: "offline_checks",
+                message: "Set GITHUB_REPOSITORY (or pass --repo owner/name) to compare checks against GitHub",
+            });
+        }
+        else {
+            const observed = await fetchObservedCheckNames({
+                token,
+                repo: repoRef,
+                ref: options.ref,
+            });
+            observedChecks = observed.checks;
+            if (observed.error) {
+                findings.push({
+                    severity: "warn",
+                    code: "github_checks",
+                    message: observed.error,
+                });
+            }
+            else if (configuredChecks.length > 0) {
+                findings.push(...compareConfiguredChecks(configuredChecks, observedChecks));
+            }
+        }
+    }
+    const ok = !findings.some((finding) => finding.severity === "error");
+    return {
+        configPath: loaded.configPath,
+        configValid: true,
+        gateMode,
+        expectedCheckName,
+        configuredChecks,
+        observedChecks,
+        findings,
+        ok,
+    };
+}
+export function formatDoctorReport(report) {
+    const lines = [];
+    lines.push("Trailhead Doctor");
+    lines.push("================");
+    lines.push("");
+    if (report.configPath) {
+        lines.push(`Config: ${report.configPath}`);
+    }
+    else {
+        lines.push("Config: (not found)");
+    }
+    lines.push(`Gate mode: ${report.gateMode}`);
+    lines.push(`Expected branch protection check: ${report.expectedCheckName}`);
+    if (report.configuredChecks.length > 0) {
+        lines.push(`Configured CI checks: ${report.configuredChecks.join(", ")}`);
+    }
+    if (report.observedChecks.length > 0) {
+        lines.push(`Observed GitHub checks: ${report.observedChecks.join(", ")}`);
+    }
+    if (report.findings.length === 0) {
+        lines.push("");
+        lines.push("No issues found.");
+        return lines.join("\n");
+    }
+    lines.push("");
+    for (const finding of report.findings) {
+        const label = finding.severity === "error"
+            ? "ERROR"
+            : finding.severity === "warn"
+                ? "WARN"
+                : "INFO";
+        lines.push(`${label} [${finding.code}] ${finding.message}`);
+    }
+    lines.push("");
+    lines.push(report.ok
+        ? "Result: OK (review warnings before release-ready rollout)"
+        : "Result: FAILED");
+    return lines.join("\n");
+}
+//# sourceMappingURL=doctor.js.map

package/dist/shared/doctor.js.map

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

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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"}