Panama/tests/quickshell/phone-messages-contract

#!/usr/bin/env bash

set -euo pipefail

project_root="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
phone_controls="$project_root/config/dot/quickshell/modules/quicksettings/PhoneControls.qml"
phone_actions="$project_root/config/dot/quickshell/modules/quicksettings/PhoneActions.qml"
quicksettings_qmldir="$project_root/config/dot/quickshell/modules/quicksettings/qmldir"
system_settings="$project_root/config/dot/quickshell/services/SystemSettings.qml"
harness="$project_root/config/dot/quickshell/phone-controls-harness.qml"
kde_fixture="$project_root/tests/quickshell/fixtures/PhoneControlsKdeConnect.qml"
settings_fixture="$project_root/tests/quickshell/fixtures/PhoneControlsSystemSettings.qml"
state_home="$(mktemp -d /tmp/panama-phone-controls.XXXXXX)"
config_path="$state_home/quickshell"

fail() {
    printf 'Phone Messages contract: %s\n' "$1" >&2
    exit 1
}

[[ -f "$phone_controls" ]] || fail 'Phone controls component is missing'
[[ -f "$phone_actions" ]] || fail 'Nonvisual Phone actions component is missing'
[[ -f "$system_settings" ]] || fail 'System settings service is missing'
[[ -f "$harness" ]] || fail 'Phone controls runtime harness is missing'
[[ -f "$kde_fixture" ]] || fail 'Phone controls KDE fixture is missing'
[[ -f "$settings_fixture" ]] || fail 'Phone controls System Settings fixture is missing'

rg -Fq 'PhoneActions 1.0 PhoneActions.qml' "$quicksettings_qmldir" \
    || fail 'Phone actions component is not registered'
rg -Fq 'PhoneActions {' "$phone_controls" \
    || fail 'Phone controls do not consume the shared action model'
rg -Fq 'readonly property var actionModels: phoneActions.actionModels' "$phone_controls" \
    || fail 'Phone controls do not render the shared action models'
rg -Fq 'PhoneActions {' "$harness" \
    || fail 'Runtime harness does not use the nonvisual action model'
if rg -Fq 'PhoneControls {' "$harness"; then
    fail 'Runtime harness still instantiates the visual Phone controls tree'
fi

cleanup() {
    XDG_STATE_HOME="$state_home" QS_DISABLE_CRASH_HANDLER=1 \
        qs -p "$config_path/phone-controls-harness.qml" kill >/dev/null 2>&1 || true
    rm -rf "$state_home"
}
trap cleanup EXIT

qs_for_harness() {
    XDG_STATE_HOME="$state_home" QS_DISABLE_CRASH_HANDLER=1 \
        qs -p "$config_path/phone-controls-harness.qml" "$@"
}

start_harness() {
    cp -a "$project_root/config/dot/quickshell" "$config_path"
    cp "$kde_fixture" "$config_path/services/KdeConnect.qml"
    cp "$settings_fixture" "$config_path/services/SystemSettings.qml"
    qs_for_harness --daemonize >/dev/null
    for _ in $(seq 1 40); do
        if qs_for_harness ipc show 2>/dev/null | rg -q '^target phone-controls-test$'; then
            return
        fi
        sleep 0.1
    done
    fail 'isolated Phone controls harness did not start'
}

assert_fixture_state() {
    local fixture="$1"
    local expected="$2"

    qs_for_harness ipc call phone-controls-test fixture "$fixture" >/dev/null
    local actual
    actual="$(qs_for_harness ipc call phone-controls-test status)"
    [[ -n "$actual" ]] || fail 'Phone controls do not expose runtime action enablement'
    jq -e --argjson expected "$expected" '
        .bluebubblesAvailable == true and .appLaunches == 0 and .phoneActions == 0 and
        (.actions | length == 4) and
        ([.actions[] | select(.id == "messages") | .enabled] == [true]) and
        ([.actions[] | select(.id != "messages") | .enabled] == $expected)
    ' <<<"$actual" >/dev/null \
        || fail "unexpected $fixture action state: $actual"
}

