Skip to content

Commit 577b8dd

Browse files
tmoostingclaude
andcommitted
0.84.0: schema-dist serial 86, a graph node's family is its type's colour word
Serial 86 keys presentation.json's colour groups by their colour words: each type's family value is blue, green, pink or amber, colors.order and colors.families are keyed by them (hexes unchanged), and _meta.families is gone. Construct moves to pink and Ability to amber. The lens profile rules that a graph node's family is that word and nothing else, and lens.fixture.json asserts it; world_graph now gives it, and all 151 lens cases (37 graph) pass. The generated map is renamed ELEMENT_GROUPS (private to the package, so no alias), and the generator and the node's field comment call it a colour group. The README's graph line says what family holds. address.md gains a sentence on what a pin's, a marker's or a zone's address answers; nothing here restates it. The tree is the tag's git archive (197 files); MANIFEST.json's sha256 (15200898...) matches the raw file served at the tag, whose ref resolves to b0ca326. walk/ and schema.json did not move, so the vendored checker is unchanged. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 9cd8995 commit 577b8dd

19 files changed

Lines changed: 228 additions & 185 deletions

‎CHANGELOG.md‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,11 @@ The package version runs on its own semver; the schema it is generated from is `
44

55
## Unreleased
66

7+
## 0.84.0 (2026-10-29)
8+
9+
- **A graph node's `family` is its type's colour word**: `blue`, `green`, `pink` or `amber`, the value the schema distribution's `presentation.json` now gives each type, in place of `agents`, `world`, `abstract` or `temporal`. The key keeps its name, as the lens profile's node does; the word is a key for drawing the 22, never a classification or a label. Two types move group: **Construct is pink** (was `world`, green) and **Ability is amber** (was `abstract`, pink); the four hexes are unchanged. A tool that matched on the old words reads the new ones. The generated map behind it, private to the package, is renamed `ELEMENT_GROUPS` (was `ELEMENT_FAMILIES`).
10+
- **Schema repinned to schema-dist `v0.33.0-dist.86`** (from dist.85; the same canonical 00.33.00, so `SCHEMA_VERSION` stays and no type or field moved; the folder lint and `FORMAT_VERSION` stay at 0.3.20). Serial 86 keys the presentation defaults' colour groups by their colour words, rules in the lens profile that a node's `family` is that word, and replays it in `lens.fixture.json`, whose 151 cases (37 graph) all pass. The address profile gains a sentence on what a pin's, a marker's or a zone's address answers on the site; nothing in this package restates it. Tests: the map against the vendored `presentation.json` for every type, Construct pink and Ability amber, and every node of every fixture graph case carrying its type's word.
11+
712
## 0.83.2 (2026-10-29)
813

914
- **The doctor's flag 11 no longer reports an unmarked Law with supertype Charter.** The checks profile at schema-dist serial 85 rules that such a Law is lore, not a Charter and not a finding, house rules or not; the doctor followed the older reading and named one carrying `x_checks_rules` as a finding. Its rules are still never applied, on a folder and through the API (with `front_door.charter` null too); a marked Charter that is not the newest stays a finding. Tests: three, the unmarked Law newer than the Charter, a world with no marked Charter, and the API's null front door, now assert no finding and no rule applied from it.

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -324,7 +324,7 @@ The world holds the elements as the owner is served them; the reader's `rung` (`
324324

325325
`DATE_FIELD` is the profile's date table (each dated type's date field; the ten timeless types are not in it), and `date_of(el)` is an element's date as that table reads it: the whole number in its type's date field, else `None`. A timeline or a horizon dates elements exactly as the lens reader's fence does.
326326

