ktx/packages/cli/src
Andrey Avtomonov 4ec5903aa5
feat(ingest): adapter-owned finalization replaces post-processor escape hatch (#136)
* Refine adapter-owned ingest finalization design after adversarial review iteration 1

* Refine adapter-owned ingest finalization design after adversarial review iteration 2

* Refine adapter-owned ingest finalization design after adversarial review iteration 3

* Implement adapter-owned ingest finalization v1

Moves finalization from runner-owned post-processors into typed
SourceAdapter.finalize() contracts. Adds finalization report schema,
scope derivation, override replay context, and migrates historic-SQL
projection. Removes IngestBundlePostProcessorPort wiring and
HistoricSqlProjectionPostProcessor.

* feat(ingest): export finalization adapter contract types

* test(ingest): exercise historic sql finalization locally

* docs(plans): add adapter-owned finalization v1 closure plan

* fix(setup): unblock clean Linux installs and add enabled_tables allowlist

- Pin managed Python runtime to 3.13 via `uv venv --python 3.13` so installs
  don't pick the system 3.12 on Ubuntu 24.04 and fail at wheel install.
- Sanitize NO_PROXY/no_proxy for the daemon child process — drop IPv6 CIDR
  entries that httpx rejects with InvalidURL (OrbStack injects these by
  default).
- Add `enabled_tables` allowlist on warehouse connections (zod schema +
  live-database introspection filter) to scope ingest to specific tables.
- Add `getting-started/troubleshooting-linux` docs page covering the Python
  3.13 prerequisite, IPv6 proxy gotcha, and a minimal working recipe; link
  it from the quickstart troubleshooting table and the llms-docs map.
- Make docs-site origin overridable via `KTX_DOCS_ORIGIN` so local builds
  can serve under host.docker.internal.

* Move docs changes to specs repo

* fix(cli): keep managed runtime python version private

* Deduplicate enabled tables filtering
2026-05-20 14:17:10 +02:00
..
commands refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
io feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
skills/analytics feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
admin-reindex.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
admin-reindex.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
admin.test.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
admin.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
bin.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
clack.ts fix: improve setup wizard behavior (#127) 2026-05-17 19:15:09 +02:00
claude-code-prompt-caching.ts feat: add claude-code llm backend with runtime port (#115) 2026-05-16 12:06:34 +02:00
cli-program.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
cli-program.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
cli-runtime.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
command-schemas.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
command-tree.test.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
command-tree.ts fix(cli): preserve tree continuation guides 2026-05-13 00:35:07 +02:00
connection.test.ts feat(context): add driver-discriminated connection schemas (#96) 2026-05-15 00:08:11 +02:00
connection.ts refactor(cli): unify output formatting across commands (#111) 2026-05-15 08:54:36 -04:00
context-build-view.test.ts fix(cli): auto-install runtime during setup (#116) 2026-05-16 11:39:43 +02:00
context-build-view.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
database-tree-picker.test.ts feat(cli): tree-picker UI for database scope selection (#81) 2026-05-13 18:41:44 -04:00
database-tree-picker.ts feat(cli): tree-picker UI for database scope selection (#81) 2026-05-13 18:41:44 -04:00
demo-assets.test.ts feat: rename project wiki directory (#66) 2026-05-13 16:05:58 +02:00
demo-assets.ts fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
demo-metrics.test.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
demo-metrics.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
doctor.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
doctor.ts Remove deleted CLI command remnants (#105) 2026-05-14 19:04:22 -04:00
example-smoke.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
index.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
index.ts feat(cli): add read-only sql command (#126) 2026-05-17 10:29:07 +02:00
ingest-depth.ts fix: remove deterministic embedding backend (#146) 2026-05-19 16:40:01 +02:00
ingest-query-executor.test.ts feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
ingest-query-executor.ts feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
ingest-report-file.test.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
ingest-report-file.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
ingest-viz.test.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
ingest.test-utils.ts fix: remove deterministic embedding backend (#146) 2026-05-19 16:40:01 +02:00
ingest.test.ts feat(ingest): adapter-owned finalization replaces post-processor escape hatch (#136) 2026-05-20 14:17:10 +02:00
ingest.ts feat(ingest): default local ingest to isolated diffs (#128) 2026-05-18 13:38:06 +02:00
knowledge.test.ts feat(cli): improve search ranking output (#123) 2026-05-17 02:32:41 +02:00
knowledge.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
local-adapters.test.ts feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
local-adapters.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
local-scan-connectors.test.ts feat(context): add driver-discriminated connection schemas (#96) 2026-05-15 00:08:11 +02:00
local-scan-connectors.ts fix: clean up ktx yaml config parameters (#75) 2026-05-14 01:27:31 +02:00
managed-local-embeddings.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-local-embeddings.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-mcp-daemon.test.ts fix: sanitize no_proxy for managed embeddings (#153) 2026-05-19 18:18:56 +02:00
managed-mcp-daemon.ts fix: sanitize no_proxy for managed embeddings (#153) 2026-05-19 18:18:56 +02:00
managed-python-command.test.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
managed-python-command.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
managed-python-daemon.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-python-daemon.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-python-http.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-python-http.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
managed-python-runtime.test.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
managed-python-runtime.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
mcp-http-server.test.ts feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
mcp-http-server.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
mcp-server-factory.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
mcp-stdio-server.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
memory-flow-hud.tsx feat: rename project wiki directory (#66) 2026-05-13 16:05:58 +02:00
memory-flow-interactive.test.ts feat: rename project wiki directory (#66) 2026-05-13 16:05:58 +02:00
memory-flow-interactive.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
memory-flow-tui.test.tsx feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
memory-flow-tui.tsx chore: add TypeScript dead-code checks (#60) 2026-05-13 13:33:28 +02:00
next-steps.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
next-steps.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
notion-page-picker.test.ts feat(cli): tree-picker UI for database scope selection (#81) 2026-05-13 18:41:44 -04:00
notion-page-picker.ts feat(cli): tree-picker UI for database scope selection (#81) 2026-05-13 18:41:44 -04:00
print-command-tree.test.ts feat(cli): add ktx admin reindex (#160) 2026-05-20 01:36:54 +02:00
print-command-tree.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
project-dir.test.ts fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
project-resolver.test.ts fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
project-resolver.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
prompt-navigation.test.ts feat(cli): prefix text-input continuation lines with box-drawing characters 2026-05-12 16:58:00 -07:00
prompt-navigation.ts feat(cli): prefix text-input continuation lines with box-drawing characters 2026-05-12 16:58:00 -07:00
proxy-env.test.ts fix: sanitize no_proxy for managed embeddings (#153) 2026-05-19 18:18:56 +02:00
proxy-env.ts fix: sanitize no_proxy for managed embeddings (#153) 2026-05-19 18:18:56 +02:00
public-ingest-copy.test.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
public-ingest-copy.ts feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
public-ingest.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
public-ingest.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
release-version.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
runtime-requirements.test.ts fix: allow agent setup without context (#139) 2026-05-19 12:18:52 +02:00
runtime-requirements.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
runtime.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
runtime.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
scan.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
scan.ts fix(cli): auto-install runtime during setup (#116) 2026-05-16 11:39:43 +02:00
setup-agents.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
setup-agents.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
setup-context.test.ts refactor(cli): remove stale setup context detach state (#109) 2026-05-15 07:09:58 -04:00
setup-context.ts refactor(cli): remove stale setup context detach state (#109) 2026-05-15 07:09:58 -04:00
setup-database-context-depth.ts feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
setup-databases.test.ts fix: remove project from ktx config (#95) 2026-05-14 17:39:31 +02:00
setup-databases.ts feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
setup-demo-tour.test.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
setup-demo-tour.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
setup-embeddings.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
setup-embeddings.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
setup-interrupt.test.ts fix(cli): clean up connection commands (#62) 2026-05-13 15:04:50 +02:00
setup-interrupt.ts fix(cli): clean up connection commands (#62) 2026-05-13 15:04:50 +02:00
setup-models.test.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
setup-models.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
setup-project.test.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
setup-project.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
setup-prompts.test.ts feat(cli): improve setup progress UX (#69) 2026-05-13 17:01:48 +02:00
setup-prompts.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
setup-ready-menu.test.ts fix: improve ingest runtime readiness (#124) 2026-05-17 10:27:29 +02:00
setup-ready-menu.ts fix: improve ingest runtime readiness (#124) 2026-05-17 10:27:29 +02:00
setup-runtime.test.ts refactor(release): drop release-policy.json runtime dep and next branch (#180) 2026-05-20 13:53:14 +02:00
setup-runtime.ts fix: allow agent setup without context (#139) 2026-05-19 12:18:52 +02:00
setup-secrets.test.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
setup-secrets.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
setup-sources-notion.test.ts fix: improve setup wizard behavior (#127) 2026-05-17 19:15:09 +02:00
setup-sources.test.ts feat(context): add driver-discriminated connection schemas (#96) 2026-05-15 00:08:11 +02:00
setup-sources.ts fix: improve setup wizard behavior (#127) 2026-05-17 19:15:09 +02:00
setup.test.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
setup.ts fix(cli): simplify setup flags and agents tty handling (#155) 2026-05-19 19:23:35 +02:00
sl.test.ts fix: remove deterministic embedding backend (#146) 2026-05-19 16:40:01 +02:00
sl.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
source-mapping.test.ts fix: improve setup wizard behavior (#127) 2026-05-17 19:15:09 +02:00
source-mapping.ts fix: improve setup wizard behavior (#127) 2026-05-17 19:15:09 +02:00
sql.test.ts feat(cli): add read-only sql command (#126) 2026-05-17 10:29:07 +02:00
sql.ts feat(cli): add read-only sql command (#126) 2026-05-17 10:29:07 +02:00
standalone-smoke.test.ts feat(cli): smart defaults and flatter command surface for ktx (#177) 2026-05-20 01:52:37 +02:00
startup-profile.ts rename klo to ktx 2026-05-10 23:51:24 +02:00
status-project.ts fix: remove deterministic embedding backend (#146) 2026-05-19 16:40:01 +02:00
text-ingest.test.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
text-ingest.ts feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
tree-picker-state.test.ts feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
tree-picker-state.ts feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
tree-picker-tui.test.tsx feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
tree-picker-tui.tsx feat(cli): enforce required database selection and improve tree-picker UX (#86) 2026-05-14 14:35:58 +02:00
viz-fallback.test.ts Initial open-source release 2026-05-10 23:12:26 +02:00
viz-fallback.ts rename klo to ktx 2026-05-10 23:51:24 +02:00