@vibesdotdev/external 0.0.0-stage → 1.0.0-rc.0

package/dist/setup/steps/install-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.js","sourceRoot":"","sources":["../../../src/setup/steps/install-helpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,4BAA4B,EAAE,MAAM,qCAAqC,CAAC;AAEnF,OAAO,EAAE,iCAAiC,EAAE,MAAM,gCAAgC,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AACrE,OAAO,EACN,kBAAkB,EAClB,sBAAsB,EAEtB,MAAM,6CAA6C,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC7C,OAAqB;IAErB,MAAM,WAAW,GAAG,OAAO;SACzB,KAAK,CAAC,eAAe,CAAC;SACtB,OAAO,EAAE;SACT,WAAW,EAAE;SACb,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,OAAqB,EACrB,EAAU;IAEV,OAAO,iCAAiC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACvC,OAAqB,EACrB,aAAqB;IAErB,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO;QACN,GAAG,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC;QAC5C,eAAe,EAAE,MAAM,sBAAsB,CAAC,OAAO,CAAC;QACtD,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,QAAQ;QACxC,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,SAAS;QAC1C,aAAa;QACb,cAAc;KACd,CAAC;AACH,CAAC"}

package/dist/setup/steps/install.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Install Step
+ *
+ * Installs vibes integration for selected external tools via runtime-discovered
+ * `external/host` assets. Tool-specific behavior can be provided by scoped
+ * implementations; otherwise the default external tool implementation uses the
+ * manifest-driven installers.
+ */
+import type { ExternalWizardStep } from '../types.ts';
+export declare const installStep: ExternalWizardStep;
+//# sourceMappingURL=install.d.ts.map

package/dist/setup/steps/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/install.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAA4C,MAAM,aAAa,CAAC;AAmDhG,eAAO,MAAM,WAAW,EAAE,kBAsIzB,CAAC"}

package/dist/setup/steps/install.js

