akm-cli 0.6.0 → 0.7.0-rc1

package/dist/tests/setup-run.integration.js

@@ -0,0 +1,877 @@
+import { afterEach, beforeEach, describe, expect, mock, test } from "bun:test";
+import path from "node:path";
+const DEFAULT_STASH_DIR = "/tmp/akm-default-stash";
+const DEFAULT_CONFIG_PATH = "/tmp/akm-config/config.json";
+const DEFAULT_CACHE_DIR = "/tmp/akm-cache";
+const DEFAULT_REGISTRY_URLS = [
+    "https://raw.githubusercontent.com/itlackey/akm-registry/main/index.json",
+    "https://skills.sh",
+];
+const promptState = {
+    confirms: [],
+    selects: [],
+    multiselects: [],
+    texts: [],
+    logs: [],
+    notes: [],
+    outros: [],
+};
+const setupState = {
+    currentConfig: {
+        semanticSearchMode: "auto",
+        output: { format: "json", detail: "brief" },
+    },
+    savedConfigs: [],
+    initCalls: [],
+    indexCalls: [],
+    detectOllamaResult: { available: false, endpoint: "http://localhost:11434", models: [] },
+    detectAgentPlatformsResult: [],
+    checkEmbeddingResult: { available: true },
+    transformersAvailable: true,
+    indexResult: {
+        totalEntries: 3,
+        verification: { ok: true, message: "semantic search verified" },
+    },
+    indexError: undefined,
+    vecAvailable: false,
+};
+function resetPromptState() {
+    promptState.confirms.length = 0;
+    promptState.selects.length = 0;
+    promptState.multiselects.length = 0;
+    promptState.texts.length = 0;
+    promptState.logs.length = 0;
+    promptState.notes.length = 0;
+    promptState.outros.length = 0;
+}
+function resetSetupState() {
+    setupState.currentConfig = {
+        semanticSearchMode: "auto",
+        output: { format: "json", detail: "brief" },
+    };
+    setupState.savedConfigs.length = 0;
+    setupState.initCalls.length = 0;
+    setupState.indexCalls.length = 0;
+    setupState.detectOllamaResult = { available: false, endpoint: "http://localhost:11434", models: [] };
+    setupState.detectAgentPlatformsResult = [];
+    setupState.checkEmbeddingResult = { available: true };
+    setupState.transformersAvailable = true;
+    setupState.indexResult = {
+        totalEntries: 3,
+        verification: { ok: true, message: "semantic search verified" },
+    };
+    setupState.indexError = undefined;
+    setupState.vecAvailable = false;
+}
+beforeEach(() => {
+    resetPromptState();
+    resetSetupState();
+    mock.restore();
+});
+afterEach(() => {
+    mock.restore();
+});
+describe("runSetupWizard", () => {
+    test("saves config, initializes stash, and indexes on the default happy path", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: (message) => {
+                promptState.logs.push(`[cancel] ${message}`);
+            },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({
+                start: (message) => {
+                    promptState.logs.push(`[spinner:start] ${message}`);
+                },
+                stop: (message) => {
+                    promptState.logs.push(`[spinner:stop] ${message}`);
+                },
+            }),
+            log: {
+                step: (message) => {
+                    promptState.logs.push(`[step] ${message}`);
+                },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: (message) => {
+                    promptState.logs.push(`[success] ${message}`);
+                },
+            },
+            intro: (message) => {
+                promptState.logs.push(`[intro] ${message}`);
+            },
+            outro: (message) => {
+                promptState.outros.push(message);
+            },
+            note: (message, title) => {
+                promptState.notes.push(`${title ?? ""}\n${message}`.trim());
+            },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => setupState.detectOllamaResult,
+            detectAgentPlatforms: () => setupState.detectAgentPlatformsResult,
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => setupState.transformersAvailable,
+            checkEmbeddingAvailability: async () => setupState.checkEmbeddingResult,
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                if (setupState.indexError) {
+                    throw setupState.indexError;
+                }
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => setupState.vecAvailable,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(false, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.savedConfigs[0]?.stashDir).toBe(DEFAULT_STASH_DIR);
+        expect(setupState.savedConfigs[0]?.semanticSearchMode).toBe("off");
+        expect(setupState.initCalls).toEqual([{ dir: DEFAULT_STASH_DIR }]);
+        expect(setupState.indexCalls).toEqual([{ stashDir: DEFAULT_STASH_DIR }]);
+        expect(promptState.outros[0]).toContain(DEFAULT_CONFIG_PATH);
+    });
+    test("keeps semantic search in auto mode when asset preparation fails", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: (message) => {
+                promptState.logs.push(`[cancel] ${message}`);
+            },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({
+                start: (message) => {
+                    promptState.logs.push(`[spinner:start] ${message}`);
+                },
+                stop: (message) => {
+                    promptState.logs.push(`[spinner:stop] ${message}`);
+                },
+            }),
+            log: {
+                step: (message) => {
+                    promptState.logs.push(`[step] ${message}`);
+                },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: (message) => {
+                    promptState.logs.push(`[success] ${message}`);
+                },
+            },
+            intro: (message) => {
+                promptState.logs.push(`[intro] ${message}`);
+            },
+            outro: (message) => {
+                promptState.outros.push(message);
+            },
+            note: (message, title) => {
+                promptState.notes.push(`${title ?? ""}\n${message}`.trim());
+            },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => setupState.detectOllamaResult,
+            detectAgentPlatforms: () => setupState.detectAgentPlatformsResult,
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => setupState.transformersAvailable,
+            checkEmbeddingAvailability: async () => setupState.checkEmbeddingResult,
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                if (setupState.indexError) {
+                    throw setupState.indexError;
+                }
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => setupState.vecAvailable,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(true, true, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        setupState.checkEmbeddingResult = {
+            available: false,
+            reason: "model-download-failed",
+            message: "download blocked",
+        };
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.savedConfigs[0]?.semanticSearchMode).toBe("auto");
+        expect(promptState.logs.some((entry) => entry.includes("remains set to auto, but is currently blocked"))).toBe(true);
+        expect(setupState.indexCalls).toEqual([{ stashDir: DEFAULT_STASH_DIR }]);
+    });
+    test("warns and completes when indexing fails after saving config", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: (message) => {
+                promptState.logs.push(`[cancel] ${message}`);
+            },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({
+                start: (message) => {
+                    promptState.logs.push(`[spinner:start] ${message}`);
+                },
+                stop: (message) => {
+                    promptState.logs.push(`[spinner:stop] ${message}`);
+                },
+            }),
+            log: {
+                step: (message) => {
+                    promptState.logs.push(`[step] ${message}`);
+                },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: (message) => {
+                    promptState.logs.push(`[success] ${message}`);
+                },
+            },
+            intro: (message) => {
+                promptState.logs.push(`[intro] ${message}`);
+            },
+            outro: (message) => {
+                promptState.outros.push(message);
+            },
+            note: (message, title) => {
+                promptState.notes.push(`${title ?? ""}\n${message}`.trim());
+            },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => setupState.detectOllamaResult,
+            detectAgentPlatforms: () => setupState.detectAgentPlatformsResult,
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => setupState.transformersAvailable,
+            checkEmbeddingAvailability: async () => setupState.checkEmbeddingResult,
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                if (setupState.indexError) {
+                    throw setupState.indexError;
+                }
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => setupState.vecAvailable,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(false, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        setupState.indexError = new Error("index exploded");
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.initCalls).toEqual([{ dir: DEFAULT_STASH_DIR }]);
+        expect(setupState.indexCalls).toEqual([{ stashDir: DEFAULT_STASH_DIR }]);
+        expect(promptState.logs.some((entry) => entry.includes("index exploded"))).toBe(true);
+        expect(promptState.outros).toHaveLength(1);
+    });
+    test("warns specifically when remote embedding endpoint is unreachable", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: (message) => {
+                promptState.logs.push(`[cancel] ${message}`);
+            },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: {
+                step: (message) => {
+                    promptState.logs.push(`[step] ${message}`);
+                },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: (message) => {
+                    promptState.logs.push(`[success] ${message}`);
+                },
+            },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({
+                available: true,
+                endpoint: "http://localhost:11434",
+                models: ["nomic-embed-text", "llama3.2"],
+            }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => true,
+            checkEmbeddingAvailability: async () => ({
+                available: false,
+                reason: "remote-unreachable",
+                message: "connection refused",
+            }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "nomic-embed-text", "llama3.2", "done");
+        promptState.confirms.push(true, true, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        promptState.texts.push("384");
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(promptState.logs.some((entry) => entry.includes("remote embedding endpoint is not reachable"))).toBe(true);
+        expect(setupState.savedConfigs.at(-1)?.semanticSearchMode).toBe("auto");
+    });
+    test("warns specifically when transformers package is missing during setup prep", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: () => { },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: {
+                step: () => { },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: () => { },
+            },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({ available: false, endpoint: "http://localhost:11434", models: [] }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => false,
+            checkEmbeddingAvailability: async () => ({
+                available: false,
+                reason: "missing-package",
+                message: "@huggingface/transformers is not installed.",
+            }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(true, true, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(promptState.logs.some((entry) => entry.includes("Install it with: bun add @huggingface/transformers"))).toBe(true);
+        expect(setupState.savedConfigs.at(-1)?.semanticSearchMode).toBe("auto");
+    });
+    test("keeps semantic search enabled and warns when sqlite-vec/db check fails", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: () => { },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: {
+                step: () => { },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: (message) => {
+                    promptState.logs.push(`[warn] ${message}`);
+                },
+                success: () => { },
+            },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({ available: false, endpoint: "http://localhost:11434", models: [] }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => true,
+            checkEmbeddingAvailability: async () => ({ available: true }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => {
+                throw new Error("db locked");
+            },
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(true, true, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.savedConfigs[0]?.semanticSearchMode).toBe("auto");
+        expect(promptState.logs.some((entry) => entry.includes("Semantic search will use the JS fallback"))).toBe(true);
+    });
+    test("keeps semantic search enabled when asset preparation is skipped", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: () => { },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: {
+                step: () => { },
+                info: (message) => {
+                    promptState.logs.push(`[info] ${message}`);
+                },
+                warn: () => { },
+                success: () => { },
+            },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({ available: false, endpoint: "http://localhost:11434", models: [] }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => true,
+            checkEmbeddingAvailability: async () => ({ available: true }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async (options) => {
+                const dir = options?.dir ?? DEFAULT_STASH_DIR;
+                setupState.initCalls.push({ dir });
+                return { stashDir: dir, created: true, configPath: DEFAULT_CONFIG_PATH };
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async ({ stashDir }) => {
+                setupState.indexCalls.push({ stashDir });
+                return setupState.indexResult;
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(true, false, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await runSetupWizard();
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.savedConfigs[0]?.semanticSearchMode).toBe("auto");
+        expect(promptState.logs.some((entry) => entry.includes("asset preparation was skipped"))).toBe(true);
+    });
+    test("stops before init when config save fails", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: () => { },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: { step: () => { }, info: () => { }, warn: () => { }, success: () => { } },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        let saveCalls = 0;
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: () => {
+                saveCalls += 1;
+                throw new Error("EACCES config.json");
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({ available: false, endpoint: "http://localhost:11434", models: [] }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => true,
+            checkEmbeddingAvailability: async () => ({ available: true }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async () => {
+                throw new Error("init should not run");
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async () => {
+                throw new Error("index should not run");
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(false, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await expect(runSetupWizard()).rejects.toThrow("EACCES config.json");
+        expect(saveCalls).toBe(1);
+        expect(setupState.initCalls).toHaveLength(0);
+        expect(setupState.indexCalls).toHaveLength(0);
+    });
+    test("persists config before surfacing init failure", async () => {
+        mock.module("@clack/prompts", () => ({
+            isCancel: () => false,
+            cancel: () => { },
+            confirm: async () => promptState.confirms.shift() ?? false,
+            select: async () => promptState.selects.shift() ?? "done",
+            multiselect: async () => promptState.multiselects.shift() ?? [],
+            text: async () => promptState.texts.shift() ?? "",
+            spinner: () => ({ start: () => { }, stop: () => { } }),
+            log: { step: () => { }, info: () => { }, warn: () => { }, success: () => { } },
+            intro: () => { },
+            outro: () => { },
+            note: () => { },
+        }));
+        mock.module("../src/config", () => ({
+            DEFAULT_CONFIG: {
+                semanticSearchMode: "auto",
+                registries: [
+                    { url: DEFAULT_REGISTRY_URLS[0], name: "official" },
+                    { url: DEFAULT_REGISTRY_URLS[1], name: "skills.sh", provider: "skills-sh" },
+                ],
+                output: { format: "json", detail: "brief" },
+            },
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            loadConfig: () => setupState.currentConfig,
+            saveConfig: (config) => {
+                setupState.savedConfigs.push(config);
+            },
+        }));
+        mock.module("../src/paths", () => ({
+            getDefaultStashDir: () => DEFAULT_STASH_DIR,
+            getConfigPath: () => DEFAULT_CONFIG_PATH,
+            getConfigDir: () => path.dirname(DEFAULT_CONFIG_PATH),
+            getCacheDir: () => DEFAULT_CACHE_DIR,
+            getSemanticStatusPath: () => path.join(DEFAULT_CACHE_DIR, "semantic-status.json"),
+        }));
+        mock.module("../src/detect", () => ({
+            detectOllama: async () => ({ available: false, endpoint: "http://localhost:11434", models: [] }),
+            detectAgentPlatforms: () => [],
+        }));
+        mock.module("../src/embedder", () => ({
+            DEFAULT_LOCAL_MODEL: "Xenova/bge-small-en-v1.5",
+            isTransformersAvailable: () => true,
+            checkEmbeddingAvailability: async () => ({ available: true }),
+        }));
+        mock.module("../src/init", () => ({
+            akmInit: async () => {
+                throw new Error("EACCES stash init");
+            },
+        }));
+        mock.module("../src/indexer", () => ({
+            akmIndex: async () => {
+                throw new Error("index should not run");
+            },
+        }));
+        mock.module("../src/db", () => ({
+            openDatabase: () => ({}),
+            closeDatabase: () => { },
+            isVecAvailable: () => false,
+        }));
+        promptState.selects.push("default", "done");
+        promptState.confirms.push(false, true);
+        promptState.multiselects.push([...DEFAULT_REGISTRY_URLS], []);
+        const { runSetupWizard } = await import("../src/setup/setup");
+        await expect(runSetupWizard()).rejects.toThrow("EACCES stash init");
+        expect(setupState.savedConfigs).toHaveLength(1);
+        expect(setupState.savedConfigs[0]?.stashDir).toBe(DEFAULT_STASH_DIR);
+        expect(setupState.indexCalls).toHaveLength(0);
+    });
+});