@rotifer/playground 0.22.0 → 0.23.0

package/dist/telemetry/heartbeat.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordHeartbeat = recordHeartbeat;
+/**
+ * Anonymous usage heartbeat (ADR-329).
+ *
+ * Answers a narrower question than gene_invocation_log: not "who called
+ * what", just "did this machine run something today, and through which
+ * channel". No identity, on by default, and — unlike the invocation report
+ * — it costs nothing to lose one. It is not §33.4 input; a dropped
+ * heartbeat is not a hole in an audited ledger, it is one machine's "active
+ * today" signal that will show up again tomorrow if the machine is still in
+ * use. That is why this file, unlike cloud/invocation.ts, does not track
+ * in-flight requests for a caller to await before process.exit() — the
+ * reliability engineering that report needs would be pure overhead here.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const client_js_1 = require("../cloud/client.js");
+const invocation_js_1 = require("../cloud/invocation.js");
+const config_js_1 = require("./config.js");
+// __dirname is CommonJS's own global here (see tsconfig's "module": "NodeNext"
+// targeting CJS output) — no fileURLToPath(import.meta.url) needed, and that
+// ESM-only syntax would fail to compile in this build target anyway.
+let cachedVersion = null;
+function packageVersion() {
+    if (cachedVersion !== null)
+        return cachedVersion;
+    try {
+        const pkg = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "..", "package.json"), "utf-8"));
+        cachedVersion = typeof pkg.version === "string" ? pkg.version : null;
+    }
+    catch {
+        cachedVersion = null;
+    }
+    return cachedVersion;
+}
+/**
+ * The one-line disclosure, printed to stderr exactly once, before the first
+ * heartbeat this machine ever actually sends — never before, so a machine
+ * whose heartbeat is off (env or stored choice) never sees a notice about
+ * data that is never leaving it. Mirrors codegraph's wording pattern
+ * (ADR-329 measured its design against codegraph's, verified against its
+ * compiled output) but says MCP explicitly, because stderr is where CLI
+ * users look and exactly where MCP hosts do not — the MCP side of this
+ * (rotifer-mcp-server) carries the notice in a tool response instead, for
+ * that reason.
+ */
+function printFirstRunNotice() {
+    process.stderr.write("[rotifer] Anonymous usage heartbeat is on by default — no code, no identity, just " +
+        "\"this machine ran something today\". `rotifer telemetry off`, ROTIFER_TELEMETRY=0, " +
+        "or DO_NOT_TRACK=1 disables it. Details: https://rotifer.dev/telemetry\n");
+}
+/**
+ * Reports one Gene invocation's worth of activity for this machine, today,
+ * on the given channel. Fire-and-forget; every failure mode is silence,
+ * same contract as recordGeneInvocation. Safe to call unconditionally from
+ * every call site that already calls recordGeneInvocation — this function
+ * does its own consent and test-run checks.
+ */
+function recordHeartbeat() {
+    // The whole body is one try/catch, deliberately wider than the network
+    // call. loadOrInitHeartbeatConfig()/markFirstRunNoticeShown() write to
+    // ~/.rotifer/telemetry.json — config.ts does not swallow that failure
+    // (rotifer telemetry on/off should surface a write error to the user who
+    // ran it), but a Gene execution silently failing because this
+    // fire-and-forget signal couldn't touch the filesystem would be a much
+    // worse trade. Every failure mode here is silence, same contract as the
+    // network call below.
+    try {
+        if ((0, invocation_js_1.runningUnderTest)())
+            return;
+        const channel = (0, invocation_js_1.resolveInvocationChannel)();
+        if (channel === null)
+            return; // unattributable declared channel — see resolveInvocationChannel
+        const config = (0, config_js_1.loadOrInitHeartbeatConfig)();
+        const decision = (0, config_js_1.resolveHeartbeatDecision)(config);
+        if (!(0, config_js_1.heartbeatDecisionEnabled)(decision))
+            return;
+        // Only reached once we know a report is actually about to leave the
+        // process — see printFirstRunNotice's doc comment for why the ordering
+        // matters. Persisted synchronously so a crash in the fetch below can
+        // never cause the notice to reprint on the next run.
+        if (!config.first_run_notice_shown) {
+            printFirstRunNotice();
+            (0, config_js_1.markFirstRunNoticeShown)(config);
+        }
+        const cloudConfig = (0, client_js_1.loadCloudConfig)();
+        const url = `${cloudConfig.endpoint.replace(/\/+$/, "")}/rest/v1/rpc/record_heartbeat`;
+        // No Authorization header: record_heartbeat is anon-callable by design
+        // (migration 20260830010000) — that grant is the entire point of ADR-329.
+        // Sending credentials here would be pointless (the RPC does not use them)
+        // and would defeat the "no identity" promise for a user who happens to be
+        // signed in but has not opted into the signed-in invocation report.
+        fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json", apikey: cloudConfig.anonKey },
+            body: JSON.stringify({
+                p_machine_id: config.machine_id,
+                p_channel: channel,
+                p_client_version: packageVersion(),
+                p_invocation_delta: 1,
+            }),
+        })
+            .then((res) => {
+            if (!res.ok && process.env.ROTIFER_DEBUG) {
+                process.stderr.write(`[rotifer] record_heartbeat failed (${res.status})\n`);
+            }
+        })
+            .catch((err) => {
+            if (process.env.ROTIFER_DEBUG) {
+                process.stderr.write(`[rotifer] record_heartbeat error: ${err?.message ?? err}\n`);
+            }
+        });
+    }
+    catch (err) {
+        if (process.env.ROTIFER_DEBUG) {
+            process.stderr.write(`[rotifer] record_heartbeat setup error: ${err?.message ?? err}\n`);
+        }
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/telemetry/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../src/telemetry/heartbeat.ts"],"names":[],"mappings":"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"}

package/dist/utils/leaderboard-watch.d.ts

@@ -0,0 +1,44 @@
+import type { LeaderboardRow } from "../cloud/client.js";
+/**
+ * Stable identity of a leaderboard row across polls. The board folds to one
+ * row per logical gene, so the logical name (owner + name) is the key — the
+ * shown version (and with it the gene_id) legitimately changes when an author
+ * publishes, and that must not read as a disappearance plus an arrival.
+ */
+export declare function leaderboardKey(row: LeaderboardRow): string;
+export type LeaderboardChange = {
+    kind: "new";
+    key: string;
+    row: LeaderboardRow;
+} | {
+    kind: "tier";
+    key: string;
+    from: LeaderboardRow["tier"];
+    to: LeaderboardRow["tier"];
+} | {
+    kind: "up" | "down";
+    key: string;
+    from: number;
+    to: number;
+};
+/**
+ * Diff two polls of the tiered leaderboard.
+ *
+ * Rank moves only exist inside a ranked tier: `tier_rank` is null for
+ * `not_evaluated` rows, and a null on either side is a tier story, not a rank
+ * story. A tier change is reported as such and suppresses the rank comparison
+ * for that row — "#3 → #1" across two different ladders compares nothing.
+ */
+export declare function diffLeaderboard(prev: LeaderboardRow[], curr: LeaderboardRow[]): LeaderboardChange[];
+/**
+ * What the score column may show for a row. A `not_evaluated` row never shows
+ * a number, even when the ledger stores one — printing a stored value next to
+ * the words "not evaluated" is how a hash-derived number got read as a
+ * measurement in the first place (ADR-319 D4 display decision).
+ */
+export declare function fitnessCell(row: LeaderboardRow): string;
+/** Same rule for V(g): no numbers on an unevaluated row. */
+export declare function safetyCell(row: LeaderboardRow): string;
+/** Position column: `not_evaluated` rows have no position, not position zero. */
+export declare function rankCell(row: LeaderboardRow): string;
+//# sourceMappingURL=leaderboard-watch.d.ts.map

package/dist/utils/leaderboard-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-watch.d.ts","sourceRoot":"","sources":["../../src/utils/leaderboard-watch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAE1D;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,cAAc,CAAA;CAAE,GACjD;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;IAC7B,EAAE,EAAE,cAAc,CAAC,MAAM,CAAC,CAAC;CAC5B,GACD;IAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EAAE,EACtB,IAAI,EAAE,cAAc,EAAE,GACrB,iBAAiB,EAAE,CA8BrB;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAGvD;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAGtD;AAED,iFAAiF;AACjF,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAEpD"}

package/dist/utils/leaderboard-watch.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.leaderboardKey = leaderboardKey;
+exports.diffLeaderboard = diffLeaderboard;
+exports.fitnessCell = fitnessCell;
+exports.safetyCell = safetyCell;
+exports.rankCell = rankCell;
+/**
+ * Stable identity of a leaderboard row across polls. The board folds to one
+ * row per logical gene, so the logical name (owner + name) is the key — the
+ * shown version (and with it the gene_id) legitimately changes when an author
+ * publishes, and that must not read as a disappearance plus an arrival.
+ */
+function leaderboardKey(row) {
+    return `${row.owner_username}/${row.gene_name}`;
+}
+/**
+ * Diff two polls of the tiered leaderboard.
+ *
+ * Rank moves only exist inside a ranked tier: `tier_rank` is null for
+ * `not_evaluated` rows, and a null on either side is a tier story, not a rank
+ * story. A tier change is reported as such and suppresses the rank comparison
+ * for that row — "#3 → #1" across two different ladders compares nothing.
+ */
+function diffLeaderboard(prev, curr) {
+    const prevMap = new Map(prev.map((r) => [leaderboardKey(r), r]));
+    const changes = [];
+    for (const row of curr) {
+        const key = leaderboardKey(row);
+        const before = prevMap.get(key);
+        if (!before) {
+            changes.push({ kind: "new", key, row });
+            continue;
+        }
+        if (before.tier !== row.tier) {
+            changes.push({ kind: "tier", key, from: before.tier, to: row.tier });
+            continue;
+        }
+        if (before.tier_rank != null &&
+            row.tier_rank != null &&
+            before.tier_rank !== row.tier_rank) {
+            changes.push({
+                kind: row.tier_rank < before.tier_rank ? "up" : "down",
+                key,
+                from: before.tier_rank,
+                to: row.tier_rank,
+            });
+        }
+    }
+    return changes;
+}
+/**
+ * What the score column may show for a row. A `not_evaluated` row never shows
+ * a number, even when the ledger stores one — printing a stored value next to
+ * the words "not evaluated" is how a hash-derived number got read as a
+ * measurement in the first place (ADR-319 D4 display decision).
+ */
+function fitnessCell(row) {
+    if (row.tier === "not_evaluated" || row.fitness_value == null)
+        return "—";
+    return row.fitness_value.toFixed(4);
+}
+/** Same rule for V(g): no numbers on an unevaluated row. */
+function safetyCell(row) {
+    if (row.tier === "not_evaluated" || row.safety_score == null)
+        return "—";
+    return row.safety_score.toFixed(4);
+}
+/** Position column: `not_evaluated` rows have no position, not position zero. */
+function rankCell(row) {
+    return row.tier_rank == null ? "—" : String(row.tier_rank);
+}
+//# sourceMappingURL=leaderboard-watch.js.map

package/dist/utils/leaderboard-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leaderboard-watch.js","sourceRoot":"","sources":["../../src/utils/leaderboard-watch.ts"],"names":[],"mappings":";;AAQA,wCAEC;AAoBD,0CAiCC;AAQD,kCAGC;AAGD,gCAGC;AAGD,4BAEC;AAnFD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,GAAmB;IAChD,OAAO,GAAG,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;AAClD,CAAC;AAYD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,IAAsB,EACtB,IAAsB;IAEtB,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,MAAM,OAAO,GAAwB,EAAE,CAAC;IAExC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACrE,SAAS;QACX,CAAC;QACD,IACE,MAAM,CAAC,SAAS,IAAI,IAAI;YACxB,GAAG,CAAC,SAAS,IAAI,IAAI;YACrB,MAAM,CAAC,SAAS,KAAK,GAAG,CAAC,SAAS,EAClC,CAAC;YACD,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM;gBACtD,GAAG;gBACH,IAAI,EAAE,MAAM,CAAC,SAAS;gBACtB,EAAE,EAAE,GAAG,CAAC,SAAS;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,GAAmB;IAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,GAAG,CAAC,aAAa,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IAC1E,OAAO,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACtC,CAAC;AAED,4DAA4D;AAC5D,SAAgB,UAAU,CAAC,GAAmB;IAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,IAAI,GAAG,CAAC,YAAY,IAAI,IAAI;QAAE,OAAO,GAAG,CAAC;IACzE,OAAO,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACrC,CAAC;AAED,iFAAiF;AACjF,SAAgB,QAAQ,CAAC,GAAmB;IAC1C,OAAO,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC"}

package/dist/utils/run-logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-logger.d.ts","sourceRoot":"","sources":["../../src/utils/run-logger.ts"],"names":[],"mappings":"AASA,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAsC9D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAiB3D"}
+{"version":3,"file":"run-logger.d.ts","sourceRoot":"","sources":["../../src/utils/run-logger.ts"],"names":[],"mappings":"AAUA,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAkD9D;AAED,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAiB3D"}

package/dist/utils/run-logger.js

@@ -8,9 +8,21 @@ const node_path_1 = require("node:path");
 const node_os_1 = require("node:os");
 const private_fs_js_1 = require("./private-fs.js");
 const invocation_js_1 = require("../cloud/invocation.js");
+const heartbeat_js_1 = require("../telemetry/heartbeat.js");
 const MAX_LOG_SIZE = 10 * 1024 * 1024; // 10MB rotation
 const LOG_DIR = (0, node_path_1.join)((0, node_os_1.homedir)(), ".rotifer", "run-logs");
 function logGeneExecution(meta) {
+    // Unconditional — unlike the recordGeneInvocation call below this one,
+    // which only fires when meta.geneDir names a Cloud-installed Gene. The
+    // heartbeat (ADR-329) doesn't need a resolvable Cloud identity: "this
+    // machine ran something today" is true whether meta.geneDir is set,
+    // unset, or points at a local, never-published Gene. Gating it on the
+    // same condition as the identity-carrying report would silently drop the
+    // heartbeat for exactly the callers (locally-authored Genes, composed
+    // agents without one obvious geneDir) that most need the anonymous signal
+    // to be counted at all. No try/catch needed here — recordHeartbeat()
+    // guarantees it never throws.
+    (0, heartbeat_js_1.recordHeartbeat)();
     try {
         (0, private_fs_js_1.ensurePrivateDir)(LOG_DIR);
         const logFile = (0, node_path_1.join)(LOG_DIR, `${meta.geneName}.jsonl`);

package/dist/utils/run-logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-logger.js","sourceRoot":"","sources":["../../src/utils/run-logger.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-logger.js","sourceRoot":"","sources":["../../src/utils/run-logger.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "Rotifer Protocol Playground — local development environment for gene development, Arena competition, and protocol simulation",
   "license": "Apache-2.0",
   "author": "Rotifer Protocol Contributors",
@@ -87,10 +87,10 @@
   },
   "optionalDependencies": {
     "@rolldown/binding-linux-x64-gnu": "1.1.1",
-    "@rotifer/playground-darwin-arm64": "0.22.0",
-    "@rotifer/playground-darwin-x64": "0.22.0",
-    "@rotifer/playground-linux-x64-gnu": "0.22.0",
-    "@rotifer/playground-win32-x64-msvc": "0.22.0"
+    "@rotifer/playground-darwin-arm64": "0.23.0",
+    "@rotifer/playground-darwin-x64": "0.23.0",
+    "@rotifer/playground-linux-x64-gnu": "0.23.0",
+    "@rotifer/playground-win32-x64-msvc": "0.23.0"
   },
   "engines": {
     "node": ">=22.18.0"