DF0068: Required Service Version Range Not Satisfied

Message

The installed service "{package}@{installed}" does not satisfy the required range "{required}".

Cause

A service descriptor marked required: true declares a version range, and the version of the service that actually resolved falls outside it. The range is checked at the ctx.services.ready() barrier against the resolved definition's own version.

Without required, the same mismatch installs the service anyway and warns with DF0069.

Example

defineDevframe({
  services: [
    // ✗ Throws when @devframes/service-shiki@2.x is what's installed.
    { package: '@devframes/service-shiki', version: '^1', required: true },
  ],
})

Fix

Align the installed service package with the declared range (update whichever side is stale), or drop required: true to downgrade the mismatch to a warning — the advertised meta carries the real version, so clients can gate on it.

Source

• packages/devframe/src/node/host-services.ts — the barrier flush checks each descriptor's version range against the resolved definition.