@gigzen/populace 1.3.3 → 1.3.4

package/README.md

@@ -25,18 +25,19 @@ applying**. Then it hands you a report on what broke.
 
 ---
 
-## It has done this to a real, finished app
+## It has done this to a real app
 
 ![Populace report for Buzz, 21 August 2026 — no failures across 932,455 API calls from 200 simulated drivers across 20 cities in 11 countries](docs/buzz-run-2026-08-21.svg)
 
-That is the *second* run. The first one is the interesting one.
+That is a later run. The first one is the interesting one.
 
 ### What happened, in plain English
 
 On **9 August 2026** we pointed Populace at **Buzz** — a gig-worker platform
 on Android with a live Postgres backend, 17 tables and 48 row-level-security
-policies. It was finished. It was signed. It had been through a full manual test
-of every screen by the person who wrote it, and it had passed.
+policies. It has since been renamed [**Waggle**](https://shakhtar-sankur.github.io/gigzen/waggle.html).
+It had not launched yet, but it was signed, and it had been through a full manual
+test of every screen by the person who wrote it, and it had passed.
 
 We started six simulated drivers: three in **Manila**, three in **Mumbai**. Each
 one signed up for a real account, set a profile, started driving a plausible
@@ -137,6 +138,20 @@ Two files land in whatever directory you ran it from: `populace-report.json` for
 CI, and `populace-report.html`, which is one self-contained page you can email
 to someone who was not watching your terminal.
 
+### Or skip the terminal
+
+[**Populace Studio**](https://github.com/Shakhtar-Sankur/populace/releases/latest) is
+the same engine in a window, for Windows, with no Node or npm needed. Download the
+installer or the portable build and check it against `SHA256SUMS.txt` on the release.
+Neither is code-signed yet, so Windows SmartScreen will warn before the first launch.
+
+Studio shows every simulated person on a world map as they move, and a box per contract
+method with its live latency. A method your adapter implements but the run never called is
+drawn dashed and named in the verdict, so it is not counted as covered. When something breaks,
+Studio shows the failing method and the database's own error text while the run is still
+going. It does not reimplement the engine: every run is the same command a terminal would
+issue, and Studio prints that command.
+
 ---
 
 ## Point it at your own app
@@ -152,7 +167,7 @@ You write **one adapter** — thirteen small methods, each answering "how does
 this happen in my app?". Two are required (`createUser`, `deleteUser`);
 everything else is optional and anything you skip is reported as untested rather
 than quietly passing. Full spec in [adapters/contract.md](adapters/contract.md),
-and [adapters/buzzbuzz.mjs](adapters/buzzbuzz.mjs) is a complete real-world
+and [adapters/waggle.mjs](adapters/waggle.mjs) is a complete real-world
 example in ~150 lines.
 
 `populace doctor` on a fresh scaffold says `2/13` and refuses to run — a method
@@ -418,7 +433,7 @@ multi-user simulation is best at finding.
 - **A populated app** instead of an empty one — the cold-start problem, solved for demos and for judging your own UX
 - **Multi-user paths exercised** without recruiting humans: presence, receipts, realtime fan-out, membership counts
 - **Permission rules tested by users who genuinely have different identities**
-- **Latency per endpoint** (p50/p95/p99/max) under N concurrent users
+- **Latency per endpoint** (p50/p95/max) under N concurrent users
 - **Failures grouped by shape**, not exact text, so one bug is one line rather than fifty
 - **Account deletion actually tested** — the path almost nobody exercises and the one regulators ask about
 - **`populace-report.json`** for CI; the run exits non-zero when problems are found

package/adapters/{buzzbuzz.mjs → waggle.mjs}

@@ -1,4 +1,8 @@
-// Adapter: Buzz — a gig-driver tracking app on Supabase.
+// Adapter: Waggle — a gig-driver tracking app on Supabase.
+//
+// (This file was adapters/buzzbuzz.mjs until the app was renamed Waggle. The
+// table names and the phone-to-email scheme below are the app's own and did
+// not change with the name.)
 //
 // Populace's first customer, and the reference implementation. Read this
 // alongside contract.md to see what a complete adapter looks like: it is ~140
@@ -20,13 +24,13 @@ export function createAdapter(target) {
 
   if (!url || !key) {
     throw new Error(
-      "buzzbuzz adapter needs target.url and target.key.\n" +
+      "waggle adapter needs target.url and target.key.\n" +
         "  Set BUZZBUZZ_TEST_URL and BUZZBUZZ_TEST_KEY in your environment.",
     );
   }
 
   return {
-    name: "buzzbuzz",
+    name: "waggle",
 
     // supabase-js RETURNS network errors rather than throwing, so without this
     // a wrong URL looks identical to "that account doesn't exist" — and a run

package/examples/rest-api/adapter.mjs

@@ -2,7 +2,7 @@
  * An adapter for a plain REST API — the second one Populace has ever had, and
  * the reason the portability claim is more than a hope.
  *
- * Read this next to adapters/buzzbuzz.mjs. They share no library, no id type,
+ * Read this next to adapters/waggle.mjs. They share no library, no id type,
  * no error convention and no auth mechanism, and the engine cannot tell them
  * apart. That is the whole argument.
  *

package/examples/{buzzbuzz → waggle}/populace.config.mjs

@@ -3,11 +3,11 @@
 // Run it — PowerShell (Windows):
 //   $env:BUZZBUZZ_TEST_URL="https://<your-TEST-project>.supabase.co"
 //   $env:BUZZBUZZ_TEST_KEY="<test project publishable key>"
-//   node src/cli.mjs run --config examples/buzzbuzz/populace.config.mjs
+//   node src/cli.mjs run --config examples/waggle/populace.config.mjs
 //
 // Run it — bash/zsh (macOS, Linux):
 //   BUZZBUZZ_TEST_URL=... BUZZBUZZ_TEST_KEY=... \
-//     node src/cli.mjs run --config examples/buzzbuzz/populace.config.mjs
+//     node src/cli.mjs run --config examples/waggle/populace.config.mjs
 //
 // The test project needs the same schema as production. Run these against it:
 //   schema.sql · social_features.sql · groups.sql · direct_messages.sql
@@ -18,7 +18,7 @@
 
 export default {
   app: "Buzz",
-  adapter: "../../adapters/buzzbuzz.mjs",
+  adapter: "../../adapters/waggle.mjs",
   environment: "test",
 
   target: {

package/examples/{buzzbuzz-local → waggle-local}/populace.config.mjs

@@ -1,6 +1,6 @@
 // Buzz against the local Supabase stack, at a scale the hosted project refuses.
 //
-// Why this file exists rather than reusing examples/buzzbuzz:
+// Why this file exists rather than reusing examples/waggle:
 //
 // The hosted test project applies Supabase's default auth rate limit of 30 sign
 // ups per five minutes per IP address. Measured on 2026-08-24: a 250-driver run
@@ -20,11 +20,11 @@
 //   npx supabase start
 //
 // Then either pick this file in Populace Studio, or:
-//   node src/cli.mjs run --config examples/buzzbuzz-local/populace.config.mjs
+//   node src/cli.mjs run --config examples/waggle-local/populace.config.mjs
 
 export default {
   app: "Buzz",
-  adapter: "../../adapters/buzzbuzz.mjs",
+  adapter: "../../adapters/waggle.mjs",
   environment: "test",
 
   // The local stack's fixed development address and publishable key. These are
@@ -35,7 +35,7 @@ export default {
     key: "sb_publishable_ACJWlzQHlZjBrEguHvfOxg_3BJgxAaH",
   },
 
-  // Kept identical to examples/buzzbuzz. A local run is no reason to relax the
+  // Kept identical to examples/waggle. A local run is no reason to relax the
   // guard: if one of these ever appears in `target.url` above, refuse to start.
   neverRunAgainst: [
     "https://rqzuuvlougzhynckvqzd.supabase.co",

package/package.json

@@ -1,60 +1,60 @@
-{
-  "name": "@gigzen/populace",
-  "version": "1.3.3",
-  "description": "A simulated population that uses your app through its real API, so you can test what needs more than one person.",
-  "type": "module",
-  "bin": {
-    "populace": "./src/cli.mjs"
-  },
-  "main": "./src/index.mjs",
-  "exports": {
-    ".": "./src/index.mjs",
-    "./engine": "./src/engine/index.mjs"
-  },
-  "files": [
-    "src",
-    "adapters",
-    "examples",
-    "!**/populace-report.json",
-    "!**/populace-report.html",
-    "!examples/buzzbuzz/run-test.ps1",
-    "populace.config.example.mjs",
-    "README.md",
-    "LICENSE",
-    "action.yml"
-  ],
-  "scripts": {
-    "demo": "node src/cli.mjs demo",
-    "doctor": "node src/cli.mjs doctor",
-    "test": "node src/selftest.mjs",
-    "prepublishOnly": "node src/selftest.mjs"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "keywords": [
-    "simulation",
-    "testing",
-    "load-testing",
-    "multi-user",
-    "synthetic-users",
-    "qa"
-  ],
-  "license": "AGPL-3.0-only",
-  "dependencies": {},
-  "devDependencies": {
-    "@supabase/supabase-js": "^2.45.0"
-  },
-  "author": "Sankur Kundu <sankur.kundu.tw@gmail.com>",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Shakhtar-Sankur/populace.git"
-  },
-  "homepage": "https://github.com/Shakhtar-Sankur/populace#readme",
-  "bugs": {
-    "url": "https://github.com/Shakhtar-Sankur/populace/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@gigzen/populace",
+  "version": "1.3.4",
+  "description": "A simulated population that uses your app through its real API, so you can test what needs more than one person.",
+  "type": "module",
+  "bin": {
+    "populace": "./src/cli.mjs"
+  },
+  "main": "./src/index.mjs",
+  "exports": {
+    ".": "./src/index.mjs",
+    "./engine": "./src/engine/index.mjs"
+  },
+  "files": [
+    "src",
+    "adapters",
+    "examples",
+    "!**/populace-report.json",
+    "!**/populace-report.html",
+    "!examples/waggle/run-test.ps1",
+    "populace.config.example.mjs",
+    "README.md",
+    "LICENSE",
+    "action.yml"
+  ],
+  "scripts": {
+    "demo": "node src/cli.mjs demo",
+    "doctor": "node src/cli.mjs doctor",
+    "test": "node src/selftest.mjs",
+    "prepublishOnly": "node src/selftest.mjs"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "simulation",
+    "testing",
+    "load-testing",
+    "multi-user",
+    "synthetic-users",
+    "qa"
+  ],
+  "license": "AGPL-3.0-only",
+  "dependencies": {},
+  "devDependencies": {
+    "@supabase/supabase-js": "^2.45.0"
+  },
+  "author": "Sankur Kundu <sankur.kundu.tw@gmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Shakhtar-Sankur/populace.git"
+  },
+  "homepage": "https://github.com/Shakhtar-Sankur/populace#readme",
+  "bugs": {
+    "url": "https://github.com/Shakhtar-Sankur/populace/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}