@gigzen/populace 1.1.0 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gigzen/populace",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "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": {

package/src/cli.mjs

@@ -264,9 +264,24 @@ async function run() {
 
   console.log(`\n  Bringing ${agents} people to life across ${cities.join(", ")}…\n`);
 
+  // Sign-ups are counted here rather than in the engine, so the engine keeps
+  // knowing nothing about who is watching.
+  let joinedSoFar = 0;
   const world = World.fromConfig(config, adapter, {
-    joined: (a) => console.log(`   ✓ ${a.persona.name} (${a.persona.city.name}, ${a.persona.platform})`),
-    joinFailed: (p, e) => console.log(`   ✖ ${p.name}: ${e.message}`),
+    joined: (a) => {
+      console.log(`   ✓ ${a.persona.name} (${a.persona.city.name}, ${a.persona.platform})`);
+      progress.joining({
+        done: ++joinedSoFar, total: agents, ok: true,
+        name: a.persona.name, city: a.persona.city.name,
+      });
+    },
+    joinFailed: (p, e) => {
+      console.log(`   ✖ ${p.name}: ${e.message}`);
+      progress.joining({
+        done: ++joinedSoFar, total: agents, ok: false,
+        name: p.name, city: p.city?.name,
+      });
+    },
     // Said out loud, because waiting silently is indistinguishable from hanging.
     // Retrying a throttled sign-up can add seconds per person, and a run that
     // pauses without explanation is a run somebody kills.

package/src/progress.mjs

@@ -71,7 +71,7 @@ function latencies(metrics) {
  * @param {(line: string) => void} options.write
  */
 export function createProgress({ enabled, everyLatency = 5, write = (l) => process.stdout.write(l) } = {}) {
-  if (!enabled) return { start() {}, tick() {}, done() {} };
+  if (!enabled) return { start() {}, joining() {}, tick() {}, done() {} };
 
   const emit = (event) => {
     try {
@@ -97,6 +97,18 @@ export function createProgress({ enabled, everyLatency = 5, write = (l) => proce
       });
     },
 
+    /**
+     * One event per person as they sign in, before any tick exists.
+     *
+     * Signing 250 people in takes minutes, and until this existed a watcher had
+     * nothing to show for it: every counter read zero, the progress bar stayed
+     * empty and the clock counted down as though the run were already under way.
+     * A window that looks identical to a hung one is a window people kill.
+     */
+    joining({ done, total, name, city, ok }) {
+      emit({ type: "joining", done, total, name, city, ok });
+    },
+
     tick(tickNo, totalTicks, world, metrics) {
       const t = world.totals();
       emit({