Sai AGENTS.md

Overview

Please make high quality, not lazy implementation decisions.

Our work should follow the existing usage of apis in the project as much as possible.

Coding

We avoid things like scanf for carefully parsing with code, eg with lws_tokenize or similar.

We avoid FILE * and use apis like open(), read().

We avoid casual linked-lists and use lws_dll2_t.

We consider using lwsac instead of discrete allocations, if the pattern of allocations will benefit from it.

Build testing

Please don't worry about build-testing, just push patches when you are confident they are complete and have considered all affected code (ie, not half-assed) and ready and I will try them and report back with grounded information.

If you really want to build-test:

Sai dependencies:

• libwebsockets from main branch - libssl-dev - libsqlite3 - Build lws: git init && git fetch https://github.com/warmcat/libwebsockets +main:main && cd libwebsockets && mkdir -p build && cd build && cmake .. -DLWS_UNIX_SOCK=1 -DLWS_WITH_STRUCT_JSON=1 -DLWS_WITH_JOSE=1 -DLWS_WITH_STRUCT_SQLITE3=1 -DLWS_WITH_GENCRYPTO=1 -DLWS_WITH_SPAWN=1 -DLWS_WITH_SECURE_STREAMS=1 && make && sudo make install && sudo ldconfig

• sai (main branch shown) - Build sai: git init && git fetch https://github.com/warmcat/sai +main:m && cd libwebsockets && mkdir -p build && cd build && cmake .. && make && sudo make install && sudo ldconfig