@kaelio/ktx 0.5.0 → 0.6.0

package/dist/setup-demo-tour.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/setup-demo-tour.test.js

@@ -1,221 +0,0 @@
-import { describe, expect, it, vi } from 'vitest';
-import { buildDemoReplayTimeline, DEMO_REPLAY_TARGETS, renderDemoAgentTransition, renderDemoBanner, renderDemoCardContent, renderDemoCompletionSummary, runDemoTour, } from './setup-demo-tour.js';
-/** Strip ANSI escape sequences for plain-text assertions. */
-function stripAnsi(text) {
-    return text.replace(/\x1b\[[0-9;]*m/g, '');
-}
-describe('renderDemoBanner', () => {
-    it('contains "Demo mode"', () => {
-        const plain = stripAnsi(renderDemoBanner());
-        expect(plain).toContain('Demo mode');
-    });
-    it('mentions pre-processed data', () => {
-        const plain = stripAnsi(renderDemoBanner());
-        expect(plain).toContain('pre-processed');
-    });
-    it('mentions read-only', () => {
-        const plain = stripAnsi(renderDemoBanner());
-        expect(plain).toContain('read-only');
-    });
-});
-describe('renderDemoCardContent', () => {
-    it('contains the title', () => {
-        const plain = stripAnsi(renderDemoCardContent('Database connection', ['Postgres']));
-        expect(plain).toContain('Database connection');
-    });
-    it('contains each selection', () => {
-        const plain = stripAnsi(renderDemoCardContent('Sources', ['dbt', 'metabase']));
-        expect(plain).toContain('dbt');
-        expect(plain).toContain('metabase');
-    });
-    it('contains navigation hints', () => {
-        const plain = stripAnsi(renderDemoCardContent('Title', ['a']));
-        expect(plain).toContain('Press Enter to continue');
-        expect(plain).toContain('Escape to go back');
-    });
-    it('works with multiple selections', () => {
-        const result = renderDemoCardContent('Pick', ['one', 'two', 'three']);
-        const plain = stripAnsi(result);
-        expect(plain).toContain('one');
-        expect(plain).toContain('two');
-        expect(plain).toContain('three');
-        // Each selection gets a ▸ bullet
-        const bullets = (plain.match(/▸/g) ?? []).length;
-        expect(bullets).toBe(3);
-    });
-});
-describe('renderDemoAgentTransition', () => {
-    it('contains "Demo project is ready"', () => {
-        const plain = stripAnsi(renderDemoAgentTransition());
-        expect(plain).toContain('Demo project is ready');
-    });
-    it('mentions connecting an agent', () => {
-        const plain = stripAnsi(renderDemoAgentTransition());
-        expect(plain).toContain('connect your agent');
-    });
-});
-describe('renderDemoCompletionSummary', () => {
-    const projectDir = '/tmp/ktx-demo-123';
-    it('includes the project path', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, true));
-        expect(plain).toContain(projectDir);
-    });
-    it('includes a temp directory warning', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, true));
-        expect(plain).toContain('temporary directory');
-    });
-    it('points to ktx setup for real data', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, true));
-        expect(plain).toContain('ktx setup');
-    });
-    it('shows agent-connected message when installed', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, true));
-        expect(plain).toContain('agent is connected');
-    });
-    it('includes star headline', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, true));
-        expect(plain).toContain('★ KTX demo is ready');
-    });
-    it('shows manual instructions when agent not installed', () => {
-        const plain = stripAnsi(renderDemoCompletionSummary(projectDir, false));
-        expect(plain).toContain('--agents');
-        expect(plain).toContain(`--project-dir ${projectDir}`);
-    });
-});
-describe('buildDemoReplayTimeline', () => {
-    const timeline = buildDemoReplayTimeline();
-    const connectionIds = new Set(timeline.map((e) => e.connectionId));
-    it('produces events for all 4 targets', () => {
-        expect(connectionIds.size).toBe(4);
-        expect(connectionIds).toContain('postgres-warehouse');
-        expect(connectionIds).toContain('dbt-main');
-        expect(connectionIds).toContain('metabase-main');
-        expect(connectionIds).toContain('notion-main');
-    });
-    it('all targets end as done', () => {
-        for (const id of connectionIds) {
-            const events = timeline.filter((e) => e.connectionId === id);
-            const last = events[events.length - 1];
-            expect(last.status).toBe('done');
-        }
-    });
-    it('events are sorted by delayMs', () => {
-        for (let i = 1; i < timeline.length; i++) {
-            expect(timeline[i].delayMs).toBeGreaterThanOrEqual(timeline[i - 1].delayMs);
-        }
-    });
-    it('uses schema-context wording for database progress', () => {
-        const renderedTimeline = timeline
-            .map((event) => [event.detailLine, event.summaryText].filter(Boolean).join(' '))
-            .join('\n');
-        expect(renderedTimeline).toContain('reading schema');
-        expect(renderedTimeline).toContain('56 tables');
-        expect(renderedTimeline).not.toContain('scanning');
-        expect(renderedTimeline).not.toContain('scanned');
-    });
-});
-describe('DEMO_REPLAY_TARGETS', () => {
-    it('has 1 primary source', () => {
-        expect(DEMO_REPLAY_TARGETS.primarySources).toHaveLength(1);
-    });
-    it('has 3 context sources', () => {
-        expect(DEMO_REPLAY_TARGETS.contextSources).toHaveLength(3);
-    });
-    it('primary source is a database-ingest operation', () => {
-        expect(DEMO_REPLAY_TARGETS.primarySources[0].operation).toBe('database-ingest');
-    });
-    it('context sources are source-ingest operations', () => {
-        for (const source of DEMO_REPLAY_TARGETS.contextSources) {
-            expect(source.operation).toBe('source-ingest');
-        }
-    });
-});
-describe('runDemoTour', () => {
-    function createMockIo() {
-        const chunks = [];
-        return {
-            io: {
-                stdout: { isTTY: true, columns: 80, write: (chunk) => { chunks.push(chunk); } },
-                stderr: { write: () => { } },
-            },
-            chunks,
-        };
-    }
-    it('returns 0 on successful tour with agent installed', async () => {
-        const { io, chunks } = createMockIo();
-        const mockAgents = vi.fn().mockResolvedValue({
-            status: 'ready',
-            projectDir: '/tmp/test',
-            installs: [{ target: 'claude-code', scope: 'project', mode: 'mcp-cli' }],
-        });
-        const navigation = vi.fn().mockResolvedValue('forward');
-        const result = await runDemoTour({ inputMode: 'auto' }, io, {
-            agents: mockAgents,
-            waitForNavigation: navigation,
-            skipReplayAnimation: true,
-            ensureProject: vi.fn().mockResolvedValue({ projectDir: '/tmp/test' }),
-        });
-        expect(result).toBe(0);
-        expect(mockAgents).toHaveBeenCalled();
-        // Should have rendered completion summary
-        const allOutput = chunks.join('');
-        expect(allOutput).toContain('agent is connected');
-    });
-    it('handles back navigation from first step by exiting', async () => {
-        const { io } = createMockIo();
-        const navigation = vi.fn().mockResolvedValue('back');
-        const result = await runDemoTour({ inputMode: 'auto' }, io, {
-            waitForNavigation: navigation,
-            skipReplayAnimation: true,
-            ensureProject: vi.fn().mockResolvedValue({ projectDir: '/tmp/test' }),
-        });
-        expect(result).toBe(0);
-        // Navigation called once for intro, then exits on back
-        expect(navigation).toHaveBeenCalledTimes(1);
-    });
-    it('goes back from sources to databases', async () => {
-        const { io } = createMockIo();
-        let callCount = 0;
-        const navigation = vi.fn().mockImplementation(() => {
-            callCount++;
-            // First call (intro): forward
-            // Second call (databases): forward
-            // Third call (sources): back
-            // Fourth call (databases again): back (exit)
-            if (callCount <= 2)
-                return Promise.resolve('forward');
-            return Promise.resolve('back');
-        });
-        const result = await runDemoTour({ inputMode: 'auto' }, io, {
-            waitForNavigation: navigation,
-            skipReplayAnimation: true,
-            ensureProject: vi.fn().mockResolvedValue({ projectDir: '/tmp/test' }),
-        });
-        expect(result).toBe(0);
-        expect(navigation).toHaveBeenCalledTimes(4);
-    });
-    it('handles agent step returning back', async () => {
-        const { io } = createMockIo();
-        let navCount = 0;
-        const navigation = vi.fn().mockImplementation(() => {
-            navCount++;
-            // Forward through intro, databases, sources, context
-            // Then back from context (after agents returns back)
-            // Then back from sources, then back from databases (exit)
-            if (navCount <= 4)
-                return Promise.resolve('forward');
-            return Promise.resolve('back');
-        });
-        const mockAgents = vi.fn().mockResolvedValue({
-            status: 'back',
-            projectDir: '/tmp/test',
-        });
-        const result = await runDemoTour({ inputMode: 'auto' }, io, {
-            agents: mockAgents,
-            waitForNavigation: navigation,
-            skipReplayAnimation: true,
-            ensureProject: vi.fn().mockResolvedValue({ projectDir: '/tmp/test' }),
-        });
-        expect(result).toBe(0);
-    });
-});

