Merge origin/main: preserve openApiDocument-to-Context feature alongside ScenarioRegistry

Author: Copilot

.changeset/add-config-file.md

@@ -0,0 +1,5 @@
+---
+"counterfact": patch
+---
+
+Add JSDoc comments throughout the codebase, covering all major classes, functions, and interfaces in `src/server/`, `src/typescript-generator/`, `src/repl/`, and `src/util/`.

.changeset/add-internal-jsdocs.md

@@ -0,0 +1,5 @@
+---
+"counterfact": patch
+---
+
+Make the hexagon in the REPL prompt the same shade of blue as the logo (#0071b5).

.changeset/afraid-pens-remain.md

@@ -0,0 +1,5 @@
+---
+"counterfact": patch
+---
+
+Moved `openapi-example.yaml` from the repository root into `test/fixtures/openapi-example.yaml` and expanded it with many OpenAPI edge cases: CRUD operations on `/users` and `/users/{userId}`, polymorphic events via `oneOf`/`allOf`/`discriminator`, nullable fields, enum types, integer formats, file upload via `multipart/form-data`, cookie parameters, deprecated endpoints, multiple response content types, a no-body `204` health-check endpoint, and free-form `additionalProperties` objects.

.changeset/blue-hexagon-repl-prompt.md

@@ -0,0 +1,14 @@
+---
+"counterfact": minor
+---
+
+Refactor `OpenApiDocument` from a plain interface into a class.
+
+`OpenApiDocument` now extends `EventTarget` and manages its own lifecycle:
+
+- `new OpenApiDocument(source)` — create an instance pointing at a local path or URL
+- `await document.load()` — read and parse the file, populating `paths`, `basePath`, and `produces`
+- `await document.watch()` — start watching the source file; dispatches a `"reload"` event whenever the file changes on disk
+- `await document.stopWatching()` — stop the file watcher
+
+The separate `OpenApiWatcher` class has been removed; its behaviour is now built into `OpenApiDocument`.