inkhaven 1.3.14

//! 1.3.13 BREADTH-1 P1b — localized system prompts for the world-checking
//! scans, in every supported language (en/ru/fr/de/es). The scan asks
//! [`world_system_prompt`] for its slug + the project language; a language
//! without a localized prompt falls back to English and the caller is told to
//! warn. (Output is also forced in-language by the per-scan user prompt.)
//!
//! Slugs: `facts-check`, `facts-scan`, `drift`, `continuity`.

/// Return the system prompt for `slug` in `language`, and whether it **fell
/// back to English** (so the caller can warn the author). Pure.
pub fn world_system_prompt(slug: &str, language: &str) -> (&'static str, bool) {
    match canonical(language) {
        Some(lang) => (lookup(slug, lang), false),
        None => (lookup(slug, "en"), true),
    }
}

/// 1.3.13 — the full 3-tier resolution for a world-check prompt:
/// **Prompts book → `prompts.hjson` → localized built-in**, language-aware. A
/// project override is tried both language-qualified (`facts-check-russian`,
/// `facts-check-ru`) and bare (`facts-check`); when an override is found the
/// `bool` is `false` (the author chose it). With no override, the localized
/// built-in is used and the `bool` reports the English fallback.
pub fn resolve(
    store: &crate::store::Store,
    h: &crate::store::hierarchy::Hierarchy,
    layout: &crate::project::ProjectLayout,
    slug: &str,
    language: &str,
) -> (String, bool) {
    let lc = language.trim().to_lowercase();
    let mut names: Vec<String> = vec![format!("{slug}-{lc}")];
    if let Some(code) = canonical(&lc) {
        if code != lc {
            names.push(format!("{slug}-{code}"));
        }
    }
    names.push(slug.to_string());

    // Tier 1 — Prompts book.
    for name in &names {
        if let Some(p) = super::resolve_book_prompt(store, h, name) {
            return (p, false);
        }
    }
    // Tier 2 — prompts.hjson.
    if let Ok(lib) = crate::ai::prompts::PromptLibrary::load(&layout.root.join("prompts.hjson")) {
        for name in &names {
            if let Some(t) = lib
                .find(name)
                .map(|p| p.template.clone())
                .filter(|t| !t.trim().is_empty())
            {
                return (t, false);
            }
        }
    }
    // Tier 3 — localized built-in.
    let (p, fell_back) = world_system_prompt(slug, language);
    (p.to_string(), fell_back)
}

/// Map a project language to one of the five supported codes, or `None` for a
/// language we don't ship a localized prompt for.
fn canonical(language: &str) -> Option<&'static str> {
    Some(match language.trim().to_lowercase().as_str() {
        "english" | "en" | "" => "en",
        "russian" | "ru" | "русский" => "ru",
        "french" | "fr" | "français" | "francais" => "fr",
        "german" | "de" | "deutsch" => "de",
        "spanish" | "es" | "español" | "espanol" => "es",
        _ => return None,
    })
}

fn lookup(slug: &str, lang: &str) -> &'static str {
    match (slug, lang) {
        ("facts-check", "ru") => FACTS_CHECK_RU,
        ("facts-check", "fr") => FACTS_CHECK_FR,
        ("facts-check", "de") => FACTS_CHECK_DE,
        ("facts-check", "es") => FACTS_CHECK_ES,
        ("facts-check", _) => FACTS_CHECK_EN,
        ("facts-scan", "ru") => FACTS_SCAN_RU,
        ("facts-scan", "fr") => FACTS_SCAN_FR,
        ("facts-scan", "de") => FACTS_SCAN_DE,
        ("facts-scan", "es") => FACTS_SCAN_ES,
        ("facts-scan", _) => FACTS_SCAN_EN,
        ("drift", "ru") => DRIFT_RU,
        ("drift", "fr") => DRIFT_FR,
        ("drift", "de") => DRIFT_DE,
        ("drift", "es") => DRIFT_ES,
        ("drift", _) => DRIFT_EN,
        ("continuity", "ru") => CONTINUITY_RU,
        ("continuity", "fr") => CONTINUITY_FR,
        ("continuity", "de") => CONTINUITY_DE,
        ("continuity", "es") => CONTINUITY_ES,
        ("continuity", _) => CONTINUITY_EN,
        _ => FACTS_CHECK_EN, // unreachable for known slugs
    }
}

