How This Dossier Is Updated
Hansa Mutual follows the series. When a volume is published, revised or found to contradict another, the dossier is brought in step in the order below. The order is the same for the sibling dossier Nordvik Region, and the two are updated in the same pull request set.
When a new volume appears (Book 15 and later; Book 14 was added by this procedure)
- Extract. Read the volume's example-organisation profile and every chapter that names Hansa Mutual. Write
data/extracts/NN_<slug>.mdwith the eight sections the other extracts have: role in the book, profile additions, people, systems and identifiers, events, figures, decisions, inconsistencies. - Ledger. Append the identifiers, events and figures to
data/ledger.jsonl. Runpython3 scripts/check_ledger.pywith the checkouts of the series next to this repository: it fails if a ledger line cites an identifier that is not in the cited chapter, and lists identifiers in the volume that name Hansa Mutual and are not in the ledger. - Chapter. Add the volume's chapter to Part III in
scripts/toc_definition.py, run it with--write, and write the chapter to the brief indocs/BOOK_BLUEPRINT.md(role in the book, additions, decisions and records, usage modes, open threads). The lettered-chapter rule: a volume added after Chapter 19 takes the next lettered chapter after the last volume chapter (Chapter 19A for Book 14, then 19B for Book 15), placed before Chapter 20, so that no chapter number and no cross-reference changes; the chapters are renumbered only in a renumbering release, which is announced on the title page of Chapter 1. The precedent is Chapter 16A of AI Governance. - Cross-cutting chapters. Revise Chapters 2 to 7 where the profile, structure, legal setting, estate, suppliers or posture changed, and Chapters 21 to 24 (chronology, decisions, numbers, cast). Add findings to Chapter 27.
- Rules. Move
cites_up_toinbook.yaml, add the volume to the bibliography as the next numbered source, regenerate Appendix A (python3 scripts/build_appendix_a.py), runbookengine test -qandbookengine run audit_references. - Credibility. If the volume gives Hansa Mutual a new scale, system class, supervisor or incident, re-run the comparison of Part V for that dimension.
- Companions. Update the other sites that carry this book (the series landing page, presentations, whitepapers, courses, shorts and posters; their registries take a new entry from
book.yaml).
When an earlier volume changes
Diff the volume's profile, rerun scripts/check_ledger.py, and correct the ledger lines and the chapters it flags. A correction in a volume that the dossier had recorded as an inconsistency is moved from Chapter 27 to a note in the chapter concerned.
Version and date
Each release states the series state it reflects (the last volume and its date) on the title page of Chapter 1. The date of the extract is in the header of every file in data/extracts/.