@hashicorp/kits 0.1.0

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

@@ -0,0 +1,67 @@
+/**
+ * Scope selection screen.
+ *
+ * Prompts user to select installation scope (global or project)
+ * and provides explanations of each scope.
+ */
+import type { InstallationScope } from "../core/types.js";
+import type { SelectOption } from "./types.js";
+/**
+ * Scope selection result.
+ */
+export interface ScopeSelectionResult {
+    cancelled: boolean;
+    scope?: InstallationScope;
+}
+/**
+ * Create select options for scope selection.
+ */
+export declare function createScopeOptions(): SelectOption<InstallationScope>[];
+/**
+ * Display scope descriptions.
+ */
+export declare function displayScopeInfo(): void;
+/**
+ * Prompt user to select installation scope.
+ *
+ * @param options - Selection options
+ */
+export declare function selectScope(options?: {
+    showInfo?: boolean;
+    message?: string;
+}): Promise<ScopeSelectionResult>;
+/**
+ * Format scope for display.
+ *
+ * @param scope - Installation scope
+ */
+export declare function formatScope(scope: InstallationScope): string;
+/**
+ * Format scope with description for display.
+ *
+ * @param scope - Installation scope
+ */
+export declare function formatScopeWithDescription(scope: InstallationScope): string;
+/**
+ * Get scope path description.
+ *
+ * @param scope - Installation scope
+ * @param projectRoot - Project root path (for project scope display)
+ */
+export declare function getScopePathDescription(scope: InstallationScope, projectRoot?: string): string;
+/**
+ * Display selected scope confirmation.
+ *
+ * @param scope - Selected installation scope
+ * @param projectRoot - Project root path (for project scope)
+ */
+export declare function displayScopeConfirmation(scope: InstallationScope, projectRoot?: string): void;
+/**
+ * Display selected scope with action text.
+ *
+ * @param scope - Selected installation scope
+ * @param projectRoot - Project root path (for project scope)
+ * @param actionLabel - Action label (e.g. "Installing to", "Uninstalling from")
+ */
+export declare function displayScopeAction(scope: InstallationScope, projectRoot: string | undefined, actionLabel: string): void;
+//# sourceMappingURL=scope-select.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scope-select.d.ts","sourceRoot":"","sources":["../../src/tui/scope-select.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAAC,iBAAiB,CAAC,EAAE,CAatE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAYvC;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE;IAC1C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqChC;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ9F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,iBAAiB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAE7F;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,WAAW,EAAE,MAAM,GAClB,IAAI,CAIN"}

package/dist/tui/scope-select.js

