DF0058: Dev Server Disabled By The Definition

Message

"{id}" declares capabilities.dev: false — it does not support a live dev server (its value is a static export only).

Cause

createDevServer runs unconditionally when called directly, but a definition can opt out of the live dev server via capabilities.dev: false — for a devframe whose value is inherently static (e.g. a report generator with nothing to serve live), a dev server would only ever produce an empty or misleading surface. This diagnostic covers a caller invoking createDevServer() directly.

Example

// ✗ Bad — starts a dev server for a devframe that opted out of it
await createDevServer(reportDevframe) // throws DF0058

// ✓ Good — run it anyway when you know what you're doing
await createDevServer(reportDevframe, { force: true })

Fix

• Pass { force: true } to createDevServer() to run it anyway.
• Otherwise, drop capabilities.dev: false on the definition if a live dev server should be supported after all.

Source

• packages/devframe/src/adapters/dev.ts — createDevServer() throws this when capabilities.dev is false and force isn't set.