npm - @gigzen/populace - Versions diffs - 1.0.0 → 1.2.0 - Mend

@gigzen/populace 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (15) hide show

package/README.md +7 -3
package/examples/buzzbuzz-local/populace.config.mjs +63 -0
package/package.json +4 -1
package/src/cli.mjs +70 -2
package/src/config.mjs +18 -2
package/src/engine/world.mjs +37 -9
package/src/progress.mjs +153 -0
package/src/selftest.mjs +72 -0
package/examples/buzzbuzz/populace-report.html +0 -254
package/examples/buzzbuzz/populace-report.json +0 -298
package/examples/buzzbuzz/run-test.ps1 +0 -61
package/examples/demo/populace-report.html +0 -230
package/examples/demo/populace-report.json +0 -219
package/examples/rest-api/populace-report.html +0 -245
package/examples/rest-api/populace-report.json +0 -280

package/examples/buzzbuzz/populace-report.html DELETED Viewed

@@ -1,254 +0,0 @@
-<!doctype html>
-<html lang="en"><head><meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Populace report — Buzz</title>
-<style>
-:root{
-  --paper:#F4F5F7;--card:#fff;--ink:#12181D;--body:#3A454E;--muted:#6B7883;
-  --rule:#DDE2E7;--accent:#A85A0B;--ok:#2C6E4C;--bad:#A63127;--warn:#9A6A08;
-  --bar:#C9D4DC;--barbad:#E0A99F;
-  --mono:ui-monospace,"SF Mono","Cascadia Mono",Menlo,Consolas,monospace;
-  --sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Arial,sans-serif;
-}
-@media (prefers-color-scheme:dark){:root{
-  --paper:#0E1418;--card:#161E24;--ink:#E8EEF3;--body:#B0BDC7;--muted:#7B8994;
-  --rule:#26323A;--accent:#E0A45C;--ok:#5FAB80;--bad:#DE7568;--warn:#D2A24E;
-  --bar:#2E3A43;--barbad:#5C332C;}}
-:root[data-theme="dark"]{--paper:#0E1418;--card:#161E24;--ink:#E8EEF3;--body:#B0BDC7;
-  --muted:#7B8994;--rule:#26323A;--accent:#E0A45C;--ok:#5FAB80;--bad:#DE7568;
-  --warn:#D2A24E;--bar:#2E3A43;--barbad:#5C332C;}
-:root[data-theme="light"]{--paper:#F4F5F7;--card:#fff;--ink:#12181D;--body:#3A454E;
-  --muted:#6B7883;--rule:#DDE2E7;--accent:#A85A0B;--ok:#2C6E4C;--bad:#A63127;
-  --warn:#9A6A08;--bar:#C9D4DC;--barbad:#E0A99F;}
-*{box-sizing:border-box}
-body{margin:0;background:var(--paper);color:var(--body);font-family:var(--sans);
-  font-size:15.5px;line-height:1.6;-webkit-font-smoothing:antialiased}
-.wrap{max-width:900px;margin:0 auto;padding:0 22px 80px}
-h1,h2,h3{color:var(--ink);margin:0;text-wrap:balance}
-h1{font-family:var(--mono);font-size:clamp(22px,4vw,30px);letter-spacing:-.02em}
-h2{font-size:17px;font-family:var(--mono);letter-spacing:-.01em}
-.mono{font-family:var(--mono)}
-header{padding:44px 0 24px;border-bottom:2px solid var(--ink);display:flex;
-  flex-direction:column;gap:10px}
-.sub{font-family:var(--mono);font-size:12.5px;color:var(--muted)}
-.verdict{margin-top:26px;padding:20px 22px;border-radius:6px;display:flex;
-  flex-direction:column;gap:8px;border-left:4px solid}
-.verdict.ok{background:color-mix(in srgb,var(--ok) 8%,transparent);border-color:var(--ok)}
-.verdict.bad{background:color-mix(in srgb,var(--bad) 8%,transparent);border-color:var(--bad)}
-.verdict h2{color:var(--ink)}
-.verdict ul{margin:4px 0 0;padding-left:20px}
-.stats{display:grid;gap:12px;grid-template-columns:repeat(auto-fit,minmax(132px,1fr));margin-top:26px}
-.stat{background:var(--card);border:1px solid var(--rule);border-radius:6px;padding:15px 16px}
-.stat .v{font-family:var(--mono);font-size:23px;color:var(--ink);font-weight:600;
-  letter-spacing:-.02em;font-variant-numeric:tabular-nums;display:block}
-.stat .l{font-family:var(--mono);font-size:10px;letter-spacing:.12em;
-  text-transform:uppercase;color:var(--muted)}
-section{margin-top:42px;display:flex;flex-direction:column;gap:14px}
-.panel{background:var(--card);border:1px solid var(--rule);border-radius:6px;padding:20px 22px}
-.panel.danger{border-color:var(--bad);border-left-width:4px}
-.panel.danger h2{color:var(--bad)}
-.tablewrap{overflow-x:auto;border:1px solid var(--rule);border-radius:6px;background:var(--card)}
-table{border-collapse:collapse;width:100%;min-width:600px}
-th,td{padding:10px 14px;text-align:left;border-bottom:1px solid var(--rule)}
-th{font-family:var(--mono);font-size:10px;letter-spacing:.12em;text-transform:uppercase;
-  color:var(--muted);font-weight:600}
-td.num{text-align:right;font-family:var(--mono);font-variant-numeric:tabular-nums;font-size:13.5px}
-td.name{font-size:13.5px;color:var(--ink);white-space:nowrap}
-td.zero{color:var(--muted)}
-td.fail{color:var(--bad);font-weight:600}
-.x{color:var(--bad);margin-right:6px}
-.barcell{width:120px}
-.bar{height:7px;background:var(--bar);border-radius:4px}
-.row-bad .bar{background:var(--barbad)}
-tr.errrow td{padding-top:0;border-bottom:1px solid var(--rule)}
-.err{font-family:var(--mono);font-size:12px;color:var(--bad);padding:3px 0 3px 26px}
-.errn{color:var(--muted);margin-right:8px}
-.trace{font-family:var(--mono);font-size:11.5px;white-space:pre-wrap;overflow-x:auto;
-  background:var(--paper);padding:14px;border-radius:5px;margin:0;color:var(--body)}
-ul.cov{list-style:none;margin:0;padding:0;display:flex;flex-direction:column;gap:9px}
-ul.cov li{display:flex;gap:14px;flex-wrap:wrap;align-items:baseline;font-size:14px}
-ul.cov .mono{color:var(--ink);min-width:170px;font-size:13px}
-.would{color:var(--muted);font-size:13.5px}
-.chip{display:inline-block;font-family:var(--mono);font-size:12px;padding:7px 13px;
-  border-radius:5px;border:1px solid}
-.chip.ok{color:var(--ok);border-color:var(--ok);background:color-mix(in srgb,var(--ok) 8%,transparent)}
-.chip.bad{color:var(--bad);border-color:var(--bad);background:color-mix(in srgb,var(--bad) 8%,transparent)}
-.chip.warn{color:var(--warn);border-color:var(--warn);background:color-mix(in srgb,var(--warn) 8%,transparent)}
-footer{margin-top:52px;padding-top:20px;border-top:1px solid var(--rule);
-  font-size:13px;color:var(--muted);display:flex;flex-direction:column;gap:6px}
-</style></head><body>
-<div class="wrap">
-<header>
-  <h1>Buzz</h1>
-  <span class="sub">test environment · 30 simulated people ·
-    32m 51s · Thu, 20 Aug 2026 16:58:01 GMT</span>
-</header>
-<div class="verdict ok">
-  <h2>No failures across 46885 API calls</h2>
-</div>
-<div class="stats">
-  <div class="stat"><span class="v">46885</span><span class="l">API calls</span></div>
-  <div class="stat"><span class="v" style="color:var(--ok)">0</span><span class="l">failed</span></div>
-  <div class="stat"><span class="v">0.0%</span><span class="l">failure rate</span></div>
-  <div class="stat"><span class="v">30</span><span class="l">concurrent users</span></div>
-  <div class="stat"><span class="v">13/13</span><span class="l">coverage</span></div>
-</div>
-<section>
-  <h2>Your API under 30 concurrent users</h2>
-  <div class="tablewrap">
-    <table>
-      <thead><tr><th>Method</th><th style="text-align:right">Calls</th>
-        <th style="text-align:right">Fails</th><th style="text-align:right">p50</th>
-        <th style="text-align:right">p95</th><th>p95 relative</th></tr></thead>
-      <tbody>
-      <tr class="">
-        <td class="mono name">reportLocation</td>
-        <td class="num">20547</td>
-        <td class="num zero">0</td>
-        <td class="num">47ms</td>
-        <td class="num">72ms</td>
-        <td class="barcell"><div class="bar" style="width:37.3%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">recentPostsByOthers</td>
-        <td class="num">7021</td>
-        <td class="num zero">0</td>
-        <td class="num">12ms</td>
-        <td class="num">27ms</td>
-        <td class="barcell"><div class="bar" style="width:14.0%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">like</td>
-        <td class="num">7021</td>
-        <td class="num zero">0</td>
-        <td class="num">8ms</td>
-        <td class="num">16ms</td>
-        <td class="barcell"><div class="bar" style="width:8.3%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">post</td>
-        <td class="num">3054</td>
-        <td class="num zero">0</td>
-        <td class="num">12ms</td>
-        <td class="num">22ms</td>
-        <td class="barcell"><div class="bar" style="width:11.4%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">comment</td>
-        <td class="num">2840</td>
-        <td class="num zero">0</td>
-        <td class="num">7ms</td>
-        <td class="num">13ms</td>
-        <td class="barcell"><div class="bar" style="width:6.7%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">openConversation</td>
-        <td class="num">2713</td>
-        <td class="num zero">0</td>
-        <td class="num">8ms</td>
-        <td class="num">18ms</td>
-        <td class="barcell"><div class="bar" style="width:9.3%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">sendMessage</td>
-        <td class="num">2713</td>
-        <td class="num zero">0</td>
-        <td class="num">9ms</td>
-        <td class="num">19ms</td>
-        <td class="barcell"><div class="bar" style="width:9.8%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">listGroups</td>
-        <td class="num">428</td>
-        <td class="num zero">0</td>
-        <td class="num">8ms</td>
-        <td class="num">17ms</td>
-        <td class="barcell"><div class="bar" style="width:8.8%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">joinGroup</td>
-        <td class="num">428</td>
-        <td class="num zero">0</td>
-        <td class="num">7ms</td>
-        <td class="num">16ms</td>
-        <td class="barcell"><div class="bar" style="width:8.3%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">createUser</td>
-        <td class="num">30</td>
-        <td class="num zero">0</td>
-        <td class="num">149ms</td>
-        <td class="num">193ms</td>
-        <td class="barcell"><div class="bar" style="width:100.0%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">setProfile</td>
-        <td class="num">30</td>
-        <td class="num zero">0</td>
-        <td class="num">16ms</td>
-        <td class="num">22ms</td>
-        <td class="barcell"><div class="bar" style="width:11.4%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">refreshSession</td>
-        <td class="num">30</td>
-        <td class="num zero">0</td>
-        <td class="num">144ms</td>
-        <td class="num">190ms</td>
-        <td class="barcell"><div class="bar" style="width:98.4%"></div></td>
-      </tr>
-      <tr class="">
-        <td class="mono name">deleteUser</td>
-        <td class="num">30</td>
-        <td class="num zero">0</td>
-        <td class="num">16ms</td>
-        <td class="num">31ms</td>
-        <td class="barcell"><div class="bar" style="width:16.1%"></div></td>
-      </tr>
-      </tbody>
-    </table>
-  </div>
-</section>
-<section>
-  <h2>What the population did</h2>
-  <div class="panel">
-    341.9 km travelled · 3054 posts ·
-    7021 likes · 2840 comments ·
-    2713 messages · 428 group joins
-  </div>
-</section>
-<section>
-  <h2>Cleanup</h2>
-  <div><div class="chip ok">Cleanup complete — 30 accounts removed</div></div>
-</section>
-<footer>
-  <span>Generated by Populace 0.1.0 · adapter <span class="mono">../../adapters/buzzbuzz.mjs</span></span>
-  <span>Simulated people are generated from patterns. This report shows whether your app
-  <strong>works</strong> — not whether anyone wants it.</span>
-</footer>
-</div></body></html>

package/examples/buzzbuzz/populace-report.json DELETED Viewed

@@ -1,298 +0,0 @@
-{
-  "populace": {
-    "version": "0.1.0",
-    "generatedAt": "2026-08-20T17:29:52.161Z"
-  },
-  "run": {
-    "app": "Buzz",
-    "adapter": "../../adapters/buzzbuzz.mjs",
-    "environment": "test",
-    "startedAt": "2026-08-20T16:58:01.553Z",
-    "durationMs": 1910608,
-    "population": {
-      "agents": 30,
-      "cities": [
-        "manila",
-        "mumbai",
-        "delhi",
-        "jakarta"
-      ],
-      "tickSeconds": 2,
-      "minutes": 30
-    }
-  },
-  "verdict": {
-    "status": "clean",
-    "problems": [],
-    "apiFailures": 0,
-    "transportFailures": 0,
-    "failingMethods": []
-  },
-  "population": {
-    "requested": 30,
-    "signedIn": 30,
-    "signupFailures": []
-  },
-  "engineErrors": [],
-  "activity": {
-    "distanceKm": 341.9,
-    "posts": 3054,
-    "likes": 7021,
-    "comments": 2840,
-    "messages": 2713,
-    "groupJoins": 428
-  },
-  "api": {
-    "calls": 46885,
-    "failures": 0,
-    "apiFailures": 0,
-    "transportFailures": 0,
-    "retries": 0,
-    "failureRate": 0,
-    "apiFailureRate": 0,
-    "network": {
-      "retries": 0,
-      "transportFailures": 0,
-      "retryRate": 0,
-      "healthy": true,
-      "gaveUp": false,
-      "gaveUpAfter": null,
-      "outages": 0
-    },
-    "durationMs": 1910592,
-    "methods": [
-      {
-        "method": "reportLocation",
-        "calls": 20547,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 47,
-          "p95": 72,
-          "p99": 102,
-          "max": 214
-        },
-        "errors": []
-      },
-      {
-        "method": "recentPostsByOthers",
-        "calls": 7021,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 12,
-          "p95": 27,
-          "p99": 35,
-          "max": 59
-        },
-        "errors": []
-      },
-      {
-        "method": "like",
-        "calls": 7021,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 8,
-          "p95": 16,
-          "p99": 23,
-          "max": 43
-        },
-        "errors": []
-      },
-      {
-        "method": "post",
-        "calls": 3054,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 12,
-          "p95": 22,
-          "p99": 29,
-          "max": 58
-        },
-        "errors": []
-      },
-      {
-        "method": "comment",
-        "calls": 2840,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 7,
-          "p95": 13,
-          "p99": 19,
-          "max": 35
-        },
-        "errors": []
-      },
-      {
-        "method": "openConversation",
-        "calls": 2713,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 8,
-          "p95": 18,
-          "p99": 25,
-          "max": 53
-        },
-        "errors": []
-      },
-      {
-        "method": "sendMessage",
-        "calls": 2713,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 9,
-          "p95": 19,
-          "p99": 23,
-          "max": 32
-        },
-        "errors": []
-      },
-      {
-        "method": "listGroups",
-        "calls": 428,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 8,
-          "p95": 17,
-          "p99": 22,
-          "max": 44
-        },
-        "errors": []
-      },
-      {
-        "method": "joinGroup",
-        "calls": 428,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 7,
-          "p95": 16,
-          "p99": 20,
-          "max": 28
-        },
-        "errors": []
-      },
-      {
-        "method": "createUser",
-        "calls": 30,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 149,
-          "p95": 193,
-          "p99": 312,
-          "max": 312
-        },
-        "errors": []
-      },
-      {
-        "method": "setProfile",
-        "calls": 30,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 16,
-          "p95": 22,
-          "p99": 23,
-          "max": 23
-        },
-        "errors": []
-      },
-      {
-        "method": "refreshSession",
-        "calls": 30,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 144,
-          "p95": 190,
-          "p99": 194,
-          "max": 194
-        },
-        "errors": []
-      },
-      {
-        "method": "deleteUser",
-        "calls": 30,
-        "failures": 0,
-        "apiFailures": 0,
-        "transportFailures": 0,
-        "retries": 0,
-        "failureRate": 0,
-        "latencyMs": {
-          "p50": 16,
-          "p95": 31,
-          "p99": 60,
-          "max": 60
-        },
-        "errors": []
-      }
-    ]
-  },
-  "coverage": {
-    "label": "13/13",
-    "implemented": [
-      "createUser",
-      "setProfile",
-      "refreshSession",
-      "reportLocation",
-      "post",
-      "recentPostsByOthers",
-      "like",
-      "comment",
-      "openConversation",
-      "sendMessage",
-      "listGroups",
-      "joinGroup",
-      "deleteUser"
-    ],
-    "notTested": []
-  },
-  "cleanup": {
-    "removed": 30,
-    "notDeleted": [],
-    "failed": []
-  }
-}