# These source checks do not evaluate the launch branch. The isolated runtime
# harness below uses fixture singletons and only reads action-model status.

rg -Fq '"bluebubbles": ["flatpak", "run", "app.bluebubbles.BlueBubbles"]' "$system_settings" \
    || fail 'BlueBubbles does not use the fixed Flatpak argument vector'
rg -Fq 'readonly property bool bluebubblesAvailable: root.bluebubblesDetected' "$system_settings" \
    || fail 'BlueBubbles availability is not exposed independently'
rg -Fq 'command: ["flatpak", "info", "app.bluebubbles.BlueBubbles"]' "$system_settings" \
    || fail 'BlueBubbles installed-state probe is missing'

for action in share clipboard ring messages; do
    rg -Fq "id: \"$action\"" "$phone_actions" \
        || fail "Phone actions do not include $action"
done

if rg -Fq '.filter(' "$phone_actions"; then
    fail 'Phone actions are filtered instead of keeping four stable columns'
fi
rg -Fq 'columns: 4' "$phone_controls" \
    || fail 'Phone actions do not use four equal columns'
rg -Fq 'root.actionModels.length - 1' "$phone_controls" \
    || fail 'Phone action widths are not calculated from the fixed model count'
rg -Fq 'SystemSettings.bluebubblesAvailable' "$phone_controls" \
    || fail 'Messages enablement does not read BlueBubbles availability'
rg -Fq 'KdeConnect.phoneReachable' "$phone_controls" \
    || fail 'KDE action reachability semantics are missing'
rg -Fq 'function actionEnabled(action: string): bool' "$phone_controls" \
    || fail 'Phone controls do not expose action enablement'
rg -Fq 'KdeConnect.supports(action)' "$phone_actions" \
    || fail 'KDE action capability semantics are missing'
rg -Fq 'else if (action === "messages")' "$phone_controls" \
    || fail 'Messages has no independent invocation branch'
rg -Fq 'SystemSettings.openApplication("bluebubbles")' "$phone_controls" \
    || fail 'Messages does not use the allow-listed BlueBubbles launcher'
rg -Fq 'BlueBubbles is not installed' "$phone_controls" \
    || fail 'Missing BlueBubbles has no quiet explanatory row'
rg -Fq 'KDE Connect actions are unavailable until the iPhone reconnects' "$phone_controls" \
    || fail 'Offline copy does not scope unavailability to KDE Connect actions'
rg -Fq 'border.width: actionMouse.activeFocus ? 2 : 0' "$phone_controls" \
    || fail 'Phone actions do not visibly indicate keyboard focus'
rg -Fq 'Accessible.role: Accessible.Button' "$phone_controls" \
    || fail 'Phone actions do not expose an Accessible button role'
rg -Fq 'Accessible.name: actionButton.modelData.label' "$phone_controls" \
    || fail 'Phone actions do not expose their accessible name'
rg -Fq 'Accessible.description: root.actionAccessibleDescription(actionButton.modelData.id)' "$phone_controls" \
    || fail 'Phone actions do not expose their availability state'
rg -Fq 'Accessible.focusable: actionMouse.enabled' "$phone_controls" \
    || fail 'Phone action accessibility does not respect disabled state'
rg -Fq 'Accessible.onPressAction:' "$phone_controls" \
    || fail 'Phone actions do not provide an accessible press handler'

# A static negative guard keeps the Messages branch from accidentally inheriting
# KDE Connect reachability, transfer, or plugin conditions.
messages_branch="$(sed -n '/else if (action === "messages")/,/^    }/p' "$phone_controls")"
printf '%s\n' "$messages_branch" | rg -Fq 'KdeConnect.' \
    && fail 'Messages is coupled to KDE Connect'

start_harness
assert_fixture_state offline '[false, false, false]'
assert_fixture_state unsupported '[true, false, false]'
assert_fixture_state transfer '[false, false, false]'

printf 'Phone Messages contract: PASS\n'