mirror of
https://github.com/rennf93/roboco.git
synced 2026-08-03 07:23:24 +02:00
feat(auditor): waive_finding verb + findings queue panel
Wire the long-unwired mark_waived repo method to a new auditor-only flow verb waive_finding, severity-scoped to minor/nit (blocker/major must be fixed, never waived), requiring a note, with a task.finding_waived audit event and no task status change. Add the verb to the IntentSpec table (auto-derived into the auditor manifest), the flow_auditor route, and the flow_server MCP tool. Surface open review findings (cross-task, blocking-first) on the auditor dashboard via ReviewFindingsRepository.list_open_findings and a new findings field on AuditorDashboard. Restore the panel's 4-card auditor layout with a new read-only FindingsQueuePanel as the 4th card.
This commit is contained in:
@@ -0,0 +1,169 @@
|
||||
"""Choreographer.waive_finding — the auditor's close-without-fix verb.
|
||||
|
||||
``mark_waived`` was the long-unwired repo method; this is its only caller.
|
||||
Severity-scoped: blocker/major must be fixed, never waived. Only open
|
||||
findings are waivable, and a note is required. No task status changes —
|
||||
the ledger row ``open -> waived`` plus a ``task.finding_waived`` audit
|
||||
event is the durable record.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
from typing import Any
|
||||
from unittest.mock import AsyncMock, MagicMock
|
||||
from uuid import uuid4
|
||||
|
||||
import pytest
|
||||
from roboco.services.gateway.choreographer import Choreographer, ChoreographerDeps
|
||||
|
||||
|
||||
def _make_deps() -> ChoreographerDeps:
|
||||
base = {
|
||||
"task": AsyncMock(),
|
||||
"work_session": AsyncMock(),
|
||||
"git": AsyncMock(),
|
||||
"a2a": AsyncMock(),
|
||||
"journal": AsyncMock(),
|
||||
"audit": AsyncMock(),
|
||||
"evidence_repo": AsyncMock(),
|
||||
}
|
||||
repo = base["evidence_repo"]
|
||||
for method in (
|
||||
"list_unread_a2a",
|
||||
"list_unread_mentions",
|
||||
"list_pending_notifications",
|
||||
"task_metadata_gaps",
|
||||
"recent_team_activity",
|
||||
"blockers_in_lane",
|
||||
"journal_highlights_for_task",
|
||||
):
|
||||
getattr(repo, method).return_value = []
|
||||
return ChoreographerDeps(**base)
|
||||
|
||||
|
||||
def _finding_row(
|
||||
*,
|
||||
severity: str = "minor",
|
||||
status: str = "open",
|
||||
origin: str = "qa",
|
||||
) -> MagicMock:
|
||||
row = MagicMock()
|
||||
row.id = uuid4()
|
||||
row.task_id = uuid4()
|
||||
row.severity = severity
|
||||
row.status = status
|
||||
row.origin = origin
|
||||
return row
|
||||
|
||||
|
||||
def _patch_repo(monkeypatch: pytest.MonkeyPatch, row: Any | None) -> MagicMock:
|
||||
"""Patch the board-module ReviewFindingsRepository to return ``row`` from
|
||||
``get`` and a recording ``mark_waived``. ``row=None`` simulates not-found."""
|
||||
repo_mock = MagicMock()
|
||||
repo_mock.get = AsyncMock(return_value=row)
|
||||
repo_mock.mark_waived = AsyncMock(return_value=True)
|
||||
monkeypatch.setattr(
|
||||
"roboco.services.gateway.choreographer.board.ReviewFindingsRepository",
|
||||
lambda *_a, **_k: repo_mock,
|
||||
)
|
||||
return repo_mock
|
||||
|
||||
|
||||
def _choreographer(monkeypatch: pytest.MonkeyPatch, row: Any | None):
|
||||
deps = _make_deps()
|
||||
deps.task.session = MagicMock()
|
||||
c = Choreographer(deps)
|
||||
return c, _patch_repo(monkeypatch, row)
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_minor_open_finding_succeeds(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
row = _finding_row(severity="minor", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
|
||||
env = await c.waive_finding(uuid4(), row.id, "cosmetic, not worth a fix")
|
||||
|
||||
assert env.error is None
|
||||
assert env.status == "waived"
|
||||
repo_mock.mark_waived.assert_awaited_once_with(row.id, "cosmetic, not worth a fix")
|
||||
c.audit.log_task_event.assert_awaited_once()
|
||||
assert c.audit.log_task_event.await_args.kwargs["event_type"] == (
|
||||
"task.finding_waived"
|
||||
)
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_nit_open_finding_succeeds(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
row = _finding_row(severity="nit", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
env = await c.waive_finding(uuid4(), row.id, "preference only")
|
||||
assert env.error is None
|
||||
repo_mock.mark_waived.assert_awaited_once()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_rejects_blocker(monkeypatch: pytest.MonkeyPatch) -> None:
|
||||
row = _finding_row(severity="blocker", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
env = await c.waive_finding(uuid4(), row.id, "try to skip the fix")
|
||||
assert env.error == "invalid_state"
|
||||
repo_mock.mark_waived.assert_not_awaited()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_rejects_major(monkeypatch: pytest.MonkeyPatch) -> None:
|
||||
row = _finding_row(severity="major", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
env = await c.waive_finding(uuid4(), row.id, "try to skip the fix")
|
||||
assert env.error == "invalid_state"
|
||||
repo_mock.mark_waived.assert_not_awaited()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_rejects_already_addressed(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
row = _finding_row(severity="minor", status="addressed")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
env = await c.waive_finding(uuid4(), row.id, "already closed")
|
||||
assert env.error == "invalid_state"
|
||||
repo_mock.mark_waived.assert_not_awaited()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_rejects_blank_note(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
row = _finding_row(severity="minor", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
env = await c.waive_finding(uuid4(), row.id, " ")
|
||||
assert env.error == "invalid_state"
|
||||
repo_mock.mark_waived.assert_not_awaited()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_unknown_finding_returns_not_found(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
c, repo_mock = _choreographer(monkeypatch, None)
|
||||
env = await c.waive_finding(uuid4(), uuid4(), "note")
|
||||
assert env.error == "not_found"
|
||||
repo_mock.mark_waived.assert_not_awaited()
|
||||
|
||||
|
||||
@pytest.mark.asyncio
|
||||
async def test_waive_succeeds_even_if_audit_log_fails(
|
||||
monkeypatch: pytest.MonkeyPatch,
|
||||
) -> None:
|
||||
"""The audit event is best-effort: a log failure must not undo the waive."""
|
||||
row = _finding_row(severity="minor", status="open")
|
||||
c, repo_mock = _choreographer(monkeypatch, row)
|
||||
c.audit.log_task_event = AsyncMock(side_effect=RuntimeError("db gone"))
|
||||
|
||||
env = await c.waive_finding(uuid4(), row.id, "still waive me")
|
||||
assert env.error is None
|
||||
repo_mock.mark_waived.assert_awaited_once()
|
||||
Reference in New Issue
Block a user