@hashicorp/kits 0.1.0

package/dist/discovery/git-fetcher.js

@@ -0,0 +1,150 @@
+/**
+ * Git fetcher for cloning repositories.
+ *
+ * Clones GitHub repositories to temporary directories with support for
+ * branch/tag checkout and automatic cleanup.
+ */
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { simpleGit } from "simple-git";
+import { parseSource, SourceParseError } from "./source-parser.js";
+/**
+ * Error thrown when git operations fail.
+ */
+export class GitFetchError extends Error {
+    gitSource;
+    gitCause;
+    constructor(message, source, cause) {
+        super(message);
+        this.name = "GitFetchError";
+        this.gitSource = source;
+        if (cause) {
+            this.gitCause = cause;
+        }
+    }
+}
+const DEFAULT_OPTIONS = {
+    tempDir: os.tmpdir(),
+    timeout: 60000,
+    shallow: true,
+};
+/**
+ * Git fetcher implementation for cloning GitHub repositories.
+ */
+export class GitFetcher {
+    options;
+    constructor(options = {}) {
+        this.options = { ...DEFAULT_OPTIONS, ...options };
+    }
+    /**
+     * Check if this fetcher can handle the given source.
+     *
+     * Handles GitHub shorthand format: org/repo or org/repo@ref
+     */
+    canHandle(source) {
+        try {
+            const descriptor = parseSource(source);
+            return descriptor.type === "github";
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Fetch (clone) a GitHub repository to a local temporary directory.
+     *
+     * @param source - GitHub shorthand (e.g., "example-org/kits@v1.0.0")
+     * @returns Fetch result with local path and cleanup function
+     * @throws GitFetchError if cloning fails
+     */
+    async fetch(source) {
+        let descriptor;
+        try {
+            const parsed = parseSource(source);
+            if (parsed.type !== "github") {
+                throw new SourceParseError("Not a GitHub source", source);
+            }
+            descriptor = parsed;
+        }
+        catch (error) {
+            throw new GitFetchError(`Failed to parse source: ${source}`, source, error instanceof Error ? error : undefined);
+        }
+        // Create temp directory
+        const tempPrefix = path.join(this.options.tempDir, "agent-kit-");
+        let tempDir;
+        try {
+            tempDir = await fs.mkdtemp(tempPrefix);
+        }
+        catch (error) {
+            throw new GitFetchError(`Failed to create temporary directory`, source, error instanceof Error ? error : undefined);
+        }
+        // Configure git
+        const gitOptions = {
+            baseDir: tempDir,
+            binary: "git",
+            maxConcurrentProcesses: 1,
+            timeout: {
+                block: this.options.timeout,
+            },
+        };
+        const git = simpleGit(gitOptions);
+        // Build clone URL
+        const cloneUrl = `https://github.com/${descriptor.owner}/${descriptor.repo}.git`;
+        try {
+            // Clone with options
+            const cloneOptions = [];
+            if (this.options.shallow) {
+                cloneOptions.push("--depth", "1");
+            }
+            if (descriptor.ref) {
+                cloneOptions.push("--branch", descriptor.ref);
+            }
+            await git.clone(cloneUrl, tempDir, cloneOptions);
+            // Return result with cleanup function
+            return {
+                localPath: tempDir,
+                cleanup: async () => {
+                    try {
+                        await fs.rm(tempDir, { recursive: true, force: true });
+                    }
+                    catch {
+                        // Ignore cleanup errors
+                    }
+                },
+            };
+        }
+        catch (error) {
+            // Clean up on failure
+            try {
+                await fs.rm(tempDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Provide helpful error messages
+            if (errorMessage.includes("not found")) {
+                throw new GitFetchError(`Repository not found: ${descriptor.owner}/${descriptor.repo}`, source, error instanceof Error ? error : undefined);
+            }
+            if (descriptor.ref &&
+                (errorMessage.includes("did not match any") ||
+                    errorMessage.includes("Remote branch") ||
+                    errorMessage.includes("not found in upstream"))) {
+                throw new GitFetchError(`Branch or tag not found: ${descriptor.ref}`, source, error instanceof Error ? error : undefined);
+            }
+            if (errorMessage.includes("Authentication failed") ||
+                errorMessage.includes("could not read Username")) {
+                throw new GitFetchError(`Authentication failed. Private repositories are not supported.`, source, error instanceof Error ? error : undefined);
+            }
+            throw new GitFetchError(`Failed to clone repository: ${errorMessage}`, source, error instanceof Error ? error : undefined);
+        }
+    }
+}
+/**
+ * Create a git fetcher with default options.
+ */
+export function createGitFetcher(options) {
+    return new GitFetcher(options);
+}
+//# sourceMappingURL=git-fetcher.js.map

package/dist/discovery/git-fetcher.js.map

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

package/dist/discovery/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Discovery module for the kit installer.
+ *
+ * This module handles source parsing, fetching, and kit discovery.
+ */
+export type { SourceType, GitHubSource, LocalSource, SourceDescriptor, FetchResult, PrimitiveCounts, DiscoveredKit, RepositoryMetadata, KitDiscoveryResult, DiscoveryError, SourceFetcher, DetectedHarness, KitCompatibility, CompatibilityMatrix, } from "./types.js";
+export { isGitHubSource, isLocalSource } from "./types.js";
+export { parseSource, formatSource, SourceParseError } from "./source-parser.js";
+export { GitFetcher, GitFetchError, createGitFetcher, type GitFetcherOptions } from "./git-fetcher.js";
+export { LocalFetcher, LocalFetchError, createLocalFetcher } from "./local-fetcher.js";
+export { FetcherRegistry, NoFetcherError, createFetcherRegistry, getDefaultFetcherRegistry, fetchSource, type FetcherRegistryOptions, } from "./fetcher-registry.js";
+export { scanKits, filterKitsByName, getMissingKitNames, KitScanError, type KitScannerOptions, } from "./kit-scanner.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EACV,UAAU,EACV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGjF,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,WAAW,EACX,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,KAAK,iBAAiB,GACvB,MAAM,kBAAkB,CAAC"}

package/dist/discovery/index.js

@@ -0,0 +1,15 @@
+/**
+ * Discovery module for the kit installer.
+ *
+ * This module handles source parsing, fetching, and kit discovery.
+ */
+export { isGitHubSource, isLocalSource } from "./types.js";
+// Source parsing
+export { parseSource, formatSource, SourceParseError } from "./source-parser.js";
+// Fetchers
+export { GitFetcher, GitFetchError, createGitFetcher } from "./git-fetcher.js";
+export { LocalFetcher, LocalFetchError, createLocalFetcher } from "./local-fetcher.js";
+export { FetcherRegistry, NoFetcherError, createFetcherRegistry, getDefaultFetcherRegistry, fetchSource, } from "./fetcher-registry.js";
+// Kit scanning
+export { scanKits, filterKitsByName, getMissingKitNames, KitScanError, } from "./kit-scanner.js";
+//# sourceMappingURL=index.js.map

package/dist/discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/discovery/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3D,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEjF,WAAW;AACX,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,gBAAgB,EAA0B,MAAM,kBAAkB,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACvF,OAAO,EACL,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,yBAAyB,EACzB,WAAW,GAEZ,MAAM,uBAAuB,CAAC;AAE/B,eAAe;AACf,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GAEb,MAAM,kBAAkB,CAAC"}

package/dist/discovery/kit-scanner.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Kit scanner for discovering kits in a repository.
+ *
+ * Loads and validates kits.json, primitives.json, and kit manifests.
+ */
+import type { KitDiscoveryResult } from "./types.js";
+/**
+ * Error thrown during kit scanning.
+ */
+export declare class KitScanError extends Error {
+    readonly scanPath?: string | undefined;
+    readonly scanCause?: Error | undefined;
+    constructor(message: string, path?: string, cause?: Error);
+}
+/**
+ * Options for the kit scanner.
+ */
+export interface KitScannerOptions {
+    /**
+     * Whether to validate JSON against schemas.
+     * Defaults to true.
+     */
+    validate?: boolean;
+}
+/**
+ * Scan for kits in a repository.
+ *
+ * Discovers kits by:
+ * 1. Looking for kits.json at repository root
+ * 2. Loading kit manifests from paths specified in kits.json
+ * 3. Handling single-kit repositories (no kits/ directory)
+ *
+ * @param localPath - Path to the repository root
+ * @param source - Original source string for reference
+ * @param options - Scanner options
+ * @returns Kit discovery result with all discovered kits
+ */
+export declare function scanKits(localPath: string, source: string, _options?: KitScannerOptions): Promise<KitDiscoveryResult>;
+/**
+ * Filter kits by name.
+ *
+ * @param result - Kit discovery result
+ * @param kitNames - Kit names to include (empty means all)
+ * @returns Filtered discovery result
+ */
+export declare function filterKitsByName(result: KitDiscoveryResult, kitNames: string[]): KitDiscoveryResult;
+/**
+ * Get kit names that were not found.
+ *
+ * @param result - Kit discovery result
+ * @param requestedNames - Names that were requested
+ * @returns Names that were not found
+ */
+export declare function getMissingKitNames(result: KitDiscoveryResult, requestedNames: string[]): string[];
+//# sourceMappingURL=kit-scanner.d.ts.map

package/dist/discovery/kit-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit-scanner.d.ts","sourceRoot":"","sources":["../../src/discovery/kit-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,KAAK,EACV,kBAAkB,EAKnB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAU1D;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AA0ID;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,iBAAsB,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CAoI7B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,QAAQ,EAAE,MAAM,EAAE,GACjB,kBAAkB,CAcpB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,EAC1B,cAAc,EAAE,MAAM,EAAE,GACvB,MAAM,EAAE,CAGV"}

package/dist/discovery/kit-scanner.js

@@ -0,0 +1,305 @@
+/**
+ * Kit scanner for discovering kits in a repository.
+ *
+ * Loads and validates kits.json, primitives.json, and kit manifests.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Error thrown during kit scanning.
+ */
+export class KitScanError extends Error {
+    scanPath;
+    scanCause;
+    constructor(message, path, cause) {
+        super(message);
+        this.name = "KitScanError";
+        if (path) {
+            this.scanPath = path;
+        }
+        if (cause) {
+            this.scanCause = cause;
+        }
+    }
+}
+/**
+ * Check if a file exists.
+ */
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read and parse a JSON file.
+ */
+async function readJsonFile(filePath) {
+    const content = await fs.readFile(filePath, "utf-8");
+    return JSON.parse(content);
+}
+/**
+ * Count primitives in a kit manifest.
+ */
+function countPrimitives(manifest) {
+    return {
+        commands: manifest.primitives.commands?.length ?? 0,
+        skills: manifest.primitives.skills?.length ?? 0,
+        subagents: manifest.primitives.subagents?.length ?? 0,
+        mcp: manifest.primitives.mcp?.length ?? 0,
+        hooks: manifest.primitives.hooks?.length ?? 0,
+    };
+}
+/**
+ * Extract required primitives from a kit manifest.
+ */
+function extractRequiredPrimitives(manifest) {
+    return manifest.requires?.primitives ?? [];
+}
+/**
+ * Infer repository metadata from directory structure.
+ */
+async function inferMetadata(localPath) {
+    // Try to read package.json for metadata
+    const packageJsonPath = path.join(localPath, "package.json");
+    if (await fileExists(packageJsonPath)) {
+        try {
+            const pkg = await readJsonFile(packageJsonPath);
+            const result = {
+                name: pkg.name ?? path.basename(localPath),
+            };
+            if (pkg.description) {
+                result.description = pkg.description;
+            }
+            if (pkg.version) {
+                result.version = pkg.version;
+            }
+            if (typeof pkg.author === "string") {
+                result.owner = { name: pkg.author };
+            }
+            else if (pkg.author) {
+                result.owner = { name: pkg.author.name };
+            }
+            return result;
+        }
+        catch {
+            // Ignore parse errors
+        }
+    }
+    // Fall back to directory name
+    return {
+        name: path.basename(localPath),
+    };
+}
+/**
+ * Load a kit manifest from a directory.
+ */
+async function loadKitManifest(kitPath, errors) {
+    const manifestPath = path.join(kitPath, "kit.json");
+    if (!(await fileExists(manifestPath))) {
+        errors.push({
+            type: "missing-file",
+            path: manifestPath,
+            message: `Kit manifest not found: ${manifestPath}`,
+        });
+        return null;
+    }
+    try {
+        const manifest = await readJsonFile(manifestPath);
+        // Basic validation
+        if (!manifest.name) {
+            errors.push({
+                type: "validation-error",
+                path: manifestPath,
+                message: "Kit manifest missing required field: name",
+            });
+            return null;
+        }
+        if (!manifest.version) {
+            errors.push({
+                type: "validation-error",
+                path: manifestPath,
+                message: "Kit manifest missing required field: version",
+            });
+            return null;
+        }
+        return manifest;
+    }
+    catch (error) {
+        errors.push({
+            type: "parse-error",
+            path: manifestPath,
+            message: `Failed to parse kit manifest: ${error instanceof Error ? error.message : String(error)}`,
+        });
+        return null;
+    }
+}
+/**
+ * Scan for kits in a repository.
+ *
+ * Discovers kits by:
+ * 1. Looking for kits.json at repository root
+ * 2. Loading kit manifests from paths specified in kits.json
+ * 3. Handling single-kit repositories (no kits/ directory)
+ *
+ * @param localPath - Path to the repository root
+ * @param source - Original source string for reference
+ * @param options - Scanner options
+ * @returns Kit discovery result with all discovered kits
+ */
+export async function scanKits(localPath, source, _options = {}) {
+    const errors = [];
+    const kits = [];
+    let registry;
+    let primitivesRegistry;
+    let repository;
+    // Try to load kits.json
+    const registryPath = path.join(localPath, "kits.json");
+    if (await fileExists(registryPath)) {
+        try {
+            registry = await readJsonFile(registryPath);
+            repository = {
+                name: registry.name,
+            };
+            if (registry.description) {
+                repository.description = registry.description;
+            }
+            if (registry.version) {
+                repository.version = registry.version;
+            }
+            if (registry.owner) {
+                repository.owner = registry.owner;
+            }
+            // Load kits from registry
+            for (const entry of registry.kits) {
+                const kitPath = path.join(localPath, entry.path);
+                const manifest = await loadKitManifest(kitPath, errors);
+                if (manifest) {
+                    kits.push({
+                        name: manifest.name,
+                        path: entry.path,
+                        manifest,
+                        requiredPrimitives: extractRequiredPrimitives(manifest),
+                        primitiveCounts: countPrimitives(manifest),
+                    });
+                }
+            }
+        }
+        catch (error) {
+            errors.push({
+                type: "parse-error",
+                path: registryPath,
+                message: `Failed to parse kits.json: ${error instanceof Error ? error.message : String(error)}`,
+            });
+            repository = await inferMetadata(localPath);
+        }
+    }
+    else {
+        // No kits.json - try to find kits
+        repository = await inferMetadata(localPath);
+        // Check for kits/ directory
+        const kitsDir = path.join(localPath, "kits");
+        if (await fileExists(kitsDir)) {
+            try {
+                const entries = await fs.readdir(kitsDir, { withFileTypes: true });
+                for (const entry of entries) {
+                    if (entry.isDirectory()) {
+                        const kitPath = path.join(kitsDir, entry.name);
+                        const manifest = await loadKitManifest(kitPath, errors);
+                        if (manifest) {
+                            kits.push({
+                                name: manifest.name,
+                                path: `./kits/${entry.name}`,
+                                manifest,
+                                requiredPrimitives: extractRequiredPrimitives(manifest),
+                                primitiveCounts: countPrimitives(manifest),
+                            });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                errors.push({
+                    type: "parse-error",
+                    path: kitsDir,
+                    message: `Failed to scan kits directory: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+        }
+        else {
+            // Check for single-kit repository (kit.json at root)
+            const manifest = await loadKitManifest(localPath, errors);
+            if (manifest) {
+                kits.push({
+                    name: manifest.name,
+                    path: ".",
+                    manifest,
+                    requiredPrimitives: extractRequiredPrimitives(manifest),
+                    primitiveCounts: countPrimitives(manifest),
+                });
+            }
+        }
+    }
+    // Try to load primitives.json
+    const primitivesPath = path.join(localPath, "primitives.json");
+    if (await fileExists(primitivesPath)) {
+        try {
+            primitivesRegistry =
+                await readJsonFile(primitivesPath);
+        }
+        catch (error) {
+            errors.push({
+                type: "parse-error",
+                path: primitivesPath,
+                message: `Failed to parse primitives.json: ${error instanceof Error ? error.message : String(error)}`,
+            });
+        }
+    }
+    const result = {
+        source,
+        localPath,
+        repository,
+        kits,
+        errors,
+    };
+    if (registry) {
+        result.registry = registry;
+    }
+    if (primitivesRegistry) {
+        result.primitivesRegistry = primitivesRegistry;
+    }
+    return result;
+}
+/**
+ * Filter kits by name.
+ *
+ * @param result - Kit discovery result
+ * @param kitNames - Kit names to include (empty means all)
+ * @returns Filtered discovery result
+ */
+export function filterKitsByName(result, kitNames) {
+    if (kitNames.length === 0) {
+        return result;
+    }
+    const nameSet = new Set(kitNames.map((n) => n.toLowerCase()));
+    const filteredKits = result.kits.filter((kit) => nameSet.has(kit.name.toLowerCase()));
+    return {
+        ...result,
+        kits: filteredKits,
+    };
+}
+/**
+ * Get kit names that were not found.
+ *
+ * @param result - Kit discovery result
+ * @param requestedNames - Names that were requested
+ * @returns Names that were not found
+ */
+export function getMissingKitNames(result, requestedNames) {
+    const foundNames = new Set(result.kits.map((kit) => kit.name.toLowerCase()));
+    return requestedNames.filter((name) => !foundNames.has(name.toLowerCase()));
+}
+//# sourceMappingURL=kit-scanner.js.map

package/dist/discovery/kit-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kit-scanner.js","sourceRoot":"","sources":["../../src/discovery/kit-scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAe7B;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,QAAQ,CAAsB;IAC9B,SAAS,CAAqB;IAEvC,YAAY,OAAe,EAAE,IAAa,EAAE,KAAa;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;CACF;AAcD;;GAEG;AACH,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,YAAY,CAAI,QAAgB;IAC7C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,QAAqB;IAC5C,OAAO;QACL,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;QACnD,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;QAC/C,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC;QACrD,GAAG,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;QACzC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,yBAAyB,CAAC,QAAqB;IACtD,OAAO,QAAQ,CAAC,QAAQ,EAAE,UAAU,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,aAAa,CAAC,SAAiB;IAC5C,wCAAwC;IACxC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;IAE7D,IAAI,MAAM,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,YAAY,CAK3B,eAAe,CAAC,CAAC;YAEpB,MAAM,MAAM,GAAuB;gBACjC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;aAC3C,CAAC;YAEF,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;gBACpB,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;YACvC,CAAC;YACD,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAC/B,CAAC;YACD,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;YACtC,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;gBACtB,MAAM,CAAC,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC3C,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;KAC/B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,eAAe,CAC5B,OAAe,EACf,MAAwB;IAExB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAEpD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,2BAA2B,YAAY,EAAE;SACnD,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAc,YAAY,CAAC,CAAC;QAE/D,mBAAmB;QACnB,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,2CAA2C;aACrD,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,kBAAkB;gBACxB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,8CAA8C;aACxD,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,iCAAiC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;SACnG,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAiB,EACjB,MAAc,EACd,WAA8B,EAAE;IAEhC,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,MAAM,IAAI,GAAoB,EAAE,CAAC;IAEjC,IAAI,QAAiC,CAAC;IACtC,IAAI,kBAAkD,CAAC;IACvD,IAAI,UAA8B,CAAC;IAEnC,wBAAwB;IACxB,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAEvD,IAAI,MAAM,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,YAAY,CAAc,YAAY,CAAC,CAAC;YACzD,UAAU,GAAG;gBACX,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB,CAAC;YACF,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;gBACzB,UAAU,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;YAChD,CAAC;YACD,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACrB,UAAU,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;YACxC,CAAC;YACD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,UAAU,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;YACpC,CAAC;YAED,0BAA0B;YAC1B,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;gBAExD,IAAI,QAAQ,EAAE,CAAC;oBACb,IAAI,CAAC,IAAI,CAAC;wBACR,IAAI,EAAE,QAAQ,CAAC,IAAI;wBACnB,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,QAAQ;wBACR,kBAAkB,EAAE,yBAAyB,CAAC,QAAQ,CAAC;wBACvD,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC;qBAC3C,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,YAAY;gBAClB,OAAO,EAAE,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aAChG,CAAC,CAAC;YACH,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;SAAM,CAAC;QACN,kCAAkC;QAClC,UAAU,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;QAE5C,4BAA4B;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAE7C,IAAI,MAAM,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAEnE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;oBAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;wBACxB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC/C,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;wBAExD,IAAI,QAAQ,EAAE,CAAC;4BACb,IAAI,CAAC,IAAI,CAAC;gCACR,IAAI,EAAE,QAAQ,CAAC,IAAI;gCACnB,IAAI,EAAE,UAAU,KAAK,CAAC,IAAI,EAAE;gCAC5B,QAAQ;gCACR,kBAAkB,EAAE,yBAAyB,CAAC,QAAQ,CAAC;gCACvD,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC;6BAC3C,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,aAAa;oBACnB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;iBACpG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAE1D,IAAI,QAAQ,EAAE,CAAC;gBACb,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI,EAAE,QAAQ,CAAC,IAAI;oBACnB,IAAI,EAAE,GAAG;oBACT,QAAQ;oBACR,kBAAkB,EAAE,yBAAyB,CAAC,QAAQ,CAAC;oBACvD,eAAe,EAAE,eAAe,CAAC,QAAQ,CAAC;iBAC3C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAE/D,IAAI,MAAM,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,kBAAkB;gBAChB,MAAM,YAAY,CAAqB,cAAc,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,oCAAoC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;aACtG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAuB;QACjC,MAAM;QACN,SAAS;QACT,UAAU;QACV,IAAI;QACJ,MAAM;KACP,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IACD,IAAI,kBAAkB,EAAE,CAAC;QACvB,MAAM,CAAC,kBAAkB,GAAG,kBAAkB,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAA0B,EAC1B,QAAkB;IAElB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CACpC,CAAC;IAEF,OAAO;QACL,GAAG,MAAM;QACT,IAAI,EAAE,YAAY;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA0B,EAC1B,cAAwB;IAExB,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC7E,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;AAC9E,CAAC"}

package/dist/discovery/local-fetcher.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Local fetcher for handling local path sources.
+ *
+ * Validates that local paths exist and are accessible.
+ */
+import type { SourceFetcher, FetchResult } from "./types.js";
+/**
+ * Error thrown when local path operations fail.
+ */
+export declare class LocalFetchError extends Error {
+    readonly localSource: string;
+    readonly localCause?: Error | undefined;
+    constructor(message: string, source: string, cause?: Error);
+}
+/**
+ * Local fetcher implementation for local path sources.
+ */
+export declare class LocalFetcher implements SourceFetcher {
+    /**
+     * Check if this fetcher can handle the given source.
+     *
+     * Handles local paths: ./path, ../path, /absolute/path, ~/path
+     */
+    canHandle(source: string): boolean;
+    /**
+     * Fetch (validate) a local path.
+     *
+     * @param source - Local path (e.g., "./my-kits" or "/absolute/path")
+     * @returns Fetch result with local path (no cleanup needed)
+     * @throws LocalFetchError if the path does not exist or is not accessible
+     */
+    fetch(source: string): Promise<FetchResult>;
+}
+/**
+ * Create a local fetcher.
+ */
+export declare function createLocalFetcher(): LocalFetcher;
+//# sourceMappingURL=local-fetcher.d.ts.map

package/dist/discovery/local-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-fetcher.d.ts","sourceRoot":"","sources":["../../src/discovery/local-fetcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAe,MAAM,YAAY,CAAC;AAG1E;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;gBAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAQ3D;AAED;;GAEG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASlC;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CA0ElD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD"}