*** Settings ***
Documentation     Docs build smoke test for the review playbook guide
...               Validates that the review playbook exists, parses correctly,
...               and contains all required sections.
Resource          ${CURDIR}/common.resource
Suite Setup       Setup Test Environment
Suite Teardown    Cleanup Test Environment

*** Variables ***
${HELPER_SCRIPT}    robot/helper_review_playbook.py
${PLAYBOOK_PATH}    docs/development/review_playbook.md

*** Test Cases ***
Review Playbook File Exists
    [Documentation]    Verify the review playbook markdown file is present
    [Tags]    docs    quality
    File Should Exist    ${WORKSPACE}/${PLAYBOOK_PATH}

Review Playbook Contains Required Sections
    [Documentation]    Verify all required sections are present in the playbook
    [Tags]    docs    quality
    ${result}=    Run Process    ${PYTHON}    ${HELPER_SCRIPT}    verify-sections    cwd=${WORKSPACE}
    Should Be Equal As Integers    ${result.rc}    0    msg=Section check failed: ${result.stderr}
    Should Contain    ${result.stdout}    review-playbook-sections-ok

Review Playbook References Nox Sessions
    [Documentation]    Verify the playbook references all required nox sessions
    [Tags]    docs    quality
    ${result}=    Run Process    ${PYTHON}    ${HELPER_SCRIPT}    verify-nox-references    cwd=${WORKSPACE}
    Should Be Equal As Integers    ${result.rc}    0    msg=Nox reference check failed: ${result.stderr}
    Should Contain    ${result.stdout}    review-playbook-nox-ok

Review Playbook Defines Severity Levels
    [Documentation]    Verify the playbook defines all P0-P3 severity levels
    [Tags]    docs    quality
    ${result}=    Run Process    ${PYTHON}    ${HELPER_SCRIPT}    verify-severity-levels    cwd=${WORKSPACE}
    Should Be Equal As Integers    ${result.rc}    0    msg=Severity check failed: ${result.stderr}
    Should Contain    ${result.stdout}    review-playbook-severity-ok

Review Playbook Contains Priority Matrix Table
    [Documentation]    Verify the priority matrix table is present
    [Tags]    docs    quality
    ${content}=    Get File    ${WORKSPACE}/${PLAYBOOK_PATH}
    Should Contain    ${content}    P0:blocker
    Should Contain    ${content}    P1:must-fix
    Should Contain    ${content}    P2:should-fix
    Should Contain    ${content}    P3:nit

Review Playbook Contains Routing Table Entries
    [Documentation]    Verify the routing table lists team members
    [Tags]    docs    quality
    ${content}=    Get File    ${WORKSPACE}/${PLAYBOOK_PATH}
    Should Contain    ${content}    Luis
    Should Contain    ${content}    Jeff
    Should Contain    ${content}    Aditya
    Should Contain    ${content}    Brent
    Should Contain    ${content}    Hamza
    Should Contain    ${content}    Rui
