@hashicorp/kits 0.1.0

package/dist/tui/compatibility.js

@@ -0,0 +1,355 @@
+/**
+ * Compatibility check screen.
+ *
+ * Displays compatibility matrix between selected kits and harnesses,
+ * showing missing primitives and experimental features.
+ */
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+import { formatKit, formatWarning, formatError } from "./spinner.js";
+import { debugLog } from "../core/debug.js";
+/**
+ * Check compatibility of a kit against a harness.
+ */
+export function checkKitHarnessCompatibility(kit, harness) {
+    const missing = [];
+    const experimental = [];
+    const supported = new Set(harness.supportedPrimitives);
+    for (const required of kit.requiredPrimitives) {
+        if (!supported.has(required)) {
+            missing.push(required);
+        }
+        // Note: experimental tracking would need adapter-level support
+        // For now, we track missing only
+    }
+    return {
+        harness: harness.name,
+        harnessDisplayName: harness.displayName,
+        compatible: missing.length === 0,
+        missingPrimitives: missing,
+        experimentalPrimitives: experimental,
+    };
+}
+/**
+ * Build compatibility matrix for selected kits and harnesses.
+ */
+export function buildCompatibilityMatrix(kits, harnesses) {
+    return kits.map((kit) => {
+        const harnessResults = harnesses.map((harness) => checkKitHarnessCompatibility(kit, harness));
+        return {
+            kit: kit.name,
+            kitVersion: kit.manifest.version,
+            requiredPrimitives: kit.requiredPrimitives,
+            harnesses: harnessResults,
+            hasIncompatible: harnessResults.some((r) => !r.compatible),
+        };
+    });
+}
+/**
+ * Format compatibility status for display.
+ */
+function formatCompatibilityStatus(compat) {
+    if (compat.compatible) {
+        if (compat.experimentalPrimitives.length > 0) {
+            return pc.yellow("experimental") + " " + pc.yellow("⚠");
+        }
+        return pc.green("compatible") + " " + pc.green("✓");
+    }
+    return pc.red("incompatible") + " " + pc.red("✗");
+}
+function formatScopeLabel(scope) {
+    return scope === "global" ? "Global (user-level)" : "Project (current directory)";
+}
+/**
+ * Display compatibility matrix for a single kit.
+ */
+export function displayKitCompatibility(matrix) {
+    const baseIndent = "   ";
+    const subIndent = "     ";
+    clack.log.message("");
+    clack.log.message(`${baseIndent}${formatKit(matrix.kit, matrix.kitVersion)}`);
+    if (matrix.requiredPrimitives.length > 0) {
+        clack.log.message(`${subIndent}${pc.dim("Requires:")} ${matrix.requiredPrimitives.join(", ")}`);
+    }
+    clack.log.message("");
+    for (const harness of matrix.harnesses) {
+        const status = formatCompatibilityStatus(harness);
+        clack.log.message(`${baseIndent}${harness.harnessDisplayName}: ${status}`);
+        if (harness.missingPrimitives.length > 0) {
+            clack.log.message(`${subIndent}${pc.dim("Missing:")} ${formatError(harness.missingPrimitives.join(", "))}`);
+        }
+        if (harness.experimentalPrimitives.length > 0) {
+            clack.log.message(`${subIndent}${pc.dim("Experimental:")} ${formatWarning(harness.experimentalPrimitives.join(", "))}`);
+        }
+    }
+}
+/**
+ * Display full compatibility matrix.
+ */
+export function displayCompatibilityMatrix(matrices, context) {
+    const selectedKitLines = matrices.map((matrix) => formatKit(matrix.kit, matrix.kitVersion));
+    const selectedHarnesses = context.harnesses.map((h) => h.displayName).join(", ");
+    const scopeLabel = formatScopeLabel(context.scope);
+    const requiredLines = matrices.map((matrix) => {
+        const required = matrix.requiredPrimitives.length > 0
+            ? matrix.requiredPrimitives.join(", ")
+            : "none";
+        return `${formatKit(matrix.kit, matrix.kitVersion)}: ${required}`;
+    });
+    const harnessStatusLines = context.harnesses.map((harness) => {
+        let compatible = true;
+        let experimental = false;
+        for (const matrix of matrices) {
+            const entry = matrix.harnesses.find((h) => h.harness === harness.name);
+            if (entry) {
+                if (!entry.compatible) {
+                    compatible = false;
+                }
+                if (entry.experimentalPrimitives.length > 0) {
+                    experimental = true;
+                }
+            }
+        }
+        const status = compatible
+            ? experimental
+                ? pc.yellow("experimental") + " " + pc.yellow("⚠")
+                : pc.green("compatible") + " " + pc.green("✓")
+            : pc.red("incompatible") + " " + pc.red("✗");
+        return `${harness.displayName}: ${status}`;
+    });
+    const lines = [
+        "Compatibility check:",
+        "",
+        "Selected Kits:",
+        ...selectedKitLines,
+        "",
+        "Selected Harnesses:",
+        selectedHarnesses,
+        "",
+        "Selected Scope:",
+        scopeLabel,
+        "",
+        "Required Primitives:",
+        ...requiredLines,
+        "",
+        ...harnessStatusLines,
+    ];
+    clack.log.info(lines.join("\n"));
+}
+/**
+ * Check if any incompatibilities exist in the matrix.
+ */
+export function hasIncompatibilities(matrices) {
+    return matrices.some((m) => m.hasIncompatible);
+}
+/**
+ * Get incompatible kit-harness pairs.
+ */
+export function getIncompatiblePairs(matrices) {
+    const pairs = [];
+    for (const matrix of matrices) {
+        for (const harness of matrix.harnesses) {
+            if (!harness.compatible) {
+                pairs.push({
+                    kit: matrix.kit,
+                    harness: harness.harness,
+                    missing: harness.missingPrimitives,
+                });
+            }
+        }
+    }
+    return pairs;
+}
+/**
+ * Get compatible kit-harness pairs.
+ */
+export function getCompatiblePairs(matrices) {
+    const pairs = [];
+    for (const matrix of matrices) {
+        for (const harness of matrix.harnesses) {
+            if (harness.compatible) {
+                pairs.push({
+                    kit: matrix.kit,
+                    harness: harness.harness,
+                });
+            }
+        }
+    }
+    return pairs;
+}
+/**
+ * Display incompatibility summary.
+ */
+export function displayIncompatibilitySummary(matrices, scope) {
+    const incompatible = getIncompatiblePairs(matrices);
+    if (incompatible.length === 0) {
+        return;
+    }
+    const summaryLines = incompatible.map((pair) => {
+        const scopeLabel = scope === "global" ? "global" : "project";
+        const missing = pair.missing.length > 0 ? pair.missing.join(", ") : "required primitives";
+        const reason = `Missing ${missing} support at ${scopeLabel} scope`;
+        return `${pair.kit} → ${pair.harness} ${pc.red("✗")} (${reason})`;
+    });
+    const lines = [
+        `${incompatible.length} incompatible combination${incompatible.length === 1 ? "" : "s"} found:`,
+        "",
+        ...summaryLines,
+    ];
+    clack.log.warn(lines.join("\n"));
+}
+/**
+ * Prompt user how to handle incompatibilities.
+ */
+export async function promptIncompatibilityChoice(matrices, scope) {
+    const compatible = getCompatiblePairs(matrices);
+    // Display summary first
+    displayIncompatibilitySummary(matrices, scope);
+    // If no compatible pairs, no choice to make
+    if (compatible.length === 0) {
+        clack.log.error("No compatible kit-harness combinations available");
+        return {
+            cancelled: false,
+            choice: "cancel",
+        };
+    }
+    // Offer choices (no partial installs)
+    const options = [
+        {
+            value: "go-back",
+            label: "Go back and change selection",
+        },
+    ];
+    if (compatible.length > 0) {
+        options.push({
+            value: "install-compatible",
+            label: "Install into compatible harnesses",
+        });
+    }
+    options.push({
+        value: "cancel",
+        label: "Cancel installation",
+    });
+    const choice = await clack.select({
+        message: `How would you like to proceed?\n${pc.gray("│")} `,
+        options,
+    });
+    if (clack.isCancel(choice)) {
+        return {
+            cancelled: true,
+        };
+    }
+    return {
+        cancelled: false,
+        choice: choice,
+    };
+}
+/**
+ * Run compatibility check flow.
+ * Returns the check result and filtered compatible pairs.
+ */
+export async function runCompatibilityCheck(kits, harnesses, scope, options) {
+    const matrices = buildCompatibilityMatrix(kits, harnesses);
+    const hasIssues = hasIncompatibilities(matrices);
+    void debugLog({
+        level: "info",
+        event: "compatibility.check",
+        data: {
+            kits: kits.map((k) => k.name),
+            harnesses: harnesses.map((h) => h.name),
+            scope,
+            hasIssues,
+        },
+    });
+    if (hasIssues) {
+        void debugLog({
+            level: "warn",
+            event: "compatibility.incompatible",
+            data: {
+                pairs: getIncompatiblePairs(matrices).map((pair) => ({
+                    kit: pair.kit,
+                    harness: pair.harness,
+                    missing: pair.missing,
+                })),
+            },
+        });
+    }
+    // Always show matrix if requested or if there are issues
+    if (options?.showMatrix || hasIssues) {
+        displayCompatibilityMatrix(matrices, { kits, harnesses, scope });
+    }
+    // If no issues, proceed
+    if (!hasIssues) {
+        return {
+            matrices,
+            result: { cancelled: false, choice: "proceed" },
+            compatiblePairs: getCompatiblePairs(matrices),
+        };
+    }
+    // Prompt for choice if enabled
+    if (options?.promptOnIncompatible !== false) {
+        const result = await promptIncompatibilityChoice(matrices, scope);
+        if (result.cancelled || result.choice === "cancel") {
+            return {
+                matrices,
+                result,
+                compatiblePairs: [],
+            };
+        }
+        if (result.choice === "go-back") {
+            return {
+                matrices,
+                result,
+                compatiblePairs: [],
+            };
+        }
+        if (result.choice === "install-compatible") {
+            return {
+                matrices,
+                result,
+                compatiblePairs: getCompatiblePairs(matrices),
+            };
+        }
+        return {
+            matrices,
+            result,
+            compatiblePairs: [],
+        };
+    }
+    // Non-interactive: no partial installs
+    return {
+        matrices,
+        result: { cancelled: false, choice: "cancel" },
+        compatiblePairs: [],
+    };
+}
+/**
+ * Get kits that are compatible with at least one selected harness.
+ */
+export function getCompatibleKits(matrices) {
+    const kits = new Set();
+    for (const matrix of matrices) {
+        for (const harness of matrix.harnesses) {
+            if (harness.compatible) {
+                kits.add(matrix.kit);
+                break;
+            }
+        }
+    }
+    return Array.from(kits);
+}
+/**
+ * Get harnesses that are compatible with at least one selected kit.
+ */
+export function getCompatibleHarnesses(matrices) {
+    const harnesses = new Set();
+    for (const matrix of matrices) {
+        for (const harness of matrix.harnesses) {
+            if (harness.compatible) {
+                harnesses.add(harness.harness);
+            }
+        }
+    }
+    return Array.from(harnesses);
+}
+//# sourceMappingURL=compatibility.js.map

