@kaelio/ktx 0.1.0 → 0.2.0

package/dist/setup.d.ts

@@ -52,7 +52,7 @@ export interface KtxSetupStatus {
 export type KtxSetupArgs = {
     command: 'run';
     projectDir: string;
-    mode: 'auto' | 'new' | 'existing';
+    mode: 'auto';
     agents: boolean;
     target?: KtxAgentTarget;
     agentScope?: KtxAgentScope;
@@ -64,7 +64,6 @@ export type KtxSetupArgs = {
     anthropicApiKeyEnv?: string;
     anthropicApiKeyFile?: string;
     llmModel?: string;
-    anthropicModel?: string;
     vertexProject?: string;
     vertexLocation?: string;
     skipLlm: boolean;

package/dist/setup.js

@@ -1,4 +1,5 @@
 import { existsSync } from 'node:fs';
+import { rm } from 'node:fs/promises';
 import { basename, join, resolve } from 'node:path';
 import { getLatestLocalIngestStatus, savedMemoryCountsForReport } from '@ktx/context/ingest';
 import { ktxLocalStateDbPath, loadKtxProject, readKtxSetupState, } from '@ktx/context/project';
@@ -11,7 +12,7 @@ import { readKtxAgentInstallManifest, runKtxSetupAgentsStep, targetDisplayName,
 import { runKtxSetupDatabasesStep, } from './setup-databases.js';
 import { runKtxSetupEmbeddingsStep } from './setup-embeddings.js';
 import { isKtxSetupLlmConfigReady, runKtxSetupAnthropicModelStep, } from './setup-models.js';
-import { runKtxSetupProjectStep } from './setup-project.js';
+import { runKtxSetupProjectStep, } from './setup-project.js';
 import { isKtxPreAgentSetupReady, isKtxSetupReady, runKtxSetupReadyChangeMenu, } from './setup-ready-menu.js';
 import { runKtxSetupSourcesStep } from './setup-sources.js';
 import { runKtxSetupRuntimeStep, } from './setup-runtime.js';
@@ -54,7 +55,6 @@ async function runKtxSetupDemoFromEntryMenu(args, io, deps) {
 function embeddingsReady(status) {
     return (status.backend !== undefined &&
         status.backend !== 'none' &&
-        status.backend !== 'deterministic' &&
         typeof status.model === 'string' &&
         status.model.length > 0 &&
         typeof status.dimensions === 'number' &&
@@ -270,6 +270,17 @@ async function commitSetupConfigChanges(projectDir) {
     const project = await loadKtxProject({ projectDir });
     await project.git.commitFile('ktx.yaml', 'setup: update KTX project config', 'ktx setup', 'setup@ktx.local');
 }
+const KTX_SETUP_SCAFFOLD_PATHS = ['ktx.yaml', '.ktx', 'wiki', 'semantic-layer', 'raw-sources', '.git'];
+async function cleanupCreatedProjectScaffold(cleanup) {
+    if (!cleanup) {
+        return;
+    }
+    if (cleanup.kind === 'remove-project-dir') {
+        await rm(cleanup.projectDir, { recursive: true, force: true });
+        return;
+    }
+    await Promise.all(KTX_SETUP_SCAFFOLD_PATHS.map((relativePath) => rm(join(cleanup.projectDir, relativePath), { recursive: true, force: true })));
+}
 export async function runKtxSetup(args, io, deps = {}) {
     try {
         return await runKtxSetupInner(args, io, deps);
@@ -390,7 +401,6 @@ async function runKtxSetupInner(args, io, deps = {}) {
                     ...(args.anthropicApiKeyEnv ? { anthropicApiKeyEnv: args.anthropicApiKeyEnv } : {}),
                     ...(args.anthropicApiKeyFile ? { anthropicApiKeyFile: args.anthropicApiKeyFile } : {}),
                     ...(args.llmModel ? { llmModel: args.llmModel } : {}),
-                    ...(args.anthropicModel ? { anthropicModel: args.anthropicModel } : {}),
                     ...(args.vertexProject ? { vertexProject: args.vertexProject } : {}),
                     ...(args.vertexLocation ? { vertexLocation: args.vertexLocation } : {}),
                     forcePrompt: forcePromptSteps.has('models') || runOnly === 'models',
@@ -493,7 +503,9 @@ async function runKtxSetupInner(args, io, deps = {}) {
                 const agentsRunner = deps.agents ?? ((agentArgs, agentIo) => runKtxSetupAgentsStep(agentArgs, agentIo, deps.agentsDeps));
                 const agentResult = await agentsRunner({
                     projectDir: projectResult.projectDir,
-                    inputMode: args.inputMode,
+                    inputMode: args.inputMode === 'auto' && io.stdout.isTTY !== true && deps.agentsDeps?.prompts === undefined
+                        ? 'disabled'
+                        : args.inputMode,
                     yes: args.yes,
                     agents: true,
                     ...(args.target ? { target: args.target } : {}),
@@ -507,7 +519,11 @@ async function runKtxSetupInner(args, io, deps = {}) {
                     agentNextActions = agentResult.nextActions;
                 }
             }
-            if (stepResult.status === 'failed' || stepResult.status === 'missing-input') {
+            if (stepResult.status === 'failed') {
+                await cleanupCreatedProjectScaffold(projectResult.createdProjectCleanup);
+                return 1;
+            }
+            if (stepResult.status === 'missing-input') {
                 return 1;
             }
             if (stepResult.status === 'back') {

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';
@@ -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');
@@ -387,7 +385,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             target: 'claude-code',
             skipAgents: false,
@@ -456,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) => {
@@ -750,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,
@@ -821,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: [],
@@ -839,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);
     });
@@ -849,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: [],
@@ -871,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);
     });
@@ -882,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
@@ -911,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,
@@ -936,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,
@@ -966,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 },
@@ -975,7 +1055,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'auto',
@@ -993,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 },
@@ -1013,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,
@@ -1050,7 +1131,7 @@ describe('setup status', () => {
             agents: false,
             skipAgents: true,
             inputMode: 'auto',
-            yes: false,
+            yes: true,
             cliVersion: '0.2.0',
             skipLlm: false,
             skipEmbeddings: true,
@@ -1078,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
@@ -1124,7 +1205,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1187,7 +1268,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1224,7 +1305,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             skipAgents: true,
             inputMode: 'disabled',
@@ -1263,7 +1344,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             inputMode: 'disabled',
             yes: true,
@@ -1315,7 +1396,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: false,
             inputMode: 'disabled',
             yes: true,
@@ -1356,7 +1437,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: true,
             target: 'codex',
             agentScope: 'project',
@@ -1406,7 +1487,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: true,
             target: 'codex',
             agentScope: 'project',
@@ -1429,6 +1510,41 @@ describe('setup status', () => {
         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 = [];
         const io = makeIo();
@@ -1478,7 +1594,7 @@ describe('setup status', () => {
             await expect(runKtxSetup({
                 command: 'run',
                 projectDir: tempDir,
-                mode: 'existing',
+                mode: 'auto',
                 agents: false,
                 inputMode: 'auto',
                 yes: false,
@@ -1570,7 +1686,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'existing',
+            mode: 'auto',
             agents: false,
             inputMode: 'auto',
             yes: false,
@@ -1627,7 +1743,7 @@ describe('setup status', () => {
         await expect(runKtxSetup({
             command: 'run',
             projectDir: tempDir,
-            mode: 'new',
+            mode: 'auto',
             agents: true,
             target: 'universal',
             agentScope: 'project',
@@ -1659,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.js

@@ -99,7 +99,7 @@ export async function runKtxSl(args, io = process, deps = {}) {
             await printSlSources({
                 rows: sources,
                 emptyMessage: `No semantic-layer sources matched "${args.query}" in ${project.projectDir}`,
-                emptyHint: 'Run `ktx sl list` to inspect available sources.',
+                emptyHint: 'Run `ktx sl` to inspect available sources.',
                 command: 'sl search',
                 output: args.output,
                 json: args.json,

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',

package/dist/standalone-smoke.test.js

@@ -76,7 +76,7 @@ async function writeSqliteScanConfig(projectDir, dbPath, enrich = false) {
                 '  enrichment:',
                 '    mode: deterministic',
                 '    embeddings:',
-                '      backend: deterministic',
+                '      backend: none',
                 '      dimensions: 6',
             ]
             : []),
@@ -94,7 +94,6 @@ async function runSetupNewProject(projectDir) {
         'setup',
         '--project-dir',
         projectDir,
-        '--new',
         '--no-input',
         '--yes',
         '--skip-llm',
@@ -117,6 +116,10 @@ describe('standalone built ktx CLI smoke', () => {
         const init = await runSetupNewProject(projectDir);
         expectSetupStderr(init);
         expect(init.stdout).toContain(`Project: ${projectDir}`);
+        const reindex = await runBuiltCli(['--project-dir', projectDir, 'admin', 'reindex', '--output', 'plain']);
+        expect(reindex.code).toBe(0);
+        expect(reindex.stdout).toContain('reindex\t');
+        expect(reindex.stderr).toContain('wiki/global');
         const run = await runBuiltCli([
             'ingest',
             'run',
@@ -126,7 +129,7 @@ describe('standalone built ktx CLI smoke', () => {
             'fake',
         ]);
         expect(run).toMatchObject({ code: 1, stdout: '' });
-        expect(run.stderr).toContain("unknown option '--connection-id'");
+        expect(run.stderr).toContain("unknown option '--adapter'");
     });
     it('rejects the removed agent command through the built binary', async () => {
         const result = await runBuiltCli(['agent']);
@@ -135,7 +138,7 @@ describe('standalone built ktx CLI smoke', () => {
         expect(result.stderr).toContain("unknown command 'agent'");
     });
     it('runs status setup checks through the built binary', async () => {
-        const result = await runBuiltCli(['status', '--verbose', '--no-input']);
+        const result = await runBuiltCli(['status', '--verbose', '--no-input'], { cwd: tempDir });
         expect(result.stdout).toMatch(/KTX status/);
         if (result.stdout.includes('No project here yet.')) {
             expect(result.stdout).toContain('ktx setup');
@@ -236,7 +239,7 @@ describe('standalone built ktx CLI smoke', () => {
         ]);
         expect(add.code).toBe(1);
         expect(add.stdout).toBe('');
-        expect(add.stderr).toContain("unknown command 'add'");
+        expect(add.stderr).toMatch(/unknown (command|option)|too many arguments/);
         const yaml = await readFile(join(projectDir, 'ktx.yaml'), 'utf-8');
         expect(yaml).not.toContain('driver: notion');
         expect(yaml).not.toContain('auth_token_ref: env:NOTION_TOKEN');

package/dist/status-project.js

@@ -120,15 +120,6 @@ function buildEmbeddingsStatus(config, env) {
             detail: 'disabled — semantic search will be skipped',
         };
     }
-    if (backend === 'deterministic') {
-        return {
-            backend,
-            model,
-            dimensions,
-            status: 'warn',
-            detail: 'deterministic — semantic search degraded (lexical/dictionary lanes still work)',
-        };
-    }
     if (backend === 'openai') {
         const ref = config.openai?.api_key;
         const resolved = resolveRef(ref, env);
@@ -469,7 +460,7 @@ function buildVerdict(llm, embeddings, connections, queryHistory, warnings) {
     if (llm.status === 'warn')
         reasons.push('LLM credentials missing');
     if (embeddings.status === 'warn') {
-        if (embeddings.backend === 'deterministic' || embeddings.backend === 'none') {
+        if (embeddings.backend === 'none') {
             reasons.push('semantic search disabled');
         }
         else {

package/node_modules/@ktx/context/dist/index-sync/index.d.ts

@@ -0,0 +1,2 @@
+export type { ReindexOptions, ReindexScopeResult, ReindexSummary, ReindexWorkResult } from './types.js';
+export { discoverReindexScopes, reindexLocalIndexes } from './reindex.js';

package/node_modules/@ktx/context/dist/index-sync/index.js

@@ -0,0 +1 @@
+export { discoverReindexScopes, reindexLocalIndexes } from './reindex.js';