@@ -0,0 +1,143 @@
+/**
+ * Install Step
+ *
+ * Installs vibes integration for selected external tools via runtime-discovered
+ * `external/host` assets. Tool-specific behavior can be provided by scoped
+ * implementations; otherwise the default external tool implementation uses the
+ * manifest-driven installers.
+ */
+import { spinner, note, confirm, isCancel } from '@clack/prompts';
+import { getTierPatterns } from "../../schemas/tiers.js";
+import { formatBinaryCommand } from "../../config/binary-detection.js";
+import { attempt } from "../../ambient/attempt.js";
+import { getEnvironmentInfo, getExternalHostManifests, resolveExternalHost } from "./install-helpers.js";
+async function installTargetMcp(runtime, target, tier, global, workspaceRoot, vibesPath) {
+    const externalTool = await resolveExternalHost(runtime, target);
+    const mcpResult = await externalTool.fixMcp({
+        global,
+        projectDir: workspaceRoot,
+        dryRun: false,
+        tier,
+        vibesPath
+    });
+    if (mcpResult.success) {
+        return {
+            target,
+            tier,
+            success: true,
+            mcpConfigured: true,
+            hooksInstalled: [],
+            filesCreated: mcpResult.created ? [mcpResult.configPath] : [],
+            filesModified: mcpResult.updated ? [mcpResult.configPath] : []
+        };
+    }
+    return {
+        target,
+        tier,
+        success: false,
+        mcpConfigured: false,
+        hooksInstalled: [],
+        filesCreated: [],
+        filesModified: [],
+        error: mcpResult.error ?? 'Unknown error'
+    };
+}
+export const installStep = {
+    id: 'install',
+    title: 'Install Configuration',
+    description: 'Installing vibes integration for selected tools',
+    async initialize(ctx) {
+        const manifests = await getExternalHostManifests(ctx.context.runtime);
+        const { selectedTargets, tierSelections, installLocation } = ctx.state.external;
+        const preview = selectedTargets.map((target) => {
+            const manifest = manifests.get(target);
+            const tier = tierSelections[target] ?? 'default';
+            const patterns = getTierPatterns(tier);
+            const toolName = manifest?.name ?? target;
+            const mcpSupported = manifest?.mcp.supported ?? false;
+            const hooksSupported = manifest?.hooks.supported ?? false;
+            const capabilities = [];
+            if (mcpSupported)
+                capabilities.push('MCP');
+            if (hooksSupported)
+                capabilities.push('Hooks');
+            return `  ${toolName}:\n    Tier: ${tier}\n    Capabilities: ${capabilities.join(', ') || 'none'}\n    Tools: ${patterns.enabled.slice(0, 5).join(', ')}${patterns.enabled.length > 5 ? '...' : ''}`;
+        });
+        note(`Location: ${installLocation}\n\n${preview.join('\n\n')}`, 'Installation Preview');
+    },
+    async renderCLI(ctx) {
+        const { selectedTargets, tierSelections, installLocation } = ctx.state.external;
+        const manifests = await getExternalHostManifests(ctx.context.runtime);
+        const proceed = await confirm({ message: 'Proceed with installation?', initialValue: true });
+        if (isCancel(proceed) || !proceed) {
+            ctx.updateState({
+                metadata: { ...ctx.state.metadata, skipped: true }
+            });
+            return;
+        }
+        const env = await getEnvironmentInfo(ctx.context.runtime, ctx.context.workspaceRoot);
+        if (env.detectedBinary) {
+            note(`${env.detectedBinary.description}\nCommand: ${formatBinaryCommand(env.detectedBinary)}`, 'Detected Vibes CLI');
+        }
+        const s = spinner();
+        s.start('Installing vibes integration...');
+        const results = [];
+        for (const target of selectedTargets) {
+            const manifest = manifests.get(target);
+            const tier = tierSelections[target] ?? 'default';
+            const toolName = manifest?.name ?? target;
+            if (!manifest?.mcp.supported) {
+                results.push({
+                    target,
+                    tier,
+                    success: false,
+                    mcpConfigured: false,
+                    hooksInstalled: [],
+                    filesCreated: [],
+                    filesModified: [],
+                    error: `${toolName} does not support MCP integration`
+                });
+                continue;
+            }
+            s.message(`Installing ${toolName} (${tier})...`);
+            const outcome = await attempt(ctx.context.runtime, () => installTargetMcp(ctx.context.runtime, target, tier, installLocation === 'global', ctx.context.workspaceRoot, ctx.context.vibesPath), `install of '${toolName}'`);
+            if (outcome.ok) {
+                results.push(outcome.value);
+            }
+            else {
+                const failure = outcome.cause;
+                results.push({
+                    target,
+                    tier,
+                    success: false,
+                    mcpConfigured: false,
+                    hooksInstalled: [],
+                    filesCreated: [],
+                    filesModified: [],
+                    error: failure instanceof Error ? failure.message : String(failure)
+                });
+            }
+        }
+        s.stop('Installation complete');
+        const allSuccess = results.every((r) => r.success);
+        ctx.updateState({
+            external: { ...ctx.state.external, results, success: allSuccess }
+        });
+        const successCount = results.filter((r) => r.success).length;
+        const failCount = results.filter((r) => !r.success).length;
+        const lines = results.map((r) => {
+            const toolName = manifests.get(r.target)?.name ?? r.target;
+            const status = r.success ? '✓' : '✗';
+            const msg = r.success ? `configured with ${r.tier} tier` : `failed: ${r.error}`;
+            return `${status} ${toolName}: ${msg}`;
+        });
+        note(`${lines.join('\n')}\n\n${successCount} succeeded, ${failCount} failed`, 'Installation Results');
+        if (allSuccess) {
+            note('Run your AI coding tool to use the vibes integration.\nAvailable MCP tools based on your tier selection are now configured.', 'Next Steps');
+        }
+    },
+    async validate(ctx) {
+        return ctx.state.external.results.length > 0;
+    }
+};
+//# sourceMappingURL=install.js.map

package/dist/setup/steps/install.js.map

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

package/dist/setup/steps/select-location.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Select Location Step
+ *
+ * Choose whether to install globally or per-project.
+ */
+import type { ExternalWizardStep } from '../types.ts';
+export declare const selectLocationStep: ExternalWizardStep;
+//# sourceMappingURL=select-location.d.ts.map

package/dist/setup/steps/select-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-location.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/select-location.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AAI3E,eAAO,MAAM,kBAAkB,EAAE,kBAoDhC,CAAC"}

