@heroiclands/package-build 25.5.5 → 25.6.0

package/docs/reference/format-details.md

@@ -1444,8 +1444,8 @@ complete address here; `folder-poisonsandtoxins` and the fully qualified
 `sohl-none-folder-poisonsandtoxins` name the same folder. An address no folder
 note answers to is a build error naming the folders the package does declare.
 
-Note this is the _pack_ folder, not the note's directory. The directory is
-`file.path` / `file.folder`, which a content table reads separately.
+Note this is the _pack_ folder, and a note's directory has no bearing on it
+or on any query.
 
 **Where a folder materialises is derived from what references it.** Every pack
 holding a document that names a folder gets that folder, and its ancestors with
@@ -3404,7 +3404,7 @@ ORDER BY sohl.kbcat, name.full
 **`FROM notes`** is the content index: one row per note, plus one per
 documentation entry, so `type = 'miscgear'` selects the items and never their
 journals. A nested field is addressed exactly as a note authors it —
-`sohl.weight`, `name.full`, `file.path` — because the index is read as JSON and
+`sohl.weight`, `name.full`, `data.culture` — because the index is read as JSON and
 every nested object is inferred as a struct. A field a note type does not carry
 reads `NULL` rather than failing. `data.culture` is the one field that reads as
 a derived value: the note's own culture, or the one it inherits. See
@@ -3534,7 +3534,7 @@ for the keys.
 | `register`       | `data.register`                 | `name`, `tongue`, `kind`, `built` (a list), `gloss`, `why`, `built_text` (the pieces joined with `+`), and `notes`: every note of the package carrying the name, derived from the index, `NULL` where none does                                                                                                                                                            |
 | `tongues`        | `data.tongues`                  | `tag`, `meaning`, and `tongue_language`, the tongue's `language`                                                                                                                                                                                                                                                                                                           |
 | `retired`        | `data.retired`                  | `form`, `instead` (always a list, `NULL` where nothing is written instead), `why`                                                                                                                                                                                                                                                                                          |
