chore: parameterize docker host ports and wire s2-lite by default

[ericallam]

Summary

Two papercuts new contributors hit running this repo locally:

1. Fresh clones default to v1 (Redis-only) realtime streams, so Sessions and chat.agent error with "S2 configuration is missing", even though the s2 service is already in docker/docker-compose.yml and pre-seeds a trigger-local basin. Wire REALTIME_STREAMS_S2_* to it in .env.example so the new-contributor flow just works. (Also drop the s2 healthcheck: the image is distroless, so the wget check always reports unhealthy.)

2. Two clones can't both run pnpm run docker because ports, project name, and container names are all hardcoded. Parameterize every host port as ${VAR:-default}, drive the project name via COMPOSE_PROJECT_NAME (with a top-level name: field as the default), prefix container names with ${CONTAINER_PREFIX:-}, and pass --env-file .env so compose reads the same root .env the webapp does. The "Running multiple instances side by side" block in .env.example lists every overridable knob.

Also split the optional services (electric-shard-1, ch-ui, toxiproxy, nginx-h2, otel-collector, prometheus, grafana) into docker-compose.extras.yml behind a new pnpm run docker:full script. The core stack keeps everything the webapp actually needs to boot: postgres, redis, electric, minio, clickhouse + migrator, s2-lite.

Defaults match every previous hardcoded value, so existing setups keep working without touching .env.

Test plan

• pnpm run docker on a clean clone brings up the core services on the standard ports under the triggerdotdev-docker project name.
• Setting COMPOSE_PROJECT_NAME=triggerdotdev-docker-alt + the *_HOST_PORT overrides in .env brings up a second stack alongside the default one with no port or container-name clashes.
• Webapp boots cleanly against the default .env.example values; /healthcheck returns 200, no S2 errors.
• s2-lite basin trigger-local accepts an append + read via the same REST endpoints the webapp uses.
• pnpm run docker:full brings up the optional services alongside the core ones in the same project.

[changeset-bot]

⚠️ No Changeset found

Latest commit: c8ee6c4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[coderabbitai]

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• 🔍 Trigger review

Walkthrough

Adds a commented S2 Realtime streams v2 block to .env.example and updates observability guidance. Parameterizes docker/docker-compose.yml (container names and host ports), removes the s2 wget healthcheck, and pins several images. Introduces docker/docker-compose.extras.yml with optional services and an observability stack. Updates package.json Docker scripts to use docker compose with --env-file .env. Updates AGENTS.md, CLAUDE.md, and CONTRIBUTING.md to document the changes and troubleshooting for running multiple local instances.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The PR title accurately summarizes the two main changes: parameterizing Docker host ports for multi-instance support and wiring S2-lite as the default realtime backend.
Description check	✅ Passed	The PR description covers the test plan, changelog, and summary sections required by the template, though the checklist items are not explicitly marked as completed.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch chore/s2-lite-oss-onboarding

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[devin-ai-integration]

Devin Review found 2 new potential issues.

View 6 additional findings in Devin Review.