Files
Dragan Spiridonov 52bcf895e6 feat: multi-platform coding agent support (v3.7.4) (#313)
* feat: add multi-platform coding agent support (8 new platforms)

Add installers for GitHub Copilot, Cursor, Cline, Kilo Code, Roo Code,
OpenAI Codex CLI, Windsurf, and Continue.dev. Each platform gets MCP
config generation and behavioral rules/instruction files.

- PlatformConfigGenerator handles JSON, TOML, and YAML config formats
- All installers follow the established OpenCode/Kiro pattern (ADR-025)
- CLI flags: --with-copilot, --with-cursor, --with-cline, --with-kilocode,
  --with-roocode, --with-codex, --with-windsurf, --with-continuedev
- Auto-detection in --auto mode for platforms with existing config dirs
- Merge-safe: existing configs are preserved, AQE entries are appended
- Total platform support: 11 (Claude Code + OpenCode + Kiro + 8 new)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* test: add unit tests for multi-platform installer classes (71 tests)

Cover PlatformConfigGenerator, CopilotInstaller, CursorInstaller,
ClineInstaller, KiloCodeInstaller, and RooCodeInstaller with tests
for fresh install, overwrite/merge, error handling, and factory functions.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* test: add unit tests for Phase 2 platform installers (32 tests)

Add tests for Codex (TOML), Windsurf (JSON), and Continue.dev (YAML)
installers covering fresh install, existing file merge, error handling,
and factory functions. Update tracking plan accordingly.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* feat: add --with-all-platforms flag, platform CLI commands, and integration/E2E tests (Phase 3+4)

- Add --with-all-platforms flag to init command (expands to all 8 platform flags)
- Add `aqe platform list/setup/verify` subcommands for platform management
- Add integration tests for all 8 platform installers against real temp dirs (76 tests)
- Add cross-platform E2E tests with auto-detection and round-trip verification (23 tests)
- Total: 466 platform-related tests passing

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add multi-platform setup guide covering all 11 platforms (Phase 6)

Comprehensive guide with automated and manual setup instructions for all
supported coding agent platforms (Copilot, Cursor, Cline, Kilo Code,
Roo Code, Codex, Windsurf, Continue.dev). Includes config examples,
auto-detection, verification, and troubleshooting.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: address brutal honesty audit findings

- Fix YAML merge bug: existing mcpServers key no longer produces
  duplicate keys — appends server entry instead of full block
- Fix docs: alwaysAllow lists for Cline/Kilo/Roo now match actual
  SAFE_AUTO_APPROVE_TOOLS (21 tools, not truncated 5)
- Fix plan table: correct config paths for Cline (.vscode/ prefix),
  Codex (.codex/ prefix), Windsurf (project-local, not global)
- Rename mislabeled E2E tests to integration (honest labeling)
- Remove unused platform-test-utils.ts (dead code)
- Add test for YAML merge with existing mcpServers key

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: fix stale plan references — mark all integration tests done, remove deleted file refs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* chore(release): bump version to v3.7.4

Multi-platform coding agent support release:
- 8 new platform installers (Copilot, Cursor, Cline, Kilo Code, Roo Code, Codex, Windsurf, Continue.dev)
- Universal PlatformConfigGenerator for JSON/TOML/YAML config formats
- CLI commands: --with-all-platforms, aqe platform list/setup/verify
- 467 tests passing, 33 files changed, +5667 lines

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* docs: add v3.7.4 release notes, changelog, and README multi-platform section

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* fix: correct alwaysAllow count from 21 to 22 in release notes

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-28 09:11:24 +01:00

4.6 KiB

v3.7.4 Release Notes

Release Date: 2026-02-28

Highlights

This release adds support for 8 new coding agent platforms, bringing the total to 11 supported platforms. MCP has become the universal standard — a single AQE MCP server now covers ~90% of the coding agent market. The work spans config generation, behavioral rules, CLI commands, and comprehensive testing for each platform.

Multi-Platform Coding Agent Support

Universal Config Generator

New PlatformConfigGenerator class handles all 8 platforms with a unified registry mapping each to its config path, key, and format (JSON, TOML, YAML).

File: v3/src/init/platform-config-generator.ts

Priority 1 Platforms (JSON-based MCP)

Platform Users Config Path Behavioral Rules
GitHub Copilot 20M .vscode/mcp.json .github/copilot-instructions.md
Cursor 360K paid .cursor/mcp.json .cursorrules
Cline 5M installs .vscode/cline_mcp_settings.json Custom QE mode + 22-tool alwaysAllow
Kilo Code 1.5M .kilocode/mcp.json Custom QE mode + 22-tool alwaysAllow
Roo Code Growing .roo/mcp.json Custom QE mode + 22-tool alwaysAllow

Priority 2 Platforms (Different Config Formats)

Platform Users Config Path Format
OpenAI Codex CLI 1M+ .codex/config.toml TOML
Windsurf Large .windsurf/mcp_config.json JSON
Continue.dev Enterprise .continue/config.yaml YAML

CLI Integration

  • aqe init --with-copilot/cursor/cline/kilocode/roocode/codex/windsurf/continuedev — individual platform flags
  • aqe init --with-all-platforms — all 8 platforms at once
  • aqe platform list — shows all platforms with install status
  • aqe platform setup <name> — install a specific platform
  • aqe platform verify <name> — validate config format, content, and rules

Each Installer Generates

  1. MCP config in the platform's native format with agentic-qe server entry
  2. Behavioral rules tailored to the platform (Markdown, TOML comments, YAML, custom modes)
  3. Merge-safe writing — won't overwrite existing config; merges agentic-qe entry into existing files

Bug Fixes

  • Continue.dev YAML merge duplicate keys — mergeExistingYamlConfig() previously appended a full mcpServers: block when existing config already had that key, producing invalid YAML. Now detects existing mcpServers: and appends only the server entry.
  • CodeQL biased-cryptographic-random alerts — Replaced Math.random() with crypto.randomUUID() in CI-sensitive paths.

Testing

Test Suite Count Description
Per-platform unit tests (x8) 81 Config generation, file writing, merge behavior
Config generator unit tests 22 All platform formats, registry validation
Integration tests 76 Real filesystem, format validation, multi-platform
Cross-platform init tests 23 Auto-detection, round-trip, cross-format consistency
Total new tests 202

All 467 tests pass across 26 test files. Build clean.

Documentation

  • docs/platform-setup-guide.md — Per-platform setup instructions (automated + manual) for all 11 platforms
  • docs/multi-platform-integration-plan.md — Full implementation plan with status tracking
  • README.md — Updated Quick Start, feature list, and new Multi-Platform section

Files Added

File Purpose
v3/src/init/platform-config-generator.ts Universal config generator
v3/src/init/copilot-installer.ts GitHub Copilot installer
v3/src/init/cursor-installer.ts Cursor installer
v3/src/init/cline-installer.ts Cline installer
v3/src/init/kilocode-installer.ts Kilo Code installer
v3/src/init/roocode-installer.ts Roo Code installer
v3/src/init/codex-installer.ts OpenAI Codex CLI installer
v3/src/init/windsurf-installer.ts Windsurf installer
v3/src/init/continuedev-installer.ts Continue.dev installer
v3/src/cli/commands/platform.ts aqe platform list/setup/verify CLI
v3/tests/unit/init/*-installer.test.ts (x8) Per-platform unit tests
v3/tests/unit/init/platform-config-generator.test.ts Config generator tests
v3/tests/integration/platform-installers.test.ts Integration tests (76)
v3/tests/integration/cross-platform-init.test.ts Cross-platform tests (23)
docs/platform-setup-guide.md Setup guide for all 11 platforms