package/dist/setup/steps/select-location.js

@@ -0,0 +1,55 @@
+/**
+ * Select Location Step
+ *
+ * Choose whether to install globally or per-project.
+ */
+import { select, note, isCancel } from '@clack/prompts';
+import { z } from 'zod';
+const InstallLocationSchema = z.enum(['project', 'global']);
+export const selectLocationStep = {
+    id: 'select-location',
+    title: 'Installation Location',
+    description: 'Choose where to install the configuration',
+    async renderCLI(ctx) {
+        const answer = await select({
+            message: 'Where should the configuration be installed?',
+            options: [
+                {
+                    value: 'project',
+                    label: 'Project (recommended)',
+                    hint: 'Install in current project directory - tracked in git'
+                },
+                {
+                    value: 'global',
+                    label: 'Global',
+                    hint: 'Install in home directory - applies to all projects'
+                }
+            ],
+            initialValue: 'project'
+        });
+        if (isCancel(answer)) {
+            ctx.updateState({
+                metadata: {
+                    ...ctx.state.metadata,
+                    skipped: true
+                }
+            });
+            return;
+        }
+        const selected = InstallLocationSchema.parse(answer);
+        ctx.updateState({
+            external: {
+                ...ctx.state.external,
+                installLocation: selected
+            }
+        });
+        const locationDesc = selected === 'global'
+            ? 'Configuration will be installed globally (~/.config or ~)'
+            : `Configuration will be installed in: ${ctx.context.workspaceRoot}`;
+        note(locationDesc, 'Install Location');
+    },
+    async validate(ctx) {
+        return ctx.state.external.installLocation !== undefined;
+    }
+};
+//# sourceMappingURL=select-location.js.map

package/dist/setup/steps/select-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-location.js","sourceRoot":"","sources":["../../../src/setup/steps/select-location.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACrD,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EAAE,2CAA2C;IAExD,KAAK,CAAC,SAAS,CAAC,GAAwB;QACvC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC;YAC3B,OAAO,EAAE,8CAA8C;YACvD,OAAO,EAAE;gBACR;oBACC,KAAK,EAAE,SAAS;oBAChB,KAAK,EAAE,uBAAuB;oBAC9B,IAAI,EAAE,uDAAuD;iBAC7D;gBACD;oBACC,KAAK,EAAE,QAAQ;oBACf,KAAK,EAAE,QAAQ;oBACf,IAAI,EAAE,qDAAqD;iBAC3D;aACD;YACD,YAAY,EAAE,SAAS;SACvB,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACtB,GAAG,CAAC,WAAW,CAAC;gBACf,QAAQ,EAAE;oBACT,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ;oBACrB,OAAO,EAAE,IAAI;iBACb;aACD,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrD,GAAG,CAAC,WAAW,CAAC;YACf,QAAQ,EAAE;gBACT,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ;gBACrB,eAAe,EAAE,QAAQ;aACzB;SACD,CAAC,CAAC;QAEH,MAAM,YAAY,GACjB,QAAQ,KAAK,QAAQ;YACpB,CAAC,CAAC,2DAA2D;YAC7D,CAAC,CAAC,uCAAuC,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QAEvE,IAAI,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAwB;QACtC,OAAO,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,KAAK,SAAS,CAAC;IACzD,CAAC;CACD,CAAC"}

package/dist/setup/steps/select-targets.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Select Targets Step
+ *
+ * Multi-select which detected tools to configure.
+ */
+import type { ExternalWizardStep } from '../types.ts';
+export declare const selectTargetsStep: ExternalWizardStep;
+//# sourceMappingURL=select-targets.d.ts.map

package/dist/setup/steps/select-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-targets.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/select-targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AAE3E,eAAO,MAAM,iBAAiB,EAAE,kBAqD/B,CAAC"}

package/dist/setup/steps/select-targets.js

