@hyprune/schema 0.9.0 → 0.11.0

package/CHANGELOG.md

@@ -434,3 +434,44 @@ Draft only; no version changes. `v0.10/object.schema.json` and the validator:
 ## @hyprune/schema 0.9.0 (2026-10-13)
 
 Publishes IPC 0.24: `objects.catalog` entries carry a placed machine's declared inputs (`machine`), and a new `live` state key reports each placed machine's source, status and per-input values (published only on change). Inherited from 0.23 otherwise; no new grant. Also the object 0.10 draft additions for gauges: the `average` mapping modifier, `levels` slots (fill/slide with spring) and stack rate, cap 100 and signed spacing.
+
+## IPC 0.25 (draft): companions (RFC-0010 companions amendment)
+
+- Methods (grant `objects.control`): `companion.set {ref}` (a companion-capable
+  library or user catalog ref), `companion.clear {}` and `companion.mode {mode:
+  follow|stay}`; each returns `{revision}`. Existing methods take the reserved
+  object id `companion`: `npcs.bind` (a route or a standing spot), `paths.draw
+  {bind}` and `interaction.choose`. No new grant, no new event.
+- Required state key `companion {ref|null, name|null (<=32), state
+  (none|loading|unavailable|active|waiting|hidden), reason|null (<=64), mode
+  (follow|stay|route), path|null (qualified path ref), activity|null
+  (following|walking|running|idle|talking|sitting|waiting|carried),
+  position|null, carried}`.
+- `objects.catalog` entries gain required `companion`: null, or `{capable,
+  name, reason|null}`.
+- `npcs.aimed.interactions[].type` gains `companion` (Stay and Follow).
+- Everything else is inherited from 0.24 unchanged; `session.hello` reports
+  `0.25`. Inheritance test included.
+
+## Object format 0.10 (draft): companion block
+
+- Optional `companion {name? (1-32), followDistance? (1.5-2.5 m), idles?
+  (<=4 unique clip names), say? (<=8 lines of <=160 characters)}`, only on
+  characters; idle variants must be clips of `traits.character` and not
+  canonical RFC-0010 clip names (`talk` is a new canonical name).
+
+## @hyprune/schema 0.10.0 (2026-10-13)
+
+Publishes IPC 0.25: companions. `companion.set`, `companion.clear` and `companion.mode` (follow or stay), a required `companion` state key, a companion capability on catalog entries and the aimed interaction type `companion`; and the object 0.10 draft `companion` block (name, followDistance, idles, say). Inherits 0.24.
+
+## @hyprune/schema 0.11.0 (2026-10-13): registry documents
+
+Registry documents (RFC-0015), versioned independently under `registry/v0.1/`:
+`index.schema.json` (index documents; `$defs.entry` for registry entry files),
+`release-record.schema.json` and `sources.schema.json`. `validateRegistry(kind, doc,
+version?)` for kinds `registry-index`, `registry-entry`, `release-record` and `sources`
+checks unique ids, versions unique and newest first (SemVer, no build metadata), tags
+naming their version (`v<version>` or `<name>-v<version>`), SPDX licences, per-type
+archive limits and custom source rules. New exports: `registryVersions`,
+`registryLimits`, `parseSemver`, `compareSemver`, `tagVersion`. The CLI accepts the four
+registry kinds. The package ships `registry/`. World formats and IPC are unchanged.

package/README.md

