refactor: remove legacy compatibility shims (#208)

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

@@ -369,7 +369,7 @@ ingest:
   llm:
     backend: anthropic
 `),
-    ).toThrow('Unsupported ingest.llm: use top-level llm.provider, llm.models, and ingest.workUnits');
+    ).toThrow('Unsupported ingest.llm: unknown field');
 
     expect(() =>
       parseKtxProjectConfig(`
@@ -377,7 +377,7 @@ scan:
   enrichment:
     backend: gateway
 `),
-    ).toThrow('Unsupported scan.enrichment.backend: use scan.enrichment.mode');
+    ).toThrow('Unsupported scan.enrichment.backend: unknown field');
 
     expect(() =>
       parseKtxProjectConfig(`
@@ -387,7 +387,7 @@ scan:
     llm:
       backend: gateway
 `),
-    ).toThrow('Unsupported scan.enrichment.llm: use top-level llm.provider and llm.models');
+    ).toThrow('Unsupported scan.enrichment.llm: unknown field');
 
     expect(() =>
       parseKtxProjectConfig(`
@@ -478,28 +478,6 @@ scan:
     );
   });
 
-  it('attaches migration hints for known deprecated keys', () => {
-    const result = validateKtxProjectConfig(`
-ingest:
-  llm:
-    backend: anthropic
-scan:
-  enrichment:
-    backend: none
-`);
-
-    expect(result.ok).toBe(false);
-    const findIssue = (path: string) => result.issues.find((issue) => issue.path === path);
-    expect(findIssue('ingest.llm')).toMatchObject({
-      message: 'Unsupported ingest.llm: use top-level llm.provider, llm.models, and ingest.workUnits',
-      fix: 'use top-level llm.provider, llm.models, and ingest.workUnits',
-    });
-    expect(findIssue('scan.enrichment.backend')).toMatchObject({
-      message: 'Unsupported scan.enrichment.backend: use scan.enrichment.mode',
-      fix: 'use scan.enrichment.mode',
-    });
-  });
-
   it('reports YAML parse errors as a root-level issue', () => {
     const result = validateKtxProjectConfig(': not valid yaml :\n');
     expect(result.ok).toBe(false);

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

@@ -11,15 +11,6 @@ const KTX_WORK_UNIT_FAILURE_MODES = ['abort', 'continue'] as const;
 const KTX_STORAGE_STATES = ['sqlite', 'postgres'] as const;
 const KTX_SEARCH_BACKENDS = ['sqlite-fts5', 'postgres-hybrid'] as const;
 
-const DEPRECATED_KEY_HINTS: Record<string, string> = {
-  'llm.provider.provider': 'use llm.provider.backend',
-  'ingest.llm': 'use top-level llm.provider, llm.models, and ingest.workUnits',
-  'ingest.embeddings.provider': 'use ingest.embeddings.backend',
-  'scan.enrichment.backend': 'use scan.enrichment.mode',
-  'scan.enrichment.llm': 'use top-level llm.provider and llm.models',
-  'scan.enrichment.embeddings.provider': 'use scan.enrichment.embeddings.backend',
-};
-
 const apiCredentialsSchema = z
   .strictObject({
     api_key: z.string().min(1).optional().describe('API key for the provider. Read from this value or the provider-specific environment variable.'),
@@ -189,12 +180,7 @@ const setupSchema = z
       .array(z.string().min(1))
       .default([])
       .describe('Connection IDs (keys of the top-level `connections` map) that the setup wizard treats as the project\'s primary databases.'),
-    completed_steps: z
-      .unknown()
-      .optional()
-      .describe('Deprecated. Accepted for backward compatibility but ignored; KTX no longer tracks setup progress here.'),
   })
-  .transform(({ database_connection_ids }) => ({ database_connection_ids }))
   .describe('Setup-wizard state captured during `ktx setup`.');
 
 const storageGitSchema = z
@@ -309,10 +295,6 @@ function formatIssue(issue: z.core.$ZodIssue, input: unknown): KtxConfigIssue[]
     const keys = (issue as { keys?: readonly string[] }).keys ?? [];
     return keys.map((key) => {
       const fullPath = basePath.length > 0 ? `${basePath}.${key}` : key;
-      const hint = DEPRECATED_KEY_HINTS[fullPath];
-      if (hint !== undefined) {
-        return { path: fullPath, message: `Unsupported ${fullPath}: ${hint}`, fix: hint };
-      }
       return { path: fullPath, message: `Unsupported ${fullPath}: unknown field` };
     });
   }

packages/cli/src/context/project/driver-schemas.test.ts

@@ -19,12 +19,12 @@ describe('connectionConfigSchema (driver discriminated union)', () => {
     const parsed = connectionConfigSchema.parse({
       driver: 'postgres',
       url: 'postgres://x',
-      historicSql: { enabled: true },
+      customField: { enabled: true },
       context: { queryHistory: { enabled: false } },
     });
     expect(parsed).toMatchObject({
       driver: 'postgres',
-      historicSql: { enabled: true },
+      customField: { enabled: true },
       context: { queryHistory: { enabled: false } },
     });
   });

packages/cli/src/context/project/driver-schemas.ts

@@ -35,7 +35,7 @@ function warehouseConnectionSchema<const Driver extends WarehouseDriver>(driver:
         ),
     })
     .describe(
-      `${driver} warehouse connection. Additional driver-tunable fields (e.g. historicSql, context.queryHistory) are accepted and passed through.`,
+      `${driver} warehouse connection. Additional driver-tunable fields (e.g. context.queryHistory) are accepted and passed through.`,
     );
 }