@@ -0,0 +1,53 @@
+/**
+ * Select Targets Step
+ *
+ * Multi-select which detected tools to configure.
+ */
+import { multiselect, note, isCancel } from '@clack/prompts';
+export const selectTargetsStep = {
+    id: 'select-targets',
+    title: 'Select Tools',
+    description: 'Choose which tools to configure with vibes integration',
+    async renderCLI(ctx) {
+        const { detectedTools } = ctx.state.external;
+        const installed = detectedTools.filter((t) => t.installed);
+        if (installed.length === 0) {
+            note('No installed tools to configure', 'Selection');
+            return;
+        }
+        const options = installed.map((tool) => ({
+            value: tool.id,
+            label: tool.name,
+            hint: tool.integrated ? 'already integrated' : 'not configured'
+        }));
+        // Pre-select tools that aren't already integrated
+        const initialValues = installed.filter((t) => !t.integrated).map((t) => t.id);
+        const selected = await multiselect({
+            message: 'Which tools do you want to configure?',
+            options,
+            initialValues,
+            required: true
+        });
+        if (isCancel(selected)) {
+            // User cancelled
+            ctx.updateState({
+                metadata: {
+                    ...ctx.state.metadata,
+                    skipped: true
+                }
+            });
+            return;
+        }
+        ctx.updateState({
+            external: {
+                ...ctx.state.external,
+                selectedTargets: selected
+            }
+        });
+    },
+    async validate(ctx) {
+        const { selectedTargets } = ctx.state.external;
+        return selectedTargets.length > 0;
+    }
+};
+//# sourceMappingURL=select-targets.js.map

package/dist/setup/steps/select-targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-targets.js","sourceRoot":"","sources":["../../../src/setup/steps/select-targets.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG7D,MAAM,CAAC,MAAM,iBAAiB,GAAuB;IACpD,EAAE,EAAE,gBAAgB;IACpB,KAAK,EAAE,cAAc;IACrB,WAAW,EAAE,wDAAwD;IAErE,KAAK,CAAC,SAAS,CAAC,GAAwB;QACvC,MAAM,EAAE,aAAa,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC7C,MAAM,SAAS,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,IAAI,CAAC,iCAAiC,EAAE,WAAW,CAAC,CAAC;YACrD,OAAO;QACR,CAAC;QAED,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACxC,KAAK,EAAE,IAAI,CAAC,EAAE;YACd,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,gBAAgB;SAC/D,CAAC,CAAC,CAAC;QAEJ,kDAAkD;QAClD,MAAM,aAAa,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAAG,MAAM,WAAW,CAAC;YAClC,OAAO,EAAE,uCAAuC;YAChD,OAAO;YACP,aAAa;YACb,QAAQ,EAAE,IAAI;SACd,CAAC,CAAC;QAEH,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,iBAAiB;YACjB,GAAG,CAAC,WAAW,CAAC;gBACf,QAAQ,EAAE;oBACT,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ;oBACrB,OAAO,EAAE,IAAI;iBACb;aACD,CAAC,CAAC;YACH,OAAO;QACR,CAAC;QAED,GAAG,CAAC,WAAW,CAAC;YACf,QAAQ,EAAE;gBACT,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ;gBACrB,eAAe,EAAE,QAAQ;aACzB;SACD,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAwB;QACtC,MAAM,EAAE,eAAe,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC/C,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;IACnC,CAAC;CACD,CAAC"}

package/dist/setup/steps/select-tiers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Select Tiers Step
+ *
+ * Choose feature tier for each selected target.
+ */
+import type { ExternalWizardStep } from '../types.ts';
+export declare const selectTiersStep: ExternalWizardStep;
+//# sourceMappingURL=select-tiers.d.ts.map

package/dist/setup/steps/select-tiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-tiers.d.ts","sourceRoot":"","sources":["../../../src/setup/steps/select-tiers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAuB,MAAM,aAAa,CAAC;AAG3E,eAAO,MAAM,eAAe,EAAE,kBAoI7B,CAAC"}

package/dist/setup/steps/select-tiers.js

