onlyworlds 0.1.0__tar.gz

onlyworlds-0.1.0/.gitattributes

@@ -0,0 +1,3 @@
+# One line ending everywhere, so a Windows checkout does not turn the generated
+# src/onlyworlds/_schema.py into CRLF (codegen --check compares it byte for byte).
+* text=auto eol=lf

onlyworlds-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,35 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  gates:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync
+      - run: uv run pytest -q
+      - run: uv run ruff check .
+      - run: uv run mypy --strict src
+      - run: uv run python codegen/generate_schema.py --check
+
+  wire:
+    # keel's own OpenAPI document and the public demo world, read only. Red here with
+    # the gates above green means the server moved under the client, not that a change broke it.
+    runs-on: ubuntu-latest
+    env:
+      OW_OPENAPI: https://www.onlyworlds.com/api/v2/openapi.json
+      OW_LIVE: "1"
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+      - run: uv sync
+      - run: uv run pytest -q tests/test_wire.py tests/test_live.py

onlyworlds-0.1.0/.gitignore

@@ -0,0 +1,6 @@
+.venv/
+__pycache__/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+dist/

onlyworlds-0.1.0/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+The package version runs on its own semver; the schema it is generated from is `SCHEMA_DIST_TAG`.
+
+## 0.1.0 (2026-10-10)
+
+The first release on PyPI. Python 3.12+, no runtime dependencies.
+
+- **The v2 API client** (`Client`): read, write, link operations, bulk, the change feed (`ChangeWalk`), and the error envelope as `ApiError`. It retries busy and gateway answers (`429`, `502`, `503`, `504`) and honours `Retry-After` (`RetryPolicy`). It never retries a wrong PIN, since each retry counts toward locking the key. The transport is swappable (`Transport`).
+- **World folders** (format v0.3.7): `read_folder` and `write_folder`, filenames that match Atlas's, and the World's three unit settings (`length_unit`, `mass_unit`, `distance_unit`) carried like any world key. Reading never changes a file.
+- **Export and push:** `export_world` writes an online world to a folder. `push` sends a folder's edits back as the difference from a copy exported before editing (`plan_push` to preview it, a log to resume it). A run stops at the first answer that refuses the key itself. What push never sends is listed in `NOT_SENT`.
+- **The schema**, generated from schema-dist `v0.31.0-dist.19` (canonical `00.31.00`): `ELEMENT_TYPES`, `FIELD_KINDS`, and the pinned manifest's hash.

onlyworlds-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2025 OnlyWorlds
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

