Cursor rule

1---
2description: 
3globs: 
4alwaysApply: true
5---
6When working on imageflow, we want to preserve comments in the code - ALWAYS - since they help us remember corner cases. Always repeat them back out into the new code. And always load /imageflow_types/src/lib.rs into memory, since we use it in every rust file.
7 
8Our primary interfaces users see are the RIAPI (querystring commands) @riapi.mdc and the JSON API @json-api.mdc, both accessed via @ffi.mdc + Imageflow.Net and Imageflow Server.
9 
10We want to keep our gitbook in docs/src up to date.
11 
12When creating an Err() in imageflow_core, use the nerror!(ErrorKind:*, "format {}", args) macro (format/args optional), which embeds line/file data and creates a FlowError struct. 
13We can map other error types to it stringly, via .map_err(|e| nerror!(ErrorKind::InvalidArgument, "Parse error: {}", e))?;
14We add to the artificial error call stack with .map_err(|e| e.at(here!()))?.
15See @errors.rs for the available ErrorKinds. 
16 
17Example: Err(nerror!(ErrorKind::InvalidOperation, "LibPNG decoder disposed before call to read_frame"))