Distillation

Date: Sep 14, 2026

• 🔴 (12:28) User stated that processes which never serve the server—specifically CLI processes and scripts—must not pay the server setup cost at module load; the relevant comment appears near packages/opencode/src/server/routes/instance/httpapi/server.ts:184.
• 🔴 (12:28) User provided repository guidance to avoid Effect.provide(SomeLayer) inside request handlers or raw route callbacks; stable layers must be provided once at the application/layer boundary rather than rebuilt or scoped per request.
• 🔴 (12:28) User provided Effect service conventions: prefer FileSystem.FileSystem over raw fs/promises, ChildProcessSpawner.ChildProcessSpawner with ChildProcess.make(...) over custom process wrappers, HttpClient.HttpClient over raw fetch, and existing Path.Path, Config, Clock, and DateTime services when already inside Effect code.
• 🔴 (12:28) User provided background-task conventions: use Effect.repeat or Effect.schedule with Effect.forkScoped in the layer definition for background loops or scheduled tasks.
• 🟡 (12:28) User supplied a targeted excerpt of packages/opencode/src/server/routes/instance/httpapi/server.ts, including imports for SessionProjector, InstanceStore, SessionStatus, MoveSession, FSUtil, and ServerAuth, plus sessionHandlers composition and server-layer setup near lines 119–257, as research evidence for startup composition.