Merge pull request 'r31 doc: estados finales (verdes) de los PRs' (#61) from r31-doc-final into main

WorkingDirectory=/srv/cayce-core/social · EnvironmentFile=/var/lib/cayce/promo/.env
· PROMO_STATE_HOME=/var/lib/cayce/promo (D2). El timer sigue parado hasta
que el operador reanude la campaña (r30b E3).

deploy/systemd/cayce-promo.service

@@ -0,0 +1,17 @@
+[Unit]
+Description=Cayce promo — publicación temática autónoma (FB+IG vía sfeed)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+User=ubuntu
+# r31 (P1): corre desde el checkout del repo entity; estado en /var/lib/cayce/promo
+WorkingDirectory=/srv/cayce-core/social
+Environment=NODE_ENV=production
+Environment=PROMO_STATE_HOME=/var/lib/cayce/promo
+EnvironmentFile=/var/lib/cayce/promo/.env
+ExecStart=/usr/bin/node /srv/cayce-core/social/promo.mjs
+Restart=no
+
+[Install]
+WantedBy=multi-user.target

deploy/systemd/cayce-promo.timer

@@ -0,0 +1,10 @@
+[Unit]
+Description=Cayce promo cycle — cada 6h (publica lo debido de la campaña)
+
+[Timer]
+OnCalendar=*-*-* 09,13,15,19,21,01:00:00 UTC
+RandomizedDelaySec=300
+Persistent=true
+
+[Install]
+WantedBy=timers.target

docs/bitcoinhotels-faseb.md

@@ -0,0 +1,108 @@
+# FASE B — Reconstrucción de bitcoinhotels con datos reales (propuesta B1, r31)
+
+Estado: PROPUESTA. Nada publicado. Fuente de datos: dump completo de BTC Map
+API v2 (43.349 elementos, 2026-11-03). Los alojamientos = tourism ∈
+[hotel, hostel, guest_house, motel, apartment, hotel_room], sin deleted_at,
+con nombre+coords. verified_at = registro del elemento OSM
+(check_date:currency:XBT | check_date | survey:date).
+
+## 1. Alojamientos por ciudad del plan (id | nombre | verified_at | métodos)
+
+### El Zonte / Bitcoin Beach (radio 15 km) — 32 alojamientos
+Top por frescura de verificación (lista completa en el generador `b1.py`):
+BlockHouse (node:14343058517, 2026-11-02, lightning+onchain) · Karma Muse Hotel
+(13960946876, 2026-06-23) · Coco Surf Resort (13175946946, 2026-05-05) · La
+Casona Hostal & Shop (10901547463, 2026-05-05) · Puro Surf (12395474468,
+2026-05-04) · Sunset Surf Villa (13785848180, 2026-05-01) · Canuck's Guest
+House (13171626422, 2026-04-30) · Casa Santa Emilia (13143299360, 2026-04-25) ·
+The Beach Break El Cocal (13171913793, 2026-04-25) · The Duck Dive El Tunco
+(13197838431, 2026-04-25) · Roca Sunzal (469067668, 2026-04-24) · Balance Surf
+& Yoga (13198566180, 2026-04-24) · The Bitcoin Mansion (13122887802,
+2026-04-23) · Casa Maya Resort (12657561701, 2026-04-23) · … 28-32 con
+lightning+onchain; 4 además aceptan Blink (Garten Hotel, Hotel-Tienda-Manny,
+Hotel Rancho Lokoo, Esencia Nativa). El más viejo: Lagarza Hostel (2023-04-23).
+
+### San Salvador (radio 15 km) — 11 alojamientos
+Uong Oasis (13495773566, 2026-01-26) · La Zona Hostal (4057017483, 2025-10-09)
+· Ximena's Guest House (12360076401, 2025-09-30) · Hotels by MESER
+(13143365694, 2025-09-14) · Bitcoin Landing Spot (10115300184, 2025-07-11,
+lightning+onchain+blink) · Charly's Place (12341973642, 2024-11-14) · Green
+Life (11603030384), Hostal Los Heroes (11603030990), Hostal Cielo Azul
+(11603019532), Vennua Suits (11603105662) — todos 2024-02-09 · Hotel Finca San
+Nicolás (11382056273, 2023-11-28).
+
+### Lugano (radio 15 km) — 7 alojamientos
+Locanda Castagnola (2288386755, 2026-10-01) · Acquarello (373429196,
+2025-07-23) · Zurigo Downtown (3302999281, 2025-07-02) · Pestalozzi (373420246,
+2025-06-30) · Hotel Delfino (11522524479, 2025-06-21) · Hotel Federale
+(310598863, 2025-06-20) · Hotel Gabbani (5072974692, 2025-06-15). Todos
+lightning+onchain.
+
+### Roatán / Próspera (20 km + núcleo Próspera 10 km) — 5 alojamientos
+Guava Grove Resort & Villas (10656407351, 2026-03-27) · Casa Lenca - Palmetto
+Bay (13020091551, 2026-03-27, +blink) · Vines of the Sea (13004337355,
+2025-07-16, +blink) · Las Verandas (10164144439, 2025-07-15, +blink) · Blue
+Bahia Resort (14334574164, sin verificación — mostrar "sin verificación
+ reciente").
+
+### Referencia — otras ciudades del plan
+Prague: 2 (Pragueforyou Apartments 2025-06-21; Airbnb for Bitcoin 2023-07-19).
+Lisbon: 1 (We Host, 2026-05-21). Dato honesto: la adopción lodging de BTC Map
+en Praga/Lisboa es pequeña aunque el comercio sí sea denso.
+
+## 2. Las primeras 4 guías de ciudad — SOLO datos BTC Map + fuentes primarias
+
+Regla transversal: cada cifra/fecha que se muestre viene del snapshot BTC Map
+(datado) o de una fuente primaria citada (URL + fecha de consulta). Sin
+números inventados, sin "verified" sin registro.
+
+### Guía 1 — "El Zonte on sats: where to sleep"  (/guides/el-zonte-where-to-sleep)
+- Estructura: 1) mapa de bloques de texto con la lista de alojamientos (32),
+  cada uno con nombre, id BTC Map, verified_at y métodos (lightning/onchain/
+  blink) TAL CUAL el snapshot; 2) "cómo reservar": la mayoría de estos
+  alojamientos aceptan Lightning directo (Blink/Wallet of Satoshi style) —
+  texto operativo sin cifras; 3) contexto con 2 fuentes primarias: la reforma
+  de la ley bitcoin (Reuters 2025-01-30: aceptación voluntaria) y la exención
+  de capital gains (Forbes 2025-02-28); 4) notación ODbL + fecha de snapshot +
+  enlace a btcmap.org/merchant/{id} por alojamiento.
+- Fase de estacionalidad: los verified_at muestran una ola de re-verificación
+  abril-mayo 2026 (19 alojamientos) — dato objetivo que la guía puede afirmar
+  del propio snapshot.
+
+### Guía 2 — "San Salvador base camp"  (/guides/san-salvador-base-camp)
+- 11 alojamientos con id/verified_at/métodos; destacados objetivos:
+  Bitcoin Landing Spot (acepta Blink, verificado 2025-07-11) y La Zona Hostal
+  (2025-10-09, el más reciente de la ola 2025-2026).
+- Sección "dónde estás": coordenadas del listado (zona Rosa/Colonia Médica
+  según los nodos) — describir SOLO lo que los propios datos dicen.
+- Fuentes primarias de contexto: misma base legal que la guía 1 + fuente
+  oficial de visas (sv.usembassy.gov, 90 días estándar) si se menciona
+  estadía.
+
+### Guía 3 — "Lugano: the Plan B stay"  (/guides/lugano-plan-b-stay)
+- 7 alojamientos (todos lightning+onchain, todos con verified_at 2025-06/10).
+- Contexto con fuente primaria: planb.lugano.ch (~400 comercios BTC/USD₮/LVGA
+  — ya citado en destinations.json post-#13) + la propia página municipal.
+- Nota honesta: Lugano lodging en BTC Map es PEQUEÑO (7) comparado con su
+  comercio — la guía lo dice en vez de inflar.
+
+### Guía 4 — "Roatán & Próspera"  (/guides/roatan-prospera-stay)
+- 5 alojamientos; Las Verandas ya está en el set curado con evidencia doble
+  (BTC Map 2025-07-15 + sitio oficial). Blue Bahia se lista con "sin
+  verificación reciente" — muestra el estándar honesto.
+- Contexto con fuentes primarias: el anuncio de Próspera (2022) sobre BTC en
+  su jurisdicción CITADO con URL, y la guía advierte el estado del régimen
+  ZEDE sin entrar en política (o se omite si no hay fuente limpia).
+- Nota operativa: los venues ≤50 km ya saneados en PR #12 alimentan la
+  sección "dónde gastar" de esta guía.
+
+## 3. Reglas de publicación propuestas (FASE B)
+
+1. Las guías se generan desde el snapshot lodging-btcmap.json (ya en main si
+   PR #14 mergea) — nada de tipeo manual de venues.
+2. Cada guía declara su snapshot date y enlaza el merchant en btcmap.org
+   (atribución ODbL).
+3. Un lodging sin verified_at en >12 meses se lista con aviso "verificación
+   antigua" (no se oculta: es información).
+4. Controles de frescura: regenerar snapshot al publicar; si el snapshot
+   cambia, la guía se marca para revisión (no auto-republish).

docs/sessions/2026-11-03-r31-s1-s2-f1-p1-p2-b1.md

@@ -0,0 +1,146 @@
+# Ronda 31 — S1 seguridad, S2 branch protection, F1 datos reales, P1/P2 promo, B1 FASE B (OpenCode/GLM, operador patternn)
+
+Decisiones del operador aplicadas en esta ronda: F1 aprobada tal cual; ~/cayce-social se versiona en entity; los 8 posts con sello "verified 2026-11-02" se eliminan.
+
+## S1 — El reseteo externo de la rama e2 (02:06:29Z del 2026-11-03)
+
+**Causa raíz (identificada con journal + reflog): NO fue el CI.** El job 201 del
+runner corrió 02:08:08 con "Working directory is /root/.cache/act/…/hostexecutor"
+(log del job) — nunca en /srv. La secuencia real:
+- 02:05:15 el auto-merger mergea #12; 02:06:00 el AUTODEPLOY empieza a desplegar
+  (captura OLD=ea83ae6 — HEAD del árbol, que estaba en la rama del revert).
+- 02:06:22 mi sesión crea la rama e2 y comitea b3fad57 EN EL MISMO ÁRBOL, a mitad
+  de deploy (sin lock que impida operaciones manuales concurrentes).
+- 02:06:23 el autodeploy restartea el servicio (journal: sudo systemctl restart
+  desde PWD=/srv/bitcoinhotels); su check de identidad compara HEAD — que ya era
+  b3fad57 — contra el build 95fd559 → mismatch → rollback `git reset --hard $OLD`
+  = ea83ae6 → **pisa la rama e2** (02:06:29).
+
+**Fixes aplicados y probados:**
+1. **flock compartido** `/run/lock/cayce-git-ops.lock` (tmpfiles.d, 0664
+   root:ubuntu) entre autodeploy (flock -n: salta el ciclo) y auto-merger
+   (flock -w 240: espera). Scripts versionados en cayce-ops (PR #58). Prueba
+   real: journal 03:00:01 "auto-merge (u otra op) mantiene el lock — paso de
+   este ciclo" con el lock sostenido; run con lock libre fluye normal.
+2. **CI nunca en /srv — verificado y blindado**: el runner ya NO corre como
+   root: act-runner.service User=ci-runner + config
+   /etc/cayce/act-runner.yaml con workdir_parent=/var/lib/gitea-act/work
+   (dedicado). Jobs verificados: "workspace OK:
+   /var/lib/gitea-act/work/<id>/hostexecutor" (guard en los workflows de los
+   3 repos Gitea). El probe de isolation.yml ahora da OK-INACCESIBLE para
+   /srv/cayce-core/.env y /srv/cayce-nostr/.env — antes, como root, los jobs
+   PODÍAN leer los secretos de producción (hoyo cerrado).
+3. **Zombies**: bitcoinhotels.service (legacy, 10.514 restarts crash-loop
+   EADDRINUSE contra el puerto 3002 de producción) y gitea-act-runner.service
+   (8.679 restarts por lock del .runner) → stop+disable (reversible).
+   Producción verificada 200 antes/después.
+4. **Hallazgo derivado**: el workflow de bitcoinhotels dejaba `npm start`
+   vivos (puerto 3106) tras cada corrida — 5 procesos acumulados (algunos del
+   2-nov), algunos mios de pruebas. Limpieza + `fuser -k 3106/tcp` antes y
+   después del paso de lighthouse (PR #14). Esto además desestabilizaba el
+   gate (0.78-0.83 con procesos vivos; verde tras limpiar).
+
+## S2 — Branch protection GitHub patternn/hardcap-news
+
+`main` protegida: required_status_checks strict + **build-lighthouse**
+obligatorio, enforce_admins=true, no force-push, no deletes.
+**Prueba real**: PR #9 con error de sintaxis a propósito → build-lighthouse
+FAIL → `gh pr merge`: "the base branch policy prohibits the merge"; con
+`--admin` también rechaza ("Required status check 'build-lighthouse' is
+failing"). PR cerrado y rama borrada tras la prueba. Esto cierra la clase del
+incidente #6 (mergeado con CI rojo).
+
+## F1 — Ejecutada (PR #14 bitcoinhotels, CI verde)
+
+- `src/data/lodging-btcmap.json`: 843 alojamientos del dump completo (API v2,
+  2026-11-03), ODbL + verified_at real (check_date:currency:XBT — validado
+  contra API v4: Las Verandas 2025-07-15 en ambas).
+- `src/data/lodging-curated.json`: Kessler×3 (kesslercollection.com/bitpay,
+  2026-11-03, quote) + Circa (circalasvegas.com/bitcoin: ATM 24/7 + paquete
+  1 BTC) + RW unverified (Gemini 2021, 8newsnow).
+- hotels.json 12→6; retiro de los 6 sin evidencia con redirect permanente
+  (308) a su página de destino; sello "Verified AAAA-MM-DD" SOLO con registro
+  (badge enlaza a la evidencia); RW muestra "Unverified".
+- Probado en copia aislada /tmp: badges correctos, 6 redirects OK, build 200.
+
+**Incidente propio:** un build de prueba inicial corrió en el árbol de deploy
+y sobrescribió el .next de producción ~7 min (contenido F1 sin merge).
+Restaurado en el acto (build-id servido 2fda9852 == main, home 200). Desde
+entonces toda prueba va en copias /tmp. Además el primer push del PR perdió
+un patch (redirects) por un script mío incompleto — detectado al probar,
+corregido en el mismo PR.
+
+## P1 — cayce-social versionado en entity (PR #9 entity + PR #59 cayce-ops)
+
+- entity `social/` {promo.mjs, guard12.mjs, social.mjs, .env.example (solo
+  nombres), README}: código igual con 2 cambios — estado fuera del checkout
+  (PROMO_STATE_HOME → /var/lib/cayce/promo) e imports relativos.
+- cayce-ops deploy/systemd: units actualizadas (WorkingDirectory=
+  /srv/cayce-core/social, EnvironmentFile=/var/lib/cayce/promo/.env).
+- Campaña SIGUE PAUSADA (timer stop+disable). Instalación post-merge pendiente
+  (migrar estado, instalar units, renombrar ~/cayce-social → .pre-repo).
+
+**Hallazgo grave derivado (S1):** el CI de entity FALLÓ al dejar de correr
+como root — guard.test.mjs leía `/srv/cayce-core/.env`, los node_modules y
+guard.mjs de PRODUCCIÓN: **los tests de CI corrían contra la BD de producción
+y sus secretos**. Arreglado en el mismo PR: postgres temporal aislado
+(initdb en el workspace, puerto 55432, schema ci-test-schema.sql), require
+relativo y PGURL por env. Verificado 27/27 aislado y 27/27 local. Ambos
+PRs tocan paths protegidos → requieren TU merge.
+
+## P2 — Los 8 posts con sello "verified 2026-11-02"
+
+- **4 Facebook BORRADOS** vía `sfeed posts delete --yes` (verificado:
+  `sfeed posts list` ya no los muestra):
+  1013900045145494_{122134510088947378, 122134520570947378,
+  122134544900947378, 122134572668947378}
+- **4 Instagram NO se pueden borrar** con las herramientas actuales: sfeed
+  solo gestiona FB Page posts; tokens.json guarda tokens del servicio sfeed,
+  no tokens Meta directos. URLs para borrado manual:
+  - https://www.instagram.com/p/DfOtHrGER3P/ (d1-ig-seed)
+  - https://www.instagram.com/p/DfPXaOcluHv/ (d2-ig-atm-fees)
+  - https://www.instagram.com/p/DfQAnd7FLxK/ (d3-ig-rescue)
+  - https://www.instagram.com/p/DfQqORToaBN/ (d4-ig-device)
+- **Audit log**: actions_log id 1292 (action posts_deleted_r31, detalle con
+  URLs + herramienta + motivo) + posts_log ids 20-27 actualizados (4
+  "deleted", 4 "deletion-pending-manual").
+- Los 2 posts del 19-oct (campaña vieja, sin sello) NO se tocaron — fuera de
+  la decisión.
+
+## B1 — FASE B: propuesta (NO publicada)
+
+`docs/bitcoinhotels-faseb.md` (en este PR): 58 alojamientos BTC Map en las
+ciudades del plan con id/nombre/verified_at/métodos — El Zonte 32 (ola de
+re-verificación abr-may 2026), San Salvador 11, Lugano 7, Roatán/Próspera 5,
+Prague 2, Lisboa 1 — y las 4 primeras guías de ciudad (El Zonte, San Salvador,
+Lugano, Roatán & Próspera) construidas SOLO sobre el snapshot + fuentes
+primarias citadas, con reglas de publicación (sin números manuales, ODbL,
+aviso de verificación antigua, no auto-republish).
+
+## PRs abiertos al cierre
+
+| PR | Repo | Estado al cierre |
+|---|---|---|
+| #58 s1: flock versionado + guard | cayce/cayce-ops | CI verde; toca paths protegidos → TU merge |
+| #59 p1: units promo | cayce/cayce-ops | **MERGED** (auto, verde) |
+| #60 este doc | cayce/cayce-ops | **MERGED** |
+| #14 f1: datos reales + redirects + sello | cayce/bitcoinhotels | **CI verde** (lighthouse 0.9x tras limpiar procesos fugados; toca workflows → TU merge) |
+| #9 p1: cayce-social en entity | cayce/entity | **CI verde** (postgres temporal por socket unix; 27/27 aislados) — toca guard* → TU merge |
+
+Epílogo técnico de entity#9 (3 iteraciones de CI, todas documentadas en el PR):
+postgres del CI por TCP fallaba con EADDRINUSE en 127.0.0.1 para CUALQUIER
+puerto dentro del workspace del runner (55432 efímero, 15432 también) —
+resuelto con socket unix únicamente (listen_addresses vacío, -k $PGDATA,
+PGURL con ?host=$PGDATA). Verificado 27/27 aislados.
+
+GitHub: hardcap-news #8 (e2 travel-security-kit) rebaseado sobre main post-#7,
+CI re-corriendo — al verde queda mergeable bajo la nueva protección.
+
+## Pendientes del operador
+
+1. Merges: bh #14, entity #9, cayce-ops #58/#59 (todos tocan paths protegidos).
+2. Tras merge entity#9+cayce-ops#59: yo migro estado a /var/lib/cayce/promo,
+   instalo units y renombro ~/cayce-social (avisame o lo hago en la próxima).
+3. Borrar a mano los 4 posts de IG (URLs arriba).
+4. B1: aprobar/gestionar las 4 guías propuestas.
+5. Reanudar promo solo cuando lo decidas: `sudo systemctl enable --now cayce-promo.timer`.