package/examples/buzzbuzz/run-test.ps1 DELETED Viewed

@@ -1,61 +0,0 @@
-# Run the Buzz simulation from Windows PowerShell.
-#
-# Exists because the bash one-liner does not work here: PowerShell 5.1 has no
-# `&&` statement separator and no `VAR=value command` prefix, so pasting the
-# Unix form fails with "The token '&&' is not a valid statement separator".
-#
-#   .\run-test.ps1                    # 6 drivers, 5 minutes
-#   .\run-test.ps1 -Agents 4 -Minutes 3
-#   .\run-test.ps1 -Clean             # just remove any leftover accounts
-#
-# Run it from anywhere; it locates itself.
-param(
-  [int]$Agents  = 6,
-  [int]$Minutes = 5,
-  [switch]$Clean
-)
-$ErrorActionPreference = "Stop"
-Set-Location $PSScriptRoot
-# Deliberately no NODE_OPTIONS here. An earlier version set
-# --dns-result-order=ipv6first to work around connection failures on a NAT64
-# link. Measuring it afterwards showed 40/40 successful connections both with
-# and without the flag — the failures were the link recovering on its own, not
-# address-family ordering. The workaround was cargo cult, so it is gone.
-# The isolated test project. Never a production host — populace.config.mjs
-# lists the live ones in neverRunAgainst and refuses them before loading.
-$env:BUZZBUZZ_TEST_URL = "https://jqepegeifmnfofeyebrz.supabase.co"
-$env:BUZZBUZZ_TEST_KEY = "sb_publishable_ZkOhFsiQBrKMB5pc2Ub1Vw_V5oxsBE1"
-$cli = Join-Path $PSScriptRoot "..\..\src\cli.mjs"
-if ($Clean) {
-  node $cli clean
-  exit $LASTEXITCODE
-}
-Write-Host ""
-Write-Host "  Checking the target before running..." -ForegroundColor Cyan
-node $cli doctor
-if ($LASTEXITCODE -ne 0) {
-  Write-Host ""
-  Write-Host "  doctor says not ready — stopping here rather than burning a run." -ForegroundColor Yellow
-  exit 1
-}
-node $cli run --agents $Agents --minutes $Minutes
-$code = $LASTEXITCODE
-# A run exits non-zero when it FINDS something. That is the tool working, not
-# the tool failing, so say so rather than leaving a bare red exit code.
-Write-Host ""
-if ($code -eq 0) {
-  Write-Host "  Run finished with no failures." -ForegroundColor Green
-} else {
-  Write-Host "  Run finished and found problems — see the report above." -ForegroundColor Yellow
-  Write-Host "  That is the expected outcome when there is something to find." -ForegroundColor DarkGray
-}
-exit $code