DF0042: Instance Registry Update Failed

Message

Failed to update the devframe instance registry at "{file}": {reason}

Cause

A dev server (or an in-process host calling registerDevframeInstance) could not write or remove its record under the instance registry directory — ~/.devframe/instances/ by default, or $DEVFRAME_INSTANCES_DIR. Typical causes are a read-only home directory, missing permissions, or a full disk. The server keeps running; only discovery is affected — devframe connect will not see this instance.

Fix

• Check that the registry directory is writable and the disk has free space.
• Point DEVFRAME_INSTANCES_DIR at a writable directory.
• Set DEVFRAME_DISABLE_INSTANCE_REGISTRY=1 to opt out of registration entirely.

Source

• packages/devframe/src/node/instance-registry.ts — registerDevframeInstance() reports this on a failed write and its unregister() on a failed removal.