@@ -0,0 +1,134 @@
+/**
+ * Scope selection screen.
+ *
+ * Prompts user to select installation scope (global or project)
+ * and provides explanations of each scope.
+ */
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+/**
+ * Create select options for scope selection.
+ */
+export function createScopeOptions() {
+    return [
+        {
+            value: "global",
+            label: "Global (user-level)",
+            hint: "Available in all projects",
+        },
+        {
+            value: "project",
+            label: "Project (current directory)",
+            hint: "Version-controllable",
+        },
+    ];
+}
+/**
+ * Display scope descriptions.
+ */
+export function displayScopeInfo() {
+    clack.log.info("Installation scope:");
+    const scopeLines = [
+        `${pc.bold("Global")} - Installs to user-level directories`,
+        pc.dim("  ~/.claude/, ~/.gemini/, ~/.codex/, etc."),
+        pc.dim("  Available in all projects on this machine"),
+        "",
+        `${pc.bold("Project")} - Installs to current directory`,
+        pc.dim("  .claude/, .gemini/, .codex/, etc."),
+        pc.dim("  Version-controllable, shared with team"),
+    ];
+    clack.log.message(scopeLines.join("\n"));
+}
+/**
+ * Prompt user to select installation scope.
+ *
+ * @param options - Selection options
+ */
+export async function selectScope(options) {
+    // Show scope information if requested
+    if (options?.showInfo !== false) {
+        displayScopeInfo();
+    }
+    // Create options for selection
+    const selectOptions = createScopeOptions();
+    // Convert to clack 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 defaultMessage = `Where would you like to install selected kits?\n${pc.gray("│")} `;
+    const selected = await clack.select({
+        message: options?.message ?? defaultMessage,
+        options: clackOptions,
+    });
+    if (clack.isCancel(selected)) {
+        return {
+            cancelled: true,
+        };
+    }
+    return {
+        cancelled: false,
+        scope: selected,
+    };
+}
+/**
+ * Format scope for display.
+ *
+ * @param scope - Installation scope
+ */
+export function formatScope(scope) {
+    return scope === "global" ? "Global" : "Project";
+}
+/**
+ * Format scope with description for display.
+ *
+ * @param scope - Installation scope
+ */
+export function formatScopeWithDescription(scope) {
+    return scope === "global"
+        ? `${pc.bold("Global")} ${pc.dim("(user-level)")}`
+        : `${pc.bold("Project")} ${pc.dim("(current directory)")}`;
+}
+/**
+ * Get scope path description.
+ *
+ * @param scope - Installation scope
+ * @param projectRoot - Project root path (for project scope display)
+ */
+export function getScopePathDescription(scope, projectRoot) {
+    if (scope === "global") {
+        return "~/.agents/";
+    }
+    if (projectRoot) {
+        return `${projectRoot}/.agents/`;
+    }
+    return ".agents/";
+}
+/**
+ * Display selected scope confirmation.
+ *
+ * @param scope - Selected installation scope
+ * @param projectRoot - Project root path (for project scope)
+ */
+export function displayScopeConfirmation(scope, projectRoot) {
+    displayScopeAction(scope, projectRoot, "Installing to");
+}
+/**
+ * Display selected scope with action text.
+ *
+ * @param scope - Selected installation scope
+ * @param projectRoot - Project root path (for project scope)
+ * @param actionLabel - Action label (e.g. "Installing to", "Uninstalling from")
+ */
+export function displayScopeAction(scope, projectRoot, actionLabel) {
+    const scopeLabel = formatScopeWithDescription(scope);
+    const pathDesc = scope === "project" && projectRoot ? pc.dim(` (${projectRoot})`) : "";
+    clack.log.info(`${actionLabel} ${scopeLabel}${pathDesc}`);
+}
+//# sourceMappingURL=scope-select.js.map

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

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

package/dist/tui/spinner.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Spinner utilities for TUI progress indicators.
+ *
+ * Wraps @clack/prompts spinner for consistent progress display.
+ */
+import * as clack from "@clack/prompts";
+/**
+ * Spinner instance type from clack.
+ */
+export type Spinner = ReturnType<typeof clack.spinner>;
+/**
+ * Create and start a spinner with the given message.
+ */
+export declare function startSpinner(message: string): Spinner;
+/**
+ * Stop a spinner with a success message.
+ */
+export declare function stopSpinnerSuccess(spinner: Spinner, message: string): void;
+/**
+ * Stop a spinner with a failure message.
+ */
+export declare function stopSpinnerError(spinner: Spinner, message: string): void;
+/**
+ * Stop a spinner with a warning message.
+ */
+export declare function stopSpinnerWarning(spinner: Spinner, message: string): void;
+/**
+ * Stop a spinner with a neutral message.
+ */
+export declare function stopSpinner(spinner: Spinner, message: string): void;
+/**
+ * Update spinner message while running.
+ */
+export declare function updateSpinner(spinner: Spinner, message: string): void;
+/**
+ * Execute an async operation with spinner feedback.
+ */
+export declare function withSpinner<T>(startMessage: string, operation: () => Promise<T>, options?: {
+    successMessage?: string | ((result: T) => string);
+    errorMessage?: string | ((error: Error) => string);
+}): Promise<T>;
+/**
+ * Spinner for source fetching.
+ */
+export declare function createFetchSpinner(source: string): Spinner;
+/**
+ * Spinner for kit scanning.
+ */
+export declare function createScanSpinner(): Spinner;
+/**
+ * Spinner for harness detection.
+ */
+export declare function createDetectionSpinner(): Spinner;
+/**
+ * Spinner for primitive resolution.
+ */
+export declare function createResolutionSpinner(): Spinner;
+/**
+ * Spinner for installation.
+ */
+export declare function createInstallSpinner(harnessName: string): Spinner;
+/**
+ * Spinner for upgrade checking.
+ */
+export declare function createUpgradeCheckSpinner(): Spinner;
+/**
+ * Spinner for manifest update.
+ */
+export declare function createManifestSpinner(): Spinner;
+/**
+ * Format count with proper pluralization.
+ */
+export declare function formatCount(count: number, singular: string, plural?: string): string;
+/**
+ * Format a source name for display.
+ */
+export declare function formatSource(source: string): string;
+/**
+ * Format a kit name for display.
+ */
+export declare function formatKit(name: string, version?: string): string;
+/**
+ * Format a harness name for display.
+ */
+export declare function formatHarness(displayName: string, version?: string): string;
+/**
+ * Format a path for display.
+ */
+export declare function formatPath(path: string): string;
+/**
+ * Format a version for display.
+ */
+export declare function formatVersion(version: string): string;
+/**
+ * Format a primitive type for display.
+ */
+export declare function formatPrimitiveType(type: string): string;
+/**
+ * Format an error message.
+ */
+export declare function formatError(message: string): string;
+/**
+ * Format a warning message.
+ */
+export declare function formatWarning(message: string): string;
+/**
+ * Format a success message.
+ */
+export declare function formatSuccess(message: string): string;
+/**
+ * Format a dim/subtle message.
+ */
+export declare function formatDim(message: string): string;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/tui/spinner.d.ts.map

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

