@rotifer/playground 0.1.0-alpha.1

package/dist/utils/display.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.error = error;
+exports.info = info;
+exports.warn = warn;
+exports.header = header;
+exports.keyValue = keyValue;
+exports.geneId = geneId;
+exports.rustStyleError = rustStyleError;
+const chalk_1 = __importDefault(require("chalk"));
+function success(message) {
+    console.log(chalk_1.default.green("✓") + " " + message);
+}
+function error(message, detail) {
+    console.error(chalk_1.default.red("✗") + " " + chalk_1.default.red(message));
+    if (detail) {
+        console.error(chalk_1.default.dim("  → " + detail));
+    }
+}
+function info(message) {
+    console.log(chalk_1.default.blue("ℹ") + " " + message);
+}
+function warn(message) {
+    console.log(chalk_1.default.yellow("⚠") + " " + message);
+}
+function header(title) {
+    console.log();
+    console.log(chalk_1.default.bold.cyan(`  ${title}`));
+    console.log(chalk_1.default.dim("  " + "─".repeat(title.length + 2)));
+}
+function keyValue(key, value) {
+    console.log(`  ${chalk_1.default.dim(key + ":")} ${value}`);
+}
+function geneId(id) {
+    return chalk_1.default.yellow(id.slice(0, 12) + "…");
+}
+function rustStyleError(opts) {
+    console.error();
+    console.error(chalk_1.default.red.bold(`error[${opts.code}]`) + chalk_1.default.bold(`: ${opts.message}`));
+    if (opts.file) {
+        console.error(chalk_1.default.blue(" --> ") + opts.file + (opts.line ? `:${opts.line}` : ""));
+    }
+    if (opts.suggestion) {
+        console.error();
+        console.error(chalk_1.default.green("help") + `: ${opts.suggestion}`);
+    }
+    if (opts.docsUrl) {
+        console.error(chalk_1.default.dim("docs") + `: ${opts.docsUrl}`);
+    }
+    console.error();
+}
+//# sourceMappingURL=display.js.map

package/dist/utils/display.js.map

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

package/genes/genesis-code-format/index.ts

@@ -0,0 +1,42 @@
+interface CodeFormatInput {
+  code: string;
+  language: "typescript" | "javascript" | "json" | "markdown" | "rust";
+}
+
+interface CodeFormatOutput {
+  formatted: string;
+  changed: boolean;
+  language: string;
+}
+
+/**
+ * Genesis Gene: Code Format
+ *
+ * Formats source code. MVP uses simple heuristic formatting.
+ * Production binding would delegate to prettier/rustfmt/etc.
+ */
+export async function express(input: CodeFormatInput): Promise<CodeFormatOutput> {
+  let formatted: string;
+
+  switch (input.language) {
+    case "json":
+      try {
+        formatted = JSON.stringify(JSON.parse(input.code), null, 2);
+      } catch {
+        formatted = input.code;
+      }
+      break;
+    default:
+      formatted = input.code
+        .replace(/\t/g, "  ")
+        .replace(/[ \t]+$/gm, "")
+        .replace(/\n{3,}/g, "\n\n");
+      break;
+  }
+
+  return {
+    formatted,
+    changed: formatted !== input.code,
+    language: input.language,
+  };
+}

package/genes/genesis-code-format/phenotype.json

