@kaelio/ktx 0.4.0 → 0.5.0

package/dist/setup-prompts.js

@@ -1,4 +1,4 @@
-import { cancel, confirm, intro, isCancel, log, multiselect, note, password, select, text, } from '@clack/prompts';
+import { autocomplete, autocompleteMultiselect, cancel, confirm, intro, isCancel, log, multiselect, note, password, select, text, } from '@clack/prompts';
 import { withMenuOptionsSpacing, withTextInputNavigation } from './prompt-navigation.js';
 import { withSetupInterruptConfirmation } from './setup-interrupt.js';
 const DEFAULT_SETUP_CANCEL_MESSAGE = 'Setup cancelled.';
@@ -46,6 +46,44 @@ export function createKtxSetupPromptAdapter(options) {
                 return selected;
             }
         },
+        async autocomplete(promptOptions) {
+            const value = await withSetupInterruptConfirmation(() => autocomplete(withMenuOptionsSpacing(promptOptions)));
+            if (isCancel(value)) {
+                if (cancelOnSelectCancel) {
+                    cancel(cancelMessage);
+                }
+                return options.selectCancelValue;
+            }
+            return String(value);
+        },
+        async autocompleteMultiselect(promptOptions) {
+            while (true) {
+                const value = await withSetupInterruptConfirmation(() => autocompleteMultiselect(withMenuOptionsSpacing(promptOptions)));
+                if (isCancel(value)) {
+                    if (cancelOnMultiselectCancel) {
+                        cancel(cancelMessage);
+                    }
+                    return [multiselectCancelValue];
+                }
+                const selected = [...value].map(String);
+                if (selected.length === 0 &&
+                    !promptOptions.required &&
+                    options.confirmEmptyOptionalMultiselect === true) {
+                    const skipConfirmed = await confirm({
+                        message: 'Nothing selected. Skip this step?',
+                        initialValue: false,
+                    });
+                    if (isCancel(skipConfirmed)) {
+                        cancel(cancelMessage);
+                        return [multiselectCancelValue];
+                    }
+                    if (!skipConfirmed) {
+                        continue;
+                    }
+                }
+                return selected;
+            }
+        },
         async text(promptOptions) {
             const value = await withSetupInterruptConfirmation(() => text({ ...promptOptions, message: withTextInputNavigation(promptOptions.message) }));
             return isCancel(value) ? undefined : String(value);

package/dist/setup-prompts.test.js

@@ -10,6 +10,8 @@ const mocks = vi.hoisted(() => {
         isCancel: vi.fn((value) => value === cancelSymbol),
         log: { info: vi.fn() },
         multiselect: vi.fn(),
+        autocomplete: vi.fn(),
+        autocompleteMultiselect: vi.fn(),
         note: vi.fn(),
         password: vi.fn(),
         select: vi.fn(),
@@ -24,6 +26,8 @@ vi.mock('@clack/prompts', () => ({
     isCancel: mocks.isCancel,
     log: mocks.log,
     multiselect: mocks.multiselect,
+    autocomplete: mocks.autocomplete,
+    autocompleteMultiselect: mocks.autocompleteMultiselect,
     note: mocks.note,
     password: mocks.password,
     select: mocks.select,
@@ -40,6 +44,8 @@ describe('setup prompt adapter', () => {
         mocks.isCancel.mockClear();
         mocks.log.info.mockReset();
         mocks.multiselect.mockReset();
+        mocks.autocomplete.mockReset();
+        mocks.autocompleteMultiselect.mockReset();
         mocks.note.mockReset();
         mocks.password.mockReset();
         mocks.select.mockReset();
@@ -130,6 +136,38 @@ describe('setup prompt adapter', () => {
         await expect(adapter.multiselect({ message: 'Which primary sources?', options: [] })).resolves.toEqual(['back']);
         expect(mocks.cancel).toHaveBeenCalledWith('Setup cancelled.');
     });
+    it('returns autocomplete selections and maps cancel to back', async () => {
+        mocks.autocomplete.mockResolvedValueOnce('analytics');
+        const adapter = createKtxSetupPromptAdapter({ selectCancelValue: 'back' });
+        await expect(adapter.autocomplete({
+            message: 'Dataset',
+            placeholder: 'Type to search',
+            options: [{ value: 'analytics', label: 'analytics' }],
+        })).resolves.toBe('analytics');
+        mocks.autocomplete.mockResolvedValueOnce(mocks.cancelSymbol);
+        await expect(adapter.autocomplete({
+            message: 'Dataset',
+            options: [{ value: 'analytics', label: 'analytics' }],
+        })).resolves.toBe('back');
+    });
+    it('returns autocomplete multiselect selections and maps cancel to back', async () => {
+        mocks.autocompleteMultiselect.mockResolvedValueOnce(['analytics', 'mart']);
+        const adapter = createKtxSetupPromptAdapter({ selectCancelValue: 'back', multiselectCancelValue: 'back' });
+        await expect(adapter.autocompleteMultiselect({
+            message: 'Datasets',
+            placeholder: 'Type to filter',
+            options: [
+                { value: 'analytics', label: 'analytics', hint: 'suggested' },
+                { value: 'mart', label: 'mart' },
+            ],
+            initialValues: ['analytics'],
+        })).resolves.toEqual(['analytics', 'mart']);
+        mocks.autocompleteMultiselect.mockResolvedValueOnce(mocks.cancelSymbol);
+        await expect(adapter.autocompleteMultiselect({
+            message: 'Datasets',
+            options: [{ value: 'analytics', label: 'analytics' }],
+        })).resolves.toEqual(['back']);
+    });
     it('keeps setup intro and note plain for non-stream output', async () => {
         const { createKtxSetupUiAdapter } = await import('./setup-prompts.js');
         const chunks = [];

package/dist/setup-ready-menu.d.ts

@@ -1,7 +1,7 @@
 import { type KtxSetupPromptOption } from './setup-prompts.js';
 import type { KtxSetupStatus } from './setup.js';
 export type KtxSetupReadyAction = 'models' | 'embeddings' | 'databases' | 'sources' | 'runtime' | 'context' | 'agents' | 'exit';
-export interface KtxSetupReadyMenuPromptAdapter {
+interface KtxSetupReadyMenuPromptAdapter {
     select(options: {
         message: string;
         options: KtxSetupPromptOption[];
@@ -16,3 +16,4 @@ export declare function isKtxSetupReady(status: KtxSetupStatus): boolean;
 export declare function runKtxSetupReadyChangeMenu(status: KtxSetupStatus, deps?: KtxSetupReadyMenuDeps): Promise<{
     action: KtxSetupReadyAction;
 }>;
+export {};

package/dist/setup-runtime.d.ts

@@ -1,4 +1,4 @@
-import { type KtxLocalProject } from '@ktx/context/project';
+import { type KtxLocalProject } from './context/project/project.js';
 import type { KtxCliIo } from './cli-runtime.js';
 import { type ManagedLocalEmbeddingsDaemon } from './managed-local-embeddings.js';
 import { type KtxManagedPythonInstallPolicy, type ManagedPythonCommandRuntime } from './managed-python-command.js';

package/dist/setup-runtime.js

@@ -1,4 +1,5 @@
-import { loadKtxProject, markKtxSetupStateStepComplete, } from '@ktx/context/project';
+import { loadKtxProject } from './context/project/project.js';
+import { markKtxSetupStateStepComplete } from './context/project/setup-config.js';
 import { ensureManagedLocalEmbeddingsDaemon, } from './managed-local-embeddings.js';
 import { ensureManagedPythonCommandRuntime, } from './managed-python-command.js';
 import { resolveProjectRuntimeRequirements, } from './runtime-requirements.js';

package/dist/setup-runtime.test.js

@@ -1,8 +1,8 @@
 import { mkdtemp, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { MANAGED_SENTENCE_TRANSFORMERS_BASE_URL } from '@ktx/context';
-import { buildDefaultKtxProjectConfig, readKtxSetupState } from '@ktx/context/project';
+import { buildDefaultKtxProjectConfig } from './context/project/config.js';
+import { readKtxSetupState } from './context/project/setup-config.js';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { runKtxSetupRuntimeStep } from './setup-runtime.js';
 function makeIo() {
@@ -79,7 +79,6 @@ describe('runKtxSetupRuntimeStep', () => {
             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 = {
             ...buildDefaultKtxProjectConfig(),
@@ -89,7 +88,7 @@ describe('runKtxSetupRuntimeStep', () => {
                     backend: 'sentence-transformers',
                     model: 'all-MiniLM-L6-v2',
                     dimensions: 384,
-                    sentenceTransformers: { base_url: MANAGED_SENTENCE_TRANSFORMERS_BASE_URL },
+                    sentenceTransformers: { base_url: '' },
                 },
             },
         };

package/dist/setup-sources-notion.test.js

@@ -1,7 +1,8 @@
 import { mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { initKtxProject, parseKtxProjectConfig, serializeKtxProjectConfig, } from '@ktx/context/project';
+import { initKtxProject } from './context/project/project.js';
+import { parseKtxProjectConfig, serializeKtxProjectConfig } from './context/project/config.js';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { runKtxSetupSourcesStep, } from './setup-sources.js';
 const notionMocks = vi.hoisted(() => ({
@@ -9,7 +10,7 @@ const notionMocks = vi.hoisted(() => ({
     retrieveBotUser: vi.fn(async () => ({ name: 'Docs Bot' })),
     retrievePage: vi.fn(async () => ({ id: 'page-1' })),
 }));
-vi.mock('@ktx/context/ingest', async (importOriginal) => {
+vi.mock('./context/ingest/adapters/notion/notion-client.js', async (importOriginal) => {
     const actual = await importOriginal();
     return {
         ...actual,
@@ -49,6 +50,7 @@ function prompts(values) {
     return {
         multiselect: vi.fn(async () => multiselectValues.shift() ?? []),
         select: vi.fn(async () => selectValues.shift() ?? 'back'),
+        autocomplete: vi.fn(async () => selectValues.shift() ?? 'back'),
         text: vi.fn(async () => ''),
         password: vi.fn(async () => undefined),
         cancel: vi.fn(),

package/dist/setup-sources.d.ts

@@ -1,5 +1,5 @@
-import { type DiscoveredMetabaseDatabase } from '@ktx/context/ingest';
-import { type KtxProjectConnectionConfig } from '@ktx/context/project';
+import { type DiscoveredMetabaseDatabase } from './context/ingest/adapters/metabase/mapping.js';
+import { type KtxProjectConnectionConfig } from './context/project/config.js';
 import type { KtxCliIo } from './cli-runtime.js';
 import { pickNotionRootPages } from './notion-page-picker.js';
 import { type KtxSetupPromptOption } from './setup-prompts.js';
@@ -56,6 +56,11 @@ export interface KtxSetupSourcesPromptAdapter {
         message: string;
         options: KtxSetupPromptOption[];
     }): Promise<string>;
+    autocomplete(options: {
+        message: string;
+        placeholder?: string;
+        options: KtxSetupPromptOption[];
+    }): Promise<string>;
     text(options: {
         message: string;
         placeholder?: string;
@@ -67,7 +72,7 @@ export interface KtxSetupSourcesPromptAdapter {
     cancel(message: string): void;
     log?(message: string): void;
 }
-export type SourceValidationResult = {
+type SourceValidationResult = {
     ok: true;
     detail?: string;
 } | {
@@ -103,3 +108,4 @@ export interface KtxSetupSourcesDeps {
     }) => Promise<number>;
 }
 export declare function runKtxSetupSourcesStep(args: KtxSetupSourcesArgs, io: KtxCliIo, deps?: KtxSetupSourcesDeps): Promise<KtxSetupSourcesResult>;
+export {};

package/dist/setup-sources.js

@@ -2,15 +2,27 @@ import { mkdtemp, readdir, readFile, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join, relative, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { localConnectionTypeForConfig, resolveNotionConnectionAuthToken, } from '@ktx/context/connections';
-import { resolveKtxConfigReference } from '@ktx/context/core';
-import { cloneOrPull, DEFAULT_METABASE_CLIENT_CONFIG, discoverMetabaseDatabases, loadDbtSchemaFiles, loadProjectInfo, MetabaseClient, NotionClient, parseLookmlStagedDir, parseMetricflowFiles, testRepoConnection, } from '@ktx/context/ingest';
-import { loadKtxProject, markKtxSetupStateStepComplete, serializeKtxProjectConfig, } from '@ktx/context/project';
+import { localConnectionTypeForConfig } from './context/connections/local-warehouse-descriptor.js';
+import { resolveNotionConnectionAuthToken } from './context/connections/notion-config.js';
+import { resolveKtxConfigReference } from './context/core/config-reference.js';
+import { cloneOrPull, testRepoConnection } from './context/ingest/repo-fetch.js';
+import { DEFAULT_METABASE_CLIENT_CONFIG, MetabaseClient } from './context/ingest/adapters/metabase/client.js';
+import { discoverMetabaseDatabases } from './context/ingest/adapters/metabase/mapping.js';
+import { loadDbtSchemaFiles } from './context/ingest/dbt-shared/schema-files.js';
+import { loadProjectInfo } from './context/ingest/dbt-shared/project-vars.js';
+import { NotionClient } from './context/ingest/adapters/notion/notion-client.js';
+import { parseLookmlStagedDir } from './context/ingest/adapters/lookml/parse.js';
+import { parseMetricflowFiles } from './context/ingest/adapters/metricflow/deep-parse.js';
+import { serializeKtxProjectConfig } from './context/project/config.js';
+import { loadKtxProject } from './context/project/project.js';
+import { markKtxSetupStateStepComplete } from './context/project/setup-config.js';
 import { pickNotionRootPages } from './notion-page-picker.js';
 import { runKtxSourceMapping } from './source-mapping.js';
 import { withMultiselectNavigation, withTextInputNavigation } from './prompt-navigation.js';
 import { runKtxPublicIngest } from './public-ingest.js';
 import { writeProjectLocalSecretReference } from './setup-secrets.js';
+import { isDemoConnection } from './telemetry/demo-detect.js';
+import { emitTelemetryEvent } from './telemetry/index.js';
 import { createKtxSetupPromptAdapter, } from './setup-prompts.js';
 const DEFAULT_NOTION_MAX_KNOWLEDGE_CREATES_PER_RUN = 25;
 const SOURCE_OPTIONS = [
@@ -196,7 +208,7 @@ async function writeProjectConfig(projectDir, config) {
     const project = await loadKtxProject({ projectDir });
     await writeFile(project.configPath, serializeKtxProjectConfig(config), 'utf-8');
 }
-async function writeSourceConnection(projectDir, connectionId, connection, adapter) {
+async function writeSourceConnection(projectDir, connectionId, connection, adapter, io) {
     assertSafeConnectionId(connectionId);
     const project = await loadKtxProject({ projectDir });
     const previousConnection = project.config.connections[connectionId];
@@ -216,6 +228,17 @@ async function writeSourceConnection(projectDir, connectionId, connection, adapt
         },
     };
     await writeFile(project.configPath, serializeKtxProjectConfig(config), 'utf-8');
+    if (io) {
+        await emitTelemetryEvent({
+            name: 'connection_added',
+            projectDir,
+            io,
+            fields: {
+                driver: String(connection.driver ?? adapter).toLowerCase(),
+                isDemoConnection: isDemoConnection(connectionId, connection),
+            },
+        });
+    }
     return async () => {
         const latest = await loadKtxProject({ projectDir });
         const connections = { ...latest.config.connections };
@@ -693,8 +716,9 @@ async function chooseMetabaseDatabaseId(input) {
                 return discovered[0].id;
             }
             if (discovered.length > 1) {
-                const selected = await input.prompts.select({
+                const selected = await input.prompts.autocomplete({
                     message: 'Metabase database',
+                    placeholder: 'Type to search databases',
                     options: [
                         ...discovered
                             .slice()
@@ -1395,7 +1419,7 @@ async function saveValidateAndMaybeBuildSource(input) {
         : buildConnection(input.source, input.sourceChoice.args);
     const rollback = input.sourceChoice.kind === 'existing'
         ? undefined
-        : await writeSourceConnection(input.args.projectDir, connectionId, connection, sourceAdapter(input.source));
+        : await writeSourceConnection(input.args.projectDir, connectionId, connection, sourceAdapter(input.source), input.io);
     if (input.sourceChoice.kind === 'existing') {
         await ensureSourceAdapterEnabled(input.args.projectDir, input.source);
     }

package/dist/setup-sources.test.js

@@ -1,7 +1,9 @@
 import { mkdir, mkdtemp, readFile, rm, writeFile } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
-import { initKtxProject, parseKtxProjectConfig, readKtxSetupState, serializeKtxProjectConfig, } from '@ktx/context/project';
+import { initKtxProject } from './context/project/project.js';
+import { parseKtxProjectConfig, serializeKtxProjectConfig } from './context/project/config.js';
+import { readKtxSetupState } from './context/project/setup-config.js';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { runKtxSetupSourcesStep, } from './setup-sources.js';
 function makeIo() {
@@ -33,6 +35,7 @@ function prompts(values) {
     return {
         multiselect: vi.fn(async () => multiselectValues.shift() ?? []),
         select: vi.fn(async () => selectValues.shift() ?? 'skip'),
+        autocomplete: vi.fn(async () => selectValues.shift() ?? 'skip'),
         text: vi.fn(async () => (textValues.length > 0 ? textValues.shift() : '')),
         password: vi.fn(async () => (passwordValues.length > 0 ? passwordValues.shift() : undefined)),
         cancel: vi.fn(),
@@ -59,6 +62,7 @@ describe('setup sources step', () => {
         await initKtxProject({ projectDir });
     });
     afterEach(async () => {
+        vi.unstubAllEnvs();
         await rm(tempDir, { recursive: true, force: true });
     });
     async function readConfig() {
@@ -121,6 +125,27 @@ describe('setup sources step', () => {
         expect((await readKtxSetupState(projectDir)).completed_steps).toContain('sources');
         expect(runInitialIngest).toHaveBeenCalledWith(projectDir, 'analytics_dbt', io.io, { inputMode: 'disabled' });
     });
+    it('emits debug telemetry when setup writes a source connection', async () => {
+        vi.stubEnv('KTX_TELEMETRY_DEBUG', '1');
+        vi.stubEnv('CI', '');
+        await addPrimarySource();
+        const io = makeIo();
+        const result = await runKtxSetupSourcesStep({
+            projectDir,
+            inputMode: 'disabled',
+            source: 'dbt',
+            sourceConnectionId: 'analytics_dbt',
+            sourcePath: '/repo/dbt',
+            sourceProjectName: 'analytics',
+            runInitialSourceIngest: false,
+            skipSources: false,
+        }, io.io, { validateDbt: vi.fn(async () => ({ ok: true, detail: 'project=analytics schemas=2' })) });
+        expect(result.status).toBe('ready');
+        expect(io.stderr()).toContain('"event":"connection_added"');
+        expect(io.stderr()).toContain('"driver":"dbt"');
+        expect(io.stderr()).toContain('"isDemoConnection":false');
+        expect(io.stderr()).not.toContain(projectDir);
+    });
     it('writes Metabase config and validates mapping through existing mapping path', async () => {
         await addPrimarySource();
         const validateMetabase = vi.fn(async () => ({ ok: true, detail: 'user=admin@example.com' }));
@@ -401,8 +426,9 @@ describe('setup sources step', () => {
                 ],
             });
             if (testCase.source === 'metabase') {
-                expect(testPrompts.select).toHaveBeenCalledWith({
+                expect(testPrompts.autocomplete).toHaveBeenCalledWith({
                     message: 'Metabase database',
+                    placeholder: 'Type to search databases',
                     options: [
                         { value: '1', label: '1: Finance (postgres)' },
                         { value: '2', label: '2: Analytics (postgres)' },

package/dist/setup.d.ts

@@ -1,4 +1,4 @@
-import type { KtxCliIo } from './cli-runtime.js';
+import { type KtxCliIo } from './cli-runtime.js';
 import { readManagedPythonRuntimeStatus } from './managed-python-runtime.js';
 import { type KtxAgentScope, type KtxAgentTarget, type KtxSetupAgentsDeps, runKtxSetupAgentsStep } from './setup-agents.js';
 import { type KtxSetupDatabaseDriver, type KtxSetupDatabasesDeps, runKtxSetupDatabasesStep } from './setup-databases.js';

package/dist/setup.js

@@ -1,8 +1,12 @@
 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';
+import { getLatestLocalIngestStatus } from './context/ingest/local-ingest.js';
+import { savedMemoryCountsForReport } from './context/ingest/reports.js';
+import { ktxLocalStateDbPath } from './context/project/local-state-db.js';
+import { loadKtxProject } from './context/project/project.js';
+import { readKtxSetupState } from './context/project/setup-config.js';
+import { getKtxCliPackageInfo } from './cli-runtime.js';
 import { formatSetupNextStepLines } from './next-steps.js';
 import { runtimeInstallPolicyFromFlags } from './managed-python-command.js';
 import { readManagedPythonRuntimeStatus } from './managed-python-runtime.js';
@@ -25,6 +29,27 @@ function createEntryMenuPromptAdapter() {
         cancelOnSelectCancel: false,
     });
 }
+function setupTelemetryOutcome(status) {
+    if (status === 'ready')
+        return 'completed';
+    if (status === 'skipped')
+        return 'skipped';
+    return 'abandoned';
+}
+async function recordSetupStep(input) {
+    const { emitTelemetryEvent } = await import('./telemetry/index.js');
+    await emitTelemetryEvent({
+        name: 'setup_step',
+        projectDir: input.projectDir,
+        io: input.io,
+        packageInfo: { ...getKtxCliPackageInfo(), version: input.cliVersion ?? getKtxCliPackageInfo().version },
+        fields: {
+            step: input.step,
+            outcome: setupTelemetryOutcome(input.status),
+            durationMs: Math.max(0, performance.now() - input.startedAt),
+        },
+    });
+}
 async function runKtxSetupEntryMenu(status, deps = {}) {
     const prompts = deps.prompts ?? createEntryMenuPromptAdapter();
     const options = status.project.ready
@@ -50,7 +75,17 @@ async function runKtxSetupEntryMenu(status, deps = {}) {
 }
 async function runKtxSetupDemoFromEntryMenu(args, io, deps) {
     const { runDemoTour } = await import('./setup-demo-tour.js');
-    return await runDemoTour({ inputMode: args.inputMode }, io, { agents: deps.agents });
+    const startedAt = performance.now();
+    const result = await runDemoTour({ inputMode: args.inputMode, cliVersion: args.cliVersion }, io, { agents: deps.agents });
+    await recordSetupStep({
+        projectDir: args.projectDir,
+        step: 'demo-tour',
+        status: result === 0 ? 'ready' : 'failed',
+        startedAt,
+        io,
+        cliVersion: args.cliVersion,
+    });
+    return result;
 }
 function embeddingsReady(status) {
     return (status.backend !== undefined &&
@@ -320,6 +355,7 @@ async function runKtxSetupInner(args, io, deps = {}) {
             }
         }
         const projectMode = entryAction === 'new-project' ? 'prompt-new' : args.mode;
+        const projectStepStartedAt = performance.now();
         projectResult = await runKtxSetupProjectStep({
             projectDir: args.projectDir,
             mode: projectMode,
@@ -327,6 +363,14 @@ async function runKtxSetupInner(args, io, deps = {}) {
             yes: args.yes,
             allowBack: canShowEntryMenu,
         }, io, deps.project);
+        await recordSetupStep({
+            projectDir: projectResult.projectDir,
+            step: 'project',
+            status: projectResult.status,
+            startedAt: projectStepStartedAt,
+            io,
+            cliVersion: args.cliVersion,
+        });
         if (projectResult.status === 'back') {
             continue;
         }
@@ -391,6 +435,7 @@ async function runKtxSetupInner(args, io, deps = {}) {
             const step = setupSteps[stepIndex];
             if (!step)
                 break;
+            const stepStartedAt = performance.now();
             let stepResult;
             if (step === 'models') {
                 const modelRunner = deps.model ?? ((modelArgs, modelIo) => runKtxSetupAnthropicModelStep(modelArgs, modelIo, deps.modelDeps));
@@ -519,6 +564,14 @@ async function runKtxSetupInner(args, io, deps = {}) {
                     agentNextActions = agentResult.nextActions;
                 }
             }
+            await recordSetupStep({
+                projectDir: projectResult.projectDir,
+                step,
+                status: stepResult.status,
+                startedAt: stepStartedAt,
+                io,
+                cliVersion: args.cliVersion,
+            });
             if (stepResult.status === 'failed') {
                 await cleanupCreatedProjectScaffold(projectResult.createdProjectCleanup);
                 return 1;

package/dist/setup.test.js

@@ -3,7 +3,7 @@ import { mkdir, mkdtemp, readFile, readdir, rm, stat, writeFile } from 'node:fs/
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { promisify } from 'node:util';
-import { writeKtxSetupState } from '@ktx/context/project';
+import { writeKtxSetupState } from './context/project/setup-config.js';
 import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
 import { localFakeBundleReport, persistLocalBundleReport } from './ingest.test-utils.js';
 import { contextBuildCommands, writeKtxSetupContextState } from './setup-context.js';
@@ -19,6 +19,7 @@ function makeIo() {
     return {
         io: {
             stdout: {
+                isTTY: false,
                 write: (chunk) => {
                     stdout += chunk;
                 },
@@ -74,6 +75,7 @@ describe('setup status', () => {
         tempDir = await mkdtemp(join(tmpdir(), 'ktx-setup-status-'));
     });
     afterEach(async () => {
+        vi.unstubAllEnvs();
         await rm(tempDir, { recursive: true, force: true });
     });
     it('reports a missing project without creating files', async () => {
@@ -261,7 +263,7 @@ describe('setup status', () => {
             reportIds: [],
             artifactPaths: [],
             retryableFailedTargets: [],
-            commands: contextBuildCommands(tempDir, 'setup-context-local-abc123'),
+            commands: contextBuildCommands(tempDir),
             failureReason: 'Previous foreground context build did not finish. Rerun setup or ktx ingest.',
         });
         await expect(readKtxSetupStatus(tempDir)).resolves.toMatchObject({
@@ -408,7 +410,7 @@ describe('setup status', () => {
                     reportIds: [],
                     artifactPaths: [],
                     retryableFailedTargets: [],
-                    commands: contextBuildCommands(tempDir, 'setup-context-local-test'),
+                    commands: contextBuildCommands(tempDir),
                 });
                 await writeKtxSetupState(tempDir, { completed_steps: ['project', 'context'] });
                 return { status: 'ready', projectDir: tempDir, runId: 'setup-context-local-test' };
@@ -427,6 +429,34 @@ describe('setup status', () => {
         expect(output).toContain(`ktx mcp start --project-dir ${tempDir}`);
         expect(output).not.toContain('Finish agent setup');
     });
+    it('emits debug telemetry for setup steps without project paths', async () => {
+        vi.stubEnv('KTX_TELEMETRY_DEBUG', '1');
+        vi.stubEnv('CI', '');
+        const testIo = makeIo();
+        testIo.io.stdout.isTTY = true;
+        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,
+            skipDatabases: true,
+            skipSources: true,
+            databaseSchemas: [],
+        }, testIo.io, {
+            runtime: async () => runtimeReady(tempDir),
+            context: async () => ({ status: 'ready', projectDir: tempDir, runId: 'setup-context-local-test' }),
+        })).resolves.toBe(0);
+        expect(testIo.stderr()).toContain('"event":"setup_step"');
+        expect(testIo.stderr()).toContain('"step":"project"');
+        expect(testIo.stderr()).toContain('"step":"models"');
+        expect(testIo.stderr()).not.toContain(tempDir);
+    });
     it('prints the setup shell intro for auto-created run mode', async () => {
         const testIo = makeIo();
         await expect(runKtxSetup({
@@ -825,7 +855,7 @@ describe('setup status', () => {
             skipSources: false,
             showEntryMenu: true,
         }, testIo.io, { entryMenuDeps: { prompts: { select: vi.fn(async () => 'demo'), cancel: vi.fn() } } })).resolves.toBe(0);
-        expect(runDemoTour).toHaveBeenCalledWith({ inputMode: 'auto' }, testIo.io, expect.objectContaining({}));
+        expect(runDemoTour).toHaveBeenCalledWith({ inputMode: 'auto', cliVersion: '0.2.0' }, testIo.io, expect.objectContaining({}));
     });
     it('creates a project through run mode when --yes is selected', async () => {
         const testIo = makeIo();
@@ -1086,6 +1116,7 @@ describe('setup status', () => {
         const embeddings = vi.fn(async () => embeddingResults.shift() ?? { status: 'back', projectDir: tempDir });
         const databasePrompts = {
             multiselect: vi.fn(async () => ['back']),
+            autocompleteMultiselect: vi.fn(async () => ['back']),
             select: vi.fn(async () => 'back'),
             text: vi.fn(),
             password: vi.fn(),
@@ -1586,7 +1617,7 @@ describe('setup status', () => {
             reportIds: [],
             artifactPaths: [],
             retryableFailedTargets: [],
-            commands: contextBuildCommands(tempDir, 'setup-context-local-ready'),
+            commands: contextBuildCommands(tempDir),
         });
         const previousRuntimeRoot = process.env.KTX_RUNTIME_ROOT;
         process.env.KTX_RUNTIME_ROOT = await writeReadyRuntime(tempDir);
@@ -1680,7 +1711,7 @@ describe('setup status', () => {
             reportIds: [],
             artifactPaths: [],
             retryableFailedTargets: [],
-            commands: contextBuildCommands(tempDir, 'setup-context-local-ready'),
+            commands: contextBuildCommands(tempDir),
         });
         const readyMenuSelect = vi.fn();
         await expect(runKtxSetup({