ktx/examples
Andrey Avtomonov 2877b85adc
fix(cli): isolate ktx-owned project repositories (#283)
* fix(cli): isolate ktx project git repos

* fix(cli): remove inert auto commit config

* test(cli): drop stale auto commit fixtures

* docs: document isolated ktx project repos

* test(cli): keep stale config grep clean

* fix(cli): guide setup away from foreign repos at the project dir

ktx owns the git repo rooted at the project dir and refuses to adopt one it
did not create (the Finding 3 isolation invariant). But setup steered users
straight into that failure: the interactive menu offers "Current directory"
first, and `--no-input --yes --project-dir <repo-root>` created directly in
place — both then threw a generic "Failed to initialize git repository:"
wrapper from deep in GitService.initialize().

Extract the ownership rule into a shared `classifyKtxRepoOwnership(dir)` used by
both GitService.initialize() (the invariant) and the setup wizard (pre-flight
guidance), so the decision derives from one rule. Setup now detects a foreign
repo before constructing GitService and: interactively re-prompts (the user
picks the existing `ktx-project` subfolder), or non-interactively returns a
clean missing-input with the actionable message. The typed foreign-repo error
is also surfaced verbatim instead of being buried under the generic wrapper.

Empty/non-repo current directories still work — only foreign repos are blocked.

* fix(cli): keep classifyKtxRepoOwnership total for non-directory paths

The setup ownership guard runs before the existing not-a-directory check, so
pointing a custom/--project-dir path at a file made classifyKtxRepoOwnership
lstat `<file>/.git`, hit ENOTDIR, and throw — crashing the setup step instead
of returning the friendly "path exists and is not a directory" result.

A path that is a file (or missing) holds no git repo for ktx to avoid, so treat
ENOTDIR like ENOENT and return 'unowned'. The downstream existingFolderState
check still rejects a non-directory with its friendly message, and the
classifier no longer throws raw errno for any caller.
2026-06-10 14:12:25 +02:00
..
local-warehouse fix(cli): isolate ktx-owned project repositories (#283) 2026-06-10 14:12:25 +02:00
orbit-relationship-verification fix(cli): isolate ktx-owned project repositories (#283) 2026-06-10 14:12:25 +02:00
package-artifacts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
postgres-historic chore(workspace): gate dead-code with knip production mode (#196) 2026-05-21 15:28:58 +02:00
README.md refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +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.