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.
This commit is contained in:
Andrey Avtomonov 2026-06-11 13:49:45 +02:00 committed by GitHub
parent 005c5fc860
commit 00cdf2de90
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
237 changed files with 844 additions and 974 deletions

View file

@ -1,6 +1,6 @@
# ktx-daemon
`ktx-daemon` is the portable Python compute package for KTX.
`ktx-daemon` is the portable Python compute package for **ktx**.
It supports portable compute in two modes:
@ -99,6 +99,6 @@ Code execution is off by default. When enabled, it runs Python `exec` in the
daemon process with the same in-process boundary as the one-shot
`code-execute` command and does not provide OS-level sandboxing.
HTTP code execution uses the standalone KTX boundary. It does not forward
HTTP code execution uses the standalone **ktx** boundary. It does not forward
caller authorization headers to a host app and does not connect scratchpad or
visualization helpers to host application APIs.

View file

@ -1,7 +1,7 @@
[project]
name = "ktx-daemon"
version = "0.11.0"
description = "Portable compute package for KTX semantic-layer operations"
description = "Portable compute package for ktx semantic-layer operations"
readme = "README.md"
requires-python = ">=3.13"
license = "Apache-2.0"

View file

@ -1,4 +1,4 @@
"""Portable compute package for KTX."""
"""Portable compute package for ktx."""
from collections.abc import Callable
from importlib.metadata import PackageNotFoundError, version

View file

@ -1,4 +1,4 @@
"""Command entry point for one-shot KTX daemon compute operations."""
"""Command entry point for one-shot ktx daemon compute operations."""
from __future__ import annotations
@ -67,7 +67,7 @@ def build_parser() -> argparse.ArgumentParser:
)
serve_http = subcommands.add_parser(
"serve-http",
help="Run the KTX daemon portable compute HTTP server",
help="Run the ktx daemon portable compute HTTP server",
)
serve_http.add_argument("--host", default="127.0.0.1")
serve_http.add_argument("--port", type=int, default=8765)

View file

@ -1,4 +1,4 @@
"""FastAPI app factory for the KTX daemon semantic compute server."""
"""FastAPI app factory for the ktx daemon semantic compute server."""
from __future__ import annotations
@ -142,8 +142,8 @@ def create_app(
)
app = FastAPI(
title="KTX Daemon",
description="Stateless portable compute server for KTX.",
title="ktx Daemon",
description="Stateless portable compute server for ktx.",
version=VERSION,
lifespan=lifespan,
)

View file

@ -1,4 +1,4 @@
"""Portable in-process code execution helpers for KTX daemon.
"""Portable in-process code execution helpers for ktx daemon.
This module preserves the host application's current Python execution behavior.
It runs code with Python ``exec`` in the current process and does not provide

View file

@ -1,4 +1,4 @@
"""Portable database introspection helpers for KTX daemon."""
"""Portable database introspection helpers for ktx daemon."""
from __future__ import annotations

View file

@ -1,4 +1,4 @@
"""Portable embedding compute helpers for KTX daemon."""
"""Portable embedding compute helpers for ktx daemon."""
from __future__ import annotations

View file

@ -1,4 +1,4 @@
"""Semantic-layer compute helpers for the KTX daemon package."""
"""Semantic-layer compute helpers for the ktx daemon package."""
from __future__ import annotations