Add D&D location occurrence extractor

internal/modules/dnd/extract/locationoccurrences/assets/prompts/dnd.location_occurrences.yaml

@@ -0,0 +1,47 @@
+id: dnd.location_occurrences
+version: "v1"
+default_profile: dnd-extraction
+inputs:
+  - name: transcript
+    required: true
+    content_type: application/json
+  - name: players
+    required: false
+    content_type: text/plain
+  - name: party
+    required: false
+    content_type: text/plain
+  - name: glossary
+    required: false
+    content_type: text/plain
+  - name: locations
+    required: true
+    content_type: application/json
+messages:
+  - role: system
+    content_file: ./sharedassets/common-dnd-system.md
+  - role: user
+    content_file: ./sharedassets/common-dnd-identity.md
+  - role: user
+    content_file: ./sharedassets/common-dnd-references.md
+    cache_control:
+      type: ephemeral
+  - role: user
+    content_file: ./sharedassets/common-dnd-transcript.md
+    cache_control:
+      type: ephemeral
+  - role: user
+    content_file: ./sharedassets/common-dnd-extraction-evidence.md
+  - role: user
+    content_file: ./locations.md
+  - role: user
+    content_file: ./task.md
+  - role: user
+    content_file: ./instructions.md
+    cache_control:
+      type: ephemeral
+output:
+  format: json
+  validation_mode: json_schema
+  schema_path: dnd_location_occurrences_llm.v1.json
+  repair_attempts: 0

internal/modules/dnd/extract/locationoccurrences/assets/prompts/instructions.md

@@ -0,0 +1,8 @@
+Return the occurrences array even when no occurrence is established. Every
+record must contain location_id, name, kind, and source_refs. Copy location_id
+and name from one supplied registry record, and cite only narrow transcript
+ranges that support both that location and its classified occurrence.
+
+Do not summarize location descriptions, infer a missing registry record, or
+use registry context as evidence. Omit source_id; Notarius assigns the current
+transcript source identity.

internal/modules/dnd/extract/locationoccurrences/assets/prompts/locations.md

@@ -0,0 +1,9 @@
+A normalized location registry is provided below for identity grounding. It may
+be empty. Each record contains the exact location ID and canonical display name
+to copy when the transcript establishes an occurrence of that place.
+
+Registry content is context, not occurrence evidence. Do not derive an
+occurrence or a source range from the registry, and do not infer a location
+that is absent from it.
+
+{{ input "locations" }}

internal/modules/dnd/extract/locationoccurrences/assets/prompts/task.md

@@ -0,0 +1,20 @@
+Extract Dungeons & Dragons location occurrences from the supplied transcript.
+
+Include an occurrence only when the transcript establishes one supplied
+location, one occurrence kind, and a coherent passage supporting both. Use
+only the exact ID and name pair from the supplied location registry. Return an
+empty occurrences array when no supplied location has an evidenced occurrence
+in this transcript passage.
+
+Use exactly one kind per occurrence:
+
+- visited: party members are physically present, arrive, remain, or depart;
+- planned: the party explicitly proposes, intends, or agrees to future travel;
+- recalled: the transcript explicitly recounts an earlier party visit; or
+- mentioned: the location is explicitly referenced without stronger support.
+
+For overlapping support, visited outranks planned, recalled, and mentioned;
+planned outranks recalled and mentioned; recalled outranks mentioned. A passage
+may produce multiple records when it independently establishes separate facts,
+such as recalling an earlier visit while planning a return. Omit inferred,
+uncertain, hypothetical, or unsupported places and occurrences.

internal/modules/dnd/extract/locationoccurrences/assets/schemas/dnd_location_occurrences_llm.v1.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "notarius.dnd.location_occurrences.llm",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["occurrences"],
+  "properties": {
+    "occurrences": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["location_id", "name", "kind", "source_refs"],
+        "properties": {
+          "location_id": {"type": "string"},
+          "name": {"type": "string"},
+          "kind": {"enum": ["visited", "planned", "recalled", "mentioned"]},
+          "source_refs": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "additionalProperties": false,
+              "required": ["start_unit_id", "end_unit_id"],
+              "properties": {
+                "start_unit_id": {"type": "integer"},
+                "end_unit_id": {"type": "integer"}
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}