ktx/examples/orbit-relationship-verification
Andrey Avtomonov b3be54e3fa
refactor(context): validate ktx.yaml with Zod and surface issues in status (#91)
* refactor(context): validate ktx.yaml with Zod and surface issues in status

- Replace hand-rolled ktx.yaml parsing with a strict Zod schema and
  derive KtxProjectConfig types from it.
- Add validateKtxProjectConfig returning structured KtxConfigIssue[]
  with migration hints for deprecated keys (ingest.llm,
  scan.enrichment.backend, etc.).
- Wire ktx status/doctor to run validation, render schema issues in
  plain and JSON output, and add a Config row to project status.
- Update the orbit example to camelCase scan.relationships keys to
  match the schema.

* fix(context): tolerate legacy setup.completed_steps and optional driver

- Accept and drop the legacy setup.completed_steps field so existing
  ktx.yaml files migrated from older versions still load.
- Make connections.<id>.driver optional in the schema; runtime code
  already produces a clear "no driver" error at use time.

* feat(cli): add ktx status --validate to run only ktx.yaml schema validation

- New --validate flag dispatches a focused runKtxDoctor 'validate' branch
  that reads ktx.yaml, runs validateKtxProjectConfig, and skips LLM,
  connection, embedding, and query-history checks.
- Plain output prints a single Config row; JSON output emits
  {ok: true} on success or the existing invalid_config / missing_project
  shapes on failure.
2026-05-14 15:36:35 +02:00
..
ktx.yaml refactor(context): validate ktx.yaml with Zod and surface issues in status (#91) 2026-05-14 15:36:35 +02:00
README.md fix: standardize KTX environment variables 2026-05-12 11:21:37 +02:00

Orbit-style relationship discovery verification

This KTX project backs the default relationships:verify-orbit command. It uses the checked-in Orbit-style SQLite fixture from the relationship discovery benchmark corpus, with no declared primary keys or foreign keys in the database schema.

Run from the KTX workspace root:

pnpm run relationships:verify-orbit

Expected relationship summary:

Accepted: 9
Review: 0
Rejected: 0
Skipped: 0

The command refreshes:

examples/orbit-relationship-verification/reports/orbit-verification.md

Use a real local Orbit project by overriding the project directory:

KTX_PROJECT_DIR=/path/to/orbit-project pnpm run relationships:verify-orbit