From 350404b5eb390fefbee64d849eb793c088a128fd Mon Sep 17 00:00:00 2001 From: Meta Vens Date: Sun, 3 May 2026 10:25:49 +0100 Subject: [PATCH] Add Pallas visual character refs --- AGENTS.md | 4 + docs/architecture/ink-branching-scenes.md | 24 +- ...s-strikes.branch-and-fold.v0.training.json | 395 ++++++++++++------ notes/fresh-workspace-handoff.md | 6 +- notes/ghostlight-current-system-map.md | 9 +- notes/ghostlight-implementation-plan.md | 4 +- prompts/README.md | 3 + prompts/visual-scene-continuity-reviewer.md | 13 + state/evidence.jsonl | 1 + state/map.yaml | 4 +- 10 files changed, 335 insertions(+), 128 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 5f19ab0..f9206c1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -150,6 +150,10 @@ When the user says to prepare for imminent compaction: fictional objects and body affordances in visible terms: geometry, materials, lighting, stance, interfaces, tools, supports, cables, fluids, screens, and crowd positions. +- Do not treat a character name as a visual description. Illustrated fixtures + need stable character visual refs for every recurring named character, and + scene prompts should either include those refs during prompt assembly or carry + enough appearance detail to stand alone. - Ground scene writing in the source's material details: habitat form, infrastructure, law, class pressure, money, route access, surveillance, communication channels, body affordances, and local failure costs. diff --git a/docs/architecture/ink-branching-scenes.md b/docs/architecture/ink-branching-scenes.md index 40dc009..44bf548 100644 --- a/docs/architecture/ink-branching-scenes.md +++ b/docs/architecture/ink-branching-scenes.md @@ -401,6 +401,14 @@ Each distinct visual section should preserve an art-direction block with: changed character positions, opened or sealed routes, damaged objects, lighting changes, emotional posture, crowd pressure, or other scene states +Named characters need stable visual references. An image model does not know +what Lio Vale looks like because the prose named Lio Vale. Each illustrated +fixture should define `visual_character_refs` for recurring named characters: +body type, apparent age range if relevant, face/hair/skin or equivalent visual +identity, clothing and equipment, silhouette, posture language, and +`do_not_change` continuity details. Scene prompts may then reference those +character refs instead of repeating the whole description every time. + Prompts must be imagegen-ready. Do not rely on unexplained Aetheria jargon as if the image model knows the lore. If the prompt says "wet-service cradle," it should also describe the visible thing: a suspended mist-lined maintenance @@ -416,12 +424,26 @@ Every visual section should identify: - `ink_anchor`: knot, stitch, or comment handle where the visual applies - `base_image_prompt`: durable scene prompt for the unmodified frame - `visible_characters`: characters allowed in the frame and their default - position or stance + position or stance, plus a `visual_ref` when the character is named - `state_image_modifiers`: additive prompts tied to explicit variables, thresholds, or route flags - `branch_image_modifiers`: additive prompts tied to specific branch ids - `visual_continuity_notes`: facts that must remain stable across edits +Prompt assembly for illustrated replay should combine: + +```text +global visual continuity + + visual_character_refs for visible named characters + + visual section base_image_prompt + + triggered state or branch image modifiers +``` + +The base image prompt is allowed to focus on the room and staging only if the +assembled prompt includes the relevant character refs. If a tool sends the base +prompt alone to imagegen, the base prompt must carry enough character detail by +itself. Names are handles, not faces. + The coordinator owns this surface for now. The responder should not receive omniscient visual art direction unless the character can observe it. Character packets may receive the local visible subset: what this actor can see, hear, diff --git a/examples/ink/pallas-species-strikes.branch-and-fold.v0.training.json b/examples/ink/pallas-species-strikes.branch-and-fold.v0.training.json index 2ab810f..af80025 100644 --- a/examples/ink/pallas-species-strikes.branch-and-fold.v0.training.json +++ b/examples/ink/pallas-species-strikes.branch-and-fold.v0.training.json @@ -413,7 +413,8 @@ "Character private state is documented in the agent fixture but the Ink only relies on observable behavior and role knowledge.", "Visual scene plan added after review noted that illustrated Ink needs click-through segmentation, per-section base prompts, character visibility controls, and imagegen-ready descriptions of fictional equipment.", "Visual reviewer pass added missing branch-02 visual scenes and aftermath modifiers for strike spread, BioElevate liability, evidence strength, Nara exposure/protection, and high security pressure.", - "Follow-up visual review returned accepted_with_minor_revisions; cleanup removed future-state modifiers from intro anchors and normalized ASCII possessives in visual prompts." + "Follow-up visual review returned accepted_with_minor_revisions; cleanup removed future-state modifiers from intro anchors and normalized ASCII possessives in visual prompts.", + "Added visual_character_refs so image prompts can assemble stable named-character identities instead of expecting imagegen to know what Lio Vale or other Pallas characters look like." ], "checks": { "uses_standard_branching_format": true, @@ -441,7 +442,7 @@ "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate.", + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes.", "Use this as the broad location anchor for the fixture." ] }, @@ -452,25 +453,29 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "walking the center lane with slate tucked under one arm, tired but attentive" + "default_stance": "walking the center lane with slate tucked under one arm, tired but attentive", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "near the amber manifold with other gray-suited seal technicians" + "default_stance": "near the amber manifold with other gray-suited seal technicians", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "at the dry anchor rail with a heavy hook and guarded posture" + "default_stance": "at the dry anchor rail with a heavy hook and guarded posture", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "partly visible in a misted suspended harness at wet-side equipment" + "default_stance": "partly visible in a misted suspended harness at wet-side equipment", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -480,17 +485,19 @@ "visible_characters": [ { "agent_id": "nara_7", - "default_stance": "focused, fingertips on the manifold, body still" + "default_stance": "focused, fingertips on the manifold, body still", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "lio_vale", - "default_stance": "watching from nearby without interrupting" + "default_stance": "watching from nearby without interrupting", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -500,17 +507,19 @@ "visible_characters": [ { "agent_id": "orrin_dax", - "default_stance": "leaning near the anchor rail, skeptical, protective of his crew" + "default_stance": "leaning near the anchor rail, skeptical, protective of his crew", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "lio_vale", - "default_stance": "optional edge-of-frame observer" + "default_stance": "optional edge-of-frame observer", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -520,17 +529,19 @@ "visible_characters": [ { "agent_id": "teth_inkwise", - "default_stance": "suspended in the cradle, several arms managing valves and tools" + "default_stance": "suspended in the cradle, several arms managing valves and tools", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "lio_vale", - "default_stance": "standing beside the cradle checking the harness cuff" + "default_stance": "standing beside the cradle checking the harness cuff", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate.", + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes.", "This prompt must always explain the wet-service cradle in visible terms." ] }, @@ -541,17 +552,19 @@ "visible_characters": [ { "agent_id": "ilya_marne", - "default_stance": "upright behind glass, hands near a console, controlled and watchful" + "default_stance": "upright behind glass, hands near a console, controlled and watchful", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "lio_vale", - "default_stance": "small figure below on the maintenance floor" + "default_stance": "small figure below on the maintenance floor", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -561,25 +574,29 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "center lane, deciding where to go" + "default_stance": "center lane, deciding where to go", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "near manifold" + "default_stance": "near manifold", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "near anchor rail" + "default_stance": "near anchor rail", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "in wet-service cradle" + "default_stance": "in wet-service cradle", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -589,17 +606,19 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "walking slowly with slate up" + "default_stance": "walking slowly with slate up", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "quiet, angled toward the wall, fingers ready to touch" + "default_stance": "quiet, angled toward the wall, fingers ready to touch", + "visual_ref": "visual_character_refs.characters.nara_7" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -609,17 +628,19 @@ "visible_characters": [ { "agent_id": "orrin_dax", - "default_stance": "seated, guarded, mug in hand" + "default_stance": "seated, guarded, mug in hand", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "lio_vale", - "default_stance": "seated beside him, listening rather than arguing" + "default_stance": "seated beside him, listening rather than arguing", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -629,17 +650,19 @@ "visible_characters": [ { "agent_id": "teth_inkwise", - "default_stance": "calmly multitasking inside the harness" + "default_stance": "calmly multitasking inside the harness", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "lio_vale", - "default_stance": "leaning in to inspect a pressure cuff" + "default_stance": "leaning in to inspect a pressure cuff", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -649,23 +672,28 @@ "visible_characters": [ { "agent_id": "nara_7", - "default_stance": "front of engineered-worker line, hand flat on rail" + "default_stance": "front of engineered-worker line, hand flat on rail", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "lio_vale", - "default_stance": "near the center lane, being asked to classify the refusal" + "default_stance": "near the center lane, being asked to classify the refusal", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "orrin_dax", - "default_stance": "at dry-side rail, watching" + "default_stance": "at dry-side rail, watching", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "in harness, valves stilled" + "default_stance": "in harness, valves stilled", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "ilya_marne", - "default_stance": "arriving from supervisor side, controlled and sharp" + "default_stance": "arriving from supervisor side, controlled and sharp", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [ @@ -680,7 +708,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -690,29 +718,34 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "near center lane, slate angled down to keep the channel local" + "default_stance": "near center lane, slate angled down to keep the channel local", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "still at manifold, protected by procedure rather than body blocking" + "default_stance": "still at manifold, protected by procedure rather than body blocking", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "ilya_marne", - "default_stance": "narrowed focus on Lio, hearing the legal trap" + "default_stance": "narrowed focus on Lio, hearing the legal trap", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "orrin_dax", - "default_stance": "watching from dry anchor rail, not yet committed" + "default_stance": "watching from dry anchor rail, not yet committed", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "still in wet-service harness, monitoring load" + "default_stance": "still in wet-service harness, monitoring load", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate.", + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes.", "Visually distinguish this from public escalation: small local board, contained amber light, no outside-feed indicator." ] }, @@ -723,23 +756,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "thumb on slate, committing the log before fear can soften it" + "default_stance": "thumb on slate, committing the log before fear can soften it", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "moving from person to policy, shoulders squared" + "default_stance": "moving from person to policy, shoulders squared", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "nara_7", - "default_stance": "front of engineered-worker stillness near manifold" + "default_stance": "front of engineered-worker stillness near manifold", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "at anchor rail, startled by the formal language" + "default_stance": "at anchor rail, startled by the formal language", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "in harness, valves paused" + "default_stance": "in harness, valves paused", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [ @@ -754,7 +792,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -764,19 +802,23 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "body angled across the inspector camera sightline" + "default_stance": "body angled across the inspector camera sightline", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "behind Lio, hands flat on rail, exposed but shielded" + "default_stance": "behind Lio, hands flat on rail, exposed but shielded", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "watching from anchor rail, expression conflicted" + "default_stance": "watching from anchor rail, expression conflicted", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "ilya_marne", - "default_stance": "facing the blocked sightline from supervisor side" + "default_stance": "facing the blocked sightline from supervisor side", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [ @@ -791,7 +833,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -801,23 +843,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "holding slate between AU board and workers" + "default_stance": "holding slate between AU board and workers", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "near supervisor channel, trying to control classification" + "default_stance": "near supervisor channel, trying to control classification", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "nara_7", - "default_stance": "near manifold, visible but not isolated" + "default_stance": "near manifold, visible but not isolated", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "with dry-side crew at anchors" + "default_stance": "with dry-side crew at anchors", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "watching pressure diagrams from wet-service cradle" + "default_stance": "watching pressure diagrams from wet-service cradle", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [ @@ -828,7 +875,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -838,21 +885,24 @@ "visible_characters": [ { "agent_id": "nara_7", - "default_stance": "hand near slate, controlled and exposed" + "default_stance": "hand near slate, controlled and exposed", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "lio_vale", - "default_stance": "holding slate outward to control evidence custody" + "default_stance": "holding slate outward to control evidence custody", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "background, watching the evidence" + "default_stance": "background, watching the evidence", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -862,21 +912,24 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "standing open-handed, not crowding Orrin" + "default_stance": "standing open-handed, not crowding Orrin", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "orrin_dax", - "default_stance": "caught between resentment and responsibility" + "default_stance": "caught between resentment and responsibility", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "nara_7", - "default_stance": "visible near manifold in background" + "default_stance": "visible near manifold in background", + "visual_ref": "visual_character_refs.characters.nara_7" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -886,17 +939,19 @@ "visible_characters": [ { "agent_id": "teth_inkwise", - "default_stance": "several arms unfolding the bypass bridge with practiced care" + "default_stance": "several arms unfolding the bypass bridge with practiced care", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "lio_vale", - "default_stance": "watching the device rather than touching it yet" + "default_stance": "watching the device rather than touching it yet", + "visual_ref": "visual_character_refs.characters.lio_vale" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -906,17 +961,19 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "thumb on send control" + "default_stance": "thumb on send control", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "reaching in too late, controlled anger visible" + "default_stance": "reaching in too late, controlled anger visible", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -926,23 +983,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "frozen mid-turn toward the alarm" + "default_stance": "frozen mid-turn toward the alarm", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "hands on rail, refusing to move" + "default_stance": "hands on rail, refusing to move", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "turning from anchor rail toward the throat" + "default_stance": "turning from anchor rail toward the throat", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "harness flexing under sudden pressure change" + "default_stance": "harness flexing under sudden pressure change", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "ilya_marne", - "default_stance": "caught between command and calculation" + "default_stance": "caught between command and calculation", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [ @@ -953,7 +1015,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate.", + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes.", "This screen may be only one sentence in replay; let the red alert breathe." ] }, @@ -964,23 +1026,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "center, hands visible, slate ready" + "default_stance": "center, hands visible, slate ready", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "demanding a decision from management side" + "default_stance": "demanding a decision from management side", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "nara_7", - "default_stance": "near manifold, exposed but steady" + "default_stance": "near manifold, exposed but steady", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "near dry-side crew at anchor rail" + "default_stance": "near dry-side crew at anchor rail", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "in wet-service harness near pressure diagrams" + "default_stance": "in wet-service harness near pressure diagrams", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [ @@ -1003,7 +1070,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1013,23 +1080,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "hands visible, refusing to move first" + "default_stance": "hands visible, refusing to move first", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "tight posture, about to record language she hates" + "default_stance": "tight posture, about to record language she hates", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "nara_7", - "default_stance": "steady near manifold" + "default_stance": "steady near manifold", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "watching from anchor rail" + "default_stance": "watching from anchor rail", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "at wet-service station" + "default_stance": "at wet-service station", + "visual_ref": "visual_character_refs.characters.teth_inkwise" } ], "state_image_modifiers": [ @@ -1040,7 +1112,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1050,21 +1122,24 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "holding slate with custody seal visible" + "default_stance": "holding slate with custody seal visible", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "teth_inkwise", - "default_stance": "hands on bypass controls" + "default_stance": "hands on bypass controls", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "ilya_marne", - "default_stance": "accepting the bargain under duress" + "default_stance": "accepting the bargain under duress", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1074,21 +1149,24 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "lifting slate toward inspector cam" + "default_stance": "lifting slate toward inspector cam", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "ilya_marne", - "default_stance": "watching for a way to punish the move" + "default_stance": "watching for a way to punish the move", + "visual_ref": "visual_character_refs.characters.ilya_marne" }, { "agent_id": "nara_7", - "default_stance": "near manifold, not centered unless prior branch did so" + "default_stance": "near manifold, not centered unless prior branch did so", + "visual_ref": "visual_character_refs.characters.nara_7" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1098,25 +1176,29 @@ "visible_characters": [ { "agent_id": "orrin_dax", - "default_stance": "front of the line, anchor hook down, claiming dry-side authority" + "default_stance": "front of the line, anchor hook down, claiming dry-side authority", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "lio_vale", - "default_stance": "near Nara, protecting without speaking over Orrin" + "default_stance": "near Nara, protecting without speaking over Orrin", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "behind or beside Lio near manifold" + "default_stance": "behind or beside Lio near manifold", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "ilya_marne", - "default_stance": "facing Orrin, frustrated by the shifted front" + "default_stance": "facing Orrin, frustrated by the shifted front", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1126,23 +1208,28 @@ "visible_characters": [ { "agent_id": "lio_vale", - "default_stance": "standing with slate lowered, not triumphant" + "default_stance": "standing with slate lowered, not triumphant", + "visual_ref": "visual_character_refs.characters.lio_vale" }, { "agent_id": "nara_7", - "default_stance": "near manifold or protected in the worker cluster" + "default_stance": "near manifold or protected in the worker cluster", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "orrin_dax", - "default_stance": "with dry-side crew, posture determined if solidarity is high" + "default_stance": "with dry-side crew, posture determined if solidarity is high", + "visual_ref": "visual_character_refs.characters.orrin_dax" }, { "agent_id": "teth_inkwise", - "default_stance": "patching or checking wet-service gear" + "default_stance": "patching or checking wet-service gear", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "ilya_marne", - "default_stance": "near supervisor side, contained anger" + "default_stance": "near supervisor side, contained anger", + "visual_ref": "visual_character_refs.characters.ilya_marne" } ], "state_image_modifiers": [ @@ -1181,7 +1268,7 @@ ], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate." + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes." ] }, { @@ -1191,21 +1278,24 @@ "visible_characters": [ { "agent_id": "nara_7", - "default_stance": "background, repeating the touch ritual" + "default_stance": "background, repeating the touch ritual", + "visual_ref": "visual_character_refs.characters.nara_7" }, { "agent_id": "teth_inkwise", - "default_stance": "partly visible patching harness cuff" + "default_stance": "partly visible patching harness cuff", + "visual_ref": "visual_character_refs.characters.teth_inkwise" }, { "agent_id": "orrin_dax", - "default_stance": "absent or off-frame, represented by cracked mug" + "default_stance": "absent or off-frame, represented by cracked mug", + "visual_ref": "visual_character_refs.characters.orrin_dax" } ], "state_image_modifiers": [], "visual_continuity_notes": [ "Service Ring Kappa remains the same asteroid cavity maintenance yard: curved mineral wall, worn yellow-white safety paint, hard industrial work lights, mist around wet-service equipment, dry anchor rail opposite the manifold, gray engineered-worker suits, and AU supervisor glass above the floor.", - "Do not change character body affordances between images: Teth is a cephalopod worker supported by a misted low-gravity harness/cradle; Nara-7 is an engineered humanoid seal technician in a numbered gray skinsuit; Orrin is a baseline human rigger with old anchor tools; Ilya is an AU supervisor seen through glass or arriving from the management side; Lio carries a slate.", + "Maintain named-character visual identity from visual_character_refs for every visible named character; do not rely on names alone, and do not change body type, clothing language, equipment, or silhouette between scenes.", "This is the final visual memory, not a victory poster. Keep it intimate and ordinary." ] } @@ -1252,5 +1342,76 @@ "prompt": "Add an outside-feed or public mirror indicator reflected on a slate or wall display." } ] + }, + "visual_character_refs": { + "purpose": "Stable named-character visual identities for prompt assembly. Image prompts must include these refs for every named visible character; scene prompts alone are not expected to teach imagegen what Lio, Nara, Orrin, Teth, or Ilya look like.", + "prompt_assembly_rule": "For each visual_scene_plan scene, assemble the image prompt from global location continuity, each visible character visual_ref, the scene base_image_prompt, and any triggered state_image_modifiers or global_branch_image_modifiers.", + "characters": { + "lio_vale": { + "display_name": "Lio Vale", + "species_or_body": "baseline human adult from Belt labor housing", + "stable_visual_description": "Lean, compact adult human with medium-brown skin, short black hair clipped close at the sides, tired dark eyes, and a scheduler's stillness that reads as careful rather than passive. Wears a worn slate-gray AU maintenance jacket over a practical work harness, soft-soled magnetic boots, a utility belt with tags and seals, and carries a rectangular work slate with scuffed edges.", + "silhouette_notes": "Usually centered between groups, shoulders slightly forward, one hand near the slate; visually reads as a tired worker-organizer rather than a heroic commander.", + "do_not_change": [ + "medium-brown skin", + "short black close-clipped hair", + "slate-gray AU maintenance jacket", + "rectangular work slate", + "compact practical build" + ] + }, + "nara_7": { + "display_name": "Nara-7", + "species_or_body": "engineered humanoid seal technician, BioDrone Standard labor line", + "stable_visual_description": "Slender engineered humanoid worker with smooth androgynous features, close-cropped dark hair, pale gray-brown skin with faint subdermal route-interface lines at wrists and neck, and a clean gray numbered seal-technician skinsuit with a small BioDrone Standard batch tag. Movements are precise and economical, hands often flat against rails or wall panels.", + "silhouette_notes": "Still, narrow, and controlled; frequently framed by the manifold or other gray-suited engineered technicians.", + "do_not_change": [ + "gray numbered skinsuit", + "BioDrone Standard batch tag", + "faint wrist and neck interface lines", + "precise hand-touch ritual", + "slender engineered humanoid silhouette" + ] + }, + "orrin_dax": { + "display_name": "Orrin Dax", + "species_or_body": "baseline human dry-side rigger", + "stable_visual_description": "Broad-shouldered baseline human rigger in his late working years, light-brown weathered skin, close-cropped graying hair, rough stubble, and a pale frost scar along one side of his jaw. Wears a patched brown-and-orange dry-side work jacket, heavy gloves, magnetic boots, and usually carries or rests near an old dark metal anchor hook and battered recycler coffee mug.", + "silhouette_notes": "Solid, guarded, slightly hunched from years of rail work; visually tied to anchor hooks, coffee, frost scars, and old tools.", + "do_not_change": [ + "frost scar along jaw", + "patched brown-and-orange rigger jacket", + "old anchor hook", + "battered coffee mug", + "broad baseline human build" + ] + }, + "teth_inkwise": { + "display_name": "Teth Inkwise", + "species_or_body": "uplifted cephalopod wet-service maintenance specialist", + "stable_visual_description": "Large uplifted cephalopod worker with mottled blue-gray skin, expressive dark eyes, and multiple flexible arms supported in a misted low-gravity maintenance cradle. Wears soft pressure cuffs, tool loops, and a body-support harness rather than human clothing; often surrounded by fluid hoses, valve clusters, padded supports, and curved tool rails sized for many arms.", + "silhouette_notes": "Nonhuman, horizontal or suspended silhouette inside wet-service equipment; never standing upright like a human.", + "do_not_change": [ + "mottled blue-gray cephalopod body", + "misted low-gravity cradle", + "soft pressure cuffs", + "multiple arms", + "not human-shaped or upright" + ] + }, + "ilya_marne": { + "display_name": "Ilya Marne", + "species_or_body": "baseline human AU superintendent", + "stable_visual_description": "Tall baseline human woman with cool light skin, severe silver-blonde hair pinned tight, sharp cheekbones, and a controlled corporate expression. Wears a clean dark AU superintendent coat with pale blue trim, polished magnetic boots, and a slim supervisor console cuff; often seen through glass or blue-white interface reflections.", + "silhouette_notes": "Vertical, polished, controlled, visually associated with supervisor glass, blue-white UI, and distance from the dirty floor.", + "do_not_change": [ + "silver-blonde pinned hair", + "dark AU superintendent coat with pale blue trim", + "supervisor console cuff", + "polished corporate posture", + "seen through glass or UI reflections" + ] + } + } } } diff --git a/notes/fresh-workspace-handoff.md b/notes/fresh-workspace-handoff.md index 1c44b6d..a3f7087 100644 --- a/notes/fresh-workspace-handoff.md +++ b/notes/fresh-workspace-handoff.md @@ -159,9 +159,9 @@ bypass, gives `evidence_of_sentience`, `nara_centered`, and `formal_stoppage` later reads, and gives visual sidecar states explicit trigger mappings. It now segments the introduction, branch locations, Kappa red alert, climax decision, and aftermath into click-through visual sections with -`visual_scene_id` anchors and imagegen-ready prompts that explain fictional -equipment in visible terms. Treat it as coordinator/IF scaffold training data, -not raw responder gold. +`visual_scene_id` anchors, stable `visual_character_refs`, and imagegen-ready +prompts that explain fictional equipment in visible terms. Treat it as +coordinator/IF scaffold training data, not raw responder gold. Next: add the corpus coverage ledger seam or choose the next Aetheria fixture from the 100-150 broad coverage target. diff --git a/notes/ghostlight-current-system-map.md b/notes/ghostlight-current-system-map.md index d59f11d..d0bf484 100644 --- a/notes/ghostlight-current-system-map.md +++ b/notes/ghostlight-current-system-map.md @@ -53,10 +53,11 @@ character-local. Adams/Pratchett-style wit-with-stakes is a useful default touchstone for counterbalancing bleakness without dissolving consequence. Visual replay is a live seam too. Illustrated IF fixtures need click-through -sections with stable `visual_scene_id` anchors, imagegen-ready base prompts, -character visibility and stance controls, and branch/state modifiers. One -whole-fixture image prompt is not enough when the prose moves through several -places, focal objects, alarms, standoffs, and aftermath states. +sections with stable `visual_scene_id` anchors, stable visual character refs +for recurring named characters, imagegen-ready base prompts, character +visibility and stance controls, and branch/state modifiers. One whole-fixture +image prompt is not enough when the prose moves through several places, focal +objects, alarms, standoffs, and aftermath states. Names are handles, not faces. ## Important Contracts diff --git a/notes/ghostlight-implementation-plan.md b/notes/ghostlight-implementation-plan.md index f18d43a..41dda4f 100644 --- a/notes/ghostlight-implementation-plan.md +++ b/notes/ghostlight-implementation-plan.md @@ -57,7 +57,9 @@ not carry live next-action lists. object closeups, arrivals, alarms, pivotal one-sentence beats, standoffs, and aftermaths into click-through Ink sections with stable visual ids. Each visual section needs an imagegen-ready prompt that describes - fictional equipment and body affordances in visible terms. + fictional equipment and body affordances in visible terms. Named + recurring characters need stable visual character refs; names are handles, + not faces. - IF review correction: run an independent artifact reviewer after branch/Ink generation and before acceptance. The reviewer audits fake variables, cosmetic choices, missing state reads, fake folds, unearned convergence, state-named-instead-of-checked prose, visual callback gaps, and endings that ignore major state. The first Cold Wake user review is a seed failure taxonomy for this evaluator path. - Visual review correction: run a visual scene continuity reviewer for illustrated fixtures. It audits oversized Ink screens, missing visual diff --git a/prompts/README.md b/prompts/README.md index 1cbdd89..3adae6c 100644 --- a/prompts/README.md +++ b/prompts/README.md @@ -36,5 +36,8 @@ should be authored here first and referenced from artifacts or tools. fixture can need several click-through screens inside one narrative scene; each distinct place, focal area, pivotal moment, and branch-visible state needs an imagegen-ready prompt or modifier. +- Treat named characters as handles, not visual descriptions. Illustrated IF + sidecars need stable visual character refs for recurring named characters, and + prompt assembly must include those refs when the character is visible. - If a prompt is used for a capture, preserve the exact rendered prompt in the capture and include the prompt file path when the capture schema allows it. diff --git a/prompts/visual-scene-continuity-reviewer.md b/prompts/visual-scene-continuity-reviewer.md index bc63c34..fbc2b21 100644 --- a/prompts/visual-scene-continuity-reviewer.md +++ b/prompts/visual-scene-continuity-reviewer.md @@ -52,7 +52,13 @@ intent, but they do not excuse missing reader/player-facing structure. ### Character Visibility And Stance +- Does the sidecar define stable visual identity references for every named + recurring character, including body type, face/hair/skin or equivalent + visible identity, clothing/equipment, silhouette, and do-not-change details? - Does each visual scene declare who may be visible? +- Does each named visible character point to a stable visual identity ref, or + does the scene prompt itself include enough description to render the person + consistently? - Are character positions and stances controlled by branch state where needed? - Are nonhuman or altered bodies represented through visible affordances: harnesses, supports, water/mist interfaces, manipulators, suit geometry, @@ -134,6 +140,9 @@ Each finding must include: - Do not accept one all-purpose base prompt for a multi-location or multi-focus scene. - Do not accept visual prompts that rely on unexplained setting jargon. +- Do not accept named characters as visual descriptions. "Lio Vale stands by + the manifold" is not enough unless the sidecar provides a stable visual + reference for Lio and the prompt assembly path says to include it. - Do not require every sentence to have a unique image. Require every distinct place, focal area, pivotal visual beat, and branch-visible state to have a durable visual anchor or modifier. @@ -141,6 +150,8 @@ Each finding must include: visual scenes on one screen or rush past a key moment. - Mark missing character visibility when a later image must know who is in the frame but the sidecar does not say. +- Mark missing character design refs when an image model would have to invent + a recurring character's appearance from their name alone. - Mark branch modifiers as weak if they describe emotion without visible posture, position, object, lighting, damage, interface, or crowd change. - Image prompts should be concrete enough for a general image model. Use @@ -158,6 +169,8 @@ Use these labels when applicable: - `weak_geometry_prompt` - `weak_character_staging` - `missing_character_visibility` +- `missing_character_design_ref` +- `named_character_as_lore_password` - `missing_branch_visual_modifier` - `missing_state_trigger` - `branch_delta_not_visual` diff --git a/state/evidence.jsonl b/state/evidence.jsonl index 7d163e6..6fbf25b 100644 --- a/state/evidence.jsonl +++ b/state/evidence.jsonl @@ -44,3 +44,4 @@ {"ts": "2026-05-03T08:11:57+00:00", "type": "design", "status": "ok", "note": "Audited persistent steering surfaces for constant-crisis/dry-technical bias and added first-class tonal-range doctrine across AGENTS, map, handoff, implementation plan, system map, architecture rationale, README, content targets, and prompt guidance."} {"ts": "2026-05-03T08:41:33+00:00", "type": "review", "status": "ok", "note": "Pallas Species Strikes IF fixture was reviewed by narrative-quality subagent, revised for shared character onboarding, conditional folded callbacks, materialized variables, BioElevate/ALF in-text bridges, visual trigger mapping, and accepted as coordinator/IF scaffold training data after cleanup."} {"ts": "2026-05-03T09:08:30+00:00", "type": "review", "status": "ok", "note": "Added visual scene continuity reviewer prompt and revised Pallas IF fixture for illustrated replay: click-through visual scene anchors, imagegen-ready per-section prompts, character visibility/stance controls, branch/state visual modifiers, and acceptance after visual review cleanup."} +{"ts": "2026-05-03T09:25:38+00:00", "type": "review", "status": "ok", "note": "Added stable visual character refs for the Pallas illustrated IF fixture and updated visual review doctrine so named characters cannot rely on imagegen knowing their appearance from names alone."} diff --git a/state/map.yaml b/state/map.yaml index efc63ac..629f9c5 100644 --- a/state/map.yaml +++ b/state/map.yaml @@ -42,7 +42,7 @@ hard_boundaries: - Technology exploration must emit game-usable item, component, assembly, supply-chain, compatibility, and provenance data mapped toward Aetheria-Economy. - Interactive-fiction fixtures should branch and fold: normalize most consequences into compact state variables and shared-scene conditionals, reserving isolated route splits for major world-changing divergence. - Interactive-fiction fixtures require independent artifact review before acceptance; tracked variables must materially affect later affordances, risk, appraisal, callbacks, visual state, or outcomes, unless explicitly marked telemetry-only. - - Complete interactive-fiction fixtures must emit visual art direction for website imagery, with click-through visual scene segmentation, one durable base image prompt per distinct section, character visibility and stance controls, and additive modification prompts for branch-visible consequences and scene-state changes. + - Complete interactive-fiction fixtures must emit visual art direction for website imagery, with click-through visual scene segmentation, stable visual character refs for recurring named characters, one durable base image prompt per distinct section, character visibility and stance controls, and additive modification prompts for branch-visible consequences and scene-state changes. - Archived local-model prototype runners are receipts and plumbing tests, not the gold-data path. live_architecture: @@ -182,5 +182,5 @@ data_flow: - If state grows faster than understanding, cut it back. current_status: - summary: Pallas Species Strikes now has a reviewer-revised accepted-as-draft branch-and-fold IF fixture grounded in AU cavity-yard labor, Awakened Labor organizing, BioElevate uplift/biodrone systems, baseline displacement fear, cephalopod maintenance leverage, click-through visual segmentation, and imagegen-ready scene prompts. Cold Wake remains an archived historical fixture and local-model receipt surface, not the active gold-data path. + summary: Pallas Species Strikes now has a reviewer-revised accepted-as-draft branch-and-fold IF fixture grounded in AU cavity-yard labor, Awakened Labor organizing, BioElevate uplift/biodrone systems, baseline displacement fear, cephalopod maintenance leverage, click-through visual segmentation, stable visual character refs, and imagegen-ready scene prompts. Cold Wake remains an archived historical fixture and local-model receipt surface, not the active gold-data path. next_action: Add the corpus coverage ledger seam or select the next Aetheria fixture from the 100-150 broad coverage target.