@komatikai/trailhead 3.0.3 → 4.2.2

package/dist/shared/ci-core.js

@@ -0,0 +1,210 @@
+export const DEFAULT_SELF_CHECK_NAMES = ["Trailhead", "Trailhead — Release Ready"];
+/**
+ * Map GitHub check conclusion/status to Trailhead CI status (ADR-009).
+ */
+export function classifyCheck(status, conclusion) {
+    if (status === "completed") {
+        switch (conclusion) {
+            case "success":
+                return "pass";
+            case "skipped":
+            case "neutral":
+                return "skip";
+            case "failure":
+            case "timed_out":
+            case "action_required":
+            case "cancelled":
+                return "fail";
+            default:
+                return "pending";
+        }
+    }
+    if (status === "in_progress" || status === "queued" || status === "pending") {
+        return "pending";
+    }
+    return "pending";
+}
+function isSelfCheck(name, excludeNames) {
+    const lower = name.toLowerCase();
+    return excludeNames.some((n) => n.toLowerCase() === lower);
+}
+export function checkNameMatches(configured, actual) {
+    if (configured === actual)
+        return true;
+    if (configured.toLowerCase() === actual.toLowerCase())
+        return true;
+    return actual.toLowerCase().startsWith(configured.toLowerCase());
+}
+function findManifestJob(manifest, configuredName) {
+    return manifest.jobs.find((job) => checkNameMatches(configuredName, job.name));
+}
+function statusFromManifestJob(job) {
+    switch (job.outcome) {
+        case "passed":
+            return "pass";
+        case "skipped":
+            return "skip";
+        case "failed":
+        case "cancelled":
+            return "fail";
+        case "pending":
+            return "pending";
+        case "ran":
+            return undefined;
+        default: {
+            const _exhaustive = job.outcome;
+            return undefined;
+        }
+    }
+}
+function applyManifestToCheck(check, manifest, configuredName) {
+    if (!manifest)
+        return check;
+    const manifestJob = findManifestJob(manifest, configuredName);
+    if (!manifestJob)
+        return check;
+    const manifestStatus = statusFromManifestJob(manifestJob);
+    if (manifestStatus === "skip") {
+        return {
+            ...check,
+            status: "skip",
+            conclusion: manifestJob.reason ?? check.conclusion,
+        };
+    }
+    if (manifestStatus && (check.status === "missing" || check.status === "pending")) {
+        return {
+            ...check,
+            status: manifestStatus,
+            conclusion: manifestJob.reason ?? check.conclusion,
+        };
+    }
+    return check;
+}
+function checkFromManifestOnly(configuredName, manifest) {
+    const manifestJob = findManifestJob(manifest, configuredName);
+    if (!manifestJob)
+        return undefined;
+    const status = statusFromManifestJob(manifestJob);
+    if (!status)
+        return undefined;
+    return {
+        name: configuredName,
+        status,
+        conclusion: manifestJob.reason,
+        detailsUrl: manifestJob.details_url,
+        required: false,
+    };
+}
+export function normalizeCheckRuns(runs, excludeCheckNames = DEFAULT_SELF_CHECK_NAMES) {
+    return runs
+        .filter((r) => !isSelfCheck(r.name, excludeCheckNames))
+        .map((r) => ({
+        name: r.name,
+        status: classifyCheck(r.status, r.conclusion),
+        conclusion: r.conclusion ?? undefined,
+        detailsUrl: r.details_url ?? r.html_url ?? undefined,
+        required: false,
+    }));
+}
+export function evaluateRequiredChecks(allChecks, ciConfig, manifest) {
+    const requiredNames = ciConfig.required_checks;
+    const optionalNames = ciConfig.optional_checks;
+    const missingPolicy = ciConfig.missing_required;
+    const evaluated = [];
+    const seen = new Set();
+    for (const reqName of requiredNames) {
+        const match = allChecks.find((c) => checkNameMatches(reqName, c.name));
+        if (match) {
+            const resolved = applyManifestToCheck({ ...match, name: reqName, required: true }, manifest ?? undefined, reqName);
+            evaluated.push(resolved);
+            seen.add(match.name);
+        }
+        else if (manifest) {
+            const fromManifest = checkFromManifestOnly(reqName, manifest);
+            if (fromManifest) {
+                evaluated.push({ ...fromManifest, name: reqName, required: true });
+            }
+            else {
+                evaluated.push({
+                    name: reqName,
+                    status: missingPolicy === "skip" ? "skip" : "missing",
+                    required: true,
+                });
+            }
+        }
+        else {
+            evaluated.push({
+                name: reqName,
+                status: missingPolicy === "skip" ? "skip" : "missing",
+                required: true,
+            });
+        }
+    }
+    for (const optName of optionalNames) {
+        const match = allChecks.find((c) => checkNameMatches(optName, c.name));
+        if (match) {
+            const resolved = applyManifestToCheck({ ...match, name: optName, required: false }, manifest ?? undefined, optName);
+            evaluated.push(resolved);
+            seen.add(match.name);
+        }
+        else if (manifest) {
+            const fromManifest = checkFromManifestOnly(optName, manifest);
+            if (fromManifest) {
+                evaluated.push({ ...fromManifest, name: optName, required: false });
+            }
+            else {
+                evaluated.push({
+                    name: optName,
+                    status: "missing",
+                    required: false,
+                });
+            }
+        }
+        else {
+            evaluated.push({
+                name: optName,
+                status: "missing",
+                required: false,
+            });
+        }
+    }
+    for (const check of allChecks) {
+        if (!seen.has(check.name)) {
+            evaluated.push({ ...check, required: false });
+        }
+    }
+    const requiredChecks = evaluated.filter((c) => c.required);
+    const pendingCount = requiredChecks.filter((c) => c.status === "pending").length;
+    const failedCount = requiredChecks.filter((c) => c.status === "fail" || c.status === "missing" || c.status === "stale").length;
+    const missingCount = requiredChecks.filter((c) => c.status === "missing").length;
+    const allRequiredPassed = requiredNames.length === 0 ||
+        requiredChecks.every((c) => c.status === "pass" || c.status === "skip");
+    return {
+        checks: evaluated,
+        allRequiredPassed,
+        pendingCount,
+        failedCount,
+        missingCount,
+    };
+}
+export function formatCiStatusIcon(status) {
+    switch (status) {
+        case "pass":
+            return "✅";
+        case "fail":
+            return "❌";
+        case "skip":
+            return "⏭️";
+        case "pending":
+            return "⏳";
+        case "stale":
+            return "⚠️";
+        case "missing":
+            return "❓";
+        default: {
+            const _exhaustive = status;
+            return "•";
+        }
+    }
+}
+//# sourceMappingURL=ci-core.js.map

