@rotifer/playground 0.7.8 → 0.8.0

package/genes/prompt-review-readability/system-prompt.md

@@ -0,0 +1,21 @@
+You are a readability-focused code reviewer. Your mission is to improve code clarity and maintainability.
+
+Focus areas (in priority order):
+1. **Naming**: unclear variable/function/class names, abbreviations, misleading names
+2. **Complexity**: functions >30 lines, nesting >3 levels, cyclomatic complexity >10
+3. **Documentation**: missing JSDoc/docstrings for public APIs, outdated comments
+4. **Patterns**: inconsistent error handling, mixed paradigms, anti-patterns
+5. **Structure**: god functions, missing abstractions, tight coupling
+6. **Dead code**: unused variables, unreachable branches, commented-out code
+7. **Consistency**: mixed naming conventions, inconsistent formatting within file
+
+For each finding, provide:
+- `severity`: "critical" (blocks understanding), "warning" (slows comprehension), "info" (style preference)
+- `category`: short tag (e.g., "naming", "complexity", "dead-code")
+- `message`: clear description of the readability issue
+- `line`: approximate line number
+- `fix`: concrete rewrite suggestion (show before/after when possible)
+
+Respect the codebase's existing style. Don't enforce personal preferences — focus on objective clarity improvements.
+
+Output valid JSON matching the output schema. Include a `readabilityScore` from 0 (unreadable) to 10 (exemplary).

package/genes/prompt-review-security/.gene-manifest.json

@@ -0,0 +1,8 @@
+{
+  "geneId": "0376427b53f9d478290a5908646720cb2772cca42981c85a84448cfa6eefca00",
+  "name": "prompt-review-security",
+  "domain": "prompt.code-review",
+  "fidelity": "Wrapped",
+  "wrappedAt": "2026-03-24T01:54:54.000Z",
+  "fromSkill": null
+}

package/genes/prompt-review-security/phenotype.json

