@hashicorp/kits 0.1.0

package/dist/tui/upgrade-select.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Upgrade selection screen.
+ *
+ * Displays available upgrades with version changes and breaking change warnings,
+ * allowing users to select which upgrades to apply.
+ */
+import type { HarnessName } from "../core/types.js";
+import type { UpgradeCheck } from "../manifest/types.js";
+import type { UpgradeDisplayEntry, UpgradeSelectionResult, SelectOption } from "./types.js";
+/**
+ * Determine severity level from version change.
+ */
+export declare function determineSeverity(currentVersion: string, availableVersion: string, breaking: boolean): "patch" | "minor" | "major";
+/**
+ * Convert UpgradeCheck to display entry.
+ */
+export declare function toUpgradeDisplayEntry(check: UpgradeCheck, harnessDisplayName: string): UpgradeDisplayEntry;
+/**
+ * Format upgrade entry for display.
+ */
+export declare function formatUpgradeEntry(entry: UpgradeDisplayEntry): string;
+/**
+ * Display single upgrade entry.
+ */
+export declare function displayUpgradeEntry(entry: UpgradeDisplayEntry, indent?: string): void;
+/**
+ * Display available upgrades grouped by kit and harness.
+ */
+export declare function displayUpgradesByKit(entries: UpgradeDisplayEntry[]): void;
+/**
+ * Display upgrade summary statistics.
+ */
+export declare function displayUpgradeSummary(entries: UpgradeDisplayEntry[]): void;
+/**
+ * Display no upgrades available message.
+ */
+export declare function displayNoUpgrades(): void;
+/**
+ * Create select options from upgrade entries.
+ */
+export declare function createUpgradeOptions(entries: UpgradeDisplayEntry[]): SelectOption<string>[];
+/**
+ * Prompt user to select which upgrades to apply.
+ */
+export declare function selectUpgrades(entries: UpgradeDisplayEntry[], options?: {
+    showSummary?: boolean;
+    showDetails?: boolean;
+}): Promise<UpgradeSelectionResult>;
+/**
+ * Display upgrade check results for --check flag.
+ */
+export declare function displayUpgradeCheck(entries: UpgradeDisplayEntry[]): void;
+/**
+ * Convert upgrade entries to JSON output format.
+ */
+export declare function upgradesToJson(entries: UpgradeDisplayEntry[]): Record<string, unknown>;
+/**
+ * Filter upgrades by kit names.
+ */
+export declare function filterUpgradesByKit(entries: UpgradeDisplayEntry[], kitNames: string[]): UpgradeDisplayEntry[];
+/**
+ * Filter upgrades by harness names.
+ */
+export declare function filterUpgradesByHarness(entries: UpgradeDisplayEntry[], harnessNames: HarnessName[]): UpgradeDisplayEntry[];
+/**
+ * Get breaking upgrades only.
+ */
+export declare function getBreakingUpgrades(entries: UpgradeDisplayEntry[]): UpgradeDisplayEntry[];
+/**
+ * Get non-breaking upgrades only.
+ */
+export declare function getNonBreakingUpgrades(entries: UpgradeDisplayEntry[]): UpgradeDisplayEntry[];
+//# sourceMappingURL=upgrade-select.d.ts.map

package/dist/tui/upgrade-select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-select.d.ts","sourceRoot":"","sources":["../../src/tui/upgrade-select.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACb,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,cAAc,EAAE,MAAM,EACtB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,OAAO,GAChB,OAAO,GAAG,OAAO,GAAG,OAAO,CAc7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,YAAY,EACnB,kBAAkB,EAAE,MAAM,GACzB,mBAAmB,CAarB;AAwBD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAWrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,GAAE,MAAa,GAAG,IAAI,CAM3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAiCzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,IAAI,CAgCN;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,YAAY,CAAC,MAAM,CAAC,EAAE,CAOxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,CAAC,EAAE;IACR,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,OAAO,CAAC,sBAAsB,CAAC,CA6GjC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,mBAAmB,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,QAAQ,EAAE,MAAM,EAAE,GACjB,mBAAmB,EAAE,CAGvB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAAE,EAC9B,YAAY,EAAE,WAAW,EAAE,GAC1B,mBAAmB,EAAE,CAGvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,EAAE,CAEvB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,mBAAmB,EAAE,GAC7B,mBAAmB,EAAE,CAEvB"}

