Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,13 @@ The package version runs on its own semver; the schema it is generated from is `

## Unreleased

## 0.135.0 (2026-11-19)

- **The schema pin moves to `v0.34.1-dist.136`** (serials 135 and 136; canonical 00.34.01 unchanged, no schema file moved, `_schema.py` changes only its provenance lines). Serial 135 adds a talk on an Object or a Construct to the room and report pages, the design state to the charter page (and that a Charter the hidden mark keeps from a reader is not that reader's), and three new fixture lists; serial 136 adds the packet page's `standing` state, `x_packet_from` and its first fixture, which no reader in this package reads yet.
- **`talks_of(element)`**: the talks on an Object or a Construct that a line in the room (`narrative` + `Message`, with the mark) is in, each `{type, id}` from its `objects` and `constructs`, the id as written; `[]` for anything that is no line.
- **`report_talks_of(narrative)`**: the talks a reader shows a report with, every Object and Construct its `objects` and `constructs` name, read as `talks_of` reads a line's; `[]` for a Narrative that is no report.
- **`design_parts_of(world, reader)`**: the design parts a reader reads, each `{type, id, state}`, an Object or a Construct served whole whose `subtype`, trimmed and folded, is `in design` or `locked`, only when `charter_of` finds a Charter for that reader; `[]` otherwise.
- Tests: the room fixture's 13 talk cases, the report fixture's 6 and the charter fixture's 13 design cases, each its own test, and the package's own cases beside them.
- Tests: CI runs the whole suite against the built wheel, installed in place of the source tree (on Python 3.12), and checks that the wheel holds every tracked file of the package and nothing else. A wheel built without the vendored folder checker failed both, where the source run passes. The release runs the suite against the wheel it uploads, too, before publishing.
- Tests: every Python example in the README is type-checked with `mypy --strict` against the installed package, each block on its own, so a renamed function, a keyword or an export the package no longer has fails before the README ships.
- README: the folder example now checks that `folder.world` is present before reading its name (`None` when `world.json` is missing or unreadable), so it type-checks under `mypy --strict`.
Expand Down
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -309,6 +309,8 @@ A lore view (a list, a count, search, a graph, a story's context, a survey) leav

`charter_of(world, reader)` reads the three aids as one reader sees them, the packet a front door shows first: `{charter, guide, domains}`. `charter` is the newest marked Charter (`{id, name, rules, skill}`: its `x_checks_rules` as stored, and the Objects its text names, by any `ow://` form, a site address or a bare id, that the reader sees, at most five), `guide` the newest marked Guide (`{id, name}`), and `domains` every marked Domain the reader sees (`{id, name, sentence, hubs}`), in the Guide's order first, then by name. `domains_of(world, reader)` is the list alone. The world and the reader are the lens reader's (below); a world open to anyone carries `open: True`, and a public reader of any other world reads nothing. The API serves the same packet as `reading_aids` on `GET /me`. The profile: [`profiles/charter.md`](https://github.com/OnlyWorlds/schema-dist/blob/main/profiles/charter.md).

`design_parts_of(world, reader)` lists the design parts that reader reads, each `{type, id, state}`: when `charter_of` finds a Charter for the reader, every Object or Construct served whole (never a known-of stub) whose `subtype`, trimmed and folded, is `in design` or `locked`. With no Charter for that reader it answers `[]`, and `locked` is an ordinary subtype. `talks_of(element)` reads the talks a line in the room is in: each id in its `objects` as `{"type": "object", "id": ...}` and each in its `constructs` as `{"type": "construct", ...}`, read as written; anything that is no line answers `[]`. `report_talks_of(narrative)` reads a report's `objects` and `constructs` the same way: the talks a reader shows the report with.

### Lenses

