portfolio-optimiser/tests/test_mandate_cli.py

"""The CLI door onto the mandate (Trekk A6): ``--mandate <file.json>``.

Krav 1 and 2 are only real if a domain expert can reach them from a command line. This pins the
three visible halves:

1. the commission is loaded FAIL-FAST — a missing or malformed mandate refuses the run (rc 1),
   because a silently degraded commission would make the settlement describe work nobody ordered;
2. the run ANNOUNCES what it will do BEFORE it does it, and the announcement precedes the outcome
   line in the output (an after-the-fact statement of intent is not a statement of intent);
3. the run SETTLES against that commission afterwards, naming every approach.

The control asserts both blocks are absent without ``--mandate`` — so no assertion above can pass
on a constant the CLI prints anyway.
"""

from __future__ import annotations

import json
import shutil
from pathlib import Path

import pytest

from portfolio_optimiser import run

BUNDLE_DIR = Path(__file__).resolve().parents[1] / "shared" / "examples" / "bygg-energi-mikro"

_VALID_PROPOSAL = (
    '{"measure":"LED-retrofit av kontorbelysning","affected_items":'
    '[{"code":"ENERGI-TOTAL-EL","quantity":300000,"unit_cost":1.0}],"claimed_saving_nok":30000}'
)
_CHECKER_APPROVE = "Tallene er innenfor feasibelt område og resonnementet holder. VERDICT: APPROVE"

_MANDATE = {
    "objective": "Kutt energikostnad uten ombygging i 2026.",
    "approaches": [
        {
            "id": "led-retrofit",
            "label": "LED-retrofit av kontorbelysning",
            "description": "Drift mener armaturene er originale.",
        }
    ],
    "allow_own_proposals": False,
    "success_criteria": "Minst ett tiltak som passerer validatoren.",
}


@pytest.fixture(autouse=True)
def _isolate_model_env(monkeypatch: pytest.MonkeyPatch) -> None:
    monkeypatch.delenv("PORTFOLIO_MODEL_MAP", raising=False)
    monkeypatch.delenv("PORTFOLIO_FOUNDRY_PROJECT_ENDPOINT", raising=False)


@pytest.fixture()
def bundle(tmp_path: Path) -> Path:
    """A throwaway COPY — the commons-owned fixture is never mutated by a test."""
    dst = tmp_path / "bundle"
    shutil.copytree(BUNDLE_DIR, dst)
    return dst


@pytest.fixture()
def replies_file(tmp_path: Path) -> Path:
    path = tmp_path / "replies.json"
    path.write_text(
        json.dumps({"proposer": _VALID_PROPOSAL, "checker": _CHECKER_APPROVE}), encoding="utf-8"
    )
    return path


@pytest.fixture()
def mandate_file(tmp_path: Path) -> Path:
    path = tmp_path / "mandate.json"
    path.write_text(json.dumps(_MANDATE), encoding="utf-8")
    return path


def _argv(bundle: Path, replies: Path, *extra: str) -> list[str]:
    return [
        "BYGG-KONTOR-NORD",
        "--docs-dir",
        str(bundle),
        "--bundle-dir",
        str(bundle),
        "--scripted-replies",
        str(replies),
        *extra,
    ]


def test_missing_mandate_refuses_the_run(bundle, replies_file, capsys) -> None:
    """A mandate that is not there refuses — never treated as 'no mandate given'."""
    rc = run.main(_argv(bundle, replies_file, "--mandate", str(bundle / "nope.json")))
    assert rc == 1
    assert "refused" in capsys.readouterr().err.lower()


def test_malformed_mandate_refuses_the_run(bundle, replies_file, tmp_path, capsys) -> None:
    """A malformed commission refuses too: authoritative startup config, not a tolerant inbox."""
    bad = tmp_path / "bad.json"
    bad.write_text('{"approaches": []}', encoding="utf-8")  # no objective
    rc = run.main(_argv(bundle, replies_file, "--mandate", str(bad)))
    assert rc == 1
    assert "refused" in capsys.readouterr().err.lower()


def test_run_announces_the_mandate_before_it_runs(
    bundle, replies_file, mandate_file, capsys
) -> None:
    """The announcement names the objective and every commissioned approach, and it appears BEFORE
    the run's outcome line — intent stated up front, not reported after the fact."""
    rc = run.main(_argv(bundle, replies_file, "--mandate", str(mandate_file)))
    out = capsys.readouterr().out
    assert rc == 0, out
    assert "Run mandate for BYGG-KONTOR-NORD" in out
    assert "Kutt energikostnad uten ombygging i 2026." in out
    assert "led-retrofit" in out
    assert out.index("Run mandate for") < out.index("BYGG-KONTOR-NORD: ")


def test_run_settles_against_the_mandate_afterwards(
    bundle, replies_file, mandate_file, capsys
) -> None:
    """The settlement names every commissioned approach and its status, AFTER the run."""
    rc = run.main(_argv(bundle, replies_file, "--mandate", str(mandate_file)))
    out = capsys.readouterr().out
    assert rc == 0, out
    assert "Mandate outcome" in out
    assert "led-retrofit" in out.split("Mandate outcome")[1]
    assert out.index("Run mandate for") < out.index("Mandate outcome")


def test_dry_run_announces_without_calling_a_model(bundle, mandate_file, capsys) -> None:
    """``--live-dry-run`` shows what the run WOULD do — the announcement is offline by
    construction, so an operator can inspect a commission before paying for it."""
    rc = run.main(
        [
            "BYGG-KONTOR-NORD",
            "--docs-dir",
            str(bundle),
            "--bundle-dir",
            str(bundle),
            "--mandate",
            str(mandate_file),
            "--live-dry-run",
        ]
    )
    out = capsys.readouterr().out
    assert rc == 0, out
    assert "Run mandate for BYGG-KONTOR-NORD" in out
    assert "LIVE-DRY-RUN OK" in out
    # A dry run stops before the first model call, so there is nothing to settle.
    assert "Mandate outcome" not in out


def test_portfolio_mode_applies_the_mandate_to_every_project(
    replies_file, mandate_file, capsys
) -> None:
    """The mandate applies to every project in a portfolio pass, and each project settles for it
    separately — a threading line with no test of its own is the green-but-dead trap this repo
    was bitten by in Fase 2."""
    rc = run.main(
        [
            "--portfolio",
            "--scripted-replies",
            str(replies_file),
            "--mandate",
            str(mandate_file),
        ]
    )
    out = capsys.readouterr().out
    assert rc == 0, out
    assert "Run mandate for the portfolio" in out
    settlements = out.count("Mandate outcome")
    assert settlements >= 2, f"expected one settlement per project, saw {settlements}"
    assert "led-retrofit" in out.split("Mandate outcome")[1]


def test_no_mandate_prints_neither_block(bundle, replies_file, capsys) -> None:
    """CONTROL: without ``--mandate`` the CLI output is the pre-Trekk-A one — no announcement, no
    settlement. Every assertion above would otherwise be able to pass on constant output."""
    rc = run.main(_argv(bundle, replies_file))
    out = capsys.readouterr().out
    assert rc == 0, out
    assert "Run mandate for" not in out
    assert "Mandate outcome" not in out