"""custom-html — pre-op seed hooks (Phase 1e HC3). The orchestrator runs `pre_<op>(ctx)`
BEFORE it performs the op; the matching test_<op>.py asserts the post-op state (assertion-only).

nginx serves the volume at /usr/share/nginx/html, so the marker file survives an upgrade / a
backup+restore of that volume and is both HTTP-readable and exec-readable."""

import os
import sys

sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", "runner"))
from harness import lifecycle  # noqa: E402

MARKER_PATH = "/usr/share/nginx/html/ci-marker.txt"


def _write(domain: str, val: str) -> None:
    lifecycle.exec_in_app(domain, ["sh", "-c", f"echo {val} > {MARKER_PATH}"])


def pre_upgrade(ctx):
    # seed a marker before the upgrade so the overlay can prove the data survives it
    _write(ctx.domain, "upgrade-survives")


def pre_backup(ctx):
    # establish a known original state before the backup op captures it
    _write(ctx.domain, "original")


def pre_restore(ctx):
    # diverge from the backed-up state so a successful restore (back to "original") is observable
    _write(ctx.domain, "mutated")
