refactor: enforce ktx naming and AGENTS.md compliance sweep (#289)

Align the tree with AGENTS.md/CLAUDE.md conventions:

- Rewrite user-facing strings, docs, and tests to lowercase `ktx`
  (no bare uppercase `KTX` tokens remain outside literal identifiers).
- Drop the legacy `historicSql` migration path and its now-unused
  helpers, per the no-backward-compat rule.
- Remove `as unknown as` / `any` casts: narrow `BaseTool` generics to
  `z.ZodObject`, add a typed `createLookerClient`, and delete the dead
  `getParametersSchema`/`toAnthropicFormat` pre-AI-SDK helpers.
- Use `InvalidArgumentError` for Commander parse failures.
- Finish the adapter→connector prose conversion in the `ktx.yaml` docs
  while keeping the literal `adapters` config key.

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

@@ -62,7 +62,7 @@ const llmSchema = z
     models: z
       .partialRecord(z.enum(KTX_MODEL_ROLES), z.string().min(1))
       .default({})
-      .describe('Per-role model overrides keyed by KTX model role (e.g. "default", "triage"). Values are provider-specific model identifiers.'),
+      .describe('Per-role model overrides keyed by ktx model role (e.g. "default", "triage"). Values are provider-specific model identifiers.'),
     promptCaching: promptCachingSchema.optional().describe('Optional prompt-caching tunables.'),
   })
   .describe('LLM provider, per-role model overrides, and prompt-caching tunables.');
@@ -243,14 +243,14 @@ const storageSchema = z
     state: z
       .enum(KTX_STORAGE_STATES)
       .default('sqlite')
-      .describe('Backend for KTX state storage. "sqlite" uses .ktx/db.sqlite; "postgres" expects a configured Postgres connection.'),
+      .describe('Backend for ktx state storage. "sqlite" uses .ktx/db.sqlite; "postgres" expects a configured Postgres connection.'),
     search: z
       .enum(KTX_SEARCH_BACKENDS)
       .default('sqlite-fts5')
       .describe('Backend for search indexes. "sqlite-fts5" uses SQLite FTS5; "postgres-hybrid" uses Postgres lexical + vector hybrid search.'),
     git: storageGitSchema.prefault({}).describe('Git-backed storage commit policy.'),
   })
-  .describe('Storage backends and commit policy for KTX state and search indexes.');
+  .describe('Storage backends and commit policy for ktx state and search indexes.');
 
 const connectionSchema = connectionConfigSchema;
 
@@ -282,13 +282,13 @@ const ktxProjectConfigSchema = z
       .record(z.string(), connectionSchema)
       .default({})
       .describe('Map of connection ID to connector configuration. Keys are user-chosen names referenced elsewhere in the config.'),
-    storage: storageSchema.prefault({}).describe('Storage backends and commit policy for KTX state and search indexes.'),
+    storage: storageSchema.prefault({}).describe('Storage backends and commit policy for ktx state and search indexes.'),
     llm: llmSchema.prefault({}).describe('LLM provider, per-role model overrides, and prompt-caching tunables.'),
     ingest: ingestSchema.prefault({}).describe('Ingest pipeline configuration.'),
     agent: agentSchema.prefault({}).describe('Agent feature configuration.'),
     scan: scanSchema.prefault({}).describe('Schema-scan configuration: enrichment and relationship discovery.'),
   })
-  .describe('Configuration schema for KTX project files (ktx.yaml).');
+  .describe('Configuration schema for ktx project files (ktx.yaml).');
 
 export type KtxProjectConfig = z.infer<typeof ktxProjectConfigSchema>;
 export type KtxProjectLlmConfig = z.infer<typeof llmSchema>;

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

@@ -102,7 +102,7 @@ const lookerConnectionSchema = z
       .min(1)
       .optional()
       .describe('Reference to Looker OAuth client secret (e.g. env:LOOKER_CLIENT_SECRET).'),
-    mappings: lookerMappingsSchema.optional().describe('Looker connection-name to KTX warehouse mappings.'),
+    mappings: lookerMappingsSchema.optional().describe('Looker connection-name to ktx warehouse mappings.'),
   })
   .describe('Looker context-source connection.');
 

packages/cli/src/context/project/mappings-yaml-schema.ts

@@ -15,7 +15,7 @@ export const metabaseMappingsSchema = z
     databaseMappings: z
       .record(z.string(), stringTargetSchema)
       .default({})
-      .describe('Map of Metabase database ID (positive integer string) to KTX connection ID. Use null to explicitly unmap.'),
+      .describe('Map of Metabase database ID (positive integer string) to ktx connection ID. Use null to explicitly unmap.'),
     syncEnabled: z
       .record(z.string(), z.boolean())
       .default({})
@@ -38,7 +38,7 @@ export const lookerMappingsSchema = z
     connectionMappings: z
       .record(z.string().min(1), stringTargetSchema)
       .default({})
-      .describe('Map of Looker connection name to KTX connection ID. Use null to explicitly unmap.'),
+      .describe('Map of Looker connection name to ktx connection ID. Use null to explicitly unmap.'),
   })
   .describe('Looker connection-to-warehouse mapping configuration.');
 

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

@@ -123,7 +123,7 @@ export async function initKtxProject(options: InitKtxProjectOptions): Promise<In
 
   const commit = await runtime.git.commitFiles(
     ['ktx.yaml', ...TRACKED_SCAFFOLD_FILES.map((file) => file.path)],
-    `Initialize KTX project: ${projectName}`,
+    `Initialize ktx project: ${projectName}`,
     authorName,
     authorEmail,
   );