327-
`world_graph(world, reader, *, lens=None, as_of=None, clock=None, rooms=False, hidden=False, proposed=False, map_space=False)` reads the same snapshot, for the same reader, as nodes and edges: `nodes` (`{id, type, name, family, icon}`, by id), `edges` (`{source, field, target, index}`, one per link, by source, field and index), `edges_cut` (links to elements that are not nodes, by reason; with a lens, `outside_lens` counts links to elements the reader sees that the lens left out), `cut` and `unreadable` (the `x_lens` key a lens could not be read by, else `None`). Room elements, hidden and proposed ones and map space are out unless a flag brings them back (`hidden` and `proposed` are the owner's alone, and a public reader takes no flag); the reading aids are out too, counted `reading_aid`, and no flag brings them back; with `lens` the nodes are exactly what the lens kept, an aid among them when the lens names its pair in `types`.
327+
`world_graph(world, reader, *, lens=None, as_of=None, clock=None, rooms=False, hidden=False, proposed=False, map_space=False)` reads the same snapshot, for the same reader, as nodes and edges: `nodes` (`{id, type, name, family, icon}`, by id; `family` is the colour word the schema distribution's presentation defaults give the type, `blue`, `green`, `pink` or `amber`, a key for drawing the 22 and never a label), `edges` (`{source, field, target, index}`, one per link, by source, field and index), `edges_cut` (links to elements that are not nodes, by reason; with a lens, `outside_lens` counts links to elements the reader sees that the lens left out), `cut` and `unreadable` (the `x_lens` key a lens could not be read by, else `None`). Room elements, hidden and proposed ones and map space are out unless a flag brings them back (`hidden` and `proposed` are the owner's alone, and a public reader takes no flag); the reading aids are out too, counted `reading_aid`, and no flag brings them back; with `lens` the nodes are exactly what the lens kept, an aid among them when the lens names its pair in `types`.
328328

329329
```python
330330
from onlyworlds import degree_of, world_graph

‎codegen/generate_schema.py‎

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -229,22 +229,23 @@ def public_fields(types: list[str], layout: dict[str, Any]) -> dict[str, list[st
229229

230230

231231
def presentation_keys(types: list[str]) -> dict[str, tuple[str, str]]:
232-
"""type -> (family, icon), the dist's presentation.json ``types.<type>.family`` and ``.icon``: the
233-
first-party presentation defaults a reader hands a tool (the graph's nodes carry them). Every type must
234-
have both, each a non-empty string, and each family one of ``colors.order``."""
232+
"""type -> (colour group, icon), the dist's presentation.json ``types.<type>.family`` (the key keeps its
233+
name; the value is the colour word) and ``.icon``: the first-party presentation defaults a reader hands a
234+
tool (the graph's nodes carry them). Every type must have both, each a non-empty string, and each colour
235+
group one of ``colors.order``."""
235236
presentation: dict[str, Any] = json.loads((DIST / "presentation.json").read_text(encoding="utf-8"))
236237
by_type = presentation.get("types")
237238
if not isinstance(by_type, dict) or sorted(by_type) != sorted(types):
238239
raise SystemExit(f"presentation.json types {sorted(by_type or {})} disagree with ELEMENT_TYPES {types}")
239-
families = (presentation.get("colors") or {}).get("order")
240-
if not isinstance(families, list) or not families:
241-
raise SystemExit(f"presentation.json colors.order is not a list of families: {families!r}")
240+
groups = (presentation.get("colors") or {}).get("order")
241+
if not isinstance(groups, list) or not groups:
242+
raise SystemExit(f"presentation.json colors.order is not a list of colour groups: {groups!r}")
242243
out: dict[str, tuple[str, str]] = {}
243244
for t in types:
244-
family, icon = by_type[t].get("family"), by_type[t].get("icon")
245-
if family not in families or not isinstance(icon, str) or not icon:
246-
raise SystemExit(f"presentation.json types.{t}: family {family!r} or icon {icon!r} is not one")
247-
out[t] = (family, icon)
245+
group, icon = by_type[t].get("family"), by_type[t].get("icon")
246+
if group not in groups or not isinstance(icon, str) or not icon:
247+
raise SystemExit(f"presentation.json types.{t}: colour group {group!r} or icon {icon!r} is not one")
248+
out[t] = (group, icon)
248249
return out
249250

250251

@@ -502,9 +503,10 @@ def wrapped(head: str, names: list[str], tail: str) -> list[str]:
502503
*[line for t in types for line in wrapped(f' "{t}": ', public[t], ",")],
503504
"}",
504505
"",
505-
"# type -> its family and its icon name: presentation.json ``types.<type>.family`` and ``.icon``, the",
506-
"# first-party presentation defaults (not the standard; a tool may override them). Colour stays the tool's.",
507-
"ELEMENT_FAMILIES: dict[str, str] = {",
506+
"# type -> its colour group (the colour word: blue, green, pink or amber) and its icon name:",
507+
"# presentation.json ``types.<type>.family`` and ``.icon``, the first-party presentation defaults (not the",
508+
"# standard; a tool may override them). A key for drawing the 22, never a label. Colour stays the tool's.",
509+
"ELEMENT_GROUPS: dict[str, str] = {",
508510
*[f' "{t}": "{shown[t][0]}",' for t in types],
509511
"}",
510512
"ELEMENT_ICONS: dict[str, str] = {",

‎codegen/schema-dist/MANIFEST.json‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -140,9 +140,9 @@
140140
"fixtures/owworld/UnicodeData-15.1.0.txt": "2fc713e6a31a87c4850a37fe2caffa4218180fadb5de86b43a143ddb4581fb86",
141141
"fixtures/owworld/verdicts.json": "11f00045fb0d510cd550e2823ae52dab437c443b5e2011f7c959750bb4ccb5d3",
142142
"LICENSE": "3235f6ccc2b72375c517c1fdeef87954e8bfda17c5b1b485b98b5c2b4a1026d1",
143-
"presentation.json": "3c20afa9fee3c191c390452f74f415eb999156bbbf966c56beac283fa0ea91a4",
143+
"presentation.json": "f06cd67349c84e92e5a93b28ea36533bd8942ee6e81d708f8d29cfa7f9fc3183",
144144
"profiles/address.fixture.json": "13b321c8244d3d4bce28e25e29b6d8c57b2450187be0cdfcd7380bea36c1ea72",
145-
"profiles/address.md": "67d750ba8925b9b28c7b5a5b1b24601e2f36e352779e0a85a8cd104b5614bc3e",
145+
"profiles/address.md": "857462ca2634d01f6989ffc375e1934391d32da53d3eb8f9df126a0abcecfb47",
146146
"profiles/calendar.fixture.json": "5c50ad60cfd5e0320dab9c709588ddb139b8b22f8320c2d40647940c6e8e321a",
147147
"profiles/calendar.md": "b77b01648cd9491700a3f47710c5012ee99c0e072b0960ae6932d6ac09080646",
148148
"profiles/charter.fixture.json": "566204bdaebab8d3ac15be7b6ea5ab8b83ed393436c21c3a7ad4d3b7314980c6",
@@ -153,8 +153,8 @@
153153
"profiles/import-map.fixture.json": "b008245c94e5cc4c23fd7aa74731ff92522c9cec80347730076b55cb7cba507d",
154154
"profiles/import-map.json": "e36620e93c91800c82b3c40ebe73b7c833f7a041ce68ae474924a05909e20ff1",
155155
"profiles/import-map.md": "ece9e6c0b8a7c7bf90378726b0eb7f07399dd432bff581fdde959bd09ae6e7c1",
156-
"profiles/lens.fixture.json": "b0b18fa18cf205bece20921d2ec52ba03fc68b8d41206ded0418ac22eaa8a460",
157-
"profiles/lens.md": "97252a08ba3c04d201e0f17b37c5408cca958e293e95753bcaac71fad6cc61c4",
156+
"profiles/lens.fixture.json": "2cf7d9878f1746f889e83275a2aa217e0c59d2e784fbba616759457115c72165",
157+
"profiles/lens.md": "061add0534058521ca154893b84ea94671b434363d8cf107e75987606a01dd59",
158158
"profiles/message.fixture.json": "3fef3487adc7d5df65bb29b0be0ccfde82e2df0411ea209ff4272ec1a0949b4b",
159159
"profiles/message.md": "e658df91b2f6582cbd272601cd1fda6959831dcfa1cf1ae3f1fc58cd4f90185f",
160160
"profiles/names.fixture.json": "a3224ef265506869ca7aa0d4848ea6f62ce04b93d4b18588394be0d7982927af",
@@ -165,7 +165,7 @@
165165
"profiles/room.md": "0b33fbd1da0fe1cf5438cecb0266096b3190de11d62fea873dc4c27efca6735a",
166166
"profiles/spine.fixture.json": "82ebcb81841a9697be42f2861befc9e13a2828bd8d566b27c42898a865c88e59",
167167
"profiles/spine.md": "887bfb1e4f89c7a6b3a9472d66d7d84bd4e78f55d41a46260316d083be5f3bfd",
168-
"README.md": "d810ae2ef161ed0a92a8c8dbc877f727e4f80bd94baa514caf5b1f6b93cb0724",
168+
"README.md": "3f431b6619405320ec6e5c4d126a4775097b810359145ff9a3e3deff5d9bd580",
169169
"schema/ability.yaml": "9fb53aa50af02134714e804b7e4c54652b63dd7adc11dd4aef991c64503205fc",
170170
"schema/base_properties.yaml": "ff591e84abab6de530208cd7fde2a60f1185d66e5940072704532e30ea72f4c4",
171171
"schema/character.yaml": "8bf572cb676024e86c4f7502a0b7f5bdfb2531071633f6f184e446f4e39efa3a",
@@ -192,7 +192,7 @@
192192
"schema/zone.yaml": "9828429f3172b83b6277c0a71a75a3f4079b8b1eccb2135418a458f2fc80f2b7",
193193
"schema.json": "7cdc0873040b461792393895e8cdd110121691c571f98ec0b60931c86c373158",
194194
"SECURITY.md": "939ee364b06f0b749bdd4cbe66b2fe49322c95abe732650ec4ef062a0c03820a",
195-
"VERSION": "6e3f8b3de259697a528658f3d1ca244eb719af1fbd3768b752ab28d6694eaf72",
195+
"VERSION": "3a1360fed622711099733147ff86c0bcaf35e0ed2cd538d5e1767a3912c918fb",
196196
"walk/lint_folder.py": "83eeb6bbd7128615523445024d9c05350f27a9a6afed0f61ff5c29f3c783458b",
197197
"walk/rulings.yaml": "1fb87ce4012d160b809e0aac50688c62405d2a5e6e303a57df84b98c249374ca",
198198
"walk/schema_walk.py": "e4a490dda5133e3961252cd8675eb39e5b214df68f6a661fa8601ccd69e6aed0"

‎codegen/schema-dist/README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Each serial (one numbered publication of these files, tagged `v<schema version>-
1414
| `schema/*.yaml` | the 22 element types, `base_properties` and `world`: the same content as the standard's YAML. The bytes differ (LF line endings, blank lines), the parsed data does not |
1515
| `example/hyperion/` | Hyperion, the public example world, as a world folder. Every file in it passes the decoded schema |
1616
| `example/world-export.json` | the world-export envelope (`format: onlyworlds-world-export`, the portal's one-file download) for one small fixed world: a single link, a multi-link, an extension field. It is the emitter's own output, pinned by a keel test, so a reader of the envelope tests against the real shape |
17-
| `presentation.json` | default family and icon per type, and the four family colours as light/dark pairs. Defaults: tools may override them. The colours were checked for colour-vision deficiency, so re-run that check before changing one. Each type also lists its `public` fields: what the platform shows of an element a reader knows of but does not see whole, beside its name and description |
17+
| `presentation.json` | default colour group and icon per type (`family` names the group by its colour: `blue`, `green`, `pink`, `amber`, a visual aid for drawing the 22 types, not part of the standard), and the four colours as light/dark pairs. Defaults: tools may override them. The colours were checked for colour-vision deficiency, so re-run that check before changing one. Each type also lists its `public` fields: what the platform shows of an element a reader knows of but does not see whole, beside its name and description |
1818
| `profiles/` | extension profiles: one page per named extension field that tools agree to read the same way (`x_identity_key`, one being in several worlds; `atlas_calendar`, a world's own calendar; `x_packet_*`, a work item's elements with a reason each; `x_review_*`, proposed and checked marks; `room`, a convention profile: the nine type-and-supertype pairs a parlor puts in a world, and the rule that a lore view leaves them out; `message`, a convention profile: a message between a world's members (a Narrative with supertype Message), to whom it is addressed, whether its sender is proved, and each reader's read mark; `checks`, machine-checkable house rules on a world's Charter; `x_names`, a world's own words for the 22 types, on the World; `spine`, a world that maps a software ecosystem: a closed list of kinds as supertypes, eleven `x_spine_*` keys, a day count from a stated day 0; `import-map`, per source tool, from that tool's own tags to the 22 types, which an import offers the user and never applies silently, LegendKeeper first; `address`, a convention profile: one element's three spellings, the site's address and the two `ow://` text forms, with an optional moment and lens, and the rule that a field holding one is public text, never resolved; `lens`, a convention profile: a saved way of reading a world (a Construct with supertype Lens), its links the anchors, `x_lens` the recipe (how far, which types, how far back, how much), and the one resolution every reader agrees on; `charter`, a convention profile: a world's reading aids, the Charter (the rules for people and AIs here), the Guide (start here) and the Domains (the places in the world), each marked with `x_charter_of`, and the one packet every tool shows first at a world's door). What it holds, how a reader reads it, what a writer must keep. A profile may carry a data file beside its page (`import-map.json`, the table a door loads). A profile with a `<name>.fixture.json` beside it has a conformance fixture: cases a reader must pass |
1919
| `walk/schema_walk.py` | the reference decoder, in Python: reads the YAML and returns each type's fields. `schema.json` is its output. One module; its only dependency is PyYAML |
2020
| `walk/rulings.yaml` | rulings the YAML cannot carry (nullability, empty strings, extension fields). Code in any language should follow these rows |

‎codegen/schema-dist/VERSION‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
canonical: 00.33.00
2-
serial: 85
2+
serial: 86
33
published: 2026-10-28

0 commit comments

Comments
 (0)