ktx/examples
Andrey Avtomonov a0d3ddbbc2 chore: standardize daemon naming on "KTX daemon"
Replace inconsistent names ("KTX Python daemon", "KTX local embeddings
daemon", "KTX managed daemon", "Python daemon") with the single name
"KTX daemon" in CLI output, errors, command descriptions, test
assertions, smoke scripts, docs, AGENTS.md, issue templates, and
codecov flags. The daemon is a portable compute server with endpoints
for SQL analysis, semantic layer, LookML, database introspection, and
embeddings; the previous labels misrepresented it as embeddings-only or
exposed implementation details ("Python", "managed").

The "KTX Python runtime" concept (installed interpreter + packages) is
deliberately left as-is — it is a separate concept from the daemon
process.
2026-05-20 11:10:27 +02:00
..
local-warehouse fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
orbit-relationship-verification fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
package-artifacts chore: standardize daemon naming on "KTX daemon" 2026-05-20 11:10:27 +02:00
postgres-historic feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
README.md chore: standardize daemon naming on "KTX daemon" 2026-05-20 11:10:27 +02:00

ktx examples

local-warehouse

local-warehouse/ is a contributor fixture for local CLI smoke tests. It uses the internal fake ingest adapter so tests can exercise memory-flow behavior without a live database or external service.

For normal context building, use the public connection-centric commands:

ktx ingest <connectionId>
ktx ingest --all

The copied project initializes its own Git repository on first use.

orbit-relationship-verification

orbit-relationship-verification/ is a checked-in KTX project used by pnpm run relationships:verify-orbit. It points the orbit SQLite connection at the Orbit-style no-declared-constraint relationship fixture and verifies that relationship enrichment writes nine accepted joins without requiring a local warehouse credential.

postgres-historic

postgres-historic/ is a manual Docker-backed smoke for Postgres query-history ingest via pg_stat_statements. It verifies setup, staged query-history artifacts, KTX daemon batch SQL analysis, bounded pattern WorkUnit shards, and no-WorkUnit idempotency for unchanged bucketed table inputs and pattern shards.

package-artifacts

package-artifacts/ documents the artifact smoke checks. Those checks create temporary projects instead of storing sample projects in this directory.