Skip to content

Record a sprawozdanie

Nerthus.Core (until cutover). This page describes the frozen system that runs today and is deleted at cutover. Replaced by: not yet written.

The monthly chore that keeps the governance ledger current: a Radny drops the month's report into Repozytorium Dzieł as one file, and records the transitions it announces. It costs one commit a month and it is the only thing feeding the governance ledger, which answers who holds which function on any date.

What this buys and what it costs

Nothing on any free-tier cap. The work is one Markdown file and a few JSON lines a month, in a repository with no CI attached. What it buys is that who was Namiestnik in June 2023 stops being a five-post traversal through a forum thread whose header post has been edited in place ten times.

Prerequisites

  • Write access to repozytorium-dziel — the Rada's, per that repository's own access ruling.
  • The month's sprawozdanie, as published on the Panel Fabularny.

Steps

  1. Drop the report in. One file per month, in the source's own directory, named RRRR-MM.md and nothing else — no heading, no metadata, no front matter:
sprawozdania/2026-08.md

The file is filed under the month the report covers, not the month it was published. A report published on 2 September covering August is 2026-08.md.

  1. Read the report for transitions. A transition is one person's relationship to one governance function changing, or one rule taking a new value. The sections that carry them are the ones the reports have always had: Narratorzy, Rada, Zadania stałe, and any paragraph announcing a rule change with a date.

  2. Append one line per transition to the right file under governance/ledger/, one JSON object per line. The nine files are namiestnik, rada, sekretarz, narratorzy, rozporzadzenia, pu-rules, mechanika, nicki, zadania-stale.

{"ref":"narratorzy","seq":115,"date":"2026-08-03","date_ig":1338,"date_basis":"instrument",
 "instrument_date":"2026-08-03","op":"appoint","subject":"Frisk",
 "evidence":[{"post":46909434,"author":"Aurelia Lesup","quote":"W tym miesiącu do grona narratorów dołączył Frisk."}],
 "source_authority":"sprawozdanie","confidence":"wysoka","extracted":"2026-08-11","confirmed_by":null}

Every field except note, grade, until, value and conflicts is required. A row with no evidence is refused, not stored: the whole arrangement is that a state change cites the sentence asserting it, and a row without one is somebody's memory.

  1. Quote verbatim. The quote is checked against the post it names, so a paraphrase is a defect. Copy the sentence.

  2. Say which date you mean. date is the day the state changes and instrument_date is the day the report was published. Where the report names a day — z dniem 01.09 rezygnuje — set date to it and date_basis to stated. Where it does not, leave both as the publication day and set date_basis to instrument.

  3. Do not resolve a disagreement. Where the report names somebody the ledger carries under another name, or contradicts an earlier row, put the disagreement in conflicts and leave the higher-authority row as the state. Ekipa Garmory outranks a rozporządzenie, which outranks a report, which outranks a sign-off.

  4. Commit both files together, with the ordinary review this repository takes. The commit is the audit record — the ledger itself is not a git history and does not pretend to be.

How to verify it worked

Ask the daemon what changed:

Get-NerthusGovernanceRef narratorzy
Get-NerthusGovernanceRef narratorzy -Log -Since 2026-08-01

The new holder is in holders, and applied has gone up by the number of lines you added. Then read the findings:

Get-NerthusGovernanceRef

findings should carry nothing new. A GovernanceLeaveWithoutHold naming your row means the person left a function the ledger never recorded them taking, which usually means an earlier month was missed rather than that this month is wrong.

What to do when it did not

The row does not appear at all. The parser refused it. Read findings for a row keyed <ref>#<line> — a malformed date, an op outside the closed set, an op that means nothing on that kind of ref, or missing evidence. The line number is the line in the .jsonl file.

The daemon answers corpus: null. This host has no works tree. corpora.dziel in config.json names it, and a host that holds only the lore repository legitimately has none.

Two holders where there should be one. On namiestnik and sekretarz an appointment evicts the previous holder, so this cannot happen; on rada and narratorzy it means a departure is missing. Add it in the month it happened rather than adjusting this one.

The months that have no report

The Rada has skipped months, and said so — Brak sprawozdania we wrześniu is a heading in the September–October 2025 report. A missing RRRR-MM.md is a true statement about the corpus and does not need a placeholder.

See also