jpmschweitzerandClaude Sonnet 4.6
c056ea1a1c
Line IDs in all dialogue and monologue pool files renamed from the old location-scoped format (e.g. the-terminal_d_039) to the new NPC-scoped format (e.g. kael-davan_d_001) per the D-035 Sprint 15 amendment. Changes: - 20 dialogue pool files across 3 locations renamed - 14 monologue pool files (detective + smuggler) renamed - Schema descriptions updated in dialogue/monologue schema files - Authoring style guide and design docs updated with new examples - Multi-location NPCs (kael-davan, pc-detective, pc-smuggler) given globally unique cross-file sequences to satisfy XREF uniqueness check The location-scoped scheme already caused a collision (the-terminal_d_039 appearing in multiple NPC files) and would not scale to procedurally generated NPC populations (D-029). Zero content changes — pure ID substitution. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
289 lines
9.7 KiB
JSON
289 lines
9.7 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "dialogue-line.schema.json",
|
|
"title": "Dialogue Line — canonical D-035 tag taxonomy",
|
|
"description": "Canonical single-line schema for dialogue and monologue pools. Implements the converged tag taxonomy from D-035 (6 structural + 3 selection + 2 authoring-only tags). Monologue-specific additions (character, trigger, prerequisite) are defined in $defs/monologue_extension. Mood vocabulary renamed Sprint 14 to match voice guide (anxious/frustrated/content/suspicious/warm/hostile/relieved/focused).",
|
|
"type": "object",
|
|
"required": ["id", "text", "role", "access", "trust", "situation"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"id": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9-]*_(d|m)_[0-9]{3}$",
|
|
"description": "Stable machine-parseable line ID: {npc-slug}_{d|m}_{###} (e.g. kael-davan_d_001, pc-detective_m_d_001). d = dialogue, m = monologue. NPC-scoped per D-035 Sprint 15 amendment — each NPC has an independent sequence starting at _001."
|
|
},
|
|
"text": {
|
|
"type": "string",
|
|
"minLength": 1,
|
|
"description": "The authored line text."
|
|
},
|
|
"role": {
|
|
"type": "string",
|
|
"pattern": "^[a-z][a-z0-9-]*$",
|
|
"description": "Template-defined role slug (e.g. dock-worker, bar-owner, player_character). Not NPC name — NPC assignment is runtime."
|
|
},
|
|
"access": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": ["public", "insider", "authority", "peer", "hostile"]
|
|
},
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"description": "D-028 Layer 1: access tiers this line is eligible for. List — a line can be eligible for multiple tiers. Hard filter."
|
|
},
|
|
"trust": {
|
|
"type": "string",
|
|
"enum": ["surface", "real", "secret"],
|
|
"description": "D-028 Layer 3: minimum trust tier required. Hard filter. Ordering: surface < real < secret."
|
|
},
|
|
"situation": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": [
|
|
"arrival",
|
|
"shift_start",
|
|
"shift_end",
|
|
"shift_transition",
|
|
"bar_evening",
|
|
"night_shift",
|
|
"investigation",
|
|
"confrontation",
|
|
"social",
|
|
"alone",
|
|
"emergency",
|
|
"routine",
|
|
"observation",
|
|
"greeting"
|
|
]
|
|
},
|
|
"minItems": 1,
|
|
"uniqueItems": true,
|
|
"description": "D-028 Layer 2: situations in which this line can fire. 14 v0.1 values (13 original + greeting added Sprint 8 for PC dialogue initial contact lines). NOTE: 'greeting' is not yet in server/src/content/line_pool.rs — lines using it will be skipped until Rust is updated."
|
|
},
|
|
"topic": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": [
|
|
"colleague",
|
|
"routine",
|
|
"cargo",
|
|
"money",
|
|
"trust",
|
|
"danger",
|
|
"institution",
|
|
"personal",
|
|
"investigation"
|
|
]
|
|
},
|
|
"uniqueItems": true,
|
|
"description": "D-028 Layer 4: topic tags for weighted selection. 9 v0.1 values. Optional — defaults to empty if omitted. Note: 'crime' deliberately excluded; NPCs think of it as 'cargo' or 'money'."
|
|
},
|
|
"mood": {
|
|
"type": "array",
|
|
"items": {
|
|
"type": "string",
|
|
"enum": [
|
|
"anxious",
|
|
"frustrated",
|
|
"content",
|
|
"suspicious",
|
|
"warm",
|
|
"hostile",
|
|
"relieved",
|
|
"focused"
|
|
]
|
|
},
|
|
"uniqueItems": true,
|
|
"description": "D-028 Layer 4: mood tags for weighted selection. 8 v0.1 values. Neutral mood = omit tag (untagged lines are always eligible). Renamed Sprint 14 to match voice guide vocabulary."
|
|
},
|
|
"tags": {
|
|
"type": "array",
|
|
"items": { "type": "string" },
|
|
"description": "Freeform escape hatch for author intent not covered by the structured taxonomy. Not consumed by the engine selection pipeline."
|
|
},
|
|
"knowledge_grant": {
|
|
"type": "object",
|
|
"description": "Knowledge the player gains from hearing this line. Feeds into the knowledge graph (D-041).",
|
|
"required": ["fact_id", "confidence"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"fact_id": {
|
|
"type": "string",
|
|
"description": "FactId from the knowledge vocabulary (#368)."
|
|
},
|
|
"confidence": {
|
|
"type": "string",
|
|
"enum": ["suspects", "knows_of", "knows_details", "direct"],
|
|
"description": "D-041 confidence tier granted."
|
|
}
|
|
}
|
|
},
|
|
"dual_lens": {
|
|
"type": "object",
|
|
"description": "Authoring-only: per-character notes for content with different resonance for smuggler vs detective. NOT consumed by the engine.",
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"smuggler": { "type": "string" },
|
|
"detective": { "type": "string" }
|
|
}
|
|
},
|
|
"notes": {
|
|
"type": "string",
|
|
"description": "Authoring-only: freeform author notes, context, or intent documentation. NOT consumed by the engine."
|
|
}
|
|
},
|
|
"$defs": {
|
|
"monologue_extension": {
|
|
"title": "Monologue-specific additions (D-035)",
|
|
"description": "Additional required fields for monologue lines. Applied ON TOP OF the base dialogue line schema. Pool-level character partitioning (D-032) is enforced at the pool root, not per-line.",
|
|
"type": "object",
|
|
"required": ["trigger"],
|
|
"properties": {
|
|
"character": {
|
|
"type": "string",
|
|
"enum": ["smuggler", "detective"],
|
|
"description": "D-032: hard partition tag. Which playable character this line belongs to. Must match the parent pool's character field."
|
|
},
|
|
"trigger": {
|
|
"type": "string",
|
|
"enum": [
|
|
"enter_location",
|
|
"observe_npc",
|
|
"hear_sound",
|
|
"observe_anomaly",
|
|
"post_conversation",
|
|
"discover_evidence",
|
|
"witness_interaction",
|
|
"time_idle",
|
|
"return_visit"
|
|
],
|
|
"description": "What causes this monologue line to fire. 9 v0.1 trigger types."
|
|
},
|
|
"prerequisite": {
|
|
"description": "Knowledge state gate. null = unconditional (fires whenever triggered). Conditions are AND-evaluated. Uses FactIds from the knowledge vocabulary (#368, D-041).",
|
|
"oneOf": [
|
|
{ "type": "null" },
|
|
{
|
|
"type": "object",
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"facts": {
|
|
"type": "array",
|
|
"items": { "$ref": "#/$defs/fact_prerequisite" }
|
|
},
|
|
"entity_attributes": {
|
|
"type": "array",
|
|
"items": { "$ref": "#/$defs/attribute_prerequisite" }
|
|
},
|
|
"relationship": {
|
|
"type": "object",
|
|
"required": ["target", "state"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"target": { "type": "string" },
|
|
"state": {
|
|
"type": "string",
|
|
"enum": ["unknown", "known", "friendly", "person_of_interest", "hostile"]
|
|
}
|
|
}
|
|
}
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"priority": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"maximum": 10,
|
|
"default": 5,
|
|
"description": "Selection priority. Higher = more likely to fire when multiple lines are eligible. Default: 5."
|
|
},
|
|
"cooldown": {
|
|
"type": "integer",
|
|
"minimum": 0,
|
|
"default": 0,
|
|
"description": "Minimum simulation ticks before this line can fire again. Default: 0 (no cooldown)."
|
|
}
|
|
}
|
|
},
|
|
"fact_prerequisite": {
|
|
"type": "object",
|
|
"required": ["fact_id", "min_confidence"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"fact_id": {
|
|
"type": "string",
|
|
"description": "FactId from the knowledge vocabulary (#368, D-041)."
|
|
},
|
|
"min_confidence": {
|
|
"type": "string",
|
|
"enum": ["suspects", "knows_of", "knows_details", "direct"],
|
|
"description": "Minimum D-041 confidence level required for this fact."
|
|
}
|
|
}
|
|
},
|
|
"attribute_prerequisite": {
|
|
"type": "object",
|
|
"required": ["entity", "key", "value"],
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"entity": { "type": "string" },
|
|
"key": { "type": "string" },
|
|
"value": { "type": "string" }
|
|
}
|
|
},
|
|
"situation_enum": {
|
|
"type": "string",
|
|
"enum": [
|
|
"arrival",
|
|
"shift_start",
|
|
"shift_end",
|
|
"shift_transition",
|
|
"bar_evening",
|
|
"night_shift",
|
|
"investigation",
|
|
"confrontation",
|
|
"social",
|
|
"alone",
|
|
"emergency",
|
|
"routine",
|
|
"observation",
|
|
"greeting"
|
|
],
|
|
"description": "14 v0.1 situation values (D-035 + Sprint 8 amendment)."
|
|
},
|
|
"topic_enum": {
|
|
"type": "string",
|
|
"enum": [
|
|
"colleague",
|
|
"routine",
|
|
"cargo",
|
|
"money",
|
|
"trust",
|
|
"danger",
|
|
"institution",
|
|
"personal",
|
|
"investigation"
|
|
],
|
|
"description": "9 v0.1 topic values (D-035)."
|
|
},
|
|
"mood_enum": {
|
|
"type": "string",
|
|
"enum": [
|
|
"anxious",
|
|
"frustrated",
|
|
"content",
|
|
"suspicious",
|
|
"warm",
|
|
"hostile",
|
|
"relieved",
|
|
"focused"
|
|
],
|
|
"description": "8 v0.1 mood values. Renamed Sprint 14 to match voice guide vocabulary. Neutral = untagged."
|
|
}
|
|
}
|
|
}
|