@rotifer/playground 0.19.1 → 0.19.2

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

@@ -0,0 +1,44 @@
+import type { NativeBinding } from "./binding.js";
+/**
+ * L0 门控的判定结果。
+ *
+ * 关键在于把两件事分开——它们的正确应对完全不同：
+ *
+ *   - `violation`：门控**跑了**，并且判定这个基因不该执行。这是安全结论，
+ *     硬拒绝，没有逃生阀。
+ *   - `unavailable`：门控**跑不了**（原生插件缺失、phenotype 读不出来）。
+ *     这是环境/数据问题，不是关于这个基因的安全结论——把它当成违规一律拒绝，
+ *     代价是整个 CLI 在拿不到预编译二进制的平台上彻底不可用。
+ */
+export type L0Outcome = {
+    kind: "pass";
+} | {
+    kind: "violation";
+    detail: string;
+} | {
+    kind: "unavailable";
+    detail: string;
+};
+/**
+ * 对一个基因的 phenotype 跑 L0 门控。
+ *
+ * 三条 unavailable 分支都不抛异常：Rust 侧 `Phenotype` 的 domain / inputSchema /
+ * outputSchema / version 没有 serde default，是真必填；而 CLI 侧 `phenotype` 是
+ * `any`、解析后从不做结构校验。一个 phenotype 还没写完整的开发中基因会让 napi
+ * 反序列化失败并抛出去——调用点若不接，用户看到的是暴露内部路径的 Node 栈跟踪，
+ * TryPool 那种本该故障转移的场景还会整个进程崩掉。
+ */
+export declare function evaluateL0(binding: NativeBinding | null, phenotype: Record<string, unknown>): L0Outcome;
+/**
+ * 门控跑不了时，这个基因还能不能放行——取决于它是谁写的。
+ *
+ * 外部来源的基因（装过来的、带 `.cloud-manifest.json`）一律拒绝：代码不是用户
+ * 写的，没有沙箱也没有门控就以宿主全权限跑它，正是这次修复要堵的东西。
+ *
+ * 本地源码基因放行并警告：代码就在用户自己的项目里、可读可改，而降级路径下的
+ * L0 本来也只查元数据、拦不住实际行为，所以这里的安全损失有限；反过来，拒绝它
+ * 的代价是 `rotifer run` / `agent run` 在任何拿不到原生插件的环境里彻底不可用
+ * （不受支持的平台、optional dependency 装失败、发布分支 CI 的锁文件窗口）。
+ */
+export declare function isExternallySourced(geneDir: string): boolean;
+//# sourceMappingURL=l0-gate.d.ts.map

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

@@ -0,0 +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;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE5D"}

package/dist/utils/l0-gate.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evaluateL0 = evaluateL0;
+exports.isExternallySourced = isExternallySourced;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * 对一个基因的 phenotype 跑 L0 门控。
+ *
+ * 三条 unavailable 分支都不抛异常：Rust 侧 `Phenotype` 的 domain / inputSchema /
+ * outputSchema / version 没有 serde default，是真必填；而 CLI 侧 `phenotype` 是
+ * `any`、解析后从不做结构校验。一个 phenotype 还没写完整的开发中基因会让 napi
+ * 反序列化失败并抛出去——调用点若不接，用户看到的是暴露内部路径的 Node 栈跟踪，
+ * TryPool 那种本该故障转移的场景还会整个进程崩掉。
+ */
+function evaluateL0(binding, phenotype) {
+    if (!binding) {
+        return { kind: "unavailable", detail: "native addon failed to load" };
+    }
+    try {
+        const { irHash: _strip, ...phenotypeForL0 } = phenotype;
+        const result = binding.l0Check(JSON.stringify(phenotypeForL0));
+        return result.passed
+            ? { kind: "pass" }
+            : { kind: "violation", detail: result.violations.join("; ") };
+    }
+    catch (err) {
+        return { kind: "unavailable", detail: `phenotype unreadable (${err?.message ?? err})` };
+    }
+}
+/**
+ * 门控跑不了时，这个基因还能不能放行——取决于它是谁写的。
+ *
+ * 外部来源的基因（装过来的、带 `.cloud-manifest.json`）一律拒绝：代码不是用户
+ * 写的，没有沙箱也没有门控就以宿主全权限跑它，正是这次修复要堵的东西。
+ *
+ * 本地源码基因放行并警告：代码就在用户自己的项目里、可读可改，而降级路径下的
+ * L0 本来也只查元数据、拦不住实际行为，所以这里的安全损失有限；反过来，拒绝它
+ * 的代价是 `rotifer run` / `agent run` 在任何拿不到原生插件的环境里彻底不可用
+ * （不受支持的平台、optional dependency 装失败、发布分支 CI 的锁文件窗口）。
+ */
+function isExternallySourced(geneDir) {
+    return (0, node_fs_1.existsSync)((0, node_path_1.join)(geneDir, ".cloud-manifest.json"));
+}
+//# sourceMappingURL=l0-gate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"l0-gate.js","sourceRoot":"","sources":["../../src/utils/l0-gate.ts"],"names":[],"mappings":";;AA6BA,gCAgBC;AAaD,kDAEC;AA5DD,qCAAqC;AACrC,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;;;;;;;;;;GAUG;AACH,SAAgB,mBAAmB,CAAC,OAAe;IACjD,OAAO,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "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.19.1",
-    "@rotifer/playground-darwin-x64": "0.19.1",
-    "@rotifer/playground-linux-x64-gnu": "0.19.1",
-    "@rotifer/playground-win32-x64-msvc": "0.19.1"
+    "@rotifer/playground-darwin-arm64": "0.19.2",
+    "@rotifer/playground-darwin-x64": "0.19.2",
+    "@rotifer/playground-linux-x64-gnu": "0.19.2",
+    "@rotifer/playground-win32-x64-msvc": "0.19.2"
   },
   "engines": {
     "node": ">=20.0.0"