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 when services are constructed before setup. 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 before setup 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 pre-setup construction throws when a required descriptor's package fails to import.