package/dist/tui/spinner.js

@@ -0,0 +1,186 @@
+/**
+ * Spinner utilities for TUI progress indicators.
+ *
+ * Wraps @clack/prompts spinner for consistent progress display.
+ */
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+/**
+ * Create and start a spinner with the given message.
+ */
+export function startSpinner(message) {
+    const spinner = clack.spinner();
+    spinner.start(message);
+    return spinner;
+}
+/**
+ * Stop a spinner with a success message.
+ */
+export function stopSpinnerSuccess(spinner, message) {
+    spinner.stop(`${message} ${pc.green("✓")}`);
+}
+/**
+ * Stop a spinner with a failure message.
+ */
+export function stopSpinnerError(spinner, message) {
+    spinner.stop(`${message} ${pc.red("✗")}`);
+}
+/**
+ * Stop a spinner with a warning message.
+ */
+export function stopSpinnerWarning(spinner, message) {
+    spinner.stop(`${message} ${pc.yellow("⚠")}`);
+}
+/**
+ * Stop a spinner with a neutral message.
+ */
+export function stopSpinner(spinner, message) {
+    spinner.stop(message);
+}
+/**
+ * Update spinner message while running.
+ */
+export function updateSpinner(spinner, message) {
+    spinner.message(message);
+}
+/**
+ * Execute an async operation with spinner feedback.
+ */
+export async function withSpinner(startMessage, operation, options) {
+    const spinner = startSpinner(startMessage);
+    try {
+        const result = await operation();
+        const successMsg = options?.successMessage
+            ? typeof options.successMessage === "function"
+                ? options.successMessage(result)
+                : options.successMessage
+            : startMessage.replace(/\.\.\.$/, "");
+        stopSpinnerSuccess(spinner, successMsg);
+        return result;
+    }
+    catch (error) {
+        const errorMsg = options?.errorMessage
+            ? typeof options.errorMessage === "function"
+                ? options.errorMessage(error)
+                : options.errorMessage
+            : `Failed: ${error.message}`;
+        stopSpinnerError(spinner, errorMsg);
+        throw error;
+    }
+}
+/**
+ * Spinner for source fetching.
+ */
+export function createFetchSpinner(source) {
+    return startSpinner(`Fetching ${pc.cyan(source)}...`);
+}
+/**
+ * Spinner for kit scanning.
+ */
+export function createScanSpinner() {
+    return startSpinner("Scanning for kits...");
+}
+/**
+ * Spinner for harness detection.
+ */
+export function createDetectionSpinner() {
+    return startSpinner("Detecting AI harnesses...");
+}
+/**
+ * Spinner for primitive resolution.
+ */
+export function createResolutionSpinner() {
+    return startSpinner("Resolving primitive references...");
+}
+/**
+ * Spinner for installation.
+ */
+export function createInstallSpinner(harnessName) {
+    return startSpinner(`Installing to ${pc.cyan(harnessName)}...`);
+}
+/**
+ * Spinner for upgrade checking.
+ */
+export function createUpgradeCheckSpinner() {
+    return startSpinner("Checking for available upgrades...");
+}
+/**
+ * Spinner for manifest update.
+ */
+export function createManifestSpinner() {
+    return startSpinner("Updating installation manifest...");
+}
+/**
+ * Format count with proper pluralization.
+ */
+export function formatCount(count, singular, plural) {
+    const word = count === 1 ? singular : (plural ?? `${singular}s`);
+    return `${pc.bold(String(count))} ${word}`;
+}
+/**
+ * Format a source name for display.
+ */
+export function formatSource(source) {
+    return pc.cyan(source);
+}
+/**
+ * Format a kit name for display.
+ */
+export function formatKit(name, version) {
+    if (version) {
+        return `${pc.bold(name)} ${pc.dim(`v${version}`)}`;
+    }
+    return pc.bold(name);
+}
+/**
+ * Format a harness name for display.
+ */
+export function formatHarness(displayName, version) {
+    if (version) {
+        return `${displayName} ${pc.dim(`v${version}`)}`;
+    }
+    return displayName;
+}
+/**
+ * Format a path for display.
+ */
+export function formatPath(path) {
+    return pc.dim(path);
+}
+/**
+ * Format a version for display.
+ */
+export function formatVersion(version) {
+    return pc.dim(`v${version}`);
+}
+/**
+ * Format a primitive type for display.
+ */
+export function formatPrimitiveType(type) {
+    return pc.cyan(type);
+}
+/**
+ * Format an error message.
+ */
+export function formatError(message) {
+    return pc.red(message);
+}
+/**
+ * Format a warning message.
+ */
+export function formatWarning(message) {
+    return pc.yellow(message);
+}
+/**
+ * Format a success message.
+ */
+export function formatSuccess(message) {
+    return pc.green(message);
+}
+/**
+ * Format a dim/subtle message.
+ */
+export function formatDim(message) {
+    return pc.dim(message);
+}
+//# sourceMappingURL=spinner.js.map