@@ -0,0 +1,124 @@
+/**
+ * Select Tiers Step
+ *
+ * Choose feature tier for each selected target.
+ */
+import { isCancel, select, note } from '@clack/prompts';
+import { getAllTiers, ToolTierSchema } from "../../schemas/tiers.js";
+export const selectTiersStep = {
+    id: 'select-tiers',
+    title: 'Select Feature Tiers',
+    description: 'Choose what level of vibes integration for each tool',
+    async renderCLI(ctx) {
+        const { selectedTargets, detectedTools } = ctx.state.external;
+        if (selectedTargets.length === 0) {
+            note('No tools selected', 'Tiers');
+            return;
+        }
+        const tiers = getAllTiers();
+        const tierOptions = tiers.map((tier) => ({
+            value: tier.id,
+            label: `${tier.name} - ${tier.shortDescription}`,
+            hint: tier.description
+        }));
+        const tierSelections = {};
+        // If only one target, just ask once
+        if (selectedTargets.length === 1) {
+            const target = selectedTargets[0];
+            const tool = detectedTools.find((t) => t.id === target);
+            const selected = await select({
+                message: `Select feature tier for ${tool?.name ?? target}:`,
+                options: tierOptions,
+                initialValue: ToolTierSchema.enum.default
+            });
+            if (isCancel(selected)) {
+                ctx.updateState({
+                    metadata: {
+                        ...ctx.state.metadata,
+                        skipped: true
+                    }
+                });
+                return;
+            }
+            tierSelections[target] = selected;
+        }
+        else {
+            // Multiple targets - ask if they want same tier for all or individual
+            const applyToAll = await select({
+                message: 'Apply the same tier to all tools?',
+                options: [
+                    { value: 'same', label: 'Yes, use the same tier for all' },
+                    { value: 'individual', label: 'No, choose individually' }
+                ]
+            });
+            if (isCancel(applyToAll)) {
+                ctx.updateState({
+                    metadata: {
+                        ...ctx.state.metadata,
+                        skipped: true
+                    }
+                });
+                return;
+            }
+            if (applyToAll === 'same') {
+                const selected = await select({
+                    message: 'Select feature tier for all tools:',
+                    options: tierOptions,
+                    initialValue: ToolTierSchema.enum.default
+                });
+                if (isCancel(selected)) {
+                    ctx.updateState({
+                        metadata: {
+                            ...ctx.state.metadata,
+                            skipped: true
+                        }
+                    });
+                    return;
+                }
+                for (const target of selectedTargets) {
+                    tierSelections[target] = selected;
+                }
+            }
+            else {
+                // Individual selection for each
+                for (const target of selectedTargets) {
+                    const tool = detectedTools.find((t) => t.id === target);
+                    const selected = await select({
+                        message: `Select feature tier for ${tool?.name ?? target}:`,
+                        options: tierOptions,
+                        initialValue: ToolTierSchema.enum.default
+                    });
+                    if (isCancel(selected)) {
+                        ctx.updateState({
+                            metadata: {
+                                ...ctx.state.metadata,
+                                skipped: true
+                            }
+                        });
+                        return;
+                    }
+                    tierSelections[target] = selected;
+                }
+            }
+        }
+        ctx.updateState({
+            external: {
+                ...ctx.state.external,
+                tierSelections
+            }
+        });
+        // Show summary
+        const lines = selectedTargets.map((target) => {
+            const tool = detectedTools.find((t) => t.id === target);
+            const tier = tiers.find((t) => t.id === tierSelections[target]);
+            return `  ${tool?.name ?? target}: ${tier?.name ?? tierSelections[target]}`;
+        });
+        note(lines.join('\n'), 'Selected Tiers');
+    },
+    async validate(ctx) {
+        const { selectedTargets, tierSelections } = ctx.state.external;
+        // Every selected target should have a tier
+        return selectedTargets.every((t) => tierSelections[t] !== undefined);
+    }
+};
+//# sourceMappingURL=select-tiers.js.map

package/dist/setup/steps/select-tiers.js.map

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

package/dist/setup/types.d.ts

