pf2e-subsystems 0.1.0

package/dist/manifest.webmanifest

@@ -0,0 +1,13 @@
+{
+  "name": "PF2e Subsystems",
+  "short_name": "PF2e Subsystems",
+  "description": "Run Pathfinder 2e's Victory Point subsystems at the table: chases, infiltrations, influence encounters and research.",
+  "start_url": ".",
+  "scope": ".",
+  "display": "standalone",
+  "background_color": "#14161b",
+  "theme_color": "#14161b",
+  "icons": [
+    { "src": "icon.svg", "sizes": "any", "type": "image/svg+xml", "purpose": "any maskable" }
+  ]
+}

package/dist/sw.js

@@ -0,0 +1,60 @@
+/* Service worker — offline support for the hosted (GitHub Pages) PWA.
+   Network-first for the app page (fresh when online, cached when offline),
+   cache-first for static assets. Cache version is stamped at build time so a
+   redeploy refreshes clients automatically. */
+const CACHE = "pf2e-subsystems-20260914005114";
+/* Every cache this app has ever made starts with PREFIX. The sweep below is
+   scoped to it on purpose: the PF2e tools share an origin when they are
+   served from one host (GitHub Pages does it, and so does the toolbox), and an
+   unscoped sweep would delete the other two apps' offline caches every time
+   this one activated. */
+const PREFIX = "pf2e-subsystems-";
+const SHELL = ["./", "./index.html", "./manifest.webmanifest", "./icon.svg"];
+
+self.addEventListener("install", (e) => {
+  e.waitUntil(
+    caches.open(CACHE)
+      .then((c) => c.addAll(SHELL).catch(() => {}))
+      .then(() => self.skipWaiting())
+  );
+});
+
+self.addEventListener("activate", (e) => {
+  e.waitUntil(
+    caches.keys()
+      .then((keys) => Promise.all(keys.filter((k) => k.startsWith(PREFIX) && k !== CACHE)
+        .map((k) => caches.delete(k))))
+      .then(() => self.clients.claim())
+  );
+});
+
+self.addEventListener("fetch", (e) => {
+  const req = e.request;
+  if (req.method !== "GET") return;
+
+  if (req.mode === "navigate") {
+    e.respondWith(
+      fetch(req)
+        .then((res) => {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put("./index.html", copy));
+          return res;
+        })
+        .catch(() => caches.match("./index.html").then((r) => r || caches.match("./")))
+    );
+    return;
+  }
+
+  e.respondWith(
+    caches.match(req).then((r) =>
+      r ||
+      fetch(req).then((res) => {
+        if (res.ok && new URL(req.url).origin === self.location.origin) {
+          const copy = res.clone();
+          caches.open(CACHE).then((c) => c.put(req, copy));
+        }
+        return res;
+      }).catch(() => r)
+    )
+  );
+});

package/notice.md

