@rotifer/playground 0.25.1 → 0.26.0

package/genes/genesis-file-read/testsuite.json

@@ -0,0 +1,41 @@
+{
+  "testCases": [
+    {
+      "input": { "path": "package.json" },
+      "expectedSchema": {
+        "type": "object",
+        "required": ["content", "size", "encoding"],
+        "properties": {
+          "content": { "type": "string", "pattern": "@rotifer/playground" },
+          "size": { "type": "integer", "minimum": 1 },
+          "encoding": { "const": "utf-8" }
+        }
+      }
+    },
+    {
+      "input": { "path": 42 },
+      "expectedOutput": {
+        "content": "[error] INVALID_PATH: path must be a non-empty string",
+        "size": 0,
+        "encoding": "utf-8"
+      }
+    },
+    {
+      "input": { "encoding": "utf-8" },
+      "expectedOutput": {
+        "content": "[error] INVALID_PATH: path must be a non-empty string",
+        "size": 0,
+        "encoding": "utf-8"
+      }
+    },
+    {
+      "input": {},
+      "expectedOutput": {
+        "content": "[error] INVALID_PATH: path must be a non-empty string",
+        "size": 0,
+        "encoding": "utf-8"
+      }
+    }
+  ],
+  "config": { "fuzzIterations": 10, "seed": 1 }
+}

package/genes/genesis-web-search/.cloud-manifest.json

@@ -1,6 +1,6 @@
 {
-  "cloud_id": "6fb2ebac-a229-4e4c-95d8-9b7ce751d8bf",
-  "owner": "Rotifer Protocol",
-  "version": "0.1.0",
-  "published_at": "2026-03-17T14:12:56.761Z"
+  "cloud_id": "ebb624a7-56aa-47be-8d98-52130e8d81c1",
+  "owner": "xiaoba-dev",
+  "version": "0.2.0",
+  "published_at": "2026-09-08T15:37:15.392Z"
 }

package/genes/genesis-web-search/index.ts

@@ -23,12 +23,31 @@ interface SearchOutput {
  */
 export function express(input: SearchInput): SearchOutput {
   const start = Date.now();
-  const max = input.maxResults ?? 5;
+
+  // `input.query` used to be interpolated straight into the result strings, so
+  // a missing field produced a simulated search for the literal "undefined" and
+  // a numeric one searched for "42". Neither is a search; both are the Gene
+  // answering confidently about a question nobody asked.
+  //
+  // Unlike a Gene with a documented default, there is nothing sensible to
+  // search for in place of a query, so this refuses: no query, no results. The
+  // shape still conforms to outputSchema, which is what "correct handling"
+  // means on this boundary (ADR-333).
+  const query: unknown = input.query;
+  if (typeof query !== "string" || query.trim() === "") {
+    return { results: [], totalResults: 0, searchTime: Date.now() - start };
+  }
+
+  const rawMax: unknown = input.maxResults;
+  const max =
+    typeof rawMax === "number" && Number.isInteger(rawMax) && rawMax > 0
+      ? Math.min(rawMax, 20)
+      : 5;
 
   const results: SearchResult[] = Array.from({ length: max }, (_, i) => ({
-    title: `Result ${i + 1} for "${input.query}"`,
-    url: `https://example.com/search?q=${encodeURIComponent(input.query)}&p=${i + 1}`,
-    snippet: `This is a simulated search result #${i + 1} for the query "${input.query}". In production, this gene binds to a real search provider.`,
+    title: `Result ${i + 1} for "${query}"`,
+    url: `https://example.com/search?q=${encodeURIComponent(query)}&p=${i + 1}`,
+    snippet: `This is a simulated search result #${i + 1} for the query "${query}". In production, this gene binds to a real search provider.`,
   }));
 
   return {

package/genes/genesis-web-search/phenotype.json

@@ -4,10 +4,20 @@
   "inputSchema": {
     "type": "object",
     "properties": {
-      "query": { "type": "string", "description": "Search query string" },
-      "maxResults": { "type": "integer", "default": 5, "minimum": 1, "maximum": 20 }
+      "query": {
+        "type": "string",
+        "description": "Search query string"
+      },
+      "maxResults": {
+        "type": "integer",
+        "default": 5,
+        "minimum": 1,
+        "maximum": 20
+      }
     },
-    "required": ["query"]
+    "required": [
+      "query"
+    ]
   },
   "outputSchema": {
     "type": "object",
@@ -17,14 +27,24 @@
         "items": {
           "type": "object",
           "properties": {
-            "title": { "type": "string" },
-            "url": { "type": "string" },
-            "snippet": { "type": "string" }
+            "title": {
+              "type": "string"
+            },
+            "url": {
+              "type": "string"
+            },
+            "snippet": {
+              "type": "string"
+            }
           }
         }
       },
-      "totalResults": { "type": "integer" },
-      "searchTime": { "type": "number" }
+      "totalResults": {
+        "type": "integer"
+      },
+      "searchTime": {
+        "type": "number"
+      }
     }
   },
   "dependencies": [],
@@ -38,5 +58,12 @@
     "concurrencyModel": "Stateless",
     "failureSemantics": "Retry"
   },
