KTStack 0.3.0

Highlights in KTStack 0.3.0

KTStack 0.3.0 introduces a native Model Context Protocol (MCP) server for AI coding agents, a unified terminal CLI (kt), 1-click IDE quick launch, and a clean-room MIT database management workspace with multi-engine backup and restore.

---

1. Native Model Context Protocol (MCP) Server (kt mcp)

• Embedded stdio JSON-RPC 2.0 MCP server (spec 2024-11-05) connecting Cursor, Claude Code, and Windsurf directly to your local KTStack environment.
• Exposes 7 zero-network-egress agent tools:
  • ktstack_list_sites: Site inventory with domains, runtime pins, and ports.
  • ktstack_create_site: Provision local sites with automated .test routing.
  • ktstack_switch_php_version: Dynamically change assigned PHP runtime versions.
  • ktstack_get_recent_logs: Instant trailing log retrieval for autonomous agent debugging.
  • ktstack_inspect_db_schema: Inspect table columns and primary keys.
  • ktstack_backup_db: Trigger immediate database dumps.
  • ktstack_doctor: System and IPC socket diagnostic probe.
• Setup guide documented in docs/ai-agent-integration.md.

2. Standalone Swift CLI (kt)

• Native Mach-O command-line tool packaged inside KTStack.app/Contents/MacOS/kt.
• Subcommands:
  • kt sites [list] [--json]: List local development sites.
  • kt services [list] [--json]: List daemon status.
  • kt services restart <service>: Gracefully restart background services.
  • kt db backup <database>: Clean-room database snapshot.
  • kt doctor: Terminal diagnostics probe.
  • kt version: Print CLI and build version.

3. 1-Click IDE Quick Launch

• Added 1-click launch buttons directly on Site cards and rows.
• Launches your preferred editor in $< 300\text{ms}$:
  • Cursor (com.todesktop.230313mzl4w4u92)
  • VS Code (com.microsoft.VSCode)
  • PhpStorm (com.jetbrains.PhpStorm)
  • Zed (dev.zed.Zed)
  • Sublime Text (com.sublimetext.4)

4. Clean-Room MIT Database Management Workspace

• 1-Click Backup & Restore: Full support for MySQL, MariaDB, PostgreSQL, SQLite, and MongoDB.
• PK-Indexed Grid Staging: Edits, deletions, and draft rows remain tied to Primary Keys across virtualized scrolling and sorting.
• AppKit Floating Editor: Custom KTCellOverlayEditor and KTGridKeyHandlingTableView avoiding AppKit field editor focus traps.
• DDL & Structure: Real-time DDL preview, foreign key navigation, and explain plan visualization.

5. Platform Architecture & Security

• Local IPC Unix Socket: Thread-safe communication via ktstack.sock restricted to POSIX 0600 permissions.
• Apple HIG & Liquid Glass: Native Liquid Glass container batching for macOS 27+ with graceful .ultraThinMaterial fallbacks on macOS 13+ (Ventura).
• 100% Clean-Room MIT Provenance: Zero AGPL or proprietary code ported.