feat: rename to BitGate and close the drop-in gap

Renames the project and makes it as easy to adopt as BitLogin, which was the
stated bar and which it did not previously meet.

Rename (ADR 0005): @nostr-governance/* -> @bitgate/*, governance-* elements ->
bitgate-*, createGovernanceRuntime -> createBitGate. "Governance" reads as DAO
voting to this audience and named a category rather than a product; BitGate
names the benefit and joins the bit- family that BitVid and BitRoad compose
with. Domain types keep their names — the product is BitGate, the subject
matter is still governance. The migration plan is left as written; this ADR
records the change rather than rewriting history.

Drop-in distribution (ADR 0006): adopting BitGate meant supplying a transport,
authoring a policy, and wiring every element in JavaScript. Now:

- createRelayTransport(urls) — WebSocket transport with reconnection, backoff,
  subscription replay, and cross-relay dedupe
- policy presets (social, commerce, admin-only) addressable by name; the engine
  still carries no thresholds of its own
- <bitgate-provider> — configuration in markup, with descendants finding the
  runtime through a bubbling context event rather than DOM walking, which
  breaks across shadow boundaries
- npm run build:widget — a self-contained dist/bitgate.js

That last one came from running it in a browser rather than from a test. Bare
specifiers resolve in Node and vitest but not in a browser, so the widget
source worked everywhere except a plain static page — the one place it exists
to serve. The bundle is not committed: consumers build from reviewed source.

Also found by running it: the provider's ready event fires during element
upgrade, before a page that defines elements after parsing can attach a
listener, so it now exposes `ready` as a promise too.

Four bugs fixed along the way, three found by new tests and one by the browser:
admin state stayed silent when a roster change altered capabilities but no
denials; the relay transport sent every subscription twice on connect; the
commerce preset computed a meaningless visibility verdict at checkout and could
hide a listing from its own seller; <bitgate-status> threw on an unusable
decision.

759 tests; lint, typecheck, and both builds clean.
This commit is contained in:
thePR0M3TH3AN committed 2026-08-09 19:58:45 -04:00
1 parent 7f70a64d61
commit adeba151b8
63 files changed
+2774 -401

No files matched your search

+13 -13
View File
@@ -3,7 +3,7 @@
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>nostr-governance widget demo</title>
<title>BitGate widget demo</title>
<style>
:root { color-scheme: light dark; }
body {
@@ -29,20 +29,20 @@
</style>
</head>
<body>
<h1>nostr-governance widget</h1>
<h1>BitGate widget demo</h1>
<p class="lede">
Every element below reads from one shared runtime. Toggle governance state
and watch each surface reach its own conclusion from the same evidence.
</p>
<section>
<h2>Viewer surface — <code>&lt;governance-veil&gt;</code></h2>
<governance-veil id="veil" profile="public-marketplace">
<h2>Viewer surface — <code>&lt;bitgate-veil&gt;</code></h2>
<bitgate-veil id="veil" profile="public-marketplace">
<div class="card">
<img alt="" />
<p><strong>Widget</strong> — 1000 sats</p>
</div>
</governance-veil>
</bitgate-veil>
<div class="controls">
<button id="report">Add a trusted scam report</button>
@@ -61,8 +61,8 @@
</section>
<section>
<h2>Status readout — <code>&lt;governance-status&gt;</code></h2>
<governance-status id="status" profile="seller-dashboard"></governance-status>
<h2>Status readout — <code>&lt;bitgate-status&gt;</code></h2>
<bitgate-status id="status" profile="seller-dashboard"></bitgate-status>
</section>
<section>
@@ -72,20 +72,20 @@
listings but not sellers. Note that the refused control stays visible
and says what it needs.
</p>
<governance-capabilities id="caps"></governance-capabilities>
<governance-admin-panel id="panel"></governance-admin-panel>
<bitgate-capabilities id="caps"></bitgate-capabilities>
<bitgate-admin-panel id="panel"></bitgate-admin-panel>
</section>
<script type="module">
import {
createCommands,
createGovernanceRuntime,
createBitGate,
createMemoryTransport,
} from "../../packages/runtime/src/index.js";
import { defineGovernanceElements } from "../../packages/widget/src/index.js";
import { defineBitGateElements } from "../../packages/widget/src/index.js";
import { COMMERCE_POLICY, COMMERCE_ROLE_CAPABILITIES } from "./src/policy.js";
defineGovernanceElements();
defineBitGateElements();
const key = (seed) => seed.repeat(64).slice(0, 64);
const ROOT = key("a1");
@@ -95,7 +95,7 @@
const NOW = Math.floor(Date.now() / 1000);
const trusted = (i) => key(i.toString(16).padStart(2, "0"));
const runtime = createGovernanceRuntime({
const runtime = createBitGate({
applicationId: "commerce-demo",
namespace: "commerce",
root: ROOT,