package/dist/shared/ci-core.js.map

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

package/dist/shared/ci-manifest.d.ts

@@ -0,0 +1,82 @@
+import { z } from "zod";
+/** Job outcome as emitted by path-filtered workflows (E15). */
+export declare const CiManifestJobOutcome: z.ZodEnum<["ran", "passed", "skipped", "failed", "pending", "cancelled"]>;
+export type CiManifestJobOutcome = z.infer<typeof CiManifestJobOutcome>;
+/** Why a job did not run — `paths-filter` is the primary v4.2 use case. */
+export declare const CiManifestSkipReason: z.ZodEnum<["paths-filter", "paths-ignore", "manual", "condition", "concurrency", "workflow_dispatch", "other"]>;
+export type CiManifestSkipReason = z.infer<typeof CiManifestSkipReason>;
+export declare const CiManifestJob: z.ZodObject<{
+    name: z.ZodString;
+    outcome: z.ZodEnum<["ran", "passed", "skipped", "failed", "pending", "cancelled"]>;
+    reason: z.ZodOptional<z.ZodEnum<["paths-filter", "paths-ignore", "manual", "condition", "concurrency", "workflow_dispatch", "other"]>>;
+    check_run_id: z.ZodOptional<z.ZodNumber>;
+    details_url: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+    reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+    check_run_id?: number | undefined;
+    details_url?: string | undefined;
+}, {
+    name: string;
+    outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+    reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+    check_run_id?: number | undefined;
+    details_url?: string | undefined;
+}>;
+export type CiManifestJob = z.infer<typeof CiManifestJob>;
+export declare const CiManifest: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    generated_at: z.ZodOptional<z.ZodString>;
+    commit_sha: z.ZodOptional<z.ZodString>;
+    workflow: z.ZodOptional<z.ZodString>;
+    run_id: z.ZodOptional<z.ZodNumber>;
+    jobs: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        outcome: z.ZodEnum<["ran", "passed", "skipped", "failed", "pending", "cancelled"]>;
+        reason: z.ZodOptional<z.ZodEnum<["paths-filter", "paths-ignore", "manual", "condition", "concurrency", "workflow_dispatch", "other"]>>;
+        check_run_id: z.ZodOptional<z.ZodNumber>;
+        details_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+        reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+        check_run_id?: number | undefined;
+        details_url?: string | undefined;
+    }, {
+        name: string;
+        outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+        reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+        check_run_id?: number | undefined;
+        details_url?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    schema_version: 1;
+    jobs: {
+        name: string;
+        outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+        reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+        check_run_id?: number | undefined;
+        details_url?: string | undefined;
+    }[];
+    generated_at?: string | undefined;
+    commit_sha?: string | undefined;
+    workflow?: string | undefined;
+    run_id?: number | undefined;
+}, {
+    schema_version: 1;
+    jobs: {
+        name: string;
+        outcome: "ran" | "passed" | "skipped" | "failed" | "pending" | "cancelled";
+        reason?: "paths-filter" | "paths-ignore" | "manual" | "condition" | "concurrency" | "workflow_dispatch" | "other" | undefined;
+        check_run_id?: number | undefined;
+        details_url?: string | undefined;
+    }[];
+    generated_at?: string | undefined;
+    commit_sha?: string | undefined;
+    workflow?: string | undefined;
+    run_id?: number | undefined;
+}>;
+export type CiManifest = z.infer<typeof CiManifest>;
+export declare function parseCiManifest(raw: unknown): CiManifest;
+export declare function readCiManifestFile(filePath: string): CiManifest | null;