package/dist/tui/upgrade-select.js

@@ -0,0 +1,324 @@
+/**
+ * Upgrade selection screen.
+ *
+ * Displays available upgrades with version changes and breaking change warnings,
+ * allowing users to select which upgrades to apply.
+ */
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+import { formatWarning } from "./spinner.js";
+/**
+ * Determine severity level from version change.
+ */
+export function determineSeverity(currentVersion, availableVersion, breaking) {
+    if (breaking)
+        return "major";
+    const currParts = currentVersion.split(".").map(Number);
+    const availParts = availableVersion.split(".").map(Number);
+    const currMajor = currParts[0] ?? 0;
+    const currMinor = currParts[1] ?? 0;
+    const availMajor = availParts[0] ?? 0;
+    const availMinor = availParts[1] ?? 0;
+    if (availMajor > currMajor)
+        return "major";
+    if (availMinor > currMinor)
+        return "minor";
+    return "patch";
+}
+/**
+ * Convert UpgradeCheck to display entry.
+ */
+export function toUpgradeDisplayEntry(check, harnessDisplayName) {
+    return {
+        kit: check.kit,
+        harness: check.harness,
+        harnessDisplayName,
+        primitive: check.primitive,
+        type: check.type,
+        currentVersion: check.currentVersion,
+        availableVersion: check.availableVersion,
+        versionSpec: check.versionSpec,
+        breaking: check.breaking,
+        severity: determineSeverity(check.currentVersion, check.availableVersion, check.breaking),
+    };
+}
+/**
+ * Format severity badge.
+ */
+function formatSeverityBadge(severity) {
+    switch (severity) {
+        case "patch":
+            return pc.green("patch");
+        case "minor":
+            return pc.cyan("minor");
+        case "major":
+            return pc.red("MAJOR");
+    }
+}
+/**
+ * Format version change arrow.
+ */
+function formatVersionChange(current, available, breaking) {
+    const arrow = breaking ? pc.red("→") : pc.cyan("→");
+    return `${pc.dim(`v${current}`)} ${arrow} ${pc.bold(`v${available}`)}`;
+}
+/**
+ * Format upgrade entry for display.
+ */
+export function formatUpgradeEntry(entry) {
+    const severity = formatSeverityBadge(entry.severity);
+    const change = formatVersionChange(entry.currentVersion, entry.availableVersion, entry.breaking);
+    const typeLabel = pc.dim(`[${entry.type}]`);
+    let breaking = "";
+    if (entry.breaking) {
+        breaking = ` ${pc.red("BREAKING ⚠")}`;
+    }
+    return `${entry.primitive} ${change} ${typeLabel} ${severity}${breaking}`;
+}
+/**
+ * Display single upgrade entry.
+ */
+export function displayUpgradeEntry(entry, indent = "  ") {
+    console.log(`${indent}${formatUpgradeEntry(entry)}`);
+    if (entry.versionSpec) {
+        console.log(`${indent}  ${pc.dim(`Spec: ${entry.versionSpec}`)}`);
+    }
+}
+/**
+ * Display available upgrades grouped by kit and harness.
+ */
+export function displayUpgradesByKit(entries) {
+    // Group by kit, then harness
+    const byKit = new Map();
+    for (const entry of entries) {
+        let kitMap = byKit.get(entry.kit);
+        if (!kitMap) {
+            kitMap = new Map();
+            byKit.set(entry.kit, kitMap);
+        }
+        let harnessEntries = kitMap.get(entry.harness);
+        if (!harnessEntries) {
+            harnessEntries = [];
+            kitMap.set(entry.harness, harnessEntries);
+        }
+        harnessEntries.push(entry);
+    }
+    for (const [kit, harnessMap] of byKit) {
+        console.log();
+        console.log(`  ${pc.bold(kit)}`);
+        for (const [harness, harnessEntries] of harnessMap) {
+            const displayName = harnessEntries[0]?.harnessDisplayName ?? harness;
+            console.log(`    ${pc.cyan(displayName)}:`);
+            for (const entry of harnessEntries) {
+                displayUpgradeEntry(entry, "      ");
+            }
+        }
+    }
+}
+/**
+ * Display upgrade summary statistics.
+ */
+export function displayUpgradeSummary(entries) {
+    const total = entries.length;
+    const breaking = entries.filter((e) => e.breaking).length;
+    const major = entries.filter((e) => e.severity === "major").length;
+    const minor = entries.filter((e) => e.severity === "minor").length;
+    const patch = entries.filter((e) => e.severity === "patch").length;
+    const kits = new Set(entries.map((e) => e.kit)).size;
+    const harnesses = new Set(entries.map((e) => e.harness)).size;
+    console.log();
+    clack.log.info(`Found ${pc.bold(String(total))} available upgrade${total === 1 ? "" : "s"}:`);
+    const parts = [];
+    if (major > 0)
+        parts.push(pc.red(`${major} major`));
+    if (minor > 0)
+        parts.push(pc.cyan(`${minor} minor`));
+    if (patch > 0)
+        parts.push(pc.green(`${patch} patch`));
+    if (parts.length > 0) {
+        console.log(`  ${parts.join(", ")}`);
+    }
+    console.log(`  Across ${kits} kit${kits === 1 ? "" : "s"} and ${harnesses} harness${harnesses === 1 ? "" : "es"}`);
+    if (breaking > 0) {
+        console.log();
+        clack.log.warn(formatWarning(`${breaking} upgrade${breaking === 1 ? "" : "s"} contain${breaking === 1 ? "s" : ""} breaking changes`));
+    }
+}
+/**
+ * Display no upgrades available message.
+ */
+export function displayNoUpgrades() {
+    console.log();
+    clack.log.success("All primitives are up to date!");
+}
+/**
+ * Create select options from upgrade entries.
+ */
+export function createUpgradeOptions(entries) {
+    return entries.map((entry, index) => ({
+        value: String(index),
+        label: `${entry.primitive} (${entry.kit})`,
+        hint: formatVersionChange(entry.currentVersion, entry.availableVersion, entry.breaking) +
+            (entry.breaking ? " BREAKING ⚠" : ""),
+    }));
+}
+/**
+ * Prompt user to select which upgrades to apply.
+ */
+export async function selectUpgrades(entries, options) {
+    if (entries.length === 0) {
+        displayNoUpgrades();
+        return {
+            cancelled: false,
+            selected: [],
+        };
+    }
+    // Display summary
+    if (options?.showSummary !== false) {
+        displayUpgradeSummary(entries);
+    }
+    // Display details
+    if (options?.showDetails !== false) {
+        displayUpgradesByKit(entries);
+    }
+    console.log();
+    // Check for breaking changes
+    const breaking = entries.filter((e) => e.breaking);
+    if (breaking.length > 0) {
+        const proceed = await clack.confirm({
+            message: `${breaking.length} upgrade${breaking.length === 1 ? "" : "s"} contain${breaking.length === 1 ? "s" : ""} breaking changes. Continue?`,
+            active: "Yes, show me the options",
+            inactive: "No, cancel",
+        });
+        if (clack.isCancel(proceed) || !proceed) {
+            return {
+                cancelled: true,
+                selected: [],
+            };
+        }
+    }
+    // If only one upgrade, ask for confirmation
+    if (entries.length === 1) {
+        const confirm = await clack.confirm({
+            message: "Apply this upgrade?",
+        });
+        if (clack.isCancel(confirm) || !confirm) {
+            return {
+                cancelled: clack.isCancel(confirm),
+                selected: [],
+            };
+        }
+        return {
+            cancelled: false,
+            selected: entries,
+        };
+    }
+    // Multiple upgrades - let user select
+    const selectOptions = createUpgradeOptions(entries);
+    selectOptions.push({
+        value: "__all__",
+        label: "All upgrades",
+        hint: `${entries.length} total`,
+    });
+    // Convert options to clack's expected format
+    const clackOptions = selectOptions.map((opt) => {
+        const base = {
+            value: opt.value,
+            label: opt.label,
+        };
+        if (opt.hint !== undefined) {
+            base.hint = opt.hint;
+        }
+        return base;
+    });
+    const selected = await clack.multiselect({
+        message: "Which upgrades do you want to apply?",
+        options: clackOptions,
+        required: true,
+    });
+    if (clack.isCancel(selected)) {
+        return {
+            cancelled: true,
+            selected: [],
+        };
+    }
+    const selectedValues = selected;
+    // Handle "All" option
+    if (selectedValues.includes("__all__")) {
+        return {
+            cancelled: false,
+            selected: entries,
+        };
+    }
+    // Map selected indices back to entries
+    const selectedEntries = selectedValues
+        .map((v) => entries[parseInt(v, 10)])
+        .filter((e) => e !== undefined);
+    return {
+        cancelled: false,
+        selected: selectedEntries,
+    };
+}
+/**
+ * Display upgrade check results for --check flag.
+ */
+export function displayUpgradeCheck(entries) {
+    if (entries.length === 0) {
+        displayNoUpgrades();
+        return;
+    }
+    displayUpgradeSummary(entries);
+    displayUpgradesByKit(entries);
+    console.log();
+    clack.log.info("Run `kit upgrade` to apply these updates");
+}
+/**
+ * Convert upgrade entries to JSON output format.
+ */
+export function upgradesToJson(entries) {
+    return {
+        upgrades: entries.map((e) => ({
+            kit: e.kit,
+            harness: e.harness,
+            primitive: e.primitive,
+            type: e.type,
+            currentVersion: e.currentVersion,
+            availableVersion: e.availableVersion,
+            versionSpec: e.versionSpec,
+            breaking: e.breaking,
+        })),
+        summary: {
+            totalUpgrades: entries.length,
+            breakingChanges: entries.filter((e) => e.breaking).length,
+            affectedKits: new Set(entries.map((e) => e.kit)).size,
+            affectedHarnesses: new Set(entries.map((e) => e.harness)).size,
+        },
+    };
+}
+/**
+ * Filter upgrades by kit names.
+ */
+export function filterUpgradesByKit(entries, kitNames) {
+    const nameSet = new Set(kitNames);
+    return entries.filter((e) => nameSet.has(e.kit));
+}
+/**
+ * Filter upgrades by harness names.
+ */
+export function filterUpgradesByHarness(entries, harnessNames) {
+    const nameSet = new Set(harnessNames);
+    return entries.filter((e) => nameSet.has(e.harness));
+}
+/**
+ * Get breaking upgrades only.
+ */
+export function getBreakingUpgrades(entries) {
+    return entries.filter((e) => e.breaking);
+}
+/**
+ * Get non-breaking upgrades only.
+ */
+export function getNonBreakingUpgrades(entries) {
+    return entries.filter((e) => !e.breaking);
+}
+//# sourceMappingURL=upgrade-select.js.map

