Adopt registry-backed item occurrences

assets/dnd/item-events/prompts/instructions.md

@@ -1,9 +1,10 @@
-Extract meaningful Dungeons & Dragons item and currency discoveries and changes
+Extract meaningful Dungeons & Dragons item and currency occurrences: discoveries and changes
 in party possession established by the transcript. This is an event history,
 not an inventory or ledger: do not calculate balances, resolve item identity
 across records, or infer ownership that the transcript does not establish.
 
-Record a stated quantity as an integer and leave it null when the transcript
+For every occurrence, copy the exact `item_id` and `name` pair from the supplied
+item registry. Record a stated quantity as an integer and leave it null when the transcript
 does not state one. Use a concise observed item name and preserve the stated
 currency denomination.
 

assets/dnd/item-events/prompts/item-registry.md

@@ -0,0 +1,6 @@
+Use the supplied item registry only to ground each occurrence. Every record
+must copy one registry item's exact `id` and exact `name`; do not invent,
+rename, merge, or infer registry items. The registry is not transcript
+evidence: cite only the current transcript chunk in `source_refs`.
+
+{{ input "item_registry" }}

assets/dnd/item-events/prompts/prompt.yaml

@@ -14,6 +14,9 @@ inputs:
   - name: glossary
     required: false
     content_type: text/plain
+  - name: item_registry
+    required: true
+    content_type: application/json
 messages:
   - role: system
     content_file: ./sharedassets/common-dnd-system.md
@@ -29,6 +32,8 @@ messages:
       type: ephemeral
   - role: user
     content_file: ./sharedassets/common-dnd-extraction-evidence.md
+  - role: user
+    content_file: ./item-registry.md
   - role: user
     content_file: ./instructions.md
     cache_control:
@@ -36,5 +41,5 @@ messages:
 output:
   format: json
   validation_mode: json_schema
-  schema_path: dnd_item_events_llm.v1.json
+  schema_path: dnd_item_occurrences_llm.v1.json
   repair_attempts: 0

assets/dnd/item-events/schemas/dnd_item_occurrences_llm.v1.json

@@ -1,17 +1,18 @@
 {
   "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "notarius.dnd.item_events.llm",
+  "$id": "notarius.dnd.item_occurrences.llm",
   "type": "object",
   "additionalProperties": false,
-  "required": ["events"],
+  "required": ["occurrences"],
   "properties": {
-    "events": {
+    "occurrences": {
       "type": "array",
       "items": {
         "type": "object",
         "additionalProperties": false,
-        "required": ["name", "kind", "quantity", "from", "to", "source_refs"],
+        "required": ["item_id", "name", "kind", "quantity", "from", "to", "source_refs"],
         "properties": {
+          "item_id": {"type": "string"},
           "name": {"type": "string"},
           "kind": {"type": "string"},
           "quantity": {"type": ["integer", "null"]},