refactor(cli): delete internal barrel index.ts files

The 34 `index.ts` re-export barrels inside `packages/cli/src/` were
holdovers from the pre-fold multi-workspace structure. Post-fold-in they
served no production purpose: external consumers go through the single
package main entry, and in-repo callers mostly imported through them
only because the path was short. Internally, knip flagged most barrel
re-exports as production-dead (only reached via tests).

This change:
- Deletes every internal barrel except `packages/cli/src/index.ts`
  (the published package entry).
- Rewrites ~270 source/test files to import each name directly from
  the file that defines it.
- Moves `tools/warehouse-verification/index.ts` to
  `create-warehouse-verification-tools.ts` (the function it defined
  locally) and updates its single consumer.
- Renames `search/backend-conformance.ts` → `.test-utils.ts` to match
  the existing test-helper file convention.
- Deletes 13 dead test-only chains (dbt-descriptions/*,
  live-database/extracted-schema, live-database/structural-sync,
  relationship-* feedback/review chain) plus their tests and a
  cascading orphan integration test.
- Updates test mocks that pointed at deleted barrel paths
  (notion-client, connector barrels in scan/local-scan-connectors
  tests) to mock the source files instead.
- Points the maintainer benchmark script
  (`scripts/relationship-benchmark-report.mjs`) at source files
  instead of `dist/context/scan/index.js`.
- Drops the barrel `!` entries from `knip.json`; adds explicit
  production entries only for the benchmark code reached via dist by
  the maintainer script.

Net: 413 files changed, ~1.2k insertions, ~9.4k deletions.

`pnpm run dead-code` (Biome + knip default + knip production) and
`pnpm run type-check` are clean; 2277 tests pass.

packages/cli/src/connectors/bigquery/connector.test.ts

@@ -1,15 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import {
-  bigQueryConnectionConfigFromConfig,
-  createBigQueryLiveDatabaseIntrospection,
-  isKtxBigQueryConnectionConfig,
-  type KtxBigQueryClient,
-  KtxBigQueryScanConnector,
-  type KtxBigQueryClientFactory,
-  type KtxBigQueryDataset,
-  type KtxBigQueryQueryJob,
-  type KtxBigQueryTableRef,
-} from './index.js';
+import { bigQueryConnectionConfigFromConfig, isKtxBigQueryConnectionConfig, type KtxBigQueryClient, KtxBigQueryScanConnector, type KtxBigQueryClientFactory, type KtxBigQueryDataset, type KtxBigQueryQueryJob, type KtxBigQueryTableRef } from '../../connectors/bigquery/connector.js';
+import { createBigQueryLiveDatabaseIntrospection } from '../../connectors/bigquery/live-database-introspection.js';
 
 function fakeClientFactory(): KtxBigQueryClientFactory {
   const queryResults = vi.fn(async (): ReturnType<KtxBigQueryQueryJob['getQueryResults']> => [

packages/cli/src/connectors/bigquery/connector.ts

@@ -1,24 +1,6 @@
 import { BigQuery, type TableField } from '@google-cloud/bigquery';
-import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableListEntry,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableListEntry, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
@@ -57,12 +39,14 @@ export interface KtxBigQueryColumnDistinctValuesResult {
   cardinality: number;
 }
 
+/** @internal */
 export interface KtxBigQueryQueryJob {
   getQueryResults(): Promise<
     [Array<Record<string, unknown>>, unknown, { schema?: { fields?: TableField[] } }?, ...unknown[]]
   >;
 }
 
+/** @internal */
 export interface KtxBigQueryTableRef {
   id?: string;
   metadata?: { type?: string };
@@ -81,6 +65,7 @@ export interface KtxBigQueryTableRef {
   >;
 }
 
+/** @internal */
 export interface KtxBigQueryDataset {
   get(): Promise<unknown>;
   getTables(): Promise<[KtxBigQueryTableRef[], ...unknown[]]>;
@@ -223,6 +208,7 @@ export function isKtxBigQueryConnectionConfig(
   return String(connection?.driver ?? '').toLowerCase() === 'bigquery';
 }
 
+/** @internal */
 export function bigQueryConnectionConfigFromConfig(input: {
   connectionId: string;
   connection: KtxBigQueryConnectionConfig | undefined;

packages/cli/src/connectors/bigquery/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type BigQueryTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/bigquery/index.ts

@@ -1,18 +0,0 @@
-export { KtxBigQueryDialect } from './dialect.js';
-export {
-  bigQueryConnectionConfigFromConfig,
-  isKtxBigQueryConnectionConfig,
-  KtxBigQueryScanConnector,
-  type KtxBigQueryClient,
-  type KtxBigQueryClientFactory,
-  type KtxBigQueryColumnDistinctValuesOptions,
-  type KtxBigQueryColumnDistinctValuesResult,
-  type KtxBigQueryConnectionConfig,
-  type KtxBigQueryDataset,
-  type KtxBigQueryQueryJob,
-  type KtxBigQueryReadOnlyQueryInput,
-  type KtxBigQueryResolvedConnectionConfig,
-  type KtxBigQueryScanConnectorOptions,
-  type KtxBigQueryTableRef,
-} from './connector.js';
-export { createBigQueryLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/bigquery/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxBigQueryScanConnector,
   type KtxBigQueryClientFactory,

packages/cli/src/connectors/clickhouse/connector.test.ts

@@ -1,11 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import {
-  clickHouseClientConfigFromConfig,
-  createClickHouseLiveDatabaseIntrospection,
-  isKtxClickHouseConnectionConfig,
-  KtxClickHouseScanConnector,
-  type KtxClickHouseClientFactory,
-} from './index.js';
+import { clickHouseClientConfigFromConfig, isKtxClickHouseConnectionConfig, KtxClickHouseScanConnector, type KtxClickHouseClientFactory } from '../../connectors/clickhouse/connector.js';
+import { createClickHouseLiveDatabaseIntrospection } from '../../connectors/clickhouse/live-database-introspection.js';
 
 function result<T>(payload: T) {
   return {

packages/cli/src/connectors/clickhouse/connector.ts

@@ -1,24 +1,6 @@
 import { createClient } from '@clickhouse/client';
-import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableListEntry,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableRef, type KtxTableSampleInput, type KtxTableListEntry, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { readFileSync } from 'node:fs';
 import { Agent as HttpsAgent } from 'node:https';
 import { homedir } from 'node:os';
@@ -198,6 +180,7 @@ export function isKtxClickHouseConnectionConfig(
   return String(connection?.driver ?? '').toLowerCase() === 'clickhouse';
 }
 
+/** @internal */
 export function clickHouseClientConfigFromConfig(input: {
   connectionId: string;
   connection: KtxClickHouseConnectionConfig | undefined;

packages/cli/src/connectors/clickhouse/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type ClickHouseTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/clickhouse/index.ts

@@ -1,16 +0,0 @@
-export { KtxClickHouseDialect } from './dialect.js';
-export {
-  clickHouseClientConfigFromConfig,
-  isKtxClickHouseConnectionConfig,
-  KtxClickHouseScanConnector,
-  type KtxClickHouseClient,
-  type KtxClickHouseClientFactory,
-  type KtxClickHouseColumnDistinctValuesOptions,
-  type KtxClickHouseColumnDistinctValuesResult,
-  type KtxClickHouseConnectionConfig,
-  type KtxClickHouseEndpointResolver,
-  type KtxClickHouseReadOnlyQueryInput,
-  type KtxClickHouseResolvedClientConfig,
-  type KtxClickHouseScanConnectorOptions,
-} from './connector.js';
-export { createClickHouseLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/clickhouse/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxClickHouseScanConnector,
   type KtxClickHouseClientFactory,

packages/cli/src/connectors/mysql/connector.test.ts

@@ -1,12 +1,7 @@
 import { describe, expect, it, vi } from 'vitest';
 import type { FieldPacket, RowDataPacket } from 'mysql2/promise';
-import {
-  createMysqlLiveDatabaseIntrospection,
-  isKtxMysqlConnectionConfig,
-  KtxMysqlScanConnector,
-  mysqlConnectionPoolConfigFromConfig,
-  type KtxMysqlPoolFactory,
-} from './index.js';
+import { createMysqlLiveDatabaseIntrospection } from '../../connectors/mysql/live-database-introspection.js';
+import { isKtxMysqlConnectionConfig, KtxMysqlScanConnector, mysqlConnectionPoolConfigFromConfig, type KtxMysqlPoolFactory } from '../../connectors/mysql/connector.js';
 
 function mysqlResult(rows: Record<string, unknown>[], fields: Array<{ name: string; type?: number }>): [RowDataPacket[], FieldPacket[]] {
   return [rows as RowDataPacket[], fields as FieldPacket[]];

packages/cli/src/connectors/mysql/connector.ts

@@ -2,27 +2,8 @@ import mysql, { type FieldPacket, type Pool, type RowDataPacket } from 'mysql2/p
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
-import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxTableListEntry,
-  type KtxSchemaForeignKey,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxTableListEntry, type KtxSchemaForeignKey, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { KtxMysqlDialect } from './dialect.js';
 
 export interface KtxMysqlConnectionConfig {
@@ -237,6 +218,7 @@ export function isKtxMysqlConnectionConfig(
   return String(connection?.driver ?? '').toLowerCase() === 'mysql';
 }
 
+/** @internal */
 export function mysqlConnectionPoolConfigFromConfig(input: {
   connectionId: string;
   connection: KtxMysqlConnectionConfig | undefined;

packages/cli/src/connectors/mysql/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type MysqlTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/mysql/index.ts

@@ -1,15 +0,0 @@
-export { KtxMysqlDialect } from './dialect.js';
-export {
-  isKtxMysqlConnectionConfig,
-  KtxMysqlScanConnector,
-  mysqlConnectionPoolConfigFromConfig,
-  type KtxMysqlColumnDistinctValuesOptions,
-  type KtxMysqlColumnDistinctValuesResult,
-  type KtxMysqlConnectionConfig,
-  type KtxMysqlEndpointResolver,
-  type KtxMysqlPoolConfig,
-  type KtxMysqlPoolFactory,
-  type KtxMysqlReadOnlyQueryInput,
-  type KtxMysqlScanConnectorOptions,
-} from './connector.js';
-export { createMysqlLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/mysql/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxMysqlScanConnector,
   type KtxMysqlConnectionConfig,

packages/cli/src/connectors/postgres/connector.test.ts

@@ -1,11 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import {
-  createPostgresLiveDatabaseIntrospection,
-  isKtxPostgresConnectionConfig,
-  KtxPostgresScanConnector,
-  postgresPoolConfigFromConfig,
-  type KtxPostgresPoolFactory,
-} from './index.js';
+import { createPostgresLiveDatabaseIntrospection } from '../../connectors/postgres/live-database-introspection.js';
+import { isKtxPostgresConnectionConfig, KtxPostgresScanConnector, postgresPoolConfigFromConfig, type KtxPostgresPoolFactory } from '../../connectors/postgres/connector.js';
 
 interface FakeQueryResult {
   rows: Record<string, unknown>[];

packages/cli/src/connectors/postgres/connector.ts

@@ -1,27 +1,8 @@
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
-import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxSchemaForeignKey,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableListEntry,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxSchemaForeignKey, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableListEntry, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { Pool } from 'pg';
 import { KtxPostgresDialect } from './dialect.js';
 
@@ -297,6 +278,7 @@ export function isKtxPostgresConnectionConfig(
   return driver === 'postgres' || driver === 'postgresql';
 }
 
+/** @internal */
 export function postgresPoolConfigFromConfig(input: {
   connectionId: string;
   connection: KtxPostgresConnectionConfig | undefined;

packages/cli/src/connectors/postgres/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type PostgresTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/postgres/historic-sql-query-client.ts

@@ -1,4 +1,4 @@
-import type { KtxPostgresQueryClient } from '../../context/ingest/index.js';
+import type { KtxPostgresQueryClient } from '../../context/ingest/adapters/historic-sql/types.js';
 import { KtxPostgresScanConnector, type KtxPostgresScanConnectorOptions } from './connector.js';
 
 export type KtxPostgresHistoricSqlQueryClientOptions = KtxPostgresScanConnectorOptions;

packages/cli/src/connectors/postgres/index.ts

@@ -1,21 +0,0 @@
-export { KtxPostgresDialect } from './dialect.js';
-export {
-  isKtxPostgresConnectionConfig,
-  KtxPostgresScanConnector,
-  postgresPoolConfigFromConfig,
-  type KtxPostgresColumnDistinctValuesOptions,
-  type KtxPostgresColumnDistinctValuesResult,
-  type KtxPostgresColumnStatisticsResult,
-  type KtxPostgresConnectionConfig,
-  type KtxPostgresEndpointResolver,
-  type KtxPostgresPoolConfig,
-  type KtxPostgresPoolFactory,
-  type KtxPostgresReadOnlyQueryInput,
-  type KtxPostgresScanConnectorOptions,
-  type KtxPostgresTableSampleResult,
-} from './connector.js';
-export {
-  KtxPostgresHistoricSqlQueryClient,
-  type KtxPostgresHistoricSqlQueryClientOptions,
-} from './historic-sql-query-client.js';
-export { createPostgresLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/postgres/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxPostgresScanConnector,
   type KtxPostgresConnectionConfig,

packages/cli/src/connectors/snowflake/connector.test.ts

@@ -1,12 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import {
-  createSnowflakeLiveDatabaseIntrospection,
-  isKtxSnowflakeConnectionConfig,
-  KtxSnowflakeScanConnector,
-  snowflakeConnectionConfigFromConfig,
-  type KtxSnowflakeDriver,
-  type KtxSnowflakeDriverFactory,
-} from './index.js';
+import { createSnowflakeLiveDatabaseIntrospection } from '../../connectors/snowflake/live-database-introspection.js';
+import { isKtxSnowflakeConnectionConfig, KtxSnowflakeScanConnector, snowflakeConnectionConfigFromConfig, type KtxSnowflakeDriver, type KtxSnowflakeDriverFactory } from '../../connectors/snowflake/connector.js';
 
 function fakeDriverFactory(): KtxSnowflakeDriverFactory {
   const driver: KtxSnowflakeDriver = {

packages/cli/src/connectors/snowflake/connector.ts

@@ -2,26 +2,8 @@ import { createPrivateKey } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
-import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableListEntry,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableRef, type KtxTableSampleInput, type KtxTableListEntry, type KtxTableSampleResult } from '../../context/scan/types.js';
 import * as snowflake from 'snowflake-sdk';
 import { KtxSnowflakeDialect } from './dialect.js';
 
@@ -196,6 +178,7 @@ export function isKtxSnowflakeConnectionConfig(
   return String(connection?.driver ?? '').toLowerCase() === 'snowflake';
 }
 
+/** @internal */
 export function snowflakeConnectionConfigFromConfig(input: {
   connectionId: string;
   connection: KtxSnowflakeConnectionConfig | undefined;

packages/cli/src/connectors/snowflake/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type SnowflakeTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/snowflake/index.ts

@@ -1,18 +0,0 @@
-export { KtxSnowflakeDialect } from './dialect.js';
-export {
-  isKtxSnowflakeConnectionConfig,
-  KtxSnowflakeScanConnector,
-  snowflakeConnectionConfigFromConfig,
-  type KtxSnowflakeColumnDistinctValuesOptions,
-  type KtxSnowflakeColumnDistinctValuesResult,
-  type KtxSnowflakeConnectionConfig,
-  type KtxSnowflakeDriver,
-  type KtxSnowflakeDriverFactory,
-  type KtxSnowflakeRawColumnMetadata,
-  type KtxSnowflakeRawTableMetadata,
-  type KtxSnowflakeReadOnlyQueryInput,
-  type KtxSnowflakeResolvedConnectionConfig,
-  type KtxSnowflakeScanConnectorOptions,
-  type KtxSnowflakeSdkOptionsProvider,
-} from './connector.js';
-export { createSnowflakeLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/snowflake/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxSnowflakeScanConnector,
   type KtxSnowflakeConnectionConfig,

packages/cli/src/connectors/sqlite/connector.test.ts

@@ -4,12 +4,8 @@ import { mkdtemp, rm } from 'node:fs/promises';
 import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { afterEach, beforeEach, describe, expect, it } from 'vitest';
-import {
-  createSqliteLiveDatabaseIntrospection,
-  isKtxSqliteConnectionConfig,
-  KtxSqliteScanConnector,
-  sqliteDatabasePathFromConfig,
-} from './index.js';
+import { createSqliteLiveDatabaseIntrospection } from '../../connectors/sqlite/live-database-introspection.js';
+import { isKtxSqliteConnectionConfig, KtxSqliteScanConnector, sqliteDatabasePathFromConfig } from '../../connectors/sqlite/connector.js';
 
 describe('KtxSqliteScanConnector', () => {
   let tempDir: string;

packages/cli/src/connectors/sqlite/connector.ts

@@ -3,25 +3,9 @@ import { existsSync, readFileSync, statSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { isAbsolute, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { assertReadOnlySql, limitSqlForExecution, normalizeQueryRows } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaForeignKey,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql, limitSqlForExecution } from '../../context/connections/read-only-sql.js';
+import { normalizeQueryRows } from '../../context/connections/query-executor.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaForeignKey, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { KtxSqliteDialect } from './dialect.js';
 
 export interface KtxSqliteConnectionConfig {
@@ -31,6 +15,7 @@ export interface KtxSqliteConnectionConfig {
   [key: string]: unknown;
 }
 
+/** @internal */
 export interface SqliteDatabasePathInput {
   connectionId: string;
   projectDir?: string;
@@ -142,6 +127,7 @@ export function isKtxSqliteConnectionConfig(
   return driver === 'sqlite' || driver === 'sqlite3';
 }
 
+/** @internal */
 export function sqliteDatabasePathFromConfig(input: SqliteDatabasePathInput): string {
   const inputDriver = input.connection?.driver ?? 'unknown';
   if (!isKtxSqliteConnectionConfig(input.connection)) {

packages/cli/src/connectors/sqlite/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type SqliteTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/sqlite/index.ts

@@ -1,16 +0,0 @@
-export { KtxSqliteDialect } from './dialect.js';
-export {
-  isKtxSqliteConnectionConfig,
-  KtxSqliteScanConnector,
-  sqliteDatabasePathFromConfig,
-  type KtxSqliteColumnDistinctValuesOptions,
-  type KtxSqliteColumnDistinctValuesResult,
-  type KtxSqliteConnectionConfig,
-  type KtxSqliteReadOnlyQueryInput,
-  type KtxSqliteScanConnectorOptions,
-  type SqliteDatabasePathInput,
-} from './connector.js';
-export {
-  createSqliteLiveDatabaseIntrospection,
-  type CreateSqliteLiveDatabaseIntrospectionOptions,
-} from './live-database-introspection.js';

packages/cli/src/connectors/sqlite/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import { KtxSqliteScanConnector, type KtxSqliteConnectionConfig } from './connector.js';
 
 export interface CreateSqliteLiveDatabaseIntrospectionOptions {

packages/cli/src/connectors/sqlserver/connector.test.ts

@@ -1,12 +1,6 @@
 import { describe, expect, it, vi } from 'vitest';
-import {
-  createSqlServerLiveDatabaseIntrospection,
-  isKtxSqlServerConnectionConfig,
-  KtxSqlServerScanConnector,
-  sqlServerConnectionPoolConfigFromConfig,
-  type KtxSqlServerPoolFactory,
-  type KtxSqlServerQueryResult,
-} from './index.js';
+import { createSqlServerLiveDatabaseIntrospection } from '../../connectors/sqlserver/live-database-introspection.js';
+import { isKtxSqlServerConnectionConfig, KtxSqlServerScanConnector, sqlServerConnectionPoolConfigFromConfig, type KtxSqlServerPoolFactory, type KtxSqlServerQueryResult } from '../../connectors/sqlserver/connector.js';
 
 function recordset<T extends Record<string, unknown>>(
   rows: T[],

packages/cli/src/connectors/sqlserver/connector.ts

@@ -1,24 +1,5 @@
-import { assertReadOnlySql } from '../../context/connections/index.js';
-import {
-  createKtxConnectorCapabilities,
-  type KtxColumnSampleInput,
-  type KtxColumnSampleResult,
-  type KtxColumnStatsInput,
-  type KtxColumnStatsResult,
-  type KtxQueryResult,
-  type KtxReadOnlyQueryInput,
-  type KtxScanConnector,
-  type KtxScanContext,
-  type KtxScanInput,
-  type KtxSchemaColumn,
-  type KtxSchemaForeignKey,
-  type KtxSchemaSnapshot,
-  type KtxSchemaTable,
-  type KtxTableListEntry,
-  type KtxTableRef,
-  type KtxTableSampleInput,
-  type KtxTableSampleResult,
-} from '../../context/scan/index.js';
+import { assertReadOnlySql } from '../../context/connections/read-only-sql.js';
+import { createKtxConnectorCapabilities, type KtxColumnSampleInput, type KtxColumnSampleResult, type KtxColumnStatsInput, type KtxColumnStatsResult, type KtxQueryResult, type KtxReadOnlyQueryInput, type KtxScanConnector, type KtxScanContext, type KtxScanInput, type KtxSchemaColumn, type KtxSchemaForeignKey, type KtxSchemaSnapshot, type KtxSchemaTable, type KtxTableListEntry, type KtxTableRef, type KtxTableSampleInput, type KtxTableSampleResult } from '../../context/scan/types.js';
 import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { resolve } from 'node:path';
@@ -50,6 +31,7 @@ export interface KtxSqlServerPoolConfig {
   pool: { max: number; min: number; idleTimeoutMillis: number };
 }
 
+/** @internal */
 export interface KtxSqlServerQueryResult {
   recordset?: Array<Record<string, unknown>> & { columns?: Record<string, { type?: { declaration?: string } }> };
 }
@@ -239,6 +221,7 @@ export function isKtxSqlServerConnectionConfig(
   return String(connection?.driver ?? '').toLowerCase() === 'sqlserver';
 }
 
+/** @internal */
 export function sqlServerConnectionPoolConfigFromConfig(input: {
   connectionId: string;
   connection: KtxSqlServerConnectionConfig | undefined;

packages/cli/src/connectors/sqlserver/dialect.ts

@@ -1,4 +1,4 @@
-import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/index.js';
+import type { KtxSchemaDimensionType, KtxTableRef } from '../../context/scan/types.js';
 
 type SqlServerTableNameRef = Pick<KtxTableRef, 'name'> & Partial<Pick<KtxTableRef, 'catalog' | 'db'>>;
 

packages/cli/src/connectors/sqlserver/index.ts

@@ -1,17 +0,0 @@
-export { KtxSqlServerDialect } from './dialect.js';
-export {
-  isKtxSqlServerConnectionConfig,
-  KtxSqlServerScanConnector,
-  sqlServerConnectionPoolConfigFromConfig,
-  type KtxSqlServerColumnDistinctValuesOptions,
-  type KtxSqlServerColumnDistinctValuesResult,
-  type KtxSqlServerConnectionConfig,
-  type KtxSqlServerEndpointResolver,
-  type KtxSqlServerPool,
-  type KtxSqlServerPoolConfig,
-  type KtxSqlServerPoolFactory,
-  type KtxSqlServerQueryResult,
-  type KtxSqlServerReadOnlyQueryInput,
-  type KtxSqlServerScanConnectorOptions,
-} from './connector.js';
-export { createSqlServerLiveDatabaseIntrospection } from './live-database-introspection.js';

packages/cli/src/connectors/sqlserver/live-database-introspection.ts

@@ -1,5 +1,5 @@
-import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/index.js';
-import type { KtxProjectConnectionConfig } from '../../context/project/index.js';
+import type { LiveDatabaseIntrospectionPort } from '../../context/ingest/adapters/live-database/types.js';
+import type { KtxProjectConnectionConfig } from '../../context/project/config.js';
 import {
   KtxSqlServerScanConnector,
   type KtxSqlServerConnectionConfig,