-| `scope`          | `data.scope`                    | No `position`: `kind`, the key the value is under (`folders`, `cultures`, `lore`, `parents`, `addresses`, `paths`, `types` or `skip`), and `value`, an Address in its canonical form or a path or a type                                                                                                                                                                   |
+| `scope`          | `data.scope`                    | No `position`: `kind`, the key the value is under (`folders`, `cultures`, `lore`, `parents`, `addresses`, `types` or `skip`), and `value`, an Address in its canonical form or a type                                                                                                                                                                                      |
 | `letters`        | `data.sounds.letters`           | `letters` (a list), `kind`, `like`, `place`, `ipa`, `tongue` (a list, `NULL` for every tongue); a [spelling guide's](#a-spelling-guides-sounds) rows too, keyed by the guide                                                                                                                                                                                               |
 | `edges`          | `data.sounds.edges`             | `edge`, `sounds` (a list: `[any]` for every sound, empty for none)                                                                                                                                                                                                                                                                                                         |
 | `clusters`       | `data.sounds.clusters`          | No `position`: `max`, one row per language stating it                                                                                                                                                                                                                                                                                                                      |
@@ -3683,8 +3683,9 @@ relational operations:
 `_section` is why one query replaces the forty near-identical blocks a grouped
 table would otherwise need: the authored `ORDER BY` decides the section order too.
 
-**Beware `packFolder`.** It is a note's _pack_ folder, not its directory — the
-directory is `file.folder`.
+**Beware `packFolder`.** It is a note's _pack_ folder. A query never selects by
+the directory a note sits in: `file.path`, `file.folder` and `file.name` are
+refused wherever a query names them.
 
 ##### Culture parents and inherited fields
 
@@ -4038,8 +4039,8 @@ as literal text.
 Only `---` accepts `.page-break`; `*** {.page-break}` and `___ {.page-break}`
 are findings. Other classes, ids and attributes on an attributed `---` line
 are findings too. A page break stands between blocks at the top level of a
-note: putting one inside a list, block quote, alert, secret block or fenced
-div is a finding at the marker's line and column.
+note: putting one inside a list, block quote, alert, footnote definition,
+secret block or fenced div is a finding at the marker's line and column.
 
 ##### Captions and numbered references
 
@@ -4305,6 +4306,7 @@ the authored text as H1 sections with fixed anchors, in this order:
 | Within            | `within`         | a `place`                                                | the places whose `data.parents` names it, one paragraph to each kind of place, in the order the place vocabulary lists its `subType`s |
 | Governed by       | `governedby`     | a `place`                                                | the affiliation its `data.government` names, as a list entry with the affiliation's kind                                              |
 | Governed places   | `governedplaces` | an `affiliation`                                         | the places whose `data.government` names it, grouped as **Within** groups them                                                        |
+| Office holders    | `officeholders`  | an `affiliation`                                         | each office of its `governance.offices` held by a living being, one line each, with the beings whose `office` names it                |
 | Chronology        | `chronology`     | a `place`                                                | an [event view](#event-views)                                                                                                         |
 | Events            | `events`         | a `being`, an `affiliation`, a `lore` note of `culture`  | an event view                                                                                                                         |
 | Accounts          | `accounts`       | an `affiliation`, a `place`, a `lore` note of `culture`  | an event view                                                                                                                         |
@@ -5066,8 +5068,8 @@ names, an empty name, a missing `pattern` or `given`, a missing `female` or
 
 #### The bodies a being belongs to, and its standing in each
 
-**Membership**: `{rank: number, office: string, societies: string[]}` — `rank`
-required, `office` and `societies` not.
+**Membership**: `{rank: number, office: string | string[], societies: string[]}` —
+`rank` required, `office` and `societies` not.
 
 `data.affiliations` is a **map keyed by the body's Address**, and each entry is
 the standing the being holds in that body. The key is what makes the pair
@@ -5081,7 +5083,8 @@ An entry carries three keys and nothing else:
   every rung, so a number indexes into it and the body stays the single source
   for what its level 5 is called.
 - **`office`** — optional, a **string**, matched against the keys of that body's
-  `governance.offices` map.
+  `governance.offices` map, or a **list** of them where one being holds several
+  posts in the same body, such as treasurer and chancellor of one council.
 - **`societies`** — optional, a **list of names**, the societies the membership
   is held in. It is always a list, even with one name; a bare string is an
   error at the key.
@@ -5110,13 +5113,15 @@ data:
 Both values are checked against the body the entry is keyed by. A `rank` that
 is not a level the body confers and an `office` that is not one of its keys are
 each an error naming the file, line and column — so a rung or a post that does
-not exist fails on every being pointing at it. Naming one body twice, by its short
+not exist fails on every being pointing at it. Each post of a list is checked
+and located on its own. Naming one body twice, by its short
 and full Address, still names one body and is an error.
 
 The infobox prints one line per membership, in the order the note writes them,
 in a section of its own titled **Affiliations**: the office where one is held, then the rung's
 title with its level in parentheses, then the body — `War Chief, Hárár (5), of
-Vrystwald Tribes`, or `Hárár (5), of Vrystwald Tribes` with no office. The title
+Vrystwald Tribes`, or `Hárár (5), of Vrystwald Tribes` with no office. Several
+posts lead in the order written: `Treasurer, Chancellor, Hárár (5), of …`. The title
 is read from the body's own `governance.ranks`; where the body declares no rung
 at that level, or its ladder is not available, the rung reads as `Rank 5` —
 `Rank 5, of Vrystwald Tribes`. The body's name links to its page, and is plain
@@ -5124,10 +5129,11 @@ text where it publishes none. A membership stating no
 standing is the body's name alone. The lines are the same on the website, in
 a Foundry journal and in the book. On the body's own page each office is a row
 anchored by its name, so the post a being holds is described where the body
-declares it.
+declares it, and its **Office holders** section lists who holds each post.
 
 For SoHL, a being embeds one affiliation item per entry: `rank` **is** that
-item's `system.level`, `office` its `system.office`, and the first name in
+item's `system.level`, `office` its `system.office` (several posts joined by
+commas), and the first name in
 `societies` its `system.society`. The SoHL item holds one society, so only the
 first name reaches it. A standing is a fact
 about the setting rather than about one system, so the `sohl:` block states
@@ -5690,7 +5696,33 @@ data:
           - { being: being-mara, start: "datefrom vrcal 2 Lusenar 725 VR" }
 ```
 
-**Governed places are derived from place notes.** Each place names one governing affiliation in `data.government`. The affiliation's **Governed places** [generated section](#generated-sections) lists the places whose explicit references resolve to it, across local notes and fetched indexes, grouped by kind; with none, it has no such section. No affiliation-side list supplies government, and neither geographic containment nor organizational parents expands it.
+**Office holders are derived from beings.** Nothing names a holder on the
+office itself: a being states the post it holds in its own
+`data.affiliations.<body>.office`. For each office in `governance.offices`, the
+body's **Office holders** [generated section](#generated-sections) lists every
+being naming it whose `data.died` is unset, so several holders at once, a post
+held jointly, a vacant post that lists no one and a former holder who has died
+all need no further key. Offices follow the body's order, and holders are
+ordered by name; an office nobody living holds has no line, and a body with no
+held office has no section. A public body lists only public beings. The
+content index carries the same list on the body's record as `officeHolders`, one
+`{ office, holders }` entry per held office, each holder a being Address:
+
+```json
+{
+  "officeHolders": [
+    {
+      "office": "War Chief",
+      "holders": [{ "address": "thalorna-note-being-hrothgar", "anchor": null, "anchorKind": null }]
+    }
+  ]
+}
+```
+
+`holders`, the dated roster above, is a separate record of terms a body may
+keep; the derived list reads only the beings.
+
+**Governed places are derived from place notes.** Each place names one governing affiliation in `data.government`. The affiliation's **Governed places** [generated section](#generated-sections) lists the places whose explicit references resolve to it, across local notes and fetched indexes, grouped by kind, and every district that states no government and falls under one of those places; with none, it has no such section. No affiliation-side list supplies government, organizational parents never expand it, and geographic containment expands it only to a district stating none.
 
 If `sohl` is present, this becomes an `affiliation` item.
 
@@ -5838,6 +5870,7 @@ Note: `data.quantity` may not be specified. Quantity is always 1.
 | `durability`       | `number`         | Gear durability                                                               |
 | `made`             | an event Address | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`        | `true` for a one-of-a-kind item; its note links a place or a being            |
 
 If a `sohl` property is present, a SoHL item of type "armorgear" is created.
 
@@ -5860,6 +5893,15 @@ without an `id`, a note holding none, an anchor the note does not declare, or
 a `prose` anchor is an error at that key. Neither reaches a system field, an
 infobox row or a page: each is a fact a content table can read.
 
+`unique: true` marks a one-of-a-kind item — a named hammer, a crown, a sword
+in a tomb — and an item without it is common, like ten feet of rope. No key says
+who holds or owns a unique item: possession changes in play, where Foundry
+tracks it in an actor's inventory, and ownership is a claim that can be
+disputed. Where the item lies and who claims it are prose in its note, linked
+to the places and beings involved, so a unique item whose note links no `place`
+and no `being` — in a body wikilink, or in a `made` or `lost` event Address — is
+an error at `unique`. Neither system reads the key; the infobox shows it as a **Unique** row.
+
 ### type: armorlocation
 
 | `data` property    | Values   | Description                                |
@@ -5900,6 +5942,7 @@ if a `sohl` property is present, a SoHL item of type "attribute" is created.
 | `durability`       | `number`                        | Gear durability                                                               |
 | `made`             | an event Address                | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address                | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`                       | `true` for a one-of-a-kind item; its note links a place or a being            |
 | `quantity`         | `number`                        | Gear quantity (default: 1)                                                    |
 | `potency`          | `na \| mild \| strong \| great` | Concoction Potency (mundane/exotic concoctions)                               |
 | `strength`         | `number`                        | Strength: higher the number, greater the strength                             |
@@ -5930,6 +5973,7 @@ Note: `data.quantity` may not be specified; quantity is always set to 1.
 | `durability`       | `number`         | Gear durability                                                               |
 | `made`             | an event Address | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`        | `true` for a one-of-a-kind item; its note links a place or a being            |
 | `capacity`         | `number`         | HM3 container capacity (in lbs)                                               |
 
 if a `sohl` property is present, a SoHL item of type "containergear" is created.
@@ -5957,6 +6001,7 @@ SoHL reads a container’s capacity in pounds from `sohl.maxCapacity`.
 | `durability`       | `number`         | Gear durability                                                               |
 | `made`             | an event Address | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`        | `true` for a one-of-a-kind item; its note links a place or a being            |
 | `quantity`         | `number`         | HM3 gear quantity (default: 1)                                                |
 
 if a `sohl` property is present, a SoHL item of type "miscgear" is created.
@@ -6076,6 +6121,7 @@ the item’s base mastery and level from `sohl.masteryLevelBase` and
 | `durability`       | `number`         | Gear durability                                                               |
 | `made`             | an event Address | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`        | `true` for a one-of-a-kind item; its note links a place or a being            |
 | `quantity`         | `number`         | HM3 gear quantity (default: 1)                                                |
 
 if a `sohl` property is present, a SoHL item of type "projectilegear" is created.
@@ -6205,13 +6251,12 @@ SoHL sets `system.quantity` to `1` for each compendium item.
 | `retired[].form`                           | `string`, required                                                                                                             | The form the setting does not write                                                                                                                                                            |
 | `retired[].instead`                        | `string` or `string[]`                                                                                                         | What is written in its place; absent where nothing is                                                                                                                                          |
 | `retired[].why`                            | `string`, required                                                                                                             | Why the setting does not write it                                                                                                                                                              |
-| `scope`                                    | `{ folders?, cultures?, lore?, parents?, addresses?, paths?, types?, skip? }`                                                  | `language` only: the notes the register covers                                                                                                                                                 |
+| `scope`                                    | `{ folders?, cultures?, lore?, parents?, addresses?, types?, skip? }`                                                          | `language` only: the notes the register covers                                                                                                                                                 |
 | `scope.folders`                            | `Address[]`                                                                                                                    | Every note whose `packFolder` is one of these folders                                                                                                                                          |
 | `scope.cultures`                           | `Address[]`                                                                                                                    | Every note whose `culture` is one of these cultures                                                                                                                                            |
 | `scope.lore`                               | `Address[]`                                                                                                                    | Every note whose `lore` names one of these notes                                                                                                                                               |
 | `scope.parents`                            | `Address[]`                                                                                                                    | Every note whose `parents` names one of these notes                                                                                                                                            |
 | `scope.addresses`                          | `Address[]`                                                                                                                    | These notes themselves                                                                                                                                                                         |
-| `scope.paths`                              | `string[]`                                                                                                                     | Every note whose file sits below one of these content paths, as `Regions/Aelwyth/`                                                                                                             |
 | `scope.types`                              | `string[]`                                                                                                                     | The note types covered; a note of another type is out of scope whatever else catches it                                                                                                        |
 | `scope.skip`                               | `Address[]`                                                                                                                    | Notes out of scope whatever else catches them                                                                                                                                                  |
 | `sounds`                                   | `{ letters?, edges?, clusters?, stress?, finals?, syllables?, joining?, joins?, marks?, skeleton?, frames?, readPast? }`       | `language` only: the letters it writes and the rules its words keep                                                                                                                            |
@@ -6269,7 +6314,7 @@ SoHL sets `system.quantity` to `1` for each compendium item.
 | `sounds.marks`                             | `{ mark, letters, kind, limit }[]`                                                                                             | The marks the language writes on its letters                                                                                                                                                   |
 | `sounds.marks[].mark`                      | `string`, required                                                                                                             | The mark's name, as `acute`                                                                                                                                                                    |
 | `sounds.marks[].letters`                   | `string[]`, required                                                                                                           | The letters that carry it                                                                                                                                                                      |
-| `sounds.marks[].kind`                      | `stress`, `length` or `apart`, required                                                                                        | What it says of its letter                                                                                                                                                                     |
+| `sounds.marks[].kind`                      | `stress`, `length`, `apart` or `quality`, required                                                                             | What it says of its letter                                                                                                                                                                     |
 | `sounds.marks[].limit`                     | `one` or `any`, required                                                                                                       | How many a word may carry                                                                                                                                                                      |
 | `sounds.skeleton`                          | `{ second, third?, between? }[]`                                                                                               | The vowel set between a root's second and third consonants                                                                                                                                     |
 | `sounds.skeleton[].second`                 | `string[]` or `any`, required                                                                                                  | The second consonants the row holds for; `any` for every other                                                                                                                                 |
@@ -6925,7 +6970,7 @@ closed list where its values are words:
 - `joins`: what happens where a consonant or a vowel meets another (`C+C`,
   `V+C`, `V+V`): `merge`, `insert` the `letters` between, `drop` the first, or
   `double` the consonant, everywhere or `where` stated.
-- `marks`: the marks written on letters, each saying `stress`, `length`, or `apart` (the mark sets a vowel to be said apart from its neighbour, as a diaeresis does), and
+- `marks`: the marks written on letters, each saying `stress`, `length`, `apart` (the mark sets a vowel to be said apart from its neighbour, as a diaeresis does) or `quality` (the mark changes which vowel is said, as a grave writing the short vowel of _cat_ does), and
   whether a word carries `one` at most or `any`.
 - `skeleton`: the vowel set between a root's second and third consonants, by
   the second consonant and, where a row states `third`, the third; nothing
@@ -7213,6 +7258,7 @@ Note: `data.quantity` may not be specified. Quantity is always 1.
 | `durability`       | `number`         | Gear durability                                                               |
 | `made`             | an event Address | The event in which it was made — `lore-forging`, or `place-ironfells#raising` |
 | `lost`             | an event Address | The event in which it was lost — `lore-flood`, or `place-ironfells#sack`      |
+| `unique`           | `boolean`        | `true` for a one-of-a-kind item; its note links a place or a being            |
 
 if a `sohl` property is present, a SoHL item of type "weapongear" is created,
 carrying every strike mode the weapon has — melee and missile alike — on
@@ -7807,12 +7853,34 @@ level with no background prints nothing.
 
 - world: A self-contained whole in which places exist — a planet, plane, or realm.
 - region: A bounded division of a world or larger region — continents, marches, uplands, provinces.
+- district: A recognised division of a settlement or a region, usually administrative — a city's quarter, a town's ward, a kingdom's shire.
 - settlement: A place where folk dwell together — cities, towns, villages, holdings, camps.
 - site: A place significant by what was made or done there — ruins, monoliths, henges, works, battlefields.
 - structure: A single building or habitation — halls, keeps, temples, inns, towers.
-- feature: A place significant by its terrain — forests, rivers, falls, passes, fords.
+- feature: A place significant by its terrain — forests, rivers, falls, fords.
+- route: A way travelled between places — a road, a pass, a sea lane.
 - celestial: A body observed from a world rather than located on one — a sun, a planet, a comet.
 
+A region is land defined by its geography or its people; a district is a
+division drawn by those who govern it. A valley crossing two shires is a
+region, and each shire is a district. **A district always stands within a
+`settlement` or a `region`**, named in `data.parents`: a district naming no
+parent is an error at its `subType`, and one whose parents all resolve and none
+is a settlement or a region is an error at `parents`. A district may name its
+own governing affiliation in `data.government`, a ward's governor or council;
+without the key it falls under its parent's government. The content index gives
+such a district the `data.government` of its nearest parent that states the key,
+reading `data.parents` in order and upward through parents that state none, so
+the district's **Governed by** section, the governing body's **Governed
+places** and every reader of the index name that body, and the "missing
+government" advisory does not fire. An explicit value on the district,
+`null` (complete anarchy) included, is its own and stands; a parent's explicit
+`null` is inherited as anarchy. **A route carries its
+journeys in `data.routes`**, at least one, and one stating none is an error at
+its `subType`; rivers stay features. Both compile as every place does, to a
+journal entry filed by `data.pack` and `data.packFolder`, and both are listed
+in their parent's **Within** section under **Districts** and **Routes**.
+
 | `data` property                   | Values                                                                           | Description                                                                                               |
 | --------------------------------- | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
 | `events`                          | event entries — see [Events](#events)                                            | What happened to or at this subject: dated, attributed events                                             |
@@ -7823,6 +7891,15 @@ level with no background prints nothing.
 | `culture`                         | `Address`                                                                        | The people this place belongs to, naming a lore note with `subType: culture`                              |
 | `population`                      | `number`                                                                         | Approximate population (precision 2 significant digits)                                                   |
 | `government`                      | `Address` or `null` (default type: `affiliation`)                                | Governing affiliation; explicit null means complete anarchy. Omission warns only for positive population. |
+| `settlements`                     | `{ rows, tail }`                                                                 | Declared settlement rows and the sentence saying what the table leaves out                                |
+| `settlements.rows`                | list of row maps                                                                 | One row per settlement                                                                                    |
+| `settlements.rows[].place`        | `Address`                                                                        | Existing settlement note; exclusive with name                                                             |
+| `settlements.rows[].name`         | `string`                                                                         | A settlement without a note; exclusive with place                                                         |
+| `settlements.rows[].market`       | integer, required                                                                | Market class, 1 to 6                                                                                      |
+| `settlements.rows[].population`   | positive integer, required                                                       | People living here                                                                                        |
+| `settlements.rows[].heldBy`       | `Address`                                                                        | What holds the land, where it is held; an affiliation or a being                                          |
+| `settlements.rows[].for`          | `string`                                                                         | Optional reason the settlement exists                                                                     |
+| `settlements.tail`                | `string`, required                                                               | Sentence stating what the table leaves out                                                                |
 | `market`                          | `number`                                                                         | Market class, 1 to 6 — what trade a settlement supports                                                   |
 | `borders`                         | `{ to, bearing }[]`                                                              | Places sharing a frontier with this one, and where each lies from here                                    |
 | `borders[].to`                    | `Address`, required                                                              | The other place; the type defaults to `place`                                                             |
@@ -8069,7 +8146,7 @@ Write `government: null` for **complete anarchy**. Omitting the key leaves gover
 | Any                   | Explicit `null`     | None; complete anarchy           |
 | Any                   | Affiliation Address | None; the reference must resolve |
 
-These rules apply to every place subtype, including settlements, sites, structures, features, regions and worlds. Empty strings, numbers, lists, maps, references to another note type and unresolved references are errors. They do not declare anarchy. `parents`, containment and capitals do not supply a government.
+These rules apply to every place subtype, including settlements, sites, structures, features, regions and worlds. Empty strings, numbers, lists, maps, references to another note type and unresolved references are errors. They do not declare anarchy. `parents`, containment and capitals do not supply a government, except to a `district` that omits the key, which falls under its nearest parent's government as [type: place](#type-place) describes.
 
 #### Population figures
 
@@ -8126,120 +8203,81 @@ languages belong to a polity's `sohl.system.commonSkills`, while the note's
 
 #### A region's settlements table
 
-A region lists its settlements in a table on its own note: one row for each
-settlement, stating what its market is, how many people it holds and who holds
-it. **A row is the whole record of a settlement that has no note.** Where a
-note exists the row links it, and the two must agree. A package that writes no
-such table is not affected by anything in this section.
-
-The table is a markdown table under a level-two `## Settlements` heading on the
-region's `place` note. Its header is exactly these columns, in this order. `For`
-may be left out; the header carries no other column:
+A region declares its table in `data.settlements: { rows, tail }`. The rows
+carry the settlement's `population` and numeric `market`, and either `place`
+(the existing note's Address, default type `place`) or `name` (plain text where
+no note exists), never both. Where the region's culture holds land, a row's
+optional `heldBy` names what holds it by Address (an affiliation or a being,
+default type `affiliation`), and what that note is says how the land is held: a
+temple, a lineage, the city, a kin group. A people who hold no land state no
+`heldBy`, and their table has no Held by column. Optional `for` states why the
+settlement exists. `tail` is the sentence stating what the table leaves out.
+
+The guard reads indexed rows. A linked row's population and market agree with
+its note, and every settlement note covered through `parents` has one row in
+the nearest declaring region. `government` states who governs; it never supplies
+who holds the land. HTML, Foundry and Typst render the declared table once.
+A body table under `## Settlements` is an error at its header, naming
+`data.settlements`; no facts are read from it.
+
+The rendered columns are fixed, in this order; `Held by` appears when any row
+states `heldBy`, and `For` when any row states `for`:
 
 | Name | Market | People | Held by | For |
 | ---- | ------ | ------ | ------- | --- |
 
-- **Name** — the settlement. Where it has a note, a link to it with the pipe
-  escaped for the table, `[[place-ashford\|Ashford]]`; otherwise plain text.
-- **Market** — the market class as its number and its name, lower case:
-  `1 hamlet`, `2 village`, `3 town`, `4 market town`, `5 city`, `6 great city`.
-  The scale is the one [`data.market`](#what-a-settlements-market-supports)
-  states.
-- **People** — the population, a whole number, grouped with commas or not:
-  `60`, `420`, `3,400`.
-- **Held by** — who holds it, written in the region's holding model. Link the
-  holder where it has a note.
-- **For** — a short phrase saying why the place is there: the ford, the mine,
-  the shrine.
-
-At least one sentence of prose follows the table, before the next heading,
-saying what the table leaves out. A section filled by an `sql` fence is
-generated from the notes and is not read as a settlements table.
-
-**The region names its holding model as a tag.** A note carrying a settlements
-table carries at least one of these tags; a region whose countryside is held
-two ways carries both. Tags stay open, so a misspelled model is not reported as
-such: the table's note is reported for naming no model.
-
-| `holdingModel` value | the Held by cell names |
-| -------------------- | ---------------------- |
-| `held`               | a person or a house    |
-| `endowed`            | an institution         |
-| `registered`         | an office              |
-| `kin`                | a kindred              |
-| `polis`              | the city               |
-
-A linked holder is an `affiliation` or a `being`, and a `being` is a person: it
-may hold land only in a region tagged `held`.
-
-**A settlement belongs to one table** — that of the nearest place above it, by
-`parents`, that carries a settlements table. Every `settlement` note that table
-covers has a row there and nowhere else.
-
-A worked example. `Vale.md`:
+`population` is a positive whole number. `market` is an integer from 1 to 6;
+the generated Market cell includes the class name (`4 market town`). A holder
+is an affiliation or a being, and its note says what kind of holding it is: a
+temple holds its endowment, a lineage its fiefs, the city its own fields. A row
+naming no holder leaves its Held by cell empty.
 
-```markdown
----
-shortcode: vale
-name: { full: The Vale }
-type: place
-subType: region
-tags: [region, held]
-data:
-  population: 100000
-  government: crown
----
-
-## Settlements
+A worked example: the following `data` block belongs to `Vale.md`, whose
+`type` is `place`, `subType` is `region` and `shortcode` is `vale`:
 
-| Name                       | Market        | People | Held by                                  | For                        |
-| -------------------------- | ------------- | -----: | ---------------------------------------- | -------------------------- |
-| [[place-ashford\|Ashford]] | 4 market town |  3,400 | [[affiliation-crown\|the Crown]]         | the ford on the drove road |
-| Weyshott                   | 2 village     |    420 | [[being-aldwyn\|Sir Aldwyn of Brynwold]] | the manor's mill           |
-| Cold Hatch                 | 1 hamlet      |     60 | Sir Aldwyn of Brynwold                   | the sheepwalk              |
-
-Some four hundred further villages lie in the vale, none of them named here.
+```yaml
+data:
+  settlements:
+    rows:
+      - place: ashford
+        market: 4
+        population: 3400
+        heldBy: affiliation-crown
+        for: the ford on the drove road
+      - name: Weyshott
+        market: 2
+        population: 420
+        heldBy: being-aldwyn
+        for: the manor's mill
+      - name: Cold Hatch
+        market: 1
+        population: 60
+    tail: Some four hundred further villages lie in the vale, none of them named here.
 ```
 
 `Ashford.md` states `parents: [vale]`, `population: 3400` and `market: 4`, so its
-row agrees with it. Weyshott and Cold Hatch have no notes; their rows are their
-whole record. Change Ashford's row to `3,000` and `package-build lint` reports:
-
-```text
-assets/content/Vale.md:16:49: error: figure disagrees: Ashford is carried at 3,000 here and 3,400 on its own note
-```
-
-`package-build lint` reports each of these as an error, each named by the
-phrase its message begins with:
-
-- **`settlements columns`** — the header is not the declared columns in
-  order. The table's rows are not read until it is.
-- **`no holding model`** — the note carries a settlements table and none of
-  the holding-model tags. Reported at its `tags`.
-- **`market class`** — a Market cell is not a class written as its number and
-  its name.
-- **`people figure`** — a People cell is not a positive whole number.
-- **`no holder`** — a Held by cell is empty.
-- **`not a holder`** — a Held by link names a note that is neither an
-  affiliation nor a being.
-- **`holder out of model`** — a Held by link names a being in a region not
-  tagged `held`.
-- **`not a settlement`** — a Name link names a note that is not a place.
-- **`figure disagrees`** — a linked row's People differs from its note's
-  `data.population`, or the note states none.
-- **`market disagrees`** — a linked row's Market differs from its note's
-  `data.market`, or the note states none.
-- **`unlinked settlement`** — an unlinked Name is the name or an alias of a
-  settlement note the table covers. The finding gives the link to write.
-- **`missing row`** — a settlement note the table covers has no row. Reported
-  at the table's header.
-- **`duplicate settlement`** — a settlement has a second row in one table, or
-  a row in a table other than the one covering it.
-- **`no tail`** — no sentence follows the table before the next heading.
-  Reported at the table's last row.
-
-A cell's finding is located at the cell. A link in a cell that resolves to no
-note is reported by the link check, once, and not again here.
+row agrees. `affiliation-crown` names the existing Crown note; `being-aldwyn`
+names Sir Aldwyn's existing note. Weyshott and Cold Hatch have no notes; these
+rows hold their complete settlement record, and Cold Hatch names no holder. The generated table uses the
+current note names for its links and prints `3,400` and `4 market town`.
+Changing Ashford's row population to `3000` produces `figure disagrees` at
+that YAML value; removing its row produces `missing row` at `rows`.
+
+Every semantic finding is an error, located where its YAML changes:
+
+- **`body settlements table`** — A body table under Settlements is refused; declare data.settlements.
+- **`settlements shape`** — A region declares rows and tail, with one name or place per row.
+- **`unresolved settlement reference`** — A place or heldBy Address does not resolve.
+- **`market class`** — A row market is not an integer from 1 to 6.
+- **`people figure`** — Population is not a positive whole number.
+- **`not a holder`** — A heldBy Address names neither an affiliation nor a being.
+- **`not a settlement`** — A place Address names a subject that is not a place.
+- **`figure disagrees`** — A linked population differs from its note, or the note states none.
+- **`market disagrees`** — A linked market differs from its note, or the note states none.
+- **`unlinked settlement`** — A plain name has an existing settlement note in this region.
+- **`missing row`** — A covered settlement note has no row.
+- **`duplicate settlement`** — A settlement has another row here or in another region.
+- **`no tail`** — The declaration has no sentence stating what it leaves out.
 
 ### type: scenario
 
@@ -8251,6 +8289,14 @@ Content prepared to be played — a situation with its cast, places, and possibl
 - adventure: A self-contained undertaking with a specific objective, playable in a few sessions.
 - encounter: A single scene or challenge, reusable within an adventure or on its own.
 
+A scenario's state is two independent signals. The `draft` tag is the author's
+judgement that it still needs work, lifted when it is finished whether or not
+it has been played. An optional `## Playtest {#playtest}` section, absent until
+the scenario is first run at a table, records each run: the date, the table's
+size, the party's makeup and the scenes covered, the difficulty as played scene
+by scene, adjustments a GM can make, and what the party did that the scenario
+did not foresee. Holes found in play are fixed in the scenario itself.
+
 | `data` property    | Values                                       | Description                                                                    |
 | ------------------ | -------------------------------------------- | ------------------------------------------------------------------------------ |
 | `parents`          | `Address[]`                                  | List of parent scenarios of this scenario (campaigns, etc.)                    |
@@ -8258,7 +8304,6 @@ Content prepared to be played — a situation with its cast, places, and possibl
 | `cast`             | `Address[]`                                  | individuals associated with this scenario                                      |
 | `factions`         | `Address[]`                                  | Affiliations associated with this scenario                                     |
 | `follows`          | `Address[]`                                  | Prerequisite scenarios that should be completed before beginning this scenario |
-| `status`           | `draft \| playtested \| published`           | Playability status of this scenario                                            |
 | `party.size`       | `solo \| small \| standard \| large \| host` | Suggested party size (solo=1, small=2-3, standard=4-6, large=6-7, host=7+)     |
 | `party.archetypes` | `Archetype[]`                                | Archetypes of characters suitable for completion                               |
 
@@ -8338,7 +8383,7 @@ Content prepared to be played — a situation with its cast, places, and possibl
 | `sounds.marks`                                    | `{ mark, letters, kind, limit }[]`                                    | The marks written on the letters, each row's keys as a language note's `sounds.marks`                                                          |
 | `sounds.marks[].mark`                             | `string`, required                                                    | The mark's name, as `acute`                                                                                                                    |
 | `sounds.marks[].letters`                          | `string[]`, required                                                  | The letters that carry it                                                                                                                      |
-| `sounds.marks[].kind`                             | `stress`, `length` or `apart`, required                               | What it says of its letter                                                                                                                     |
+| `sounds.marks[].kind`                             | `stress`, `length`, `apart` or `quality`, required                    | What it says of its letter                                                                                                                     |
 | `sounds.marks[].limit`                            | `one` or `any`, required                                              | How many a word may carry                                                                                                                      |
 
 A setting guide introduces one culture's view of the setting, so it names that