@hashicorp/kits 0.1.0

package/dist/resolution/multi-kit-resolver.js

@@ -0,0 +1,258 @@
+/**
+ * Multi-kit resolver for deduplicating shared primitives.
+ *
+ * When installing multiple kits that reference the same primitives,
+ * this module ensures each shared primitive is resolved once with
+ * the highest compatible version.
+ */
+import * as semver from "semver";
+import { isReferencedPrimitive, PRIMITIVE_TYPES } from "../core/types.js";
+import { createPrimitiveKey } from "./types.js";
+import { parseReference } from "./reference-parser.js";
+import { resolveRegistryPrimitivePath } from "./primitive-paths.js";
+import { resolvePrimitiveReferences } from "./index.js";
+/**
+ * Resolves primitives across multiple kits, deduplicating shared primitives.
+ *
+ * When multiple kits reference the same primitive:
+ * 1. Collects all version specs for that primitive
+ * 2. Finds the highest version satisfying all specs
+ * 3. Uses that single resolved version for all kits
+ *
+ * @param kits - Array of kit manifests
+ * @param registry - The primitives registry loader
+ * @param kitBasePaths - Map of kit names to their base paths
+ * @returns Multi-kit resolution result with deduplication
+ */
+export async function resolveMultipleKits(kits, registry, kitBasePaths) {
+    const allPrimitives = new Map();
+    const kitPrimitives = new Map();
+    const sharedPrimitives = new Map();
+    const errors = [];
+    // Step 1: Collect all primitive references across kits
+    const referenceMap = collectPrimitiveReferences(kits);
+    // Step 2: Resolve shared primitives (referenced by multiple kits)
+    const sharedResolved = await resolveSharedPrimitives(referenceMap, registry);
+    // Add shared primitive errors
+    errors.push(...sharedResolved.errors);
+    // Store shared primitives
+    for (const [key, resolved] of sharedResolved.primitives) {
+        allPrimitives.set(key, resolved);
+        // Track which kits share this primitive
+        const refInfo = referenceMap.get(key);
+        if (refInfo && refInfo.kits.size > 1) {
+            sharedPrimitives.set(key, Array.from(refInfo.kits.keys()));
+        }
+    }
+    // Step 3: Resolve per-kit primitives (inline + non-shared)
+    for (const kit of kits) {
+        const kitBasePath = kitBasePaths.get(kit.name);
+        if (!kitBasePath) {
+            errors.push({
+                type: "not-found",
+                primitive: kit.name,
+                message: `Base path not provided for kit "${kit.name}"`,
+            });
+            continue;
+        }
+        const kitResult = await resolvePrimitiveReferences(kit, registry, kitBasePath);
+        errors.push(...kitResult.errors);
+        const kitResolvedPrimitives = [];
+        for (const resolved of kitResult.primitives) {
+            const key = createPrimitiveKey(resolved.type, resolved.name);
+            // Use shared resolution if available
+            if (!resolved.isInline && allPrimitives.has(key)) {
+                kitResolvedPrimitives.push(allPrimitives.get(key));
+            }
+            else {
+                // Store non-shared or inline primitive
+                allPrimitives.set(key, resolved);
+                kitResolvedPrimitives.push(resolved);
+            }
+        }
+        kitPrimitives.set(kit.name, kitResolvedPrimitives);
+    }
+    return {
+        allPrimitives,
+        kitPrimitives,
+        sharedPrimitives,
+        errors,
+    };
+}
+/**
+ * Collects all primitive references across kits.
+ */
+function collectPrimitiveReferences(kits) {
+    const references = new Map();
+    for (const kit of kits) {
+        for (const type of PRIMITIVE_TYPES) {
+            const primitives = kit.primitives[type];
+            if (!primitives)
+                continue;
+            for (const primitive of primitives) {
+                if (!isReferencedPrimitive(primitive))
+                    continue;
+                try {
+                    const parsed = parseReference(primitive.ref);
+                    const key = createPrimitiveKey(type, parsed.name);
+                    if (!references.has(key)) {
+                        references.set(key, {
+                            type,
+                            name: parsed.name,
+                            kits: new Map(),
+                        });
+                    }
+                    references.get(key).kits.set(kit.name, parsed.versionSpec);
+                }
+                catch {
+                    // Skip invalid references - they'll be caught in normal resolution
+                }
+            }
+        }
+    }
+    return references;
+}
+/**
+ * Resolves primitives shared by multiple kits.
+ */
+async function resolveSharedPrimitives(referenceMap, registry) {
+    const primitives = new Map();
+    const errors = [];
+    for (const [key, info] of referenceMap) {
+        // Skip if only one kit references this primitive
+        if (info.kits.size <= 1)
+            continue;
+        // Get all version specs from different kits
+        const specs = Array.from(info.kits.values());
+        // Look up the primitive
+        const entry = await registry.getPrimitive(info.type, info.name);
+        if (!entry) {
+            errors.push({
+                type: "not-found",
+                primitive: `${info.name} (shared by ${Array.from(info.kits.keys()).join(", ")})`,
+                message: `Shared primitive "${info.name}" of type "${info.type}" not found in registry`,
+            });
+            continue;
+        }
+        // Find highest version satisfying all specs
+        const versions = entry.versions.map((v) => v.version);
+        const matchingVersion = findHighestSatisfyingAll(versions, specs);
+        if (!matchingVersion) {
+            errors.push({
+                type: "no-matching-version",
+                primitive: `${info.name} (shared by ${Array.from(info.kits.keys()).join(", ")})`,
+                message: `No version found satisfying all specs: ${specs.join(", ")}. Available: ${versions.join(", ")}`,
+                available: versions,
+            });
+            continue;
+        }
+        // Get the version entry
+        const versionEntry = entry.versions.find((v) => v.version === matchingVersion);
+        if (!versionEntry)
+            continue;
+        // Build resolved primitive
+        const basePath = `${registry.getBasePath()}/${entry.path}/${versionEntry.path}`;
+        const sourcePath = await resolveRegistryPrimitivePath(info.type, info.name, basePath);
+        primitives.set(key, {
+            name: info.name,
+            type: info.type,
+            ref: `${info.name}@${matchingVersion}`, // Use resolved version as ref
+            resolvedVersion: matchingVersion,
+            sourcePath,
+            isInline: false,
+            metadata: {
+                description: entry.description,
+                released: versionEntry.released,
+                changelog: versionEntry.changelog,
+            },
+        });
+    }
+    return { primitives, errors };
+}
+/**
+ * Finds the highest version that satisfies all given specs.
+ */
+function findHighestSatisfyingAll(versions, specs) {
+    // Handle edge cases
+    if (specs.length === 0)
+        return null;
+    if (versions.length === 0)
+        return null;
+    // If all specs are "latest", return highest version
+    if (specs.every((s) => s.toLowerCase() === "latest")) {
+        return semver.maxSatisfying(versions, "*");
+    }
+    // Filter to versions satisfying all non-latest specs
+    const nonLatestSpecs = specs.filter((s) => s.toLowerCase() !== "latest");
+    const satisfyingAll = versions.filter((version) => nonLatestSpecs.every((spec) => {
+        // Handle exact version match
+        if (semver.valid(spec)) {
+            return version === spec || semver.eq(version, spec);
+        }
+        // Handle range specs
+        const range = semver.validRange(spec);
+        if (range) {
+            return semver.satisfies(version, range);
+        }
+        // Unknown spec format - be permissive
+        return true;
+    }));
+    if (satisfyingAll.length === 0) {
+        return null;
+    }
+    // Return highest satisfying version
+    return semver.maxSatisfying(satisfyingAll, "*");
+}
+/**
+ * Deduplicates primitives by merging identical versions.
+ *
+ * @param primitives - Array of resolved primitives from multiple kits
+ * @returns Deduplicated array with shared primitives merged
+ */
+export function deduplicatePrimitives(primitives) {
+    const deduplicated = new Map();
+    for (const primitive of primitives) {
+        const key = createPrimitiveKey(primitive.type, primitive.name);
+        // For inline primitives, use kit-specific keys
+        if (primitive.isInline) {
+            // Inline primitives are kit-specific, include source path in key
+            const inlineKey = `${key}:${primitive.sourcePath}`;
+            deduplicated.set(inlineKey, primitive);
+            continue;
+        }
+        // For referenced primitives, deduplicate by type:name
+        if (!deduplicated.has(key)) {
+            deduplicated.set(key, primitive);
+            continue;
+        }
+        // If already exists, keep the higher version
+        const existing = deduplicated.get(key);
+        if (primitive.resolvedVersion &&
+            existing.resolvedVersion &&
+            semver.gt(primitive.resolvedVersion, existing.resolvedVersion)) {
+            deduplicated.set(key, primitive);
+        }
+    }
+    return deduplicated;
+}
+/**
+ * Analyzes primitive sharing across kits.
+ *
+ * @param kits - Array of kit manifests
+ * @returns Analysis of shared primitives
+ */
+export function analyzeSharedPrimitives(kits) {
+    const references = collectPrimitiveReferences(kits);
+    const shared = new Map();
+    for (const [key, info] of references) {
+        if (info.kits.size > 1) {
+            shared.set(key, {
+                type: info.type,
+                name: info.name,
+                kits: Array.from(info.kits.keys()),
+            });
+        }
+    }
+    return shared;
+}
+//# sourceMappingURL=multi-kit-resolver.js.map

