# Parity — ghost

The recipe-maintainer corpus has **no** `recipe-info/ghost/tests/` directory — ghost was not in
their parity suite. This PARITY.md documents the Phase-2 health_check (parity-aligned baseline)
+ recipe-specific tests beyond.

## Recipe-specific tests (Phase-2 P3, ≥2 beyond parity)

Ghost is a **publishing platform** with a public themed site at `/`, an admin UI at `/ghost/`,
and a JSON Content/Admin API at `/ghost/api/*`. Defining behaviors exercised:

| cc-ci file | what's verified | rationale |
|---|---|---|
| `tests/ghost/custom/test_content_api.py` | GETs `/ghost/api/content/settings/`; asserts 200 with `{"settings": {...}}` envelope OR 401/403 with a Ghost error envelope. | Distinguishes "the ghost-server JS process is up + emitting its API" from "a static themed page is served at /." A wedged Ghost backend → 5xx; misrouted nginx → 404. |
| `tests/ghost/custom/test_admin_redirect.py` | GETs `/ghost/`; asserts 200 or 302 + Ghost branding/SPA references in the response (or a redirect to /ghost/#/setup on fresh deploy). | Proves the admin route is wired through the nginx proxy. Distinguishes "admin SPA bound" from "404 (route missing)" or "5xx (broken)." |

Two specific tests + parity health_check = ≥2 floor met.

## Plan §4.3 prescribed deeper test — AUTHORED (closes DEFERRED ghost create-post)

§4.3 named "create-a-post round-trip" for ghost. Implemented in
`tests/ghost/custom/test_post_roundtrip.py` (helper `custom/_ghost.py`):
1. Wait for the Admin API healthcheck (`GET /ghost/api/admin/site/` → 200).
2. Setup the Ghost owner (POST `/ghost/api/admin/authentication/setup/`, fresh deploy) + establish
   an admin **session cookie** (POST `/ghost/api/admin/session/`) — cookie-aware stdlib opener,
   version-negotiated (no `/v3/` in the path; recipe-versioned).
3. POST `/ghost/api/admin/posts/?source=html` to create a published post with a unique marker in
   title + body.
4. GET `/ghost/api/admin/posts/<id>/?formats=html` to read it back; assert title + body marker
   round-trip intact (unique-per-run → non-vacuous).

Admin creds are class-B run-scoped (destroyed at teardown with the app).

## Backup data-integrity (P4) — AUTHORED

`ops.py` + `test_install`-free lifecycle overlays (`test_upgrade.py` / `test_backup.py` /
`test_restore.py`) seed a deterministic `ci_marker` row into the **MySQL** `ghost` DB (the recipe's
real state store) via the `mysql` CLI in the `db` service. The recipe's backupbot pre-hook
(`mysqldump ghost --tab`) dumps that table into the backed-up path, so the marker rides
backup→restore the way a real post's row would. pre_restore drops the table (divergence); the
restore overlay asserts it returned.

**Expected RED until a recipe-PR lands:** the ghost recipe has a logical mysqldump backup but **no
`backupbot.restore.*` hook** (and the mysql data volume itself isn't backupbot-labelled), so a
file-level restore never reimports the dump — same defect class fixed in immich#1 / mattermost-lts#1.
If `test_restore_returns_state` goes RED, the durable fix is a recipe-PR adding a mysqldump-reimport
restore post-hook. (See `test_restore.py` docstring + DECISIONS.md.)

## Playwright (P6)

Not yet authored. Ghost's admin UI is an Ember SPA; a Playwright flow would exercise the
setup wizard + post creation. Q4 follow-up.