package/dist/setup-embeddings.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/setup-embeddings.test.js

@@ -1,436 +0,0 @@
-import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { initKtxProject } from './context/project/project.js';
-import { parseKtxProjectConfig } from './context/project/config.js';
-import { readKtxSetupState, writeKtxSetupState } from './context/project/setup-config.js';
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
-import { runKtxSetupEmbeddingsStep } from './setup-embeddings.js';
-const EMBEDDING_OPTION_PROMPT_MESSAGE = [
-    'Which embedding option should KTX use?',
-    '',
-    'KTX uses embeddings for semantic search over semantic-layer sources, wiki context, schema metadata, ' +
-        'and relationship evidence.',
-].join('\n');
-function makeIo() {
-    let stdout = '';
-    let stderr = '';
-    return {
-        io: {
-            stdout: {
-                isTTY: true,
-                write: (chunk) => {
-                    stdout += chunk;
-                },
-            },
-            stderr: {
-                write: (chunk) => {
-                    stderr += chunk;
-                },
-            },
-        },
-        stdout: () => stdout,
-        stderr: () => stderr,
-    };
-}
-function makePromptAdapter(options) {
-    const selectValues = [...(options.selectValues ?? [])];
-    return {
-        select: vi.fn(async () => selectValues.shift() ?? 'retry'),
-        password: vi.fn(async () => options.passwordValue ?? 'embedding-secret'),
-        cancel: vi.fn(),
-    };
-}
-function managedDaemon(baseUrl = 'http://127.0.0.1:61234', logs = {}) {
-    return {
-        baseUrl,
-        stdoutLog: logs.stdoutLog ?? '/tmp/ktx-daemon.stdout.log',
-        stderrLog: logs.stderrLog ?? '/tmp/ktx-daemon.stderr.log',
-    };
-}
-describe('setup embeddings step', () => {
-    let tempDir;
-    beforeEach(async () => {
-        tempDir = await mkdtemp(join(tmpdir(), 'ktx-setup-embeddings-'));
-        await initKtxProject({ projectDir: tempDir });
-    });
-    afterEach(async () => {
-        await rm(tempDir, { recursive: true, force: true });
-    });
-    it('explains why interactive users choose an embedding option before validating embeddings', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const prompts = makePromptAdapter({ selectValues: ['back'] });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { prompts, env: {}, healthCheck });
-        expect(result.status).toBe('back');
-        expect(healthCheck).not.toHaveBeenCalled();
-        expect(prompts.select).toHaveBeenCalledWith({
-            message: EMBEDDING_OPTION_PROMPT_MESSAGE,
-            options: [
-                { value: 'sentence-transformers', label: 'Local sentence-transformers embeddings' },
-                { value: 'openai', label: 'OpenAI embeddings', hint: 'recommended' },
-                { value: 'back', label: 'Back' },
-            ],
-        });
-    });
-    it('returns from the OpenAI credential prompt to embedding option selection when Back is selected', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const prompts = makePromptAdapter({ selectValues: ['openai', 'back', 'sentence-transformers'] });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { prompts, env: {}, healthCheck, ensureLocalEmbeddings: vi.fn(async () => managedDaemon()) });
-        expect(result.status).toBe('ready');
-        expect(healthCheck).toHaveBeenCalledTimes(1);
-        expect(healthCheck).toHaveBeenCalledWith({
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-            sentenceTransformers: { baseURL: 'http://127.0.0.1:61234', pathPrefix: '' },
-        });
-        expect(vi.mocked(prompts.select).mock.calls.map((call) => call[0].message)).toEqual([
-            EMBEDDING_OPTION_PROMPT_MESSAGE,
-            'How should KTX find your OpenAI embedding API key?',
-            EMBEDDING_OPTION_PROMPT_MESSAGE,
-        ]);
-    });
-    it('configures local sentence-transformers embeddings after interactive selection', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const prompts = makePromptAdapter({ selectValues: ['sentence-transformers'] });
-        const ensureLocalEmbeddings = vi.fn(async () => managedDaemon());
-        const spinnerEvents = [];
-        const spinner = vi.fn(() => ({
-            start: (msg) => spinnerEvents.push(`start:${msg}`),
-            message: (msg) => spinnerEvents.push(`message:${msg}`),
-            stop: (msg) => spinnerEvents.push(`stop:${msg}`),
-            error: (msg) => spinnerEvents.push(`error:${msg}`),
-        }));
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { prompts, env: {}, healthCheck, ensureLocalEmbeddings, spinner });
-        expect(result.status).toBe('ready');
-        expect(ensureLocalEmbeddings).toHaveBeenCalledWith({
-            cliVersion: '0.2.0',
-            projectDir: tempDir,
-            installPolicy: 'auto',
-            io: io.io,
-        });
-        expect(healthCheck).toHaveBeenCalledWith({
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-            sentenceTransformers: { baseURL: 'http://127.0.0.1:61234', pathPrefix: '' },
-        });
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(config.ingest.embeddings).toMatchObject({
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-        });
-        expect(config.ingest.embeddings.sentenceTransformers).toBeUndefined();
-        expect(config.scan.enrichment.embeddings).toMatchObject(config.ingest.embeddings);
-        expect(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8')).not.toContain('completed_steps:');
-        expect((await readKtxSetupState(tempDir)).completed_steps).toContain('embeddings');
-        expect(spinnerEvents).toContainEqual('start:Testing local embeddings (all-MiniLM-L6-v2)');
-        expect(io.stdout()).toContain('Embeddings ready: yes');
-    });
-    it('uses a short non-animated local embeddings health-check status by default', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const prompts = makePromptAdapter({ selectValues: ['sentence-transformers'] });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { prompts, env: {}, healthCheck, ensureLocalEmbeddings: vi.fn(async () => managedDaemon()) });
-        expect(result.status).toBe('ready');
-        expect(io.stderr()).toContain('Testing local embeddings (all-MiniLM-L6-v2)');
-        expect(io.stderr()).not.toContain('First run may take up to 60 seconds');
-        expect(io.stderr().match(/Testing local embeddings/g)).toHaveLength(1);
-    });
-    it('shows live progress while local sentence-transformers embeddings are being tested', async () => {
-        const io = makeIo();
-        const prompts = makePromptAdapter({ selectValues: ['sentence-transformers'] });
-        let resolveHealthCheck;
-        const healthCheck = vi.fn(() => new Promise((resolve) => {
-            resolveHealthCheck = resolve;
-        }));
-        const spinnerEvents = [];
-        const spinner = vi.fn(() => ({
-            start: (msg) => spinnerEvents.push(`start:${msg}`),
-            message: (msg) => spinnerEvents.push(`message:${msg}`),
-            stop: (msg) => spinnerEvents.push(`stop:${msg}`),
-            error: (msg) => spinnerEvents.push(`error:${msg}`),
-        }));
-        const result = runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { prompts, env: {}, healthCheck, ensureLocalEmbeddings: vi.fn(async () => managedDaemon()), spinner });
-        await vi.waitFor(() => {
-            expect(spinnerEvents).toContainEqual('start:Testing local embeddings (all-MiniLM-L6-v2)');
-        });
-        expect(resolveHealthCheck).toBeDefined();
-        resolveHealthCheck?.({ ok: true });
-        await expect(result).resolves.toMatchObject({ status: 'ready' });
-    });
-    it('uses default local sentence-transformers embeddings in non-interactive setup', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, { env: {}, healthCheck, ensureLocalEmbeddings: vi.fn(async () => managedDaemon()) });
-        expect(result.status).toBe('ready');
-        expect(healthCheck).toHaveBeenCalledWith({
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-            sentenceTransformers: { baseURL: 'http://127.0.0.1:61234', pathPrefix: '' },
-        });
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(config.ingest.embeddings).toMatchObject({
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-        });
-        expect(config.ingest.embeddings.sentenceTransformers).toBeUndefined();
-        expect(config.scan.enrichment.embeddings).toMatchObject(config.ingest.embeddings);
-        expect(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8')).not.toContain('completed_steps:');
-        expect((await readKtxSetupState(tempDir)).completed_steps).toContain('embeddings');
-    });
-    it('fails non-interactive local setup when the managed local embeddings runtime is missing', async () => {
-        const io = makeIo();
-        const ensureLocalEmbeddings = vi.fn(async () => {
-            throw new Error('KTX Python runtime is required for this command. Run: ktx admin runtime install --feature local-embeddings --yes');
-        });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'never',
-            skipEmbeddings: false,
-        }, io.io, { env: {}, ensureLocalEmbeddings });
-        expect(result.status).toBe('failed');
-        expect(io.stderr()).toContain('KTX Python runtime is required for this command. Run: ktx admin runtime install --feature local-embeddings --yes');
-    });
-    it('does not persist embedding completion when the health check fails', async () => {
-        const io = makeIo();
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, {
-            env: {},
-            ensureLocalEmbeddings: vi.fn(async () => managedDaemon()),
-            healthCheck: vi.fn(async () => ({ ok: false, message: '401 invalid api key [redacted]' })),
-        });
-        expect(result.status).toBe('failed');
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8')).not.toContain('completed_steps:');
-        expect(config.ingest.embeddings.backend).toBe('none');
-        expect(io.stderr()).toContain('Local embedding health check failed: 401 invalid api key [redacted]');
-        expect(io.stderr()).toContain('Prepare the runtime with: ktx admin runtime start --feature local-embeddings');
-        expect(io.stderr()).not.toContain('skip for now');
-    });
-    it('prints the recent daemon stderr tail when local embedding health check fails', async () => {
-        const io = makeIo();
-        const stderrLog = join(tempDir, '.ktx', 'runtime', 'daemon.stderr.log');
-        await mkdir(join(tempDir, '.ktx', 'runtime'), { recursive: true });
-        await writeFile(stderrLog, Array.from({ length: 45 }, (_value, index) => `daemon traceback line ${index + 1}`).join('\n'));
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, {
-            env: {},
-            ensureLocalEmbeddings: vi.fn(async () => managedDaemon('http://127.0.0.1:61234', { stderrLog })),
-            healthCheck: vi.fn(async () => ({ ok: false, message: 'HTTP 500' })),
-        });
-        expect(result.status).toBe('failed');
-        expect(io.stderr()).toContain('Recent KTX daemon stderr:');
-        expect(io.stderr()).toContain('daemon traceback line 6');
-        expect(io.stderr()).toContain('daemon traceback line 45');
-        expect(io.stderr()).not.toContain('daemon traceback line 5');
-    });
-    it('does not print daemon stderr diagnostics when the log is unavailable or empty', async () => {
-        const io = makeIo();
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, {
-            env: {},
-            ensureLocalEmbeddings: vi.fn(async () => managedDaemon('http://127.0.0.1:61234', {
-                stderrLog: join(tempDir, '.ktx', 'runtime', 'missing.stderr.log'),
-            })),
-            healthCheck: vi.fn(async () => ({ ok: false, message: 'HTTP 500' })),
-        });
-        expect(result.status).toBe('failed');
-        expect(io.stderr()).not.toContain('Recent KTX daemon stderr:');
-    });
-    it('uses fixed OpenAI defaults and only asks for credentials when OpenAI is selected', async () => {
-        const io = makeIo();
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            embeddingBackend: 'openai',
-            embeddingApiKeyEnv: 'OPENAI_API_KEY', // pragma: allowlist secret
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, {
-            env: { OPENAI_API_KEY: 'sk-openai-test' }, // pragma: allowlist secret
-            healthCheck,
-        });
-        expect(result.status).toBe('ready');
-        expect(healthCheck).toHaveBeenCalledWith({
-            backend: 'openai',
-            model: 'text-embedding-3-small',
-            dimensions: 1536,
-            openai: { apiKey: 'sk-openai-test' }, // pragma: allowlist secret
-        });
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(config.ingest.embeddings).toMatchObject({
-            backend: 'openai',
-            model: 'text-embedding-3-small',
-            dimensions: 1536,
-            openai: { api_key: 'env:OPENAI_API_KEY' }, // pragma: allowlist secret
-        });
-        expect(io.stdout()).not.toContain('sk-openai-test');
-    });
-    it('can fall back to OpenAI after the default local daemon is unavailable', async () => {
-        const io = makeIo();
-        const prompts = makePromptAdapter({ selectValues: ['sentence-transformers', 'openai', 'env'] });
-        const healthCheck = vi
-            .fn()
-            .mockResolvedValueOnce({ ok: false, message: 'fetch failed' })
-            .mockResolvedValueOnce({ ok: true });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, io.io, {
-            prompts,
-            env: { OPENAI_API_KEY: 'sk-openai-test' }, // pragma: allowlist secret
-            healthCheck,
-            ensureLocalEmbeddings: vi.fn(async () => managedDaemon()),
-        });
-        expect(result.status).toBe('ready');
-        expect(healthCheck).toHaveBeenNthCalledWith(1, {
-            backend: 'sentence-transformers',
-            model: 'all-MiniLM-L6-v2',
-            dimensions: 384,
-            sentenceTransformers: { baseURL: 'http://127.0.0.1:61234', pathPrefix: '' },
-        });
-        expect(healthCheck).toHaveBeenNthCalledWith(2, {
-            backend: 'openai',
-            model: 'text-embedding-3-small',
-            dimensions: 1536,
-            openai: { apiKey: 'sk-openai-test' }, // pragma: allowlist secret
-        });
-        expect(prompts.select).toHaveBeenCalledWith(expect.objectContaining({
-            message: 'Local embeddings are not reachable. Start the local KTX daemon, then retry.',
-            options: expect.arrayContaining([expect.objectContaining({ value: 'openai' })]),
-        }));
-        expect(vi.mocked(prompts.select).mock.calls[1]?.[0].options).toEqual([
-            { value: 'retry', label: 'Retry' },
-            { value: 'openai', label: 'Use OpenAI embeddings' },
-            { value: 'back', label: 'Back' },
-        ]);
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(config.ingest.embeddings.backend).toBe('openai');
-    });
-    it('leaves setup incomplete when skipped', async () => {
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: true,
-        }, makeIo().io);
-        expect(result.status).toBe('skipped');
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8')).not.toContain('completed_steps:');
-        expect(config.ingest.embeddings.backend).toBe('none');
-    });
-    it('returns back without writing config when the local health check fails and Back is selected', async () => {
-        const prompts = makePromptAdapter({ selectValues: ['sentence-transformers', 'back'] });
-        const result = await runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'auto',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, makeIo().io, {
-            prompts,
-            env: {},
-            ensureLocalEmbeddings: vi.fn(async () => managedDaemon()),
-            healthCheck: vi.fn(async () => ({ ok: false, message: 'daemon unavailable' })),
-        });
-        expect(result.status).toBe('back');
-        const config = parseKtxProjectConfig(await readFile(join(tempDir, 'ktx.yaml'), 'utf-8'));
-        expect(config.ingest.embeddings.backend).toBe('none');
-    });
-    it('preserves already completed embeddings setup when no embedding args request changes', async () => {
-        await mkdir(join(tempDir, '.ktx'), { recursive: true });
-        await initKtxProject({ projectDir: tempDir, force: true });
-        await writeFile(join(tempDir, 'ktx.yaml'), [
-            'setup:',
-            '  database_connection_ids: []',
-            'connections: {}',
-            'ingest:',
-            '  embeddings:',
-            '    backend: sentence-transformers',
-            '    model: all-MiniLM-L6-v2',
-            '    dimensions: 384',
-            '    sentenceTransformers:',
-            '      base_url: http://127.0.0.1:8765',
-            "      pathPrefix: ''",
-        ].join('\n'), 'utf-8');
-        await writeKtxSetupState(tempDir, { completed_steps: ['project', 'llm', 'embeddings'] });
-        const healthCheck = vi.fn(async () => ({ ok: true }));
-        await expect(runKtxSetupEmbeddingsStep({
-            projectDir: tempDir,
-            inputMode: 'disabled',
-            cliVersion: '0.2.0',
-            runtimeInstallPolicy: 'auto',
-            skipEmbeddings: false,
-        }, makeIo().io, {
-            env: { OPENAI_API_KEY: 'sk-openai-test' }, // pragma: allowlist secret
-            healthCheck,
-        })).resolves.toMatchObject({ status: 'ready' });
-        expect(healthCheck).not.toHaveBeenCalled();
-    });
-});

package/dist/setup-interrupt.test.d.ts

@@ -1 +0,0 @@
-export {};