Errors

Complete error catalog from src/errors.js. Every user-facing failure is a SwarmError with stable code, exit code, and hint.

Error catalog

Code	Exit code	Cause	Example message	Hint
E_USAGE	USAGE	usage	[varies]	Run with --help to see the correct usage.
E_RENDER_FAILED	RENDER_FAILED	render failed	[varies]	See the render log above.

Error format

Error message
  Hint: suggestion

Example:

Found 2 problem(s) in data.csv:
- Line 5, column "Opacity": "abc" is not a number.
- Line 8, column "Logo": file not found: /path/to/missing.png
  Hint: Fix the reported rows/columns, then run again.

In --json mode

Errors appear in NDJSON row events:

{
  "event": "row",
  "index": 5,
  "where": "line 6",
  "status": "failed",
  "output": null,
  "seconds": 0,
  "error": "EffectCraft render failed with code 1"
}