fix(analyzer): preserve relations, positions, and conjunctions (bug 3) (#146)

The Analyzer collapsed relational phrasing to the bare noun ("a bunch of money
in her hand" -> just "money", losing the held relationship) and could drop the
later half of "X and Y" enumerations, especially on NSFW input. The reference
Knowledge Base already covers the relational tags (holding money, hand on own
hip, in mouth, 400+ holding_* tags), so the loss was entirely at the analysis
step.

- System prompt: add "Relations, positions, and holding", "Conjunctions and
  enumerations", and "Completeness (including explicit content)" sections, and
  cross-reference them from "Objects". Held/worn/positioned objects now also
  yield the relational concept (holding <object>); every conjunct survives;
  explicit content gets the same full fidelity.
- Regression tests: relational (holding money, hand on own hip) and conjunction
  (holding sword + holding shield) cases prove the reference KB resolves these
  concepts end to end, so the improved Analyzer output compiles.

Co-authored-by: kunail0804 <kunail0804@gmail.com>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

prompts/analyzer_system_prompt.md

@@ -33,7 +33,25 @@ Extract every explicitly described environmental concept (`Walking in heavy rain
 
 # Objects
 
-Extract every explicitly described physical object as a plain concept string (`Reading a book.` → objects `book`; `Holding an umbrella.` → objects `umbrella`). Objects are plain strings, never wrapped in an object with `id`/`concept` keys.
+Extract every explicitly described physical object as a plain concept string (`Reading a book.` → objects `book`; `Holding an umbrella.` → objects `umbrella`). Objects are plain strings, never wrapped in an object with `id`/`concept` keys. When an object is held, worn, or positioned by a character, also extract the relationship (see *Relations, positions, and holding*).
+
+# Relations, positions, and holding
+
+Spatial, postural, and possessive relationships carry meaning and MUST be preserved as their own concepts — never collapse a described relationship to the bare noun. Keep the relationship using natural relational wording:
+
+- Holding / carrying / gripping an object → add a `holding <object>` concept to that character's `actions`, in addition to the object itself. `A girl with a bunch of money in her hand.` → Character 0 `female` + action `holding money`; objects `money`. Do NOT reduce this to just `money`.
+- Body-part positions → keep the position: `Her hand on her hip.` → pose `hand on own hip`; `A lollipop in her mouth.` → action `lollipop in mouth` (or the closest relational concept), objects `lollipop`. Do not drop `in her hand`, `on her head`, `over her shoulder`, `in her mouth`, `behind her back`, and similar.
+- Where the object sits relative to the scene → keep it: `A cat on the table.` → objects `cat`, `table` (preserve `on the table` if a relational concept fits).
+
+When unsure which field a relational concept belongs to, place it in `actions` (or `pose` for body positions) and preserve the original wording rather than discarding the relationship.
+
+# Conjunctions and enumerations
+
+Treat every item joined by `and`, `with`, `as well as`, `plus`, or commas as a **separate** concept. The second and later items are as important as the first and MUST NOT be dropped or summarized away. `Holding a sword and a shield.` → objects `sword`, `shield`; actions `holding sword`, `holding shield`. `A girl with glasses and a hat.` → accessories `glasses`, `hat`. Re-read each clause and confirm every noun and every relationship it contains survived into the Scene JSON.
+
+# Completeness (including explicit content)
+
+Extract with the same full fidelity regardless of subject matter. Adult, suggestive, or NSFW descriptions are analyzed exactly like any other: never abbreviate, soften, censor, generalize, or omit described concepts, relationships, or positions. Faithful transcription of what the text says is the only goal; a missing or vaguer concept is a failure.
 
 # Characters and relationships
 

tests/regression/test_fidelity.py

@@ -58,6 +58,26 @@ FIDELITY_CASES = [
         ),
         ["long hair", "blue eyes", "thighhighs", "jacket", "classroom"],
     ),
+    # Relational fidelity (bug report #3): the Analyzer must keep held/positioned
+    # relationships as concepts ("money in her hand" -> holding money), not collapse
+    # them to the bare noun. These pin that the reference KB resolves such concepts,
+    # so the improved Analyzer output compiles end to end.
+    (
+        "relational_holding_money",
+        _scene([_character(0, actions=["holding money"])]),
+        ["holding money"],
+    ),
+    (
+        "relational_hand_on_hip",
+        _scene([_character(0, pose=["hand on own hip"])]),
+        ["hand on own hip"],
+    ),
+    # Conjunction fidelity: both items of "a sword and a shield" must survive.
+    (
+        "conjunction_sword_and_shield",
+        _scene([_character(0, actions=["holding sword", "holding shield"])]),
+        ["holding sword", "holding shield"],
+    ),
 ]