ravenous_roll20/TASKS.md

84 lines
5.0 KiB
Markdown

# Ravenous sheet worklist
This list tracks the next development steps from [AGENTS.md](AGENTS.md).
Mark an item complete only after its stated check passes. Keep a note of the
Roll20 test date and any failures; local worker tests do not reproduce Roll20's
parser, browser, or chat.
## Done locally
- [x] Generate the sheet from the pinned `ravenous_typst` data and run the
Python build tests (`uv run python -m unittest discover -s tests -v`).
- [x] Add local worker tests (`node tests/test_worker.mjs`) for derived values,
resistance and protection summaries, technique import, skill outcomes,
attack follow-up calculations, and damage mitigation.
- [x] Verify generated artifacts with `./scripts/build.sh --check`.
- [x] Add themed exports from the book palette data, with a separate output
directory for alternate CSS and deterministic checks.
- [x] Add a minimal GM-only Roll20 Mod proof of concept that creates one
character from a JSON `name`; test valid and invalid commands locally.
- [x] Add origin powers from the pinned book data stage by stage in an editable
Powers tab, while preserving custom rows and preventing duplicate imports.
- [x] Add a GM-only character JSON export/import Mod script and a monster
database converter. Verify round trips, repeating rows, invalid input, and
all master-visible monsters locally.
## Next: Roll20 smoke test
- [x] Install `roll20_mod/ravenous_import_name.js` as a New Script in a test
game, run `!ravenous-import-name {"name":"Ariane"}` as GM, and confirm a
single new character appears in the journal. **2026-09-17:** user reports
that the test worked in Roll20.
- [x] Install `roll20_mod/ravenous_character_io.js` in a test game. Export an
edited sheet, save its JSON outside Roll20, import it from a GM handout, and
compare notes, abilities, attributes, and repeating rows. Import one converted
monster and check each mapped row and any worker recalculations. **2026-09-17:**
user reports this workflow completed successfully in Roll20;
`local_exports/character.json` is the local saved export and is excluded from Git.
- [ ] Load `build/ravenous.html`, `build/ravenous.css`, and
`build/translation.json` into a Custom Sheet Sandbox with Legacy Sanitization
disabled. Record the date, browser, and any console or worker errors.
**2026-09-17 attempt:** user supplied a Firefox console log (browser inferred
from Firefox-specific messages). It shows `Starting up WEB WORKER`, CSP
warnings for inline scripts/event handlers, Sentry CDN CORS/integrity errors,
and `Uncaught SyntaxError: missing ] after element list` in `vtt.bundle`.
The log does not confirm the Legacy Sanitization setting or whether the sheet
itself loaded and its workers ran; the syntax error needs a reproduction.
- [x] Load one alternate theme (for example `build-steel/`) and inspect the
sheet and chat cards for legibility and contrast in Roll20. **2026-09-17:**
user reports that the themes work perfectly.
- [ ] Create an attacker and defender, plus a token representing the defender.
Open both sheets; switch every tab; add, edit, delete, and reorder a repeating
row. Reopen each sheet and confirm values persist.
- [ ] Change base and temporary characteristics, stage, a skill rank, and a
custom skill. Confirm the displayed totals update and that derived stats use
the permanent characteristic as intended.
- [ ] Add one technique, attempt to add it again, and activate its chat card.
Check that text is readable and free of raw Typst markup.
- [ ] Select an origin, add one stage of powers, try adding it again, then add
another stage and a custom power. Change origin and reopen
the sheet. Confirm existing rows persist and selection alone adds no rows.
- [ ] Roll a skill at the threshold boundary and on a natural 1. Check chat
outcome and margin. Try public and secret rolls.
- [ ] Roll an attack, use its **Défendre** chat button with the defender token
selected, then use **Dégâts** and **Subir**. Test zero successes, more successes
than RMax, multiple checked resistances, one active protection, depleted
integrity, and a fixed location. Confirm DMG and AB against hand calculations.
- [ ] Repeat an attack follow-up after closing and reopening the sheet. Record
whether the attack context survives; the current worker stores it in memory.
## After smoke test
- [ ] Fix each observed Roll20 defect with a focused reproduction and a local
test where the behavior can be simulated. Recheck it in the sandbox.
- [ ] Compare derived statistics, defense thresholds, damage, and AB formulas
with the pinned rulebook. Record the rule reference and any intentional
deviation before changing mechanics.
- [x] Decide whether HP should update automatically. **2026-09-17:** user
decided to keep HP updates manual for now.
- [ ] Decide whether armor integrity, technique costs, and temporary effects
should update automatically. Record each decision before adding automation
or UI controls.
- [ ] Add local worker tests to Jenkins only after confirming Node is installed
on its build agent, or provision a pinned Node runtime there.