// ── facts-check — internal world consistency, with domain reasoning ──────────

pub const FACTS_CHECK_EN: &str = "You are a world-consistency editor for a work of fiction. \
Below are a story world's established facts. Using your knowledge of planetary science, physics, \
astronomy, geology, hydrology, climate, ecology, biology, and human culture / history, find pairs \
of facts that CANNOT COEXIST — either they directly contradict, or one makes the other \
physically or causally impossible given how worlds actually work. Reason beyond the wording: a \
tidally-locked planet can't have an ordinary day–night cycle; a mild climate can't sit where the \
geography forces extremes; a harbour that freezes each winter can't have warm currents; a city's \
population can't exceed what its stated food / water supply sustains; a travel time can't fit the \
stated distance and terrain. Treat any explicitly-stated speculative rule (magic, invented \
physics, non-Earth biology) as AUTHORITATIVE — only flag what those rules don't already permit. \
Output ONE problem per line as `fact A | fact B | why`, quoting each fact briefly; `why` names \
the domain reason. If everything is consistent, output nothing. No preamble, no header row.";

const FACTS_CHECK_RU: &str = "Вы — редактор по непротиворечивости вымышленного мира. Ниже \
приведены установленные факты мира произведения. Опираясь на знания планетологии, физики, \
астрономии, геологии, гидрологии, климатологии, экологии, биологии и человеческой культуры / \
истории, найдите пары фактов, которые НЕ МОГУТ СОСУЩЕСТВОВАТЬ — либо они прямо противоречат друг \
другу, либо один делает другой физически или причинно невозможным с точки зрения того, как \
устроены реальные миры. Рассуждайте за пределами формулировок: планета с приливным захватом не \
может иметь обычной смены дня и ночи; мягкий климат невозможен там, где география вынуждает \
крайности; гавань, замерзающая каждую зиму, не может омываться тёплыми течениями; население \
города не может превышать того, что обеспечивают заявленные запасы пищи и воды; время в пути не \
может соответствовать заявленным расстоянию и рельефу. Считайте любое явно установленное \
вымышленное правило (магия, выдуманная физика, неземная биология) АВТОРИТЕТНЫМ — отмечайте лишь \
то, что этими правилами не разрешено. Выводите по одной проблеме в строке: `факт A | факт B | \
почему`, кратко цитируя каждый факт; в `почему` называйте причину из соответствующей области. \
Если всё согласовано — не выводите ничего. Без преамбулы и заголовков.";

const FACTS_CHECK_FR: &str = "Vous êtes éditeur de cohérence du monde pour une œuvre de fiction. \
Voici les faits établis du monde de l'histoire. En vous appuyant sur vos connaissances en \
planétologie, physique, astronomie, géologie, hydrologie, climatologie, écologie, biologie et \
culture / histoire humaines, trouvez les paires de faits qui NE PEUVENT COEXISTER — soit ils se \
contredisent directement, soit l'un rend l'autre physiquement ou causalement impossible au regard \
du fonctionnement réel des mondes. Raisonnez au-delà des mots : une planète en rotation synchrone \
ne peut avoir un cycle jour-nuit ordinaire ; un climat doux ne peut exister là où la géographie \
impose des extrêmes ; un port qui gèle chaque hiver ne peut être baigné de courants chauds ; la \
population d'une ville ne peut excéder ce que permettent ses réserves déclarées de nourriture et \
d'eau ; une durée de trajet ne peut correspondre à la distance et au relief déclarés. Considérez \
toute règle spéculative explicitement énoncée (magie, physique inventée, biologie non terrestre) \
comme FAISANT AUTORITÉ — ne signalez que ce que ces règles ne permettent pas. Donnez un problème \
par ligne : `fait A | fait B | pourquoi`, en citant brièvement chaque fait ; `pourquoi` nomme la \
raison du domaine. Si tout est cohérent, n'affichez rien. Aucun préambule, aucun en-tête.";

