@rotifer/playground 0.31.0 → 0.33.0

package/dist/utils/clawhub-client.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * The two ClawHub endpoints `wrap --from-clawhub` uses: skill metadata and
+ * the skill package.
+ *
+ * Both sit in front of ClawHub's Convex backend, which is slow (4–11 s per
+ * answer) and fails about one request in six with HTTP 500
+ * `[Request ID: …] Server Error` — from any network, measured 2026-10-31.
+ * So every request here has a timeout, transient failures (5xx, 408, 429, a
+ * timeout, a network error) are retried with backoff, and a failure that
+ * survives the retries says exactly what it was: a 404 is "not found", a 500
+ * carries ClawHub's own message, a non-JSON answer names its content type.
+ * Before this, all of them read "not found or API error", which is how a
+ * flaky upstream passed for a missing skill.
+ *
+ * `fetch` follows 301/302/307/308. The download endpoint answers 307, which
+ * an earlier hand-written client did not follow (2026-08-31).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClawHubError = exports.CLAWHUB_DOWNLOAD = exports.CLAWHUB_API = void 0;
+exports.clawHubEndpoints = clawHubEndpoints;
+exports.fetchClawHubInfo = fetchClawHubInfo;
+exports.fetchClawHubPackage = fetchClawHubPackage;
+exports.CLAWHUB_API = "https://clawhub.ai/api/skill";
+exports.CLAWHUB_DOWNLOAD = "https://wry-manatee-359.convex.site/api/v1/download";
+class ClawHubError extends Error {
+    kind;
+    url;
+    attempts;
+    status;
+    detail;
+    constructor(kind, url, attempts, status, detail) {
+        super(describeFailure(kind, attempts, status, detail));
+        this.kind = kind;
+        this.url = url;
+        this.attempts = attempts;
+        this.status = status;
+        this.detail = detail;
+        this.name = "ClawHubError";
+    }
+}
+exports.ClawHubError = ClawHubError;
+function describeFailure(kind, attempts, status, detail) {
+    const tries = `${attempts} attempt${attempts === 1 ? "" : "s"}`;
+    switch (kind) {
+        case "not_found":
+            return `not found (HTTP ${status ?? 404})`;
+        case "http":
+            return `HTTP ${status}${detail ? ` — ${detail}` : ""} (${tries})`;
+        case "not_json":
+            return `the response was not JSON (${detail}) (${tries})`;
+        case "timeout":
+            return `no answer within ${detail} (${tries})`;
+        case "network":
+            return `network error: ${detail} (${tries})`;
+    }
+}
+const DEFAULTS = {
+    attempts: 3,
+    // A successful answer takes up to ~11 s; leave room above that.
+    timeoutMs: 30_000,
+    retryDelaysMs: [1_000, 3_000],
+};
+const LOOPBACK = new Set(["127.0.0.1", "localhost", "[::1]", "::1"]);
+/**
+ * The endpoints, or the overrides in ROTIFER_CLAWHUB_API_URL /
+ * ROTIFER_CLAWHUB_DOWNLOAD_URL (a mirror, or a local fixture in tests). An
+ * override must be https, or plain http to a loopback address; anything else
+ * is refused rather than silently sending requests somewhere unencrypted.
+ */
+function clawHubEndpoints(env = process.env) {
+    return {
+        api: checkedOverride("ROTIFER_CLAWHUB_API_URL", env.ROTIFER_CLAWHUB_API_URL) ?? exports.CLAWHUB_API,
+        download: checkedOverride("ROTIFER_CLAWHUB_DOWNLOAD_URL", env.ROTIFER_CLAWHUB_DOWNLOAD_URL) ?? exports.CLAWHUB_DOWNLOAD,
+    };
+}
+function checkedOverride(name, value) {
+    if (!value)
+        return undefined;
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        throw new Error(`${name} is not a URL: ${value}`);
+    }
+    if (url.protocol === "https:" || (url.protocol === "http:" && LOOPBACK.has(url.hostname))) {
+        return value;
+    }
+    throw new Error(`${name} must be https, or http to a loopback address: ${value}`);
+}
+function isTransientStatus(status) {
+    return status >= 500 || status === 408 || status === 429;
+}
+/** ClawHub's error text: the `code` / `message` / `error` field, or the body. */
+function errorDetail(body) {
+    let text = body.trim();
+    try {
+        const parsed = JSON.parse(text);
+        const field = ["code", "message", "error"].map((k) => parsed[k]).find((v) => typeof v === "string");
+        if (typeof field === "string")
+            text = field;
+    }
+    catch {
+        // not JSON: keep the text
+    }
+    return text.length > 200 ? `${text.slice(0, 200)}…` : text;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function request(url, options) {
+    const attempts = Math.max(1, options.attempts ?? DEFAULTS.attempts);
+    const timeoutMs = options.timeoutMs ?? DEFAULTS.timeoutMs;
+    const delays = options.retryDelaysMs ?? DEFAULTS.retryDelaysMs;
+    const doFetch = options.fetchImpl ?? fetch;
+    let last;
+    for (let attempt = 1; attempt <= attempts; attempt++) {
+        let failure;
+        try {
+            const res = await doFetch(url, { redirect: "follow", signal: AbortSignal.timeout(timeoutMs) });
+            const body = Buffer.from(await res.arrayBuffer());
+            if (res.status === 200) {
+                return { status: 200, contentType: res.headers.get("content-type") ?? "", body };
+            }
+            const detail = errorDetail(body.toString("utf-8"));
+            if (res.status === 404)
+                throw new ClawHubError("not_found", url, attempt, 404, detail);
+            failure = new ClawHubError("http", url, attempt, res.status, detail);
+            if (!isTransientStatus(res.status))
+                throw failure;
+        }
+        catch (e) {
+            if (e instanceof ClawHubError)
+                throw e;
+            const err = e;
+            failure =
+                err.name === "TimeoutError" || err.name === "AbortError"
+                    ? new ClawHubError("timeout", url, attempt, undefined, timeoutMs >= 1000 ? `${Math.round(timeoutMs / 1000)} s` : `${timeoutMs} ms`)
+                    : new ClawHubError("network", url, attempt, undefined, err.cause?.code ?? err.cause?.message ?? err.message);
+        }
+        last = failure;
+        if (attempt < attempts) {
+            options.onRetry?.(attempt, attempts, failure);
+            await sleep(delays[Math.min(attempt - 1, delays.length - 1)] ?? 0);
+        }
+    }
+    throw last;
+}
+async function fetchClawHubInfo(slug, options = {}) {
+    const url = `${options.api ?? clawHubEndpoints().api}?slug=${encodeURIComponent(slug)}`;
+    const answer = await request(url, options);
+    let data;
+    try {
+        data = JSON.parse(answer.body.toString("utf-8"));
+    }
+    catch {
+        throw new ClawHubError("not_json", url, 1, 200, `content-type ${answer.contentType || "unknown"}`);
+    }
+    if (!data.skill)
+        throw new ClawHubError("not_found", url, 1, 200, "the answer names no skill");
+    return {
+        slug: data.skill.slug,
+        displayName: data.skill.displayName,
+        summary: data.skill.summary,
+        stats: data.skill.stats,
+        owner: { handle: data.owner?.handle || "unknown", displayName: data.owner?.displayName || "" },
+        version: data.latestVersion?.version || "0.0.0",
+    };
+}
+/** The skill package (a zip). */
+async function fetchClawHubPackage(slug, options = {}) {
+    const url = `${options.download ?? clawHubEndpoints().download}?slug=${encodeURIComponent(slug)}`;
+    return (await request(url, options)).body;
+}
+//# sourceMappingURL=clawhub-client.js.map

package/dist/utils/clawhub-client.js.map

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

package/dist/utils/config.d.ts

@@ -6,6 +6,13 @@ export interface RotiferConfig {
     default_domain?: string;
 }
 export declare function findProjectRoot(startDir?: string): string | null;
+/**
+ * rotifer.json exists but cannot be read as a config. The CLI entry point
+ * reports it as a message, not a stack (#456); the file is never rewritten.
+ */
+export declare class ConfigError extends Error {
+    name: string;
+}
 export declare function loadConfig(projectDir?: string): RotiferConfig;
 export declare function saveConfig(config: RotiferConfig, projectDir: string): void;
 export declare function getProjectRoot(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAS/E;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAW7D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG1E;AAED,wBAAgB,cAAc,IAAI,MAAM,CAQvC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAID,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI,CAS/E;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,SAAiB;CAC/B;AAED,wBAAgB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,CAe7D;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAG1E;AAED,wBAAgB,cAAc,IAAI,MAAM,CAQvC"}

package/dist/utils/config.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigError = void 0;
 exports.findProjectRoot = findProjectRoot;
 exports.loadConfig = loadConfig;
 exports.saveConfig = saveConfig;
@@ -17,6 +18,14 @@ function findProjectRoot(startDir = process.cwd()) {
     }
     return null;
 }
+/**
+ * rotifer.json exists but cannot be read as a config. The CLI entry point
+ * reports it as a message, not a stack (#456); the file is never rewritten.
+ */
+class ConfigError extends Error {
+    name = "ConfigError";
+}
+exports.ConfigError = ConfigError;
 function loadConfig(projectDir) {
     const root = projectDir || findProjectRoot();
     if (!root) {
@@ -24,7 +33,12 @@ function loadConfig(projectDir) {
     }
     const configPath = (0, node_path_1.join)(root, CONFIG_FILE);
     const content = (0, node_fs_1.readFileSync)(configPath, "utf-8");
-    return JSON.parse(content);
+    try {
+        return JSON.parse(content);
+    }
+    catch (err) {
+        throw new ConfigError(`${configPath} is not valid JSON: ${err.message}`);
+    }
 }
 function saveConfig(config, projectDir) {
     const configPath = (0, node_path_1.join)(projectDir, CONFIG_FILE);

package/dist/utils/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";;AAaA,0CASC;AAED,gCAWC;AAED,gCAGC;AAED,wCAQC;AAlDD,qCAAkE;AAClE,yCAAiC;AAUjC,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,IAAI,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,mCAAmC,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;AAC9C,CAAC;AAED,SAAgB,UAAU,CAAC,MAAqB,EAAE,UAAkB;IAClE,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,IAAA,uBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,6DAA6D,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":";;;AAaA,0CASC;AAUD,gCAeC;AAED,gCAGC;AAED,wCAQC;AA9DD,qCAAkE;AAClE,yCAAiC;AAUjC,MAAM,WAAW,GAAG,cAAc,CAAC;AAEnC,SAAgB,eAAe,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAC9D,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,GAAG,KAAK,GAAG,EAAE,CAAC;QACnB,IAAI,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,GAAG,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC;YACvC,OAAO,GAAG,CAAC;QACb,CAAC;QACD,GAAG,GAAG,IAAA,gBAAI,EAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,GAAG,aAAa,CAAC;CAC/B;AAFD,kCAEC;AAED,SAAgB,UAAU,CAAC,UAAmB;IAC5C,MAAM,IAAI,GAAG,UAAU,IAAI,eAAe,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,mCAAmC,CACrD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAA,sBAAY,EAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;IAC9C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,WAAW,CAAC,GAAG,UAAU,uBAAwB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAED,SAAgB,UAAU,CAAC,MAAqB,EAAE,UAAkB;IAClE,MAAM,UAAU,GAAG,IAAA,gBAAI,EAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACjD,IAAA,uBAAa,EAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,MAAM,WAAW,6DAA6D,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -1,5 +1,13 @@
 /**
- * The §5.1 fitness formula, in one place.
+ * The §5.1 fitness formula, in one place, normalized to [0, 1] (ADR-346):
+ *
+ *   F(g) = S_r · log₂(1 + C_util) · (1 + R_rob)/2 · L_score · Cost_score
+ *
+ * Five factors, each in [0, 1], so F(g) is in [0, 1] with no cap; the maximum,
+ * exactly 1, is S_r = C_util = R_rob = 1 at zero latency and cost. This equals
+ * the ADR-318 D2 form divided by 2·ln 2, but is written as the product so the
+ * maximum comes out as exactly 1 rather than as a quotient that could round
+ * past it. The spec's original statement was
  *
  *   F(g) = [S_r · ln(1 + C_util) · (1 + R_rob)] / [L · Resource_Cost]
  *
@@ -25,6 +33,14 @@
  * 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.
  */
+/**
+ * Which formula `computeBaseFitness` implements, numbered as rotifer-core's
+ * `fitness::FORMULA_VERSION`: 1 additive, 2 multiplicative in (0, 2·ln 2]
+ * (ADR-318 D2), 3 multiplicative normalized to [0, 1] (ADR-346). Sent with
+ * every Arena upload as `formula_version`, so the registry can tell the scales
+ * apart.
+ */
+export declare const FITNESS_FORMULA_VERSION = 3;
 /**
  * Fallback L_ref: latency at which L_score halves when no season median is
  * available. `[N]` — provisional, uncalibrated.
@@ -46,8 +62,8 @@ export declare const LATENCY_SCALE_MS = 1000;
  * 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)
+ * Cost_score of 0.008 or below and F(g) collapses to ~0.002 — far under
+ * any admission threshold. 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
@@ -117,7 +133,7 @@ export interface FitnessInputs {
 }
 export interface FitnessBreakdown {
     /**
-     * F(g), in (0, 2·ln 2] ≈ (0, 1.386].
+     * F(g), in [0, 1] (ADR-346).
      *
      * Not capped. The old `min(1.0)` was there because dividing by the
      * efficiency scores made the value unbounded — with them multiplied the

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

@@ -1 +1 @@
-{"version":3,"file":"fitness-formula.d.ts","sourceRoot":"","sources":["../../src/utils/fitness-formula.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAGtD,CAAC;AAEH,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAKpE;AAED,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IACrC;;;;;;;;OAQG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GACvF,OAAO,CAAC,iBAAiB,CAAC,CAuC5B;AAED,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,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAyB,GAAG,MAAM,CAErG;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,GAAE,MAA6B,GAAG,MAAM,CAE7G;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,cAAmC,GAC7C,gBAAgB,CAWlB"}
+{"version":3,"file":"fitness-formula.d.ts","sourceRoot":"","sources":["../../src/utils/fitness-formula.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,cAAc,CAGtD,CAAC;AAEH,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAKpE;AAED,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,cAAc,CAAC;IACtB,MAAM,EAAE,eAAe,GAAG,UAAU,CAAC;IACrC;;;;;;;;OAQG;IACH,YAAY,EAAE,OAAO,CAAC;IACtB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GACvF,OAAO,CAAC,iBAAiB,CAAC,CAuC5B;AAED,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,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAyB,GAAG,MAAM,CAErG;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,GAAE,MAA6B,GAAG,MAAM,CAE7G;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,cAAmC,GAC7C,gBAAgB,CAalB"}

package/dist/utils/fitness-formula.js

@@ -1,6 +1,14 @@
 "use strict";
 /**
- * The §5.1 fitness formula, in one place.
+ * The §5.1 fitness formula, in one place, normalized to [0, 1] (ADR-346):
+ *
+ *   F(g) = S_r · log₂(1 + C_util) · (1 + R_rob)/2 · L_score · Cost_score
+ *
+ * Five factors, each in [0, 1], so F(g) is in [0, 1] with no cap; the maximum,
+ * exactly 1, is S_r = C_util = R_rob = 1 at zero latency and cost. This equals
+ * the ADR-318 D2 form divided by 2·ln 2, but is written as the product so the
+ * maximum comes out as exactly 1 rather than as a quotient that could round
+ * past it. The spec's original statement was
  *
  *   F(g) = [S_r · ln(1 + C_util) · (1 + R_rob)] / [L · Resource_Cost]
  *
@@ -27,12 +35,20 @@
  * tests in `tests/unit/fitness-formula.test.ts` hold the direction.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.REFERENCE_FUNCTION_MISSING = exports.FALLBACK_REFERENCE = exports.RESOURCE_SCALE_UNITS = exports.LATENCY_SCALE_MS = void 0;
+exports.REFERENCE_FUNCTION_MISSING = exports.FALLBACK_REFERENCE = exports.RESOURCE_SCALE_UNITS = exports.LATENCY_SCALE_MS = exports.FITNESS_FORMULA_VERSION = void 0;
 exports.isUsableReference = isUsableReference;
 exports.resolveFitnessReference = resolveFitnessReference;
 exports.latencyScoreFor = latencyScoreFor;
 exports.resourceEfficiencyFor = resourceEfficiencyFor;
 exports.computeBaseFitness = computeBaseFitness;
+/**
+ * Which formula `computeBaseFitness` implements, numbered as rotifer-core's
+ * `fitness::FORMULA_VERSION`: 1 additive, 2 multiplicative in (0, 2·ln 2]
+ * (ADR-318 D2), 3 multiplicative normalized to [0, 1] (ADR-346). Sent with
+ * every Arena upload as `formula_version`, so the registry can tell the scales
+ * apart.
+ */
+exports.FITNESS_FORMULA_VERSION = 3;
 /**
  * Fallback L_ref: latency at which L_score halves when no season median is
  * available. `[N]` — provisional, uncalibrated.
@@ -54,8 +70,8 @@ exports.LATENCY_SCALE_MS = 1000;
  * 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)
+ * Cost_score of 0.008 or below and F(g) collapses to ~0.002 — far under
+ * any admission threshold. 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
@@ -144,10 +160,12 @@ function computeBaseFitness(inputs, reference = exports.FALLBACK_REFERENCE) {
     const scale = isUsableReference(reference) ? reference : exports.FALLBACK_REFERENCE;
     const latencyScore = latencyScoreFor(inputs.avgLatencyMs, scale.latencyMs);
     const resourceEfficiency = resourceEfficiencyFor(inputs.avgResourceCost, scale.resourceCost);
-    const quality = inputs.successRate * Math.log1p(inputs.coverage) * (1 + inputs.robustness);
+    // Each factor is in [0, 1]: log₂(1 + C) is 1 at C = 1 and (1 + R)/2 is 1 at
+    // R = 1 — exactly, which keeps the product's maximum at exactly 1.
+    const quality = inputs.successRate * Math.log2(1 + inputs.coverage) * ((1 + inputs.robustness) / 2);
     // 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.
+    // every factor is in [0, 1], so the product is too.
     const value = quality * latencyScore * resourceEfficiency;
     return { value, latencyScore, resourceEfficiency };
 }

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

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

package/dist/utils/gene-id-display.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Print the gene's v2 ID, or why it has none (docs/gene-id-v2.md) — the ID
+ * the protocol names the gene by: P2P announces it and agent memory records
+ * it as createdBy. Not the unprefixed phenotype hash (superseded).
+ */
+export declare function showGeneIdV2(geneDir: string): void;
+/**
+ * Print the content_hash `rotifer publish` sends for this phenotype
+ * (docs/content-hash-v1.md, ADR-341) — what install compares against.
+ * Labelled for what it is: a hash of phenotype.json as it stands, not an
+ * identity (that is the v2 ID above).
+ */
+export declare function showContentHash(phenotype: Record<string, unknown>): void;
+//# sourceMappingURL=gene-id-display.d.ts.map

package/dist/utils/gene-id-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gene-id-display.d.ts","sourceRoot":"","sources":["../../src/utils/gene-id-display.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAExE"}

package/dist/utils/gene-id-display.js

@@ -0,0 +1,64 @@
+"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.showGeneIdV2 = showGeneIdV2;
+exports.showContentHash = showContentHash;
+const node_path_1 = require("node:path");
+const display = __importStar(require("./display.js"));
+const palette_js_1 = require("./palette.js");
+const binding_js_1 = require("./binding.js");
+const content_hash_js_1 = require("./content-hash.js");
+/**
+ * Print the gene's v2 ID, or why it has none (docs/gene-id-v2.md) — the ID
+ * the protocol names the gene by: P2P announces it and agent memory records
+ * it as createdBy. Not the unprefixed phenotype hash (superseded).
+ */
+function showGeneIdV2(geneDir) {
+    const r = (0, binding_js_1.geneIdV2)((0, node_path_1.dirname)(geneDir), (0, node_path_1.basename)(geneDir));
+    if ("id" in r)
+        display.keyValue("Gene ID (v2)", palette_js_1.c.warn(r.id));
+    else
+        display.keyValue("Gene ID (v2)", `not computable — ${r.reason}`);
+}
+/**
+ * Print the content_hash `rotifer publish` sends for this phenotype
+ * (docs/content-hash-v1.md, ADR-341) — what install compares against.
+ * Labelled for what it is: a hash of phenotype.json as it stands, not an
+ * identity (that is the v2 ID above).
+ */
+function showContentHash(phenotype) {
+    display.keyValue("Content hash", `${(0, content_hash_js_1.contentHash)(phenotype)} (phenotype.json as publish sends it — not an identity)`);
+}
+//# sourceMappingURL=gene-id-display.js.map

package/dist/utils/gene-id-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gene-id-display.js","sourceRoot":"","sources":["../../src/utils/gene-id-display.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAWA,oCAIC;AAQD,0CAEC;AAzBD,yCAA8C;AAC9C,sDAAwC;AACxC,6CAAiC;AACjC,6CAAwC;AACxC,uDAAgD;AAEhD;;;;GAIG;AACH,SAAgB,YAAY,CAAC,OAAe;IAC1C,MAAM,CAAC,GAAG,IAAA,qBAAQ,EAAC,IAAA,mBAAO,EAAC,OAAO,CAAC,EAAE,IAAA,oBAAQ,EAAC,OAAO,CAAC,CAAC,CAAC;IACxD,IAAI,IAAI,IAAI,CAAC;QAAE,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;;QACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,SAAkC;IAChE,OAAO,CAAC,QAAQ,CAAC,cAAc,EAAE,GAAG,IAAA,6BAAW,EAAC,SAAS,CAAC,yDAAyD,CAAC,CAAC;AACvH,CAAC"}

package/dist/utils/l0-gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"l0-gate.d.ts","sourceRoot":"","sources":["../../src/utils/l0-gate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,SAAS,CAaX;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW5D"}
+{"version":3,"file":"l0-gate.d.ts","sourceRoot":"","sources":["../../src/utils/l0-gate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,aAAa,GAAG,IAAI,EAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,SAAS,CAeX;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAW5D"}

package/dist/utils/l0-gate.js

@@ -4,6 +4,7 @@ exports.evaluateL0 = evaluateL0;
 exports.isExternallySourced = isExternallySourced;
 const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
+const rust_phenotype_js_1 = require("./rust-phenotype.js");
 /**
  * 对一个基因的 phenotype 跑 L0 门控。
  *
@@ -18,8 +19,10 @@ function evaluateL0(binding, phenotype) {
         return { kind: "unavailable", detail: "native addon failed to load" };
     }
     try {
+        // In rotifer-core's shape: wrap's ISO createdAt made every wrapped gene's
+        // gate "unavailable" before (#448), which runs a local gene unchecked.
         const { irHash: _strip, ...phenotypeForL0 } = phenotype;
-        const result = binding.l0Check(JSON.stringify(phenotypeForL0));
+        const result = binding.l0Check(JSON.stringify((0, rust_phenotype_js_1.toRustPhenotype)(phenotypeForL0)));
         return result.passed
             ? { kind: "pass" }
             : { kind: "violation", detail: result.violations.join("; ") };

package/dist/utils/l0-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"l0-gate.js","sourceRoot":"","sources":["../../src/utils/l0-gate.ts"],"names":[],"mappings":";;AA6BA,gCAgBC;AAuBD,kDAWC;AA/ED,qCAAmD;AACnD,yCAAiC;AAmBjC;;;;;;;;GAQG;AACH,SAAgB,UAAU,CACxB,OAA6B,EAC7B,SAAkC;IAElC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,MAAM;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,yBAAyB,GAAG,EAAE,OAAO,IAAI,GAAG,GAAG,EAAE,CAAC;IAC1F,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAA,oBAAU,EAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAA4B,CAAC;QACrF,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC;QAC3D,MAAM,eAAe,GAAG,cAAc,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}
+{"version":3,"file":"l0-gate.js","sourceRoot":"","sources":["../../src/utils/l0-gate.ts"],"names":[],"mappings":";;AA8BA,gCAkBC;AAuBD,kDAWC;AAlFD,qCAAmD;AACnD,yCAAiC;AAEjC,2DAAsD;AAkBtD;;;;;;;;GAQG;AACH,SAAgB,UAAU,CACxB,OAA6B,EAC7B,SAAkC;IAElC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxE,CAAC;IACD,IAAI,CAAC;QACH,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,GAAG,SAAS,CAAC;QACxD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAA,mCAAe,EAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAChF,OAAO,MAAM,CAAC,MAAM;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE;YAClB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IAClE,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,yBAAyB,GAAG,EAAE,OAAO,IAAI,GAAG,GAAG,EAAE,CAAC;IAC1F,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,mBAAmB,CAAC,OAAe;IACjD,MAAM,YAAY,GAAG,IAAA,gBAAI,EAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAA,oBAAU,EAAC,YAAY,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,sBAAY,EAAC,YAAY,EAAE,OAAO,CAAC,CAA4B,CAAC;QACrF,MAAM,eAAe,GAAG,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,CAAC;QAC3D,MAAM,eAAe,GAAG,cAAc,IAAI,CAAC,CAAC;QAC5C,OAAO,CAAC,CAAC,eAAe,IAAI,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/rust-phenotype.d.ts

@@ -10,15 +10,27 @@
  *
  * Values are converted, not dropped. A value that cannot be converted
  * faithfully (an irHash that is not 32 bytes of hex, a createdAt that is not a
- * date) is omitted, so Rust falls back to its serde default (`None` / `0`).
- * None of the three fields is read while executing a gene — they are
- * metadata — so omitting one does not change what runs.
+ * date, a dependency named without a way to resolve the name) is omitted, so
+ * Rust falls back to its serde default (`None` / `0` / empty). None of the
+ * three fields is read while executing a gene — they are metadata — so
+ * omitting one does not change what runs. A caller that must not lose a value
+ * silently checks `createdAtProblem` first.
+ *
+ * Every path that hands a phenotype.json to rotifer-core goes through this:
+ * `agent run`'s algebra executor, `compile`'s IR compiler (#448), the L0 gate
+ * and `test --compliance` (#449).
  *
  * Other fields pass through unchanged.
  */
+/**
+ * Why `createdAt` cannot be converted, or undefined when it can (or is absent).
+ * For callers that report the field rather than let Rust default it to 0.
+ */
+export declare function createdAtProblem(phenotype: Record<string, unknown>): string | undefined;
 /**
  * @param geneId maps a dependency given by gene name to its gene id, using the
- *   same derivation as the gene entries passed alongside the phenotype.
+ *   same derivation as the gene entries passed alongside the phenotype. Without
+ *   it, only dependencies already given as 64-char hex ids are kept.
  */
-export declare function toRustPhenotype(phenotype: Record<string, unknown>, geneId: (geneName: string) => string): Record<string, unknown>;
+export declare function toRustPhenotype(phenotype: Record<string, unknown>, geneId?: (geneName: string) => string): Record<string, unknown>;
 //# sourceMappingURL=rust-phenotype.d.ts.map

package/dist/utils/rust-phenotype.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rust-phenotype.d.ts","sourceRoot":"","sources":["../../src/utils/rust-phenotype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAqBH;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GACnC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkBzB"}
+{"version":3,"file":"rust-phenotype.d.ts","sourceRoot":"","sources":["../../src/utils/rust-phenotype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAqBH;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,SAAS,CAKvF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GACpC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBzB"}

package/dist/utils/rust-phenotype.js

@@ -11,13 +11,20 @@
  *
  * Values are converted, not dropped. A value that cannot be converted
  * faithfully (an irHash that is not 32 bytes of hex, a createdAt that is not a
- * date) is omitted, so Rust falls back to its serde default (`None` / `0`).
- * None of the three fields is read while executing a gene — they are
- * metadata — so omitting one does not change what runs.
+ * date, a dependency named without a way to resolve the name) is omitted, so
+ * Rust falls back to its serde default (`None` / `0` / empty). None of the
+ * three fields is read while executing a gene — they are metadata — so
+ * omitting one does not change what runs. A caller that must not lose a value
+ * silently checks `createdAtProblem` first.
+ *
+ * Every path that hands a phenotype.json to rotifer-core goes through this:
+ * `agent run`'s algebra executor, `compile`'s IR compiler (#448), the L0 gate
+ * and `test --compliance` (#449).
  *
  * Other fields pass through unchanged.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.createdAtProblem = createdAtProblem;
 exports.toRustPhenotype = toRustPhenotype;
 const HEX_32_BYTES = /^[0-9a-fA-F]{64}$/;
 function hexToBytes(hex) {
@@ -36,9 +43,22 @@ function toEpochMillis(value) {
     }
     return undefined;
 }
+/**
+ * Why `createdAt` cannot be converted, or undefined when it can (or is absent).
+ * For callers that report the field rather than let Rust default it to 0.
+ */
+function createdAtProblem(phenotype) {
+    const { createdAt } = phenotype;
+    if (createdAt === undefined)
+        return undefined;
+    if (toEpochMillis(createdAt) !== undefined)
+        return undefined;
+    return `createdAt ${JSON.stringify(createdAt)} is not a date: use epoch milliseconds or an ISO 8601 timestamp`;
+}
 /**
  * @param geneId maps a dependency given by gene name to its gene id, using the
- *   same derivation as the gene entries passed alongside the phenotype.
+ *   same derivation as the gene entries passed alongside the phenotype. Without
+ *   it, only dependencies already given as 64-char hex ids are kept.
  */
 function toRustPhenotype(phenotype, geneId) {
     const { irHash, createdAt, dependencies, ...rest } = phenotype;
@@ -52,6 +72,7 @@ function toRustPhenotype(phenotype, geneId) {
     if (Array.isArray(dependencies)) {
         out.dependencies = dependencies
             .filter((d) => typeof d === "string" && d.length > 0)
+            .filter((d) => HEX_32_BYTES.test(d) || geneId !== undefined)
             .map((d) => hexToBytes(HEX_32_BYTES.test(d) ? d : geneId(d)));
     }
     return out;

package/dist/utils/rust-phenotype.js.map

@@ -1 +1 @@
-{"version":3,"file":"rust-phenotype.js","sourceRoot":"","sources":["../../src/utils/rust-phenotype.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;AAyBH,0CAqBC;AA5CD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAC7B,SAAkC,EAClC,MAAoC;IAEpC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IAC/D,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,EAAE,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC;IAEzC,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,YAAY,GAAG,YAAY;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"rust-phenotype.js","sourceRoot":"","sources":["../../src/utils/rust-phenotype.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;AAyBH,4CAKC;AAOD,0CAsBC;AAzDD,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC,SAAS,UAAU,CAAC,GAAW;IAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC9E,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,SAAkC;IACjE,MAAM,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAChC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,IAAI,aAAa,CAAC,SAAS,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7D,OAAO,aAAa,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,iEAAiE,CAAC;AACjH,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,SAAkC,EAClC,MAAqC;IAErC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,SAAS,CAAC;IAC/D,MAAM,GAAG,GAA4B,EAAE,GAAG,IAAI,EAAE,CAAC;IAEjD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,EAAE,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,EAAE,KAAK,SAAS;QAAE,GAAG,CAAC,SAAS,GAAG,EAAE,CAAC;IAEzC,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,YAAY,GAAG,YAAY;aAC5B,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;aACjE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,KAAK,SAAS,CAAC;aAC3D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}