fix: store Metabase mappings in ktx.yaml (#61)

* fix: store Metabase mappings in ktx.yaml

* docs: note KTX has no public users

* refactor: drop setup progress compatibility

packages/context/src/project/config.test.ts

@@ -81,16 +81,13 @@ describe('KTX project config', () => {
     });
   });
 
-  it('parses and serializes setup wizard metadata', () => {
+  it('parses and serializes setup warehouse metadata without setup progress', () => {
     const config = parseKtxProjectConfig(`
 project: revenue
 setup:
   database_connection_ids:
     - warehouse
     - analytics
-  completed_steps:
-    - project
-    - llm
 connections:
   warehouse:
     driver: postgres
@@ -99,13 +96,12 @@ connections:
 
     expect(config.setup).toEqual({
       database_connection_ids: ['warehouse', 'analytics'],
-      completed_steps: ['project', 'llm'],
     });
 
     const serialized = serializeKtxProjectConfig(config);
     expect(serialized).toContain('setup:');
     expect(serialized).toContain('database_connection_ids:');
-    expect(serialized).toContain('completed_steps:');
+    expect(serialized).not.toContain('completed_steps:');
   });
 
   it('parses global direct Anthropic LLM config', () => {

packages/context/src/project/config.ts

@@ -75,7 +75,6 @@ export interface KtxProjectConnectionConfig {
 
 export interface KtxProjectSetupConfig {
   database_connection_ids: string[];
-  completed_steps?: string[];
 }
 
 export interface KtxProjectConfig {
@@ -508,7 +507,6 @@ export function parseKtxProjectConfig(raw: string): KtxProjectConfig {
       ? {
           setup: {
             database_connection_ids: stringArray(setup.database_connection_ids, []),
-            completed_steps: stringArray(setup.completed_steps, []),
           },
         }
       : {}),

packages/context/src/project/index.ts

@@ -27,12 +27,10 @@ export { initKtxProject, loadKtxProject } from './project.js';
 export type { KtxSetupStep } from './setup-config.js';
 export {
   KTX_SETUP_STEPS,
-  ktxSetupCompletedSteps,
   ktxSetupStatePath,
   markKtxSetupStateStepComplete,
   mergeKtxSetupGitignoreEntries,
   readKtxSetupState,
   setKtxSetupDatabaseConnectionIds,
-  stripKtxSetupCompletedSteps,
   writeKtxSetupState,
 } from './setup-config.js';

packages/context/src/project/setup-config.test.ts

@@ -4,12 +4,10 @@ import { join } from 'node:path';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
 import { buildDefaultKtxProjectConfig } from './config.js';
 import {
-  ktxSetupCompletedSteps,
   markKtxSetupStateStepComplete,
   mergeKtxSetupGitignoreEntries,
   readKtxSetupState,
   setKtxSetupDatabaseConnectionIds,
-  stripKtxSetupCompletedSteps,
 } from './setup-config.js';
 
 describe('KTX setup config helpers', () => {
@@ -48,36 +46,6 @@ describe('KTX setup config helpers', () => {
     expect(config.setup).toBeUndefined();
   });
 
-  it('strips setup completed steps while preserving database connection ids', () => {
-    const config = {
-      ...buildDefaultKtxProjectConfig('warehouse'),
-      setup: {
-        database_connection_ids: ['warehouse'],
-        completed_steps: ['project', 'databases'],
-      },
-    };
-
-    expect(stripKtxSetupCompletedSteps(config).setup).toEqual({
-      database_connection_ids: ['warehouse'],
-    });
-  });
-
-  it('combines legacy config setup steps with local state for reads', () => {
-    const config = {
-      ...buildDefaultKtxProjectConfig('warehouse'),
-      setup: {
-        database_connection_ids: ['warehouse'],
-        completed_steps: ['project', 'databases'],
-      },
-    };
-
-    expect(ktxSetupCompletedSteps(config, { completed_steps: ['databases', 'sources'] })).toEqual([
-      'project',
-      'databases',
-      'sources',
-    ]);
-  });
-
   it('merges setup-local gitignore entries without removing existing lines', () => {
     expect(mergeKtxSetupGitignoreEntries('cache/\ndb.sqlite\n')).toBe(
       ['cache/', 'db.sqlite', 'db.sqlite-*', 'ingest-transcripts/', 'secrets/', 'setup/', 'agents/', ''].join('\n'),

packages/context/src/project/setup-config.ts

@@ -64,27 +64,6 @@ export async function markKtxSetupStateStepComplete(projectDir: string, step: Kt
   return nextState;
 }
 
-export function ktxSetupCompletedSteps(config: KtxProjectConfig, state: KtxSetupState): KtxSetupStep[] {
-  return uniqueSetupSteps([...(config.setup?.completed_steps ?? []), ...state.completed_steps]);
-}
-
-export function stripKtxSetupCompletedSteps(config: KtxProjectConfig): KtxProjectConfig {
-  if (!config.setup) {
-    return config;
-  }
-  const databaseConnectionIds = config.setup.database_connection_ids ?? [];
-  if (databaseConnectionIds.length === 0) {
-    const { setup: _setup, ...withoutSetup } = config;
-    return withoutSetup;
-  }
-  return {
-    ...config,
-    setup: {
-      database_connection_ids: [...databaseConnectionIds],
-    },
-  };
-}
-
 export function setKtxSetupDatabaseConnectionIds(
   config: KtxProjectConfig,
   connectionIds: string[],
@@ -95,7 +74,6 @@ export function setKtxSetupDatabaseConnectionIds(
     ...config,
     setup: {
       database_connection_ids: uniqueConnectionIds,
-      ...(config.setup?.completed_steps ? { completed_steps: [...config.setup.completed_steps] } : {}),
     },
   };
 }