chore: import upstream snapshot with attribution

showcase/docker-compose.record.yml

@@ -0,0 +1,51 @@
+# Record-mode override for aimock. Layer on top of docker-compose.local.yml
+# to flip aimock from replay-only into record+replay against real OpenAI /
+# Anthropic. Recorded fixtures land on the host at
+# `showcase/aimock/d5-recorded/recorded/` (one file per LLM call).
+#
+# Usage:
+#   docker compose -f showcase/docker-compose.local.yml \
+#                  -f showcase/docker-compose.record.yml \
+#                  --profile infra up -d aimock langgraph-python
+#
+# When recording is finished, switch back to base compose (no override) and
+# load any new fixtures from `d5-recorded/` via an additional `--fixtures`
+# entry on the aimock command.
+#
+# Authorization headers from the integration container are forwarded to the
+# real provider — no key needs to be set on aimock itself.
+services:
+  aimock:
+    volumes:
+      # RW mount so aimock can write `recorded/<provider>-<ts>-<uuid>.json`
+      # under this dir. Existing baseline fixtures stay :ro from the base
+      # compose; only the recording dir is writable.
+      - ./aimock/d5-recorded:/showcase-fixtures/d5-recorded:rw
+      # Read-only mounts for depth-organized fixture directories so aimock
+      # can short-circuit on already-matched prompts from shared/d4/d6.
+      - ./aimock/shared:/showcase-fixtures/shared:ro
+      - ./aimock/d4:/showcase-fixtures/d4:ro
+      - ./aimock/d6:/showcase-fixtures/d6:ro
+    command: [
+        "--port",
+        "4010",
+        "--host",
+        "0.0.0.0",
+        "--record",
+        "--provider-openai",
+        "https://api.openai.com",
+        "--provider-anthropic",
+        "https://api.anthropic.com",
+        # Load ONLY the recorded dir as the fixture source. The baseline
+        # depth-organized fixtures (shared/d4/d6) are intentionally NOT
+        # loaded — if they were, aimock would short-circuit on
+        # already-matched prompts and never proxy them to the real
+        # provider, defeating the recording pass.
+        #
+        # First --fixtures path is the recording destination base; aimock
+        # writes to `<base>/recorded/<provider>-<ts>-<uuid>.json`.
+        "--fixtures",
+        "/showcase-fixtures/d5-recorded",
+        "--fixtures",
+        "/showcase-fixtures/shared",
+      ]