package/dist/shared/ci-manifest.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+/** Job outcome as emitted by path-filtered workflows (E15). */
+export const CiManifestJobOutcome = z.enum([
+    "ran",
+    "passed",
+    "skipped",
+    "failed",
+    "pending",
+    "cancelled",
+]);
+/** Why a job did not run — `paths-filter` is the primary v4.2 use case. */
+export const CiManifestSkipReason = z.enum([
+    "paths-filter",
+    "paths-ignore",
+    "manual",
+    "condition",
+    "concurrency",
+    "workflow_dispatch",
+    "other",
+]);
+export const CiManifestJob = z.object({
+    name: z.string().min(1),
+    outcome: CiManifestJobOutcome,
+    reason: CiManifestSkipReason.optional(),
+    check_run_id: z.number().int().positive().optional(),
+    details_url: z.string().url().optional(),
+});
+export const CiManifest = z.object({
+    schema_version: z.literal(1),
+    generated_at: z.string().optional(),
+    commit_sha: z.string().optional(),
+    workflow: z.string().optional(),
+    run_id: z.number().int().positive().optional(),
+    jobs: z.array(CiManifestJob),
+});
+export function parseCiManifest(raw) {
+    return CiManifest.parse(raw);
+}
+export function readCiManifestFile(filePath) {
+    try {
+        const resolved = path.resolve(filePath);
+        const contents = fs.readFileSync(resolved, "utf8");
+        return parseCiManifest(JSON.parse(contents));
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=ci-manifest.js.map

package/dist/shared/ci-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-manifest.js","sourceRoot":"","sources":["../../src/shared/ci-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,KAAK;IACL,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,WAAW;CACZ,CAAC,CAAC;AAGH,2EAA2E;AAC3E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,IAAI,CAAC;IACzC,cAAc;IACd,cAAc;IACd,QAAQ;IACR,WAAW;IACX,aAAa;IACb,mBAAmB;IACnB,OAAO;CACR,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,oBAAoB,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACzC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC;CAC7B,CAAC,CAAC;AAGH,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACnD,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/shared/config-core.d.ts

@@ -0,0 +1,5 @@
+import type { RepoConfig as RepoConfigType } from "./types.js";
+export declare const SUPPORTED_CONFIG_SCHEMA_VERSIONS: Set<number>;
+export declare const CURRENT_CONFIG_SCHEMA_VERSION = 2;
+export declare function parseYaml(input: string): unknown;
+export declare function parseRepoConfigContent(content: string): RepoConfigType | null;

package/dist/shared/config-core.js

@@ -0,0 +1,127 @@
+import { RepoConfig } from "./types.js";
+export const SUPPORTED_CONFIG_SCHEMA_VERSIONS = new Set([1, 2]);
+export const CURRENT_CONFIG_SCHEMA_VERSION = 2;
+export function parseYaml(input) {
+    const lines = input
+        .split("\n")
+        .map((line) => line.replace(/\r$/, ""))
+        .filter((line) => line.trim() !== "" && !line.trim().startsWith("#"));
+    const root = {};
+    const stack = [{ indent: -1, value: root }];
+    const parseScalar = (value) => {
+        const v = value.trim();
+        if ((v.startsWith('"') && v.endsWith('"')) ||
+            (v.startsWith("'") && v.endsWith("'"))) {
+            return v.slice(1, -1);
+        }
+        if (v === "true")
+            return true;
+        if (v === "false")
+            return false;
+        if (v === "null")
+            return null;
+        const n = Number(v);
+        if (!Number.isNaN(n) && v !== "")
+            return n;
+        return v;
+    };
+    const findNextSignificantLine = (fromIndex) => {
+        for (let i = fromIndex + 1; i < lines.length; i += 1) {
+            const candidate = lines[i];
+            if (candidate.trim() !== "" && !candidate.trim().startsWith("#")) {
+                return candidate;
+            }
+        }
+        return null;
+    };
+    for (let i = 0; i < lines.length; i += 1) {
+        const line = lines[i];
+        const indent = line.match(/^ */)?.[0].length ?? 0;
+        const trimmed = line.trim();
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const container = stack[stack.length - 1].value;
+        if (trimmed.startsWith("- ")) {
+            if (!Array.isArray(container))
+                continue;
+            const itemRaw = trimmed.slice(2).trim();
+            if (itemRaw === "") {
+                const child = {};
+                container.push(child);
+                stack.push({ indent, value: child });
+                continue;
+            }
+            const itemKeyMatch = itemRaw.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+            if (itemKeyMatch) {
+                const child = {};
+                const [, itemKey, itemVal] = itemKeyMatch;
+                if (itemVal === "") {
+                    const nextLine = findNextSignificantLine(i);
+                    const nextIndent = nextLine?.match(/^ */)?.[0].length ?? -1;
+                    const nextTrimmed = nextLine?.trim() ?? "";
+                    const useArray = nextLine !== null && nextIndent > indent && nextTrimmed.startsWith("- ");
+                    child[itemKey] = useArray ? [] : {};
+                    if (!useArray &&
+                        typeof child[itemKey] === "object" &&
+                        child[itemKey] !== null) {
+                        stack.push({ indent, value: child[itemKey] });
+                    }
+                }
+                else {
+                    const trimmedVal = itemVal.trim();
+                    if (trimmedVal.startsWith("[") && trimmedVal.endsWith("]")) {
+                        const inner = trimmedVal.slice(1, -1).trim();
+                        child[itemKey] =
+                            inner === ""
+                                ? []
+                                : inner.split(",").map((item) => parseScalar(item.trim()));
+                    }
+                    else {
+                        child[itemKey] = parseScalar(itemVal);
+                    }
+                }
+                container.push(child);
+                stack.push({ indent, value: child });
+                continue;
+            }
+            container.push(parseScalar(itemRaw));
+            continue;
+        }
+        const keyMatch = trimmed.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
+        if (!keyMatch ||
+            typeof container !== "object" ||
+            container === null ||
+            Array.isArray(container)) {
+            continue;
+        }
+        const [, key, rawVal] = keyMatch;
+        if (rawVal !== "") {
+            const trimmedVal = rawVal.trim();
+            if (trimmedVal.startsWith("[") && trimmedVal.endsWith("]")) {
+                const inner = trimmedVal.slice(1, -1).trim();
+                container[key] =
+                    inner === "" ? [] : inner.split(",").map((item) => parseScalar(item.trim()));
+                continue;
+            }
+            container[key] = parseScalar(rawVal);
+            continue;
+        }
+        const nextLine = findNextSignificantLine(i);
+        const nextIndent = nextLine?.match(/^ */)?.[0].length ?? -1;
+        const nextTrimmed = nextLine?.trim() ?? "";
+        const useArray = nextLine !== null && nextIndent > indent && nextTrimmed.startsWith("- ");
+        const child = useArray ? [] : {};
+        container[key] = child;
+        stack.push({ indent, value: child });
+    }
+    return root;
+}
+export function parseRepoConfigContent(content) {
+    const raw = parseYaml(content);
+    const parsed = RepoConfig.safeParse(raw);
+    if (!parsed.success)
+        return null;
+    return parsed.data;
+}
+//# sourceMappingURL=config-core.js.map

package/dist/shared/config-core.js.map

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

package/dist/shared/doctor.d.ts

@@ -0,0 +1,48 @@
+import type { GateMode, RepoConfig } from "./types.js";
+export type DoctorSeverity = "error" | "warn" | "info";
+export interface DoctorFinding {
+    severity: DoctorSeverity;
+    code: string;
+    message: string;
+}
+export interface DoctorReport {
+    configPath: string | null;
+    configValid: boolean;
+    gateMode: GateMode;
+    expectedCheckName: string;
+    configuredChecks: string[];
+    observedChecks: string[];
+    findings: DoctorFinding[];
+    ok: boolean;
+}
+export interface RunDoctorOptions {
+    cwd?: string;
+    offline?: boolean;
+    githubToken?: string;
+    repo?: string;
+    ref?: string;
+}
+export declare function findConfigPath(cwd: string): string | null;
+export declare function loadRepoConfig(cwd: string): {
+    configPath: string | null;
+    config: RepoConfig | null;
+    error?: string;
+};
+export declare function collectConfiguredChecks(config: RepoConfig): string[];
+export declare function validateConfigStructure(config: RepoConfig, configPath: string): DoctorFinding[];
+export declare function compareConfiguredChecks(configuredChecks: string[], observedChecks: string[]): DoctorFinding[];
+export interface GitHubRepoRef {
+    owner: string;
+    repo: string;
+}
+export declare function parseRepoRef(input: string): GitHubRepoRef | null;
+export declare function fetchObservedCheckNames(options: {
+    token: string;
+    repo: GitHubRepoRef;
+    ref?: string;
+}): Promise<{
+    checks: string[];
+    error?: string;
+}>;
+export declare function runDoctor(options?: RunDoctorOptions): Promise<DoctorReport>;
+export declare function formatDoctorReport(report: DoctorReport): string;