aos-reminders: Instructions file for Codex

AGENTS.md

This file applies to the entire repository.

CONCEPTS.md at the repo root holds the shared domain vocabulary — entities, named processes, and the faction / Army of Renown / battle-formation hierarchy — relevant when orienting to the codebase or discussing how army-building concepts relate. docs/solutions/ holds documented solutions to past problems (bugs, architecture patterns, workflow learnings), organized by category with YAML frontmatter (module, tags, problem_type) — relevant when implementing or debugging in documented areas.

Project purpose and current state

AoS Reminders turns an Age of Sigmar army configuration into phase-ordered reminders.

This is an Age of Sigmar fourth-edition codebase:

• the browser runtime uses the canonical model under src/aos4/
• the checked-in runtime is generated from the accepted aos4-corpus-2026-11-03 snapshot
• importing, cloud armies, and army sharing are AoS 4-native: roster parsers in src/importers/ (official app text, Listbot text and file upload, Sigdex text, New Recruit .ros/.rosz/.json), roster resolution in src/aos4/import/, and the Auth0-authorized cloud client in src/api/armyApi.ts
• an army document may opt into Legends units (allowsLegends); Legends applies as an overlay on the document's rules context during selection resolution
• unrecognized browser state is deleted and replaced with a schema-valid army document; it is never translated
• the 27 decoded factions that field units are selectable through one source-complete relationship graph; the 28th row, Endless Spells, is a Wahapedia container for universal manifestations rather than an army, and generation now offers nothing from it, so armyFactions has nothing left to exclude
• manifestations are a category of unit rather than an army: the five universal manifestation lores and their 18 warscrolls come off the Endless Spells container page and are offered by all 27 armies instead of by the container, through the review's universalFactionContent gate
• the accepted corpus contains 1,367 warscrolls, 1,059 battle profiles, 5,461 abilities, 2,373 weapons, 1,607 content groups, and 21,233 live source records
• the 78 Regiments of Renown are classified regiment-of-renown content groups (reviewed regimentsOfRenown input), offered by exactly their inclusion factions with their regiment abilities and member warscrolls linked (issue #1858), all from the accepted collection pages. Krong the Club shipped from the pinned BSData Regiments of Renown catalogue (#1999) until the corpus 2026-09-30 Ossiarch Bonereapers page re-pin brought Wahapedia's copy, which agrees with the official battle-profile row; the BSData catalogue retired and Krong kept its canonical ids. The same re-pin published Urrgar's Maulerguts, classified against the official Ogor Mawtribes regiments pack (#2037). Where a regiment's republished copies disagree, the majority copy wins unless a reviewed variantReason on its regimentsOfRenown entry keeps a named copy instead: corpus 2026-10-02 re-pins the Ironjawz collection and keeps its copies of Odo Godswallow, Bundo Whalebiter, One-eyed Grunnock and Big Drogg Fort-Kicka, the only ones matching the September 2026 rewrite on official Regiments of Renown - Sons of Behemat pages 1-4, over the stale majority (#1999); the dedupe fails closed once a choice names the majority or no copy conflicts; Cogfort Raiders and Rogue Engine link their Outlaw Cogfort member warscrolls, which Wahapedia publishes only on the inclusion factions' collections, through reviewed adoptedWarscrolls entries with availability: 'regiment-of-renown' — the datasheets are fielded only through their regiments and never offered directly (#2030); Gotrek Gurnisson's warscroll carries no faction keyword and his regiment's ORGANISATION line is plain text, so the adapter reads plain-text members by name and a reviewed regiment-only adoption keeps the Fyreslayers collection copy (#2047); Mask of the Deceiver, Heroes of The Jade Abbey, and The Sorrowmourn Choir also print plain-text members and still resolve none; Stumblefoot Gargant, which the September 2026 Battle Profiles prints DELETED, is historical content: every one of its 25 inclusion factions still offers it, but only through the historical overlay, which the builder shows every army under its Scourge of Ghyran (2025-26) header (Retired since 2025-26 in a 2025-26 past-season army) (#1757, #1812)
• current standard, General's Handbook 2026-27 (Scourge of Aqshy), the General's Handbook 2025-26 past season (Scourge of Ghyran, #2042), Spearhead, Legends, and historical rules contexts isolate parallel and retired records; the past season pairs that season's battlepack content (also kept historical) with today's warscrolls, battletomes, and points, and says so wherever it is offered (docs/data/aos4-past-season-2025-26.md); the browser defaults to the current 2026-27 seasonal context
• strict generation consumes every live record and separately dispositions 21,152 superseded records (the May 2026 bulk warscroll/faction-rule rows and the seventeen index-era Ogor datasheets the July 2026 battletome rewrites replaced, issues #1850 and #1880) so none can leak into runtime; the Sons of Behemat battletome ships natively from the Wahapedia pages re-pinned in corpus 2026-09-25 (issue #1999)
• all 1,312 extracted official battle-profile facts have an explicit disposition: 1,016 apply to runtime, 1 remains a profile-only gap (The Emberwatch, a Legends-context Underworlds warband with a reviewed deviation under the official-first intake gate, issue #1820), and 295 remain structured references; the September 2026 core Battle Profiles is the single battle-profile source, so nothing is superseded, and text it strikes through (33 reinforcement notes, a Favoured Spawning note, the DELETED Stumblefoot Gargant regiment) is not extracted as live (#1757)
• corpus 2026-10-01 (#2060) applies the September 2026 Rules Updates errata that still shipped in an earlier form, through reviewed overrides citing the exact pages, including the 12" Summon Shyish Reaper for the Clattering Procession and Eternal Nightmare copies and the Summon Unholy Reliquary for the Knights of the Crimson Keep copy (owner ruling: those errata apply to every army), and Lord Kroak's Arcane Vassal completed from the current Faction Pack: Seraphon reprint; Dirty Tricks (p61) needs no override because its secondary page already omits the removed one-Dirty-Trick-per-phase sentence (Warhammer Community, 29 June 2026); ability overrides may also carry a reviewed name and cost, warscroll keyword overrides may add, and the machine review certifies phrase edits whose new words the official page prints beside the unchanged words around them, and deletions the official page prints whole
• corpus 2026-10-02 (#1999) re-pins only the Ironjawz warscroll collection (2026-10-02 bytes) so the four rewritten Sons of Behemat Regiments of Renown ship their September 2026 rules and official inclusion lists (One-eyed Grunnock no longer offered to Beasts of Chaos); same-name rules keep their canonical ids, the four new rules take fresh ids, and Timberrrrr! (four copies) and Shake the Earth retire. Fortress Wrekka ships the page's "delcared" typo as a recorded discrepancy: the official page splits that reaction across two layout columns, so the machine review cannot ground a spelling override. Krong the Club, Okar's Torrbad, Urrgar's Maulerguts and Da Kountin' Krew move their kept copy to the same page with their ids unchanged
• the earlier candidate/cohort reports remain checked-in reconnaissance history, not current blockers