package/dist/tui/compatibility.js.map

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

package/dist/tui/env-prompt.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Environment variable prompts.
+ *
+ * Detects required environment variables from MCP server configurations
+ * and prompts users for missing values.
+ */
+import type { McpServerConfig, ResolvedPrimitive, ResolvedEnvVar } from "../core/types.js";
+import type { EnvVarRequirement, EnvVarPromptResult, EnvVarPromptResults } from "./types.js";
+/**
+ * Extract environment variable requirements from MCP config.
+ *
+ * Works with the new schema where env values are McpEnvVarDefinition objects
+ * containing description, required, sensitive, and optional default fields.
+ */
+export declare function extractEnvVarsFromConfig(config: McpServerConfig, source: string): EnvVarRequirement[];
+/**
+ * Extract all environment variable requirements from resolved primitives.
+ */
+export declare function extractAllEnvVars(primitives: ResolvedPrimitive[]): EnvVarRequirement[];
+/**
+ * Categorization result for environment variables.
+ * Separates sensitive vars (never prompted) from nonsensitive vars.
+ */
+export interface EnvVarCategorization {
+    /** Sensitive vars - always passthrough, never prompted */
+    sensitive: EnvVarRequirement[];
+    /** Nonsensitive vars already satisfied (have current value) */
+    satisfied: EnvVarRequirement[];
+    /** Nonsensitive required vars without value or default */
+    missing: EnvVarRequirement[];
+    /** Nonsensitive optional vars (may have default) */
+    optional: EnvVarRequirement[];
+}
+/**
+ * Group requirements by sensitivity and whether they need prompting.
+ *
+ * Sensitive variables are separated into their own category and are never
+ * prompted - they must be set in the shell environment.
+ *
+ * Nonsensitive variables are grouped by:
+ * - satisfied: Have current value from environment
+ * - missing: Required but no value or default
+ * - optional: Not required, or has default value
+ */
+export declare function categorizeEnvVars(requirements: EnvVarRequirement[]): EnvVarCategorization;
+/**
+ * Display warnings for sensitive environment variables.
+ *
+ * Sensitive variables are never prompted - they must be set in the shell
+ * environment before using the MCP server. This function displays warnings
+ * for any sensitive variables that are required but not set.
+ *
+ * @param requirements - All environment variable requirements
+ * @returns true if any warnings were displayed
+ */
+export declare function displaySensitiveWarnings(requirements: EnvVarRequirement[]): boolean;
+/**
+ * Display environment variable status with sensitivity classification.
+ *
+ * Shows separate sections for:
+ * - Sensitive variables (with warnings for missing required)
+ * - Nonsensitive satisfied variables
+ * - Nonsensitive missing required variables
+ * - Nonsensitive optional variables
+ */
+export declare function displayEnvVarStatus(requirements: EnvVarRequirement[]): void;
+/**
+ * Prompt for environment variables.
+ *
+ * IMPORTANT: Sensitive variables are NEVER prompted. They are:
+ * - Displayed with warnings if not set in the environment
+ * - Automatically marked for passthrough to the harness config
+ *
+ * Only nonsensitive variables are prompted or configured.
+ *
+ * @param requirements - All environment variable requirements
+ * @param options - Prompting options
+ * @returns Prompt results for all variables
+ */
+export declare function promptForEnvVars(requirements: EnvVarRequirement[], _options?: {
+    sourceToKits?: Map<string, Set<string>>;
+    skipSatisfied?: boolean;
+    skipOptional?: boolean;
+}): Promise<EnvVarPromptResults>;
+export declare function promptForSharedMcpInstances(usageByInstance: Map<string, Set<string>>, existingOverrides?: Record<string, Record<string, string>>): Promise<{
+    cancelled: boolean;
+    overrides: Record<string, Record<string, string>>;
+}>;
+/**
+ * Apply environment variable results to a config.
+ *
+ * @deprecated Use applyEnvVarResultsAsResolved for proper ResolvedEnvVar output.
+ */
+export declare function applyEnvVarResults(results: EnvVarPromptResult[]): Record<string, string>;
+/**
+ * Convert prompt results to ResolvedEnvVar array for adapter consumption.
+ *
+ * This function maps TUI prompt results to the ResolvedEnvVar format expected
+ * by adapters for proper environment variable transformation.
+ *
+ * @param results - Prompt results from promptForEnvVars
+ * @param requirements - Original requirements (for descriptions)
+ * @returns Array of ResolvedEnvVar ready for adapter transformation
+ */
+export declare function applyEnvVarResultsAsResolved(results: EnvVarPromptResult[], requirements: EnvVarRequirement[]): ResolvedEnvVar[];
+/**
+ * Check if all required nonsensitive vars are satisfied.
+ *
+ * Sensitive vars are not checked here - they are always passthrough and
+ * warnings are displayed separately. This function checks only nonsensitive
+ * vars that require user input.
+ */
+export declare function areRequiredVarsSatisfied(requirements: EnvVarRequirement[]): boolean;
+/**
+ * Get list of missing required nonsensitive vars.
+ *
+ * Returns only nonsensitive vars that are required but don't have a value
+ * or default. Sensitive vars are excluded - they are handled separately
+ * with warnings.
+ */
+export declare function getMissingRequiredVars(requirements: EnvVarRequirement[]): string[];
+/**
+ * Get list of missing required sensitive vars (for warnings).
+ *
+ * Returns sensitive vars that are required but not set in the environment.
+ * These are displayed as warnings since they cannot be prompted.
+ */
+export declare function getMissingSensitiveVars(requirements: EnvVarRequirement[]): string[];
+//# sourceMappingURL=env-prompt.d.ts.map