package/dist/tui/upgrade-select.js.map

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

package/dist/validation/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Validation module for kit primitives.
+ *
+ * Provides validation utilities for command primitives and other
+ * primitive types against their canonical format specifications.
+ */
+export { validateCommands, main as runCommandValidation } from "./validate-commands.js";
+export { validateSkills, main as runSkillValidation } from "./validate-skills.js";
+export { validateSubagents, main as runSubagentValidation } from "./validate-subagents.js";
+export { validateMcp, main as runMcpValidation } from "./validate-mcp.js";
+export { validateHooks, main as runHookValidation } from "./validate-hooks.js";
+export { validateKits, main as runKitValidation } from "./validate-kits.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,IAAI,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,IAAI,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/validation/index.js

@@ -0,0 +1,13 @@
+/**
+ * Validation module for kit primitives.
+ *
+ * Provides validation utilities for command primitives and other
+ * primitive types against their canonical format specifications.
+ */
+export { validateCommands, main as runCommandValidation } from "./validate-commands.js";
+export { validateSkills, main as runSkillValidation } from "./validate-skills.js";
+export { validateSubagents, main as runSubagentValidation } from "./validate-subagents.js";
+export { validateMcp, main as runMcpValidation } from "./validate-mcp.js";
+export { validateHooks, main as runHookValidation } from "./validate-hooks.js";
+export { validateKits, main as runKitValidation } from "./validate-kits.js";
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,gBAAgB,EAAE,IAAI,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,IAAI,IAAI,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,IAAI,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,IAAI,IAAI,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/validation/source.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Shared source resolution for validation scripts.
+ */
+import { type FetchResult } from "../discovery/index.js";
+/**
+ * Resolve a validation source to a local path.
+ *
+ * Accepts GitHub shorthand (org/repo[@ref]) and local paths. If the source
+ * looks like a relative path without an explicit prefix, we prefer a local
+ * path when it exists.
+ */
+export declare function resolveValidationSource(source: string): Promise<FetchResult>;
+export declare function formatValidationSourceError(error: unknown): string;
+//# sourceMappingURL=source.d.ts.map

