Ktx releases

0.8.0 (2026-06-01)

⚠ BREAKING CHANGES

• cli: remove fast mode; ktx ingest always builds enriched context (KLO-721) (#237)

Features

• cli: profile ingest runs and split model vs tool time (#249) (21744fc)
• cli: remove fast mode; ktx ingest always builds enriched context (KLO-721) (#237) (3f0d11e)
• cli: shell completion for commands, flags, and entity names (#244) (d320d54), closes #243
• README architecture diagrams + React Flow diagram studio (#245) (ba5bb92)
• report MCP client telemetry (#242) (2e5f7f2)
• telemetry: enable PostHog GeoIP enrichment (#243) (95a2653)
• trim MCP query response payloads (#240) (25f639f)

Bug Fixes

• brand: README lockup wordmark in Outfit to match docs-site (#246) (1959f49)
• cli: align Notion setup credential to --source-auth-token-ref (#236) (637891f)
• cli: treat artifact-producing ingests with failures as partial (#238) (53a6f8d)
• release: point repository URLs at renamed GitHub repo (#250) (41f5279)

Documentation

• ktx skill: harden setup guidance from agent-driven demo run (#247) (5faa16b)
• readme: add launch video to README hero (#248) (22ddf55)

Continuous Integration

• normalize star-history.svg trailing newline (#241) (cbbcf8e), closes #240
• push star-history refresh to protected main with RELEASE_PAT (#239) (ba06f70)
• refresh README star history chart twice daily (08d08d8)
• stop tombi reformatting uv.lock and sync lock to 0.7.0 (#235) (8ebc4ce)

Other Changes

• refresh star history chart [skip ci] (c196d1f)
• refresh star history chart [skip ci] (2058c26)
• refresh star history chart [skip ci] (54d6e87)
• upgrade dependencies and tooling (#232) (d53cdac)

0.1.0 (2026-05-19)

⚠ BREAKING CHANGES

• cli: remove ktx agent command (#58)

Features

• add claude-code llm backend with runtime port (#115) (b565e44)
• add daemon sql batch analysis (ffbbaf4)
• add historic sql aggregate readers (25952e4)
• add historic sql bucket helpers (6a291a1)
• add historic sql evidence emission (ef9358b)
• add historic sql evidence skills (9544262)
• add historic sql redaction helper (7b38418)
• add historic sql skill schemas (c2b24df)
• add historic sql unified contracts (55140d1)
• add sql analysis batch port (f4021da)
• allow generic historic sql readers locally (5d72c1f)
• carry historic sql usage in semantic sources (f170530)
• chunk historic sql unified staging (7549872)
• cli: add box-drawing prefixes to remaining setup stdout messages (07ac71e)
• cli: add box-drawing prefixes to setup informational messages (f091f94)
• cli: add demo guided tour module with rendering, keypress, and replay (3677193)
• cli: add edit flow for setup connections (#77) (9ecb8cb)
• cli: add intro step and project dir to demo tour (262276d)
• cli: add ktx dev schema to emit ktx.yaml JSON Schema (#93) (2bca308)
• cli: add print-command-tree build-time script (fda3d4b)
• cli: add read-only sql command (#126) (33a142f)
• cli: add reliable runtime stop --all (#30) (36c3f93)
• cli: add runDemoTour orchestrator and wire into setup entry menu (8cb6324)
• cli: add text ingest command (#72) (d1b5936)
• cli: add walkCommandTree and formatCommandTree helpers (f205bec)
• cli: clean up command surface (e15a4eb)
• cli: clean up dev command surface (#57) (b9e0a74)
• cli: clean up wiki and sl commands (#65) (c202202)
• cli: enforce required database selection and improve tree-picker UX (#86) (6c4623f)
• cli: extend ktx connection test to every supported driver (#92) (c7c5f63)
• cli: formalize dev-friendly result output (b95cb9b)
• cli: friendly missing-project status and per-project daemon state (#87) (e28b104)
• cli: hide table counts from primary source connection test output (a2096dd)
• cli: improve search ranking output (#123) (74be832)
• cli: improve setup progress UX (#69) (754e4a9)
• cli: migrate all setup steps to use local state for completion tracking (dbfee6b)
• cli: offer connection URL paste first in database setup (d567ffe)
• cli: prefix text-input continuation lines with box-drawing characters (509f9f5)
• cli: print resolved project dir (0ff14e1)
• cli: redesign ktx status output UX (#80) (ed690ef)
• cli: redesign Notion page picker UI and add skip-empty flow (#78) (f219ba2)
• cli: remove ktx agent command (#58) (721f1a9)
• cli: render command docs as tree (39f0320)
• cli: replace fake demo data with real NBC/Orbit project context (ebf475e)
• cli: route ingest adapter logs through operational logger (d7fb092)
• cli: split Claude Desktop skills and polish setup-agents output (#141) (56f4f9c)
• cli: tree-picker UI for database scope selection (#81) (dabd640)
• cli: unify wiki and sl search output with clack-style box and score badge (#89) (77cce79)
• context: add driver-discriminated connection schemas (#96) (f8db998)
• context: add local .ktx/setup/state.json for setup completion tracking (f702711)
• context: add warehouse verification tools (#46) (c22248d)
• cut over historic sql adapter (b3ebba9)
• docs-site: add "by Kaelio" attribution and enlarge nav logo (#110) (beeeda4)
• docs-site: add agent-readable docs routes (dfa4651)
• docs-site: refresh nav mascot with SVG and bump size (#101) (d431fbf)
• docs: add CodeBlock with three context-aware modes (3a3dfee)
• docs: add CopyButton component (7607e9f)
• docs: add Fumadocs site workspace (572d515)
• docs: collapse sidebar sections by default (399bad0)
• docs: polish introduction page (f693adf)
• docs: style Mode A (terminal) code blocks (86fc6aa)
• docs: style Mode B (filename tab) and Mode C (minimal) (c54b5ca)
• docs: typographic sidebar with active rail (0049a47)
• docs: visualize KTX ingestion with ReactFlow diagram (#133) (7d156d9)
• docs: wire CodeBlock into MDX components map (cc033f1)
• emit historic sql pattern shard work units (3e11e33)
• expose sl search usage snippets (d9acdc8)
• hydrate sl search usage metadata (cd12757)
• index historic sql usage in sl search text (19585e6)
• ingest: default local ingest to isolated diffs (#128) (e64da5a)
• llm: add local AI SDK DevTools tracing (e7418fd)
• merge ingest and scan (b00c1a1)
• npm-managed Python runtime for @kaelio/ktx (#7) (9dad936)
• preserve historic sql usage in manifest shards (c45d131)
• project historic sql evidence (fb541cb)
• redact historic sql staged artifacts (0616345)
• rename historic sql setup threshold (c91331b)
• rename project wiki directory (#66) (d7147f9)
• return sl search snippets (633f935)
• run historic sql deterministic projection (da263c0)
• setup: add Claude Desktop target and MCP-first agent setup (#114) (e6d578c)
• shard historic sql pattern inputs (2a91ea5)
• stage historic sql aggregate snapshots (93752d5)
• wire historic sql readers for bigquery and snowflake (98a475d)
• write historic sql pattern shards (02b621b)

Bug Fixes

• accept ingest wiki forward refs (#125) (f49672b)
• align KTX agent tools and repair handling (#73) (28b5e2a)
• align release provenance metadata (b582321)
• allow agent setup without context (#139) (b42f418)
• allow dbt ingest to discover warehouse schemas (#20) (9d3b101)
• ci: align smoke stderr expectations (6a1fded)
• ci: update artifact source test (5277c81)
• ci: update stale KTX test expectations (#32) (4c93a6e)
• clean up ktx yaml config parameters (#75) (1a472cf)
• cli: add star headline to demo completion summary per spec (04e9f96)
• cli: auto-install runtime during setup (#116) (a72fca2)
• cli: build runtime assets during dev setup (#121) (de72a10)
• cli: clarify historic SQL ingest progress (#36) (f422fac)
• cli: clean up connection commands (#62) (e1e9c4a)
• cli: clean up dev runtime commands (#59) (eaaabb3)
• cli: correct demo completion summary counts to match manifest (76f7275)
• cli: harden managed runtime install (#16) (ff3e0ed)
• cli: hide setup project banner (e50fef8)
• cli: honor configured llm backends in setup (02e096a)
• cli: keep ingest progress off stdout (9409d50)
• cli: keep ktx setup alive when a dbt git clone fails (#88) (52dd894)
• cli: match command tree description separator (e8a7018)
• cli: preserve tree continuation guides (5e057f9)
• cli: remove ktx setup subcommands (#42) (17a2fee)
• cli: remove redundant "already" from configured sources label (#83) (6d7d905)
• cli: remove redundant path resolution hints from project setup (52d1c90)
• cli: replace duplicate directory prompt with direct path options (bdca6d0)
• cli: replace KLO logo with KTX (80c2930)
• cli: report metabase ingest readiness (e05a6d4)
• cli: retry daemon health before startup failure (#17) (f013e00)
• cli: route plain ingest progress to stderr (dc0e33d)
• cli: scale nested scan progress phases (#35) (e1129dd)
• cli: show project dir in context build step (#67) (e353425)
• cli: slow demo replay animation to half speed (~6.8s total) (c75871b)
• cli: support Metabase connection tests (#21) (106ce16)
• cli: surface historic sql ingest progress (#18) (df2eeaa)
• context: avoid saving scan error descriptions (#37) (4d4441c)
• context: make ingest adapter logging explicit (9e80add)
• context: merge overlay columns onto manifest columns by name (#94) (cb8902f), closes #103
• docs-site: add docs index redirect, test, and trim Accept media type (b4a302e)
• docs-site: reset code block prose styles (81c7e60)
• docs-site: return explicit markdown route 404 (838cf84)
• docs: replace broken page copy buttons with working single button (#132) (6a60977)
• docs: restore search overlay behavior (#134) (611f830)
• docs: tighten sidebar selectors + add focus-visible (ea2d002)
• guide dev ingest llm setup (#15) (a2dcd4e)
• improve ingest runtime readiness (#124) (c89af77)
• improve setup wizard behavior (#127) (d1c84e5)
• keep historic sql archived patterns stable (c2b2356)
• link Conductor agent overlays from root checkout (69128cc)
• llm: wire prompt caching through all Anthropic call sites (#90) (49f1e27)
• make pgss max advisory informational (77baa1f)
• normalize historic sql probe results (1b1b32d)
• prevent stable release pushes to main (#145) (03e2f9f)
• publish first stable release as 0.1.0 (#143) (7110aa6)
• release: repair next npm release workflow (#122) (d3d58a2)
• remove project from ktx config (#95) (ce23aca)
• show setup destination paths (#63) (d4d8ad1)
• standardize KTX environment variables (d5f484e)
• stop requiring readonly connection config (#71) (3fde443)
• store Metabase mappings in ktx.yaml (#61) (b755762)
• write canonical historic sql setup filters (9fb98e3)

Performance Improvements

• cli: cache pnpm run ktx builds against a stamp file (#113) (f9532f5)
• parallelize scan description generation (366933c)
• setup: speed up conductor setup and make it rerun-safe (#107) (2de4dd2)

Documentation

• add agent setup prompt endpoint (#142) (e80bfbf)
• add cli command tree implementation plan (7b52ff9)
• add Codecov badge (#85) (339bc39)
• add context layer diagram (#102) (d244261)
• add demo guided tour design spec (6e2a6b7)
• add demo guided tour implementation plan (e52713c)
• add ingestion flow diagram to readme (#144) (afcfecf)
• add README agent setup prompt (b4c77c0)
• add title attributes to config code blocks (cb9ab25)
• agents: instruct agents to update docs-site after code changes (#99) (a9c7c15)
• align readme quickstart (#138) (eb41d08)
• clarify getting started introduction (#120) (c7e6b50)
• design agent-friendly docs site (8fdf578)
• docs-site: add agent notes across docs (f3f8aa6)
• docs-site: add AI resources for agents (966627a)
• docs-site: make core guides agent-friendly (9580bd2)
• docs-site: normalize CLI references for agents (885072d)
• docs-site: separate docs-agent resources (f1909b4)
• docs-site: update AI resource URLs and nav order (e79caa8)
• explain historic sql pattern shards (56b20c4)
• merge community contributing pages (#119) (cf3674c)
• move LLM configuration guide last (#117) (6862883)
• plan agent-friendly docs site (b440c75)
• plans: add historic-sql cross-dialect readiness plan (83b6fd5)
• plans: add historic-sql docs/smoke/config-cleanup plan (fc1fdb6)
• plans: add historic-sql end-to-end retrieval acceptance plan (f8312cf)
• plans: add historic-sql foundations plan (d73a54e)
• plans: add historic-sql pattern shard smoke/docs plan (fed5e6f)
• plans: add historic-sql pattern workunit sharding plan (1ba7be8)
• plans: add historic-sql projection archive hardening plan (2006165)
• plans: add historic-sql redaction hardening plan (cb55a0d)
• plans: add historic-sql search enrichment plan (a146550)
• plans: add historic-sql skills/projection/cutover plan (f99f853)
• plans: add historic-sql unified hot-path plan (3ada460)
• refresh historic sql setup and smoke docs (78e88a6)
• refresh KTX demo readiness guidance (085f68b)
• refresh setup and install guidance (1b552a3)
• remove section overview pages (#130) (d60d83e)
• remove stale benchmarks section (37150c0)
• replace README logo with KTX lockup (69e5466)
• revamp quickstart and tighten code-block styling (#135) (b507ff1)
• revamp resource and integration sections (#104) (17653e2)
• standardize env variable examples (d830e8c)
• tighten context layer concepts (a0193b3)
• tighten guide copy (#131) (c539433)

Code Refactoring

• cli: centralize Clack prompt handling (4236548)
• cli: extract buildKtxProgram for reuse outside runCommanderKtxCli (cdcfd21)
• cli: hide internal setup options and remove dead flags (#79) (c2750dd)
• cli: remove dead demo dep from KtxSetupDeps (6943f17)
• cli: remove interactive gcloud auth from Vertex AI setup (ea33e51)
• cli: remove stale setup context detach state (#109) (703cbd9)
• cli: remove Vertex AI auth step and add gcloud retry (#84) (5b4ba73)
• cli: rename demo menu option to "Explore a pre-built KTX project" (6629d69)
• cli: unify output formatting across commands (#111) (50ffebd)
• context: validate ktx.yaml with Zod and surface issues in status (#91) (b3be54e)
• remove legacy compatibility paths (#64) (97da991)
• remove legacy historic sql pipeline (d47826a)
• remove legacy historic sql reader fetch surface (109dd8d)

Tests

• align historic sql pattern skill with shards (8deac9d)
• assert historic sql pattern shard smoke (a223f53)
• assert unified postgres historic sql smoke (b03eb27)
• cli: cover output channel invariants (c35297b)
• cover historic sql projection cleanup (e39aea7)
• cover historic sql retrieval acceptance (9c615fc)
• expect historic sql pattern shard smoke docs (1947527)
• expect unified historic sql example docs (598149b)
• expose historic sql pattern shard path (dab7bfb)
• verify historic sql docs and smoke cleanup (81ec2ee)
• verify historic sql pattern shard work units (2d1efda)
• verify historic sql sharded smoke docs (ca325cd)
• verify historic sql unified hot path (80fffcd)

Continuous Integration

• add codecov coverage reporting (#82) (0a261fe)
• parallelize KTX CI checks (3e98693)
• run pre-commit checks in CI (#74) (fa92379)

Other Changes

• add TypeScript dead-code checks (#60) (bcb0d2f)
• cli: add docs:commands pnpm script (d4ce275)
• configure docs site deployment (2acaf04)
• deps: refresh workspace dependencies (#43) (85fc408)
• ignore devtools artifacts (22e1706)
• move docs site workspace (a46563b)
• move docs site workspace (#11) (5a4d878)
• remove private planning docs (#140) (86afff5)
• standardize pre-commit checks (52400c5)