@kaelio/ktx 0.1.0-rc.6 → 0.1.1

package/dist/setup.test.js

@@ -1,5 +1,5 @@
 import { execFile } from 'node:child_process';
-import { mkdir, mkdtemp, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { promisify } from 'node:util';
@@ -8,7 +8,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { localFakeBundleReport, persistLocalBundleReport } from './ingest.test-utils.js';
 import { contextBuildCommands, writeKtxSetupContextState } from './setup-context.js';
 import { runDemoTour } from './setup-demo-tour.js';
-import { formatKtxSetupStatus, readKtxSetupStatus, runKtxSetup } from './setup.js';
+import { formatKtxSetupCompletionSummary, formatKtxSetupStatus, readKtxSetupStatus, runKtxSetup } from './setup.js';
 vi.mock('./setup-demo-tour.js', () => ({
     runDemoTour: vi.fn(async () => 0),
 }));
@@ -88,7 +88,7 @@ describe('setup status', () => {
             agents: [],
         });
     });
-    it('reports deterministic default embeddings as not setup-ready', async () => {
+    it('reports disabled default embeddings as not setup-ready', async () => {
         await mkdir(tempDir, { recursive: true });
         await writeFile(join(tempDir, 'ktx.yaml'), [
             'llm:',
@@ -100,15 +100,14 @@ describe('setup status', () => {
             '    default: claude-sonnet-4-6',
             'ingest:',
             '  embeddings:',
-            '    backend: deterministic',
-            '    model: deterministic',
+            '    backend: none',
             '    dimensions: 8',
             'connections: {}',
         ].join('\n'), 'utf-8');
         await expect(readKtxSetupStatus(tempDir)).resolves.toMatchObject({
             project: { path: tempDir, ready: true },
             llm: { backend: 'anthropic', ready: true, model: 'claude-sonnet-4-6' },
-            embeddings: { backend: 'deterministic', ready: false, model: 'deterministic', dimensions: 8 },
+            embeddings: { backend: 'none', ready: false, dimensions: 8 },
         });
     });
     it.each([
@@ -299,8 +298,7 @@ describe('setup status', () => {
             '    default: claude-sonnet-4-6',
             'ingest:',
             '  embeddings:',
-            '    backend: deterministic',
-            '    model: deterministic',
+            '    backend: none',
             '    dimensions: 8',
             '',
         ].join('\n'), 'utf-8');
@@ -337,6 +335,98 @@ describe('setup status', () => {
         expect(rendered).toContain('KTX context built: no');
         expect(rendered).not.toContain('No KTX project found.');
     });
+    it('formats a concise ready summary for completed agent setup', () => {
+        const rendered = formatKtxSetupCompletionSummary({
+            project: { path: tempDir, ready: true },
+            llm: { ready: true, model: 'sonnet' },
+            embeddings: { ready: true, model: 'text-embedding-3-small' },
+            databases: [{ connectionId: 'postgres-warehouse', ready: true }],
+            sources: [{ connectionId: 'dbt-main', type: 'dbt', ready: true }],
+            runtime: { required: true, ready: true, features: ['core'] },
+            context: { ready: true, status: 'completed' },
+            agents: [
+                { target: 'claude-code', scope: 'project', ready: true },
+                { target: 'claude-desktop', scope: 'global', ready: true },
+            ],
+        }, {
+            agentNextActions: [
+                '1. Start MCP',
+                '  Run this command before using Claude Code:',
+                '',
+                '  RUN:',
+                `  ktx mcp start --project-dir ${tempDir}`,
+                '',
+                '  If you need to stop MCP later:',
+                `  ktx mcp stop --project-dir ${tempDir}`,
+                '',
+                '2. Open Claude Code',
+                '  Open Claude Code from the KTX project directory:',
+                '',
+                '  RUN:',
+                `  cd '${tempDir}'`,
+                '  claude',
+            ].join('\n'),
+        });
+        expect(rendered).toContain(`Project\n  ${tempDir}`);
+        expect(rendered).toContain('Context\n  built');
+        expect(rendered).toContain('Agents configured\n  Claude Code, Claude Desktop');
+        expect(rendered).toContain('REQUIRED BEFORE USING AGENTS\n\n  1. Start MCP');
+        expect(rendered).toContain('    Run this command before using Claude Code:');
+        expect(rendered).toContain('    RUN:');
+        expect(rendered).toContain('    If you need to stop MCP later:');
+        expect(rendered).toContain(`ktx mcp stop --project-dir ${tempDir}`);
+        expect(rendered).toContain('After that, try\n  Ask your agent: "Use KTX to show me the available tables."');
+        expect(rendered).not.toContain('Verify');
+        expect(rendered).not.toContain('Project ready: yes');
+        expect(rendered).not.toContain('What you can do next');
+    });
+    it('prints agent next actions inside the final ready summary during full setup', async () => {
+        const testIo = makeIo();
+        await expect(runKtxSetup({
+            command: 'run',
+            projectDir: tempDir,
+            mode: 'auto',
+            agents: false,
+            target: 'claude-code',
+            skipAgents: false,
+            inputMode: 'disabled',
+            yes: true,
+            cliVersion: '0.2.0',
+            skipLlm: true,
+            skipEmbeddings: true,
+            skipDatabases: true,
+            skipSources: true,
+            databaseSchemas: [],
+        }, testIo.io, {
+            runtime: async () => runtimeReady(tempDir),
+            context: async () => {
+                await writeKtxSetupContextState(tempDir, {
+                    runId: 'setup-context-local-test',
+                    status: 'completed',
+                    primarySourceConnectionIds: [],
+                    contextSourceConnectionIds: [],
+                    reportIds: [],
+                    artifactPaths: [],
+                    retryableFailedTargets: [],
+                    commands: contextBuildCommands(tempDir, 'setup-context-local-test'),
+                });
+                await writeKtxSetupState(tempDir, { completed_steps: ['project', 'context'] });
+                return { status: 'ready', projectDir: tempDir, runId: 'setup-context-local-test' };
+            },
+        })).resolves.toBe(0);
+        const output = testIo.stdout();
+        expect(output).toContain('Claude Code · Project scope');
+        expect(output).toContain(join(tempDir, '.mcp.json'));
+        expect(output).toContain('Requires MCP to be started.');
+        expect(output).toContain('Analytics skill installed.');
+        expect(output).not.toContain('Agent integration complete');
+        expect(output).toContain('Finish KTX agent setup');
+        expect(output).not.toContain('KTX project ready');
+        expect(output).toContain('REQUIRED BEFORE USING AGENTS');
+        expect(output).toContain('Run this command before using Claude Code:');
+        expect(output).toContain(`ktx mcp start --project-dir ${tempDir}`);
+        expect(output).not.toContain('Finish agent setup');
+    });
     it('prints the setup shell intro for auto-created run mode', async () => {
         const testIo = makeIo();
         await expect(runKtxSetup({
@@ -364,6 +454,85 @@ describe('setup status', () => {
         expect(testIo.stdout()).not.toContain('Optional MCP:');
         expect(testIo.stderr()).toBe('');
     });
+    it('removes a newly created missing project directory when a later runtime step fails', async () => {
+        const projectDir = join(tempDir, 'missing-project');
+        const testIo = makeIo();
+        await expect(runKtxSetup({
+            command: 'run',
+            projectDir,
+            mode: 'auto',
+            agents: false,
+            skipAgents: true,
+            inputMode: 'disabled',
+            yes: true,
+            cliVersion: '0.2.0',
+            skipLlm: true,
+            skipEmbeddings: true,
+            databaseSchemas: [],
+            skipDatabases: true,
+            skipSources: true,
+        }, testIo.io, {
+            model: async () => ({ status: 'skipped', projectDir }),
+            embeddings: async () => ({ status: 'skipped', projectDir }),
+            databases: async () => ({ status: 'skipped', projectDir }),
+            sources: async () => ({ status: 'skipped', projectDir }),
+            runtime: async () => ({ status: 'failed', projectDir, requirements: { features: ['core'], requirements: [] } }),
+        })).resolves.toBe(1);
+        await expect(stat(projectDir)).rejects.toThrow();
+    });
+    it('removes KTX scaffold files from an initially empty project directory when runtime setup fails', async () => {
+        const testIo = makeIo();
+        await expect(runKtxSetup({
+            command: 'run',
+            projectDir: tempDir,
+            mode: 'auto',
+            agents: false,
+            skipAgents: true,
+            inputMode: 'disabled',
+            yes: true,
+            cliVersion: '0.2.0',
+            skipLlm: true,
+            skipEmbeddings: true,
+            databaseSchemas: [],
+            skipDatabases: true,
+            skipSources: true,
+        }, testIo.io, {
+            model: async () => ({ status: 'skipped', projectDir: tempDir }),
+            embeddings: async () => ({ status: 'skipped', projectDir: tempDir }),
+            databases: async () => ({ status: 'skipped', projectDir: tempDir }),
+            sources: async () => ({ status: 'skipped', projectDir: tempDir }),
+            runtime: async () => ({ status: 'failed', projectDir: tempDir, requirements: { features: ['core'], requirements: [] } }),
+        })).resolves.toBe(1);
+        await expect(stat(tempDir)).resolves.toBeDefined();
+        expect(await readdir(tempDir)).toEqual([]);
+    });
+    it('preserves a pre-existing non-empty project directory when runtime setup fails', async () => {
+        await writeFile(join(tempDir, 'notes.txt'), 'keep me\n', 'utf-8');
+        const testIo = makeIo();
+        await expect(runKtxSetup({
+            command: 'run',
+            projectDir: tempDir,
+            mode: 'auto',
+            agents: false,
+            skipAgents: true,
+            inputMode: 'disabled',
+            yes: true,
+            cliVersion: '0.2.0',
+            skipLlm: true,
+            skipEmbeddings: true,
+            databaseSchemas: [],
+            skipDatabases: true,
+            skipSources: true,
+        }, testIo.io, {
+            model: async () => ({ status: 'skipped', projectDir: tempDir }),
+            embeddings: async () => ({ status: 'skipped', projectDir: tempDir }),
+            databases: async () => ({ status: 'skipped', projectDir: tempDir }),
+            sources: async () => ({ status: 'skipped', projectDir: tempDir }),
+            runtime: async () => ({ status: 'failed', projectDir: tempDir, requirements: { features: ['core'], requirements: [] } }),
+        })).resolves.toBe(1);
+        await expect(readFile(join(tempDir, 'notes.txt'), 'utf-8')).resolves.toBe('keep me\n');
+        await expect(stat(join(tempDir, 'ktx.yaml'))).resolves.toBeDefined();
+    });
     it('shows demo near the bottom of the first setup intent menu before project creation', async () => {
         const testIo = makeIo();
         const select = vi.fn(async (options) => {
@@ -658,16 +827,16 @@ describe('setup status', () => {
         }, testIo.io, { entryMenuDeps: { prompts: { select: vi.fn(async () => 'demo'), cancel: vi.fn() } } })).resolves.toBe(0);
         expect(runDemoTour).toHaveBeenCalledWith({ inputMode: 'auto' }, testIo.io, expect.objectContaining({}));
     });
-    it('creates a project through run mode when --new is selected', async () => {
+    it('creates a project through run mode when --yes is selected', async () => {
         const testIo = makeIo();
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             skipLlm: true,
             skipEmbeddings: true,
@@ -729,14 +898,14 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
             skipEmbeddings: true,
             databaseSchemas: [],
@@ -747,7 +916,7 @@ describe('setup status', () => {
             projectDir: tempDir,
             inputMode: 'disabled',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
         }), testIo.io);
     });
@@ -757,16 +926,16 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             llmBackend: 'vertex',
             vertexProject: 'local-gcp-project',
             vertexLocation: 'us-east5',
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
             skipEmbeddings: true,
             databaseSchemas: [],
@@ -779,7 +948,7 @@ describe('setup status', () => {
             llmBackend: 'vertex',
             vertexProject: 'local-gcp-project',
             vertexLocation: 'us-east5',
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
         }), testIo.io);
     });
@@ -790,14 +959,14 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
             yes: true,
             cliVersion: '0.2.0',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
             embeddingBackend: 'openai',
             embeddingApiKeyEnv: 'OPENAI_API_KEY', // pragma: allowlist secret
@@ -819,10 +988,11 @@ describe('setup status', () => {
     it('passes no-input runtime policy to the embeddings step', async () => {
         const io = makeIo();
         const embeddings = vi.fn(async () => ({ status: 'failed', projectDir: tempDir }));
+        await writeFile(join(tempDir, 'ktx.yaml'), 'connections: {}\n', 'utf-8');
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             agentScope: 'project',
             skipAgents: true,
@@ -844,10 +1014,11 @@ describe('setup status', () => {
         const io = makeIo();
         const embeddings = vi.fn(async () => ({ status: 'ready', projectDir: tempDir }));
         const context = vi.fn(async () => ({ status: 'failed', projectDir: tempDir }));
+        await writeFile(join(tempDir, 'ktx.yaml'), 'connections: {}\n', 'utf-8');
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             agentScope: 'project',
             skipAgents: true,
@@ -874,6 +1045,7 @@ describe('setup status', () => {
     });
     it('lets Back from embedding setup return to the model step instead of exiting', async () => {
         const testIo = makeIo();
+        await writeFile(join(tempDir, 'ktx.yaml'), 'connections: {}\n', 'utf-8');
         const modelResults = [
             { status: 'ready', projectDir: tempDir },
             { status: 'back', projectDir: tempDir },
@@ -883,7 +1055,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'auto',
@@ -901,6 +1073,7 @@ describe('setup status', () => {
     });
     it('lets Back from database selection return to embedding setup', async () => {
         const testIo = makeIo();
+        await writeFile(join(tempDir, 'ktx.yaml'), 'connections: {}\n', 'utf-8');
         const modelResults = [
             { status: 'ready', projectDir: tempDir },
             { status: 'back', projectDir: tempDir },
@@ -921,11 +1094,11 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'auto',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             skipLlm: false,
             skipEmbeddings: false,
@@ -958,7 +1131,7 @@ describe('setup status', () => {
             agents: false,
             skipAgents: true,
             inputMode: 'auto',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             skipLlm: false,
             skipEmbeddings: true,
@@ -986,14 +1159,14 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
             embeddingBackend: 'openai',
             embeddingApiKeyEnv: 'OPENAI_API_KEY', // pragma: allowlist secret
@@ -1032,7 +1205,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1095,7 +1268,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1132,7 +1305,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1171,7 +1344,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             inputMode: 'disabled',
             yes: true,
@@ -1223,7 +1396,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             inputMode: 'disabled',
             yes: true,
@@ -1257,14 +1430,14 @@ describe('setup status', () => {
         const committedConfig = await execFileAsync('git', ['-C', tempDir, 'show', 'HEAD:ktx.yaml']);
         expect(committedConfig.stdout).toContain('warehouse:');
     });
-    it('runs agent setup after context succeeds in --agents mode', async () => {
+    it('runs agent setup without runtime or context in --agents mode', async () => {
         const calls = [];
         const io = makeIo();
         await writeFile(join(tempDir, 'ktx.yaml'), ['connections: {}', ''].join('\n'), 'utf-8');
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: true,
             target: 'codex',
             agentScope: 'project',
@@ -1284,11 +1457,11 @@ describe('setup status', () => {
             sources: async () => ({ status: 'skipped', projectDir: tempDir }),
             runtime: async () => {
                 calls.push('runtime');
-                return runtimeReady(tempDir);
+                throw new Error('runtime should not run');
             },
             context: async () => {
                 calls.push('context');
-                return { status: 'ready', projectDir: tempDir, runId: 'setup-context-local-test' };
+                throw new Error('context should not run');
             },
             agents: async () => {
                 calls.push('agents');
@@ -1299,10 +1472,12 @@ describe('setup status', () => {
                 };
             },
         })).resolves.toBe(0);
-        expect(calls).toEqual(['runtime', 'context', 'agents']);
+        expect(calls).toEqual(['agents']);
     });
-    it('does not install agents when non-interactive --agents finds context incomplete', async () => {
+    it('installs agents when non-interactive --agents finds context incomplete', async () => {
         const io = makeIo();
+        const runtime = vi.fn(async () => runtimeReady(tempDir));
+        const context = vi.fn(async () => ({ status: 'skipped', projectDir: tempDir }));
         const agents = vi.fn(async () => ({
             status: 'ready',
             projectDir: tempDir,
@@ -1312,7 +1487,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: true,
             target: 'codex',
             agentScope: 'project',
@@ -1326,12 +1501,49 @@ describe('setup status', () => {
             skipAgents: false,
             databaseSchemas: [],
         }, io.io, {
-            runtime: async () => runtimeReady(tempDir),
-            context: async () => ({ status: 'skipped', projectDir: tempDir }),
+            runtime,
+            context,
             agents,
-        })).resolves.toBe(1);
-        expect(agents).not.toHaveBeenCalled();
-        expect(io.stderr()).toContain('KTX context is not ready for agents.');
+        })).resolves.toBe(0);
+        expect(runtime).not.toHaveBeenCalled();
+        expect(context).not.toHaveBeenCalled();
+        expect(agents).toHaveBeenCalledTimes(1);
+        expect(io.stderr()).not.toContain('KTX context is not ready for agents.');
+    });
+    it('runs non-TTY --agents with a target without requiring --no-input or --yes', async () => {
+        const io = makeIo();
+        const agents = vi.fn(async () => ({
+            status: 'ready',
+            projectDir: tempDir,
+            installs: [{ target: 'claude-code', scope: 'project', mode: 'mcp' }],
+        }));
+        await writeFile(join(tempDir, 'ktx.yaml'), ['connections: {}', ''].join('\n'), 'utf-8');
+        await expect(runKtxSetup({
+            command: 'run',
+            projectDir: tempDir,
+            mode: 'auto',
+            agents: true,
+            target: 'claude-code',
+            agentScope: 'project',
+            inputMode: 'auto',
+            yes: false,
+            cliVersion: '0.2.0',
+            skipLlm: false,
+            skipEmbeddings: false,
+            skipDatabases: false,
+            skipSources: false,
+            skipAgents: false,
+            databaseSchemas: [],
+        }, io.io, { agents })).resolves.toBe(0);
+        expect(agents).toHaveBeenCalledWith(expect.objectContaining({
+            inputMode: 'disabled',
+            yes: false,
+            agents: true,
+            target: 'claude-code',
+            scope: 'project',
+            mode: 'mcp',
+        }), io.io);
+        expect(io.stderr()).not.toContain('Interactive setup requires a terminal');
     });
     it('routes a ready project menu selection to agent setup', async () => {
         const calls = [];
@@ -1382,7 +1594,7 @@ describe('setup status', () => {
             await expect(runKtxSetup({
                 command: 'run',
                 projectDir: tempDir,
-                mode: 'existing',
+                mode: 'auto',
                 agents: false,
                 inputMode: 'auto',
                 yes: false,
@@ -1433,7 +1645,7 @@ describe('setup status', () => {
                 process.env.KTX_RUNTIME_ROOT = previousRuntimeRoot;
             }
         }
-        expect(calls).toEqual(['runtime', 'agents']);
+        expect(calls).toEqual(['agents']);
     });
     it('skips to agent setup when context is ready but agents are not configured', async () => {
         const calls = [];
@@ -1474,7 +1686,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             inputMode: 'auto',
             yes: false,
@@ -1517,9 +1729,9 @@ describe('setup status', () => {
             },
         })).resolves.toBe(0);
         expect(readyMenuSelect).not.toHaveBeenCalled();
-        expect(calls).toEqual(['runtime', 'agents']);
+        expect(calls).toEqual(['agents']);
     });
-    it('runs only project resolution, runtime, context gate, and agent setup in --agents mode', async () => {
+    it('runs only project resolution and agent setup in --agents mode', async () => {
         const io = makeIo();
         const runtime = vi.fn(async () => runtimeReady(tempDir));
         const context = vi.fn(async () => ({ status: 'ready', projectDir: tempDir, runId: 'setup-context-local-test' }));
@@ -1531,7 +1743,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: true,
             target: 'universal',
             agentScope: 'project',
@@ -1552,8 +1764,8 @@ describe('setup status', () => {
             context,
             agents,
         })).resolves.toBe(0);
-        expect(runtime).toHaveBeenCalledTimes(1);
-        expect(context).toHaveBeenCalledTimes(1);
+        expect(runtime).not.toHaveBeenCalled();
+        expect(context).not.toHaveBeenCalled();
         expect(agents).toHaveBeenCalledTimes(1);
     });
     it('does not run embedding setup when the model step fails', async () => {
@@ -1563,19 +1775,20 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             anthropicApiKeyEnv: 'ANTHROPIC_API_KEY', // pragma: allowlist secret
-            anthropicModel: 'claude-sonnet-4-6',
+            llmModel: 'claude-sonnet-4-6',
             skipLlm: false,
             skipEmbeddings: false,
             databaseSchemas: [],
             skipDatabases: true,
         }, testIo.io, { model, embeddings })).resolves.toBe(1);
+        expect(model).toHaveBeenCalledTimes(1);
         expect(embeddings).not.toHaveBeenCalled();
     });
 });

package/dist/sl.test.js

@@ -89,7 +89,8 @@ describe('runKtxSl', () => {
             yaml: [
                 'name: orders',
                 'table: public.orders',
-                'description: Paid order facts',
+                'descriptions:',
+                '  user: Paid order facts',
                 'grain: [order_id]',
                 'columns:',
                 '  - name: order_id',