@rotifer/playground 0.23.2 → 0.25.0

package/dist/publish/auto-publish.js

@@ -0,0 +1,205 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autoPublishGate = autoPublishGate;
+exports.needsCompileBeforePublish = needsCompileBeforePublish;
+exports.needsNetworkConfigBeforePublish = needsNetworkConfigBeforePublish;
+exports.resolveWrapFidelity = resolveWrapFidelity;
+exports.skipHintFor = skipHintFor;
+exports.offerAutoPublish = offerAutoPublish;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_readline_1 = require("node:readline");
+const display = __importStar(require("../utils/display.js"));
+const palette_js_1 = require("../utils/palette.js");
+const user_config_js_1 = require("../utils/user-config.js");
+const auth_js_1 = require("../cloud/auth.js");
+const publish_js_1 = require("../commands/publish.js");
+/**
+ * Pure decision: should `wrap` ask about publishing?
+ *
+ * Ordered so the reported reason is the one the user can act on first. An
+ * explicit opt-out wins over everything (never second-guess it); a build
+ * environment is next because nothing else matters when nobody is watching;
+ * a Gene that cannot be published as-is (missing WASM, missing network
+ * config) outranks being signed out, because logging in would not fix either.
+ */
+function autoPublishGate(input) {
+    if (!input.enabled)
+        return { offer: false, reason: "disabled-by-config" };
+    if (!input.interactive)
+        return { offer: false, reason: "non-interactive" };
+    if (input.needsWasm)
+        return { offer: false, reason: "needs-compile" };
+    if (input.needsNetworkConfig)
+        return { offer: false, reason: "needs-network-config" };
+    if (!input.loggedIn)
+        return { offer: false, reason: "not-logged-in" };
+    return { offer: true };
+}
+/** True when publishing this Gene would be rejected for a missing WASM artifact. */
+function needsCompileBeforePublish(geneDir, fidelity) {
+    if (fidelity !== "Native")
+        return false;
+    return !(0, node_fs_1.existsSync)((0, node_path_1.join)(geneDir, "gene.ir.wasm"));
+}
+/**
+ * True when publishing this Gene would be rejected for an empty (or absent)
+ * `network.allowedDomains` — the exact check in publish.ts's
+ * publishSingleGene, duplicated here rather than imported because that
+ * function only reports the failure after asking the user to confirm; this
+ * runs before the question is asked at all.
+ *
+ * A missing or unparseable phenotype.json is not this function's problem to
+ * report — `false` here just means "don't block on network config", and
+ * whatever is actually wrong with the file surfaces from publishSingleGene
+ * itself if the user says yes.
+ */
+function needsNetworkConfigBeforePublish(geneDir, fidelity) {
+    if (fidelity !== "Hybrid")
+        return false;
+    try {
+        const phenotype = JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(geneDir, "phenotype.json"), "utf-8"));
+        const domains = phenotype?.network?.allowedDomains;
+        return !Array.isArray(domains) || domains.length === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Which fidelity the auto-publish gate should judge a wrap by.
+ *
+ * `wrap`'s plain path (no --from-skill/--from-clawhub) loads an existing
+ * phenotype.json when re-wrapping a gene — e.g. to change --domain — and
+ * leaves its `fidelity` untouched. The CLI's `--fidelity` flag still defaults
+ * to "Wrapped" regardless. Passing that default straight to the gate made an
+ * existing Native gene with no compiled gene.ir.wasm show the publish prompt,
+ * accept a "yes", and only then fail inside publishSingleGene — found by an
+ * independent cursor-agent pyramid test run, 2026-08-31, which is also why
+ * this is a pure function rather than a PTY-driven E2E test: reproducing it
+ * needs a real TTY, and this repo's CI matrix runs both ubuntu-latest and
+ * macos-14, whose `script` binaries take incompatible arguments — a
+ * behavioural test for a one-line data-selection bug was the wrong layer.
+ *
+ * The on-disk phenotype wins whenever one was actually loaded; the CLI flag
+ * is truth only when there was nothing on disk to read.
+ */
+function resolveWrapFidelity(phenotype, cliFidelity) {
+    return typeof phenotype.fidelity === "string" && phenotype.fidelity.length > 0
+        ? phenotype.fidelity
+        : cliFidelity;
+}
+/**
+ * The next step a skipped offer points at.
+ *
+ * Exported as a pure function because most skip reasons are unreachable from a
+ * spawned-CLI test: a child process never has a TTY, so `non-interactive`
+ * shadows every reason below it. Testing the message through the gate would
+ * quietly cover one branch and leave three unexercised.
+ */
+function skipHintFor(reason, geneName, geneDir) {
+    if (reason === "needs-compile") {
+        return `  rotifer compile ${geneName}       # required before publishing a Native gene`;
+    }
+    if (reason === "needs-network-config") {
+        const phenotypePath = geneDir ? (0, node_path_1.join)(geneDir, "phenotype.json") : `${geneName}/phenotype.json`;
+        return `  Add network.allowedDomains to ${phenotypePath}, then: rotifer publish ${geneName}`;
+    }
+    if (reason === "not-logged-in") {
+        return `  rotifer login                    # then: rotifer publish ${geneName}`;
+    }
+    return `  rotifer publish ${geneName}       # upload to Rotifer Cloud`;
+}
+/**
+ * Ask, defaulting to yes. Empty input (a bare Enter) is the default — that is
+ * what makes it a default rather than a question with a suggested answer.
+ */
+async function confirmPublish(geneName) {
+    console.log();
+    display.hint(palette_js_1.c.dim(`Publishing is on by default — turn it off with 'rotifer config set default-publish false'`));
+    const rl = (0, node_readline_1.createInterface)({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => {
+        rl.question(`Publish '${geneName}' to Rotifer Cloud? [Y/n] `, (ans) => {
+            rl.close();
+            resolve(ans.trim().toLowerCase());
+        });
+    });
+    return answer === "" || answer === "y" || answer === "yes";
+}
+/**
+ * Run the offer. Returns whether the Gene was actually published, so callers
+ * can decide what to print next. Never throws: a wrap that succeeded must not
+ * be reported as failed because the optional upload afterwards did not work.
+ */
+async function offerAutoPublish(opts) {
+    const { geneName, geneDir, fidelity } = opts;
+    const gate = autoPublishGate({
+        enabled: (0, user_config_js_1.shouldAutoPublish)(),
+        interactive: Boolean(process.stdin.isTTY) && !display.isJsonMode(),
+        loggedIn: (0, auth_js_1.isLoggedIn)(),
+        needsWasm: needsCompileBeforePublish(geneDir, fidelity),
+        needsNetworkConfig: needsNetworkConfigBeforePublish(geneDir, fidelity),
+    });
+    // Printed for every skip, opt-out included: turning off the *prompt* is not
+    // a request to hide that publishing exists, and this line is what `wrap`
+    // already printed before the offer was wired in.
+    if (!gate.offer) {
+        display.hint(skipHintFor(gate.reason, geneName, geneDir));
+        return false;
+    }
+    if (!(await confirmPublish(geneName))) {
+        console.log();
+        display.hint(`  rotifer publish ${geneName}       # upload later`);
+        return false;
+    }
+    console.log();
+    try {
+        const creds = await (0, auth_js_1.requireAuth)();
+        const result = await (0, publish_js_1.publishSingleGene)(geneName, geneDir, creds, {});
+        if (result.status === "failed") {
+            display.warn(`Publish failed: ${result.error ?? "unknown error"}`);
+            display.hint(`  rotifer publish ${geneName}       # retry`);
+            return false;
+        }
+        return true;
+    }
+    catch (e) {
+        display.warn(`Publish failed: ${e instanceof Error ? e.message : String(e)}`);
+        display.hint(`  rotifer publish ${geneName}       # retry`);
+        return false;
+    }
+}
+//# sourceMappingURL=auto-publish.js.map

package/dist/publish/auto-publish.js.map

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

package/dist/utils/fitness-formula.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The §5.1 fitness formula, in one place.
+ *
+ *   F(g) = [S_r · ln(1 + C_util) · (1 + R_rob)] / [L · Resource_Cost]
+ *
+ * `L` and `Resource_Cost` in the spec are the *raw* latency and cost, so both
+ * sit in the denominator and a slower, costlier gene scores lower. The
+ * implementation does not divide by raw values — an unbounded denominator
+ * drives F(g) to zero for any gene with a realistic latency, which is what
+ * ADR-215 P1 set out to avoid. It normalizes each into a (0, 1] score first:
+ *
+ *   L_score    = 1 / (1 + avg_latency_ms / LATENCY_SCALE_MS)
+ *   Cost_score = 1 / (1 + avg_cost / RESOURCE_SCALE_UNITS)
+ *
+ * Those scores are already *inverted* — lower latency means a score nearer 1 —
+ * so they belong in the numerator. Dividing by them, as this code did until
+ * this module existed, flips the penalty into a reward: F(g) rose with latency
+ * and every gene slower than a second pinned at the 1.0 cap. The regression
+ * tests in `tests/unit/fitness-formula.test.ts` hold the direction.
+ */
+/**
+ * Latency at which L_score halves. `[N]` — provisional, uncalibrated.
+ *
+ * ADR-318 D2 replaces both constants with `L_ref` / `Cost_ref` — the season
+ * median for the gene's own domain and fidelity, which is what makes F(g)
+ * dimensionless and comparable across bindings — and marks their values `[N]`
+ * pending ABM / measured calibration under RFC-001 §0. That reference scale
+ * needs a season-median pipeline that does not exist yet (v0.9.3 #6); these two
+ * fixed constants are the stand-ins until it does.
+ */
+export declare const LATENCY_SCALE_MS = 1000;
+/**
+ * Resource cost (fuel units) at which Cost_score halves. `[N]` — provisional.
+ *
+ * Badly out of scale, and known to be: ADR-318 recorded both constants as
+ * guesses, and measured 7.7e9 fuel on a leaderboard gene from its reported
+ * efficiency score. Locally, three
+ * sandbox runs each over the bundled Native corpus burn 1.2M–83M fuel
+ * (url-extractor 1.22M, debugger 1.44M, citation-manager 1.80M,
+ * particle-spatial 83.3M), so at a 10k scale every real gene lands at a
+ * Cost_score of 0.008 or below and F(g) collapses to ~0.003 — far under
+ * τ = 0.3. While it divided, the same mismatch was invisible: it inflated F(g)
+ * past the 1.0 cap instead. This is why `arena submit` does not gate on F(g)
+ * while `hasCompleteFitnessInputs` is false: a threshold comparison against a
+ * provisional scale is not an admission decision. Picking new values is a
+ * protocol-parameter change under RFC-001 §0, not a code cleanup.
+ */
+export declare const RESOURCE_SCALE_UNITS = 10000;
+export interface FitnessInputs {
+    /** S_r — fraction of evaluation runs that passed, in [0, 1]. */
+    successRate: number;
+    /** Mean wall-clock latency across the evaluation runs, in milliseconds. */
+    avgLatencyMs: number;
+    /** Mean fuel consumed across the evaluation runs. */
+    avgResourceCost: number;
+    /** C_util — input-space coverage in [0, 1]. */
+    coverage: number;
+    /** R_rob — adversarial robustness in [0, 1]. */
+    robustness: number;
+}
+export interface FitnessBreakdown {
+    /**
+     * F(g), in (0, 2·ln 2] ≈ (0, 1.386].
+     *
+     * Not capped. The old `min(1.0)` was there because dividing by the
+     * efficiency scores made the value unbounded — with them multiplied the
+     * formula is bounded by its own factors, and ADR-318 D2 drops the cap for
+     * exactly that reason: a cap erases the difference between everything above
+     * it, which is what made six leaderboard genes tie at a perfect 1.000.
+     */
+    value: number;
+    /** L_score — 1 at zero latency, falling monotonically as latency rises. */
+    latencyScore: number;
+    /** Cost_score — 1 at zero cost, falling monotonically as cost rises. */
+    resourceEfficiency: number;
+}
+/** L_score: 1 at zero latency, strictly decreasing, never zero. */
+export declare function latencyScoreFor(avgLatencyMs: number): number;
+/** Cost_score: 1 at zero cost, strictly decreasing, never zero. */
+export declare function resourceEfficiencyFor(avgResourceCost: number): number;
+/**
+ * F(g) from one batch of evaluation measurements.
+ *
+ * Multiplicative throughout: a zero in any factor collapses the score, with no
+ * mutual compensation between a gene's strengths and its weaknesses.
+ */
+export declare function computeBaseFitness(inputs: FitnessInputs): FitnessBreakdown;
+//# sourceMappingURL=fitness-formula.d.ts.map

package/dist/utils/fitness-formula.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness-formula.d.ts","sourceRoot":"","sources":["../../src/utils/fitness-formula.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,MAAM,WAAW,aAAa;IAC5B,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,eAAe,EAAE,MAAM,CAAC;IACxB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,mEAAmE;AACnE,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAErE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,CAU1E"}

package/dist/utils/fitness-formula.js

@@ -0,0 +1,79 @@
+"use strict";
+/**
+ * The §5.1 fitness formula, in one place.
+ *
+ *   F(g) = [S_r · ln(1 + C_util) · (1 + R_rob)] / [L · Resource_Cost]
+ *
+ * `L` and `Resource_Cost` in the spec are the *raw* latency and cost, so both
+ * sit in the denominator and a slower, costlier gene scores lower. The
+ * implementation does not divide by raw values — an unbounded denominator
+ * drives F(g) to zero for any gene with a realistic latency, which is what
+ * ADR-215 P1 set out to avoid. It normalizes each into a (0, 1] score first:
+ *
+ *   L_score    = 1 / (1 + avg_latency_ms / LATENCY_SCALE_MS)
+ *   Cost_score = 1 / (1 + avg_cost / RESOURCE_SCALE_UNITS)
+ *
+ * Those scores are already *inverted* — lower latency means a score nearer 1 —
+ * so they belong in the numerator. Dividing by them, as this code did until
+ * this module existed, flips the penalty into a reward: F(g) rose with latency
+ * and every gene slower than a second pinned at the 1.0 cap. The regression
+ * tests in `tests/unit/fitness-formula.test.ts` hold the direction.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESOURCE_SCALE_UNITS = exports.LATENCY_SCALE_MS = void 0;
+exports.latencyScoreFor = latencyScoreFor;
+exports.resourceEfficiencyFor = resourceEfficiencyFor;
+exports.computeBaseFitness = computeBaseFitness;
+/**
+ * Latency at which L_score halves. `[N]` — provisional, uncalibrated.
+ *
+ * ADR-318 D2 replaces both constants with `L_ref` / `Cost_ref` — the season
+ * median for the gene's own domain and fidelity, which is what makes F(g)
+ * dimensionless and comparable across bindings — and marks their values `[N]`
+ * pending ABM / measured calibration under RFC-001 §0. That reference scale
+ * needs a season-median pipeline that does not exist yet (v0.9.3 #6); these two
+ * fixed constants are the stand-ins until it does.
+ */
+exports.LATENCY_SCALE_MS = 1000;
+/**
+ * Resource cost (fuel units) at which Cost_score halves. `[N]` — provisional.
+ *
+ * Badly out of scale, and known to be: ADR-318 recorded both constants as
+ * guesses, and measured 7.7e9 fuel on a leaderboard gene from its reported
+ * efficiency score. Locally, three
+ * sandbox runs each over the bundled Native corpus burn 1.2M–83M fuel
+ * (url-extractor 1.22M, debugger 1.44M, citation-manager 1.80M,
+ * particle-spatial 83.3M), so at a 10k scale every real gene lands at a
+ * Cost_score of 0.008 or below and F(g) collapses to ~0.003 — far under
+ * τ = 0.3. While it divided, the same mismatch was invisible: it inflated F(g)
+ * past the 1.0 cap instead. This is why `arena submit` does not gate on F(g)
+ * while `hasCompleteFitnessInputs` is false: a threshold comparison against a
+ * provisional scale is not an admission decision. Picking new values is a
+ * protocol-parameter change under RFC-001 §0, not a code cleanup.
+ */
+exports.RESOURCE_SCALE_UNITS = 10_000;
+/** L_score: 1 at zero latency, strictly decreasing, never zero. */
+function latencyScoreFor(avgLatencyMs) {
+    return 1.0 / (1.0 + Math.max(avgLatencyMs, 0) / exports.LATENCY_SCALE_MS);
+}
+/** Cost_score: 1 at zero cost, strictly decreasing, never zero. */
+function resourceEfficiencyFor(avgResourceCost) {
+    return 1.0 / (1.0 + Math.max(avgResourceCost, 0) / exports.RESOURCE_SCALE_UNITS);
+}
+/**
+ * F(g) from one batch of evaluation measurements.
+ *
+ * Multiplicative throughout: a zero in any factor collapses the score, with no
+ * mutual compensation between a gene's strengths and its weaknesses.
+ */
+function computeBaseFitness(inputs) {
+    const latencyScore = latencyScoreFor(inputs.avgLatencyMs);
+    const resourceEfficiency = resourceEfficiencyFor(inputs.avgResourceCost);
+    const quality = inputs.successRate * Math.log1p(inputs.coverage) * (1 + inputs.robustness);
+    // Multiplied, not divided: L_score and Cost_score are already inverted, so
+    // multiplying by them is what makes slower and costlier score lower. No cap —
+    // every factor is bounded, so the product is too.
+    const value = quality * latencyScore * resourceEfficiency;
+    return { value, latencyScore, resourceEfficiency };
+}
+//# sourceMappingURL=fitness-formula.js.map

package/dist/utils/fitness-formula.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fitness-formula.js","sourceRoot":"","sources":["../../src/utils/fitness-formula.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AA8DH,0CAEC;AAGD,sDAEC;AAQD,gDAUC;AArFD;;;;;;;;;GASG;AACU,QAAA,gBAAgB,GAAG,IAAI,CAAC;AACrC;;;;;;;;;;;;;;;GAeG;AACU,QAAA,oBAAoB,GAAG,MAAM,CAAC;AAgC3C,mEAAmE;AACnE,SAAgB,eAAe,CAAC,YAAoB;IAClD,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,GAAG,wBAAgB,CAAC,CAAC;AACpE,CAAC;AAED,mEAAmE;AACnE,SAAgB,qBAAqB,CAAC,eAAuB;IAC3D,OAAO,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,4BAAoB,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,MAAqB;IACtD,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IAC1D,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACzE,MAAM,OAAO,GACX,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7E,2EAA2E;IAC3E,8EAA8E;IAC9E,kDAAkD;IAClD,MAAM,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,kBAAkB,CAAC;IAC1D,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC;AACrD,CAAC"}

package/dist/utils/user-config.d.ts

@@ -1,6 +1,10 @@
 export interface UserConfig {
     "update-check"?: boolean;
+    /** Pre-multi-package rollback target; still written for @rotifer/playground
+     *  so an older CLI and `rotifer config get last-version` keep working. */
     "last-version"?: string;
+    /** Per-package rollback targets, written by `rotifer self-update`. */
+    "last-versions"?: Record<string, string>;
     "default-publish"?: boolean;
 }
 export declare function isValidKey(key: string): key is keyof UserConfig;

package/dist/utils/user-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAUD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,MAAM,UAAU,CAE/D;AAED,wBAAgB,cAAc,IAAI,UAAU,CAQ3C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGvD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,GAAG,MAAM,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}
+{"version":3,"file":"user-config.d.ts","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;8EAC0E;IAC1E,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAYD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,MAAM,UAAU,CAE/D;AAED,wBAAgB,cAAc,IAAI,UAAU,CAQ3C;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAGvD;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,GAAG,MAAM,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAQ7E;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C"}