@@ -0,0 +1,29 @@
+{
+  "domain": "tooling",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "code": { "type": "string", "description": "Source code to format" },
+      "language": { "type": "string", "description": "Programming language", "enum": ["typescript", "javascript", "json", "markdown", "rust"] }
+    },
+    "required": ["code", "language"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "formatted": { "type": "string" },
+      "changed": { "type": "boolean" },
+      "language": { "type": "string" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-genesis",
+  "fidelity": "Native",
+  "transparency": "Open",
+  "semantic_requirements": {
+    "timeModel": "Sync",
+    "concurrencyModel": "Stateless",
+    "failureSemantics": "Fail"
+  }
+}

package/genes/genesis-file-read/index.ts

@@ -0,0 +1,33 @@
+import { readFileSync } from "node:fs";
+
+interface FileReadInput {
+  path: string;
+  encoding?: "utf-8" | "base64";
+}
+
+interface FileReadOutput {
+  content: string;
+  size: number;
+  encoding: string;
+}
+
+/**
+ * Genesis Gene: File Read
+ *
+ * Reads a local file and returns its contents.
+ * Restricted by L0 sandbox constraints (path allowlist).
+ */
+export async function express(input: FileReadInput): Promise<FileReadOutput> {
+  const encoding = input.encoding ?? "utf-8";
+  const buffer = readFileSync(input.path);
+
+  const content = encoding === "base64"
+    ? buffer.toString("base64")
+    : buffer.toString("utf-8");
+
+  return {
+    content,
+    size: buffer.length,
+    encoding,
+  };
+}

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

@@ -0,0 +1,29 @@
+{
+  "domain": "filesystem",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "path": { "type": "string", "description": "File path to read" },
+      "encoding": { "type": "string", "default": "utf-8", "enum": ["utf-8", "base64"] }
+    },
+    "required": ["path"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "content": { "type": "string" },
+      "size": { "type": "integer" },
+      "encoding": { "type": "string" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-genesis",
+  "fidelity": "Native",
+  "transparency": "Open",
+  "semantic_requirements": {
+    "timeModel": "Sync",
+    "concurrencyModel": "Stateless",
+    "failureSemantics": "Fail"
+  }
+}

package/genes/genesis-l0-constraint/index.ts

@@ -0,0 +1,62 @@
+interface ConstraintCheckInput {
+  geneId: string;
+  constraints?: {
+    maxMemoryBytes?: number;
+    maxFuel?: number;
+    allowedHostFunctions?: string[];
+    deniedHostFunctions?: string[];
+  };
+}
+
+interface ConstraintCheckOutput {
+  compliant: boolean;
+  violations: string[];
+  constraintSet: {
+    maxMemoryBytes: number;
+    maxFuel: number;
+    allowedHostFunctions: string[];
+    deniedHostFunctions: string[];
+  };
+}
+
+const DEFAULT_MAX_MEMORY = 16 * 1024 * 1024; // 16 MiB
+const DEFAULT_MAX_FUEL = 1_000_000;
+
+/**
+ * Genesis Gene: L0 Constraint Checker
+ *
+ * Validates that a gene's resource usage profile conforms to L0 sandbox
+ * constraints. This is a meta-gene used by the Arena admission process
+ * and the testing framework.
+ */
+export async function express(input: ConstraintCheckInput): Promise<ConstraintCheckOutput> {
+  const maxMem = input.constraints?.maxMemoryBytes ?? DEFAULT_MAX_MEMORY;
+  const maxFuel = input.constraints?.maxFuel ?? DEFAULT_MAX_FUEL;
+  const allowed = input.constraints?.allowedHostFunctions ?? [];
+  const denied = input.constraints?.deniedHostFunctions ?? ["fs.write", "net.listen", "process.exit"];
+
+  const violations: string[] = [];
+
+  if (!input.geneId || input.geneId.length !== 64) {
+    violations.push("Invalid gene ID format (expected 64-char hex)");
+  }
+
+  if (maxMem > 256 * 1024 * 1024) {
+    violations.push(`Memory limit ${maxMem} exceeds protocol maximum (256 MiB)`);
+  }
+
+  if (maxFuel > 100_000_000) {
+    violations.push(`Fuel limit ${maxFuel} exceeds protocol maximum (100M)`);
+  }
+
+  return {
+    compliant: violations.length === 0,
+    violations,
+    constraintSet: {
+      maxMemoryBytes: maxMem,
+      maxFuel: maxFuel,
+      allowedHostFunctions: allowed,
+      deniedHostFunctions: denied,
+    },
+  };
+}

package/genes/genesis-l0-constraint/phenotype.json

@@ -0,0 +1,37 @@
+{
+  "domain": "safety",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "geneId": { "type": "string", "description": "Gene ID (hex) to check" },
+      "constraints": {
+        "type": "object",
+        "properties": {
+          "maxMemoryBytes": { "type": "integer", "default": 16777216 },
+          "maxFuel": { "type": "integer", "default": 1000000 },
+          "allowedHostFunctions": { "type": "array", "items": { "type": "string" } },
+          "deniedHostFunctions": { "type": "array", "items": { "type": "string" } }
+        }
+      }
+    },
+    "required": ["geneId"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "compliant": { "type": "boolean" },
+      "violations": { "type": "array", "items": { "type": "string" } },
+      "constraintSet": { "type": "object" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-genesis",
+  "fidelity": "Native",
+  "transparency": "Open",
+  "semantic_requirements": {
+    "timeModel": "Sync",
+    "concurrencyModel": "Stateless",
+    "failureSemantics": "Fail"
+  }
+}

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

@@ -0,0 +1,39 @@
+interface SearchInput {
+  query: string;
+  maxResults?: number;
+}
+
+interface SearchResult {
+  title: string;
+  url: string;
+  snippet: string;
+}
+
+interface SearchOutput {
+  results: SearchResult[];
+  totalResults: number;
+  searchTime: number;
+}
+
+/**
+ * Genesis Gene: Web Search
+ *
+ * Full-featured web search gene. In MVP, returns simulated results.
+ * Production binding would connect to a real search API.
+ */
+export async function express(input: SearchInput): Promise<SearchOutput> {
+  const start = Date.now();
+  const max = input.maxResults ?? 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.`,
+  }));
+
+  return {
+    results,
+    totalResults: results.length,
+    searchTime: Date.now() - start,
+  };
+}

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

@@ -0,0 +1,40 @@
+{
+  "domain": "search",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "query": { "type": "string", "description": "Search query string" },
+      "maxResults": { "type": "integer", "default": 5, "minimum": 1, "maximum": 20 }
+    },
+    "required": ["query"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "results": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "title": { "type": "string" },
+            "url": { "type": "string" },
+            "snippet": { "type": "string" }
+          }
+        }
+      },
+      "totalResults": { "type": "integer" },
+      "searchTime": { "type": "number" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-genesis",
+  "fidelity": "Native",
+  "transparency": "Open",
+  "streaming_capability": null,
+  "semantic_requirements": {
+    "timeModel": "Async",
+    "concurrencyModel": "Stateless",
+    "failureSemantics": "Retry"
+  }
+}

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

@@ -0,0 +1,22 @@
+interface LiteSearchInput {
+  query: string;
+}
+
+interface LiteSearchOutput {
+  answer: string;
+  source: string;
+}
+
+/**
+ * Genesis Gene: Web Search Lite
+ *
+ * Lightweight single-answer search gene — returns a concise answer
+ * instead of a list. Lower resource cost, suitable for Par composition
+ * with deadline constraints.
+ */
+export async function express(input: LiteSearchInput): Promise<LiteSearchOutput> {
+  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),
+  };
+}

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

@@ -0,0 +1,27 @@
+{
+  "domain": "search",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "query": { "type": "string", "description": "Search query string" }
+    },
+    "required": ["query"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "answer": { "type": "string" },
+      "source": { "type": "string" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "rotifer-genesis",
+  "fidelity": "Native",
+  "transparency": "Open",
+  "semantic_requirements": {
+    "timeModel": "Async",
+    "concurrencyModel": "Stateless",
+    "failureSemantics": "Fallback"
+  }
+}

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "@rotifer/playground",
+  "version": "0.1.0-alpha.1",
+  "description": "Rotifer Protocol Playground — local development environment for gene development, Arena competition, and protocol simulation",
+  "license": "AGPL-3.0-or-later",
+  "author": "Rotifer Protocol Contributors",
+  "homepage": "https://github.com/rotifer-protocol/rotifer-playground#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rotifer-protocol/rotifer-playground.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rotifer-protocol/rotifer-playground/issues"
+  },
+  "keywords": [
+    "rotifer",
+    "protocol",
+    "gene",
+    "arena",
+    "agent",
+    "wasm",
+    "sandbox",
+    "evolution",
+    "ai",
+    "web3",
+    "decentralized",
+    "autonomous",
+    "digital-life",
+    "cli"
+  ],
+  "bin": {
+    "rotifer": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "build:napi": "cd crates/rotifer-napi && napi build --release",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run lint && npm run test && npm run build",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.5",
+    "ajv": "^8.17.0",
+    "ajv-formats": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "genes/",
+    "LICENSE",
+    "README.md",
+    "CHANGELOG.md"
+  ]
+}

package/templates/composition/par-example.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://rotifer.dev/schemas/algebra-expr.json",
+  "type": "Par",
+  "branches": [
+    { "type": "Gene", "id": "{{gene_a_id}}" },
+    { "type": "Gene", "id": "{{gene_b_id}}" }
+  ],
+  "merge": "FirstSuccess",
+  "deadline": "5s",
+  "_comment": "Parallel composition: run both genes, take first success within 5s deadline"
+}

package/templates/composition/seq-example.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://rotifer.dev/schemas/algebra-expr.json",
+  "type": "Seq",
+  "steps": [
+    { "type": "Gene", "id": "{{gene_a_id}}" },
+    { "type": "Gene", "id": "{{gene_b_id}}" }
+  ],
+  "_comment": "Sequential composition: gene_a output feeds into gene_b input"
+}

package/templates/gene/index.ts

@@ -0,0 +1,13 @@
+interface Input {
+  input: string;
+}
+
+interface Output {
+  output: string;
+}
+
+export async function express(input: Input): Promise<Output> {
+  return {
+    output: `Processed: ${input.input}`,
+  };
+}

package/templates/gene/phenotype.json

@@ -0,0 +1,21 @@
+{
+  "domain": "{{domain}}",
+  "inputSchema": {
+    "type": "object",
+    "properties": {
+      "input": { "type": "string", "description": "Primary input" }
+    },
+    "required": ["input"]
+  },
+  "outputSchema": {
+    "type": "object",
+    "properties": {
+      "output": { "type": "string" }
+    }
+  },
+  "dependencies": [],
+  "version": "0.1.0",
+  "author": "{{author}}",
+  "fidelity": "Wrapped",
+  "transparency": "Open"
+}

package/templates/gene/test.ts

@@ -0,0 +1,15 @@
+import { describe, it, expect } from "vitest";
+import { express } from "./index.js";
+
+describe("{{name}}", () => {
+  it("should process input and return output", async () => {
+    const result = await express({ input: "hello" });
+    expect(result).toHaveProperty("output");
+    expect(typeof result.output).toBe("string");
+  });
+
+  it("should handle empty input", async () => {
+    const result = await express({ input: "" });
+    expect(result).toHaveProperty("output");
+  });
+});