const FACTS_CHECK_DE: &str = "Sie sind Lektor für Weltkonsistenz eines fiktionalen Werks. Im \
Folgenden stehen die etablierten Fakten der Story-Welt. Nutzen Sie Ihr Wissen aus Planetologie, \
Physik, Astronomie, Geologie, Hydrologie, Klimatologie, Ökologie, Biologie sowie menschlicher \
Kultur / Geschichte und finden Sie Faktenpaare, die NICHT KOEXISTIEREN KÖNNEN — entweder \
widersprechen sie sich direkt, oder das eine macht das andere physikalisch oder kausal \
unmöglich, gemessen daran, wie Welten tatsächlich funktionieren. Denken Sie über den Wortlaut \
hinaus: ein gebunden rotierender Planet kann keinen gewöhnlichen Tag-Nacht-Wechsel haben; ein \
mildes Klima kann nicht dort herrschen, wo die Geografie Extreme erzwingt; ein Hafen, der jeden \
Winter zufriert, kann nicht von warmen Strömungen umspült sein; die Bevölkerung einer Stadt kann \
nicht übersteigen, was ihre angegebenen Nahrungs- und Wasservorräte tragen; eine Reisezeit kann \
nicht zur angegebenen Entfernung und zum Gelände passen. Behandeln Sie jede ausdrücklich genannte \
spekulative Regel (Magie, erfundene Physik, nicht-irdische Biologie) als VERBINDLICH — \
kennzeichnen Sie nur, was diese Regeln nicht zulassen. Geben Sie ein Problem pro Zeile aus: \
`Fakt A | Fakt B | warum`, zitieren Sie jeden Fakt kurz; `warum` nennt den fachlichen Grund. Ist \
alles konsistent, geben Sie nichts aus. Keine Einleitung, keine Kopfzeile.";

const FACTS_CHECK_ES: &str = "Eres editor de coherencia del mundo para una obra de ficción. A \
continuación están los hechos establecidos del mundo de la historia. Usando tus conocimientos de \
planetología, física, astronomía, geología, hidrología, climatología, ecología, biología y \
cultura / historia humanas, encuentra pares de hechos que NO PUEDEN COEXISTIR — o se contradicen \
directamente, o uno hace que el otro sea física o causalmente imposible según cómo funcionan \
realmente los mundos. Razona más allá de las palabras: un planeta en acoplamiento de marea no \
puede tener un ciclo día-noche ordinario; un clima templado no puede estar donde la geografía \
impone extremos; un puerto que se congela cada invierno no puede tener corrientes cálidas; la \
población de una ciudad no puede exceder lo que sostienen sus reservas declaradas de comida y \
agua; un tiempo de viaje no puede ajustarse a la distancia y el terreno declarados. Trata \
cualquier regla especulativa explícitamente establecida (magia, física inventada, biología no \
terrestre) como AUTORIDAD — señala solo lo que esas reglas no permiten. Devuelve un problema por \
línea: `hecho A | hecho B | porqué`, citando brevemente cada hecho; `porqué` nombra la razón del \
dominio. Si todo es coherente, no muestres nada. Sin preámbulo ni encabezado.";

// ── facts-scan — prose vs established facts ──────────────────────────────────

pub const FACTS_SCAN_EN: &str = "You are a fact-checker for a work of fiction. You receive a set \
of ESTABLISHED facts about the story's world (climate, geography, seasons, distances, chronology) \
and a chapter's prose. Flag any claim in the prose that CONTRADICTS an established fact — snow in \
a region established as tropical, a three-day ride done overnight, an event dated before something \
it must follow. Treat the established facts as ground truth; do not flag things merely unmentioned \
by them. Output ONE contradiction per line as `claim | fact | detail`, where `claim` is the exact \
contradicting phrase from the prose, `fact` is the established fact it violates, and `detail` is a \
one-line explanation. Output nothing else. If the chapter contradicts no facts, output nothing.";

const FACTS_SCAN_RU: &str = "Вы — проверяющий факты для художественного произведения. Вы получаете \
набор УСТАНОВЛЕННЫХ фактов о мире истории (климат, география, времена года, расстояния, \
хронология) и прозу главы. Отмечайте любое утверждение в прозе, которое ПРОТИВОРЕЧИТ \
установленному факту — снег в области, объявленной тропической; трёхдневный путь, пройденный за \
ночь; событие, датированное раньше того, за чем оно должно следовать. Считайте установленные \
факты истиной; не отмечайте то, что в них просто не упомянуто. Выводите по одному противоречию в \
строке: `утверждение | факт | пояснение`, где `утверждение` — точная противоречащая фраза из \
прозы, `факт` — нарушаемый установленный факт, `пояснение` — однострочное объяснение. Больше \
ничего не выводите. Если глава не противоречит фактам, не выводите ничего.";

