DF0067: Required Service Package Not Importable

Message

Failed to import the required service package "{package}": {reason}

Cause

A service descriptor marked required: true names a package that could not be resolved and imported at the ctx.services.ready() barrier. Descriptors resolve against the declaring plugin's own dependencies first (then the workspace root), so this usually means the service package is missing from the declarer's dependencies, or isn't installed.

Descriptors without required degrade instead: the missing service is skipped and clients observe services.has(pkg) === false.

Example

defineDevframe({
  services: [
    // ✗ Throws at the ready() barrier when the package isn't installed.
    { package: '@devframes/service-shiki', required: true },
  ],
})

Fix

Install the service package next to whoever declares it — a plugin declaring it in services lists it in its own dependencies (or peerDependencies) — or drop required: true and let the consuming UI fall back when the service is absent.

Source

• packages/devframe/src/node/host-services.ts — the barrier flush throws when a required descriptor's package fails to import.