fix: pr notes

Author: shrugs

packages/integration-test-env/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NameHash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

packages/integration-test-env/README.md

@@ -0,0 +1,36 @@
+# @ensnode/integration-test-env
+
+Integration test environment orchestration for ENSNode. Spins up the full ENSNode stack against the [ens-test-env](https://github.com/ensdomains/contracts-v2) devnet, runs monorepo-level integration tests, then tears everything down.
+
+## Devnet Image
+
+The current devnet image is pinned to:
+
+```
+ghcr.io/ensdomains/contracts-v2:main-f476641
+```
+
+Update the `DEVNET_IMAGE` constant in the orchestrator source to change the devnet version.
+
+## How It Works
+
+The orchestrator runs a 6-phase pipeline:
+
+1. **Postgres + Devnet** — started in parallel via testcontainers
+2. **ENSRainbow database** — downloads pre-built LevelDB, extracts, starts ENSRainbow from source
+3. **ENSIndexer** — starts from source, waits for health
+4. **Indexing** — polls until omnichain status reaches "Following" or "Completed"
+5. **ENSApi** — starts from source, waits for health
+6. **Integration tests** — runs `pnpm test:integration` at monorepo root
+
+## Usage
+
+```sh
+pnpm start
+```
+
+Works both in CI and locally — just make sure the required ports are available (8545, 8000, 3223, 42069, 4334).
+
+## License
+
+Licensed under the MIT License. See [LICENSE](./LICENSE).

packages/integration-test-env/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "description": "Integration test environment orchestration for ENSNode",
   "scripts": {
-    "start": "CI=1 tsx src/ci.ts"
+    "start": "CI=1 tsx src/orchestrator.ts"
   },
   "dependencies": {
     "@ensnode/datasources": "workspace:*",

packages/integration-test-env/src/ci.ts …integration-test-env/src/orchestrator.tspackages/integration-test-env/src/ci.ts renamed to packages/integration-test-env/src/orchestrator.ts packages/integration-test-env/src/ci.ts renamed to packages/integration-test-env/src/orchestrator.ts

@@ -1,8 +1,6 @@
 /**
  * Integration Test Environment Orchestrator
  *
- * Co-authored by Claude (Opus 4.6).
- *
  * Spins up the full ENSNode stack against the ens-test-env devnet, runs
  * monorepo-level integration tests, then tears everything down.
  *
@@ -17,7 +15,7 @@
  *   - testcontainers for Postgres (dynamic port, built-in health check) and devnet
  *     (fixed ports required — ensTestEnvChain hardcodes localhost:8545).
  *   - execa for child process management — automatic cleanup on parent exit,
- *     forceKillAfterDelay (10s SIGKILL fallback), env inheritance via extendEnv.
+ *     forceKillAfterDelay (10s SIGKILL fallback), env inherited from parent.
  *   - Services run from source (pnpm start/serve) rather than Docker so that
  *     CI tests the actual code in the PR.
  *   - ENSRainbow database is downloaded via the existing shell script and
@@ -131,29 +129,29 @@ function logError(msg: string) {
   console.error(`[ci] ERROR: ${msg}`);
 }
 
-async function waitForHealth(url: string, timeoutMs: number, label: string): Promise<void> {
+async function waitForHealth(url: string, timeoutMs: number, serviceName: string): Promise<void> {
   const start = Date.now();
   while (Date.now() - start < timeoutMs) {
     checkAborted();
     try {
       const res = await fetch(url, { signal: AbortSignal.timeout(5_000) });
       if (res.ok) {
-        log(`${label} is healthy`);
+        log(`${serviceName} is healthy`);
         return;
       }
-      log(`${label} health check returned ${res.status}, retrying...`);
+      log(`${serviceName} health check returned ${res.status}, retrying...`);
     } catch {}
     await new Promise((r) => setTimeout(r, 1000));
   }
-  throw new Error(`${label} did not become healthy within ${timeoutMs / 1000}s`);
+  throw new Error(`${serviceName} did not become healthy within ${timeoutMs / 1000}s`);
 }
 
 function spawnService(
   command: string,
   args: string[],
   cwd: string,
   env: Record<string, string>,
-  label: string,
+  serviceName: string,
 ): ResultPromise {
   const subprocess = spawn(command, args, {
     cwd,
@@ -167,19 +165,19 @@ function spawnService(
 
   subprocess.stdout?.on("data", (data: Buffer) => {
     for (const line of data.toString().split("\n").filter(Boolean)) {
-      console.log(`[${label}] ${line}`);
+      console.log(`[${serviceName}] ${line}`);
     }
   });
 
   subprocess.stderr?.on("data", (data: Buffer) => {
     for (const line of data.toString().split("\n").filter(Boolean)) {
-      console.error(`[${label}] ${line}`);
+      console.error(`[${serviceName}] ${line}`);
     }
   });
 
   subprocess.then((result) => {
     if (result.failed && !result.isTerminated) {
-      setAborted(`${label} exited with code ${result.exitCode}`);
+      setAborted(`${serviceName} exited with code ${result.exitCode}`);
     }
   });
 
@@ -219,8 +217,18 @@ async function pollIndexingStatus(timeoutMs: number): Promise<void> {
   throw new Error(`Indexing did not complete within ${timeoutMs / 1000}s`);
 }
 
+function logVersions() {
+  log("Software versions:");
+  log(`  Node.js:  ${process.version}`);
+  log(`  pnpm:     ${execaSync("pnpm", ["--version"]).stdout.trim()}`);
+  log(`  Docker:   ${execaSync("docker", ["--version"]).stdout.trim()}`);
+  log(`  Postgres image: ${POSTGRES_IMAGE}`);
+  log(`  Devnet image:   ${DEVNET_IMAGE}`);
+}
+
 async function main() {
   log("Starting integration test environment...");
+  logVersions();
 
   // Phase 1: Start Postgres + Devnet in parallel
   log("Starting Postgres and devnet...");