@@ -0,0 +1,60 @@
+{
+  "domain": "prompt.code-review",
+  "description": "Code review gene specialized in security vulnerability detection. Identifies prompt injection, private key exposure, path traversal, SSRF, input validation gaps, and supply chain risks. Part of the Code Review Assistant 3×2 arena competition.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "code": { "type": "string", "description": "Source code to review" },
+      "language": { "type": "string", "description": "Programming language" },
+      "context": { "type": "string", "description": "File path or component context" }
+    },
+    "required": ["code"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "findings": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "severity": { "type": "string", "enum": ["critical", "warning", "info"] },
+            "category": { "type": "string" },
+            "message": { "type": "string" },
+            "line": { "type": "integer" },
+            "fix": { "type": "string" }
+          }
+        }
+      },
+      "summary": { "type": "string" },
+      "riskLevel": { "type": "string", "enum": ["high", "medium", "low", "none"] }
+    }
+  },
+  "llmRequirements": {
+    "templateFormat": "mustache",
+    "templateVariables": ["code", "language", "context"],
+    "targetModels": ["claude-3", "gpt-4"],
+    "minContextWindow": 8192,
+    "expectedOutputFormat": "json",
+    "temperatureHint": 0.1,
+    "maxOutputTokens": 4096,
+    "systemPromptPath": "system-prompt.md",
+    "chainOfThought": true
+  },
+  "fitnessConfig": {
+    "evaluationMethod": "template-quality",
+    "dimensions": {
+      "detectionRate": { "weight": 0.35, "description": "Fraction of known issues found in test corpus" },
+      "falsePositiveRate": { "weight": 0.25, "description": "1 - (false positives / total findings), higher is better" },
+      "responseQuality": { "weight": 0.20, "description": "Actionability of fix suggestions" },
+      "templateValidity": { "weight": 0.10, "description": "Template renders without error" },
+      "resourceEfficiency": { "weight": 0.10, "description": "Token efficiency of rendered prompt" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-team",
+  "fidelity": "Wrapped",
+  "transparency": "Open",
+  "source": "development-genome"
+}

package/genes/prompt-review-security/system-prompt.md

@@ -0,0 +1,21 @@
+You are a security-focused code reviewer. Your mission is to find security vulnerabilities in the provided code.
+
+Focus areas (in priority order):
+1. **Injection attacks**: SQL injection, prompt injection, command injection, XSS
+2. **Secret exposure**: hardcoded API keys, private keys, credentials in source
+3. **Path traversal**: `../` in file paths, unsanitized user input in file operations
+4. **SSRF/DNS rebinding**: fetch to user-controlled URLs, private IP access
+5. **Input validation**: missing type checks, unbounded inputs, prototype pollution
+6. **Authentication/Authorization**: missing auth checks, broken access control
+7. **Supply chain**: known vulnerable dependencies, typosquatting risks
+
+For each finding, provide:
+- `severity`: "critical" (exploitable), "warning" (potential risk), "info" (best practice)
+- `category`: short tag (e.g., "injection", "secret-exposure", "path-traversal")
+- `message`: clear description of the vulnerability
+- `line`: approximate line number
+- `fix`: concrete fix suggestion
+
+Be thorough but precise — false positives erode trust. Only flag genuine risks.
+
+Output valid JSON matching the output schema.

package/genes/rotifer-protocol/SKILL.md

@@ -117,5 +117,5 @@ rotifer agent run search-bot --input '{"query":"hello"}'
 - [rotifer.dev](https://rotifer.dev) — Website
 - [rotifer.dev/genes](https://rotifer.dev/genes/) — Gene Store
 - [rotifer.dev/docs](https://rotifer.dev/docs/) — Documentation
-- [GitLab](https://gitlab.com/rotifer-protocol/rotifer-playground) — Source
+- [GitHub](https://github.com/rotifer-protocol/rotifer-playground) — Source
 - [Discord](https://discord.gg/6d4JrfMr) — Community

package/genes/rule-router-frequency/.gene-manifest.json

@@ -0,0 +1,8 @@
+{
+  "geneId": "4e172b696388f8a3d488241dba2a62360567c4add7bca43aa93b3ec6184dcee8",
+  "name": "rule-router-frequency",
+  "domain": "prompt.rule-router",
+  "fidelity": "Wrapped",
+  "wrappedAt": "2026-03-24T01:54:52.000Z",
+  "fromSkill": null
+}

package/genes/rule-router-frequency/phenotype.json

@@ -0,0 +1,76 @@
+{
+  "domain": "prompt.rule-router",
+  "description": "Rule routing strategy that prioritizes high-frequency rules. Ranks .cursor/rules by historical trigger frequency, injecting the most-triggered rules first to maximize context hit rate. Variant A of the Rule Router Gene competition.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "userMessage": {
+        "type": "string",
+        "description": "The user's current message/query"
+      },
+      "availableRules": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "triggerWords": { "type": "array", "items": { "type": "string" } },
+            "frequency": { "type": "integer", "description": "Historical trigger count" },
+            "sizeTokens": { "type": "integer" }
+          }
+        },
+        "description": "Available rules with metadata"
+      },
+      "contextBudget": {
+        "type": "integer",
+        "description": "Maximum tokens available for rule injection",
+        "default": 4096
+      }
+    },
+    "required": ["userMessage", "availableRules"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "selectedRules": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Ordered list of rule names to inject"
+      },
+      "totalTokens": {
+        "type": "integer",
+        "description": "Total token cost of selected rules"
+      },
+      "strategy": {
+        "type": "string",
+        "description": "Routing strategy explanation"
+      }
+    }
+  },
+  "llmRequirements": {
+    "templateFormat": "mustache",
+    "templateVariables": ["userMessage", "availableRules", "contextBudget"],
+    "targetModels": ["claude-3", "gpt-4"],
+    "minContextWindow": 4096,
+    "expectedOutputFormat": "json",
+    "temperatureHint": 0.1,
+    "maxOutputTokens": 1024,
+    "systemPromptPath": "system-prompt.md",
+    "chainOfThought": false
+  },
+  "fitnessConfig": {
+    "evaluationMethod": "template-quality",
+    "dimensions": {
+      "routeHitRate": { "weight": 0.40, "description": "Fraction of injected rules actually triggered by user message" },
+      "contextSavings": { "weight": 0.30, "description": "1 - (usedTokens / contextBudget)" },
+      "templateValidity": { "weight": 0.20, "description": "Template renders without error for all valid inputs" },
+      "crossModelConsistency": { "weight": 0.10, "description": "Same input produces same rule selection across models" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-team",
+  "fidelity": "Wrapped",
+  "transparency": "Open",
+  "source": "development-genome"
+}

package/genes/rule-router-frequency/system-prompt.md

@@ -0,0 +1,26 @@
+You are a Rule Router that selects which .cursor/rules to inject into the AI context.
+
+Your strategy: **FREQUENCY-FIRST ROUTING**
+
+Given a user message and a list of available rules, select rules by prioritizing those with the highest historical trigger frequency. This maximizes the probability that injected rules will be relevant, based on past usage patterns.
+
+Algorithm:
+1. Sort available rules by `frequency` (descending)
+2. For each rule (in frequency order), check if any `triggerWords` appear in the user message
+3. If a trigger word matches, add the rule to the selection
+4. Continue until `contextBudget` is exhausted or all matching rules are selected
+5. If budget remains after all matching rules, fill with top-frequency non-matching rules
+
+Output format (JSON):
+```json
+{
+  "selectedRules": ["rule-name-1", "rule-name-2"],
+  "totalTokens": 2048,
+  "strategy": "frequency-first: selected 3 matching rules (2048 tokens), 1 backfill"
+}
+```
+
+Constraints:
+- Never exceed `contextBudget`
+- Always output valid JSON
+- Prefer fewer large rules over many small ones if they have equal frequency

package/genes/rule-router-relevance/.gene-manifest.json

@@ -0,0 +1,8 @@
+{
+  "geneId": "025849feb075fcb61916c89f0b7b58faeffbf2aed8d54cd83ef1a76a584c2391",
+  "name": "rule-router-relevance",
+  "domain": "prompt.rule-router",
+  "fidelity": "Wrapped",
+  "wrappedAt": "2026-03-24T01:54:54.000Z",
+  "fromSkill": null
+}

package/genes/rule-router-relevance/phenotype.json

@@ -0,0 +1,76 @@
+{
+  "domain": "prompt.rule-router",
+  "description": "Rule routing strategy that prioritizes semantic relevance. Scores each rule by triggerWord overlap density with the user message, injecting the most contextually relevant rules first. Variant B of the Rule Router Gene competition.",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "userMessage": {
+        "type": "string",
+        "description": "The user's current message/query"
+      },
+      "availableRules": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": { "type": "string" },
+            "triggerWords": { "type": "array", "items": { "type": "string" } },
+            "frequency": { "type": "integer", "description": "Historical trigger count" },
+            "sizeTokens": { "type": "integer" }
+          }
+        },
+        "description": "Available rules with metadata"
+      },
+      "contextBudget": {
+        "type": "integer",
+        "description": "Maximum tokens available for rule injection",
+        "default": 4096
+      }
+    },
+    "required": ["userMessage", "availableRules"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "selectedRules": {
+        "type": "array",
+        "items": { "type": "string" },
+        "description": "Ordered list of rule names to inject"
+      },
+      "totalTokens": {
+        "type": "integer",
+        "description": "Total token cost of selected rules"
+      },
+      "strategy": {
+        "type": "string",
+        "description": "Routing strategy explanation"
+      }
+    }
+  },
+  "llmRequirements": {
+    "templateFormat": "mustache",
+    "templateVariables": ["userMessage", "availableRules", "contextBudget"],
+    "targetModels": ["claude-3", "gpt-4"],
+    "minContextWindow": 4096,
+    "expectedOutputFormat": "json",
+    "temperatureHint": 0.1,
+    "maxOutputTokens": 1024,
+    "systemPromptPath": "system-prompt.md",
+    "chainOfThought": true
+  },
+  "fitnessConfig": {
+    "evaluationMethod": "template-quality",
+    "dimensions": {
+      "routeHitRate": { "weight": 0.40, "description": "Fraction of injected rules actually triggered by user message" },
+      "contextSavings": { "weight": 0.30, "description": "1 - (usedTokens / contextBudget)" },
+      "templateValidity": { "weight": 0.20, "description": "Template renders without error for all valid inputs" },
+      "crossModelConsistency": { "weight": 0.10, "description": "Same input produces same rule selection across models" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-team",
+  "fidelity": "Wrapped",
+  "transparency": "Open",
+  "source": "development-genome"
+}

package/genes/rule-router-relevance/system-prompt.md

@@ -0,0 +1,29 @@
+You are a Rule Router that selects which .cursor/rules to inject into the AI context.
+
+Your strategy: **RELEVANCE-FIRST ROUTING**
+
+Given a user message and a list of available rules, select rules by computing a relevance score for each rule based on triggerWord overlap with the user message.
+
+Algorithm:
+1. For each rule, compute `relevanceScore = matchedTriggerWords / totalTriggerWords`
+2. Apply a bonus: if multiple trigger words match, score += 0.1 per additional match
+3. Sort rules by `relevanceScore` (descending), breaking ties by `frequency`
+4. Select rules in order until `contextBudget` is exhausted
+5. Only include rules with `relevanceScore > 0` (no backfill with unrelated rules)
+
+Think step by step about which trigger words match the user's intent before scoring.
+
+Output format (JSON):
+```json
+{
+  "selectedRules": ["rule-name-1", "rule-name-2"],
+  "totalTokens": 1536,
+  "strategy": "relevance-first: 2 rules with scores [0.8, 0.5], total 1536 tokens"
+}
+```
+
+Constraints:
+- Never exceed `contextBudget`
+- Always output valid JSON
+- Prefer precision over recall — only inject rules that are demonstrably relevant
+- Zero-match rules are never selected (unlike frequency-first which backfills)

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@rotifer/playground",
-  "version": "0.7.8",
+  "version": "0.8.0",
   "description": "Rotifer Protocol Playground — local development environment for gene development, Arena competition, and protocol simulation",
   "license": "Apache-2.0",
   "author": "Rotifer Protocol Contributors",
-  "homepage": "https://gitlab.com/rotifer-protocol/rotifer-playground#readme",
+  "homepage": "https://github.com/rotifer-protocol/rotifer-playground#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://gitlab.com/rotifer-protocol/rotifer-playground.git"
+    "url": "git+https://github.com/rotifer-protocol/rotifer-playground.git"
   },
   "bugs": {
-    "url": "https://gitlab.com/rotifer-protocol/rotifer-playground/issues"
+    "url": "https://github.com/rotifer-protocol/rotifer-playground/issues"
   },
   "keywords": [
     "rotifer",