@@ -0,0 +1,132 @@
+# Third-Party Notices & Attribution
+
+**pf2e-subsystems**
+
+This file records the licensing of the two distinct kinds of material in this
+package: the application **code**, and the Pathfinder **rules text** it bundles
+(the GM Core subsystems chapter, plus condition and action descriptions). They
+are covered by different licenses and the distinction below is intentional.
+
+---
+
+## 1. Application code
+
+All original source code in this package is released under the **MIT License**.
+See the [`LICENSE`](./LICENSE) file for the full text.
+
+```
+Copyright (c) 2026 Whyte Erminae
+```
+
+The MIT License covers only the code authored for this project. It does **not**
+cover the Pathfinder game content described in section 2, which carries its own
+license and notice. The encounters a GM builds in this app are their own; the app
+stores them in the GM's browser and transmits them nowhere.
+
+---
+
+## 2. Pathfinder rules content (ORC License)
+
+The bundled reference data consists of the **rules expressions of Pathfinder
+Second Edition subsystems, conditions and actions** — their names and functional
+effect text, including the sample chase obstacles and the Victory Point scales
+tables. Under the Open RPG Creative License this is **Licensed Material** (the
+copyrighted expression of game mechanics), used here under that license. It
+originates with **Paizo Inc.** and is derived from the open-source [Foundry VTT
+`pf2e` system](https://github.com/foundryvtt/pf2e) data — the subsystem text from
+the GM Screen journal (`packs/pf2e/journals/gm-screen.json`), the conditions and
+actions from their own packs.
+
+Every page of subsystem text carries the Paizo page range it came from; those
+citations are generated into `data/subsystems.generated.js` alongside the text
+and are shown in the app's Reference tab.
+
+### ORC Notice
+
+This product is licensed under the ORC License located at the Library of Congress
+at TX 9-307-067 and available online at various locations including
+paizo.com/orclicense, azoralaw.com/orclicense, and others. All warranties are
+disclaimed as set forth therein.
+
+### Attribution
+
+This product is based on the following Licensed Material:
+
+Pathfinder Player Core © 2023 Paizo Inc., Designed by Logan Bonner, Jason
+Bulmahn, Stephen Radney-MacFarland, and Mark Seifter.
+
+Pathfinder Player Core 2 © 2024 Paizo Inc.
+
+Pathfinder GM Core © 2023 Paizo Inc., Designed by Logan Bonner and Mark Seifter.
+
+Pathfinder Treasure Vault (Remastered) © 2025 Paizo Inc.
+
+Pathfinder Dark Archive (Remastered) © 2025 Paizo Inc.
+
+> NOTE — The precise list of source books is generated into `GENERATED_REF_META`
+> in `data/reference.generated.js` and `GENERATED_SUB_META` in
+> `data/subsystems.generated.js`, from the licenses and citations recorded in the
+> Foundry pf2e data. Re-sync this section whenever either is rebuilt
+> (`npm run build:ref`, `npm run build:sub`).
+
+### Reserved Material
+
+Reserved Material elements are excluded from this product. To avoid confusion,
+such items include all trademarks, registered trademarks, and proper nouns,
+artwork, dialogue, organizations, plots, and storylines. Where a rule's mechanics
+are included, any such Reserved Material has been omitted or genericized.
+
+### Crediting this work downstream
+
+pf2e-primer © 2026 Whyte Erminae.
+
+---
+
+## 3. Pathfinder rules content (OGL)
+
+Three of the bundled action descriptions originate in pre-Remaster books that
+were published under the **Open Game License v1.0a** rather than the ORC License
+(2 from *Pathfinder Secrets of Magic*, 1 from *Pathfinder Gamemastery Guide*).
+They are included here as Open Game Content under that license.
+
+### OGL Section 15
+
+```
+Open Game License v 1.0a © 2000, Wizards of the Coast, Inc.
+
+System Reference Document © 2000, Wizards of the Coast, Inc.; Authors Jonathan
+Tweet, Monte Cook, and Skip Williams, based on material by E. Gary Gygax and
+Dave Arneson.
+
+Pathfinder Secrets of Magic © 2021, Paizo Inc.; Authors: Amirali Attar Olyaee,
+Alexander Augunas, Kate Baker, James Case, Jeff Collins, Vanessa Hoskins,
+James Jacobs, Jason Keeley, Lyz Liddell, Ron Lundeen, Patchen Mortimer, Stephen
+Radney-MacFarland, David N. Ross, Michael Sayre, Owen K.C. Stephens, Mark
+Seifter, Ashton Sperry, Andrew White.
+
+Pathfinder Gamemastery Guide © 2020, Paizo Inc.; Authors: Alexander Augunas,
+Jesse Benner, John Bennett, Logan Bonner, Clinton J. Boomer, Jason Bulmahn,
+James Case, Paris Crenshaw, Jesse Decker, Robert N. Emerson, Eleanor Ferron,
+Jaym Gates, Matthew Goetz, T.H. Gulliver, Kev Hamilton, Sasha Laranoa Harving,
+BJ Hensley, Vanessa Hoskins, Brian R. James, Jason LeMaitre, Lyz Liddell, Luis
+Loza, Ron Lundeen, Colm Lundberg, Stephen Radney-MacFarland, Jessica Redekop,
+Patrick Renie, Mikhail Rekun, Alistair Rigg, David N. Ross, David Schwartz,
+Michael Sayre, Amber Stewart, Christina Stiles, Landon Winkler, Linda Zayas-Palmer.
+```
+
+> NOTE — Regenerate this list from `GENERATED_REF_META` whenever the reference
+> data is rebuilt (`npm run build:ref`); the licence recorded per entry decides
+> which section it belongs in.
+
+---
+
+## 4. Compatibility / trademark notice
+
+Pathfinder and all associated marks and logos are trademarks of Paizo Inc.
+This package is an independent work, is **not** published, endorsed, sponsored,
+or affiliated with Paizo Inc., and no such association is implied. Any reference
+to Pathfinder is made under nominative fair use solely to identify the game
+system with which this material is compatible.
+
+The explanatory prose, the two pregenerated characters, the teaching NPC and all
+the interactive demos are original work by the author of this package.

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "pf2e-subsystems",
+  "version": "0.1.0",
+  "description": "Run Pathfinder 2e's Victory Point subsystems at the table — chases, infiltrations, influence encounters and research (single self-contained HTML).",
+  "keywords": [
+    "pathfinder",
+    "pf2e",
+    "gm",
+    "subsystems",
+    "victory-points",
+    "chase",
+    "infiltration",
+    "influence",
+    "research",
+    "ttrpg"
+  ],
+  "homepage": "https://thewhytewolf.github.io/pf2esubsystems/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/TheWhyteWolf/pf2esubsystems.git"
+  },
+  "bugs": {
+    "url": "https://github.com/TheWhyteWolf/pf2esubsystems/issues"
+  },
+  "author": "Whyte",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "bin": {
+    "pf2e-subsystems": "bin/cli.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "tools/",
+    "data/",
+    "dist/",
+    "notice.md"
+  ],
+  "scripts": {
+    "build": "python3 tools/build.py",
+    "build:ref": "python3 tools/build_reference.py --src \"$PF2E_DATA/packs/pf2e\" --out data/reference.generated.js",
+    "build:sub": "python3 tools/build_subsystems.py --src \"$PF2E_DATA/packs/pf2e/journals/gm-screen.json\" --out data/subsystems.generated.js",
+    "test": "node tools/test.mjs",
+    "check": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "jsdom": "^24.0.0"
+  }
+}