package/dist/validation/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/validation/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAQ/B;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,CAAC,CAyBtB;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWlE"}

package/dist/validation/source.js

@@ -0,0 +1,51 @@
+/**
+ * Shared source resolution for validation scripts.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fetchSource, GitFetchError, LocalFetchError, NoFetcherError, SourceParseError, } from "../discovery/index.js";
+const LOCAL_PATH_PREFIXES = ["./", "../", "/", "~"];
+function isExplicitLocalPath(source) {
+    return LOCAL_PATH_PREFIXES.some((prefix) => source.startsWith(prefix));
+}
+/**
+ * Resolve a validation source to a local path.
+ *
+ * Accepts GitHub shorthand (org/repo[@ref]) and local paths. If the source
+ * looks like a relative path without an explicit prefix, we prefer a local
+ * path when it exists.
+ */
+export async function resolveValidationSource(source) {
+    let normalizedSource = source;
+    if (!isExplicitLocalPath(source)) {
+        const resolved = path.resolve(source);
+        const hasSlash = source.includes("/");
+        let shouldTreatAsLocal = false;
+        if (!hasSlash) {
+            shouldTreatAsLocal = true;
+        }
+        else {
+            try {
+                await fs.stat(resolved);
+                shouldTreatAsLocal = true;
+            }
+            catch {
+                shouldTreatAsLocal = false;
+            }
+        }
+        if (shouldTreatAsLocal) {
+            normalizedSource = resolved;
+        }
+    }
+    return fetchSource(normalizedSource);
+}
+export function formatValidationSourceError(error) {
+    if (error instanceof NoFetcherError ||
+        error instanceof SourceParseError ||
+        error instanceof LocalFetchError ||
+        error instanceof GitFetchError) {
+        return error.message;
+    }
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=source.js.map

package/dist/validation/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../src/validation/source.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,gBAAgB,GAEjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAEpD,SAAS,mBAAmB,CAAC,MAAc;IACzC,OAAO,mBAAmB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,MAAc;IAEd,IAAI,gBAAgB,GAAG,MAAM,CAAC;IAE9B,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,kBAAkB,GAAG,KAAK,CAAC;QAE/B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,kBAAkB,GAAG,IAAI,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,kBAAkB,GAAG,IAAI,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB,GAAG,KAAK,CAAC;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,kBAAkB,EAAE,CAAC;YACvB,gBAAgB,GAAG,QAAQ,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,gBAAgB,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IACE,KAAK,YAAY,cAAc;QAC/B,KAAK,YAAY,gBAAgB;QACjC,KAAK,YAAY,eAAe;QAChC,KAAK,YAAY,aAAa,EAC9B,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IAED,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/validation/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared validation helpers.
+ */
+export interface ValidationResult {
+    file: string;
+    valid: boolean;
+    error?: string;
+}
+export interface ValidationSummary {
+    total: number;
+    passed: number;
+    failed: number;
+    results: ValidationResult[];
+}
+export interface FindMarkdownOptions {
+    extension?: string;
+    fileName?: string;
+}
+/**
+ * Recursively find markdown files in a directory.
+ */
+export declare function findMarkdownFiles(dir: string, options?: FindMarkdownOptions): Promise<string[]>;
+/**
+ * Recursively find files with an exact name.
+ */
+export declare function findFilesByName(dir: string, fileName: string): Promise<string[]>;
+export declare function summarizeResults(results: ValidationResult[]): ValidationSummary;
+export declare function printValidationResults(title: string, summary: ValidationSummary, basePath: string): void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/validation/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/validation/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC,CA4BnB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAEnB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,iBAAiB,CAU/E;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,iBAAiB,EAC1B,QAAQ,EAAE,MAAM,GACf,IAAI,CAuCN"}

package/dist/validation/utils.js

@@ -0,0 +1,89 @@
+/**
+ * Shared validation helpers.
+ */
+import * as fs from "fs/promises";
+import * as path from "path";
+import pc from "picocolors";
+/**
+ * Recursively find markdown files in a directory.
+ */
+export async function findMarkdownFiles(dir, options = {}) {
+    const files = [];
+    const { extension = ".md", fileName } = options;
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                const subFiles = await findMarkdownFiles(fullPath, options);
+                files.push(...subFiles);
+            }
+            else if (entry.isFile()) {
+                if (fileName) {
+                    if (entry.name === fileName) {
+                        files.push(fullPath);
+                    }
+                }
+                else if (entry.name.endsWith(extension)) {
+                    files.push(fullPath);
+                }
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't be read - ignore
+    }
+    return files;
+}
+/**
+ * Recursively find files with an exact name.
+ */
+export async function findFilesByName(dir, fileName) {
+    return findMarkdownFiles(dir, { fileName });
+}
+export function summarizeResults(results) {
+    const passed = results.filter((r) => r.valid).length;
+    const failed = results.filter((r) => !r.valid).length;
+    return {
+        total: results.length,
+        passed,
+        failed,
+        results,
+    };
+}
+export function printValidationResults(title, summary, basePath) {
+    console.log();
+    console.log(pc.bold(title));
+    console.log("=".repeat(50));
+    console.log();
+    const failures = summary.results.filter((r) => !r.valid);
+    if (failures.length > 0) {
+        console.log(pc.red(pc.bold("Failures:")));
+        console.log();
+        for (const failure of failures) {
+            const relativePath = path.relative(basePath, failure.file);
+            console.log(pc.red(`  ✗ ${relativePath}`));
+            console.log(pc.dim(`    ${failure.error}`));
+            console.log();
+        }
+    }
+    const passed = summary.results.filter((r) => r.valid);
+    if (passed.length > 0) {
+        console.log(pc.green(pc.bold("Passed:")));
+        console.log();
+        for (const success of passed) {
+            const relativePath = path.relative(basePath, success.file);
+            console.log(pc.green(`  ✓ ${relativePath}`));
+        }
+        console.log();
+    }
+    console.log("=".repeat(50));
+    console.log(`Total: ${summary.total} | ` +
+        pc.green(`Passed: ${summary.passed}`) +
+        ` | ` +
+        (summary.failed > 0
+            ? pc.red(`Failed: ${summary.failed}`)
+            : `Failed: ${summary.failed}`));
+    console.log();
+}
+//# sourceMappingURL=utils.js.map

package/dist/validation/utils.js.map

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