Skip to content

Commit 9bf375d

Browse files
tmoostingclaude
andcommitted
0.99.0: the site's own row says You are here when the surface is onlyworlds; schema-dist serial 101
openers_for gives the site's own row "You are here" when the surface names itself onlyworlds, before "Needs a connection", as a tool's own row did; three cases in the shared openers fixture (57, the same bytes as the npm SDK's), red on the old code. The pin moves to serial 101, a sentence on the strand page. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 2aee084 commit 9bf375d

10 files changed

Lines changed: 147 additions & 18 deletions

File tree

‎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.99.0 (2026-10-31)
8+
9+
- **`tool="onlyworlds"` is the site itself.** `openers_for` gives the site's own row "You are here" when the surface names itself `onlyworlds`, before "Needs a connection", as a tool's own row already did. Three cases in the shared openers fixture (57 now, the same bytes as the npm SDK's).
10+
- **The schema pin moves to schema-dist serial 101** (`v0.33.0-dist.101`): a sentence on the strand page (a surface that only reads may draw the filled slots alone); no schema file moved, the strand fixture unchanged.
11+
712
## 0.98.2 (2026-10-31)
813

914
- **`draught()` refuses a Character id that is not one path segment, as every other call refuses its type, id and field.** It put `character_id` into the path as given, so an id carrying a `/` or `?` asked a different route; it now raises `ValueError` before anything is sent. A test reads every request path in the client's source and fails on one built from a value that is not checked or quoted.

‎codegen/schema-dist/MANIFEST.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -167,7 +167,7 @@
167167
"profiles/spine.fixture.json": "82ebcb81841a9697be42f2861befc9e13a2828bd8d566b27c42898a865c88e59",
168168
"profiles/spine.md": "887bfb1e4f89c7a6b3a9472d66d7d84bd4e78f55d41a46260316d083be5f3bfd",
169169
"profiles/strand.fixture.json": "f5bd8d85fdec97883e403a407d30cfa8b0a236001616ef6fee246cad8410a975",
170-
"profiles/strand.md": "64378917e16a7fb9862d7440e1dd6fa188a36e9f7fca52bcf23b50202a90a0f9",
170+
"profiles/strand.md": "3aeece06d7537918b6455d2f7a67806139bd371a3f8555c768454cee456fb169",
171171
"README.md": "ce5d0b9e169204355d1602391c3db0697a094d69f01030336aecff587144d531",
172172
"schema/ability.yaml": "9fb53aa50af02134714e804b7e4c54652b63dd7adc11dd4aef991c64503205fc",
173173
"schema/base_properties.yaml": "ec3724ceb2faca973e431a2e2ff946e55bfb55b6b8d78689b6b22d0cfb7c9a2e",
@@ -195,7 +195,7 @@
195195
"schema/zone.yaml": "9828429f3172b83b6277c0a71a75a3f4079b8b1eccb2135418a458f2fc80f2b7",
196196
"schema.json": "02a50f6589ed3e33ff300cbe19528cf895535658294c051a5d4d1330f00edb5d",
197197
"SECURITY.md": "939ee364b06f0b749bdd4cbe66b2fe49322c95abe732650ec4ef062a0c03820a",
198-
"VERSION": "b7be10e26c74aae471ba3106c21dfe3ce35249e4a41339e74e8432d890d48864",
198+
"VERSION": "1ec53c0fd74d82f521b8898a26b15cd96bfb09aca9e37ac9cd4d6fed179cd191",
199199
"walk/lint_folder.py": "67d1ceab980f4a8f782f9fe31b79f02a79ba08302f0021b1eb87c1c5b3ab2400",
200200
"walk/rulings.yaml": "1fb87ce4012d160b809e0aac50688c62405d2a5e6e303a57df84b98c249374ca",
201201
"walk/schema_walk.py": "e4a490dda5133e3961252cd8675eb39e5b214df68f6a661fa8601ccd69e6aed0"

‎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: 100
2+
serial: 101
33
published: 2026-10-31

‎codegen/schema-dist/profiles/strand.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,6 @@ A slot holds only its own kind: an id of another kind, in the mark or in a paren
3939
3. A lens, a graph, a list or a count treats the five elements as the ordinary elements they are; the strand marks nothing on them.
4040
4. A doctor reports, scoped and by name: a mark whose shape is not the profile's, or whose set id is in no known format; a set id that is not of its kind, not in the world, or not in its parent's list; a hero with no `location`; the same id in two slots. None of these is an error to a person; each is the next thing to make.
4141

42-
**Where it shows.** Three surfaces draw the same five slots: a tool's home for a world (Atlas Home: the slots as the first steps of an empty world, the picture beside them as the world grows), the site's Make door (what a visitor makes before an account is a strand, written with the mark at "keep this world"), and the Constellation's Create door (the same four elements, the same four links). The packages read it; keel serves the key by rule 1. A public page's hero drawn from the strand, a pack shipping a strand's shape, an import proposing one from the most-linked Narrative: later, not now.
42+
**Where it shows.** Three surfaces draw the same five slots: a tool's home for a world (Atlas Home: the slots as the first steps of an empty world, the picture beside them as the world grows), the site's Make door (what a visitor makes before an account is a strand, written with the mark at "keep this world"), and the Constellation's Create door (the same four elements, the same four links). The packages read it; keel serves the key by rule 1. A public page's hero drawn from the strand, a pack shipping a strand's shape, an import proposing one from the most-linked Narrative: later, not now. The empty slot as the next thing to make is a writer's rule: a surface that writes the strand draws all five slots, the empty ones as the next step; a surface that only reads (a read-only home, a public page) may draw the filled slots alone, and still shows a half-built strand as the strand (the story alone is one), never fills a slot from another, and never calls an empty one an error.
4343

44-
**Ruled**: Skeld, 2026-10-30: the concept Titus's (a miniature of a world; a story, not THE story; story first; then and now kept apart), the links read off the standard's YAML files, the three-id mark on a tool author's question about list order, the no-fallback reading; serial 98, with the fixture beside this page. Serial 99 (2026-10-30): only `narrative` is required, on a second tool author's seam (a strand begins when the story is chosen), with the strictness on the other two members a reader asked for. Serial 100 (2026-10-31): rule 2 made definite on a reader's point: the front door serves the reading as `reading_aids.strand`, and the charter profile's order names the strand fourth.
44+
**Ruled**: Skeld, 2026-10-30: the concept Titus's (a miniature of a world; a story, not THE story; story first; then and now kept apart), the links read off the standard's YAML files, the three-id mark on a tool author's question about list order, the no-fallback reading; serial 98, with the fixture beside this page. Serial 99 (2026-10-30): only `narrative` is required, on a second tool author's seam (a strand begins when the story is chosen), with the strictness on the other two members a reader asked for. Serial 100 (2026-10-31): rule 2 made definite on a reader's point: the front door serves the reading as `reading_aids.strand`, and the charter profile's order names the strand fourth. Serial 101 (2026-10-31): the reader's rule under Where it shows, on a read-only home's question (empty slots are a writer's next step; a reader may draw the filled slots alone); no fixture change.

‎codegen/schema-pin.json‎

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,20 @@
22
"_what": "The recorded pin for the vendored OnlyWorlds schema distribution (codegen/schema-dist/, copied byte-exact). Do not edit by hand; re-vendor from the pinned tag and review the diff. Kept equal to the npm SDK's pin (github.com/OnlyWorlds/sdk, codegen/schema-pin.json) on purpose: two clients, one schema.",
33
"_why_manifest_sha256": "Verifying the tree against its own MANIFEST.json only proves internal consistency. If the tag moved, the manifest moved with it. The hash recorded here is the one first accepted, which is what makes a moved tag visible.",
44
"repo": "https://github.com/OnlyWorlds/schema-dist",
5-
"tag": "v0.33.0-dist.100",
6-
"commit": "6ae742c9cfcdfc3f9bdff45891922260dd2501d1",
7-
"manifest_sha256": "20cfc3b4bf2098c2bd22be8542cbe770717db1f468ce5e88a1de4929bfe89721",
5+
"tag": "v0.33.0-dist.101",
6+
"commit": "4cfb0a52838042f7ccc2c41bd519fa425b43c582",
7+
"manifest_sha256": "c42d43b385da46fcb4bb64df4072bb1a8b404ed028c9536eb9c37c50c33f5036",
88
"canonical_version": "00.33.00",
9-
"dist_serial": 100,
9+
"dist_serial": 101,
1010
"published": "2026-10-31",
1111
"pinned_at": "2026-10-31",
1212
"pinned_by": "The maintainer: tree from `git archive` of the tag in a schema-dist checkout (198 files: the 197 the MANIFEST lists, and MANIFEST.json itself); files re-hashed against MANIFEST.json by generate_schema.py; MANIFEST self-hash matched against the raw file GitHub serves at the tag, whose ref resolves to the commit above.",
1313
"previous_pins": [
14+
{
15+
"tag": "v0.33.0-dist.100",
16+
"manifest_sha256": "20cfc3b4bf2098c2bd22be8542cbe770717db1f468ce5e88a1de4929bfe89721",
17+
"note": "superseded by v0.33.0-dist.101 (profiles/strand.md's Where it shows: the empty slot as the next thing to make is a writer's rule; a read-only surface may draw the filled slots alone, a strand begun still shown; strand.fixture.json unchanged at 26 cases; no schema file moved)"
18+
},
1419
{
1520
"tag": "v0.33.0-dist.99",
1621
"manifest_sha256": "cc7457288f92dcff0abd2d6828637c26c8be0ff5adeaf4ab7ee439622c1412ab",

‎src/onlyworlds/_schema.py‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
# GENERATED by codegen/generate_schema.py from the vendored schema distribution. Do not hand-edit.
22
# Regenerate: python codegen/generate_schema.py (CI/test: --check)
3-
# Source: https://github.com/OnlyWorlds/schema-dist @ v0.33.0-dist.100 (6ae742c9cfcdfc3f9bdff45891922260dd2501d1)
3+
# Source: https://github.com/OnlyWorlds/schema-dist @ v0.33.0-dist.101 (4cfb0a52838042f7ccc2c41bd519fa425b43c582)
44

55
"""Schema provenance, the 22 element types and their fields, from the pinned schema distribution."""
66

7-
SCHEMA_DIST_TAG = "v0.33.0-dist.100"
7+
SCHEMA_DIST_TAG = "v0.33.0-dist.101"
88
SCHEMA_VERSION = "00.33.00"
9-
SCHEMA_DIST_SERIAL = 100
10-
SCHEMA_MANIFEST_SHA256 = "20cfc3b4bf2098c2bd22be8542cbe770717db1f468ce5e88a1de4929bfe89721"
9+
SCHEMA_DIST_SERIAL = 101
10+
SCHEMA_MANIFEST_SHA256 = "c42d43b385da46fcb4bb64df4072bb1a8b404ed028c9536eb9c37c50c33f5036"
1111

1212
# Canonical order, as the walk declares it.
1313
ELEMENT_TYPES: tuple[str, ...] = (

‎src/onlyworlds/_version.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
__version__ = "0.98.2"
1+
__version__ = "0.99.0"

‎src/onlyworlds/openers.py‎

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,8 @@ def openers_for(
8282
"""The rows of the Open with menu for a world (``kind="world"``) or one element of it (``"element"``), in order.
8383
8484
First the site's own row (id ``onlyworlds``, name ``onlyworlds.com``, the world's or the element's page on
85-
www.onlyworlds.com, for every audience, its one word "Needs a connection" when offline), then one row per
85+
www.onlyworlds.com, for every audience, its one word "You are here" when ``surface["tool"]`` is ``onlyworlds``
86+
(the site itself), else "Needs a connection" when offline), then one row per
8687
``tools`` row, in the list's order, that is ``listed`` and has a door for this kind. ``tools`` is the tools
8788
list's rows, ``TOOLS`` or the list as served; ``address`` is an ``AddressReading`` from ``parse_ow_link`` or
8889
what ``element_address`` takes, with the world's id. A lens and a moment on it ride on no href.
@@ -173,7 +174,12 @@ def offline(href: str) -> bool:
173174

174175
site = page if kind == "element" else element_address({"form": "human", "world": world})
175176
rows: list[Opener] = [
176-
{"id": "onlyworlds", "name": "onlyworlds.com", "href": site, "state": _OFFLINE if offline(site) else None}
177+
{
178+
"id": "onlyworlds",
179+
"name": "onlyworlds.com",
180+
"href": site,
181+
"state": "You are here" if tool == "onlyworlds" else _OFFLINE if offline(site) else None,
182+
}
177183
]
178184
for r in tools:
179185
if not isinstance(r, Mapping) or not isinstance(r.get("id"), str) or not isinstance(r.get("name"), str):

‎tests/fixtures/openers.fixture.json‎

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1369,6 +1369,119 @@
13691369
}
13701370
]
13711371
},
1372+
{
1373+
"name": "site-you-are-here",
1374+
"why": "tool onlyworlds is the site itself: its own row says You are here, every other row as before",
1375+
"tools": "three",
1376+
"kind": "world",
1377+
"address": {
1378+
"form": "human",
1379+
"world": "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f"
1380+
},
1381+
"surface": {
1382+
"audience": "member",
1383+
"tool": "onlyworlds",
1384+
"signed_in": true
1385+
},
1386+
"expect": [
1387+
{
1388+
"id": "onlyworlds",
1389+
"name": "onlyworlds.com",
1390+
"href": "https://www.onlyworlds.com/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1391+
"state": "You are here"
1392+
},
1393+
{
1394+
"id": "zephyr",
1395+
"name": "Zephyr",
1396+
"href": "https://zephyr.example/#/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1397+
"state": null
1398+
},
1399+
{
1400+
"id": "bramble",
1401+
"name": "Bramble",
1402+
"href": "https://bramble.example/open/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1403+
"state": null
1404+
},
1405+
{
1406+
"id": "corvid",
1407+
"name": "Corvid",
1408+
"href": "https://corvid.example/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1409+
"state": null
1410+
}
1411+
]
1412+
},
1413+
{
1414+
"name": "site-you-are-here-offline",
1415+
"why": "the site's own row says You are here before Needs a connection, as a tool's own row does",
1416+
"tools": "three",
1417+
"kind": "element",
1418+
"address": {
1419+
"form": "text",
1420+
"world": "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1421+
"type": "character",
1422+
"id": "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a"
1423+
},
1424+
"surface": {
1425+
"audience": "member",
1426+
"tool": "onlyworlds",
1427+
"signed_in": true,
1428+
"online": false
1429+
},
1430+
"expect": [
1431+
{
1432+
"id": "onlyworlds",
1433+
"name": "onlyworlds.com",
1434+
"href": "https://www.onlyworlds.com/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f/character/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a",
1435+
"state": "You are here"
1436+
},
1437+
{
1438+
"id": "zephyr",
1439+
"name": "Zephyr",
1440+
"href": "https://zephyr.example/#/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f/character/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a",
1441+
"state": "Needs a connection"
1442+
},
1443+
{
1444+
"id": "bramble",
1445+
"name": "Bramble",
1446+
"href": "https://bramble.example/open/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f/e/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a",
1447+
"state": "Needs a connection"
1448+
},
1449+
{
1450+
"id": "corvid",
1451+
"name": "Corvid",
1452+
"href": "https://corvid.example/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f/character/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a",
1453+
"state": "Needs a connection"
1454+
}
1455+
]
1456+
},
1457+
{
1458+
"name": "site-you-are-here-public",
1459+
"why": "the public on the site sees its own row as You are here too",
1460+
"tools": "three",
1461+
"kind": "world",
1462+
"address": {
1463+
"form": "human",
1464+
"world": "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f"
1465+
},
1466+
"surface": {
1467+
"audience": "public",
1468+
"tool": "onlyworlds"
1469+
},
1470+
"expect": [
1471+
{
1472+
"id": "onlyworlds",
1473+
"name": "onlyworlds.com",
1474+
"href": "https://www.onlyworlds.com/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1475+
"state": "You are here"
1476+
},
1477+
{
1478+
"id": "corvid",
1479+
"name": "Corvid",
1480+
"href": "https://corvid.example/w/0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f",
1481+
"state": null
1482+
}
1483+
]
1484+
},
13721485
{
13731486
"name": "offline-public",
13741487
"why": "the public's rows say Needs a connection too; the rows that need something are still not there",

‎tests/test_openers.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,8 @@
1414
from onlyworlds import TOOLS, AddressError, openers_for, parse_ow_link
1515

1616
FIXTURE = Path(__file__).resolve().parent / "fixtures" / "openers.fixture.json"
17-
FIXTURE_SHA256 = "5a9ebbc8604d2fc87078fef25156dd2e767605a1b08cb2bec43e37c6bc2fd9db"
18-
CASES = 54
17+
FIXTURE_SHA256 = "351ddec25f3af8cf8ec2c9c901d6ed4719355286467ada091e45d6012f8ed05b"
18+
CASES = 57
1919
WORLD = "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e0f"
2020
ELEMENT = "0199c3a1-7b2e-7c3d-8e4f-5a6b7c8d9e1a"
2121

0 commit comments

Comments
 (0)