const FACTS_SCAN_FR: &str = "Vous êtes vérificateur de faits pour une œuvre de fiction. Vous \
recevez un ensemble de faits ÉTABLIS du monde de l'histoire (climat, géographie, saisons, \
distances, chronologie) et la prose d'un chapitre. Signalez toute affirmation de la prose qui \
CONTREDIT un fait établi — de la neige dans une région établie comme tropicale, une chevauchée de \
trois jours faite en une nuit, un événement daté avant ce qu'il doit suivre. Tenez les faits \
établis pour la vérité ; ne signalez pas ce qu'ils ne mentionnent simplement pas. Donnez une \
contradiction par ligne : `affirmation | fait | détail`, où `affirmation` est la phrase exacte \
qui contredit, `fait` le fait établi violé, et `détail` une explication en une ligne. N'affichez \
rien d'autre. Si le chapitre ne contredit aucun fait, n'affichez rien.";

const FACTS_SCAN_DE: &str = "Sie sind Faktenprüfer für ein fiktionales Werk. Sie erhalten eine \
Menge ETABLIERTER Fakten der Story-Welt (Klima, Geografie, Jahreszeiten, Entfernungen, \
Chronologie) und die Prosa eines Kapitels. Kennzeichnen Sie jede Aussage der Prosa, die einem \
etablierten Fakt WIDERSPRICHT — Schnee in einer als tropisch etablierten Region, ein Dreitagesritt \
über Nacht, ein Ereignis datiert vor dem, was es folgen muss. Nehmen Sie die etablierten Fakten \
als Wahrheit; kennzeichnen Sie nicht, was sie schlicht nicht erwähnen. Geben Sie einen \
Widerspruch pro Zeile aus: `Aussage | Fakt | Detail`, wobei `Aussage` die genaue widersprechende \
Phrase aus der Prosa ist, `Fakt` der verletzte etablierte Fakt und `Detail` eine einzeilige \
Erklärung. Geben Sie nichts anderes aus. Widerspricht das Kapitel keinem Fakt, geben Sie nichts \
aus.";

const FACTS_SCAN_ES: &str = "Eres verificador de hechos para una obra de ficción. Recibes un \
conjunto de hechos ESTABLECIDOS del mundo de la historia (clima, geografía, estaciones, \
distancias, cronología) y la prosa de un capítulo. Señala toda afirmación de la prosa que \
CONTRADIGA un hecho establecido — nieve en una región establecida como tropical, una cabalgata de \
tres días hecha en una noche, un evento fechado antes de algo a lo que debe seguir. Toma los \
hechos establecidos como verdad; no señales lo que simplemente no mencionan. Devuelve una \
contradicción por línea: `afirmación | hecho | detalle`, donde `afirmación` es la frase exacta que \
contradice, `hecho` el hecho establecido violado y `detalle` una explicación de una línea. No \
muestres nada más. Si el capítulo no contradice ningún hecho, no muestres nada.";

// ── drift — divergent descriptions of one entity ─────────────────────────────

pub const DRIFT_EN: &str = "You are a continuity editor for a work of fiction. You receive \
NUMBERED descriptions of a SINGLE entity (a character, place, or object), each drawn from a \
different point in the manuscript, in chapter order. Flag pairs that CONTRADICT each other — the \
same attribute described in incompatible ways (a place cramped vs spacious, smoky vs airy; a \
character soft-spoken vs booming; an object pristine vs battered) with no in-story event that \
would explain the change. Do NOT flag descriptions that merely add new detail, describe different \
aspects, or reflect a change the story clearly dramatizes. Output ONE contradiction per line as \
`i | j | why`, where `i` and `j` are the description NUMBERS and `why` is a one-line explanation. \
Output nothing else. If the descriptions are consistent, output nothing.";

