This file (1225 lines) had a severe, systemic version of a bug seen in
smaller doses in earlier books: from partway through Rozdział II onward
(~1130 lines, everything through Rozdział X and all 4 annexes), section
headings had degraded into plain paragraph text during a prior sync -
no "#" markers at all. Content wasn't lost, just unstructured: no
outline, no working internal links, and the auto-generated
table-of-contents block only ever covered the first two chapters.
Restored headings programmatically by matching each plain-text line
against the doc's actual heading list (in document order, to avoid
mismatching duplicate-looking section names) and re-adding the correct
"#" level - 202 headings fixed. Replaced the now very-stale hand-written
TOC (which only listed chapters I-II) with the same auto-generating
`table-of-contents` plugin block already used elsewhere in the vault
(e.g. lore/02), since hand-maintaining 200+ TOC lines isn't sustainable.
Diffed the full chapter III-X + annexes text against the doc afterward:
only one real content difference in ~1300 lines - a singular/plural
mismatch ("który pierwotnie popierał" vs "którzy pierwotnie popierali")
that changed whether one prince or several supported the founding of
Królestwo Zaryn. Fixed to match the book (singular, matches Robert Zaryn
being established elsewhere as the sole founder).
Confirmed the ~16 headings that didn't restore (Ziemia/Hiondirs detail
subsections under Rozdział II) are intentional: that content already
lives in locations/Ziemia (Sol-3-1725)/... and locations/Hiondirs-4/...,
correctly split out per the established book-links-out-to-entity-file
pattern, headings and all.
Księga Magii also grew since the last sync (2970-line doc now). Checked
structural coverage against the vault: Rozdział I (disciplines) and
Rozdział IV (artifacts) are correctly split into disciplines/*.md and
already match the doc. Rozdział VII (spell-creation formulas/tables)
verified byte-for-byte accurate.
Found one real structural gap: Rozdział VIII "Dzika Magia Dzikich Wiedźm"
had zero presence in rules/01 - not even a summary+link - even though the
actual content already exists, complete and accurate, in
disciplines/Dzika Wiedźmia Magia.md. Added the missing chapter stub.
Spot-checked spells across schools (general/air/sacred/superspells) for
stat-block accuracy against the doc - found and fixed a real, recurring
bug: several spells have a "Wymagania" (requirements) line in the book
that never made it into the vault's structured `requirements` field:
- Ostrze Dawida: requires Race (Anioł) - was empty
- Fanatyczne Poświęcenie: requires Race (Człowiek) - was empty
- All 8 superspells require Mistrzostwo (mastery) of a discipline - none
of them encode this anywhere. Added the requirement text into each
spell's body since the schema has no dedicated "mastery" field and
guessing at unknown discipline enum keys seemed worse than not
guessing. Left as follow-up if the app schema should grow a field for
this.
- Zagłada (Doom) specifically requires a 4-mage ritual (main caster + 3
others who already know the spell, none can be Źródło Mocy) - this one
*does* have dedicated frontmatter fields (requiresGroupCast, minCasters)
that were sitting at false/1. Fixed to true/4.
Did not attempt a full line-by-line read of all ~104 spells or the
~900 lines of Rozdział I-VI narrative/spell prose given the book's size;
spot-checked a representative sample per chapter/school instead. A
systematic requirements-field audit across all spell files is a
reasonable follow-up given what turned up here.
rules/06. Bestiariusz.md was a 0-byte file - never synced. Turns out
the live doc itself is mostly an unfinished skeleton: "Rozdział I -
Przeciwnicy" (monster stat blocks) is a bare heading with no content at
all, and most of "Rozdział II - Inne Postacie" is just a list of NPC
names with no stats or descriptions under them, in the doc itself. Only
"Rozdział III - Talenty" (4 unique boss/NPC talents) has real written
content.
Built the vault file to faithfully match that structure: full text for
the 4 talents, and the NPC roster linked out to their existing npcs/
profile pages where one exists (12 of 18 names). Two names (Klara,
Wikaene) have no npc/ file yet - left as plain text rather than inventing
one, since they're only attested in session-log mentions
(lore/90. Tales..., session notes), not in the book. Narcyza Zurbach's
existing npc file is itself an empty placeholder stub.
Did not fabricate any monster stat blocks or NPC combat stats - neither
the book nor the vault has them anywhere, and inventing them isn't a
reconciliation task.
This book grew substantially in the live doc since the last vault sync
(2165 lines now vs the ~650-line vault rules file), restructured from
4 chapters into 9 chapters + 2 annexes. Checked lore/03. Ekonomia
Magicznego Świata.md's heading structure against the doc's chapters
I-VIII: it's already been fully expanded to match, 1:1, including every
subsection - no gaps found there. Did a structural check, not a full
line-by-line read, given its size (~1100 lines of narrative prose);
flagging that a deeper pass is available if wanted.
Deep-diffed the mechanics-only portions that live in rules/03 (the book
was already correctly split: crunch in rules/, worldbuilding in lore/):
- Real rule bugs: "Widzenie w Ciemności" and "Hartowany w Ogniu" talents
were restricted to Krasnolud only in the vault; the book grants them to
Krasnolud/Feles/Elf and Krasnolud/Lamia respectively.
- Real rule bug: the simplified trade minigame's failure clause was
flattened to a flat 10% loss; the book scales it ("10% za każdy
brakujący Sukces") and ties the GM's complication roll to the shortfall.
- Naming drift: "Tworzenie Artefaktów" -> "Rzemiosło Artefaktów" (matches
the actual discipline file name used everywhere else in the vault).
- Two "Rodział" -> "Rozdział" typos, and a malformed wikilink with a
duplicate closing `]]`.
Currency exchange table (Rozdział II) and the base-price table (Aneks B)
verified byte-for-byte against the doc - no drift.
Fetched the "Klątwa Otchłani" doc and checked it against rules/02
(mechanics), lore/02 (Otchłań worldbuilding), and the eldritch spell
files it links out to.
- Missing rules content: "Przywołanie Istoty z Otchłani" gave no way to
actually determine required successes ("depends on the creature", full
stop) - the book's per-creature table (Tajemny Krab 2, Strażnik
Otchłani 4, Czempion Otchłani 6, Simulacrum 10 successes, plus their
Otchłań-bond level requirements) was dropped entirely. Restored it.
- Wrong cross-reference: rules/02's Wstęp pointed to
[[03. Ekonomia Magicznego Świata]] (a different book's lore file
entirely) instead of [[02. Otchłań i Magia]].
- Two more headings that degraded to plain text during a prior sync
("Bariera Ziemi", "Przebudzenie" in lore/02) - same failure pattern as
Arcanum Sanguinis, now fixed.
- Chapter renumbering inconsistency: rules/02 renumbers every chapter
locally (I-V) except the last one, which stayed "Rozdział X" from the
book's original numbering. Renumbered to VI for consistency with its
siblings.
Verified: Nil/Mundus/Tempus/Mistrz Losu personifications (already split
to npcs/Kult Otchłani/*.md) and all 5 eldritch spell stat blocks match
the doc. Rozdział III (Kara za nieudolność) and VIII (Choroby
Psychiczne) are empty in the book itself, not a sync gap.
Fetched the "Chwała Szkarłatnemu Kultowi" doc (constants.ts display name;
internally still titled that, vault calls the book "Vivat Patriarcha
coccineus!" - flagging for confirmation, not renaming).
- Fixed a broken TOC anchor: linked to "Superzaklęcie - Requiem" but the
actual heading is just "Requiem" - dead internal link in Obsidian.
- Restored "może wskrzesić" (can resurrect) for the Wielki
Taumaturg/Pierwszy Patriarcha ritual outcome; vault had drifted to
"może stworzyć nowe ciało dla" (can create a new body for), which
contradicts both the book and the vault's own lore/05 file (which
independently says the cult wants to "wskrzesić" him).
Rozdział I-III (rumors/structure/locations lore) live in lore/05.
Szkarłatny Kult.md, which has been substantially expanded past the book
with campaign-specific canon (Nicodemus Florens, Xillith, Domena
Szkarłatu time dilation) - left untouched per policy: book is
source-of-truth only where it asserts something the vault contradicts,
not vault-original elaboration. Spell stat blocks in spells/crimson/*
and spells/general/superspells/requiem.md verified byte-for-byte
accurate against the doc - no changes needed.
Fetched the live "Krwawa Mgła"/Arcanum Sanguinis Google Doc (constants.ts
entry has a stale display name; the doc itself was renamed) and diffed it
against rules/04. Found:
- Wielka Ofiara frequency cap was wrong: vault said "raz na rundę" (once
per round), book says "raz dziennie" (once per day). Real balance bug,
not cosmetic - this is a potential instant-kill action.
- "Wchłanianie Krwi" had lost its heading during a prior sync (plain text,
missing from TOC) - restored as a proper H3 + linked in the outline.
- Minor wording drift restored to match the book ("czy mechanik" clause,
"coraz" typo).
Confirmed disciplines/Magia Krwi.md (the existing lore-split destination
for this book's Rozdział I-II / Robert Zaryn material) already matches
the doc verbatim - no changes needed there.
Claude
Octoturge