@@ -0,0 +1,128 @@
+/**
+ * External Setup Wizard Types
+ *
+ * Type definitions for the unified external tool setup wizard.
+ */
+import type { AgentId } from '../detection/types.ts';
+import type { ToolTier } from '../schemas/tiers.ts';
+import type { ValueFreeFailure, VibesRuntime } from '@vibesdotdev/kernel';
+/**
+ * Simplified wizard metadata for external setup
+ */
+export interface ExternalWizardMetadata {
+    currentStepId: string | null;
+    completedStepIds: Set<string>;
+    history: string[];
+    skipped: boolean;
+    completed: boolean;
+}
+/**
+ * External wizard step context
+ */
+export interface ExternalStepContext {
+    state: ExternalSetupState;
+    context: {
+        workspaceRoot: string;
+        vibesPath?: string;
+        runtime: VibesRuntime;
+    };
+    updateState: (partial: Partial<ExternalSetupState>) => void;
+}
+/**
+ * External wizard step definition
+ */
+export interface ExternalWizardStep {
+    id: string;
+    title: string;
+    description?: string;
+    initialize?: (ctx: ExternalStepContext) => Promise<void>;
+    renderCLI?: (ctx: ExternalStepContext) => Promise<void>;
+    validate?: (ctx: ExternalStepContext) => Promise<boolean>;
+}
+/**
+ * Detected tool information for wizard display
+ */
+export interface DetectedTool {
+    id: AgentId;
+    name: string;
+    installed: boolean;
+    version?: string;
+    integrated: boolean;
+    configPath?: string;
+}
+/**
+ * Target selection with tier
+ */
+export interface TargetTierSelection {
+    target: AgentId;
+    tier: ToolTier;
+}
+/**
+ * Installation result for a single target
+ */
+export interface TargetInstallResult {
+    target: AgentId;
+    tier: ToolTier;
+    success: boolean;
+    mcpConfigured: boolean;
+    hooksInstalled: string[];
+    filesCreated: string[];
+    filesModified: string[];
+    error?: string;
+}
+/**
+ * External setup wizard state
+ */
+export interface ExternalSetupState {
+    metadata: ExternalWizardMetadata;
+    external: {
+        /** All detected tools from detection scan */
+        detectedTools: DetectedTool[];
+        /** Tools selected for configuration */
+        selectedTargets: AgentId[];
+        /** Tier selection for each target */
+        tierSelections: Partial<Record<AgentId, ToolTier>>;
+        /** Install location preference */
+        installLocation: 'global' | 'project';
+        /** Installation results */
+        results: TargetInstallResult[];
+        /** Overall success flag */
+        success: boolean;
+    };
+}
+/**
+ * Create initial external setup state
+ */
+export declare function createExternalSetupState(): ExternalSetupState;
+/**
+ * Wizard options passed from CLI
+ */
+export interface ExternalSetupWizardOptions {
+    /** Target to configure (if single-target mode) */
+    target?: AgentId;
+    /** Tier to apply (skips tier selection if provided) */
+    tier?: ToolTier;
+    /** Install globally */
+    global?: boolean;
+    /** Preview changes only */
+    dryRun?: boolean;
+    /** Path to vibes CLI */
+    vibesPath?: string;
+    /** Project directory */
+    projectDir?: string;
+    /** Skip interactive prompts (use defaults) */
+    nonInteractive?: boolean;
+    /** Runtime used to resolve external/host descriptors */
+    runtime: VibesRuntime;
+}
+/**
+ * Wizard result
+ */
+export interface ExternalSetupWizardResult {
+    success: boolean;
+    skipped: boolean;
+    results: TargetInstallResult[];
+    error?: string;
+    failure?: ValueFreeFailure;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/setup/types.d.ts.map

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

package/dist/setup/types.js

@@ -0,0 +1,28 @@
+/**
+ * External Setup Wizard Types
+ *
+ * Type definitions for the unified external tool setup wizard.
+ */
+/**
+ * Create initial external setup state
+ */
+export function createExternalSetupState() {
+    return {
+        metadata: {
+            currentStepId: null,
+            completedStepIds: new Set(),
+            history: [],
+            skipped: false,
+            completed: false
+        },
+        external: {
+            detectedTools: [],
+            selectedTargets: [],
+            tierSelections: {},
+            installLocation: 'project',
+            results: [],
+            success: false
+        }
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/setup/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/setup/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiGH;;GAEG;AACH,MAAM,UAAU,wBAAwB;IACvC,OAAO;QACN,QAAQ,EAAE;YACT,aAAa,EAAE,IAAI;YACnB,gBAAgB,EAAE,IAAI,GAAG,EAAE;YAC3B,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,KAAK;SAChB;QACD,QAAQ,EAAE;YACT,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE;YACnB,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,SAAS;YAC1B,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,KAAK;SACd;KACD,CAAC;AACH,CAAC"}