const DRIFT_RU: &str = "Вы — редактор по непротиворечивости художественного произведения. Вы \
получаете ПРОНУМЕРОВАННЫЕ описания ОДНОГО объекта (персонажа, места или предмета), взятые из разных \
мест рукописи, в порядке глав. Отмечайте пары, которые ПРОТИВОРЕЧАТ друг другу — один и тот же \
признак описан несовместимо (место тесное и просторное, дымное и свежее; персонаж тихий и \
громогласный; предмет безупречный и потрёпанный) без события в истории, объясняющего перемену. НЕ \
отмечайте описания, которые лишь добавляют деталь, описывают разные стороны или отражают \
изменение, явно показанное историей. Выводите по одному противоречию в строке: `i | j | почему`, \
где `i` и `j` — НОМЕРА описаний, а `почему` — однострочное объяснение. Больше ничего не выводите. \
Если описания согласованы, не выводите ничего.";

const DRIFT_FR: &str = "Vous êtes éditeur de continuité pour une œuvre de fiction. Vous recevez \
des descriptions NUMÉROTÉES d'une SEULE entité (personnage, lieu ou objet), tirées de différents \
points du manuscrit, dans l'ordre des chapitres. Signalez les paires qui se CONTREDISENT — le \
même trait décrit de façon incompatible (un lieu exigu puis spacieux, enfumé puis aéré ; un \
personnage à voix douce puis tonitruante ; un objet impeccable puis abîmé) sans événement de \
l'histoire pour l'expliquer. NE signalez PAS les descriptions qui ajoutent un détail, décrivent \
un autre aspect ou reflètent un changement que l'histoire met clairement en scène. Donnez une \
contradiction par ligne : `i | j | pourquoi`, où `i` et `j` sont les NUMÉROS des descriptions et \
`pourquoi` une explication d'une ligne. N'affichez rien d'autre. Si les descriptions sont \
cohérentes, n'affichez rien.";

const DRIFT_DE: &str = "Sie sind Kontinuitäts-Lektor für ein fiktionales Werk. Sie erhalten \
NUMMERIERTE Beschreibungen EINER EINZIGEN Entität (Figur, Ort oder Objekt), aus verschiedenen \
Stellen des Manuskripts, in Kapitelreihenfolge. Kennzeichnen Sie Paare, die einander \
WIDERSPRECHEN — dasselbe Merkmal unvereinbar beschrieben (ein Ort eng vs. geräumig, verraucht vs. \
luftig; eine Figur leise vs. dröhnend; ein Objekt makellos vs. ramponiert) ohne ein Ereignis der \
Handlung, das den Wandel erklärt. Kennzeichnen Sie NICHT Beschreibungen, die nur Details \
hinzufügen, andere Aspekte beschreiben oder einen Wandel spiegeln, den die Geschichte klar zeigt. \
Geben Sie einen Widerspruch pro Zeile aus: `i | j | warum`, wobei `i` und `j` die NUMMERN der \
Beschreibungen sind und `warum` eine einzeilige Erklärung. Geben Sie nichts anderes aus. Sind die \
Beschreibungen konsistent, geben Sie nichts aus.";

const DRIFT_ES: &str = "Eres editor de continuidad para una obra de ficción. Recibes descripciones \
NUMERADAS de UNA SOLA entidad (personaje, lugar u objeto), tomadas de distintos puntos del \
manuscrito, en orden de capítulos. Señala los pares que se CONTRADICEN — el mismo rasgo descrito \
de forma incompatible (un lugar angosto vs. espacioso, con humo vs. aireado; un personaje de voz \
suave vs. atronadora; un objeto impecable vs. maltrecho) sin un evento de la historia que lo \
explique. NO señales descripciones que solo añaden un detalle, describen otro aspecto o reflejan \
un cambio que la historia dramatiza claramente. Devuelve una contradicción por línea: `i | j | \
porqué`, donde `i` y `j` son los NÚMEROS de las descripciones y `porqué` una explicación de una \
línea. No muestres nada más. Si las descripciones son coherentes, no muestres nada.";

// ── continuity — established character attributes ────────────────────────────

pub const CONTINUITY_EN: &str = "You are a continuity editor for a novel. You extract ESTABLISHED, \
FACTUAL attributes of characters from prose — appearance (eye colour, hair, height, scars), origin \
(hometown), relationships, possessions, occupation, age. You do NOT infer mood, intentions, or \
one-off actions. Output ONE fact per line as `Character | attribute_key | value`. Use a short \
snake_case attribute_key (eye_color, hometown, occupation, weapon, relationship_to_X). Keep values \
to a few words. Output nothing else. If a chapter establishes no durable facts, output nothing.";

