← Back to Engineering Notes

November 5, 2025

v0.2.7: API Sync, TCP Support & Advanced Mocking

Intelligent API synchronization with change detection, TCP protocol mocking, flexible response selection, and real webhook execution.

Automatic API Sync & Change Detection

Periodic polling of upstream APIs with configurable intervals (default: 1 hour). Deep response comparison detects changes in status codes, headers, and body content. Optional automatic fixture updates, manual sync trigger via POST /api/recorder/sync/now, and detailed change reports with before/after comparisons. Configurable upstream URL, headers, timeout, and max requests.

TCP Protocol Support

The new mockforge-tcp crate enables raw TCP protocol mocking with fixture-based message matching, echo mode for testing clients, TLS/SSL support for encrypted connections, optional delimiter-based message framing, configurable buffer sizes and connection limits, and a --tcp-port CLI flag.

Response Selection Modes

When multiple OpenAPI examples are available: sequential (round-robin) for systematic testing, random for unpredictable variation, and weighted random with custom per-example weights to control selection probability.

Webhook HTTP Execution

HookAction::HttpRequest now executes actual outbound HTTP requests (GET, POST, PUT, DELETE, PATCH) with configurable body and headers. Fire-and-forget execution so failures do not block orchestration.

Enhanced Documentation

Complete CRUD simulation guide with stateful data store implementation, and full webhooks and callbacks guide covering hook chains, scripts, and real-world integration patterns.