b3be54e3fa
* 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.
|
||
|---|---|---|
| .. | ||
| local-warehouse | ||
| orbit-relationship-verification | ||
| package-artifacts | ||
| postgres-historic | ||
| README.md | ||
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, managed 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.