@@ -2,7 +2,7 @@
 
 > **Hyprune** is an explorable, world-driven desktop environment for Hyprland: your workspaces become places you can walk through, with live windows on the walls. This repository holds the versioned **schemas** for world packages, IPC and manifests, and their validator. Install Hyprune through the [hyprune](https://github.com/hyprune/hyprune) repository (starter kits, Nix, Arch); learn more at [hyprune.com](https://hyprune.com). Licence: MIT.
 
-Versioned contracts for Hyprune, a world-driven Hyprland desktop: world packages (formats 0.1–0.9), the IPC protocol (0.1–0.24), object and library manifests (0.9, draft 0.10), extension and screen-type manifests and the input keymap. JSON Schema dialect: **2020-12**. Every version is frozen once published; core, the shell and the SDK pin these exact files. Readable reference: [hyprune.com/reference/schema](https://hyprune.com/reference/schema/).
+Versioned contracts for Hyprune, a world-driven Hyprland desktop: world packages (formats 0.1–0.9), the IPC protocol (0.1–0.25, 0.25 draft), object and library manifests (0.9, draft 0.10), extension and screen-type manifests and the input keymap. JSON Schema dialect: **2020-12**. Every version is frozen once published; core, the shell and the SDK pin these exact files. Readable reference: [hyprune.com/reference/schema](https://hyprune.com/reference/schema/).
 
 ## Install
 
@@ -32,6 +32,29 @@ Every schema file is importable at `@hyprune/schema/v0.N/<name>.schema.json` (`v
 
 [RFC source](https://github.com/hyprune/docs/tree/main/src/content/docs/rfcs) is normative for semantics. [RFC-0003](https://hyprune.com/rfcs/0003-ipc/) defines IPC; [RFC-0004](https://hyprune.com/rfcs/0004-world-format/) defines worlds. The `$id` URLs are mirrored by docs for authoring; this validator registers all schemas locally and never fetches them.
 
+## Registry documents (RFC-0015)
+
+Registry formats are versioned on their own, under `registry/v0.N/` (first: `0.1`):
+
+| Schema | Describes |
+| --- | --- |
+| `registry/v0.1/index.schema.json` | An index (official, community registry or any third-party index). `$defs.entry` is one entry and the shape of a registry entry file, which may add a `$schema` pointer. |
+| `registry/v0.1/release-record.schema.json` | `<id>-<version>.release.json`, the record published with each release. |
+| `registry/v0.1/sources.schema.json` | `sources.json` and the read-only files listed in `HYPRUNE_SOURCES_FILES`. |
+
+```js
+import { validateRegistry, compareSemver, tagVersion } from '@hyprune/schema';
+validateRegistry('registry-index', index);   // also 'registry-entry', 'release-record', 'sources'
+tagVersion('lumen-reach-v0.10.2');           // { name: 'lumen-reach', version: '0.10.2' }
+```
+
+`validateRegistry` adds the rules a schema can't express: ids unique within an index,
+versions unique and newest first by SemVer, each tag naming its version (`v<version>` or
+`<name>-v<version>`), SPDX licences, per-type archive limits (`registryLimits`), release
+record asset names, and unique, non-reserved custom source ids. CLI:
+`npm run validate -- registry-index index.json` (indexes up to 16 MiB). Fixtures:
+`examples/registry/` (valid) and `examples/registry/invalid/<kind>--<case>.json`.
+
 ## Validate
 
 Use Node >=22.12 (CI pins 24.14.0), npm, and the committed lockfile:
@@ -212,6 +235,13 @@ raw value, condition (`fresh`, `stale`, `missing`, `error`) and `publishedAt`
 grant; every other 0.23 definition is unchanged. See the RFC-0013 amendment
 "Live state in IPC 0.24".
 
+IPC **0.25** (draft, the RFC-0010 companions amendment) adds the companion: a
+required `companion` state key (the chosen ref and name, its state, mode
+`follow`/`stay`/`route`, bound path, activity and position), a `companion`
+capability on catalog entries, the aimed interaction type `companion`, and
+`companion.set/clear/mode` (objects.control). Object format 0.10 (draft) gains
+the optional `companion` block. Every other 0.24 definition is unchanged.
+
 ## Objects and libraries (RFC-0011)
 
 Object manifests (`object.json`) and library manifests (`library.json`) use the

package/bin/validate.mjs

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 import { readFileSync } from 'node:fs';
-import { validate } from '../lib/validate.mjs';
+import { validate, validateRegistry } from '../lib/validate.mjs';
+const registryKinds = ['registry-index', 'registry-entry', 'release-record', 'sources'];
 const [kind, file, method, version, worldFile, asset, ...extra] = process.argv.slice(2);
 // For kind `object` the fifth argument is the object's glTF (.gltf or .glb) for the cross-checks.
 const gltfJson = path => {
@@ -9,19 +10,24 @@ const gltfJson = path => {
   if (bytes.length < 20 || bytes.readUInt32LE(0) !== 0x46546c67 || bytes.readUInt32LE(16) !== 0x4e4f534a) throw new Error('Invalid GLB header/JSON chunk');
   return JSON.parse(bytes.subarray(20, 20 + bytes.readUInt32LE(12)).toString('utf8'));
 };
-if (!kind || !file || extra.length || ((worldFile || asset) && kind !== 'scene' && kind !== 'object') || (asset && kind === 'object')) {
+if (!kind || !file || extra.length || ((worldFile || asset) && kind !== 'scene' && kind !== 'object') || (asset && kind === 'object') ||
+    (registryKinds.includes(kind) && method && method !== '-')) {
   console.error('Usage: hyprune-validate <world|extension|screen-type|ipc> <file.json|-> [response-method|-] [contract-version]\n' +
                 '       hyprune-validate scene <scene.gltf> - <world-format> <world.json> [object-asset-id]\n' +
-                '       hyprune-validate <object|library|library-releases> <file.json|-> [-] [format] [object scene.gltf|.glb]\n(in this repository: npm run validate -- ...)');
+                '       hyprune-validate <object|library|library-releases> <file.json|-> [-] [format] [object scene.gltf|.glb]\n' +
+                '       hyprune-validate <registry-index|registry-entry|release-record|sources> <file.json|-> [-] [registry version]\n(in this repository: npm run validate -- ...)');
   process.exitCode = 2;
 } else {
   try {
     const bytes = readFileSync(file === '-' ? 0 : file);
-    if (bytes.length > 1_048_576) throw new Error('Document exceeds 1 MiB');
+    // Indexes may be up to 16 MiB as served (RFC-0015); every other document 1 MiB.
+    const cap = kind === 'registry-index' ? 16 * 1_048_576 : 1_048_576;
+    if (bytes.length > cap) throw new Error(`Document exceeds ${cap / 1_048_576} MiB`);
     const value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
     const options = kind === 'object' ? { gltf: worldFile ? gltfJson(worldFile) : undefined }
       : { world: worldFile ? JSON.parse(readFileSync(worldFile, 'utf8')) : undefined, asset };
-    const result = validate(kind, value, method === '-' ? undefined : method, version || undefined, options);
+    const result = registryKinds.includes(kind) ? validateRegistry(kind, value, version || undefined)
+      : validate(kind, value, method === '-' ? undefined : method, version || undefined, options);
     for (const warning of result.warnings || []) console.error(`warning: ${warning}`);
     if (result.valid) console.log(`VALID ${kind}: ${file}`);
     else { console.error(result.errors.join('\n')); process.exitCode = 1; }

package/examples/registry/entry.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0",
+      "version": "1.2.0",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}

package/examples/registry/index.json

@@ -0,0 +1,137 @@
+{
+  "indexVersion": "0.1",
+  "name": "Example community index",
+  "homepage": "https://example.org/hyprune",
+  "serial": 1842,
+  "generated": "2026-11-02T08:00:00Z",
+  "successor": null,
+  "entries": [
+    {
+      "id": "io.github.example-creator.tidepool",
+      "type": "world",
+      "name": "Tidepool Station",
+      "summary": "A tidal research station with four workspace homes and a pier.",
+      "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+      "creator": "example-creator",
+      "repo": "https://github.com/example-creator/tidepool-world",
+      "tags": [
+        "water",
+        "station"
+      ],
+      "versions": [
+        {
+          "tag": "v1.2.0",
+          "version": "1.2.0",
+          "formatVersion": "0.9",
+          "published": "2026-11-01",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        },
+        {
+          "tag": "v1.2.0-rc.1",
+          "version": "1.2.0-rc.1",
+          "formatVersion": "0.9",
+          "published": "2026-10-28",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        },
+        {
+          "tag": "v1.1.0",
+          "version": "1.1.0",
+          "formatVersion": "0.9",
+          "published": "2026-10-20",
+          "license": "CC-BY-SA-4.0",
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 48213004,
+          "expandedBytes": 96424960,
+          "files": 212,
+          "record": {
+            "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+            "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+          },
+          "requires": {
+            "libraries": [
+              "com.example.street@1.2.0"
+            ]
+          },
+          "thumbnails": [
+            {
+              "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+              "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+              "width": 1280,
+              "height": 720
+            }
+          ],
+          "status": "available"
+        }
+      ]
+    },
+    {
+      "id": "com.example.street",
+      "type": "library",
+      "name": "Street kit",
+      "summary": "Lanterns and benches.",
+      "creator": "example-org",
+      "repo": "https://github.com/example-org/hyprune-objects",
+      "versions": [
+        {
+          "tag": "street-v1.2.0",
+          "version": "1.2.0",
+          "formatVersion": "0.10",
+          "published": "2026-10-30",
+          "license": "CC0-1.0",
+          "url": "https://github.com/example-org/hyprune-objects/releases/download/street-v1.2.0/com.example.street-1.2.0.tar.zst",
+          "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+          "bytes": 3108221,
+          "expandedBytes": 7340032,
+          "files": 24
+        }
+      ]
+    }
+  ]
+}

package/examples/registry/invalid/registry-entry--bad-spdx.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0",
+      "version": "1.2.0",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "Free for everyone",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}

package/examples/registry/invalid/registry-entry--build-metadata.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "https://hyprune.com/schema/registry/v0.1/index.schema.json#/$defs/entry",
+  "id": "io.github.example-creator.tidepool",
+  "type": "world",
+  "name": "Tidepool Station",
+  "summary": "A tidal research station with four workspace homes and a pier.",
+  "description": "Four connected homes around a flooded atrium.\nA pier with a long view.",
+  "creator": "example-creator",
+  "repo": "https://github.com/example-creator/tidepool-world",
+  "tags": [
+    "water",
+    "station"
+  ],
+  "versions": [
+    {
+      "tag": "v1.2.0+build.5",
+      "version": "1.2.0+build.5",
+      "formatVersion": "0.9",
+      "published": "2026-11-01",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0/io.github.example-creator.tidepool-1.2.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.2.0-rc.1",
+      "version": "1.2.0-rc.1",
+      "formatVersion": "0.9",
+      "published": "2026-10-28",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.2.0-rc.1/io.github.example-creator.tidepool-1.2.0-rc.1.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    },
+    {
+      "tag": "v1.1.0",
+      "version": "1.1.0",
+      "formatVersion": "0.9",
+      "published": "2026-10-20",
+      "license": "CC-BY-SA-4.0",
+      "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.tar.zst",
+      "sha256": "5d2f0c6e3b9a41d8e7c2b0f4a6d9e1c3b5a7f9e2d4c6b8a0f1e3d5c7b9a2e4f6",
+      "bytes": 48213004,
+      "expandedBytes": 96424960,
+      "files": 212,
+      "record": {
+        "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.release.json",
+        "sha256": "9a1c3e5f7b9d0a2c4e6f8b1d3a5c7e9f0b2d4a6c8e1f3b5d7a9c0e2f4b6d8a1c"
+      },
+      "requires": {
+        "libraries": [
+          "com.example.street@1.2.0"
+        ]
+      },
+      "thumbnails": [
+        {
+          "url": "https://github.com/example-creator/tidepool-world/releases/download/v1.1.0/io.github.example-creator.tidepool-1.1.0.thumb-1.png",
+          "sha256": "0b8e4c2a6f1d3e5b7a9c0d2e4f6a8b1c3d5e7f9a0b2c4d6e8f1a3b5c7d9e0f2a",
+          "width": 1280,
+          "height": 720
+        }
+      ],
+      "status": "available"
+    }
+  ]
+}