@kaelio/ktx 0.1.0 → 0.1.1

package/dist/setup-project.js

@@ -37,6 +37,15 @@ async function existingFolderState(projectDir) {
         throw error;
     }
 }
+function cleanupForFolderState(projectDir, state) {
+    if (state === 'missing') {
+        return { kind: 'remove-project-dir', projectDir };
+    }
+    if (state === 'empty-directory') {
+        return { kind: 'remove-ktx-scaffold', projectDir };
+    }
+    return undefined;
+}
 async function confirmProjectDir(selectedDir, io, prompts) {
     const state = await existingFolderState(selectedDir);
     if (state === 'not-directory') {
@@ -75,7 +84,7 @@ async function confirmProjectDir(selectedDir, io, prompts) {
         return { status: 'back' };
     if (action !== 'create')
         return { status: 'cancelled' };
-    return { status: 'confirmed', confirmedCreation: true };
+    return { status: 'confirmed', confirmedCreation: true, createdProjectCleanup: cleanupForFolderState(selectedDir, state) };
 }
 async function normalizeSetupGitignore(projectDir) {
     const gitignorePath = join(projectDir, '.ktx/.gitignore');
@@ -147,34 +156,34 @@ async function promptForNewProjectDir(projectDir, homeDir, io, prompts) {
             return { status: 'back', projectDir };
         if (confirmed.status === 'cancelled')
             return { status: 'cancelled', projectDir };
-        return { status: 'selected', projectDir: selectedDir, confirmedCreation: confirmed.confirmedCreation };
+        return {
+            status: 'selected',
+            projectDir: selectedDir,
+            confirmedCreation: confirmed.confirmedCreation,
+            ...(confirmed.createdProjectCleanup ? { createdProjectCleanup: confirmed.createdProjectCleanup } : {}),
+        };
     }
 }
+async function createProjectWithCleanup(projectDir, deps) {
+    const state = await existingFolderState(projectDir);
+    const project = await createProject(projectDir, deps);
+    const createdProjectCleanup = cleanupForFolderState(projectDir, state);
+    return {
+        project,
+        ...(createdProjectCleanup ? { createdProjectCleanup } : {}),
+    };
+}
 export async function runKtxSetupProjectStep(args, io, deps = {}) {
     const projectDir = resolve(args.projectDir);
     const homeDir = deps.homeDir ?? homedir();
     const exists = hasProjectConfig(projectDir);
-    if (args.mode === 'existing') {
-        if (!exists) {
-            io.stderr.write(`No existing KTX project found at ${projectDir}. Pass --new to create it.\n`);
-            return { status: 'missing-input', projectDir };
-        }
-        const project = await loadExistingProject(projectDir, deps);
-        printProjectSummary(io, projectDir);
-        return { status: 'ready', projectDir, project };
-    }
-    if (args.mode === 'new') {
-        const project = await createProject(projectDir, deps);
-        printProjectSummary(io, projectDir);
-        return { status: 'ready', projectDir, project };
-    }
     if (args.mode === 'prompt-new') {
         if (args.inputMode === 'disabled') {
-            io.stderr.write('Missing new project folder: pass --new --project-dir to create a project without prompts.\n');
+            io.stderr.write('Missing new project folder: pass --project-dir and --yes to create a project without prompts.\n');
             return { status: 'missing-input', projectDir };
         }
         if (!io.stdout.isTTY && !deps.prompts) {
-            io.stderr.write('Missing new project folder: pass --new --project-dir to create a project outside an interactive terminal.\n');
+            io.stderr.write('Missing new project folder: pass --project-dir and --yes to create a project outside an interactive terminal.\n');
             return { status: 'missing-input', projectDir };
         }
         const prompts = deps.prompts ?? createClackSetupProjectPromptAdapter();
@@ -192,6 +201,7 @@ export async function runKtxSetupProjectStep(args, io, deps = {}) {
             projectDir: selected.projectDir,
             project,
             confirmedCreation: selected.confirmedCreation,
+            ...(selected.createdProjectCleanup ? { createdProjectCleanup: selected.createdProjectCleanup } : {}),
         };
     }
     if (exists) {
@@ -201,15 +211,20 @@ export async function runKtxSetupProjectStep(args, io, deps = {}) {
     }
     if (args.inputMode === 'disabled') {
         if (!args.yes) {
-            io.stderr.write('Missing setup choice: pass --new or --yes to create a project in non-interactive setup.\n');
+            io.stderr.write('Missing setup choice: pass --yes to create a project in non-interactive setup.\n');
             return { status: 'missing-input', projectDir };
         }
-        const project = await createProject(projectDir, deps);
+        const { project, createdProjectCleanup } = await createProjectWithCleanup(projectDir, deps);
         printProjectSummary(io, projectDir);
-        return { status: 'ready', projectDir, project };
+        return {
+            status: 'ready',
+            projectDir,
+            project,
+            ...(createdProjectCleanup ? { createdProjectCleanup } : {}),
+        };
     }
     if (!io.stdout.isTTY && !deps.prompts) {
-        io.stderr.write('Missing setup choice: pass --new or --yes to create a project outside an interactive terminal.\n');
+        io.stderr.write('Missing setup choice: pass --yes to create a project outside an interactive terminal.\n');
         return { status: 'missing-input', projectDir };
     }
     const prompts = deps.prompts ?? createClackSetupProjectPromptAdapter();
@@ -238,9 +253,14 @@ export async function runKtxSetupProjectStep(args, io, deps = {}) {
             return { status: 'cancelled', projectDir };
         }
         if (choice === 'current') {
-            const project = await createProject(projectDir, deps);
+            const { project, createdProjectCleanup } = await createProjectWithCleanup(projectDir, deps);
             printProjectSummary(io, projectDir);
-            return { status: 'ready', projectDir, project };
+            return {
+                status: 'ready',
+                projectDir,
+                project,
+                ...(createdProjectCleanup ? { createdProjectCleanup } : {}),
+            };
         }
         if (choice === 'new-default') {
             const confirmed = await confirmProjectDir(defaultProjectDir, io, prompts);
@@ -257,6 +277,7 @@ export async function runKtxSetupProjectStep(args, io, deps = {}) {
                 projectDir: defaultProjectDir,
                 project,
                 confirmedCreation: confirmed.confirmedCreation,
+                ...(confirmed.createdProjectCleanup ? { createdProjectCleanup: confirmed.createdProjectCleanup } : {}),
             };
         }
         if (choice === 'new-custom') {
@@ -281,7 +302,13 @@ export async function runKtxSetupProjectStep(args, io, deps = {}) {
                 return { status: 'cancelled', projectDir };
             const project = await createProject(customDir, deps);
             printProjectSummary(io, customDir);
-            return { status: 'ready', projectDir: customDir, project, confirmedCreation: confirmed.confirmedCreation };
+            return {
+                status: 'ready',
+                projectDir: customDir,
+                project,
+                confirmedCreation: confirmed.confirmedCreation,
+                ...(confirmed.createdProjectCleanup ? { createdProjectCleanup: confirmed.createdProjectCleanup } : {}),
+            };
         }
         prompts.cancel('Setup cancelled.');
         return { status: 'cancelled', projectDir };

package/dist/setup-project.test.js

@@ -48,10 +48,10 @@ describe('setup project step', () => {
     afterEach(async () => {
         await rm(tempDir, { recursive: true, force: true });
     });
-    it('creates a new project with --new and marks the project step complete', async () => {
+    it('creates a new project in non-interactive auto mode with --yes and marks the project step complete', async () => {
         const projectDir = join(tempDir, 'warehouse');
         const testIo = makeIo();
-        const result = await runKtxSetupProjectStep({ projectDir, mode: 'new', inputMode: 'disabled', yes: false }, testIo.io);
+        const result = await runKtxSetupProjectStep({ projectDir, mode: 'auto', inputMode: 'disabled', yes: true }, testIo.io);
         expect(result.status).toBe('ready');
         expect(result.projectDir).toBe(projectDir);
         expect(await readFile(join(projectDir, 'ktx.yaml'), 'utf-8')).not.toContain('completed_steps:');
@@ -61,7 +61,7 @@ describe('setup project step', () => {
         expect(testIo.stdout()).toContain(`Project: ${projectDir}`);
         expect(testIo.stderr()).toBe('');
     });
-    it('loads an existing project with --existing and drops config setup progress', async () => {
+    it('loads an existing project in auto mode and drops config setup progress', async () => {
         const projectDir = join(tempDir, 'warehouse');
         await initKtxProject({ projectDir });
         await writeFile(join(projectDir, 'ktx.yaml'), [
@@ -72,7 +72,7 @@ describe('setup project step', () => {
             '    - llm',
             'connections: {}',
         ].join('\n'), 'utf-8');
-        const result = await runKtxSetupProjectStep({ projectDir, mode: 'existing', inputMode: 'disabled', yes: false }, makeIo().io);
+        const result = await runKtxSetupProjectStep({ projectDir, mode: 'auto', inputMode: 'disabled', yes: false }, makeIo().io);
         expect(result.status).toBe('ready');
         const config = parseKtxProjectConfig(await readFile(join(projectDir, 'ktx.yaml'), 'utf-8'));
         expect(config.setup).toEqual({
@@ -86,16 +86,16 @@ describe('setup project step', () => {
         const rejectedIo = makeIo();
         const acceptedIo = makeIo();
         await expect(runKtxSetupProjectStep({ projectDir, mode: 'auto', inputMode: 'disabled', yes: false }, rejectedIo.io)).resolves.toMatchObject({ status: 'missing-input' });
-        expect(rejectedIo.stderr()).toContain('Missing setup choice: pass --new or --yes');
+        expect(rejectedIo.stderr()).toContain('Missing setup choice: pass --yes');
         await expect(stat(join(projectDir, 'ktx.yaml'))).rejects.toThrow();
         await expect(runKtxSetupProjectStep({ projectDir, mode: 'auto', inputMode: 'disabled', yes: true }, acceptedIo.io)).resolves.toMatchObject({ status: 'ready', projectDir });
         await expect(stat(join(projectDir, 'ktx.yaml'))).resolves.toBeDefined();
     });
-    it('fails --existing clearly when ktx.yaml is missing', async () => {
+    it('fails clearly in no-input auto mode when ktx.yaml is missing and --yes is absent', async () => {
         const projectDir = join(tempDir, 'warehouse');
         const testIo = makeIo();
-        await expect(runKtxSetupProjectStep({ projectDir, mode: 'existing', inputMode: 'disabled', yes: false }, testIo.io)).resolves.toMatchObject({ status: 'missing-input' });
-        expect(testIo.stderr()).toContain(`No existing KTX project found at ${projectDir}`);
+        await expect(runKtxSetupProjectStep({ projectDir, mode: 'auto', inputMode: 'disabled', yes: false }, testIo.io)).resolves.toMatchObject({ status: 'missing-input' });
+        expect(testIo.stderr()).toContain('Missing setup choice: pass --yes');
     });
     it('prompts to use the current directory and creates a project in interactive auto mode', async () => {
         const projectDir = join(tempDir, 'warehouse');

package/dist/setup-runtime.test.js

@@ -77,6 +77,8 @@ describe('runKtxSetupRuntimeStep', () => {
         const io = makeIo();
         const ensureLocalEmbeddings = vi.fn(async () => ({
             baseUrl: 'http://127.0.0.1:61234',
+            stdoutLog: join(tempDir, '.ktx', 'runtime', 'daemon.stdout.log'),
+            stderrLog: join(tempDir, '.ktx', 'runtime', 'daemon.stderr.log'),
             env: { KTX_MANAGED_SENTENCE_TRANSFORMERS_BASE_URL: 'http://127.0.0.1:61234' },
         }));
         const config = {

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') {