roboco/tests/foundation/test_journaling.py

"""Tier 1 — journaling scope catalog."""

from __future__ import annotations

from roboco.foundation import identity
from roboco.foundation.policy import journaling
from roboco.models.base import JournalEntryType


def test_scope_enum_has_five_panel_ui_values() -> None:
    """Panel UI exposes 5 scopes: Notes/Decisions/Reflections/Learnings/Struggles."""
    expected = {"note", "decision", "reflect", "learning", "struggle"}
    actual = {s.value for s in journaling.Scope}
    assert actual == expected, f"Scope drift: {actual ^ expected}"


def test_scope_to_type_covers_every_scope() -> None:
    for scope in journaling.Scope:
        assert scope in journaling.SCOPE_TO_TYPE, f"{scope.value} missing"


def test_scope_to_type_maps_to_canonical_journal_entry_types() -> None:
    assert journaling.SCOPE_TO_TYPE[journaling.Scope.NOTE] == JournalEntryType.GENERAL
    assert (
        journaling.SCOPE_TO_TYPE[journaling.Scope.DECISION]
        == JournalEntryType.DECISION_LOG
    )
    assert (
        journaling.SCOPE_TO_TYPE[journaling.Scope.REFLECT]
        == JournalEntryType.TASK_REFLECTION
    )
    assert (
        journaling.SCOPE_TO_TYPE[journaling.Scope.LEARNING] == JournalEntryType.LEARNING
    )
    assert (
        journaling.SCOPE_TO_TYPE[journaling.Scope.STRUGGLE] == JournalEntryType.STRUGGLE
    )


def test_scope_string_values_match_panel_ui() -> None:
    """The agent-facing string values must match what the UI renders."""
    assert journaling.Scope.NOTE.value == "note"
    assert journaling.Scope.DECISION.value == "decision"
    assert journaling.Scope.REFLECT.value == "reflect"
    assert journaling.Scope.LEARNING.value == "learning"
    assert journaling.Scope.STRUGGLE.value == "struggle"


def test_read_tier_enum_has_5_levels() -> None:
    expected = {"own", "cell", "cell_and_pms", "all_cells", "all"}
    actual = {t.value for t in journaling.ReadTier}
    assert actual == expected


def test_role_read_tiers_cover_every_role() -> None:
    for role in identity.Role:
        assert role in journaling.ROLE_READ_TIERS, f"Role.{role.name} missing"


def test_protected_journals_includes_ceo_and_auditor() -> None:
    assert "ceo" in journaling.PROTECTED_JOURNALS
    assert "auditor" in journaling.PROTECTED_JOURNALS


def test_developer_read_tier_is_cell() -> None:
    assert (
        journaling.ROLE_READ_TIERS[identity.Role.DEVELOPER] == journaling.ReadTier.CELL
    )


def test_main_pm_read_tier_is_all_cells() -> None:
    assert (
        journaling.ROLE_READ_TIERS[identity.Role.MAIN_PM]
        == journaling.ReadTier.ALL_CELLS
    )


def test_auditor_read_tier_is_all() -> None:
    """Auditor sees everything (silent observer)."""
    assert journaling.ROLE_READ_TIERS[identity.Role.AUDITOR] == journaling.ReadTier.ALL


def test_ceo_read_tier_is_all() -> None:
    assert journaling.ROLE_READ_TIERS[identity.Role.CEO] == journaling.ReadTier.ALL