package/src/content.js

@@ -0,0 +1,234 @@
+/* ============================================================
+   src/content.js — the app's own configuration.
+
+   Every word of rules PROSE comes from data/subsystems.generated.js and
+   data/reference.generated.js, which are built from the open-source Foundry
+   pf2e data so they can't drift from GM Core. This file is the other half:
+   the machine-readable shape of each subsystem — its point pools, how a
+   degree of success moves them, and the defaults a GM can override.
+
+   engine.js only renders what's here. Adding a sixth subsystem means adding
+   an entry to SUBSYSTEMS, not writing a new screen.
+   ============================================================ */
+
+/* The four outcomes, in the order they appear on every button row. */
+const DEGREES = [
+  { key: "critSuccess", label: "Critical success", short: "Crit succ", tone: "heal" },
+  { key: "success",     label: "Success",          short: "Success",   tone: "ok" },
+  { key: "failure",     label: "Failure",          short: "Failure",   tone: "warn" },
+  { key: "critFailure", label: "Critical failure", short: "Crit fail", tone: "harm" },
+];
+
+/* Where the rules say "the GM decides", the app asks instead of choosing.
+   These strings surface in the prep editor next to the field in question. */
+const GM_CALLS = {
+  obstacleCost:
+    "How many points an obstacle needs is yours to set. The default follows " +
+    "GM Core's rule of thumb; raise it for a particularly demanding obstacle.",
+  awarenessFail:
+    "When the infiltration fails is yours to set. The default is twice the " +
+    "Infiltration Points the job needs, with a complication at each quarter.",
+  roundLength:
+    "A round is however long you say it is — the book gives a range, not a number.",
+  thresholds:
+    "Thresholds and what reaching one grants are entirely yours; the book " +
+    "gives scales, not contents.",
+  thresholdProgress:
+    "Counted in obstacles cleared, not points — the points reset at every " +
+    "obstacle, so they are not what measures progress across the whole run.",
+  researchCap:
+    "Each research check has a maximum RP. Past it the PCs learn nothing new " +
+    "from that source and have to go looking elsewhere.",
+};
+
+const SUBSYSTEMS = {
+  /* ---------------------------------------------------------- */
+  chase: {
+    key: "chase",
+    name: "Chase",
+    glyph: "»",
+    rulesPage: "chases",
+    blurb: "A run of obstacles, one action per PC per round. The group's " +
+           "points clear the obstacle in front of them — and the extras " +
+           "don't carry over.",
+    pools: [{ key: "cp", name: "Chase Points", abbr: "CP", min: 0, role: "goal" }],
+    scale: {
+      critSuccess: { cp: 2 },
+      success:     { cp: 1 },
+      failure:     {},
+      critFailure: { cp: -1 },
+    },
+    structure: "sequence",
+    /* Chase Points reset at every obstacle, so a threshold counted in points
+       would be meaningless. What advances across a chase is obstacles cleared. */
+    thresholdBasis: "progress",
+    /* GM Core: half the obstacles need one fewer point than the party size,
+       half need two fewer, minimum 1. */
+    obstacleCost: { base: "party", offsets: [1, 2], min: 1 },
+    presets: [
+      { key: "short",  label: "Short",  obstacles: 6,  note: "about 10–20 minutes of game time" },
+      { key: "medium", label: "Medium", obstacles: 8,  note: "about 15–25 minutes" },
+      { key: "long",   label: "Long",   obstacles: 10, note: "about 20–30 minutes" },
+    ],
+    extras: [
+      { key: "cantAct", label: "Couldn't act", deltas: { cp: -1 },
+        note: "A PC who passes their turn or can't act costs the group 1 CP." },
+      { key: "bypass", label: "Bypassed it", deltas: { cp: 1 },
+        note: "An action that gets past the obstacle without a check — a spell, " +
+              "usually 1 CP, or 2 if it was exceptionally helpful." },
+    ],
+    obstacleLibrary: true,
+    asks: ["obstacleCost", "thresholdProgress"],
+  },
+
+  /* ---------------------------------------------------------- */
+  infiltration: {
+    key: "infiltration",
+    name: "Infiltration",
+    glyph: "◑",
+    rulesPage: "infiltration",
+    blurb: "Two pools running against each other: points toward the job, and " +
+           "the opposition slowly noticing you. A failed check costs you both.",
+    pools: [
+      { key: "ip", name: "Infiltration Points", abbr: "IP", min: 0, role: "goal" },
+      { key: "ap", name: "Awareness Points",    abbr: "AP", min: 0, role: "hazard" },
+    ],
+    scale: {
+      critSuccess: { ip: 2 },
+      success:     { ip: 1 },
+      failure:     { ap: 1 },
+      critFailure: { ap: 2 },
+    },
+    /* The one everybody forgets at the table. */
+    roundEnd: { ap: 1 },
+    roundEndNote: "Each infiltration round that passes adds 1 Awareness Point.",
+    structure: "sequence",
+    /* As with a chase: progress is obstacles, not the points inside one. The
+       ladder that matters here is Awareness, and that one is derived. */
+    thresholdBasis: "progress",
+    obstacleModes: [
+      { key: "group", label: "Group", note: "The party pools its points; cleared once for everyone." },
+      { key: "individual", label: "Individual", note: "Every PC has to earn the points separately." },
+    ],
+    /* Failure at twice the IP the job needs, with a complication each quarter. */
+    awarenessRule: { multiplier: 2, steps: 4 },
+    edge: {
+      key: "ep", name: "Edge Points", abbr: "EP",
+      note: "Earned by preparation activities beforehand. Spend 1 to turn a " +
+            "failure or critical failure into a success — no points to the " +
+            "opposition, 1 IP to you.",
+    },
+    prepActivities: [
+      { slug: "bribe-contact",    name: "Bribe Contact" },
+      { slug: "forge-documents",  name: "Forge Documents" },
+      { slug: "gain-contact",     name: "Gain Contact" },
+      { slug: "gossip",           name: "Gossip" },
+      { slug: "scout-location",   name: "Scout Location" },
+      { slug: "secure-disguises", name: "Secure Disguises" },
+    ],
+    extras: [
+      { key: "helped", label: "Helped without a check", deltas: { ip: 1 },
+        note: "A spell or action that just works — usually 1 IP, 2 if it was " +
+              "particularly helpful." },
+      { key: "noticed", label: "Something went wrong", deltas: { ap: 1 },
+        note: "Anything disruptive the rules don't price. Your call." },
+    ],
+    asks: ["awarenessFail", "obstacleCost", "thresholdProgress"],
+  },
+
+  /* ---------------------------------------------------------- */
+  influence: {
+    key: "influence",
+    name: "Influence",
+    glyph: "◇",
+    rulesPage: "influence",
+    blurb: "A social encounter in rounds. Each PC either works on the NPC or " +
+           "works out what the NPC actually responds to.",
+    pools: [{ key: "ip", name: "Influence Points", abbr: "IP", min: 0, role: "goal" }],
+    scale: {
+      critSuccess: { ip: 2 },
+      success:     { ip: 1 },
+      failure:     {},
+      critFailure: { ip: -1 },
+    },
+    structure: "single",
+    roundLength: { low: "15 minutes", high: "an hour" },
+    /* Each PC acts once per round, choosing one of these. */
+    actions: [
+      { key: "influence", name: "Influence", slug: "influence", scored: true },
+      { key: "discover",  name: "Discover",  slug: "discover",  scored: false,
+        /* How many facts a Discover reveals. -1 means the GM feeds them a
+           plausible lie, which the app records but does not invent. */
+        reveals: { critSuccess: 2, success: 1, failure: 0, critFailure: -1 } },
+    ],
+    discoverNote:
+      "On a critical failure the PC learns something incorrect. The app marks " +
+      "the round; what the lie is, is yours.",
+    asks: ["roundLength", "thresholds"],
+  },
+
+  /* ---------------------------------------------------------- */
+  research: {
+    key: "research",
+    name: "Research",
+    glyph: "❖",
+    rulesPage: "research",
+    blurb: "Points against thresholds that hand over information — with each " +
+           "source drying up once it has given all it has.",
+    pools: [{ key: "rp", name: "Research Points", abbr: "RP", min: 0, role: "goal" }],
+    scale: {
+      critSuccess: { rp: 2 },
+      success:     { rp: 1 },
+      failure:     {},
+      critFailure: { rp: -1 },
+    },
+    structure: "checks",
+    roundLength: { low: "10 minutes", high: "a full day" },
+    checkNote:
+      "List the skills for a source lowest DC first — that's the order the " +
+      "book uses, and it reads as a hint to the players.",
+    asks: ["researchCap", "roundLength", "thresholds"],
+  },
+
+  /* ---------------------------------------------------------- */
+  custom: {
+    key: "custom",
+    name: "Victory Points",
+    glyph: "◆",
+    rulesPage: "victory-points",
+    blurb: "The bare framework the other four are built on. Name your points, " +
+           "set your thresholds, and run anything — reputation, a duel, a " +
+           "hexploration, a race against a rival crew.",
+    pools: [{ key: "vp", name: "Victory Points", abbr: "VP", min: 0, role: "goal" }],
+    structure: "single",
+    renameable: true,
+    /* The two structures GM Core defines. The scale comes from the mode. */
+    modes: [
+      { key: "accumulating", label: "Accumulating",
+        note: "Start at nothing and climb toward the end point.",
+        scale: {
+          critSuccess: { vp: 2 },
+          success:     { vp: 1 },
+          failure:     {},
+          critFailure: { vp: -1 },
+        } },
+      { key: "diminishing", label: "Diminishing",
+        note: "Start at the end point and try not to lose it. On a critical " +
+              "success the PCs gain a point only if regaining ground is " +
+              "possible — otherwise treat it as a success.",
+        startAtGoal: true,
+        scale: {
+          critSuccess: { vp: 1 },
+          success:     {},
+          failure:     { vp: -1 },
+          critFailure: { vp: -2 },
+        } },
+    ],
+    /* Presets come from the VP Scales table in the generated data. */
+    scalePresets: true,
+    asks: ["thresholds"],
+  },
+};
+
+/* The order they appear in the "new encounter" picker. */
+const SUBSYSTEM_ORDER = ["chase", "infiltration", "influence", "research", "custom"];