mirror of
https://github.com/Kaelio/ktx.git
synced 2026-06-10 08:05:14 +02:00
a0d3ddbbc2
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.
37 lines
1.3 KiB
Markdown
37 lines
1.3 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
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.
|