ktx/docs/superpowers/specs
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-design.md docs: design agent-friendly docs site 2026-05-11 16:30:47 -07:00
2026-05-11-demo-guided-tour-design.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-historic-sql-redesign-design.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-11-npm-managed-python-runtime-design.md feat: npm-managed Python runtime for @kaelio/ktx (#7) 2026-05-11 15:50:34 +02:00
2026-05-12-notion-ingestion-warehouse-verification-design.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-13-unified-ingest-ux-design.md Polish documentation copy (#98) 2026-05-14 12:43:14 -04:00
2026-05-14-research-agent-mcp-tools-design.md feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00
2026-05-15-semantic-layer-docs-design.md Align docs with current KTX behavior (#106) 2026-05-15 15:31:51 -04:00
2026-05-16-mcp-tool-polish-design.md feat(setup): add Claude Desktop target and MCP-first agent setup (#114) 2026-05-16 11:39:55 +02:00