-  "tags": ["web-search", "results", "snippets", "async", "retrieval"]
+  "tags": [
+    "web-search",
+    "results",
+    "snippets",
+    "async",
+    "retrieval"
+  ],
+  "irHash": "9af9ccc90df36c586661876203b87f182c9fac65ebcfdec22c1e0d683be19b49"
 }

package/genes/genesis-web-search/testsuite.json

@@ -0,0 +1,82 @@
+{
+  "testCases": [
+    {
+      "input": {
+        "query": "rotifer protocol",
+        "maxResults": 2
+      },
+      "expectedSchema": {
+        "type": "object",
+        "required": [
+          "results",
+          "totalResults"
+        ],
+        "properties": {
+          "totalResults": {
+            "const": 2
+          },
+          "results": {
+            "type": "array",
+            "minItems": 2,
+            "items": {
+              "properties": {
+                "title": {
+                  "pattern": "rotifer protocol"
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "input": {
+        "maxResults": 3
+      },
+      "expectedSchema": {
+        "type": "object",
+        "required": [
+          "results",
+          "totalResults"
+        ],
+        "properties": {
+          "totalResults": {
+            "const": 0
+          },
+          "results": {
+            "type": "array",
+            "maxItems": 0
+          }
+        }
+      }
+    },
+    {
+      "input": {
+        "query": 42
+      },
+      "expectedSchema": {
+        "type": "object",
+        "properties": {
+          "totalResults": {
+            "const": 0
+          }
+        }
+      }
+    },
+    {
+      "input": {},
+      "expectedSchema": {
+        "type": "object",
+        "properties": {
+          "totalResults": {
+            "const": 0
+          }
+        }
+      }
+    }
+  ],
+  "config": {
+    "fuzzIterations": 10,
+    "seed": 1
+  }
+}

package/genes/genesis-web-search-lite/.cloud-manifest.json

@@ -1,6 +1,6 @@
 {
-  "cloud_id": "247f642a-8f45-418f-852b-38c0d5699270",
-  "owner": "Rotifer Protocol",
-  "version": "0.1.0",
-  "published_at": "2026-03-17T14:12:54.670Z"
+  "cloud_id": "9f3410dc-4edb-492e-bdd6-fb103fd106e1",
+  "owner": "xiaoba-dev",
+  "version": "0.2.0",
+  "published_at": "2026-09-08T15:37:48.867Z"
 }

package/genes/genesis-web-search-lite/index.ts

@@ -15,8 +15,20 @@ interface LiteSearchOutput {
  * with deadline constraints.
  */
 export function express(input: LiteSearchInput): LiteSearchOutput {
+  // Same defect as genesis-web-search: a missing query became a confident
+  // answer about "undefined". With no default query to fall back on, saying so
+  // is the only honest response — and it stays inside outputSchema, which is
+  // what refusal has to look like on this boundary (ADR-333).
+  const query: unknown = input.query;
+  if (typeof query !== "string" || query.trim() === "") {
+    return {
+      answer: "No query provided.",
+      source: "",
+    };
+  }
+
   return {
-    answer: `[Simulated] Quick answer for "${input.query}": This is a placeholder response from genesis-web-search-lite. In production, this returns a concise answer from a search provider.`,
-    source: "https://example.com/instant?q=" + encodeURIComponent(input.query),
+    answer: `[Simulated] Quick answer for "${query}": This is a placeholder response from genesis-web-search-lite. In production, this returns a concise answer from a search provider.`,
+    source: "https://example.com/instant?q=" + encodeURIComponent(query),
   };
 }

package/genes/genesis-web-search-lite/phenotype.json

@@ -4,15 +4,24 @@
   "inputSchema": {
     "type": "object",
     "properties": {
-      "query": { "type": "string", "description": "Search query string" }
+      "query": {
+        "type": "string",
+        "description": "Search query string"
+      }
     },
-    "required": ["query"]
+    "required": [
+      "query"
+    ]
   },
   "outputSchema": {
     "type": "object",
     "properties": {
-      "answer": { "type": "string" },
-      "source": { "type": "string" }
+      "answer": {
+        "type": "string"
+      },
+      "source": {
+        "type": "string"
+      }
     }
   },
   "dependencies": [],
@@ -25,5 +34,12 @@
     "concurrencyModel": "Stateless",
     "failureSemantics": "SILENT_DEGRADE"
   },
-  "tags": ["web-search", "single-answer", "attribution", "lightweight", "async"]
+  "tags": [
+    "web-search",
+    "single-answer",
+    "attribution",
+    "lightweight",
+    "async"
+  ],
+  "irHash": "e1bae37cdb28cdce1c4a3631bcb9e58eb8009a01d3d8f4c6b7f1555d38fd040d"
 }

package/genes/genesis-web-search-lite/testsuite.json

@@ -0,0 +1,24 @@
+{
+  "testCases": [
+    {
+      "input": { "query": "rotifer protocol" },
+      "expectedSchema": {
+        "type": "object",
+        "required": ["answer", "source"],
+        "properties": {
+          "answer": { "type": "string", "pattern": "rotifer protocol" },
+          "source": { "type": "string", "minLength": 1 }
+        }
+      }
+    },
+    {
+      "input": { "query": 42 },
+      "expectedOutput": { "answer": "No query provided.", "source": "" }
+    },
+    {
+      "input": {},
+      "expectedOutput": { "answer": "No query provided.", "source": "" }
+    }
+  ],
+  "config": { "fuzzIterations": 10, "seed": 1 }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.25.1",
+  "version": "0.26.0",
   "description": "Rotifer Protocol Playground — local development environment for gene development, Arena competition, and protocol simulation",
   "license": "Apache-2.0",
   "author": "Rotifer Protocol Contributors",
@@ -71,26 +71,31 @@
     "chalk": "^4.1.2",
     "commander": "^15.0.0"
   },
+  "overrides": {
+    "js-yaml": "^4.3.2",
+    "qs": "^6.16.0",
+    "@humanfs/node": "^0.16.8"
+  },
   "devDependencies": {
     "@napi-rs/cli": "^3.7.0",
     "@stryker-mutator/core": "10.0.0",
     "@stryker-mutator/vitest-runner": "10.0.0",
     "@supabase/supabase-js": "^2.105.4",
     "@types/node": "^25.9.2",
-    "@vitest/coverage-v8": "^4.1.2",
+    "@vitest/coverage-v8": "^4.1.11",
     "esbuild": "^0.28.1",
     "eslint": "^10.1.0",
     "javy-cli": "^3.0.1",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.58.0",
-    "vitest": "^4.0.0"
+    "vitest": "^4.1.11"
   },
   "optionalDependencies": {
     "@rolldown/binding-linux-x64-gnu": "1.1.1",
-    "@rotifer/playground-darwin-arm64": "0.25.1",
-    "@rotifer/playground-darwin-x64": "0.25.1",
-    "@rotifer/playground-linux-x64-gnu": "0.25.1",
-    "@rotifer/playground-win32-x64-msvc": "0.25.1"
+    "@rotifer/playground-darwin-arm64": "0.26.0",
+    "@rotifer/playground-darwin-x64": "0.26.0",
+    "@rotifer/playground-linux-x64-gnu": "0.26.0",
+    "@rotifer/playground-win32-x64-msvc": "0.26.0"
   },
   "engines": {
     "node": ">=22.18.0"