api-simulator

Keep contributor changes aligned with repository test patterns, diagnostics, release/versioning workflow, documentation requirements, and compatibility.

Provide Counterfact repository orientation, high-level architecture, and the canonical command reference for install/build/test/lint workflows.

Update Counterfact CLI option behavior, config resolution, telemetry-safe startup handling, and bootstrap/runtime entrypoint flow.

Modify TypeScript generator internals, OpenAPI parsing/schema handling, and generated file writing behavior without regressing regeneration guarantees.

Safely change Counterfact runtime/server internals while preserving module boundaries, hot reload behavior, and backward compatibility guarantees.

Add and evolve Counterfact context classes in _.context.ts files, including required unit test coverage for context behavior.

Edit Counterfact route files to add endpoint behavior while keeping handlers thin and delegating business logic to context classes.

Create and update Counterfact scenario modules that seed or mutate context state through reusable scenario functions.

Understand Counterfact architecture and generated project structure before editing generated API simulation code.

Build a fully simulated API from an OpenAPI spec using Counterfact. Generate the initial scaffold, research the real API's behaviour, implement stateful context classes, write tests for those classes, and configure scenario scripts (including a startup scenario) so the mock server is immediately useful without manual setup.

Interact with Counterfact mock API server programmatically. Inspect and modify context state, configure proxy settings, test endpoints, and control mock behavior. Use when the user mentions "counterfact", "mock server", "REPL", testing APIs, or working with OpenAPI mocks.