package/dist/resolution/multi-kit-resolver.js.map

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

package/dist/resolution/primitive-paths.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Resolve registry primitive content paths.
+ *
+ * Registry version paths point to a version directory. This helper resolves the
+ * actual file or directory to install based on primitive type conventions.
+ */
+import type { PrimitiveType } from "../core/types.js";
+/**
+ * Resolve a registry primitive content path for installation.
+ *
+ * @param type - Primitive type
+ * @param name - Primitive name
+ * @param basePath - Resolved registry base path (entry.path + version.path)
+ * @returns Path to primitive content (file or directory)
+ */
+export declare function resolveRegistryPrimitivePath(type: PrimitiveType, name: string, basePath: string): Promise<string>;
+//# sourceMappingURL=primitive-paths.d.ts.map

package/dist/resolution/primitive-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-paths.d.ts","sourceRoot":"","sources":["../../src/resolution/primitive-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAWtD;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/resolution/primitive-paths.js

@@ -0,0 +1,59 @@
+/**
+ * Resolve registry primitive content paths.
+ *
+ * Registry version paths point to a version directory. This helper resolves the
+ * actual file or directory to install based on primitive type conventions.
+ */
+import { stat } from "node:fs/promises";
+import path from "node:path";
+async function pathExists(targetPath) {
+    try {
+        await stat(targetPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve a registry primitive content path for installation.
+ *
+ * @param type - Primitive type
+ * @param name - Primitive name
+ * @param basePath - Resolved registry base path (entry.path + version.path)
+ * @returns Path to primitive content (file or directory)
+ */
+export async function resolveRegistryPrimitivePath(type, name, basePath) {
+    try {
+        const stats = await stat(basePath);
+        if (!stats.isDirectory()) {
+            return basePath;
+        }
+    }
+    catch {
+        return basePath;
+    }
+    let candidate = basePath;
+    switch (type) {
+        case "commands":
+            candidate = path.join(basePath, `${name}.md`);
+            break;
+        case "subagents":
+            candidate = path.join(basePath, `${name}.md`);
+            break;
+        case "hooks":
+            candidate = path.join(basePath, "config.json");
+            break;
+        case "mcp":
+            candidate = path.join(basePath, "config.json");
+            break;
+        case "skills":
+        default:
+            return basePath;
+    }
+    if (await pathExists(candidate)) {
+        return candidate;
+    }
+    return basePath;
+}
+//# sourceMappingURL=primitive-paths.js.map

package/dist/resolution/primitive-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-paths.js","sourceRoot":"","sources":["../../src/resolution/primitive-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,KAAK,UAAU,UAAU,CAAC,UAAkB;IAC1C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAAmB,EACnB,IAAY,EACZ,QAAgB;IAEhB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,SAAS,GAAG,QAAQ,CAAC;IAEzB,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,UAAU;YACb,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;YAC9C,MAAM;QACR,KAAK,WAAW;YACd,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;YAC9C,MAAM;QACR,KAAK,OAAO;YACV,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,KAAK;YACR,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,QAAQ,CAAC;QACd;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/resolution/primitives-registry.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Primitives registry loader and query interface.
+ *
+ * Provides functionality to load the primitives.json file and query
+ * primitives by type and name.
+ */
+import type { PrimitivesRegistry, PrimitiveEntry, PrimitiveType, PrimitiveVersionEntry } from "../core/types.js";
+import type { VersionResolutionResult } from "./types.js";
+/**
+ * Error thrown when the primitives registry cannot be loaded.
+ */
+export declare class PrimitivesRegistryError extends Error {
+    readonly errorCause?: unknown;
+    constructor(message: string, cause?: unknown);
+}
+/**
+ * Wrapper class for querying the primitives registry.
+ */
+export declare class PrimitivesRegistryLoader {
+    private registry;
+    private basePath;
+    constructor(basePath: string);
+    /**
+     * Loads the primitives registry from the repository.
+     *
+     * @returns The loaded primitives registry
+     * @throws PrimitivesRegistryError if loading fails
+     */
+    load(): Promise<PrimitivesRegistry>;
+    /**
+     * Gets the loaded registry, loading it if necessary.
+     */
+    getRegistry(): Promise<PrimitivesRegistry>;
+    /**
+     * Checks if the registry has been loaded.
+     */
+    isLoaded(): boolean;
+    /**
+     * Gets the base path for resolving primitive paths.
+     */
+    getBasePath(): string;
+    /**
+     * Gets a primitive entry by type and name.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns The primitive entry or null if not found
+     */
+    getPrimitive(type: PrimitiveType, name: string): Promise<PrimitiveEntry | null>;
+    /**
+     * Gets all available versions for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns Array of version entries, sorted newest first
+     */
+    getVersions(type: PrimitiveType, name: string): Promise<PrimitiveVersionEntry[]>;
+    /**
+     * Gets the version strings for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns Array of version strings
+     */
+    getVersionStrings(type: PrimitiveType, name: string): Promise<string[]>;
+    /**
+     * Gets the latest version for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns The latest version string or null if not found
+     */
+    getLatestVersion(type: PrimitiveType, name: string): Promise<string | null>;
+    /**
+     * Gets a specific version entry for a primitive.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The exact version string
+     * @returns The version entry or null if not found
+     */
+    getVersion(type: PrimitiveType, name: string, version: string): Promise<PrimitiveVersionEntry | null>;
+    /**
+     * Resolves the full path to a primitive version's content.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The version string
+     * @returns The absolute path to the primitive content or null if not found
+     */
+    resolvePath(type: PrimitiveType, name: string, version: string): Promise<string | null>;
+    /**
+     * Gets version resolution result with full path information.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @param version - The exact version string
+     * @returns The version resolution result or null if not found
+     */
+    getVersionResolution(type: PrimitiveType, name: string, version: string): Promise<VersionResolutionResult | null>;
+    /**
+     * Checks if a primitive exists in the registry.
+     *
+     * @param type - The primitive type
+     * @param name - The primitive name
+     * @returns True if the primitive exists
+     */
+    hasPrimitive(type: PrimitiveType, name: string): Promise<boolean>;
+    /**
+     * Lists all primitives of a given type.
+     *
+     * @param type - The primitive type
+     * @returns Array of primitive names
+     */
+    listPrimitives(type: PrimitiveType): Promise<string[]>;
+    /**
+     * Lists all primitives across all types.
+     *
+     * @returns Map of type to primitive names
+     */
+    listAllPrimitives(): Promise<Map<PrimitiveType, string[]>>;
+}
+/**
+ * Creates a new primitives registry loader.
+ *
+ * @param basePath - The base path to the kit repository
+ * @returns A new PrimitivesRegistryLoader instance
+ */
+export declare function createPrimitivesRegistry(basePath: string): PrimitivesRegistryLoader;
+/**
+ * Loads a primitives registry from a repository path.
+ *
+ * @param basePath - The base path to the kit repository
+ * @returns The loaded primitives registry
+ */
+export declare function loadPrimitivesRegistry(basePath: string): Promise<PrimitivesRegistry>;
+//# sourceMappingURL=primitives-registry.d.ts.map

package/dist/resolution/primitives-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives-registry.d.ts","sourceRoot":"","sources":["../../src/resolution/primitives-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAK7C;AAED;;GAEG;AACH,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B;;;;;OAKG;IACG,IAAI,IAAI,OAAO,CAAC,kBAAkB,CAAC;IA4BzC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAOhD;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;;;;;OAMG;IACG,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAWrF;;;;;;OAMG;IACG,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAYtF;;;;;;OAMG;IACG,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAK7E;;;;;;OAMG;IACG,gBAAgB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKjF;;;;;;;OAOG;IACG,UAAU,CACd,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;IASxC;;;;;;;OAOG;IACG,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAe7F;;;;;;;OAOG;IACG,oBAAoB,CACxB,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC;IAmB1C;;;;;;OAMG;IACG,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKvE;;;;;OAKG;IACG,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW5D;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;CAYjE;AAmDD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,wBAAwB,CAEnF;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAG1F"}