ktx/docs/superpowers/plans
Andrey Avtomonov e6d578c03f
feat(setup): add Claude Desktop target and MCP-first agent setup (#114)
* feat(setup): add Claude Desktop target and MCP-first agent setup

Adds `ktx mcp stdio` and a `claude-desktop` setup target that generates a
local plugin ZIP wiring the analytics skill and a stdio MCP config. Replaces
the CLI-only agent install mode with MCP+analytics (default) and an optional
admin CLI skill, renames the research skill to analytics, and lets interactive
setup pick project vs global scope when every target supports it. Extracts a
shared MCP server factory used by both HTTP and stdio entrypoints.

* Add MCP agent client setup support

* Polish setup output formatting

* Add MCP tool polish design spec

Design for slimming the MCP-registered surface from 25 to 11 tools,
introducing memory_ingest, applying the per-tool polish kit (annotations,
outputSchema, .describe(), in-band error wrapping, union-drift fixes,
type-narrowed jsonToolResult), emitting progress notifications on
sql_execution + sl_query, and refining the ktx-analytics SKILL.md to
match.

* Refine MCP tool polish design spec after adversarial review iteration 1

* Refine MCP tool polish design spec after adversarial review iteration 2

* Refine MCP tool polish design spec after adversarial review iteration 3

* refactor(context): rename memory capture service to ingest

* feat(mcp): slim research tool surface

* refactor(mcp): remove admin ports from server factory

* refactor(cli): rename text ingest memory port

* docs: update analytics skill for memory ingest

* chore: verify mcp surface rename

* Add MCP tool polish v1 surface change plan

* feat(context): polish mcp tool metadata

* fix(context): enforce resolved semantic layer compute sources

* feat(context): emit mcp query progress stages

* fix(context): keep mcp progress event internal

* Add MCP tool polish v1 metadata & progress plan

* Fix CI snapshot and docs checks
2026-05-16 11:39:55 +02:00
..
2026-05-11-agent-friendly-docs-site.md docs: plan agent-friendly docs site 2026-05-11 16:38:15 -07:00
2026-05-11-bundled-python-runtime-wheel.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-demo-guided-tour.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-historic-sql-cross-dialect-readiness.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-docs-smoke-and-config-cleanup.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-historic-sql-end-to-end-retrieval-acceptance.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-foundations.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-pattern-shard-smoke-docs.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-pattern-workunit-sharding.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-projection-archive-hardening.md docs(plans): add historic-sql projection archive hardening plan 2026-05-11 19:48:33 +02:00
2026-05-11-historic-sql-redaction-hardening.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-redesign-manual-test-plan.md Fix historic SQL ingest setup and progress 2026-05-11 22:35:07 +02:00
2026-05-11-historic-sql-search-enrichment.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-skills-projection-cutover.md ci: run pre-commit checks in CI (#74) 2026-05-13 19:49:25 +02:00
2026-05-11-historic-sql-unified-hot-path.md docs(plans): add historic-sql unified hot-path plan 2026-05-11 17:55:42 +02:00
2026-05-11-managed-agent-mcp-semantic-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-release-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-embeddings-smoke-public-version.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-local-ingest-daemon-runtime.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-command-integration.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-daemon-lifecycle.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-installer.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-python-runtime-release-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-docs-and-postgres-smoke-cleanup.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-prune-smoke-and-docs.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-managed-runtime-uv-prerequisite-contract.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-public-kaelio-ktx-npm-package.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-public-npm-release-handoff.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-published-package-managed-runtime-smoke.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-11-single-public-runtime-artifact-cleanup.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-12-notion-warehouse-verification-gap-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-12-warehouse-verification-final-v1-closure.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-12-warehouse-verification-tools.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-cli-command-tree-script.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-13-unified-ingest-public-cli-surface.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-docs-site-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-final-public-surface-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-final-ux-labels.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-foreground-and-retry-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-progress-copy-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-public-output-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-public-plain-output-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-query-history-status-cleanup.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-unified-ingest-v1-verification-copy-closure.md feat: merge ingest and scan 2026-05-14 01:43:06 +02:00
2026-05-13-warehouse-verification-prompt-shape-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-warehouse-verification-sql-example-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-13-warehouse-verification-structured-target-miss-closure.md feat(context): add warehouse verification tools (#46) 2026-05-13 13:43:23 +02:00
2026-05-14-connection-driver-discriminated-union.md feat(context): add driver-discriminated connection schemas (#96) 2026-05-15 00:08:11 +02:00
2026-05-14-research-agent-mcp-dictionary-search.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-discover-data.md feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
2026-05-14-research-agent-mcp-entity-details.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-http-daemon.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-ingest-contract-convergence.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-setup-agents.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-14-research-agent-mcp-sql-execution-foundation.md feat(mcp):added MCP server (#97) 2026-05-15 02:35:09 +02:00
2026-05-15-semantic-layer-docs.md Align docs with current KTX behavior (#106) 2026-05-15 15:31:51 -04:00
2026-05-16-mcp-tool-polish-v1-metadata-progress.md feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
2026-05-16-mcp-tool-polish-v1-surface-change.md feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00