package/dist/tui/env-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-prompt.d.ts","sourceRoot":"","sources":["../../src/tui/env-prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,eAAe,EAEf,iBAAiB,EAEjB,cAAc,EACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,iBAAiB,EAEjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAkBpB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EACvB,MAAM,EAAE,MAAM,GACb,iBAAiB,EAAE,CAqBrB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,iBAAiB,EAAE,GAC9B,iBAAiB,EAAE,CAuBrB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,0DAA0D;IAC1D,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,+DAA+D;IAC/D,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,0DAA0D;IAC1D,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,oDAAoD;IACpD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,oBAAoB,CA8BzF;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,iBAAiB,EAAE,GAChC,OAAO,CA6DT;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAO3E;AAkHD;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,iBAAiB,EAAE,EACjC,QAAQ,CAAC,EAAE;IACT,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IACxC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GACA,OAAO,CAAC,mBAAmB,CAAC,CAgD9B;AAED,wBAAsB,2BAA2B,CAC/C,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,EACzC,iBAAiB,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAC7D,OAAO,CAAC;IACT,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD,CAAC,CA6CD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,kBAAkB,EAAE,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAUxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,kBAAkB,EAAE,EAC7B,YAAY,EAAE,iBAAiB,EAAE,GAChC,cAAc,EAAE,CAwDlB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,iBAAiB,EAAE,GAChC,OAAO,CAIT;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,iBAAiB,EAAE,GAChC,MAAM,EAAE,CAIV;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,iBAAiB,EAAE,GAChC,MAAM,EAAE,CAIV"}