v4.4.0-client: emit manifest.json + defaultMenuUrl field (4.4.1)

.github/workflows/patch.yml

@@ -54,7 +54,7 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git config user.name "github-actions[bot]"
 
-          git add dist/game.min.js dist/metadata.json
+          git add dist/manifest.json dist/game.min.js dist/metadata.json
           git add dist/public-game.min.js 2>/dev/null || true
 
           if git diff --cached --quiet; then

CLAUDE.md

@@ -10,7 +10,10 @@ The Play Origin extension (in `ProdigyPXP/ProdigyOrigin`, formerly "Prodigy Orig
 
 ### Architecture
 
-- **src/patch.ts** — Core patcher. Fetches game files, applies regex-based patches, writes output.
+- **src/patch.ts** — Orchestrator. Fetches game files, runs rules via `src/patches.ts` for VERIFICATION, builds the prefix/suffix via `src/wrappers.ts`, assembles `dist/manifest.json` (primary artifact) + `dist/game.min.js` (verification copy) + `dist/metadata.json`.
+- **src/patches.ts** — `PatchRule` type, `RULES` array, `applyRules`, `hashRules`.
+- **src/wrappers.ts** — `buildPrefix(version)`, `buildSuffix(version, displayImages)`; `buildSuffix` reads `window.__ORIGIN_MENU_URL__`, which is provided via `manifest.defaultMenuUrl`.
+- **src/manifest.ts** — `Manifest` type, `buildManifest`, `hashManifest`.
 - **src/constants.ts** — URLs, version, GUI link.
 - **src/displayImages.ts** — Console splash images.
 - **build.mjs** — esbuild build script.
@@ -45,6 +48,7 @@ node dist/patch.js  # Run patcher locally
 ## Output
 
 The patcher writes to the output directory:
-- `game.min.js` — Patched game with injected hack entry points
-- `metadata.json` — Build metadata (version, hash, degraded status)
-- `public-game.min.js` — Patched public game file (if available)
+- `manifest.json` — **Primary artifact.** Consumed by the Play Origin extension.
+- `game.min.js` — Verification copy of the patched bundle (not loaded by the extension at runtime).
+- `metadata.json` — Per-run metadata: version, hash, perRuleCounts, degraded status.
+- `public-game.min.js` — Patched public game file (if available).

README.md

@@ -4,6 +4,25 @@ P-NP is the static patch pipeline that powers **Play Origin** (the browser-exten
 
 The repository no longer runs an HTTP server. Instead, a GitHub Action fetches current Prodigy assets, applies the patcher logic, and pushes the patched files to a dedicated `patched` branch so they can be served from `raw.githubusercontent.com`.
 
+## Architecture (v4.4.0+)
+
+The patcher's primary artifact is `dist/manifest.json` — a small JSON file containing:
+
+- `schemaVersion` — manifest schema version for compatibility checks.
+- `patcherVersion` — version of this patcher that produced the manifest.
+- `rules` — ordered list of regex find/replace rules applied to `game.min.js`.
+- `prefix` — pre-rendered JS string prepended to the patched game.
+- `suffix` — pre-rendered JS string appended after the patched game.
+- `defaultMenuUrl` — default menu/loader URL used by consumers when patching.
+- `hash` — content hash of `{rules, prefix, suffix, defaultMenuUrl}` for cache invalidation.
+
+The Play Origin extension fetches this manifest, fetches the original `game.min.js`
+from `code.prodigygame.com`, applies the rules locally in its background service
+worker, wraps with prefix/suffix, and caches the result in `chrome.storage.local`.
+
+`dist/game.min.js` is still produced as a verification copy so this repo's history
+stays auditable, but the extension no longer fetches it.
+
 ## How It Works
 
 1. `.github/workflows/patch.yml` runs every 2 hours (cron) and on manual dispatch.

dist/metadata.json

@@ -1,10 +1,19 @@
 {
-  "generatedAt": "2026-05-25T19:39:06.899Z",
-  "patcherVersion": "4.3.0",
+  "generatedAt": "2026-05-25T20:58:13.440Z",
+  "patcherVersion": "4.4.1",
   "gameVersion": "2026.26.0",
   "publicGameHash": null,
   "loadGamePath": "/js/load-game-f2baaaba58.min.js",
   "patchDegraded": false,
+  "manifestHash": "aa3a3ec39939dbb0",
+  "perRuleCounts": {
+    "singleton-exposure": 1,
+    "safe-bind": 9,
+    "expose-constants": 1,
+    "answer-question-bypass": 1,
+    "external-factory-bypass": 1,
+    "open-question-bypass": 1
+  },
   "source": {
     "gameUrl": "https://code.prodigygame.com/code/2026.26.0/game.min.js?v=2026.26.0",
     "publicGameUrl": null,

package.json

@@ -1,12 +1,14 @@
 {
   "name": "p-np-patcher",
-  "version": "4.3.0",
+  "version": "4.4.1",
   "description": "Fetches and patches Prodigy game files for static hosting",
   "main": "./dist/patch.js",
   "type": "module",
   "scripts": {
     "build": "node build.mjs",
-    "patch": "node dist/patch.js"
+    "patch": "node dist/patch.js",
+    "test": "node --experimental-strip-types --test \"tests/**/*.test.ts\"",
+    "typecheck": "tsc --noEmit"
   },
   "repository": {
     "type": "git",

src/constants.ts

@@ -1,4 +1,4 @@
-export const VERSION = "4.3.0";
+export const VERSION = "4.4.1";
 export const GUI_LINK = "https://raw.githubusercontent.com/ProdigyPXP/ProdigyOrigin/master/originGUI/dist/bundle.js";
 export const PRODIGY_LOAD_URL = "https://math.prodigygame.com/load";
 export const PRODIGY_CODE_ORIGIN = "https://code.prodigygame.com";

src/manifest.ts

@@ -0,0 +1,38 @@
+import { createHash } from "node:crypto";
+import type { PatchRule } from "./patches.ts";
+
+export type Manifest = {
+  schemaVersion: 1;
+  patcherVersion: string;
+  hash: string;
+  rules: ReadonlyArray<PatchRule>;
+  prefix: string;
+  suffix: string;
+  defaultMenuUrl: string;
+};
+
+export const hashManifest = (
+  rules: ReadonlyArray<PatchRule>,
+  prefix: string,
+  suffix: string,
+  defaultMenuUrl: string
+): string => {
+  const canonical = JSON.stringify({ rules, prefix, suffix, defaultMenuUrl });
+  return createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+};
+
+export const buildManifest = (input: {
+  patcherVersion: string;
+  rules: ReadonlyArray<PatchRule>;
+  prefix: string;
+  suffix: string;
+  defaultMenuUrl: string;
+}): Manifest => ({
+  schemaVersion: 1,
+  patcherVersion: input.patcherVersion,
+  hash: hashManifest(input.rules, input.prefix, input.suffix, input.defaultMenuUrl),
+  rules: input.rules,
+  prefix: input.prefix,
+  suffix: input.suffix,
+  defaultMenuUrl: input.defaultMenuUrl
+});