A lens is a saved way of reading a world: a Construct with supertype `Lens` (`is_lens(el)`) whose links are its anchors and whose `x_lens` is the recipe (`depth`, `types`, `window` or `from` and `to`, `undated`, `changed_within`, `show`, `budget`, `mail`, `notes`). `resolve_lens(world, lens, reader, as_of=None, clock=None)` resolves it for one reader over a world snapshot, the same answer as the npm SDK's `resolveLens`: the kept ids and their rows in the profile's order, the cut counted by reason, and the mail part when the lens names a mail rule. A template (`is_template(el)`, subtype `Template`) resolves to nothing; `lenses_in_use(membership, character.get("x_lens_uses"))` gives the lenses a seat reads (the membership's choice wins).
Expand Down
17 changes: 9 additions & 8 deletions codegen/schema-dist/MANIFEST.json
Original file line number Diff line number Diff line change
Expand Up @@ -146,8 +146,8 @@
"profiles/address.md": "2fd4fe31e90d51818ba48e52e64ffcbdfa0a6a9e1404d7cca85646c52b2b5fd9",
"profiles/calendar.fixture.json": "0a013c3732eda70a42c4eab30555669af28983a5ba9f4a233addf0f06bedb4cd",
"profiles/calendar.md": "c81c63a46eb886cb9aeedf3a668f117ffc626ff711ee2b23a2a8a402b81c7c82",
"profiles/charter.fixture.json": "ba80d4e276ed81a7c185dcd66c3d6ea7af9c9e49fb947bacde2d52136acb2cd5",
"profiles/charter.md": "f61a4958602bd9f8f466c0660e8ae1aff5e6fc6da397c5c493d971a8bfe286ca",
"profiles/charter.fixture.json": "972eda71e3538310df7ccd4166a2e7f2807eb55b6f512a03ced28c9220ea668a",
"profiles/charter.md": "0c4c87172bb6dc94ff3cc41751616580c9082460e5ffc750c661536e2f5a6913",
"profiles/checks.fixture.json": "43586fddd94ebe9678bf46e6d744768a094f856b668c5917fe9e0dda46599251",
"profiles/checks.md": "6778b7e6b9cebc447486e5679ef6036dbf2f8c875c70a2f0f55660fc2c885ce9",
"profiles/identity.md": "bb631fe3cae3cc7b57f1c866ebac496bb426ad0cb661ff5fdec928cccffe1616",
Expand All @@ -166,15 +166,16 @@
"profiles/message.md": "768e09ef6370deb2af331da8d665128746553498da2cb6e065bbdcaa326d6d2c",
"profiles/names.fixture.json": "7d012081b5df7bab3e2223333f87a347417c3061c62b38947fc952e8c4d2377a",
"profiles/names.md": "401e1c37624d01f43304924374009e5ae89949503a8bc3ff8bc3ddce11ba38cd",
"profiles/packet.md": "c1996f357f5d7562741d1a5d842190cba97cfb27d35de5caba41fea6ccd13c5b",
"profiles/packet.fixture.json": "b9f7799f5278b27caca06505d9c3863874f324d6718f652936b823a34de82b90",
"profiles/packet.md": "1bdf9770a03a28a3fbe93326a4f06150a50aa76cd227ba917bbf50159e0ea5e0",
"profiles/record.fixture.json": "a0dc588db339eeb9ae2732a6828af34412235ac8a9aaa27bef566391685f611e",
"profiles/record.md": "b2c7a083a64010bab653675cad08c23d8e4402074730a72a87518622dc2cde2f",
"profiles/report-lines.fixture.json": "2face7cd693235d806e34d3884164b6934a78a299fb77f5ac283b89374e1b47a",
"profiles/report.fixture.json": "c87c6165829858b58126bc5ccab2391647e8e4971a46deee39dde9b5d1f3593e",
"profiles/report.md": "7650eb4013337bff5d4b51dcf0ddf01e67cfeac97300c92013b17de1c6a66b70",
"profiles/report.fixture.json": "0d83ce1ee76f93c79b786bb10e1e97bfb94c6983a8b3b00d1867e65f03722e94",
"profiles/report.md": "e459ffcd5cdcbb493a61eb29302ae4cfffc7a28a21ad8b2f58984819e8195132",
"profiles/review.md": "aae3ad18b6275e146f9146c6fc7d6da04f7d1582b240444edf07ba97e5c8f67b",
"profiles/room.fixture.json": "a1700126b8025d3b5f31c5542c3e6a50e623e915086ef6834fe7905086bc41b3",
"profiles/room.md": "27472fe099e37a0c0c22a66c66bf48b99f42a37b51b22f9102970735579d3b2d",
"profiles/room.fixture.json": "43d84e0012537a9899f67bd1950b7223b0c2b4ff87e57cfab395a232e44a85c7",
"profiles/room.md": "6555063aec83e34fc4f3babf3d0561cd2920b2358735240c53afb57e0e4817a4",
"profiles/spine.fixture.json": "84a130adf7eb0d4d981cf71b4f4f5914484fdc332904751259ba01cb45c56267",
"profiles/spine.md": "6bd367c3f4b101878fbc54a3c8c806630b7760173f24fef995db801b6103d92e",
"profiles/strand.fixture.json": "7bc2d2dae11c0722b1db987c070b249ddcbc55b81683c4bfa26900c7ffe0fc53",
Expand Down Expand Up @@ -206,7 +207,7 @@
"schema/zone.yaml": "cca04ee498fb813fa18b96f1ac99816e7f1a8ae1fb9e21c48b37620dbb674856",
"schema.json": "581dc7b5e890acc06b1c89b0d7bdcc2f20f54f52d5a3b4af8c5a184e1e6fd48c",
"SECURITY.md": "939ee364b06f0b749bdd4cbe66b2fe49322c95abe732650ec4ef062a0c03820a",
"VERSION": "d9951b2802d73c34c49e9a75661458239102b3999ab3b95891def07238a00577",
"VERSION": "b92f129c447a35f30782f0f319ca9c17e2f4c1ce849e93b8e234068e48a48b0f",
"views.fixture.json": "6fda45c2d36cc82a613a4b4d99d14ba9646db2c5bf912b82e68c6b62b20441c1",
"views.json": "f4d06ee16bd6c66fc28cf27146b8d199c85164e5deecabafc23af53408746fe0",
"walk/lint_folder.py": "28efffa3a39d7f2ceaf69cae5c4ddce023e4989e7a5d2c26c1b4d4815eff386e",
Expand Down
4 changes: 2 additions & 2 deletions codegen/schema-dist/VERSION
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
canonical: 00.34.01
serial: 134
published: 2026-11-17
serial: 136
published: 2026-11-19
Loading
Loading