Function scenario

e2e/src/scenario.ts:120–222

(
  name: string,
  options: ScenarioOptions,
  body: Effect.Effect<void, unknown, AllServices | HttpClient.HttpClient>,
)

};

export const scenario = (
  name: string,
  options: ScenarioOptions,
  body: Effect.Effect<void, unknown, AllServices | HttpClient.HttpClient>,
): void => {
  if (options.skip) {
    // Blocked on a tracked, out-of-scope issue (see the scenario's `skip`
    // reason). Registered as skipped so the suite stays green and the gap stays
    // visible in the test report rather than silently deleted.
    it.skip(name, () => Effect.void);
    return;
  }
  const target = resolveTarget();
  const dir = join(RUNS_DIR, target.name, slugify(name));
  const context = contextFor(target, dir);
  const testFile = captureTestFile();
  const register = options.expectedFailure ? it.live.fails : it.live;

  register(
    name,
    (testCtx) =>
      Effect.gen(function* () {
        // A run's directory is the run — never mix artifacts across attempts.
        rmSync(dir, { recursive: true, force: true });
        mkdirSync(dir, { recursive: true });
        const startedAt = Date.now();
        const exit = yield* Effect.exit(
          body.pipe(Effect.provideContext(context)) as Effect.Effect<
            void,
            unknown,
            HttpClient.HttpClient
          >,
        );
        const endedAt = Date.now();

        // Yielding a service this target can't provide is the skip signal.
        const missing = exit._tag === "Failure" ? missingServices(exit.cause) : [];
        if (missing.length > 0) {
          rmSync(dir, { recursive: true, force: true });
          mkdirSync(dir, { recursive: true });
          writeFileSync(
            join(dir, "skipped.json"),
            JSON.stringify({ scenario: name, target: target.name, missing }, null, 1),
          );
          buildManifest(RUNS_DIR);
          return yield* Effect.sync(() =>
            testCtx.skip(`needs ${missing.join(", ")} — not on ${target.name}`),
          );
        }

        const error = exit._tag === "Failure" ? failureMessage(exit.cause) : undefined;
        // The test source is the review artifact — ship this scenario's code
        // (imports + sibling scenarios stripped) alongside the run.
        const source = testFile ? extractScenarioSource(testFile, name) : undefined;
        if (source) writeFileSync(join(dir, "test.ts"), source);
        writeFileSync(
          join(dir, "result.json"),
          JSON.stringify(