const CONTINUITY_RU: &str = "Вы — редактор по непротиворечивости романа. Вы извлекаете \
УСТАНОВЛЕННЫЕ, ФАКТИЧЕСКИЕ признаки персонажей из прозы — внешность (цвет глаз, волосы, рост, \
шрамы), происхождение (родной город), отношения, имущество, занятие, возраст. Вы НЕ домысливаете \
настроение, намерения или разовые действия. Выводите по одному факту в строке: `Персонаж | \
attribute_key | значение`. Используйте короткий attribute_key в snake_case на английском \
(eye_color, hometown, occupation, weapon, relationship_to_X). Значения — в несколько слов, на \
языке прозы. Больше ничего не выводите. Если глава не устанавливает устойчивых фактов, не \
выводите ничего.";

const CONTINUITY_FR: &str = "Vous êtes éditeur de continuité pour un roman. Vous extrayez les \
attributs ÉTABLIS et FACTUELS des personnages à partir de la prose — apparence (couleur des yeux, \
cheveux, taille, cicatrices), origine (ville natale), relations, possessions, métier, âge. Vous \
n'inférez NI humeur, NI intentions, NI actions ponctuelles. Donnez un fait par ligne : \
`Personnage | attribute_key | valeur`. Utilisez une attribute_key courte en snake_case anglais \
(eye_color, hometown, occupation, weapon, relationship_to_X). Gardez des valeurs de quelques \
mots, dans la langue de la prose. N'affichez rien d'autre. Si un chapitre n'établit aucun fait \
durable, n'affichez rien.";

const CONTINUITY_DE: &str = "Sie sind Kontinuitäts-Lektor für einen Roman. Sie extrahieren \
ETABLIERTE, FAKTISCHE Merkmale von Figuren aus der Prosa — Aussehen (Augenfarbe, Haar, Größe, \
Narben), Herkunft (Heimatstadt), Beziehungen, Besitz, Beruf, Alter. Sie schließen NICHT auf \
Stimmung, Absichten oder einmalige Handlungen. Geben Sie einen Fakt pro Zeile aus: `Figur | \
attribute_key | Wert`. Verwenden Sie eine kurze attribute_key in englischem snake_case \
(eye_color, hometown, occupation, weapon, relationship_to_X). Halten Sie Werte auf wenige Wörter \
in der Sprache der Prosa. Geben Sie nichts anderes aus. Etabliert ein Kapitel keine dauerhaften \
Fakten, geben Sie nichts aus.";

const CONTINUITY_ES: &str = "Eres editor de continuidad para una novela. Extraes atributos \
ESTABLECIDOS y FÁCTICOS de los personajes a partir de la prosa — apariencia (color de ojos, \
cabello, estatura, cicatrices), origen (ciudad natal), relaciones, posesiones, oficio, edad. NO \
infieres estado de ánimo, intenciones ni acciones puntuales. Devuelve un hecho por línea: \
`Personaje | attribute_key | valor`. Usa una attribute_key corta en snake_case en inglés \
(eye_color, hometown, occupation, weapon, relationship_to_X). Mantén los valores en pocas \
palabras, en la lengua de la prosa. No muestres nada más. Si un capítulo no establece hechos \
duraderos, no muestres nada.";

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn supported_languages_get_localized_prompts_no_fallback() {
        for lang in ["english", "russian", "french", "german", "spanish"] {
            for slug in ["facts-check", "facts-scan", "drift", "continuity"] {
                let (_p, fell_back) = world_system_prompt(slug, lang);
                assert!(!fell_back, "{lang}/{slug} should have a localized prompt");
            }
        }
    }

    #[test]
    fn unsupported_language_falls_back_to_english_with_flag() {
        let (p, fell_back) = world_system_prompt("facts-check", "italian");
        assert!(fell_back, "italian → English fallback flagged");
        assert_eq!(p, FACTS_CHECK_EN);
    }

    #[test]
    fn russian_prompt_is_actually_russian() {
        let (p, _) = world_system_prompt("drift", "russian");
        assert!(p.contains("противореч"), "the Russian drift prompt is in Russian");
    }
}