DF0071: Deferred Service Installation Failed On Connect

Message

Deferred service installation failed while flushing on the first client connection: {reason}

Cause

Queued wire-service installs are normally flushed by the host calling ctx.services.ready() once every devframe's setup has run — the first-party adapters (initDevframe, createBuild, createCac, initHub) all do. As a safety net, a host that never calls it still gets the flush right before the first client RPC connection is served. When that deferred flush fails (a required service missing, an unsatisfied version range, a throwing setup), the error can only be reported — a connection hook is no place to crash — so it surfaces as this diagnostic instead of a startup failure.

Fix

Call ctx.services.ready() explicitly after every devframe's setup has run, so installation errors throw at startup where they can be acted on:

await devframe.setup(ctx)
await ctx.services.ready()

The reason carries the underlying error (typically DF0067, DF0068, or a service setup failure) — fix that root cause as its own page describes.

Source

• packages/devframe/src/node/rpc-core.ts — createContextRpcServer()'s connect hook reports a failing deferred flush.