Sync from kink_cli (Docker Space)

README.md

@@ -147,13 +147,16 @@ python scripts/audit_starter_deck.py --store data/store_slim.db --limit 24
 
 ## Live deployment
 
-- **Hub:** [huggingface.co/spaces/ronheichman/kink-discovery](https://huggingface.co/spaces/ronheichman/kink-discovery)
-- **App URL:** [ronheichman-kink-discovery.hf.space](https://ronheichman-kink-discovery.hf.space) (same-origin API + static UI)
+- **Hub:** [huggingface.co/spaces/Perplexed7675/kink-discovery](https://huggingface.co/spaces/Perplexed7675/kink-discovery)
+- **App URL:** [perplexed7675-kink-discovery.hf.space](https://perplexed7675-kink-discovery.hf.space) (same-origin API + static UI)
+- **Account persistence:** pick **one** option so user profiles survive restarts:
+  - **Paid:** enable HF Persistent Storage on the Space and set `KINK_STORE_PATH=/data/store_slim.db` + `KINK_FAIL_ON_EPHEMERAL_STORE=1`. Zero engineering, perfect durability.
+  - **Free (Hub-snapshot):** create a private HF Hub dataset (e.g. `Perplexed7675/kink-userstate`), then set Space variables `KINK_USER_SNAPSHOT_REPO=Perplexed7675/kink-userstate` and `HF_TOKEN=<write-token>`. The container then pulls the latest user-state snapshot on cold boot and pushes back every 60s when the user tables change (catalog stays on `/tmp`). Tunables: `KINK_USER_SNAPSHOT_FILENAME` (default `user_state.db`), `KINK_USER_SNAPSHOT_INTERVAL_S` (default 60). Trade-off: up to ~60s of writes can be lost on a hard crash; the Space must stay single-replica (cpu-basic is).
 
 Re-verify anytime:
 
 ```bash
-HF_VERIFY_BASE_URL=https://ronheichman-kink-discovery.hf.space python scripts/verify_hf_stack.py
+HF_VERIFY_BASE_URL=https://perplexed7675-kink-discovery.hf.space python scripts/verify_hf_stack.py
 ```
 
 After **frontend** changes, bump the `?v=` query on `frontend/index.html` styles + `app.js` so browsers load the new bundle, then redeploy (command below).
@@ -166,7 +169,7 @@ After **frontend** changes, bump the `?v=` query on `frontend/index.html` styles
 ```bash
 # Either export credentials, or rely on parser secrets.toml + [huggingface].username → <username>/kink-discovery
 export HF_TOKEN=hf_...
-export HF_SPACE_REPO=yourname/your-space-name   # e.g. ronheichman/kink-discovery
+export HF_SPACE_REPO=yourname/your-space-name   # e.g. Perplexed7675/kink-discovery
 python scripts/publish_hf_space.py --verify
 ```
 

api.py

@@ -44,12 +44,17 @@ def _frontend_static_cache_control(target: Path) -> str:
 
 
 def _require_frontend_build() -> None:
-    if FRONTEND_PATH.is_file():
-        return
-    raise HTTPException(
-        status_code=503,
-        detail="Frontend build missing. Run `npm ci && npm run build` before serving the app.",
-    )
+    if not FRONTEND_PATH.is_file():
+        raise HTTPException(
+            status_code=503,
+            detail="Frontend build missing. Run `npm ci && npm run build` before serving the app.",
+        )
+    assets_dir = FRONTEND_DIST_DIR / "assets"
+    if not assets_dir.is_dir() or not any(assets_dir.iterdir()):
+        raise HTTPException(
+            status_code=503,
+            detail="Frontend build incomplete (no bundled assets). Run `npm ci && npm run build` to refresh.",
+        )
 
 
 def _hf_space_published_image() -> bool:
@@ -144,6 +149,7 @@ def _get_backend() -> Backend:
         ensure_media_cache(MEDIA_ROOT)
         path = ensure_store_db(_default_store)
         _warn_or_fail_ephemeral_store(path)
+        _restore_user_snapshot_on_boot(path)
         b = Backend(path)
         # Catalog must be ready before the first recommendations request. Build it once here:
         # starting a warm thread and then blocking can double-build on slow cpu-basic Spaces.
@@ -170,12 +176,106 @@ class _BackendProxy:
 backend = _BackendProxy()
 
 
+def _restore_user_snapshot_on_boot(store_path: Path) -> None:
+    """Pull the latest user-state snapshot from the configured Hub dataset when local user tables are empty.
+
+    No-op when KINK_USER_SNAPSHOT_REPO is unset. Failures are logged and swallowed so a Hub outage
+    cannot prevent the Space from booting (catalog still serves; periodic push will retry).
+    """
+    try:
+        from backend import user_snapshot, user_snapshot_hub
+    except ImportError:
+        return
+    if not user_snapshot_hub.snapshot_enabled():
+        return
+    try:
+        if not user_snapshot.user_state_is_empty(store_path):
+            return
+        tmp = store_path.parent / ".user_state_snapshot.db"
+        if not user_snapshot_hub.pull_user_snapshot(tmp):
+            return
+        counts = user_snapshot.restore_user_state(store_path, tmp)
+        try:
+            tmp.unlink()
+        except OSError:
+            pass
+        applied = sum(counts.values())
+        print(
+            f"[kink_cli] restored {applied} user-state rows from snapshot "
+            f"({user_snapshot_hub.snapshot_repo()}/{user_snapshot_hub.snapshot_filename()})"
+        )
+    except Exception as exc:  # noqa: BLE001 — degrade gracefully on any restore failure
+        print(f"[kink_cli] user-state snapshot restore failed: {exc}")
+
+
+async def _user_snapshot_flusher(store_path: Path, interval_s: float) -> None:
+    """Periodic push: when fingerprint changes, dump user tables and upload to Hub. Tolerant of transient failures."""
+    from backend import user_snapshot, user_snapshot_hub
+
+    last_fingerprint = user_snapshot.compute_user_state_fingerprint(store_path)
+    while True:
+        try:
+            await asyncio.sleep(interval_s)
+            fp = await asyncio.to_thread(user_snapshot.compute_user_state_fingerprint, store_path)
+            if fp == last_fingerprint:
+                continue
+            tmp = store_path.parent / ".user_state_snapshot_out.db"
+            await asyncio.to_thread(user_snapshot.dump_user_state, store_path, tmp)
+            sent = await asyncio.to_thread(user_snapshot_hub.push_user_snapshot, tmp)
+            try:
+                tmp.unlink()
+            except OSError:
+                pass
+            if sent:
+                last_fingerprint = fp
+        except asyncio.CancelledError:
+            raise
+        except Exception as exc:  # noqa: BLE001 — never let the flusher die
+            print(f"[kink_cli] user-state snapshot flush failed: {exc}")
+
+
 @asynccontextmanager
 async def lifespan(_app: FastAPI):
     """Begin Hub download + DB open in a worker thread so the server binds to PORT immediately (HF Spaces timeout)."""
     loop = asyncio.get_running_loop()
     loop.run_in_executor(None, _get_backend)
-    yield
+
+    flusher_task: asyncio.Task | None = None
+    try:
+        from backend import user_snapshot_hub
+    except ImportError:
+        user_snapshot_hub = None  # type: ignore[assignment]
+    if user_snapshot_hub is not None and user_snapshot_hub.snapshot_enabled():
+        interval_s = float(os.environ.get("KINK_USER_SNAPSHOT_INTERVAL_S", "60") or "60")
+
+        async def _start_when_ready() -> None:
+            while _backend_impl is None:
+                await asyncio.sleep(1.0)
+            await _user_snapshot_flusher(_backend_impl.path, interval_s)
+
+        flusher_task = asyncio.create_task(_start_when_ready())
+
+    try:
+        yield
+    finally:
+        if flusher_task is not None:
+            flusher_task.cancel()
+            try:
+                await flusher_task
+            except (asyncio.CancelledError, Exception):  # noqa: BLE001
+                pass
+            if _backend_impl is not None:
+                try:
+                    from backend import user_snapshot, user_snapshot_hub as _hub
+                    tmp = _backend_impl.path.parent / ".user_state_snapshot_shutdown.db"
+                    user_snapshot.dump_user_state(_backend_impl.path, tmp)
+                    _hub.push_user_snapshot(tmp, commit_message="user-state snapshot (shutdown)")
+                    try:
+                        tmp.unlink()
+                    except OSError:
+                        pass
+                except Exception as exc:  # noqa: BLE001
+                    print(f"[kink_cli] final user-state snapshot push failed: {exc}")
 
 
 app = FastAPI(title="Kink Discovery API", version="0.1.0", lifespan=lifespan)

backend/user_snapshot.py

@@ -0,0 +1,182 @@
+"""Snapshot of user-state tables only — the slim, durable subset of the SQLite store.
+
+Used to keep accounts alive across HF Space restarts without paid persistent storage:
+the live container reads/writes the catalog DB at ``KINK_STORE_PATH`` (ephemeral on
+``/tmp``), and a periodic snapshotter pushes only the user-state tables to a private
+HF Hub dataset (or any pull/push pair) so a fresh container can restore them on boot.
+
+Authoritative user-table list mirrors ``scripts/dev_reset_local.py`` so a wipe and a
+snapshot/restore stay in sync. Catalog tables (``kink``, ``play_fts*``, ``fetlife*``,
+``similarityedge``, ``kinkscenarioparent``) are NOT included — they bootstrap from the
+catalog seed/Hub dataset/B2 separately.
+"""
+from __future__ import annotations
+
+import sqlite3
+from pathlib import Path
+
+USER_TABLES: tuple[str, ...] = (
+    "user",
+    "userpreference",
+    "playpreference",
+    "rolepreference",
+    "scenariopreference",
+    "promptdismissal",
+    "partnerlink",
+    "partnerlinkrequest",
+    "partnergroup",
+    "partnergroupmember",
+)
+
+
+def _table_exists(conn: sqlite3.Connection, name: str) -> bool:
+    row = conn.execute(
+        "SELECT 1 FROM sqlite_master WHERE type='table' AND name=? LIMIT 1",
+        (name,),
+    ).fetchone()
+    return row is not None
+
+
+def _present_tables(conn: sqlite3.Connection) -> list[str]:
+    return [name for name in USER_TABLES if _table_exists(conn, name)]
+
+
+def _table_create_sql(conn: sqlite3.Connection, name: str) -> str:
+    row = conn.execute(
+        "SELECT sql FROM sqlite_master WHERE type='table' AND name=? LIMIT 1",
+        (name,),
+    ).fetchone()
+    if not row or not row[0]:
+        raise RuntimeError(f"missing CREATE TABLE for {name!r} in source store")
+    return row[0]
+
+
+def dump_user_state(store_path: Path, out_path: Path) -> dict[str, int]:
+    """Write a slim SQLite at ``out_path`` containing only USER_TABLES rows from ``store_path``.
+
+    Returns a mapping of table -> row count. Does not modify ``store_path``.
+    """
+    store_path = Path(store_path)
+    out_path = Path(out_path)
+    if not store_path.is_file():
+        raise FileNotFoundError(f"store does not exist: {store_path}")
+    if out_path.exists():
+        out_path.unlink()
+    out_path.parent.mkdir(parents=True, exist_ok=True)
+
+    src = sqlite3.connect(f"file:{store_path}?mode=ro", uri=True)
+    try:
+        present = _present_tables(src)
+        creates = {name: _table_create_sql(src, name) for name in present}
+
+        dst = sqlite3.connect(out_path)
+        try:
+            counts: dict[str, int] = {}
+            with dst:
+                dst.execute("PRAGMA journal_mode=OFF")
+                dst.execute("PRAGMA synchronous=OFF")
+                for name in present:
+                    dst.execute(creates[name])
+                for name in present:
+                    rows = list(src.execute(f'SELECT * FROM "{name}"'))
+                    if not rows:
+                        counts[name] = 0
+                        continue
+                    placeholders = ",".join(["?"] * len(rows[0]))
+                    dst.executemany(
+                        f'INSERT INTO "{name}" VALUES ({placeholders})',
+                        rows,
+                    )
+                    counts[name] = len(rows)
+            return counts
+        finally:
+            dst.close()
+    finally:
+        src.close()
+
+
+def restore_user_state(store_path: Path, in_path: Path) -> dict[str, int]:
+    """Upsert all USER_TABLES rows from ``in_path`` into ``store_path``.
+
+    Existing rows with conflicting primary keys are replaced (the snapshot wins).
+    Catalog tables in ``store_path`` are untouched. Returns table -> rows-applied.
+    """
+    store_path = Path(store_path)
+    in_path = Path(in_path)
+    if not store_path.is_file():
+        raise FileNotFoundError(f"store does not exist: {store_path}")
+    if not in_path.is_file():
+        raise FileNotFoundError(f"snapshot does not exist: {in_path}")
+
+    counts: dict[str, int] = {}
+    dst = sqlite3.connect(store_path)
+    try:
+        dst.execute("PRAGMA foreign_keys=OFF")
+        dst.execute(f"ATTACH DATABASE '{in_path.as_posix()}' AS snap")
+        try:
+            snap_tables = {
+                row[0]
+                for row in dst.execute("SELECT name FROM snap.sqlite_master WHERE type='table'")
+            }
+            with dst:
+                for name in USER_TABLES:
+                    if name not in snap_tables:
+                        continue
+                    if not _table_exists(dst, name):
+                        continue
+                    cur = dst.execute(
+                        f'INSERT OR REPLACE INTO main."{name}" SELECT * FROM snap."{name}"'
+                    )
+                    counts[name] = cur.rowcount or 0
+        finally:
+            dst.execute("DETACH DATABASE snap")
+            dst.execute("PRAGMA foreign_keys=ON")
+    finally:
+        dst.close()
+    return counts
+
+
+def compute_user_state_fingerprint(store_path: Path) -> str:
+    """Cheap fingerprint that changes whenever user-state rows change.
+
+    Combines per-table row count with max(updated_at) when the column exists. A bare
+    count would miss updates to existing rows; reading every column would be wasteful.
+    """
+    store_path = Path(store_path)
+    if not store_path.is_file():
+        return "missing"
+    conn = sqlite3.connect(f"file:{store_path}?mode=ro", uri=True)
+    try:
+        parts: list[str] = []
+        for name in USER_TABLES:
+            if not _table_exists(conn, name):
+                parts.append(f"{name}:-")
+                continue
+            count = conn.execute(f'SELECT COUNT(*) FROM "{name}"').fetchone()[0]
+            cols = {row[1] for row in conn.execute(f'PRAGMA table_info("{name}")')}
+            ts = ""
+            if "updated_at" in cols:
+                ts_row = conn.execute(f'SELECT MAX(updated_at) FROM "{name}"').fetchone()
+                ts = "" if ts_row is None or ts_row[0] is None else str(ts_row[0])
+            parts.append(f"{name}:{count}:{ts}")
+        return "|".join(parts)
+    finally:
+        conn.close()
+
+
+def user_state_is_empty(store_path: Path) -> bool:
+    """True when no rows exist in any USER_TABLES — used to gate boot-time pull."""
+    store_path = Path(store_path)
+    if not store_path.is_file():
+        return True
+    conn = sqlite3.connect(f"file:{store_path}?mode=ro", uri=True)
+    try:
+        for name in USER_TABLES:
+            if not _table_exists(conn, name):
+                continue
+            count = conn.execute(f'SELECT COUNT(*) FROM "{name}"').fetchone()[0]
+            if count > 0:
+                return False
+        return True
+    finally:
+        conn.close()

backend/user_snapshot_hub.py

@@ -0,0 +1,91 @@
+"""Hugging Face Hub dataset I/O for the user-state snapshot.
+
+Auth + repo come from environment so the snapshotter is a no-op when not configured:
+  KINK_USER_SNAPSHOT_REPO     ``owner/dataset`` of a private Hub dataset (required to enable)
+  KINK_USER_SNAPSHOT_FILENAME default ``user_state.db``
+  HF_TOKEN                    write token; reuses the same secret as the catalog/Space deploy
+"""
+from __future__ import annotations
+
+import logging
+import os
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_SNAPSHOT_FILENAME = "user_state.db"
+
+
+def snapshot_repo() -> str:
+    return (os.environ.get("KINK_USER_SNAPSHOT_REPO") or "").strip()
+
+
+def snapshot_filename() -> str:
+    return (os.environ.get("KINK_USER_SNAPSHOT_FILENAME") or DEFAULT_SNAPSHOT_FILENAME).strip() or DEFAULT_SNAPSHOT_FILENAME
+
+
+def snapshot_enabled() -> bool:
+    return bool(snapshot_repo())
+
+
+def _hf_token() -> str | None:
+    return (os.environ.get("HF_TOKEN") or os.environ.get("HUGGING_FACE_HUB_TOKEN") or "").strip() or None
+
+
+def pull_user_snapshot(target_path: Path) -> bool:
+    """Download the latest snapshot from the configured Hub dataset to ``target_path``.
+
+    Returns True on success, False when snapshot is disabled or the file is not yet present
+    on the Hub. All other Hub errors propagate.
+    """
+    if not snapshot_enabled():
+        return False
+    target_path = Path(target_path)
+    target_path.parent.mkdir(parents=True, exist_ok=True)
+    try:
+        from huggingface_hub import hf_hub_download
+        from huggingface_hub.errors import EntryNotFoundError, RepositoryNotFoundError
+    except ImportError:
+        logger.warning("huggingface_hub not installed; skipping snapshot pull")
+        return False
+    try:
+        downloaded = hf_hub_download(
+            repo_id=snapshot_repo(),
+            repo_type="dataset",
+            filename=snapshot_filename(),
+            token=_hf_token(),
+        )
+    except (EntryNotFoundError, RepositoryNotFoundError):
+        logger.info("snapshot %s/%s not present on Hub yet (cold start)", snapshot_repo(), snapshot_filename())
+        return False
+    Path(downloaded).replace(target_path)
+    return True
+
+
+def push_user_snapshot(source_path: Path, *, commit_message: str | None = None) -> bool:
+    """Upload ``source_path`` as the latest snapshot. Returns True when sent."""
+    if not snapshot_enabled():
+        return False
+    source_path = Path(source_path)
+    if not source_path.is_file():
+        logger.warning("snapshot source %s missing; skipping push", source_path)
+        return False
+    try:
+        from huggingface_hub import HfApi
+    except ImportError:
+        logger.warning("huggingface_hub not installed; skipping snapshot push")
+        return False
+    token = _hf_token()
+    if not token:
+        logger.warning("HF_TOKEN missing; cannot push snapshot")
+        return False
+    api = HfApi(token=token)
+    api.create_repo(repo_id=snapshot_repo(), repo_type="dataset", private=True, exist_ok=True)
+    api.upload_file(
+        path_or_fileobj=str(source_path),
+        path_in_repo=snapshot_filename(),
+        repo_id=snapshot_repo(),
+        repo_type="dataset",
+        commit_message=commit_message or "user-state snapshot",
+    )
+    return True

deploy/hf/README.md

@@ -10,6 +10,21 @@
 
 SQLite stores users in the **same file** as the catalog. If that file is on **persistent storage**, new users and plays are written into that file and remain after image updates or container restarts. If the DB only existed on ephemeral disk, it would reset when the Space restarts.
 
+### Free alternative: snapshot user-state to a private Hub dataset
+
+If you do not want to pay for HF Persistent Storage, set these Space variables instead:
+
+- `KINK_USER_SNAPSHOT_REPO=<owner>/<dataset>` — a private dataset repo for the snapshot.
+- `HF_TOKEN=<write-token>` — same secret used by the catalog/Space deploy.
+- Optional: `KINK_USER_SNAPSHOT_FILENAME` (default `user_state.db`), `KINK_USER_SNAPSHOT_INTERVAL_S` (default 60).
+
+Behaviour:
+
+- On cold boot, after the catalog opens, `_restore_user_snapshot_on_boot` pulls the latest snapshot from the dataset and upserts it into the live SQLite — but only when the local user tables are empty. Failures are logged and ignored so a Hub outage cannot block boot.
+- A background task in `lifespan` recomputes the user-state fingerprint every `KINK_USER_SNAPSHOT_INTERVAL_S` seconds; when it changes, it dumps `USER_TABLES` to a slim SQLite and uploads via `huggingface_hub.upload_file`. A final push runs on lifespan shutdown.
+- Tables shipped: `user`, `userpreference`, `playpreference`, `rolepreference`, `scenariopreference`, `promptdismissal`, `partnerlink`, `partnerlinkrequest`, `partnergroup`, `partnergroupmember`. Catalog tables (`kink`, `play_fts*`, `similarityedge`, `fetlife*`, `kinkscenarioparent`) stay on the ephemeral image.
+- Trade-off: up to ~`interval` seconds of writes can be lost on a hard crash. Multi-replica Spaces would race on push — keep cpu-basic (single replica) or add an external mutex before scaling.
+
 ## First boot (empty volume)
 
 Pick **one** way to supply the full `store_slim.db` (multi‑GB):

frontend/app.js

@@ -20,6 +20,7 @@ import {
   useLoginMutation,
   useCreateMutation,
   useSavePlayMutation,
+  useDeletePlayMutation,
   useSaveRoleMutation,
   usePrefMutation,
   useScenarioPreferenceMutation,
@@ -298,6 +299,11 @@ function AppInner() {
     onSaveStart: () => setPendingPlaySaveCount((count) => count + 1),
     onSaveSettled: () => setPendingPlaySaveCount((count) => Math.max(0, count - 1)),
   });
+  const deletePlayMutation = useDeletePlayMutation({ auth, setStatus });
+  const handleDeletePlay = useCallback((kinkId) => {
+    if (!kinkId) return;
+    deletePlayMutation.mutate(kinkId);
+  }, [deletePlayMutation]);
   const saveRoleMutation = useSaveRoleMutation({ auth, setStatus });
   const prefMutation = usePrefMutation({ auth, setStatus });
   const scenarioPreferenceMutation = useScenarioPreferenceMutation({ auth, activeGroupId, setStatus });
@@ -595,6 +601,7 @@ function AppInner() {
               onDirectionColumnChange=${handleDirectionColumnChange}
               onNavigate=${handleNavigate}
               onOpenScenarios=${handleOpenScenarios}
+              onDeletePlay=${handleDeletePlay}
               focusKinkId=${playsFocusKinkId}
               onFocusKinkConsumed=${() => setPlaysFocusKinkId("")}
             />
@@ -608,6 +615,8 @@ function AppInner() {
               user=${user}
               currentPlays=${currentPlays}
               onRate=${handleRate}
+              onDirectionToggle=${handleDirectionToggle}
+              onDeletePlay=${handleDeletePlay}
               onNavigate=${handleNavigate}
               onOpenScenarios=${handleOpenScenarios}
               setStatus=${setStatus}
@@ -652,6 +661,37 @@ function AppInner() {
   `;
 }
 
+function NewProfileCredentials({ createResult }) {
+  const [revealed, setRevealed] = useState(false);
+  const token = createResult.private_token || "";
+  const masked = `••••••••${token.slice(-4)}`;
+  return html`
+    <div className="creds">
+      <div><strong>Profile ID</strong></div>
+      <code data-testid="onboarding-created-user-id">${createResult.id}</code>
+      <div style=${{ marginTop: 8 }}><strong>Private pass</strong></div>
+      <div className="onboarding-token-row" style=${{ display: "flex", gap: 8, flexWrap: "wrap", alignItems: "center" }}>
+        ${revealed
+          ? html`<code data-testid="onboarding-created-private-token">${token}</code>`
+          : html`<code data-testid="onboarding-created-private-token-mask">${masked}</code>`}
+        <button
+          type="button"
+          className="ghost sm"
+          data-testid="onboarding-reveal-token"
+          onClick=${() => setRevealed((v) => !v)}
+        >${revealed ? "Hide" : "Reveal"}</button>
+        <button
+          type="button"
+          className="ghost sm"
+          data-testid="onboarding-copy-token"
+          onClick=${() => { try { navigator.clipboard?.writeText(token); } catch {} }}
+        >Copy</button>
+      </div>
+      <div className="tiny muted">Save the private pass somewhere safe. You will need it to reopen this profile.</div>
+    </div>
+  `;
+}
+
 function Onboarding({
   step,
   setStep,
@@ -675,12 +715,7 @@ function Onboarding({
         <h1>Set up your profile</h1>
         <p className="sub">Keep these credentials. You need them to reopen the profile later.</p>
         <div className="card stack">
-          <div className="creds">
-            <div><strong>Profile ID</strong></div>
-            <code data-testid="onboarding-created-user-id">${createResult.id}</code>
-            <div style=${{ marginTop: 8 }}><strong>Private pass</strong></div>
-            <code data-testid="onboarding-created-private-token">${createResult.private_token}</code>
-          </div>
+          <${NewProfileCredentials} createResult=${createResult} />
 
           ${pendingPartnerId ? html`<div className="tiny">Invite saved for <code>${pendingPartnerId}</code>. The connection request will go out after this setup.</div>` : null}
 

frontend/discover-state.js

@@ -5,6 +5,7 @@ export function visibleDiscoveryItems(rawItems, currentPlays) {
   for (const row of rawItems || []) {
     const id = row?.kink?.id;
     if (id == null || id === "") continue;
+    if (row.kink?.is_scenario) continue;
     const sid = String(id);
     if (played[sid] || seen.has(sid)) continue;
     seen.add(sid);

frontend/discover-state.test.mjs

@@ -27,6 +27,15 @@ test("visibleDiscoveryItems drops already-rated raw recommendation rows", () =>
   assert.deepEqual(visibleDiscoveryItems(rawItems, currentPlays).map((row) => row.kink.id), ["b"]);
 });
 
+test("visibleDiscoveryItems drops scenario kinks even when not yet rated", () => {
+  const rawItems = [
+    { kink: { id: "a", name: "regular" } },
+    { kink: { id: "b", name: "scenario", is_scenario: true } },
+    { kink: { id: "c", name: "another" } },
+  ];
+  assert.deepEqual(visibleDiscoveryItems(rawItems, {}).map((row) => row.kink.id), ["a", "c"]);
+});
+
 test("visibleDiscoveryItems skips malformed rows, blank ids, and duplicate ids", () => {
   const rawItems = [
     null,

frontend/dist/assets/index-HvMqkWIl.css

@@ -0,0 +1 @@
+:root{--bg: #f5efe7;--bg-2: #efe5d7;--surface: rgba(255, 251, 246, .92);--surface-strong: #fffaf3;--ink: #1d1815;--muted: #6d6157;--line: #dbcdbd;--accent: #b33636;--accent-2: #264653;--accent-soft: #f0ddd0;--ok: #236b45;--radius: 18px;--radius-sm: 12px;--radius-pill: 999px;--tab-height: 56px}*{box-sizing:border-box}body{margin:0;color:var(--ink);font-family:IBM Plex Sans,Inter,system-ui,sans-serif;background:radial-gradient(circle at top left,rgba(179,54,54,.14),transparent 24%),radial-gradient(circle at bottom right,rgba(38,70,83,.12),transparent 22%),linear-gradient(180deg,var(--bg-2),var(--bg));min-height:100vh;padding-bottom:calc(var(--tab-height) + 12px)}button,input,textarea{font:inherit}button{border:0;border-radius:var(--radius-pill);background:var(--accent);color:#fff;padding:10px 16px;cursor:pointer;transition:transform .12s ease,opacity .12s ease;font-size:.88rem}button:hover{transform:translateY(-1px)}button:active{transform:scale(.97)}button.secondary{background:var(--accent-2)}button.ghost{background:transparent;color:var(--ink);border:1px solid var(--line)}button.sm{padding:6px 12px;font-size:.82rem}input,textarea{width:100%;border:1px solid var(--line);border-radius:14px;padding:12px 14px;background:var(--surface-strong);color:var(--ink)}.page{max-width:680px;margin:0 auto;padding:16px}.app-global-bar{display:flex;justify-content:flex-end;align-items:center;margin:0 0 10px;min-height:36px}.app-graph-debug-toggle--on{border-color:var(--accent-2);background:#2646531a;color:var(--accent-2)}.tab-bar{position:fixed;bottom:0;left:0;right:0;display:flex;justify-content:center;gap:0;height:var(--tab-height);background:var(--surface-strong);border-top:1px solid var(--line);z-index:90}.tab-btn{flex:1;max-width:180px;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:2px;background:transparent;color:var(--muted);border:none;border-radius:0;padding:4px 0;font-size:.72rem;font-weight:600;letter-spacing:.02em;transition:color .1s ease}.tab-btn:hover{transform:none}.tab-btn.active{color:var(--accent)}.tab-icon{font-size:1.3rem;line-height:1}.tab-badge{display:inline-flex;align-items:center;justify-content:center;min-width:18px;height:18px;border-radius:var(--radius-pill);background:var(--accent);color:#fff;font-size:.66rem;font-weight:700;padding:0 5px;position:absolute;top:4px;right:calc(50% - 20px)}.top-bar{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:16px}.top-bar-title{font-size:1.4rem;font-weight:800;letter-spacing:-.03em;line-height:1}.top-bar-right{display:flex;align-items:center;gap:8px;font-size:.82rem;color:var(--muted)}.top-bar-right strong{color:var(--ink)}.card{background:var(--surface);border:1px solid var(--line);border-radius:var(--radius);padding:20px;box-shadow:0 8px 24px #0000000a}.card-lg{padding:28px 24px;text-align:center}.card-title{margin:0 0 8px;font-size:1.8rem;font-weight:800;letter-spacing:-.03em;line-height:1.1}.card-definition{color:var(--muted);font-size:1rem;line-height:1.5;max-width:480px;margin:0 auto 16px}.kink-pill,.card-cluster{display:inline-block;padding:5px 11px;border-radius:var(--radius-pill);background:#26465314;color:var(--accent-2);font-size:.7rem;font-weight:700;letter-spacing:.06em;text-transform:uppercase;margin-bottom:12px}.card-image-area{width:100%;aspect-ratio:16 / 9;border-radius:var(--radius-sm);background:linear-gradient(135deg,#c9b8a7,#a89584);overflow:hidden;margin-bottom:16px;position:relative;cursor:pointer}.card-image-area img{width:100%;height:100%;object-fit:cover;filter:blur(20px);transition:filter .3s ease}.card-image-area.revealed img{filter:none}.card-counter{font-size:.84rem;color:var(--muted);font-weight:600}.card-image-area--preview{cursor:pointer}.card-image-area--preview .card-image-blur{width:100%;height:100%;object-fit:cover;filter:blur(20px);transform:scale(1.04);display:block}.card-image-cta{position:absolute;top:0;right:0;bottom:0;left:0;display:flex;align-items:center;justify-content:center;color:#fff;font-size:.95rem;font-weight:700;text-shadow:0 1px 8px rgba(0,0,0,.75);pointer-events:none}.card-image-scroll{max-height:340px;overflow-y:auto;overflow-x:hidden;scroll-snap-type:y mandatory;border-radius:var(--radius-sm);margin-bottom:16px;border:1px solid var(--line);-webkit-overflow-scrolling:touch;overscroll-behavior:contain;scrollbar-width:thin}.card-image-slide{min-height:220px;scroll-snap-align:start;scroll-snap-stop:always}.card-image-slide img{width:100%;height:100%;min-height:220px;object-fit:cover;display:block}.discover-card-wrap{margin:0 auto 10px;max-width:420px;border-radius:22px;box-shadow:0 12px 40px #0000001f}.discover-photo-hint{text-align:center;line-height:1.45;max-width:420px;margin:0 auto 8px;padding:0 8px}.discover-photo-hint strong{color:var(--ink);font-weight:800}.discover-reason-row{max-width:420px;margin:0 auto 8px;padding:0 8px}.discover-reason-pill{display:inline-flex;align-items:center;padding:6px 12px;border-radius:var(--radius-pill);background:#1d18150f;color:var(--ink);font-size:.78rem;font-weight:600;line-height:1.3}.discover-reason-pill--partner_influenced{background:#b336361f;color:var(--accent)}.discover-reason-pill--starter{background:#2646531a;color:var(--accent-2)}.discover-group-row{max-width:420px;margin:0 auto 14px;padding:0 4px}.discover-group-label{font-size:.72rem;font-weight:700;text-transform:uppercase;letter-spacing:.06em;color:var(--muted);margin-bottom:8px}.partner-group-picker{margin-bottom:8px}.discover-photo-toggle{display:flex;align-items:center;gap:10px;margin:0 auto 12px;max-width:420px;font-size:.86rem;color:var(--muted);cursor:pointer;-webkit-user-select:none;user-select:none}.discover-photo-toggle input{width:1.05rem;height:1.05rem;accent-color:var(--accent, #c62828)}.discover-directions{max-width:420px;margin:4px auto 6px;padding:0 10px}.discover-dir-label{font-size:.72rem;font-weight:700;text-transform:uppercase;letter-spacing:.07em;color:var(--muted);margin-bottom:8px}.discover-direction-sheet{max-width:420px;margin:0 auto 14px;padding:14px;border:1px solid var(--line);border-radius:var(--radius);background:#ffffffe0;display:grid;gap:10px}.discover-direction-actions{display:flex;gap:8px;flex-wrap:wrap}.discover-scenario-hint{display:flex;align-items:center;justify-content:space-between;gap:12px;margin-bottom:12px}.discover-scenario-hint strong{display:block;margin-bottom:2px}.tinder-card{background:var(--surface-strong);border:1px solid var(--line);border-radius:22px;overflow:hidden;text-align:left}.tinder-card__media{position:relative;background:linear-gradient(145deg,#3d3430,#1a1513)}.tinder-card__media-inner{position:relative;height:min(58vh,520px);height:min(58dvh,520px);min-height:280px;overflow:hidden}.tinder-card__carousel{position:relative;width:100%;height:100%}.tinder-card__slide--solo{height:100%}.tinder-card__slide--solo img{width:100%;height:100%;min-height:min(58vh,520px);min-height:min(58dvh,520px);object-fit:cover;display:block}.tinder-edge{position:absolute;top:0;bottom:calc(104px + env(safe-area-inset-bottom,0px));width:30%;max-width:150px;z-index:4;cursor:pointer;background:transparent;border:none;padding:0;-webkit-tap-highlight-color:transparent}.tinder-edge--left{left:0;background:linear-gradient(90deg,rgba(0,0,0,.14),transparent)}.tinder-edge--right{right:0;background:linear-gradient(270deg,rgba(0,0,0,.14),transparent)}.tinder-edge:active{opacity:.85}.tinder-dots{position:absolute;bottom:14px;left:50%;transform:translate(-50%);display:flex;gap:7px;z-index:5;pointer-events:none}.tinder-dots span{width:7px;height:7px;border-radius:50%;background:#ffffff61;transition:transform .12s ease,background .12s ease}.tinder-dots span.on{background:#fff;transform:scale(1.12)}.tinder-card__media-scroll{height:100%;overflow-y:auto;overflow-x:hidden;scroll-snap-type:y mandatory;-webkit-overflow-scrolling:touch;overscroll-behavior:contain;scrollbar-width:thin}.tinder-card__slide{min-height:100%;scroll-snap-align:start;scroll-snap-stop:always;box-sizing:border-box}.tinder-card__slide img{width:100%;height:100%;min-height:min(58vh,520px);object-fit:cover;display:block}.tinder-card__img-blur{filter:blur(22px);transform:scale(1.06)}.tinder-card__media--placeholder{display:flex;align-items:center;justify-content:center;aspect-ratio:3 / 4;max-height:58vh;min-height:280px}.tinder-card__placeholder-letters{font-size:3.5rem;font-weight:800;color:#ffffff38;letter-spacing:-.06em}.tinder-card__photo-badge{position:absolute;top:12px;right:12px;left:auto;bottom:auto;transform:none;z-index:4;padding:5px 12px;border-radius:var(--radius-pill);background:#00000080;color:#fff;font-size:.74rem;font-weight:700;letter-spacing:.04em;pointer-events:none}.tinder-card__gradient{position:absolute;top:0;right:0;bottom:0;left:0;background:linear-gradient(180deg,transparent 38%,rgba(0,0,0,.55) 100%);pointer-events:none;z-index:2}.tinder-card__reveal-row{position:absolute;left:0;right:0;bottom:0;height:calc(104px + env(safe-area-inset-bottom,0px));display:flex;align-items:center;justify-content:center;z-index:6;pointer-events:none;box-sizing:border-box;padding-bottom:env(safe-area-inset-bottom,0px)}.tinder-card__reveal{position:relative;flex:0 0 auto;width:max-content;max-width:min(280px,calc(100% - 32px));margin:0;padding:11px 20px;border-radius:var(--radius-pill);border:1px solid rgba(255,255,255,.5);background:#00000080;color:#fff;font-size:.84rem;font-weight:700;cursor:pointer;box-shadow:0 6px 24px #00000059;touch-action:manipulation;-webkit-user-select:none;user-select:none;pointer-events:auto;outline:none}@media (hover: hover) and (pointer: fine){.tinder-card__reveal:hover{background:#0000009e}}.tinder-card__reveal:focus-visible{box-shadow:0 6px 24px #00000059,0 0 0 2px #ffffff73}.tinder-card__body{padding:16px 18px 20px}button.tinder-card__body.tinder-card__body--tappable{display:block;width:100%;border:none;margin:0;padding:16px 18px 20px;font:inherit;color:inherit;text-align:left;background:var(--surface-strong);-moz-appearance:none;appearance:none;-webkit-appearance:none;border-radius:0;box-sizing:border-box}.tinder-card__body--tappable{cursor:pointer;border-radius:0 0 18px 18px;transition:background .14s ease;touch-action:manipulation;-webkit-tap-highlight-color:transparent}.tinder-card__body--tappable:focus-visible{outline:none;box-shadow:inset 0 0 0 2px #6450c859}.tinder-card__body--tappable:active{background:#0000000b}.tinder-card__body--expanded{max-height:min(52vh,420px);overflow-y:auto;overscroll-behavior:contain;-webkit-overflow-scrolling:touch}.tinder-card__body .kink-pill{margin-bottom:8px}.tinder-card__body .card-title{font-size:1.55rem;text-align:left;margin-bottom:6px}.tinder-card__body:not(.tinder-card__body--expanded) .card-definition{text-align:left;font-size:.92rem;line-height:1.45;display:block;overflow:visible;margin-bottom:0;color:var(--ink)}.tinder-card__body--expanded .card-definition--discover-full{text-align:left;font-size:.92rem;line-height:1.5;display:block;margin-bottom:0;overflow:visible;color:var(--ink)}.tinder-card__notes{margin-top:10px;font-size:.84rem;line-height:1.45;white-space:pre-wrap;word-break:break-word;color:#5c5c5c}.tinder-card__info-cue{margin-top:10px;font-size:.72rem;font-weight:600;letter-spacing:.02em;color:#888;text-align:center}.tinder-card .safety-badge{margin-top:8px}.action-bar{display:flex;flex-wrap:wrap;justify-content:center;gap:10px;padding:16px 8px;max-width:520px;margin:0 auto}.action-btn{display:flex;flex-direction:column;align-items:center;gap:4px;padding:12px 20px;border-radius:16px;border:1px solid var(--line);background:#fff;color:var(--ink);font-size:.76rem;font-weight:600;min-width:64px;transition:transform .1s ease,background .1s ease,border-color .1s ease}.action-btn:hover{transform:translateY(-2px)}.action-btn:active{transform:scale(.94)}.action-btn .action-icon{font-size:1.4rem;line-height:1}.action-btn.love{border-color:#e57373;background:#fff5f5}.action-btn.like{border-color:#81c784;background:#f5fff5}.action-btn.maybe{border-color:#b39ddb;background:#f3e5f5}.action-btn.skip{border-color:var(--line)}.action-btn.nogo{border-color:#bbb;background:#fafafa}.chip-flow{display:flex;flex-wrap:wrap;gap:6px;align-items:flex-start}.chip-flow--with-dnd{flex-direction:column;align-items:stretch}.plays-board-card--inline{width:100%}.play-chip{display:inline-flex;align-items:center;gap:6px;padding:6px 10px;border:1px solid var(--line);border-radius:var(--radius-sm);background:#ffffffd1;font-size:.88rem;font-weight:600;cursor:pointer;transition:border-color .1s ease,box-shadow .1s ease;max-width:100%}.chip-top-row{display:inline-flex;align-items:center;gap:6px;min-width:0;flex:1}.chip-near-title{flex-shrink:0;opacity:.55;font-size:.85em;font-weight:600;cursor:help}.play-chip:hover{border-color:var(--accent)}.play-chip .chip-emoji{flex-shrink:0}.play-chip .chip-name{overflow:hidden;text-overflow:ellipsis;white-space:nowrap;min-width:0}.play-chip.expanded{width:100%;max-width:100%;min-width:0;box-sizing:border-box;flex-direction:column;align-items:stretch;gap:10px;padding:12px;background:#fff;border-color:var(--accent);box-shadow:0 4px 16px #0000000f}.play-chip.expanded .chip-top-row{align-items:flex-start}.play-chip.expanded .chip-name{display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:3;overflow:hidden;text-overflow:ellipsis;white-space:normal;word-break:break-word}.plays-inspector{scroll-margin-top:12px}.plays-inspector--tentative{border:1px dashed var(--accent, #888);background:#ffffff05}.plays-inspector-head-actions{display:flex;gap:8px;flex-wrap:wrap;align-items:center}.tentative-badge{display:inline-block;margin-top:4px;padding:2px 8px;font-size:.72rem;border-radius:999px;border:1px dashed var(--accent, #888);color:var(--muted)}.play-chip--expandable{cursor:pointer}.play-chip--expanded{background:#ffffff0a}.play-chip-inspector{width:100%;margin-top:8px}.play-chip-inspector--floating{margin-top:12px}.plays-inspector-head{display:flex;align-items:flex-start;justify-content:space-between;gap:12px}.plays-inspector-copy{min-width:0}.plays-inspector-label{text-transform:uppercase;letter-spacing:.05em;font-weight:700;color:var(--muted)}.plays-inspector-title-row{display:flex;align-items:flex-start;gap:8px;min-width:0}.plays-inspector-title{margin:0;font-size:1.2rem;line-height:1.2;overflow-wrap:anywhere;word-break:break-word}.plays-inspector-emoji{flex-shrink:0;font-size:1.2rem;line-height:1}.plays-inspector-definition{margin:0}.plays-inspector-actions,.plays-inspector-actions-row,.plays-inspector-section{display:grid;gap:10px}.inline-detail{display:grid;gap:10px;min-width:0;max-width:100%}.inline-detail .detail-def{font-size:.9rem;line-height:1.45;color:var(--muted);font-weight:400;overflow-wrap:anywhere;word-break:break-word}.scenario-panel{display:grid;gap:8px;padding:10px;border:1px solid var(--line);border-radius:var(--radius-sm);background:#00000005}.scenario-panel-head{display:flex;align-items:flex-start;justify-content:space-between;gap:10px}.scenario-panel-mother{display:grid;gap:2px;min-width:0}.scenario-panel-mother-label{text-transform:uppercase;letter-spacing:.05em;font-weight:700;color:var(--muted)}.scenario-panel-mother-name{font-size:.95rem;font-weight:700;line-height:1.35;overflow-wrap:anywhere;word-break:break-word}.scenario-panel-hint{margin:0 0 4px;line-height:1.4}.scenario-list{display:grid;gap:8px}.scenario-list--page{gap:10px}.scenario-row{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:8px;min-width:0}.scenario-row-text{display:grid;gap:2px;min-width:0}.scenario-name{font-size:.84rem;font-weight:650;line-height:1.4;overflow-wrap:anywhere;word-break:break-word;white-space:normal}.scenario-match-chip .chip-name{white-space:normal;overflow-wrap:anywhere}.scenario-row--page{padding:12px;border:1px solid var(--line);border-radius:var(--radius-sm);background:#ffffffd1}.scenario-row--highlight{border-color:var(--accent);box-shadow:0 0 0 2px #b336361f}.scenario-row-actions{display:flex;align-items:center;justify-content:flex-end}.scenarios-parent-head,.scenarios-detail-head{display:flex;align-items:flex-start;justify-content:space-between;gap:12px;flex-wrap:wrap}.scenarios-parent-search{max-width:240px}.scenarios-parent-list{display:grid;gap:8px}.scenarios-parent-item{width:100%;display:grid;gap:3px;justify-items:start;text-align:left;border-radius:var(--radius-sm);border:1px solid var(--line);background:#ffffffd1;color:var(--ink);padding:12px 14px}.scenarios-parent-item.active{border-color:var(--accent);background:#fff}.scenarios-parent-name{font-weight:700;overflow-wrap:anywhere;word-break:break-word}.scenarios-parent-meta{font-size:.78rem;color:var(--muted)}.scenarios-detail-label{text-transform:uppercase;letter-spacing:.05em;font-weight:700;color:var(--muted)}.scenarios-detail-title{margin:4px 0;line-height:1.15}@media (max-width: 560px){.discover-scenario-hint{align-items:stretch;flex-direction:column}.scenario-row{grid-template-columns:1fr}.scenario-row-actions{justify-content:flex-start}}.dir-pills{display:flex;gap:6px;flex-wrap:wrap}.dir-pill{display:inline-flex;align-items:center;gap:5px;padding:5px 10px;border:1px solid var(--line);border-radius:var(--radius-pill);background:#fff;color:var(--ink);font-size:.8rem;font-weight:500;line-height:1.2;touch-action:manipulation;-webkit-tap-highlight-color:transparent}.dir-pill.active{background:var(--accent-2);color:#fff;border-color:transparent}.dir-pill:disabled{opacity:.55;cursor:not-allowed}.discover-dir-strip{margin:.65rem 0 .35rem;padding:0 2px}.discover-dir-strip__label{margin-bottom:6px;text-align:center;line-height:1.35}.discover-dir-strip__pills{justify-content:center}.reaction-bar{display:flex;gap:6px;flex-wrap:wrap}.react-btn{display:inline-flex;align-items:center;justify-content:center;padding:5px 8px;border-radius:var(--radius-pill);border:1px solid var(--line);background:#fff;font-size:.9rem;min-width:32px;min-height:32px;transition:transform 80ms ease,background 80ms ease}.react-btn:active{transform:scale(.92)}.react-btn.active{background:var(--accent-soft);border-color:transparent}.section-header{display:flex;align-items:center;justify-content:space-between;gap:8px;margin-bottom:8px}.section-title{margin:0;font-size:.88rem;font-weight:700;text-transform:uppercase;letter-spacing:.06em;color:var(--muted)}.section-count{font-size:.76rem;color:var(--muted);font-weight:600}.plays-direction-board{margin-bottom:20px}.plays-board-hint{margin:0 0 12px;line-height:1.45}.plays-board-columns{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:10px;align-items:stretch}.plays-board-columns>.plays-board-column{min-width:0}@media (max-width: 780px){.plays-board-columns{grid-template-columns:1fr}.plays-board-card{flex-wrap:wrap;align-items:flex-start}.plays-board-card .plays-dnd-handle{margin-top:4px}.plays-board-card-body{flex:1 1 calc(100% - 48px);min-width:0}.plays-touch-moves{display:flex;order:3}}.plays-board-column{display:flex;flex-direction:column;min-height:140px;border:2px dashed var(--line);border-radius:var(--radius);background:#ffffff8c;padding:8px;transition:border-color .12s ease,background .12s ease,box-shadow .12s ease}.plays-board-column--over{border-color:var(--accent);background:#ffecec73;box-shadow:0 0 0 1px #c6282826}.plays-board-column-head{display:flex;align-items:center;gap:6px;margin-bottom:8px;font-size:.78rem;font-weight:700;text-transform:uppercase;letter-spacing:.05em;color:var(--muted)}.plays-board-column-icon{font-size:1rem}.plays-board-column-title{overflow-wrap:anywhere}.plays-board-column-body{flex:1;min-width:0;display:flex;flex-direction:column;gap:8px}.plays-board-empty{flex:1;display:flex;align-items:center;justify-content:center;padding:16px 8px;text-align:center;color:var(--muted);opacity:.9}.plays-board-card{display:flex;gap:6px;align-items:flex-start;min-width:0;max-width:100%;width:100%;box-sizing:border-box}.plays-dnd-handle{flex-shrink:0;cursor:grab;-webkit-user-select:none;user-select:none;padding:4px 6px;margin-top:2px;border-radius:6px;color:var(--muted);font-size:1rem;line-height:1;touch-action:none}.plays-dnd-handle:hover{background:#0000000a;color:var(--ink)}.plays-dnd-handle:active{cursor:grabbing}.plays-touch-moves{display:none;flex:1 1 100%;flex-wrap:wrap;gap:6px;align-items:stretch;margin-top:2px}.plays-touch-move-btn{flex:1 1 auto;min-width:0;display:inline-flex;align-items:center;justify-content:center;gap:4px;padding:8px 6px;border:1px solid var(--line);border-radius:var(--radius-sm);background:#ffffffeb;font-size:.72rem;font-weight:600;line-height:1.15;text-align:center;color:var(--ink);cursor:pointer;touch-action:manipulation;-webkit-tap-highlight-color:transparent}.plays-touch-move-btn:active{background:#c6282814}.plays-touch-move-icon{font-size:.95rem;line-height:1}.plays-board-card-body{flex:1;min-width:0;overflow-x:hidden}.plays-board-card-body .play-chip,.plays-board-card-body .inline-detail .reaction-bar,.plays-board-card-body .inline-detail .dir-pills,.plays-board-card-body .inline-detail .chips{max-width:100%}.inline-detail .chips .chip{max-width:100%;min-width:0;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;text-overflow:ellipsis;line-height:1.35;text-align:left;white-space:normal;word-break:break-word}.plays-board-card-body .inline-detail button.ghost.sm{max-width:100%;justify-self:start}.plays-board-card-body .play-assets,.plays-board-card-body .play-assets-carousel{max-width:100%;box-sizing:border-box}.collapse-toggle{all:unset;cursor:pointer;display:flex;align-items:center;gap:6px;font-size:.84rem;font-weight:600;color:var(--muted);padding:6px 0}.collapse-toggle .arrow{transition:transform .2s ease}.collapse-toggle.open .arrow{transform:rotate(90deg)}.partner-code{display:flex;align-items:center;gap:10px;padding:12px 14px;border:1px solid var(--line);border-radius:var(--radius);background:#ffffffb8}.partner-code code{font-size:1.1rem;font-weight:700;flex:1;overflow-wrap:anywhere}.sub-tabs{display:flex;gap:0;border-bottom:2px solid var(--line);margin-bottom:12px}.sub-tab{padding:8px 16px;background:transparent;border:none;border-bottom:2px solid transparent;border-radius:0;color:var(--muted);font-weight:600;font-size:.84rem;margin-bottom:-2px;transition:color .1s,border-color .1s}.sub-tab:hover{transform:none;color:var(--ink)}.sub-tab.active{color:var(--accent);border-bottom-color:var(--accent)}.match-indicator{display:inline-flex;align-items:center;gap:4px;padding:3px 8px;border-radius:var(--radius-pill);font-size:.74rem;font-weight:600}.match-indicator.perfect{background:#e8f5e9;color:#2e7d32}.match-indicator.partial{background:#fff3e0;color:#e65100}.together-scenario-card{flex-direction:column;align-items:stretch;gap:10px}.together-scenario-copy{display:grid;gap:4px;min-width:0}.together-mother-label,.together-scenario-label{text-transform:uppercase;letter-spacing:.05em;font-weight:700;color:var(--muted);font-size:.68rem}.together-mother-name{font-size:.95rem;font-weight:700;line-height:1.35;overflow-wrap:anywhere;word-break:break-word}button.together-mother-link{all:unset;cursor:pointer;font-size:.95rem;font-weight:700;line-height:1.35;overflow-wrap:anywhere;word-break:break-word;color:var(--accent);text-decoration:underline;text-underline-offset:2px}button.together-mother-link:focus-visible{outline:2px solid var(--accent);outline-offset:2px}.together-scenario-title{font-size:.88rem;font-weight:650;line-height:1.45;overflow-wrap:anywhere;word-break:break-word;white-space:normal}.together-scenario-meta{display:flex;flex-direction:column;gap:8px;min-width:0}.together-scenario-you{display:grid;gap:4px;padding-top:4px;border-top:1px solid var(--line)}.onboard{min-height:100vh;display:flex;flex-direction:column;align-items:center;justify-content:center;padding:24px;text-align:center}.onboard .card{width:100%;max-width:440px;text-align:left}.onboard h1{font-size:2.4rem;letter-spacing:-.04em;line-height:1;margin:0 0 8px}.onboard .sub{color:var(--muted);margin:0 0 24px;font-size:.96rem}.starter-page{padding-top:24px}.starter-hero{display:flex;align-items:flex-start;justify-content:space-between;gap:16px;margin-bottom:16px}.starter-hero .sub{margin:8px 0 0;max-width:520px}.creds{border:1px solid var(--line);border-radius:var(--radius);padding:14px;background:#ffffffb8}.creds code{display:block;margin-top:6px;padding:8px 10px;border-radius:var(--radius-sm);background:#f5eee4;overflow-wrap:anywhere;font-weight:600}.settings-code{display:inline-block;margin-top:6px;padding:8px 10px;border-radius:var(--radius-sm);background:#f5eee4;overflow-wrap:anywhere;font-weight:600}.settings-toggle{margin:0;max-width:none}.settings-share-row{padding:10px 12px;border:1px solid var(--line);border-radius:var(--radius-sm);background:#ffffffb8}.settings-share-title{font-size:.9rem;font-weight:700;margin-bottom:4px}.search-overlay{position:fixed;top:0;right:0;bottom:0;left:0;z-index:80;background:#1d18156b;-webkit-backdrop-filter:blur(6px);backdrop-filter:blur(6px);display:flex;flex-direction:column;align-items:center;padding:16px}.search-overlay .search-inner{width:100%;max-width:560px;display:grid;gap:12px}.search-overlay input{font-size:1.1rem;padding:14px 16px}.play-assets{width:100%}.play-assets-carousel{position:relative;border-radius:var(--radius-sm);border:1px solid var(--line);overflow:hidden;background:var(--surface)}.play-assets-carousel .play-assets-slide{min-height:200px;max-height:min(48vh,340px)}.play-assets-carousel .play-assets-slide img{width:100%;height:100%;min-height:200px;max-height:min(48vh,340px);object-fit:cover;display:block}.play-edge{position:absolute;top:0;bottom:0;width:28%;max-width:120px;z-index:2;cursor:pointer;border:none;padding:0;background:transparent;-webkit-tap-highlight-color:transparent}.play-edge--left{left:0;background:linear-gradient(90deg,rgba(0,0,0,.08),transparent)}.play-edge--right{right:0;background:linear-gradient(270deg,rgba(0,0,0,.08),transparent)}.play-assets-dots{position:absolute;bottom:10px;left:50%;transform:translate(-50%);display:flex;gap:6px;z-index:3;pointer-events:none}.play-assets-dots span{width:6px;height:6px;border-radius:50%;background:#ffffff73}.play-assets-dots span.on{background:#fff}.play-assets-badge{position:absolute;top:8px;right:8px;z-index:3;padding:4px 10px;border-radius:var(--radius-pill);background:#0000007a;color:#fff;font-size:.72rem;font-weight:700;pointer-events:none}.image-grid{display:grid;grid-template-columns:repeat(2,1fr);gap:8px}.image-tile{position:relative;aspect-ratio:1;background:#c9b8a7;border-radius:var(--radius-sm);overflow:hidden}.image-tile img{width:100%;height:100%;object-fit:cover}.image-tile .reveal-btn{position:absolute;top:0;right:0;bottom:0;left:0;border-radius:0;background:linear-gradient(180deg,#0000001f,#000000b3);display:flex;align-items:center;justify-content:center;font-size:.82rem}.safety-badge{padding:4px 8px;border-radius:8px;font-size:.78rem;font-weight:600;display:inline-block}.safety-badge.extreme{background:#ffebee;color:#c62828;border:1px solid #ef9a9a}.safety-badge.advanced{background:#fff3e0;color:#e65100;border:1px solid #ffcc80}.stack{display:grid;gap:12px}.stack-sm{display:grid;gap:8px}.row{display:flex;gap:8px;align-items:center;flex-wrap:wrap}.muted{color:var(--muted)}.tiny{font-size:.82rem;color:var(--muted)}.empty{color:var(--muted);border:1px dashed rgba(219,205,189,.7);border-radius:14px;padding:10px 12px;background:#ffffff59;font-size:.88rem}.chips{display:flex;gap:6px;flex-wrap:wrap}.chip{border:1px solid var(--line);border-radius:var(--radius-pill);padding:5px 10px;font-size:.82rem;background:#fff;color:var(--ink);cursor:pointer;font-weight:500}.chip.active{border-color:var(--accent);background:var(--accent-soft);color:var(--accent);font-weight:600}.status{min-height:1.2em;color:var(--muted);font-size:.86rem}.together-scope-hint{margin:0 0 10px;color:var(--muted)}.together-section-label{margin:8px 0 2px;font-weight:700;color:var(--muted);text-transform:uppercase;letter-spacing:.04em}.related-match-chip{align-items:flex-start}.related-arrow{color:var(--muted);font-weight:700}.related-match-meta{flex:1 1 240px;color:var(--muted)}.their-board-picker{margin-bottom:12px}.together-react-row{display:inline-flex;flex-wrap:wrap;gap:6px;align-items:center;justify-content:flex-end;max-width:100%}.together-react-pair{display:inline-flex;gap:3px;align-items:center}.together-react-id{font-family:ui-monospace,monospace;font-size:.75em;opacity:.85}@media (min-width: 768px){.page{max-width:720px;padding:24px}.action-btn{padding:14px 28px;min-width:80px;font-size:.82rem}.action-btn .action-icon{font-size:1.6rem}.card-lg{padding:36px 32px}.card-title{font-size:2.2rem}}.desktop-nav{display:none}@media (min-width: 1024px){.page{max-width:880px}.tab-bar{display:none}body{padding-bottom:0}.desktop-nav{display:flex;gap:0;margin-bottom:20px;border-bottom:2px solid var(--line)}.desktop-nav .tab-btn{flex-direction:row;gap:6px;padding:10px 20px;font-size:.88rem;max-width:none;border-bottom:2px solid transparent;margin-bottom:-2px}.desktop-nav .tab-btn.active{border-bottom-color:var(--accent);color:var(--accent)}}

frontend/dist/index.html

@@ -5,8 +5,8 @@
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>Play List</title>
     <link rel="icon" href="/favicon.ico" type="image/jpeg" />
-    <script type="module" crossorigin src="/frontend/assets/index-BsUmRveR.js"></script>
-    <link rel="stylesheet" crossorigin href="/frontend/assets/index-DiW-h6tN.css">
+    <script type="module" crossorigin src="/frontend/assets/index-BRxg-Ey6.js"></script>
+    <link rel="stylesheet" crossorigin href="/frontend/assets/index-HvMqkWIl.css">
   </head>
   <body>
     <div id="root"></div>

frontend/mutations.js

@@ -127,6 +127,46 @@ export function useSavePlayMutation({
   });
 }
 
+export function useDeletePlayMutation({ auth, setStatus }) {
+  const qc = useQueryClient();
+  return useMutation({
+    mutationFn: (kinkId) =>
+      api(`/users/${auth.userId}/plays/${encodeURIComponent(kinkId)}`, {
+        method: "DELETE",
+        headers: authHeaders(auth.token),
+      }),
+    onMutate: async (kinkId) => {
+      const playKey = String(kinkId);
+      const previousUser = qc.getQueryData(["user", auth.userId]);
+      const previousBoard = qc.getQueryData(["board", auth.userId]);
+      qc.setQueryData(["user", auth.userId], (old) => {
+        if (!old?.plays) return old;
+        const { [playKey]: _drop, ...rest } = old.plays;
+        return { ...old, plays: rest };
+      });
+      qc.setQueryData(["board", auth.userId], (old) => {
+        if (!old) return old;
+        const next = { ...old };
+        for (const col of ["to_me", "by_me", "together", "hidden", "no_go"]) {
+          if (Array.isArray(next[col])) next[col] = next[col].filter((item) => String(item?.id) !== playKey);
+        }
+        return next;
+      });
+      return { previousUser, previousBoard };
+    },
+    onSuccess: () => {
+      qc.invalidateQueries({ queryKey: ["board", auth.userId] });
+      qc.invalidateQueries({ queryKey: ["user", auth.userId] });
+      setStatus?.("Removed.");
+    },
+    onError: (error, _kinkId, context) => {
+      if (context?.previousUser) qc.setQueryData(["user", auth.userId], context.previousUser);
+      if (context?.previousBoard) qc.setQueryData(["board", auth.userId], context.previousBoard);
+      setStatus?.(error.message);
+    },
+  });
+}
+
 export function useSaveRoleMutation({ auth, setStatus }) {
   const qc = useQueryClient();
   return useMutation({

frontend/my-plays-similar.js

@@ -15,3 +15,20 @@ export function planSimilarTentativeAdd(currentPlays, similarKinkId, parentDirec
     directions: tentativeSimilarDirections(parentDirections),
   };
 }
+
+export function openSimilarKinkInline({
+  similarKinkId,
+  parentDirections,
+  currentPlays,
+  onRate,
+  onInspect,
+  onMarkTentative,
+}) {
+  const plan = planSimilarTentativeAdd(currentPlays, similarKinkId, parentDirections);
+  if (plan.shouldTentativeAdd) {
+    onRate(similarKinkId, "curious", plan.directions);
+    onMarkTentative?.(similarKinkId);
+  }
+  onInspect(similarKinkId);
+  return plan;
+}

frontend/my-plays.js

@@ -1,9 +1,10 @@
 import React, { useState, useMemo, useCallback, useEffect, useRef } from "react";
 import { html, UI_REACTIONS, DIRECTION_PILLS } from "./constants.js";
-import { PlayChip, ReactionBar, DirectionPills, SearchOverlay } from "./components.js";
+import { PlayChip, SearchOverlay } from "./components.js";
 import { useBoardQuery, useSearchQuery, useDetailQuery, useSimilarQuery } from "./queries.js";
 import { uiReactionFor } from "./api.js";
-import { planSimilarTentativeAdd } from "./my-plays-similar.js";
+import { openSimilarKinkInline } from "./my-plays-similar.js";
+import { PlayInspectorCallout } from "./play-inspector.js";
 import {
   DIRECTION_COLUMN_ORDER,
   directionColumnsForPlay,
@@ -33,12 +34,16 @@ function PlaysTouchColumnMoves({ kinkId, onDirectionColumnChange }) {
   `;
 }
 
+function isScenarioItem(item) {
+  return Boolean(item?.is_scenario);
+}
+
 function positivePlaysUnique(board) {
   const seen = new Set();
   const out = [];
   for (const col of DIR_ORDER) {
     for (const item of board[col] || []) {
-      if (seen.has(item.id)) continue;
+      if (seen.has(item.id) || isScenarioItem(item)) continue;
       seen.add(item.id);
       out.push(item);
     }
@@ -50,21 +55,15 @@ function boardItemsById(board) {
   const map = new Map();
   for (const col of [...DIR_ORDER, "hidden", "no_go"]) {
     for (const item of board?.[col] || []) {
-      if (!item?.id || map.has(item.id)) continue;
+      if (!item?.id || map.has(item.id) || isScenarioItem(item)) continue;
       map.set(item.id, item);
     }
   }
   return map;
 }
 
-function visibleSimilarItems(similarData) {
-  return (similarData?.items || []).filter((item) => item?.kink && !item.kink.is_scenario).slice(0, 6);
-}
-
-function openSimilarKink({ similarKinkId, parentDirections, currentPlays, onRate, onInspect }) {
-  const plan = planSimilarTentativeAdd(currentPlays, similarKinkId, parentDirections);
-  if (plan.shouldTentativeAdd) onRate(similarKinkId, "curious", plan.directions);
-  onInspect(similarKinkId);
+function filterScenariosFromBucket(items) {
+  return (items || []).filter((item) => !isScenarioItem(item));
 }
 
 function DirectionsColumnBoard({
@@ -259,170 +258,6 @@ function CollapsibleSection(props) {
   `;
 }
 
-function ImageGrid({ assets }) {
-  const [revealed, setRevealed] = useState(false);
-  const [idx, setIdx] = useState(0);
-  const [failedAssetUrls, setFailedAssetUrls] = useState(() => new Set());
-  const visibleAssets = assets.filter((asset) => !failedAssetUrls.has(asset.asset_url));
-  const n = visibleAssets.length;
-  const cur = visibleAssets[idx];
-
-  useEffect(() => {
-    setIdx(0);
-    setFailedAssetUrls(new Set());
-  }, [assets?.length, assets?.[0]?.asset_url]);
-
-  const go = useCallback((delta, e) => {
-    e?.stopPropagation?.();
-    if (n < 2) return;
-    setIdx((i) => (i + delta + n) % n);
-  }, [n]);
-
-  const markAssetFailed = useCallback((assetUrl) => {
-    if (!assetUrl) return;
-    setFailedAssetUrls((prev) => {
-      if (prev.has(assetUrl)) return prev;
-      const next = new Set(prev);
-      next.add(assetUrl);
-      return next;
-    });
-  }, []);
-
-  useEffect(() => {
-    setIdx((i) => (n ? Math.min(Math.max(0, i), n - 1) : 0));
-  }, [n]);
-
-  if (!n) return null;
-
-  return html`
-    <div className="play-assets">
-      ${!revealed
-        ? html`
-            <button
-              type="button"
-              className="ghost sm"
-              onClick=${(e) => { e.stopPropagation(); setRevealed(true); }}
-            >Show ${n} photo${n > 1 ? "s" : ""}</button>
-          `
-        : html`
-            <div className="play-assets-carousel">
-              ${n > 1
-                ? html`
-                    <button type="button" className="play-edge play-edge--left" aria-label="Previous photo" onClick=${(e) => go(-1, e)} />
-                    <button type="button" className="play-edge play-edge--right" aria-label="Next photo" onClick=${(e) => go(1, e)} />
-                  `
-                : null}
-              <div className="play-assets-slide">
-                <img
-                  loading="eager"
-                  decoding="async"
-                  src=${cur.asset_url}
-                  alt=""
-                  draggable=${false}
-                  onError=${() => markAssetFailed(cur.asset_url)}
-                />
-              </div>
-              ${n > 1
-                ? html`
-                    <div className="play-assets-dots" aria-hidden="true">
-                      ${visibleAssets.map((_, i) => html`<span key=${`pd-${i}`} className=${i === idx ? "on" : ""} />`)}
-                    </div>
-                    <div className="play-assets-badge">${idx + 1} / ${n}</div>
-                  `
-                : null}
-            </div>
-          `}
-    </div>
-  `;
-}
-
-function PlayInspectorCallout({
-  item,
-  play,
-  detailData,
-  detailLoading,
-  similarData,
-  onRate,
-  onDirectionToggle,
-  onOpenSimilar,
-  onOpenScenarios,
-  onClose,
-  showImages,
-  inspectorRef,
-}) {
-  if (!item?.id) return null;
-  const reaction = uiReactionFor(play?.interest_state);
-  const reactionMeta = UI_REACTIONS.find((entry) => entry.ui === reaction);
-  const directions = play?.directions || [];
-  const detail = detailData?.id === item.id ? detailData : null;
-  const defText = (detail?.definition || detail?.detail_summary || item.summary || "").trim();
-  const similarItems = visibleSimilarItems(similarData);
-  const scenarioCount = Number(detail?.scenario_child_count || item.scenario_child_count || 0);
-
-  return html`
-    <section className="plays-inspector card stack" data-testid="plays-inspector" ref=${inspectorRef}>
-      <div className="plays-inspector-head">
-        <div className="plays-inspector-copy">
-          <div className="tiny plays-inspector-label">Selected play</div>
-          <div className="plays-inspector-title-row">
-            <span className="plays-inspector-emoji">${reactionMeta?.icon || ""}</span>
-            <h3 className="plays-inspector-title">${item.name}</h3>
-          </div>
-        </div>
-        <button type="button" className="ghost sm" data-testid="plays-inspector-close" onClick=${onClose}>Close</button>
-      </div>
-      ${defText
-        ? html`<div className="detail-def plays-inspector-definition">${defText}</div>`
-        : detailLoading
-          ? html`<div className="tiny muted">Loading details…</div>`
-          : null}
-      <div className="plays-inspector-actions">
-        <${ReactionBar} current=${reaction} onRate=${(rating) => onRate(item.id, rating)} />
-        <${DirectionPills}
-          directions=${directions}
-          locked=${!reaction}
-          onToggle=${(direction) => onDirectionToggle(item.id, direction)}
-        />
-      </div>
-      <div className="plays-inspector-actions-row">
-        <button
-          type="button"
-          className="ghost sm"
-          data-testid="plays-open-scenarios"
-          disabled=${scenarioCount < 1}
-          onClick=${() => onOpenScenarios?.(item.id)}
-        >${scenarioCount > 0 ? `Explore scenarios (${scenarioCount})` : "No scenarios yet"}</button>
-        <button className="ghost sm" onClick=${() => onRate(item.id, "not_interested")}>Remove from list</button>
-      </div>
-      ${similarItems.length
-        ? html`
-            <div className="plays-inspector-section">
-              <div className="tiny plays-inspector-label">Similar</div>
-              <div className="chips">
-                ${similarItems.map((entry) => html`
-                  <button
-                    key=${entry.kink.id}
-                    type="button"
-                    className="chip"
-                    title=${entry.kink.name}
-                    onClick=${(e) => {
-                      e.stopPropagation();
-                      onOpenSimilar(entry.kink.id, directions);
-                    }}
-                  >
-                    ${entry.kink.name}
-                  </button>
-                `)}
-              </div>
-            </div>
-          `
-        : null}
-      ${detail?.is_extreme ? html`<div className="safety-badge extreme">Significant risk</div>` : null}
-      ${showImages && detail?.assets?.length ? html`<${ImageGrid} assets=${detail.assets} />` : null}
-    </section>
-  `;
-}
-
 export function MyPlaysView({
   auth,
   currentPlays,
@@ -432,10 +267,12 @@ export function MyPlaysView({
   onDirectionColumnChange,
   onNavigate,
   onOpenScenarios,
+  onDeletePlay,
   focusKinkId,
   onFocusKinkConsumed,
 }) {
   const [inspectedId, setInspectedId] = useState("");
+  const [tentativeIds, setTentativeIds] = useState(() => new Set());
   const [dragOver, setDragOver] = useState(null);
   const [searchOpen, setSearchOpen] = useState(false);
   const [searchInput, setSearchInput] = useState("");
@@ -445,7 +282,15 @@ export function MyPlaysView({
 
   const boardQuery = useBoardQuery(auth);
   const board = boardQuery.data || {};
-  const boardById = useMemo(() => boardItemsById(board), [board]);
+  const filteredBoard = useMemo(() => ({
+    ...board,
+    to_me: filterScenariosFromBucket(board.to_me),
+    by_me: filterScenariosFromBucket(board.by_me),
+    together: filterScenariosFromBucket(board.together),
+    hidden: filterScenariosFromBucket(board.hidden),
+    no_go: filterScenariosFromBucket(board.no_go),
+  }), [board]);
+  const boardById = useMemo(() => boardItemsById(filteredBoard), [filteredBoard]);
   const inspectedItem = boardById.get(inspectedId) || null;
   const detailQuery = useDetailQuery(inspectedId);
   const similarQuery = useSimilarQuery(inspectedId);
@@ -453,10 +298,10 @@ export function MyPlaysView({
   const totalCount = Object.keys(currentPlays || {}).length;
 
   const nearDupHints = useMemo(() => {
-    const pos = positivePlaysUnique(board);
-    const combined = [...pos, ...(board.hidden || []), ...(board.no_go || [])];
+    const pos = positivePlaysUnique(filteredBoard);
+    const combined = [...pos, ...(filteredBoard.hidden || []), ...(filteredBoard.no_go || [])];
     return nearDuplicateHintsById(combined);
-  }, [board]);
+  }, [filteredBoard]);
 
   useEffect(() => {
     if (!inspectedId) return;
@@ -483,17 +328,55 @@ export function MyPlaysView({
     searchDebounceRef.current = setTimeout(() => setSearchDebounced(value.trim()), 300);
   }, []);
 
+  const markTentative = useCallback((id) => {
+    setTentativeIds((prev) => {
+      if (prev.has(id)) return prev;
+      const next = new Set(prev);
+      next.add(id);
+      return next;
+    });
+  }, []);
+
+  const clearTentative = useCallback((id) => {
+    setTentativeIds((prev) => {
+      if (!prev.has(id)) return prev;
+      const next = new Set(prev);
+      next.delete(id);
+      return next;
+    });
+  }, []);
+
+  const handleRateInInspector = useCallback((kinkId, rating, dirs) => {
+    clearTentative(kinkId);
+    onRate(kinkId, rating, dirs);
+  }, [clearTentative, onRate]);
+
+  const handleDirectionToggleInInspector = useCallback((kinkId, direction) => {
+    clearTentative(kinkId);
+    onDirectionToggle(kinkId, direction);
+  }, [clearTentative, onDirectionToggle]);
+
   const handleOpenSimilar = useCallback((similarKinkId, directions) => {
-    openSimilarKink({
+    openSimilarKinkInline({
       similarKinkId,
       parentDirections: directions,
       currentPlays,
       onRate,
       onInspect: setInspectedId,
+      onMarkTentative: markTentative,
     });
-  }, [currentPlays, onRate]);
+  }, [currentPlays, onRate, markTentative]);
+
+  const handleUndoTentative = useCallback(() => {
+    if (!inspectedId) return;
+    const target = inspectedId;
+    clearTentative(target);
+    setInspectedId("");
+    onDeletePlay?.(target);
+  }, [inspectedId, clearTentative, onDeletePlay]);
 
   const empty = totalCount === 0;
+  const isInspectedTentative = inspectedItem ? tentativeIds.has(inspectedItem.id) : false;
 
   return html`
     <div data-testid="plays-view">
@@ -514,13 +397,15 @@ export function MyPlaysView({
                 detailData=${detailQuery.data}
                 detailLoading=${detailQuery.isFetching}
                 similarData=${similarQuery.data}
-                onRate=${onRate}
-                onDirectionToggle=${onDirectionToggle}
+                onRate=${handleRateInInspector}
+                onDirectionToggle=${handleDirectionToggleInInspector}
                 onOpenSimilar=${handleOpenSimilar}
                 onOpenScenarios=${onOpenScenarios}
                 onClose=${() => setInspectedId("")}
                 showImages=${showImages}
                 inspectorRef=${inspectorRef}
+                tentative=${isInspectedTentative}
+                onUndoTentative=${onDeletePlay ? handleUndoTentative : undefined}
               />
             `
           : null}
@@ -533,7 +418,7 @@ export function MyPlaysView({
           ? html`<div className="empty">No plays yet. Go to Discover to find things you like.</div>`
           : html`
               <${DirectionsColumnBoard}
-                board=${board}
+                board=${filteredBoard}
                 currentPlays=${currentPlays}
                 inspectedId=${inspectedId}
                 onInspect=${setInspectedId}
@@ -548,8 +433,8 @@ export function MyPlaysView({
 
         <${CollapsibleSection}
           title="Hidden"
-          emoji="\uD83D\uDE48"
-          items=${board.hidden || []}
+          emoji="🙈"
+          items=${filteredBoard.hidden || []}
           inspectedId=${inspectedId}
           onInspect=${setInspectedId}
           nearDupHints=${nearDupHints}
@@ -560,8 +445,8 @@ export function MyPlaysView({
         />
         <${CollapsibleSection}
           title="No-go"
-          emoji="\uD83D\uDEAB"
-          items=${board.no_go || []}
+          emoji="🚫"
+          items=${filteredBoard.no_go || []}
           inspectedId=${inspectedId}
           onInspect=${setInspectedId}
           nearDupHints=${nearDupHints}

frontend/play-inspector.js

@@ -0,0 +1,190 @@
+import React, { useState, useEffect, useCallback } from "react";
+import { html, UI_REACTIONS } from "./constants.js";
+import { ReactionBar, DirectionPills } from "./components.js";
+import { uiReactionFor } from "./api.js";
+
+export function visibleSimilarItems(similarData) {
+  return (similarData?.items || []).filter((item) => item?.kink && !item.kink.is_scenario).slice(0, 6);
+}
+
+function ImageGrid({ assets }) {
+  const [revealed, setRevealed] = useState(false);
+  const [idx, setIdx] = useState(0);
+  const [failedAssetUrls, setFailedAssetUrls] = useState(() => new Set());
+  const visibleAssets = assets.filter((asset) => !failedAssetUrls.has(asset.asset_url));
+  const n = visibleAssets.length;
+  const cur = visibleAssets[idx];
+
+  useEffect(() => {
+    setIdx(0);
+    setFailedAssetUrls(new Set());
+  }, [assets?.length, assets?.[0]?.asset_url]);
+
+  const go = useCallback((delta, e) => {
+    e?.stopPropagation?.();
+    if (n < 2) return;
+    setIdx((i) => (i + delta + n) % n);
+  }, [n]);
+
+  const markAssetFailed = useCallback((assetUrl) => {
+    if (!assetUrl) return;
+    setFailedAssetUrls((prev) => {
+      if (prev.has(assetUrl)) return prev;
+      const next = new Set(prev);
+      next.add(assetUrl);
+      return next;
+    });
+  }, []);
+
+  useEffect(() => {
+    setIdx((i) => (n ? Math.min(Math.max(0, i), n - 1) : 0));
+  }, [n]);
+
+  if (!n) return null;
+
+  return html`
+    <div className="play-assets">
+      ${!revealed
+        ? html`
+            <button
+              type="button"
+              className="ghost sm"
+              onClick=${(e) => { e.stopPropagation(); setRevealed(true); }}
+            >Show ${n} photo${n > 1 ? "s" : ""}</button>
+          `
+        : html`
+            <div className="play-assets-carousel">
+              ${n > 1
+                ? html`
+                    <button type="button" className="play-edge play-edge--left" aria-label="Previous photo" onClick=${(e) => go(-1, e)} />
+                    <button type="button" className="play-edge play-edge--right" aria-label="Next photo" onClick=${(e) => go(1, e)} />
+                  `
+                : null}
+              <div className="play-assets-slide">
+                <img
+                  loading="eager"
+                  decoding="async"
+                  src=${cur.asset_url}
+                  alt=""
+                  draggable=${false}
+                  onError=${() => markAssetFailed(cur.asset_url)}
+                />
+              </div>
+              ${n > 1
+                ? html`
+                    <div className="play-assets-dots" aria-hidden="true">
+                      ${visibleAssets.map((_, i) => html`<span key=${`pd-${i}`} className=${i === idx ? "on" : ""} />`)}
+                    </div>
+                    <div className="play-assets-badge">${idx + 1} / ${n}</div>
+                  `
+                : null}
+            </div>
+          `}
+    </div>
+  `;
+}
+
+export function PlayInspectorCallout({
+  item,
+  play,
+  detailData,
+  detailLoading,
+  similarData,
+  onRate,
+  onDirectionToggle,
+  onOpenSimilar,
+  onOpenScenarios,
+  onClose,
+  showImages,
+  inspectorRef,
+  tentative = false,
+  onUndoTentative,
+}) {
+  if (!item?.id) return null;
+  const reaction = uiReactionFor(play?.interest_state);
+  const reactionMeta = UI_REACTIONS.find((entry) => entry.ui === reaction);
+  const directions = play?.directions || [];
+  const detail = detailData?.id === item.id ? detailData : null;
+  const defText = (detail?.definition || detail?.detail_summary || item.summary || "").trim();
+  const similarItems = visibleSimilarItems(similarData);
+  const scenarioCount = Number(detail?.scenario_child_count || item.scenario_child_count || 0);
+  const sectionClass = `plays-inspector card stack${tentative ? " plays-inspector--tentative" : ""}`;
+
+  return html`
+    <section className=${sectionClass} data-testid="plays-inspector" ref=${inspectorRef}>
+      <div className="plays-inspector-head">
+        <div className="plays-inspector-copy">
+          <div className="tiny plays-inspector-label">Selected play</div>
+          <div className="plays-inspector-title-row">
+            <span className="plays-inspector-emoji">${reactionMeta?.icon || ""}</span>
+            <h3 className="plays-inspector-title">${item.name}</h3>
+          </div>
+          ${tentative ? html`
+            <span className="tentative-badge" data-testid="plays-inspector-tentative">
+              Tentative — added as Curious
+            </span>
+          ` : null}
+        </div>
+        <div className="plays-inspector-head-actions">
+          ${tentative && onUndoTentative ? html`
+            <button
+              type="button"
+              className="ghost sm"
+              data-testid="plays-inspector-undo"
+              onClick=${onUndoTentative}
+            >Undo</button>
+          ` : null}
+          <button type="button" className="ghost sm" data-testid="plays-inspector-close" onClick=${onClose}>Close</button>
+        </div>
+      </div>
+      ${defText
+        ? html`<div className="detail-def plays-inspector-definition">${defText}</div>`
+        : detailLoading
+          ? html`<div className="tiny muted">Loading details…</div>`
+          : null}
+      <div className="plays-inspector-actions">
+        <${ReactionBar} current=${reaction} onRate=${(rating) => onRate(item.id, rating)} />
+        <${DirectionPills}
+          directions=${directions}
+          locked=${!reaction}
+          onToggle=${(direction) => onDirectionToggle(item.id, direction)}
+        />
+      </div>
+      <div className="plays-inspector-actions-row">
+        <button
+          type="button"
+          className="ghost sm"
+          data-testid="plays-open-scenarios"
+          disabled=${scenarioCount < 1}
+          onClick=${() => onOpenScenarios?.(item.id)}
+        >${scenarioCount > 0 ? `Explore scenarios (${scenarioCount})` : "No scenarios yet"}</button>
+        <button className="ghost sm" onClick=${() => onRate(item.id, "not_interested")}>Remove from list</button>
+      </div>
+      ${similarItems.length
+        ? html`
+            <div className="plays-inspector-section">
+              <div className="tiny plays-inspector-label">Similar</div>
+              <div className="chips">
+                ${similarItems.map((entry) => html`
+                  <button
+                    key=${entry.kink.id}
+                    type="button"
+                    className="chip"
+                    title=${entry.kink.name}
+                    onClick=${(e) => {
+                      e.stopPropagation();
+                      onOpenSimilar(entry.kink.id, directions);
+                    }}
+                  >
+                    ${entry.kink.name}
+                  </button>
+                `)}
+              </div>
+            </div>
+          `
+        : null}
+      ${detail?.is_extreme ? html`<div className="safety-badge extreme">Significant risk</div>` : null}
+      ${showImages && detail?.assets?.length ? html`<${ImageGrid} assets=${detail.assets} />` : null}
+    </section>
+  `;
+}

frontend/styles.css

@@ -836,6 +836,45 @@ button.tinder-card__body.tinder-card__body--tappable {
   scroll-margin-top: 12px;
 }
 
+.plays-inspector--tentative {
+  border: 1px dashed var(--accent, #888);
+  background: rgba(255, 255, 255, 0.02);
+}
+
+.plays-inspector-head-actions {
+  display: flex;
+  gap: 8px;
+  flex-wrap: wrap;
+  align-items: center;
+}
+
+.tentative-badge {
+  display: inline-block;
+  margin-top: 4px;
+  padding: 2px 8px;
+  font-size: 0.72rem;
+  border-radius: 999px;
+  border: 1px dashed var(--accent, #888);
+  color: var(--muted);
+}
+
+.play-chip--expandable {
+  cursor: pointer;
+}
+
+.play-chip--expanded {
+  background: rgba(255, 255, 255, 0.04);
+}
+
+.play-chip-inspector {
+  width: 100%;
+  margin-top: 8px;
+}
+
+.play-chip-inspector--floating {
+  margin-top: 12px;
+}
+
 .plays-inspector-head {
   display: flex;
   align-items: flex-start;

frontend/together.js

@@ -1,15 +1,19 @@
-import React, { useState, useEffect, useMemo } from "react";
+import React, { useState, useEffect, useMemo, useCallback } from "react";
 import { html, UI_REACTIONS, VIEWS, partnerGroupChipLabel, partnerGroupPartnerIdsTitle } from "./constants.js";
 import { ReactionBar } from "./components.js";
-import { useGroupsQuery, useOverlapQuery, usePartnerBoardQuery } from "./queries.js";
+import { useGroupsQuery, useOverlapQuery, usePartnerBoardQuery, useDetailQuery, useSimilarQuery } from "./queries.js";
 import { uiReactionFor } from "./api.js";
 import { preferredPartnerGroupId, resolvedPartnerGroups } from "./partner-groups.js";
+import { PlayInspectorCallout } from "./play-inspector.js";
+import { openSimilarKinkInline } from "./my-plays-similar.js";
 
 export function TogetherView({
   auth,
   user,
   currentPlays,
   onRate,
+  onDirectionToggle,
+  onDeletePlay,
   onNavigate,
   onOpenScenarios,
   setStatus,
@@ -254,6 +258,10 @@ export function TogetherView({
                     currentPlays=${currentPlays}
                     auth=${auth}
                     participantCount=${participantCount}
+                    showImages=${false}
+                    onRate=${onRate}
+                    onDirectionToggle=${onDirectionToggle}
+                    onDeletePlay=${onDeletePlay}
                     onNavigate=${onNavigate}
                     onOpenScenarios=${onOpenScenarios}
                   />`
@@ -295,6 +303,10 @@ function SharedTab({
   currentPlays,
   auth,
   participantCount = 2,
+  showImages = false,
+  onRate,
+  onDirectionToggle,
+  onDeletePlay,
   onNavigate,
   onOpenScenarios,
 }) {
@@ -304,6 +316,67 @@ function SharedTab({
     ? "No play is shared across everyone in this connection yet."
     : "No shared plays yet. Both of you need a few overlapping likes first.";
 
+  const [expandedKinkId, setExpandedKinkId] = useState("");
+  const [tentativeIds, setTentativeIds] = useState(() => new Set());
+  const detailQuery = useDetailQuery(expandedKinkId);
+  const similarQuery = useSimilarQuery(expandedKinkId);
+
+  const matchById = useMemo(() => {
+    const map = new Map();
+    for (const m of matches) {
+      if (m?.id) map.set(m.id, m);
+    }
+    return map;
+  }, [matches]);
+  const expandedItem = expandedKinkId ? matchById.get(expandedKinkId) || { id: expandedKinkId, name: detailQuery.data?.name || "" } : null;
+
+  const markTentative = useCallback((id) => {
+    setTentativeIds((prev) => {
+      if (prev.has(id)) return prev;
+      const next = new Set(prev);
+      next.add(id);
+      return next;
+    });
+  }, []);
+
+  const clearTentative = useCallback((id) => {
+    setTentativeIds((prev) => {
+      if (!prev.has(id)) return prev;
+      const next = new Set(prev);
+      next.delete(id);
+      return next;
+    });
+  }, []);
+
+  const handleRateInline = useCallback((kinkId, rating, dirs) => {
+    clearTentative(kinkId);
+    onRate?.(kinkId, rating, dirs);
+  }, [clearTentative, onRate]);
+
+  const handleDirectionToggleInline = useCallback((kinkId, direction) => {
+    clearTentative(kinkId);
+    onDirectionToggle?.(kinkId, direction);
+  }, [clearTentative, onDirectionToggle]);
+
+  const handleOpenSimilarInline = useCallback((similarKinkId, dirs) => {
+    openSimilarKinkInline({
+      similarKinkId,
+      parentDirections: dirs,
+      currentPlays,
+      onRate,
+      onInspect: setExpandedKinkId,
+      onMarkTentative: markTentative,
+    });
+  }, [currentPlays, onRate, markTentative]);
+
+  const handleUndoInline = useCallback(() => {
+    if (!expandedKinkId) return;
+    const target = expandedKinkId;
+    clearTentative(target);
+    setExpandedKinkId("");
+    onDeletePlay?.(target);
+  }, [expandedKinkId, clearTentative, onDeletePlay]);
+
   if (!matches.length && !scenarioMatches.length) return html`<div className="empty">${emptyHint}</div>`;
 
   return html`
@@ -319,20 +392,23 @@ function SharedTab({
                 const partnerUi = uiReactionFor(state);
                 return (myReaction === "love" || myReaction === "like") && (partnerUi === "love" || partnerUi === "like");
               });
-              const openPlay = () => onNavigate?.(VIEWS.PLAYS, kink.id);
+              const expanded = expandedKinkId === kink.id;
+              const toggle = () => setExpandedKinkId((prev) => (prev === kink.id ? "" : kink.id));
+              const isTentative = tentativeIds.has(kink.id);
               return html`
                 <div
                   key=${kink.id}
-                  className="play-chip"
+                  className=${`play-chip play-chip--expandable${expanded ? " play-chip--expanded" : ""}`}
                   data-testid=${`together-shared-direct-${kink.id}`}
-                  style=${{ width: "100%" }}
+                  style=${{ width: "100%", flexWrap: "wrap" }}
                   role="button"
                   tabIndex="0"
-                  onClick=${openPlay}
+                  aria-expanded=${expanded}
+                  onClick=${toggle}
                   onKeyDown=${(e) => {
                     if (e.key !== "Enter" && e.key !== " ") return;
                     e.preventDefault();
-                    openPlay();
+                    toggle();
                   }}
                 >
                   <span className="chip-name" style=${{ flex: 1 }}>${kink.name}</span>
@@ -345,12 +421,66 @@ function SharedTab({
                       </span>
                     `)}
                   </span>
+                  ${expanded
+                    ? html`
+                        <div
+                          className="play-chip-inspector"
+                          data-testid=${`together-shared-direct-inspector-${kink.id}`}
+                          style=${{ width: "100%" }}
+                          onClick=${(e) => e.stopPropagation()}
+                          onKeyDown=${(e) => e.stopPropagation()}
+                        >
+                          <${PlayInspectorCallout}
+                            item=${expandedItem || kink}
+                            play=${currentPlays[kink.id] || {}}
+                            detailData=${detailQuery.data}
+                            detailLoading=${detailQuery.isFetching}
+                            similarData=${similarQuery.data}
+                            onRate=${handleRateInline}
+                            onDirectionToggle=${handleDirectionToggleInline}
+                            onOpenSimilar=${handleOpenSimilarInline}
+                            onOpenScenarios=${onOpenScenarios}
+                            onClose=${() => setExpandedKinkId("")}
+                            showImages=${showImages}
+                            tentative=${isTentative}
+                            onUndoTentative=${onDeletePlay ? handleUndoInline : undefined}
+                          />
+                        </div>
+                      `
+                    : null}
                 </div>
               `;
             })}
           `
         : null}
 
+      ${expandedKinkId && !matchById.has(expandedKinkId)
+        ? html`
+            <div
+              className="play-chip-inspector play-chip-inspector--floating"
+              data-testid=${`together-shared-direct-inspector-${expandedKinkId}`}
+              onClick=${(e) => e.stopPropagation()}
+              onKeyDown=${(e) => e.stopPropagation()}
+            >
+              <${PlayInspectorCallout}
+                item=${expandedItem || { id: expandedKinkId, name: detailQuery.data?.name || "" }}
+                play=${currentPlays[expandedKinkId] || {}}
+                detailData=${detailQuery.data}
+                detailLoading=${detailQuery.isFetching}
+                similarData=${similarQuery.data}
+                onRate=${handleRateInline}
+                onDirectionToggle=${handleDirectionToggleInline}
+                onOpenSimilar=${handleOpenSimilarInline}
+                onOpenScenarios=${onOpenScenarios}
+                onClose=${() => setExpandedKinkId("")}
+                showImages=${showImages}
+                tentative=${tentativeIds.has(expandedKinkId)}
+                onUndoTentative=${onDeletePlay ? handleUndoInline : undefined}
+              />
+            </div>
+          `
+        : null}
+
       ${scenarioMatches.length
         ? html`
             <div className="tiny together-section-label" data-testid="together-shared-scenarios-section">
@@ -417,7 +547,11 @@ function WorthExploringTab({
   const similar = overlap?.similar_matches || [];
 
   if (!related.length && !scenarioRelated.length && !similar.length) {
-    return html`<div className="empty">Add more overlap to unlock nearby ideas worth exploring together.</div>`;
+    return html`
+      <div className="empty" data-testid="together-explore-empty">
+        No nearby ideas yet. <strong>Rate more in Discover</strong>, or ask your partner to share theirs in Together.
+      </div>
+    `;
   }
 
   return html`
@@ -565,25 +699,51 @@ function TheirListTab({
     : null;
 
   if (!boardPartnerId) {
-    return html`<div>${picker}<div className="empty">No partner has turned on full-list sharing for this connection.</div></div>`;
+    return html`
+      <div data-testid="together-their-list-panel">
+        ${picker}
+        <div className="empty">
+          No partner has turned on full-list sharing for this connection yet.
+          <div className="tiny muted">See the <strong>Share link</strong> above to invite or remind them.</div>
+        </div>
+      </div>
+    `;
+  }
+  if (isPending) {
+    return html`<div data-testid="together-their-list-panel">${picker}<div className="empty">Loading…</div></div>`;
   }
-  if (isPending) return html`<div>${picker}<div className="empty">Loading…</div></div>`;
   if (isError) {
     const forbidden = error?.status === 403;
-    return html`<div>${picker}<div className="empty">${forbidden ? "This partner has not shared their list here." : (error?.message || "Could not load this list.")}</div></div>`;
+    return html`
+      <div data-testid="together-their-list-panel">
+        ${picker}
+        <div className="empty">
+          ${forbidden
+            ? html`This partner has not turned on sharing yet. Ask <code>${boardPartnerId.slice(0, 12)}…</code> to enable it from their Together → Privacy.`
+            : (error?.message || "Could not load this list.")}
+        </div>
+      </div>
+    `;
+  }
+  if (!data) {
+    return html`<div data-testid="together-their-list-panel">${picker}<div className="empty">Could not load this list.</div></div>`;
   }
-  if (!data) return html`<div>${picker}<div className="empty">Could not load this list.</div></div>`;
 
   const allPlays = [...(data.to_me || []), ...(data.by_me || []), ...(data.together || [])];
   const seen = new Set();
   const deduped = allPlays.filter((play) => {
-    if (seen.has(play.id)) return false;
+    if (seen.has(play.id) || play?.is_scenario) return false;
     seen.add(play.id);
     return true;
   });
 
   if (!deduped.length) {
-    return html`<div>${picker}<div className="empty">This shared list is empty.</div></div>`;
+    return html`
+      <div data-testid="together-their-list-panel">
+        ${picker}
+        <div className="empty">This shared list is empty. Ask them to rate a few in Discover.</div>
+      </div>
+    `;
   }
 
   return html`

scripts/playwright_product_flow.py

@@ -240,8 +240,13 @@ def create_profile_in_browser(page: Page, *, path: str = "") -> Credentials:
     expect(create_btn).to_be_visible(timeout=min(30000, t_onboard))
     create_btn.click()
     expect(page.get_by_test_id("onboarding-setup")).to_be_visible(timeout=t_onboard)
+    user_id = page.get_by_test_id("onboarding-created-user-id").inner_text().strip()
+    reveal_btn = page.get_by_test_id("onboarding-reveal-token")
+    if reveal_btn.count():
+        reveal_btn.click()
+    expect(page.get_by_test_id("onboarding-created-private-token")).to_be_visible(timeout=15000)
     creds = Credentials(
-        user_id=page.get_by_test_id("onboarding-created-user-id").inner_text().strip(),
+        user_id=user_id,
         private_token=page.get_by_test_id("onboarding-created-private-token").inner_text().strip(),
     )
     page.get_by_test_id("onboarding-start-starter").click()
@@ -763,11 +768,323 @@ def scenario_couple_audit(browser: Browser) -> dict[str, object]:
         right_context.close()
 
 
+def scenario_couple_adversarial(browser: Browser) -> dict[str, object]:
+    """Couple flow with many kinks, conflicts, and the Same-Plays / My-Plays similar-tentative-add path.
+
+    Adds adversarial coverage on top of ``scenario_couple_audit``:
+      * both partners seeded past 80 likes (recommender stress + bigger overlap pool)
+      * curated love/love overlap of ~9 known-name kinks → asserted in Together > Shared
+      * one love(left)/hard_no(right) conflict → must be ABSENT from Same Plays
+      * clicking a Same Plays chip lands on the My Plays inspector for that kink
+      * clicking a 'Similar' chip in My Plays tentatively adds the similar kink
+        as ``curious`` with the parent's directions, then opens it in the inspector
+      * ``visibleSimilarItems`` invariant: no scenario kinks in the Similar chip set
+    """
+    overlap_targets = [
+        ("kissing", "Kissing"),
+        ("massage", "Massage"),
+        ("oral sex", "Oral Sex"),
+        ("anal", "Anal"),
+        ("spanking", "Spanking"),
+        ("blindfolds", "Blindfolds"),
+        ("role play", "Role Play"),
+        ("hair pulling", "Hair Pulling"),
+        ("cuddling", "Cuddling"),
+    ]
+    conflict_candidates = [("biting", "Biting"), ("hickeys", "Hickeys"), ("tickling", "Tickling")]
+    right_only_options = [("foot worship", "Foot Worship"), ("lingerie", "Lingerie"), ("rope bondage", "Rope Bondage")]
+
+    left = create_user()
+    right = create_user()
+    seed_user_with_recommendations(left, 80)
+    seed_user_with_recommendations(right, 80)
+
+    overlap_pairs: list[tuple[str, str]] = []
+    for query, expected in overlap_targets:
+        try:
+            kink_id = find_kink_id(query, expected)
+        except AssertionError:
+            continue
+        save_play(left, kink_id, "love", ["together"])
+        save_play(right, kink_id, "love", ["together"])
+        overlap_pairs.append((kink_id, expected))
+    if len(overlap_pairs) < 5:
+        raise AssertionError(f"Could not seed enough overlap kinks: only {len(overlap_pairs)} matched")
+
+    overlap_id_set = {kid for kid, _ in overlap_pairs}
+    conflict_pair: tuple[str, str] | None = None
+    for query, expected in conflict_candidates:
+        try:
+            kink_id = find_kink_id(query, expected)
+        except AssertionError:
+            continue
+        if kink_id in overlap_id_set:
+            continue
+        save_play(left, kink_id, "love", ["together"])
+        save_play(right, kink_id, "hard_no", [])
+        conflict_pair = (kink_id, expected)
+        break
+    if conflict_pair is None:
+        raise AssertionError("Could not seed a love/hard_no conflict pair (no candidate matched the catalog)")
+
+    right_only_pair: tuple[str, str] | None = None
+    for query, expected in right_only_options:
+        try:
+            kink_id = find_kink_id(query, expected)
+        except AssertionError:
+            continue
+        if kink_id in overlap_id_set or kink_id == conflict_pair[0]:
+            continue
+        ensure_play_absent(left, kink_id)
+        save_play(right, kink_id, "love", ["together"])
+        right_only_pair = (kink_id, expected)
+        break
+    if right_only_pair is None:
+        raise AssertionError("Could not seed a right-only kink for Their List coverage")
+
+    parent_id, parent_name, scenario_a, scenario_b = find_parent_with_scenario_pair()
+    save_play(left, parent_id, "like", ["together"])
+    save_play(right, parent_id, "like", ["together"])
+    save_scenario(left, parent_id, scenario_a, "like", ["together"])
+    save_scenario(right, parent_id, scenario_a, "like", ["together"])
+    save_scenario(right, parent_id, scenario_b, "like", ["together"])
+
+    send_partner_request(right, left.user_id)
+    wait_for(
+        lambda: right.user_id in get_user(left).get("incoming_partner_requests", []),
+        label="left incoming partner request",
+    )
+    accept_partner_request(left, right.user_id)
+    wait_for(
+        lambda: right.user_id in get_user(left).get("partners", []),
+        label="linked partners",
+    )
+    group_id = group_id_for_pair(left, right.user_id)
+    toggle_share(right, group_id, True)
+    wait_for(
+        lambda: right.user_id in next((g for g in list_groups(left) if g["id"] == group_id), {}).get("sharing_member_ids", []),
+        label="right sharing toggle",
+    )
+
+    overlap_path = f"/users/{left.user_id}/partner-groups/{urllib.parse.quote(group_id)}/overlap"
+    wait_for(
+        lambda: {item.get("id") for item in get_json(overlap_path, headers=auth_headers(left)).get("direct_matches", [])} >= overlap_id_set,
+        timeout_s=45.0,
+        label="all curated overlap kinks visible in Same Plays",
+    )
+
+    overlap_payload = get_json(overlap_path, headers=auth_headers(left))
+    direct_ids = {item.get("id") for item in overlap_payload.get("direct_matches", [])}
+    missing_overlap = sorted(overlap_id_set - direct_ids)
+    if missing_overlap:
+        raise AssertionError(f"Same Plays missing curated kinks: {missing_overlap}")
+    if conflict_pair[0] in direct_ids:
+        raise AssertionError(f"Conflict (love/hard_no) kink {conflict_pair[1]!r} leaked into Same Plays")
+    scenario_match_ids = {
+        item.get("scenario_kink", {}).get("id") for item in overlap_payload.get("scenario_matches", [])
+    }
+    if scenario_a not in scenario_match_ids:
+        raise AssertionError("Shared scenario A missing from scenario_matches")
+
+    checkpoints: list[dict[str, object]] = [
+        {
+            "stage": "seed_and_overlap",
+            "expected": "both users seeded past 80 likes; curated overlap appears in Same Plays; love/hard_no conflict excluded",
+            "actual": {
+                "left_play_count": len(get_user(left).get("plays", {})),
+                "right_play_count": len(get_user(right).get("plays", {})),
+                "overlap_count_api": len(direct_ids),
+                "curated_overlap": [name for _, name in overlap_pairs],
+                "conflict_excluded": conflict_pair[1],
+                "shared_scenario": scenario_a,
+            },
+            "summary": "API overlap matches curated love/love and excludes love/hard_no conflict",
+        }
+    ]
+
+    left_context = browser.new_context(
+        viewport={"width": 1280, "height": 720},
+        extra_http_headers={"Cache-Control": "no-cache"},
+    )
+    page = left_context.new_page()
+    try:
+        login_existing_user(page, left)
+        expect(page.get_by_test_id("discover-view")).to_be_visible(timeout=15000)
+        open_together(page)
+        expect(page.get_by_test_id(f"together-group-chip-{group_id}")).to_be_visible(timeout=15000)
+        page.get_by_test_id(f"together-group-chip-{group_id}").click()
+        expect(page.get_by_test_id("together-shared-panel")).to_be_visible(timeout=15000)
+        expect(page.get_by_test_id("together-shared-direct-section")).to_be_visible(timeout=15000)
+
+        for kink_id, name in overlap_pairs:
+            expect(page.get_by_test_id(f"together-shared-direct-{kink_id}")).to_be_visible(timeout=20000)
+        if page.get_by_test_id(f"together-shared-direct-{conflict_pair[0]}").count():
+            raise AssertionError(f"Conflict chip rendered in Same Plays for {conflict_pair[1]!r}")
+        expect(page.get_by_test_id(f"together-shared-scenario-{scenario_a}")).to_be_visible(timeout=15000)
+        checkpoints.append(
+            {
+                "stage": "shared_panel_render",
+                "expected": "every curated overlap kink renders as a Same Plays chip; conflict chip absent; shared scenario chip visible",
+                "actual": {
+                    "overlap_rendered": [name for _, name in overlap_pairs],
+                    "conflict_absent": conflict_pair[1],
+                    "scenario_visible": scenario_a,
+                },
+                "summary": "Same Plays UI matches API overlap; love/hard_no conflict not shown",
+            }
+        )
+
+        focus_kink_id, focus_kink_name = overlap_pairs[0]
+        page.get_by_test_id(f"together-shared-direct-{focus_kink_id}").click()
+        expect(page.get_by_test_id("together-view")).to_be_visible(timeout=15000)
+        inline_inspector = page.get_by_test_id(f"together-shared-direct-inspector-{focus_kink_id}")
+        expect(inline_inspector).to_be_visible(timeout=15000)
+        expect(inline_inspector.locator(".plays-inspector-title")).to_have_text(focus_kink_name, timeout=15000)
+        if page.get_by_test_id("plays-view").count():
+            raise AssertionError("Same Plays chip should expand inline, not route to plays-view")
+        checkpoints.append(
+            {
+                "stage": "same_plays_click_expands_inline",
+                "expected": "clicking a Same Plays chip expands the inspector inline inside Together → Shared (no view switch)",
+                "actual": {"focused_kink_id": focus_kink_id, "focused_kink_name": focus_kink_name},
+                "summary": "Same Plays chip expanded inline with the inspector body; stayed on Together",
+            }
+        )
+
+        similar_chips = inline_inspector.locator(".chips button.chip")
+        try:
+            similar_chips.first.wait_for(state="visible", timeout=20000)
+        except Exception as exc:
+            raise AssertionError(f"No Similar chips appeared inline for {focus_kink_name!r}: {exc}") from exc
+        chip_count = similar_chips.count()
+        chip_labels = [similar_chips.nth(i).inner_text().strip() for i in range(chip_count)]
+        first_similar_label = chip_labels[0]
+
+        plays_before = set(get_user(left).get("plays", {}).keys())
+        with page.expect_response(
+            lambda res: res.request.method == "POST" and "/plays" in res.url,
+            timeout=15000,
+        ) as similar_resp:
+            similar_chips.first.click()
+        body = similar_resp.value
+        if not body.ok:
+            raise AssertionError(f"Tentative add POST /plays failed: status={body.status}")
+
+        wait_for(
+            lambda: bool(set(get_user(left).get("plays", {}).keys()) - plays_before),
+            timeout_s=15.0,
+            label="tentative add visible in user plays",
+        )
+        plays_after = get_user(left).get("plays", {})
+        new_ids = sorted(set(plays_after.keys()) - plays_before)
+        if len(new_ids) != 1:
+            raise AssertionError(f"Expected exactly one new play after similar click, got {new_ids}")
+        new_kink_id = new_ids[0]
+        new_play = plays_after[new_kink_id]
+        if new_play.get("interest_state") != "curious":
+            raise AssertionError(f"Tentative add wrong state: {new_play.get('interest_state')!r}")
+        if "together" not in (new_play.get("directions") or []):
+            raise AssertionError(f"Tentative add did not inherit parent direction 'together': {new_play.get('directions')}")
+
+        new_kink_detail = get_json(f"/kinks/{urllib.parse.quote(new_kink_id)}")
+        if new_kink_detail.get("is_scenario"):
+            raise AssertionError("Similar chip surfaced a scenario kink (visibleSimilarItems should filter is_scenario)")
+
+        # The chip is now expanded on the new kink; expect title to update inline.
+        new_inline_inspector = page.get_by_test_id(f"together-shared-direct-inspector-{new_kink_id}")
+        expect(new_inline_inspector).to_be_visible(timeout=15000)
+        expect(new_inline_inspector.locator(".plays-inspector-title")).to_have_text(
+            new_kink_detail.get("name", first_similar_label), timeout=15000
+        )
+        expect(new_inline_inspector.get_by_test_id("plays-inspector-tentative")).to_be_visible(timeout=10000)
+
+        scenario_chips = [label for label in chip_labels if label.lower().startswith("scenario:")]
+        if scenario_chips:
+            raise AssertionError(f"Similar chip set contained scenario-prefixed entries: {scenario_chips}")
+
+        checkpoints.append(
+            {
+                "stage": "shared_inline_similar_tentative_add",
+                "expected": "clicking a Similar chip on the inline Same-Plays inspector POSTs /plays as 'curious' with parent directions, re-inspects the new kink inline, and shows a Tentative badge",
+                "actual": {
+                    "parent_kink_id": focus_kink_id,
+                    "parent_kink_name": focus_kink_name,
+                    "similar_chip_count": chip_count,
+                    "tentative_kink_id": new_kink_id,
+                    "tentative_kink_name": new_kink_detail.get("name"),
+                    "tentative_state": new_play.get("interest_state"),
+                    "tentative_directions": new_play.get("directions"),
+                    "similar_is_scenario": bool(new_kink_detail.get("is_scenario")),
+                    "chip_labels_sample": chip_labels[:6],
+                },
+                "summary": "Similar-chip click tentatively saved as curious/together inline and showed the Tentative badge",
+            }
+        )
+
+        # Undo the tentative add via the new Undo button; the kink should leave the user's plays.
+        undo_btn = new_inline_inspector.get_by_test_id("plays-inspector-undo")
+        expect(undo_btn).to_be_visible(timeout=5000)
+        with page.expect_response(
+            lambda res: res.request.method == "DELETE" and f"/plays/{urllib.parse.quote(new_kink_id)}" in res.url,
+            timeout=15000,
+        ) as delete_resp:
+            undo_btn.click()
+        if not delete_resp.value.ok:
+            raise AssertionError(f"Undo DELETE /plays failed: status={delete_resp.value.status}")
+        wait_for(
+            lambda: new_kink_id not in get_user(left).get("plays", {}),
+            timeout_s=15.0,
+            label="undo removes tentative play",
+        )
+        checkpoints.append(
+            {
+                "stage": "shared_inline_undo_tentative",
+                "expected": "Undo on a tentative add removes the play row via DELETE /plays",
+                "actual": {"undone_kink_id": new_kink_id, "undone_kink_name": new_kink_detail.get("name")},
+                "summary": "Undo button removed the tentative play; user state matches pre-click",
+            }
+        )
+
+        open_together(page)
+        page.get_by_test_id("together-tab-explore").click()
+        expect(page.get_by_test_id("together-explore-panel")).to_be_visible(timeout=15000)
+        page.get_by_test_id("together-tab-theirs").click()
+        expect(page.get_by_test_id("together-their-list-panel")).to_be_visible(timeout=15000)
+        expect(page.get_by_text(right_only_pair[1])).to_be_visible(timeout=15000)
+        checkpoints.append(
+            {
+                "stage": "explore_and_theirs_render",
+                "expected": "Worth Exploring + Their List populate; right-only kink visible after sharing",
+                "actual": {"right_only_visible": right_only_pair[1]},
+                "summary": "Explore and Their List subtabs both render and surface the partner-only item",
+            }
+        )
+
+        return {
+            "summary": "adversarial couple flow: many likes, curated overlap, conflict suppression, Same-Plays inline expand, Similar tentative-add + Undo, and Worth Exploring / Their List all behaved as expected",
+            "left_user_id": left.user_id,
+            "right_user_id": right.user_id,
+            "group_id": group_id,
+            "left_play_count_final": len(plays_after),
+            "right_play_count_final": len(get_user(right).get("plays", {})),
+            "overlap_kinks": [name for _, name in overlap_pairs],
+            "conflict_kink": conflict_pair[1],
+            "right_only_kink": right_only_pair[1],
+            "shared_scenario_id": scenario_a,
+            "tentative_kink": new_kink_detail.get("name"),
+            "tentative_kink_id": new_kink_id,
+            "checkpoints": checkpoints,
+        }
+    finally:
+        left_context.close()
+
+
 SCENARIOS: dict[str, Callable[[Browser], dict[str, object]]] = {
     "onboarding": lambda browser: _run_in_fresh_context(browser, scenario_onboarding_create_button),
     "starter": lambda browser: _run_in_fresh_context(browser, scenario_starter_gate),
     "settings": lambda browser: _run_in_fresh_context(browser, scenario_settings_controls),
     "couple": scenario_couple_audit,
+    "couple_adversarial": scenario_couple_adversarial,
 }
 
 

tests/test_discover_recommendations_invariant.py

@@ -10,7 +10,7 @@ import pytest
 from fastapi.testclient import TestClient
 from sqlmodel import Session
 
-from models import Kink, KinkContentType, SimilarityEdge
+from models import Kink, KinkContentType, KinkScenarioParent, SimilarityEdge
 
 
 def _seed_large_play_catalog(session: Session, *, n_kinks: int = 80) -> None:
@@ -71,6 +71,46 @@ def test_recommend_non_empty_after_47_distinct_ratings(big_catalog_backend):
     assert out_ids.isdisjoint(rated), "recommendations must not repeat already-rated kinks"
 
 
+def _seed_scenario_under_parent(session: Session, *, parent_id: str, scenario_id: str) -> None:
+    session.add(Kink(id=parent_id, name="Parent Play", cluster="fetlife_fetish", short_definition="parent", notes="Kinksters: 1000"))
+    session.add(KinkContentType(kink_id=parent_id, content_kind="play", evidence="test"))
+    session.add(Kink(id=scenario_id, name="Parent Play scenario", cluster="fetlife_fetish", short_definition="child", notes="Kinksters: 100"))
+    session.add(KinkContentType(kink_id=scenario_id, content_kind="scenario", evidence="test"))
+    session.add(KinkScenarioParent(scenario_kink_id=scenario_id, parent_kink_id=parent_id, score=0.9, method="test"))
+    session.commit()
+
+
+def test_recommendations_and_search_exclude_scenarios(big_catalog_backend, monkeypatch: pytest.MonkeyPatch) -> None:
+    """Flat recommendations and the public search must never surface scenario kinks."""
+    b = big_catalog_backend
+    parent_id, scenario_id = "scenario_parent_1", "scenario_child_1"
+    with Session(b.engine) as session:
+        _seed_scenario_under_parent(session, parent_id=parent_id, scenario_id=scenario_id)
+    b._invalidate_catalog_cache(force=True)
+    b._catalog()
+
+    monkeypatch.setenv("KINK_STORE_PATH", str(b.path))
+    monkeypatch.setenv("KINK_HF_REQUIRE_FULL_CATALOG", "0")
+    sys.modules.pop("api", None)
+    api_mod = importlib.import_module("api")
+    api_mod._backend_impl = None
+    client = TestClient(api_mod.app)
+
+    u = client.post("/users", json={}).json()
+    uid, tok = u["id"], u["private_token"]
+    headers = {"x-private-token": tok}
+
+    rec = client.get(f"/users/{uid}/recommendations?limit=48", headers=headers)
+    assert rec.status_code == 200, rec.text
+    rec_ids = {item["kink"]["id"] for item in rec.json().get("items") or []}
+    assert scenario_id not in rec_ids, f"scenario {scenario_id!r} leaked into /recommendations"
+
+    search = client.get("/search?q=scenario&limit=20")
+    assert search.status_code == 200, search.text
+    search_ids = {item["kink"]["id"] for item in search.json().get("items") or []}
+    assert scenario_id not in search_ids, f"scenario {scenario_id!r} leaked into /search"
+
+
 def test_http_recommendations_non_empty_after_47_ratings(
     monkeypatch: pytest.MonkeyPatch,
     big_catalog_backend,

tests/test_user_snapshot.py

@@ -0,0 +1,127 @@
+"""User-state snapshot dump/restore/fingerprint round-trip tests.
+
+The Hub I/O is exercised separately (and is a no-op when KINK_USER_SNAPSHOT_REPO is unset).
+These tests stay offline: they prove the SQLite primitives (USER_TABLES preserved exactly,
+catalog tables untouched) so the deployment-time integration only needs Hub auth to land.
+"""
+from __future__ import annotations
+
+import os
+import sqlite3
+from pathlib import Path
+
+import pytest
+from sqlmodel import Session
+
+from backend.core import Backend
+from backend.user_snapshot import (
+    USER_TABLES,
+    compute_user_state_fingerprint,
+    dump_user_state,
+    restore_user_state,
+    user_state_is_empty,
+)
+from models import Kink, KinkContentType
+
+
+@pytest.fixture
+def store_path(tmp_path: Path) -> Path:
+    os.environ["KINK_SKIP_HEAVY_WARM"] = "1"
+    db = tmp_path / "snap.db"
+    b = Backend(db)
+    with Session(b.engine) as session:
+        for i in range(3):
+            kid = f"snap_kink_{i}"
+            session.add(Kink(id=kid, name=f"Snap {i}", cluster="fetlife_fetish", short_definition="t", notes="Kinksters: 5"))
+            session.add(KinkContentType(kink_id=kid, content_kind="play", evidence="test"))
+        session.commit()
+    return db
+
+
+def _table_count(db: Path, table: str) -> int:
+    conn = sqlite3.connect(f"file:{db}?mode=ro", uri=True)
+    try:
+        row = conn.execute(
+            "SELECT 1 FROM sqlite_master WHERE type='table' AND name=? LIMIT 1",
+            (table,),
+        ).fetchone()
+        if not row:
+            return -1
+        return conn.execute(f'SELECT COUNT(*) FROM "{table}"').fetchone()[0]
+    finally:
+        conn.close()
+
+
+def test_user_state_is_empty_on_fresh_store(store_path: Path) -> None:
+    assert user_state_is_empty(store_path) is True
+
+
+def test_dump_restore_roundtrip_preserves_users_and_plays(store_path: Path, tmp_path: Path) -> None:
+    """Dump after writes restores the same rows on a fresh store; catalog rows untouched."""
+    b = Backend(store_path)
+    user = b.create_user()
+    b.save_play_preference(user.id, "snap_kink_0", "like", ["together"])
+    b.save_play_preference(user.id, "snap_kink_1", "love", ["to_me"])
+
+    out = tmp_path / "snap_out.db"
+    counts = dump_user_state(store_path, out)
+    assert counts.get("user", 0) == 1
+    assert counts.get("playpreference", 0) == 2
+
+    fresh = tmp_path / "fresh.db"
+    Backend(fresh)
+    with Session(Backend(fresh).engine) as session:
+        session.add(Kink(id="snap_kink_0", name="Snap 0", cluster="fetlife_fetish", short_definition="t", notes="Kinksters: 5"))
+        session.add(Kink(id="snap_kink_1", name="Snap 1", cluster="fetlife_fetish", short_definition="t", notes="Kinksters: 5"))
+        session.add(KinkContentType(kink_id="snap_kink_0", content_kind="play", evidence="test"))
+        session.add(KinkContentType(kink_id="snap_kink_1", content_kind="play", evidence="test"))
+        session.commit()
+
+    assert user_state_is_empty(fresh) is True
+    catalog_kinks_before = _table_count(fresh, "kink")
+
+    restored = restore_user_state(fresh, out)
+    assert restored.get("user", 0) == 1
+    assert restored.get("playpreference", 0) == 2
+    assert _table_count(fresh, "user") == 1
+    assert _table_count(fresh, "playpreference") == 2
+    assert _table_count(fresh, "kink") == catalog_kinks_before
+
+
+def test_fingerprint_changes_when_user_row_added(store_path: Path) -> None:
+    b = Backend(store_path)
+    fp_before = compute_user_state_fingerprint(store_path)
+    user = b.create_user()
+    b.save_play_preference(user.id, "snap_kink_0", "like", ["together"])
+    fp_after = compute_user_state_fingerprint(store_path)
+    assert fp_before != fp_after
+
+
+def test_dump_excludes_catalog_tables(store_path: Path, tmp_path: Path) -> None:
+    """USER_TABLES must contain no catalog table names — guards against accidentally shipping the catalog."""
+    catalog_tables = {"kink", "kinkalias", "kinkasset", "similarityedge", "kinkscenarioparent", "fetlifeuserfetish"}
+    assert catalog_tables.isdisjoint(set(USER_TABLES))
+
+    out = tmp_path / "snap_only.db"
+    dump_user_state(store_path, out)
+    snap_tables = set()
+    conn = sqlite3.connect(out)
+    try:
+        snap_tables = {row[0] for row in conn.execute("SELECT name FROM sqlite_master WHERE type='table'")}
+    finally:
+        conn.close()
+    assert snap_tables.isdisjoint(catalog_tables), f"snapshot leaked catalog tables: {snap_tables & catalog_tables}"
+
+
+def test_restore_is_upsert_not_destructive(store_path: Path, tmp_path: Path) -> None:
+    """A second restore on top of existing rows replaces matching PKs without erroring on duplicates."""
+    b = Backend(store_path)
+    user = b.create_user()
+    b.save_play_preference(user.id, "snap_kink_0", "like", ["together"])
+    out = tmp_path / "snap_out.db"
+    dump_user_state(store_path, out)
+    # Restore on top of itself (no-op for content; checks INSERT OR REPLACE accepts duplicate PKs).
+    counts = restore_user_state(store_path, out)
+    assert counts.get("user", 0) >= 1
+    assert _table_count(store_path, "user") == 1
+    assert _table_count(store_path, "playpreference") == 1