[Foundry P2] pf2e npc_to_actor + "Send to Foundry" on NPC generation

rbrooks commented

2026-06-23 00:42:34 +00:00

Owner

Push Quest Board-generated NPCs into Foundry.

Scope

Extend the pf2e adapter with npc_to_actor(generated_npc).
Add a "Send to Foundry" button on the NPC generation UI.
POST the generated stat block to Foundry's actor directory via the REST API.
Button is hidden when the active campaign's adapter returns None for npc_to_actor.

Done when

A GM can push a generated PF2e NPC into the connected Foundry world's actor directory in one click.

Roadmap: Phase 2 steps 7-9. Depends on Phase 1 (#adapter scaffolding, settings, health check).

Push Quest Board-generated NPCs into Foundry. ## Scope - Extend the `pf2e` adapter with `npc_to_actor(generated_npc)`. - Add a **"Send to Foundry"** button on the NPC generation UI. - POST the generated stat block to Foundry's actor directory via the REST API. - Button is hidden when the active campaign's adapter returns `None` for `npc_to_actor`. ## Done when - A GM can push a generated PF2e NPC into the connected Foundry world's actor directory in one click. _Roadmap: Phase 2 steps 7-9. Depends on Phase 1 (#adapter scaffolding, settings, health check)._

rbrooks added this to the (deleted) milestone

2026-06-23 00:42:34 +00:00

rbrooks added the

frontend

backend

enhancement

labels

2026-06-23 00:42:34 +00:00

rbrooks referenced this issue

2026-06-24 04:21:51 +00:00

[Foundry] Bidirectional integration — architecture & design reference #24

claude-bot referenced this issue

2026-07-15 22:02:49 +00:00

[Foundry] foundry_links document-mapping table for idempotent push #146

claude-bot referenced this issue

2026-07-15 22:03:08 +00:00

[Foundry] Map structured stat blocks (sidebar_fields, #130) into npc_to_actor #148

claude-bot referenced this issue

2026-07-15 22:03:23 +00:00

[Foundry] Token image on pushed actors #150

claude-bot referenced this issue

2026-07-15 22:03:27 +00:00

[Game Systems] Foundry alignment: one system identity + structured npc_to_actor #151

claude-bot referenced this issue

2026-07-15 22:03:41 +00:00

[Foundry] "Send to live scene": place pushed NPC token into the active scene #152

claude-bot referenced this issue

2026-07-15 22:03:55 +00:00

[Foundry] Live-push UX on WikiArticle & CampaignPlanning #154

claude-bot referenced this issue

2026-07-15 22:04:10 +00:00

[Foundry] "Push update" for already-linked NPCs #156

claude-bot referenced this issue

2026-09-15 18:21:01 +00:00

[UX] Redesign coverage: where every shipped and planned feature lives in Design A #656

claude-bot modified the milestone from (deleted) to v5.0.0 - Foundry: Connect & Push

2026-10-27 17:53:49 +00:00

claude-bot referenced this issue

2026-11-07 15:54:27 +00:00

[Foundry] Decide & document connection topology: self-hosted relay vs direct URL, and the SSRF/URL-policy exemption #143

rbrooks referenced this issue from a commit

2026-11-08 20:47:16 +00:00

docs: the Foundry push's build contract (#9, #146, #7)

claude-bot commented

2026-11-08 20:48:43 +00:00

Collaborator

Picked up as Foundry slice 2, "Push" (2026-11-08). The contract is docs/design/foundry-push.md on feat/9-foundry-push, over slice 1 (#5, #6, PR #1368).

It covers #9, #146 (links), #7 (adapters, keyed by the campaign's one game system, #151) and #148 (sidebar rows), plus:

the D335 queue: Postgres, claimed atomically by the holder, a Redis DB 0 nudge, a heartbeat drain, requeue on close, failed after 5 tries, expiry;
applied-once through actor flags;
the D342 whispers;
"N waiting" on Settings → Foundry.

Found while scoping:

Conjure's NPCs have no stats (name, occupation, want, secret, voice).
The importer drops a creature's embedded items (attacks and spells).
pf2e schema_v1 has no saves or skills.

That's why there are three questions for the owner: Q251 (where the button goes), Q252 (rules-library creatures; the recommendation is the world's own compendium first) and Q253 (how long a send waits; 14 days recommended). The backend and the module are being built now in a way that suits any answer.

**Picked up as Foundry slice 2, "Push" (2026-11-08).** The contract is `docs/design/foundry-push.md` on `feat/9-foundry-push`, over slice 1 (#5, #6, PR #1368). It covers #9, #146 (links), #7 (adapters, keyed by the campaign's one game system, #151) and #148 (sidebar rows), plus: - the D335 queue: Postgres, claimed atomically by the holder, a Redis DB 0 nudge, a heartbeat drain, requeue on close, failed after 5 tries, expiry; - applied-once through actor flags; - the D342 whispers; - "N waiting" on Settings → Foundry. **Found while scoping:** - Conjure's NPCs have no stats (name, occupation, want, secret, voice). - The importer drops a creature's embedded items (attacks and spells). - pf2e `schema_v1` has no saves or skills. That's why there are three questions for the owner: Q251 (where the button goes), Q252 (rules-library creatures; the recommendation is the world's own compendium first) and Q253 (how long a send waits; 14 days recommended). The backend and the module are being built now in a way that suits any answer.

rbrooks referenced this issue from a commit

2026-11-08 20:52:10 +00:00

feat(foundry): module applies push commands, sends events, whispers GMs (#9, D342)

rbrooks referenced this issue from a commit

2026-11-08 20:55:18 +00:00

fix(foundry): create applies an allowlist, not the whole document (#9)

rbrooks referenced this issue from a commit

2026-11-08 21:37:08 +00:00

feat(webapp): Foundry push backend: queue, delivery, links and the pf2e adapter (#9, #146, #7, #148, #151)

rbrooks referenced this issue from a commit

2026-11-08 21:50:33 +00:00

fix(webapp): a pushed page sends only the table's text in public, the :::gm blocks in private (#9)

rbrooks referenced this issue from a commit

2026-11-08 22:13:30 +00:00

fix(webapp): claims for a campaign are serialised, so the in-flight cap holds (#9)

claude-bot referenced this issue

2026-11-08 23:31:29 +00:00

WIP: Foundry slice 2, send to Foundry (#9, #146, #7, #148, #151) #1369

rbrooks referenced this issue from a commit

2026-11-09 17:06:13 +00:00

docs: D343-D345, where Send to Foundry goes, rules-library creatures, and the 14-day wait (#9)

claude-bot commented

2026-11-09 17:07:06 +00:00

Collaborator

Owner's answers (2026-11-09), recorded as D343–D345, all as recommended:

Where the button goes: Send to Foundry goes on a conjured NPC (name and notes) and on an NPC's wiki page (stat block); a rules-library creature gets it too. The split button and live scene stay v5.1.
Rules-library creatures: the world's own pf2e compendium first; otherwise our copy without attacks, saying so.
Waiting: a send waits 14 days, then fails with the reason and can be sent again.

The backend (#1369, CI green) already does D344 and D345. The buttons and "N waiting" are being built now. Their wording, with the seven whispers, is on the Wording Review page as part "ad" (23 rows).

**Owner's answers (2026-11-09), recorded as D343–D345, all as recommended:** - **Where the button goes:** Send to Foundry goes on a conjured NPC (name and notes) and on an NPC's wiki page (stat block); a rules-library creature gets it too. The split button and live scene stay v5.1. - **Rules-library creatures:** the world's own pf2e compendium first; otherwise our copy without attacks, saying so. - **Waiting:** a send waits 14 days, then fails with the reason and can be sent again. The backend (#1369, CI green) already does D344 and D345. The buttons and "N waiting" are being built now. Their wording, with the seven whispers, is on the Wording Review page as part "ad" (23 rows).

rbrooks referenced this issue from a commit

2026-11-09 17:44:09 +00:00

feat(webapp): Send to Foundry button, and what is waiting in Settings → Foundry (#9)

rbrooks referenced this issue from a commit

2026-11-09 17:44:09 +00:00

fix(webapp): Send to Foundry tests without userEvent on a fake clock; the waiting list reads in an effect (#9)

rbrooks referenced this issue from a commit

2026-11-09 17:51:46 +00:00

fix(webapp): Send to Foundry shows only when the server says it can send, and sidebar rows go by an allowlist (#9)

rbrooks referenced this issue from a commit

2026-11-09 18:17:29 +00:00

fix(webapp): Send to Foundry's accessible name starts with what it shows (#9)

claude-bot commented

2026-11-09 18:18:18 +00:00

Collaborator

Send to Foundry UI built and checked (2026-11-09), on #1369:

Placements (D343): the button is on a conjured NPC (Prep drawer), an NPC or creature wiki page and a rules-library creature. Settings → Foundry has the waiting list with Cancel, plus failure, expired and mismatch lines.
can_send: the status now carries it (paired, an adapter for the campaign's game system, and no mismatch), so the button never shows when a send can't work.
Security review: sidebar rows go by an allowlist (only the table's in public, only the GMs' in GM notes). Page text was fixed earlier: the table's text in public, :::gm blocks in private, players' blocks never sent.
Render check: 36 shots, no console errors, no overflow at 390. The one axe finding, label-content-name-mismatch, is fixed: the names now start with the visible label.
Wording: part "ad" (25 rows) is all approved by the owner, and the code matches.

Left before merge: a live push to foundry-dev with the owner (after the first pairing, #5), and v4.8.0 final.

**Send to Foundry UI built and checked (2026-11-09), on #1369:** - **Placements (D343):** the button is on a conjured NPC (Prep drawer), an NPC or creature wiki page and a rules-library creature. Settings → Foundry has the waiting list with Cancel, plus failure, expired and mismatch lines. - **`can_send`:** the status now carries it (paired, an adapter for the campaign's game system, and no mismatch), so the button never shows when a send can't work. - **Security review:** sidebar rows go by an allowlist (only the table's in public, only the GMs' in GM notes). Page text was fixed earlier: the table's text in public, `:::gm` blocks in private, players' blocks never sent. - **Render check:** 36 shots, no console errors, no overflow at 390. The one axe finding, label-content-name-mismatch, is fixed: the names now start with the visible label. - **Wording:** part "ad" (25 rows) is all approved by the owner, and the code matches. **Left before merge:** a live push to foundry-dev with the owner (after the first pairing, #5), and v4.8.0 final.

rbrooks referenced this issue from a commit

2026-11-09 23:11:16 +00:00

fix(foundry): HP on update, speed notes, pairing messages, one-line indicator (#9)

Rows
Columns

[Foundry P2] pf2e npc_to_actor + "Send to Foundry" on NPC generation #9

Scope

Done when