onlyworlds-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.5
+Name: onlyworlds
+Version: 0.1.0
+Summary: OnlyWorlds for Python: the world folder format (read, write, push) and a client for the v2 API.
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# onlyworlds (Python)
+
+OnlyWorlds is an open standard for worldbuilding data: 22 element types (characters, locations, events, laws and the rest) that any tool can read and write. This is a Python client for its API, and a reader and writer for OnlyWorlds world folders (a world as a folder of JSON files). Python 3.12+, no runtime dependencies.
+
+## Install
+
+```bash
+pip install onlyworlds
+```
+
+The newest unreleased code: `pip install git+https://github.com/OnlyWorlds/python-sdk`.
+
+## First run
+
+Moppetopia is a public demo world. Its read-only key, `0000000001`, needs no account:
+
+```python
+from onlyworlds import Client
+
+client = Client("0000000001")
+print(client.get_world()["name"])
+for c in client.list_page("character", filter={"name__icontains": "fluffington"})["data"]:
+    print(" ", c["name"])
+```
+
+```
+Moppetopia
+  Admiral Fluffington
+```
+
+## Your own world
+
+Create a world at [onlyworlds.com](https://www.onlyworlds.com); its keys are on the world's page. A new key is shown once, so copy it then.
+
+- An `ow_r_` key reads, with no PIN: `Client("ow_r_…")`.
+- An `ow_w_` key reads and writes. Writes also send a PIN: `Client("ow_w_…", "…")`.
+- For code that writes, give it its own [agent seat](https://onlyworlds.github.io/docs/development/agents), a key for one tool or script. The seat's key and its `ow_s_` secret (passed as the PIN) work in one world, and you can remove them without touching your account PIN.
+
+Elements are plain dicts:
+
+```python
+writer = Client("ow_w_…", "ow_s_…")
+peak = writer.create("location", {"name": "Dragon Peak"})
+writer.patch("location", peak["id"], {"supertype": "Mountain"})
+
+for character in client.iter_elements("character", expand=["species"]):
+    print(character["name"])
+```
+
+## World folders
+
+A world folder is one JSON file per element, in [the world folder format](https://onlyworlds.github.io/docs/schema/folders). [Atlas](https://atlas.onlyworlds.com), the OnlyWorlds editor, reads and writes the same format.
+
+```python
+from onlyworlds import export_world, read_folder
+
+export_world("moppetopia", api_key="0000000001")
+folder = read_folder("moppetopia")
+print(folder.world["name"], len(folder.elements), "elements")
+```
+
+`write_folder(root, world, elements)` writes a folder from a world dict and a dict of element lists by type. Reading never changes a file, and a file without an id is skipped and left alone.
+
+To send a folder's edits back, keep a copy exported before you edited, then push the difference:
+
+```python
+from onlyworlds import push
+
+result = push("moppetopia-before", "moppetopia", api_key="ow_w_…", pin="ow_s_…", log_path="push.jsonl")
+```
+
+`push` sends only the fields that changed, retries what the server asks it to retry, checks that what came back is what it sent, and logs every write, so running it again skips what already landed. `dry_run=True` shows the plan without sending it.
+
+## Errors
+
+A failed call raises `ApiError` with the API's `code`, `param` (the field that failed) and `doc_url`, and flags for the cases you handle differently: `is_validation_error`, `is_auth_error`, `is_not_author`, `is_owner_only`, `is_id_conflict`, `is_resync_required`, `is_busy`.
+
+## The change feed
+
+```python
+walk = client.walk_changes(saved_cursor)  # None for everything
+for op in walk:
+    ...  # op["op"] is "upsert" or "delete"
+saved_cursor = walk.cursor  # opaque: keep it, don't parse it
+```
+
+## Schema
+
+The 22 element types and each field's kind are generated from the published [schema distribution](https://github.com/OnlyWorlds/schema-dist); `onlyworlds.SCHEMA_VERSION` and `onlyworlds.SCHEMA_DIST_TAG` say which one. The package's own version doesn't track the schema's.
+
+Not yet: typed element models, the account routes, a snapshot writer.
+
+## Develop
+
+```bash
+uv sync
+uv run pytest -q
+uv run ruff check . && uv run mypy --strict src
+uv run python codegen/generate_schema.py --check
+```
+
+Three groups of tests run only when asked:
+
+- `OW_CONFORMANCE_FIXTURE=<path>`: the folder-format conformance fixture from the Atlas repo.
+- `OW_OPENAPI=https://www.onlyworlds.com/api/v2/openapi.json` (or a saved copy): checks the client's routes, parameters and fields against the API's own OpenAPI document.
+- `OW_LIVE=1`: read-only calls against the demo world.
+
+
+## License
+
+MIT. See `LICENSE`.

onlyworlds-0.1.0/README.md

@@ -0,0 +1,111 @@
+# onlyworlds (Python)
+
+OnlyWorlds is an open standard for worldbuilding data: 22 element types (characters, locations, events, laws and the rest) that any tool can read and write. This is a Python client for its API, and a reader and writer for OnlyWorlds world folders (a world as a folder of JSON files). Python 3.12+, no runtime dependencies.
+
+## Install
+
+```bash
+pip install onlyworlds
+```
+
+The newest unreleased code: `pip install git+https://github.com/OnlyWorlds/python-sdk`.
+
+## First run
+
+Moppetopia is a public demo world. Its read-only key, `0000000001`, needs no account:
+
+```python
+from onlyworlds import Client
+
+client = Client("0000000001")
+print(client.get_world()["name"])
+for c in client.list_page("character", filter={"name__icontains": "fluffington"})["data"]:
+    print(" ", c["name"])
+```
+
+```
+Moppetopia
+  Admiral Fluffington
+```
+
+## Your own world
+
+Create a world at [onlyworlds.com](https://www.onlyworlds.com); its keys are on the world's page. A new key is shown once, so copy it then.
+
+- An `ow_r_` key reads, with no PIN: `Client("ow_r_…")`.
+- An `ow_w_` key reads and writes. Writes also send a PIN: `Client("ow_w_…", "…")`.
+- For code that writes, give it its own [agent seat](https://onlyworlds.github.io/docs/development/agents), a key for one tool or script. The seat's key and its `ow_s_` secret (passed as the PIN) work in one world, and you can remove them without touching your account PIN.
+
+Elements are plain dicts:
+
+```python
+writer = Client("ow_w_…", "ow_s_…")
+peak = writer.create("location", {"name": "Dragon Peak"})
+writer.patch("location", peak["id"], {"supertype": "Mountain"})
+
+for character in client.iter_elements("character", expand=["species"]):
+    print(character["name"])
+```
+
+## World folders
+
+A world folder is one JSON file per element, in [the world folder format](https://onlyworlds.github.io/docs/schema/folders). [Atlas](https://atlas.onlyworlds.com), the OnlyWorlds editor, reads and writes the same format.
+
+```python
+from onlyworlds import export_world, read_folder
+
+export_world("moppetopia", api_key="0000000001")
+folder = read_folder("moppetopia")
+print(folder.world["name"], len(folder.elements), "elements")
+```
+
+`write_folder(root, world, elements)` writes a folder from a world dict and a dict of element lists by type. Reading never changes a file, and a file without an id is skipped and left alone.
+
+To send a folder's edits back, keep a copy exported before you edited, then push the difference:
+
+```python
+from onlyworlds import push
+
+result = push("moppetopia-before", "moppetopia", api_key="ow_w_…", pin="ow_s_…", log_path="push.jsonl")
+```
+
+`push` sends only the fields that changed, retries what the server asks it to retry, checks that what came back is what it sent, and logs every write, so running it again skips what already landed. `dry_run=True` shows the plan without sending it.
+
+## Errors
+
+A failed call raises `ApiError` with the API's `code`, `param` (the field that failed) and `doc_url`, and flags for the cases you handle differently: `is_validation_error`, `is_auth_error`, `is_not_author`, `is_owner_only`, `is_id_conflict`, `is_resync_required`, `is_busy`.
+
+## The change feed
+
+```python
+walk = client.walk_changes(saved_cursor)  # None for everything
+for op in walk:
+    ...  # op["op"] is "upsert" or "delete"
+saved_cursor = walk.cursor  # opaque: keep it, don't parse it
+```
+
+## Schema
+
+The 22 element types and each field's kind are generated from the published [schema distribution](https://github.com/OnlyWorlds/schema-dist); `onlyworlds.SCHEMA_VERSION` and `onlyworlds.SCHEMA_DIST_TAG` say which one. The package's own version doesn't track the schema's.
+
+Not yet: typed element models, the account routes, a snapshot writer.
+
+## Develop
+
+```bash
+uv sync
+uv run pytest -q
+uv run ruff check . && uv run mypy --strict src
+uv run python codegen/generate_schema.py --check
+```
+
+Three groups of tests run only when asked:
+
+- `OW_CONFORMANCE_FIXTURE=<path>`: the folder-format conformance fixture from the Atlas repo.
+- `OW_OPENAPI=https://www.onlyworlds.com/api/v2/openapi.json` (or a saved copy): checks the client's routes, parameters and fields against the API's own OpenAPI document.
+- `OW_LIVE=1`: read-only calls against the demo world.
+
+
+## License
+
+MIT. See `LICENSE`.

onlyworlds-0.1.0/codegen/generate_schema.py

@@ -0,0 +1,201 @@
+#!/usr/bin/env python3
+"""Generate src/onlyworlds/_schema.py from the vendored schema distribution.
+
+Build-time only: needs PyYAML (the walk imports it). The generated module has no
+dependencies, so the published package does not need PyYAML at runtime.
+
+The type list comes from THE walk (codegen/schema-dist/walk/schema_walk.py),
+imported, never re-implemented. A second witness is checked on every run: the
+walk's list must equal the dist's schema/*.yaml stems minus the two non-element
+files (base_properties, world). If they ever disagree, generation fails instead
+of picking one.
+
+Order of checks matters: the dist is authenticated (MANIFEST.json against the
+pin) and its contents verified (every file against MANIFEST.json) BEFORE the
+walk is imported, because importing unverified code to answer a question about
+the verified tree would be the complicit-manifest case.
+
+Usage:
+  python codegen/generate_schema.py          write the module
+  python codegen/generate_schema.py --check  exit 1 if the committed module is stale
+"""
+
+from __future__ import annotations
+
+import argparse
+import hashlib
+import importlib.util
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+HERE = Path(__file__).resolve().parent
+DIST = HERE / "schema-dist"
+PIN = HERE / "schema-pin.json"
+OUT = HERE.parent / "src" / "onlyworlds" / "_schema.py"
+
+NON_ELEMENT_SCHEMA_FILES = {"base_properties", "world"}
+
+
+def _sha256(path: Path) -> str:
+    return hashlib.sha256(path.read_bytes()).hexdigest()
+
+
+def verify_dist() -> dict[str, object]:
+    """Authenticate the vendored tree. Returns the pin record. Raises SystemExit on failure."""
+    pin: dict[str, object] = json.loads(PIN.read_text(encoding="utf-8"))
+    manifest = DIST / "MANIFEST.json"
+    got = _sha256(manifest)
+    if got != pin["manifest_sha256"]:
+        raise SystemExit(
+            f"schema-dist MANIFEST.json sha256 {got} != pinned {pin['manifest_sha256']} "
+            "(moved tag, or a re-vendor without a re-pin)"
+        )
+    files: dict[str, str] = json.loads(manifest.read_text(encoding="utf-8"))["files"]
+    bad = [f for f, h in sorted(files.items()) if not (DIST / f).is_file() or _sha256(DIST / f) != h]
+    if bad:
+        raise SystemExit(f"schema-dist files do not match MANIFEST.json: {bad}")
+    version = dict(
+        line.split(": ", 1) for line in (DIST / "VERSION").read_text(encoding="utf-8").splitlines() if ": " in line
+    )
+    if version.get("canonical") != pin["canonical_version"] or int(version.get("serial", -1)) != pin["dist_serial"]:
+        raise SystemExit(f"schema-dist VERSION {version} disagrees with the pin record")
+    return pin
+
+
+# The walk's kinds -> the wire vocabulary the npm SDK's FIELD_SCHEMA uses.
+KIND_NAMES = {"scalar_str": "text", "scalar_int": "integer", "single": "single_link", "multi": "multi_link"}
+# Notes the walk is known to emit on this pin. Any OTHER note fails generation
+# (rulings.yaml: unknown-field-types-must-be-surfaced): silence is how a newer
+# schema meets an older decoder and drops a field.
+EXPECTED_NOTES = ("pin.element: `generic-link`", "relation.events: field declared more than once")
+
+
+def load_walk() -> Any:
+    spec = importlib.util.spec_from_file_location("schema_walk", DIST / "walk" / "schema_walk.py")
+    assert spec is not None and spec.loader is not None
+    walk = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(walk)
+    return walk
+
+
+def field_kinds(walk: Any, types: list[str]) -> dict[str, dict[str, str]]:
+    """type -> {wire field name: kind}. Base fields by a DECLARED mapping (the SDK's):
+    base_properties.yaml names lowercased; `Id` and `World` dropped (identity, and a
+    field the API rejects in bodies). The generic link (pin.element) is served as
+    the pair element_type (text) + element_id (single_link), as the SDK emits it."""
+    schema = DIST / "schema"
+    base_doc = walk.load_yaml(schema, "base_properties")
+    base = {
+        name.lower(): "text"
+        for name, spec in base_doc["properties"].items()
+        if name.lower() not in ("id", "world") and spec.get("type") == "string"
+    }
+    notes: list[str] = []
+    out: dict[str, dict[str, str]] = {}
+    for t in types:
+        kinds = dict(base)
+        for f in walk.flatten_fields(walk.load_yaml(schema, t), t, note=notes.append):
+            if f["kind"] == "generic":
+                kinds[f"{f['name']}_type"] = "text"
+                kinds[f"{f['name']}_id"] = "single_link"
+            elif f["kind"] in KIND_NAMES:
+                kinds[f["name"]] = KIND_NAMES[f["kind"]]
+            else:
+                raise SystemExit(f"{t}.{f['name']}: unknown kind {f['kind']!r} from the walk")
+        out[t] = kinds
+    unexpected = [n for n in notes if not n.startswith(EXPECTED_NOTES)]
+    if unexpected:
+        raise SystemExit(f"the walk raised notes this generator does not know: {unexpected}")
+    return out
+
+
+def generic_pairs(walk: Any, types: list[str]) -> dict[str, list[tuple[str, str]]]:
+    """type -> [(type column, id column)] for each generic link: keel refuses a write that sets one half."""
+    schema = DIST / "schema"
+    out: dict[str, list[tuple[str, str]]] = {}
+    for t in types:
+        pairs = [
+            (f"{f['name']}_type", f"{f['name']}_id")
+            for f in walk.flatten_fields(walk.load_yaml(schema, t), t, note=lambda _n: None)
+            if f["kind"] == "generic"
+        ]
+        if pairs:
+            out[t] = pairs
+    return out
+
+
+def element_types(walk: Any) -> list[str]:
+    from_walk: list[str] = list(walk.ELEMENT_TYPES)
+    from_files = sorted(p.stem for p in (DIST / "schema").glob("*.yaml") if p.stem not in NON_ELEMENT_SCHEMA_FILES)
+    if sorted(from_walk) != from_files or len(set(from_walk)) != len(from_walk):
+        raise SystemExit(f"the walk's ELEMENT_TYPES {from_walk} disagree with the dist's schema files {from_files}")
+    return from_walk
+
+
+def render(
+    pin: dict[str, object],
+    types: list[str],
+    kinds: dict[str, dict[str, str]],
+    pairs: dict[str, list[tuple[str, str]]],
+) -> str:
+    lines = [
+        "# GENERATED by codegen/generate_schema.py from the vendored schema distribution. Do not hand-edit.",
+        "# Regenerate: python codegen/generate_schema.py  (CI/test: --check)",
+        f"# Source: {pin['repo']} @ {pin['tag']} ({pin['commit']})",
+        "",
+        '"""Schema provenance and the 22 element types, generated from the pinned schema distribution."""',
+        "",
+        f'SCHEMA_DIST_TAG = "{pin["tag"]}"',
+        f'SCHEMA_VERSION = "{pin["canonical_version"]}"',
+        f"SCHEMA_DIST_SERIAL = {pin['dist_serial']}",
+        f'SCHEMA_MANIFEST_SHA256 = "{pin["manifest_sha256"]}"',
+        "",
+        "# Canonical order, as the walk declares it.",
+        "ELEMENT_TYPES: tuple[str, ...] = (",
+        *[f'    "{t}",' for t in types],
+        ")",
+        "",
+        "# type -> {wire field name: text | integer | single_link | multi_link}. Schema fields only:",
+        "# anything else on a body is server-managed, a tool's extension, or unknown.",
+        "FIELD_KINDS: dict[str, dict[str, str]] = {",
+    ]
+    for t in types:
+        lines.append(f'    "{t}": {{')
+        lines.extend(f'        "{name}": "{kind}",' for name, kind in kinds[t].items())
+        lines.append("    },")
+    lines += [
+        "}",
+        "",
+        "# type -> ((type column, id column), ...): each generic link's two halves. A write sets both or neither.",
+        "GENERIC_PAIRS: dict[str, tuple[tuple[str, str], ...]] = {",
+        *[f'    "{t}": ({", ".join(f'("{a}", "{b}")' for a, b in pairs[t])},),' for t in types if t in pairs],
+        "}",
+        "",
+    ]
+    return "\n".join(lines)
+
+
+def main() -> int:
+    ap = argparse.ArgumentParser()
+    ap.add_argument("--check", action="store_true")
+    args = ap.parse_args()
+    pin = verify_dist()
+    walk = load_walk()
+    types = element_types(walk)
+    text = render(pin, types, field_kinds(walk, types), generic_pairs(walk, types))
+    if args.check:
+        current = OUT.read_bytes().decode("utf-8") if OUT.is_file() else ""
+        if current != text:
+            print(f"STALE: {OUT} does not match what the pinned dist generates", file=sys.stderr)
+            return 1
+        print(f"ok: {OUT.name} matches {pin['tag']}")
+        return 0
+    OUT.write_bytes(text.encode("utf-8"))  # bytes: LF on every platform
+    print(f"wrote {OUT} ({pin['tag']})")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

onlyworlds-0.1.0/codegen/schema-dist/.gitattributes

@@ -0,0 +1 @@
+* -text

onlyworlds-0.1.0/codegen/schema-dist/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OnlyWorlds
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

onlyworlds-0.1.0/codegen/schema-dist/MANIFEST.json

@@ -0,0 +1,73 @@
+{
+  "files": {
+    ".gitattributes": "705fd4d6451a31d36b3df7de96f83f30ac976c9b4a6d1e51671d8e2f33e2d0da",
+    "example/hyperion/elements/ability/piano-playing--60195ff8.json": "a1ff537bb6db03944aa9aec97daef4d5847ed4bfa7150b71df9d533220f33cf6",
+    "example/hyperion/elements/character/mr-steinway--678bd862.json": "c0c93bff76d76f481a611b8772741d57a8adbb72d05e4465f9d30cf5ade3090c",
+    "example/hyperion/elements/character/rachmaninov--4c0d52b4.json": "15d2b8ee04ba6085b40bc06ef00e65e4fd392472ea47466e2e580b39248fcdee",
+    "example/hyperion/elements/character/the-consul--8b711e25.json": "f2a8c37169628c6109cdbe3bb3416a84ee9d8e1b3439e181cfc347b0be93ef04",
+    "example/hyperion/elements/collective/pack-of-bellowing-saurians--1218fc88.json": "02b87475b540d173ebc3418d8e825e207364cb3e6f87afebd738d6e35609f9f3",
+    "example/hyperion/elements/construct/hegemony-standard--e40d0001.json": "8db776fd7a3faa3a22626f2ca80e825853fa024ca2f4b18ae4070fbd82f5299f",
+    "example/hyperion/elements/construct/rachmaninov-s-prelude--6ebf1c1e.json": "588b1c509827371c4176c1cefd26f562e01e04664c134a3621607f193a38f1b5",
+    "example/hyperion/elements/construct/steinway-piano--d0a334b1.json": "2180305399f14be914b260d95d4859b0ae20a90e1767e103fc8015ae13ac10ad",
+    "example/hyperion/elements/creature/great-green-saurian--8406227d.json": "5dfc5230c54117b2974dee958a9c50623fd31a4c2a2823e255b1b12e75345d80",
+    "example/hyperion/elements/creature/greater-green-saurian--e79a4c7c.json": "af102041d4a69dc745ed29ce1e22db28da79af7c1e5a5927df92a72a2cb59947",
+    "example/hyperion/elements/event/the-primal-performance--8b461fb6.json": "df38b54bad28cf3ba84fed34f34912d389dfe502d34754d9818a8fe51b5fc1ba",
+    "example/hyperion/elements/event/the-raging-of-the-beasts--95bb5602.json": "d1b544e76495ab4bb4cd6bb19e9fa8d68ef7830187e107d4aafc82bb56d7b1d1",
+    "example/hyperion/elements/institution/the-hegemony--b6872c95.json": "69f99fa1e6f1f172eb941059c3b20f9c4e68dce2e6ed97c252c495b1c68e56cd",
+    "example/hyperion/elements/language/western-musical-notation--f856e44c.json": "d9ae2b48e93a8bf079d82520ea51d199baf401d666e107a4d25be198e0a89ae9",
+    "example/hyperion/elements/location/unnamed-planet--6283dd71.json": "f6249cc4920a66330ee90ee66ea5e592648b6812fc8dc0e893a6e00b1d2ea259",
+    "example/hyperion/elements/map/map-of-unnamed-planet--153cd291.json": "d65670dc9baeed1b4c67bcb0e0d7e4349f0d6b2b3bc1a9d25e1fd7a0d989a472",
+    "example/hyperion/elements/marker/swamps-point-0--f42a6e15.json": "925d954946e51a3cbf62e89ee917a71ec5454c9a67ed29fb1dfeeae432dfd3a8",
+    "example/hyperion/elements/marker/swamps-point-1--3f8fe28c.json": "0f8e4d0af04f75a3f6d1a2cd8f3fdd305e88aaa5ea72ccdbafee23488c374826",
+    "example/hyperion/elements/marker/swamps-point-2--811d2c15.json": "9157c840604764336ae40088949d2ec298fef482352bebfa2d31d784725ee2ce",
+    "example/hyperion/elements/marker/swamps-point-3--ea668c31.json": "4cc41e877b2a65ccd98f7ba99269f690a7376077b23d73b210ee3c88fafc8509",
+    "example/hyperion/elements/marker/swamps-point-4--4e843a51.json": "24b489a8a2a569aea6508e0c7b63c087c90fc03d9d7261bca0ef6593149a7efe",
+    "example/hyperion/elements/marker/swamps-point-5--48b3cfa2.json": "46106b8c97e2f95e4973384558e2e5d243fa1e8330c9d5751a3fb2c830e16ba7",
+    "example/hyperion/elements/narrative/chapter-1--39fd9536.json": "551f6a41ab05c7d8b45ca659c540bb8cdd0c2a492341d7e457190fcf2ebfd020",
+    "example/hyperion/elements/narrative/hyperion--bb17eaba.json": "a60867b9d2df1f9451498ac0d17ceb4fb7b911dd624ba02b8d5398d7c4e1feae",
+    "example/hyperion/elements/narrative/new-book--08afd034.json": "294a4efc6067c891dec3eaeec12e4f2137eca9ffc637210bda345dcf6e3bebdf",
+    "example/hyperion/elements/narrative/new-page--2f7bc2f5.json": "1fe86a75bf223a87b44f27b0555604abb9d63661a9ddceee2b0b2514092069b5",
+    "example/hyperion/elements/narrative/story-of-the-old-piano--2a6553ca.json": "dd0db85f8cebe8662c6d518a86cbd45b1301d251bf4538a302d30ad540314ef6",
+    "example/hyperion/elements/object/ebony-spaceship--f4e8e286.json": "ca58edba90b6a50016dac127ee2526247c1ab7b552774faddf1bd83e4ae263fe",
+    "example/hyperion/elements/object/spaceship-balcony--dd75923a.json": "4853b29c222c05d278ab947eb45b7d6dab23135b20db51c015629c167553dafe",
+    "example/hyperion/elements/object/the-consul-s-steinway--75bfd994.json": "514914783bfbd8e91d887cfc06068f020536523dee897aa7d94619c5c9973cdc",
+    "example/hyperion/elements/phenomenon/piano-music--5be90c7d.json": "020b2cc3e7c710ef43ec5ca948e40a911dc698b89da34d2da0dc7ff7c627d699",
+    "example/hyperion/elements/pin/the-consul-s-balcony-seat--df789513.json": "a6f91a3badcc97ef2a1e45cbda608934f773990e212bc4c83f9370b6f1a562c2",
+    "example/hyperion/elements/species/saurians--d24e2d1e.json": "90133114fb8c5f1642370741555f303f05580fbaa0cc63f50bba249d6f5720c6",
+    "example/hyperion/elements/title/consul-of-the-hegemony--241a68ab.json": "4723020b824c3abd22b3d2e20d23521ac68fbd3e2198527539fadfabf91cf1f3",
+    "example/hyperion/elements/trait/swamp-rage--dff0708a.json": "6bd7a73f73f9a8c37d8ca603af8209c75251ad524aa485fc06538a63c0123588",
+    "example/hyperion/elements/zone/swamps--d138f887.json": "d9e9caf3360daaecee51dab9716c7e4a444b47736284c0a6b4269d8b84ae2c45",
+    "example/hyperion/world.json": "eeaa6f45d6c232e7aae2114a40eb68a7d30fa7eadcb9e51e6a77908db8d738bb",
+    "LICENSE": "ab9469f20388ba53771315ed7cb94461d5e3de6e0113bd8f0280f3364434fe18",
+    "presentation.json": "776b5e48d9b27c1d99baabfdaffe7d2fe3995580450452c26e5ab7e30176264f",
+    "README.md": "0478b0be204b8683b3f8ea2da37d3ba3cc968a3ed6aa81c994c99242e5773892",
+    "schema/ability.yaml": "9fb53aa50af02134714e804b7e4c54652b63dd7adc11dd4aef991c64503205fc",
+    "schema/base_properties.yaml": "9d1d6b11ebae8405a3d9845fe8b186059c57e8f7474c9a0665d229025396cb2c",
+    "schema/character.yaml": "8bf572cb676024e86c4f7502a0b7f5bdfb2531071633f6f184e446f4e39efa3a",
+    "schema/collective.yaml": "da660c6bb2bfb4d2a2aeef958590a334dd86112477ae8112d9bf520b1a7d06f8",
+    "schema/construct.yaml": "0f2233208e03fa8cfd60ac1fd51cae2078713e8ca3f227437f4d3e520e7e3a6f",
+    "schema/creature.yaml": "66c8b7123614c4ef506386aae9a077d11babbb1ad365986ffcdb879100403c58",
+    "schema/event.yaml": "5843fd04bdfca18934c37c31c1f21777780bad7381bf4b3a8e731f21e4d99558",
+    "schema/family.yaml": "2f3b9225d46c15138b714d4ac5157b1ea2f837a2046431454c22ded226a1f5ba",
+    "schema/institution.yaml": "8f1912ce0588315eb982b7b32b72dbd2d641dce235533e33527b51767e7075e4",
+    "schema/language.yaml": "272fdc87bfaf3b91ca19df7354ba0a1986d9933612a740e0c8cfcc9e86033f78",
+    "schema/law.yaml": "51a35f12128ed6cb0069086aebc2523694373a50fff659657109210264ef3dd8",
+    "schema/location.yaml": "6833171e55989468f11105cfad7ac2b1d7812b112392765dc2572fd03a80ab57",
+    "schema/map.yaml": "5a3ee73f68f4c096c9969b4bcec44e0c4d6be4e826d0496f1cf7e81736d10375",
+    "schema/marker.yaml": "2843eff80fc4360e0d8e9fca5ade1c9337d88c99089a79182e3454e8056d3ed0",
+    "schema/narrative.yaml": "d5ab13a6278e8fc72ffca1ed2429bc2dc73e6ea999396c3825a0ac68b80f4e21",
+    "schema/object.yaml": "697a853295302aa036fbf26190b8b754a5d177675d97421cab52026ffe1bb2f9",
+    "schema/phenomenon.yaml": "27dc2d0557fb4d5e9b08769b989dfb19c61ead77670c34e152ef1462918fdd16",
+    "schema/pin.yaml": "2554639d3bc0ef3be6477253c3486521b01e26f7eb6ec38c870120e9257486b1",
+    "schema/relation.yaml": "40be0989442bddeb84d11762250c92e6026065d174ae32d3a00c2c650d857823",
+    "schema/species.yaml": "6df722fe713b1b5adbde591b4664e808292126b489d99c7b469349b5af7e6cd5",
+    "schema/title.yaml": "36ef98440f238c731bdb433102fda890794cde31031e05ce8fe56b70801e96ad",
+    "schema/trait.yaml": "261df723f603809d71c9ddf5faf27a0f0ba92186f544e56cea95911051d2359d",
+    "schema/world.yaml": "f4e875e80802a77f21afe8334cdb5918299d64cb52007abd050b131d59cf9d04",
+    "schema/zone.yaml": "9474902bf71703ac82495b28ad253266edc0ffc69894ac8846e3934b268c81a5",
+    "schema.json": "9ebf22d585e30d72dd4d17a1b09016d620a5ef0b2b806c5d0800efb0588bbb2e",
+    "VERSION": "5a20f5f044a10a717a369d6424dacf43d299b8cebfa3e1e23cad12cfda42aea8",
+    "walk/rulings.yaml": "75fff534c7dd47763ba79d489a31c7792b4f0569e5d3cbbf44f46e677e92deef",
+    "walk/schema_walk.py": "519f431f496e28b2745d6c3773ecbd0174b26175b10fcf49eb527aaed43b895b"
+  }
+}