package/dist/utils/user-config.js

@@ -18,6 +18,8 @@ function getUserConfigFile() {
 const DEFAULTS = {
     "update-check": true,
     "last-version": "",
+    // Not exposed through `rotifer config` (see VALID_KEYS) — self-update owns it.
+    "last-versions": {},
     "default-publish": true,
 };
 const VALID_KEYS = new Set(["update-check", "last-version", "default-publish"]);

package/dist/utils/user-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":";;AA0BA,gCAEC;AAED,wCAQC;AAED,wCAGC;AAED,gDAIC;AAED,gDAQC;AAED,8CAOC;AApED,qCAA6E;AAC7E,yCAAiC;AACjC,qCAAkC;AAElC,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAA,gBAAI,EAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAQD,MAAM,QAAQ,GAAyB;IACrC,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,EAAE;IAClB,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElG,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,GAAG,CAAC,GAAuB,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;QAC9B,IAAI,IAAA,oBAAU,EAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,cAAc,CAAC,MAAkB;IAC/C,IAAA,mBAAS,EAAC,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAA,uBAAa,EAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB;IACtD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;IAClD,CAAC;SAAM,CAAC;QACL,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,SAAgB,iBAAiB;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACrD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,GAAG,CAAC;IACxD,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"user-config.js","sourceRoot":"","sources":["../../src/utils/user-config.ts"],"names":[],"mappings":";;AAgCA,gCAEC;AAED,wCAQC;AAED,wCAGC;AAED,gDAIC;AAED,gDAQC;AAED,8CAOC;AA1ED,qCAA6E;AAC7E,yCAAiC;AACjC,qCAAkC;AAElC,SAAS,YAAY;IACnB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,IAAA,gBAAI,EAAC,IAAA,iBAAO,GAAE,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAA,gBAAI,EAAC,YAAY,EAAE,EAAE,aAAa,CAAC,CAAC;AAC7C,CAAC;AAYD,MAAM,QAAQ,GAAyB;IACrC,cAAc,EAAE,IAAI;IACpB,cAAc,EAAE,EAAE;IAClB,+EAA+E;IAC/E,eAAe,EAAE,EAAE;IACnB,iBAAiB,EAAE,IAAI;CACxB,CAAC;AAEF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElG,SAAgB,UAAU,CAAC,GAAW;IACpC,OAAO,UAAU,CAAC,GAAG,CAAC,GAAuB,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,iBAAiB,EAAE,CAAC;QAC9B,IAAI,IAAA,oBAAU,EAAC,CAAC,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;IAC9C,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAgB,cAAc,CAAC,MAAkB;IAC/C,IAAA,mBAAS,EAAC,YAAY,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,IAAA,uBAAa,EAAC,iBAAiB,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7E,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB;IACtD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;AACrB,CAAC;AAED,SAAgB,kBAAkB,CAAC,GAAqB,EAAE,KAAa;IACrE,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,IAAI,GAAG,KAAK,cAAc,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG,CAAC;IAClD,CAAC;SAAM,CAAC;QACL,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnD,CAAC;IACD,cAAc,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC;AAED,SAAgB,iBAAiB;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;IACrD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,WAAW,KAAK,OAAO,IAAI,WAAW,KAAK,GAAG,CAAC;IACxD,CAAC;IACD,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,OAAO,MAAM,CAAC,iBAAiB,CAAC,IAAI,QAAQ,CAAC,iBAAiB,CAAC,CAAC;AAClE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.23.2",
+  "version": "0.25.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.23.2",
-    "@rotifer/playground-darwin-x64": "0.23.2",
-    "@rotifer/playground-linux-x64-gnu": "0.23.2",
-    "@rotifer/playground-win32-x64-msvc": "0.23.2"
+    "@rotifer/playground-darwin-arm64": "0.25.0",
+    "@rotifer/playground-darwin-x64": "0.25.0",
+    "@rotifer/playground-linux-x64-gnu": "0.25.0",
+    "@rotifer/playground-win32-x64-msvc": "0.25.0"
   },
   "engines": {
     "node": ">=22.18.0"