diff --git a/AGENTS.md b/AGENTS.md index 9dc47e1..104dc06 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -9,6 +9,7 @@ - `node vectors/check.mjs --big --koreader koreader-test-data` passes with "10 passed, 0 failed". It needs a checkout of koreader/test-data at `koreader-test-data`, and `--big` writes a sparse 1 GiB file under the system temp folder. - `node verify.mjs --help` exits 2 by design. - The reference check starts the server with `sh reference-server/run.sh start` (Docker or Podman), registers `ciuser2` as the `reference` job in `.github/workflows/conformance.yml` does, then runs `node verify.mjs --base-url http://127.0.0.1:8080 --user ciuser1 --password cipass1 --register --strict-accept --second-user ciuser2 --second-password secondpass`. It passes when it prints "RESULT: conformant" and exits 0. Stop the server with `sh reference-server/run.sh stop`. +- `sh reference-server/run.sh` reads `KOSYNC_NAME` and `KOSYNC_PORT`, so `KOSYNC_NAME=kosync-sadr KOSYNC_PORT=18080 sh reference-server/run.sh start` runs a second server beside the default one. Stop it with the same `KOSYNC_NAME`. ### Toolchain - No package manager and no lockfile. CI installs only Node (`actions/setup-node`), the `koreader/kosync` image (a service container, and the default image in `reference-server/run.sh`), and a clone of koreader/test-data.