package/dist/tui/spinner.js.map

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

package/dist/tui/summary.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Installation summary display.
+ *
+ * Shows success/error summary after installation completes,
+ * listing installed primitives and next steps.
+ */
+import type { HarnessName, InstallationScope } from "../core/types.js";
+import type { InstallResult as AdapterInstallResult } from "../adapters/types.js";
+import type { InstallSummary, SkippedInstallEntry } from "./types.js";
+/**
+ * Display installation plan summary before proceeding.
+ */
+export declare function displayInstallPlanSummary(kits: {
+    name: string;
+    version: string;
+}[], harnesses: {
+    displayName: string;
+}[], scope: InstallationScope): void;
+/**
+ * Prompt to proceed with installation.
+ */
+export declare function confirmInstallPlan(): Promise<{
+    cancelled: boolean;
+    proceed: boolean;
+}>;
+/**
+ * Build installation summary from results.
+ */
+export declare function buildInstallSummary(results: {
+    harness: HarnessName;
+    harnessDisplayName: string;
+    kit: string;
+    kitVersion: string;
+    result: AdapterInstallResult;
+}[], skipped: SkippedInstallEntry[]): InstallSummary;
+/**
+ * Display installation summary.
+ */
+export declare function displayInstallSummary(summary: InstallSummary, options?: {
+    verbose?: boolean;
+}): void;
+/**
+ * Display dry run summary.
+ */
+export declare function displayDryRunSummary(kits: {
+    name: string;
+    version: string;
+}[], harnesses: {
+    name: HarnessName;
+    displayName: string;
+}[], options?: {
+    scope?: InstallationScope;
+    projectRoot?: string;
+}): void;
+/**
+ * Display installation failure summary.
+ */
+export declare function displayInstallFailure(error: string, context?: {
+    harness?: string;
+    kit?: string;
+    operation?: string;
+}): void;
+/**
+ * Display total counts summary.
+ */
+export declare function displayTotalsSummary(summary: InstallSummary): void;
+/**
+ * Convert summary to JSON output format.
+ */
+export declare function summaryToJson(summary: InstallSummary, source: string): Record<string, unknown>;
+//# sourceMappingURL=summary.d.ts.map

package/dist/tui/summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.d.ts","sourceRoot":"","sources":["../../src/tui/summary.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAiB,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAA0B,aAAa,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC1G,OAAO,KAAK,EACV,cAAc,EAEd,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAUpB;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EACzC,SAAS,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,EACpC,KAAK,EAAE,iBAAiB,GACvB,IAAI,CAmBN;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAY5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE;IACP,OAAO,EAAE,WAAW,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;CAC9B,EAAE,EACH,OAAO,EAAE,mBAAmB,EAAE,GAC7B,cAAc,CA4EhB;AAuED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B,IAAI,CA2DN;AAaD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,EACzC,SAAS,EAAE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,EAAE,EACvD,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5D,IAAI,CAuBN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;IACR,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,IAAI,CAkBN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,cAAc,GACtB,IAAI,CAuBN;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,MAAM,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6CzB"}