Error Reference
DevFrame uses structured diagnostics to surface actionable warnings and errors at runtime. Each diagnostic has a unique error code, a human-readable message, and a link back to this documentation.
How error codes work
- Codes follow the pattern
DF+ 4-digit number (e.g.,DF0001). - Every error page includes the cause, recommended fix, and a reference to the source file that emits it.
- The diagnostics system is powered by
logs-sdk, which provides structured logging with docs URLs, ANSI-formatted console output, and level-based filtering.
Devframe (DF)
Emitted by devframe — framework-neutral host / shared-state / auth surface.
| Code | Level | Title | Migrated from |
|---|---|---|---|
| DF0001 | error | Dock Already Registered | DTK0015 |
| DF0002 | error | Cannot Change Dock ID | DTK0016 |
| DF0003 | error | Dock Not Registered | DTK0017 |
| DF0004 | error | Terminal Session Already Registered | DTK0018 |
| DF0005 | error | Terminal Session Not Registered | DTK0019 |
| DF0006 | error | RPC Function Not Registered | DTK0020 |
| DF0007 | error | AsyncLocalStorage Not Set | DTK0021 |
| DF0008 | error | View distDir Not Found | DTK0022 |
| DF0009 | error | Command Already Registered | DTK0024 |
| DF0010 | error | Cannot Change Command ID | DTK0025 |
| DF0011 | error | Command Not Registered | DTK0026 |
| DF0012 | warn | Storage Parse Failed | DTK0009 |
| DF0013 | error | Shared State Not Found | DTK0027 |
| DF0014 | error | Invalid Agent Field | — |
| DF0015 | error | Agent Tool Already Registered | — |
| DF0016 | error | Agent Resource Already Registered | — |
| DF0017 | error | MCP Server Start Failure | — |