@rotifer/playground 0.1.0-alpha.1

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0-alpha.1] - 2026-02-20
+
+### Added
+
+- **CLI Framework**: 10 commands covering the full gene development lifecycle
+  - `rotifer init` — project scaffolding with Genesis genes and Arena preview
+  - `rotifer scan` — discover candidate functions from source files
+  - `rotifer wrap` — wrap functions as Rotifer genes (Phenotype generation)
+  - `rotifer test` — L2 sandbox testing (schema validation, conformance)
+  - `rotifer compile` — Phenotype validation and gene fingerprinting
+  - `rotifer arena submit` — submit genes to local Arena with admission gate
+  - `rotifer arena list` — view Arena rankings with F(g), V(g), Fidelity
+  - `rotifer arena watch` — placeholder for live ranking updates
+  - `rotifer agent create` — create Agents with gene genomes
+  - `rotifer agent list` — view all registered Agents
+
+- **Rust Core** (`rotifer-core` crate)
+  - Type system: Context, GeneResult, Phenotype, Gene, Agent, AlgebraExpr
+  - WASM Sandbox via wasmtime (resource limits, fuel consumption, epoch interruption)
+  - Arena Engine: local ranking with fitness-based sorting
+  - Algebra Executor: Seq, Par, Cond, Try, Transform composition
+  - Fitness computation: simplified F(g) model with admission threshold
+  - SQLite storage: genes, agents, arena entries
+  - Gene compiler: scan, wrap, schema generation
+  - Agent manager: create, activate, terminate lifecycle
+
+- **napi-rs Bridge** (`rotifer-napi` crate)
+  - PlaygroundBinding facade: 10 methods bridging Rust Core to TypeScript
+  - Source file scanner (TypeScript + Rust function detection)
+
+- **5 Genesis Genes** (pre-installed with every project)
+  - `genesis-web-search` — full search with multiple results
+  - `genesis-web-search-lite` — lightweight single-answer search
+  - `genesis-file-read` — local file reading
+  - `genesis-code-format` — source code formatting
+  - `genesis-l0-constraint` — L0 sandbox constraint checker
+
+- **Developer Experience** (ADR-068)
+  - Three-act Demo: Wow (30s) → Aha (5min) → Hooked (30min)
+  - Rust-style error messages with codes, suggestions, and docs links
+  - Automatic pre-submission testing on `arena submit`
+  - Deterministic Arena rankings from Phenotype content hashing
+
+- **Templates**: gene scaffold + Seq/Par composition examples
+- **Test Suite**: 29 tests (unit + E2E) covering full lifecycle
+- **demo.sh**: automated three-act demonstration script
+
+### Protocol Compliance
+
+Implements Rotifer Protocol Specification v2.9 (Frozen):
+- **Full**: Phenotype, AlgebraExpr, WASM Sandbox, Fitness F(g), Arena
+- **Simplified**: Agent Lifecycle, Gene Lifecycle, RotiferBinding
+- **Stub**: Formal Verification, Cross-Binding Consistency, ZK Proofs
+
+[0.1.0-alpha.1]: https://github.com/rotifer-protocol/playground/releases/tag/v0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,31 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2026 Rotifer Protocol Contributors
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Affero General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Affero General Public License for more details.
+
+You should have received a copy of the GNU Affero General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+---
+
+Additional terms for the Rotifer Protocol:
+
+1. "Genesis Genes" included in this package are provided under the same
+   AGPL-3.0-or-later license. Genes developed by third parties using this
+   tool may use any license compatible with their deployment context.
+
+2. The Rotifer Protocol Specification (referenced by this implementation)
+   is a separate work with its own licensing terms.
+
+For the full AGPL-3.0 license text, see:
+https://www.gnu.org/licenses/agpl-3.0.en.html

package/README.md

@@ -0,0 +1,230 @@
+# Rotifer Playground
+
+[![CI](https://github.com/rotifer-protocol/playground/actions/workflows/ci.yml/badge.svg)](https://github.com/rotifer-protocol/playground/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@rotifer/playground)](https://www.npmjs.com/package/@rotifer/playground)
+[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org/)
+[![Protocol](https://img.shields.io/badge/Protocol-v2.9%20Frozen-orange)](../spec/rotifer-protocol-specification.md)
+
+Local development environment for the **Rotifer Protocol** — build genes, run Arena competitions, and simulate agent evolution.
+
+> **Status:** Alpha (v0.1.0-alpha.1). Core gene lifecycle is functional. WASM compilation and live Arena watching are planned for v0.2.
+
+---
+
+## Install
+
+```bash
+npm install -g @rotifer/playground
+```
+
+Or use directly via npx:
+
+```bash
+npx @rotifer/playground init my-project
+```
+
+**Requirements:** Node.js >= 20.0.0
+
+---
+
+## 30-Second Demo
+
+```bash
+$ rotifer init my-project
+
+  Rotifer Protocol - Project Initialization
+  ───────────────────────────────────────────
+✓ Project scaffolding created
+ℹ Installing Genesis genes...
+✓ 5 Genesis genes installed
+
+  Arena Rankings
+  ────────────────
+  #   Name                        Domain        F(g)    Fidelity
+  ────────────────────────────────────────────────────────────────
+  1   genesis-web-search          search        0.87    Native
+  2   genesis-code-format         tooling       0.81    Native
+  3   genesis-l0-constraint       safety        0.79    Native
+  4   genesis-web-search-lite     search        0.77    Native
+  5   genesis-file-read           filesystem    0.74    Native
+  6   hello-world                 general       0.57    Wrapped
+
+ℹ 6 genes across 5 domain(s) — Arena is alive!
+✓ Project ready: my-project
+```
+
+One command. Five Genesis genes. A living Arena.
+
+---
+
+## Three-Act Experience (ADR-068)
+
+### Act 1 — Wow (30 seconds)
+
+```bash
+rotifer init my-project && cd my-project
+```
+
+You see an Arena with 6 genes ranked by fitness. No configuration needed.
+
+### Act 2 — Aha (5 minutes)
+
+```bash
+rotifer scan genes/               # Discover candidate functions
+rotifer wrap hello-world           # Wrap as a gene (generates Phenotype)
+rotifer test hello-world           # Run L2 sandbox tests
+rotifer arena submit hello-world   # Submit to Arena (admission gate)
+rotifer arena list                 # See your gene's ranking
+```
+
+Your existing code becomes a gene and competes in the Arena.
+
+### Act 3 — Hooked (30 minutes)
+
+Write a native gene, compile it, submit to Arena, and create an Agent:
+
+```bash
+# Write a native gene (higher fidelity = higher fitness potential)
+mkdir genes/my-search && vim genes/my-search/index.ts
+
+rotifer compile my-search          # Validate Phenotype + fingerprint
+rotifer arena submit my-search     # Watch it climb the rankings
+rotifer arena list --domain search # Compare against Genesis genes
+
+# Create an Agent with a gene genome
+rotifer agent create search-bot --genes genesis-web-search my-search
+rotifer agent list
+```
+
+---
+
+## Architecture
+
+```
+playground/
+├── crates/
+│   ├── rotifer-core/        Rust: types, sandbox, arena, algebra, fitness, storage
+│   └── rotifer-napi/        napi-rs bridge: Rust ↔ Node.js FFI
+├── src/                     TypeScript CLI (commander.js)
+│   ├── commands/            10 CLI commands
+│   ├── utils/               Config, display formatting
+│   └── errors/              Rust-style error formatting
+├── genes/                   5 Genesis genes (bundled)
+├── templates/               Gene + composition scaffolds
+└── tests/                   Unit + E2E test suites (29 tests)
+```
+
+### Layers
+
+| Layer | Technology | Responsibility |
+|-------|-----------|----------------|
+| **CLI** | TypeScript + commander.js | User interface, command routing, display |
+| **Bridge** | napi-rs (cdylib) | Rust-to-Node.js FFI binding |
+| **Core** | Rust + wasmtime | WASM sandbox, Arena engine, Algebra executor, Fitness computation, SQLite storage |
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `rotifer init [name]` | Initialize a new gene project with Genesis genes |
+| `rotifer scan [path]` | Scan source files for candidate gene functions |
+| `rotifer wrap <name>` | Wrap a function as a Rotifer gene |
+| `rotifer test [name]` | Test a gene in L2 sandbox |
+| `rotifer compile [name]` | Compile a gene (validate + fingerprint) |
+| `rotifer arena submit <name>` | Submit a gene to the Arena |
+| `rotifer arena list` | List Arena rankings |
+| `rotifer arena watch <domain>` | Watch Arena rankings (MVP: placeholder) |
+| `rotifer agent create <name>` | Create an Agent with a genome |
+| `rotifer agent list` | List all agents |
+
+---
+
+## Genesis Genes
+
+Five pre-installed genes ship with every project:
+
+| Gene | Domain | Fidelity | Description |
+|------|--------|----------|-------------|
+| `genesis-web-search` | search | Native | Full web search with multiple results |
+| `genesis-web-search-lite` | search | Native | Lightweight single-answer search |
+| `genesis-file-read` | filesystem | Native | Read local files (L0 sandbox restricted) |
+| `genesis-code-format` | tooling | Native | Format source code (JSON, TS, etc.) |
+| `genesis-l0-constraint` | safety | Native | L0 sandbox constraint checker |
+
+---
+
+## Gene Composition (Algebra)
+
+Genes can be composed using the Rotifer Algebra:
+
+| Operator | Description | Example |
+|----------|-------------|---------|
+| **Seq** | Sequential pipeline | Search → Format |
+| **Par** | Parallel with merge | Search + Search-Lite, take first |
+| **Cond** | Conditional branch | If query.length > 100 → Lite, else → Full |
+| **Try** | Fault tolerance | Primary with fallback |
+| **Transform** | Map/transform | Inner gene → mapper gene |
+
+See `templates/composition/` for JSON examples.
+
+---
+
+## Development
+
+```bash
+git clone https://github.com/rotifer-protocol/playground.git
+cd playground
+
+# TypeScript CLI
+npm install
+npm run build          # Build to dist/
+npm test               # Run 29 tests
+npm run lint           # Type check only
+
+# Rust Core (requires Rust toolchain)
+cargo check -p rotifer-core
+cargo test -p rotifer-core
+
+# Full demo
+bash demo.sh
+```
+
+---
+
+## Protocol Compliance
+
+Implements **Rotifer Protocol Specification v2.9** (Frozen). Based on 14 rounds of expert discussion and 70 ADRs.
+
+| Implementation Depth | Chapters |
+|---------------------|----------|
+| **Full** | Phenotype (§4), AlgebraExpr (§15), WASM Sandbox (§12), Fitness F(g) (§5), Arena (§33) |
+| **Simplified** | Agent Lifecycle (§16), Gene Lifecycle (§46), RotiferBinding (§12) |
+| **Stub** | Formal Verification (§26), Cross-Binding Consistency (§45), ZK Proofs |
+
+Changes driven by implementation feedback are proposed through the ADR process.
+
+---
+
+## Roadmap
+
+- [x] **v0.1.0-alpha.1** — Core CLI + Genesis genes + Arena
+- [ ] **v0.2.0** — WASM compilation pipeline, live Arena watching
+- [ ] **v0.3.0** — Agent gene execution, Seq/Par runtime
+- [ ] **v1.0.0** — Full protocol compliance, multi-binding support
+
+---
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for development setup and guidelines.
+
+## License
+
+[AGPL-3.0-or-later](LICENSE)
+
+---
+
+**The Rotifer Protocol is alive.**

package/dist/commands/agent-create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const agentCreateCommand: Command;
+//# sourceMappingURL=agent-create.d.ts.map

package/dist/commands/agent-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-create.d.ts","sourceRoot":"","sources":["../../src/commands/agent-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,kBAAkB,SAoD3B,CAAC"}

package/dist/commands/agent-create.js

@@ -0,0 +1,86 @@
+"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.agentCreateCommand = void 0;
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const display = __importStar(require("../utils/display.js"));
+const config_js_1 = require("../utils/config.js");
+exports.agentCreateCommand = new commander_1.Command("create")
+    .description("Create a new Agent with a genome of genes")
+    .argument("<name>", "agent name")
+    .option("-g, --genes <genes...>", "gene names to include in genome")
+    .action(async (name, options) => {
+    const root = (0, config_js_1.getProjectRoot)();
+    const config = (0, config_js_1.loadConfig)(root);
+    display.header("Agent Creation");
+    const agentsDir = (0, node_path_1.join)(root, ".rotifer", "agents");
+    (0, node_fs_1.mkdirSync)(agentsDir, { recursive: true });
+    const agentId = (0, node_crypto_1.randomUUID)();
+    const genome = [];
+    if (options.genes) {
+        for (const geneName of options.genes) {
+            const geneDir = (0, node_path_1.join)(root, config.genes_dir, geneName);
+            if (!(0, node_fs_1.existsSync)((0, node_path_1.join)(geneDir, "phenotype.json"))) {
+                display.rustStyleError({
+                    code: "E0040",
+                    message: `Gene '${geneName}' not found or not wrapped`,
+                    file: (0, node_path_1.join)(geneDir, "phenotype.json"),
+                    suggestion: `Run 'rotifer wrap ${geneName} --domain <domain>' first`,
+                });
+                process.exit(1);
+            }
+            genome.push(geneName);
+        }
+    }
+    const agent = {
+        id: agentId,
+        name,
+        state: "Active",
+        genome,
+        createdAt: new Date().toISOString(),
+        reputation: 0.0,
+    };
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(agentsDir, agentId + ".json"), JSON.stringify(agent, null, 2) + "\n");
+    display.success(`Agent '${name}' created`);
+    display.keyValue("Agent ID", agentId);
+    display.keyValue("State", agent.state);
+    display.keyValue("Genome", genome.length > 0 ? genome.join(", ") : "(empty)");
+    console.log();
+    display.info("View agents: rotifer agent list");
+});
+//# sourceMappingURL=agent-create.js.map

package/dist/commands/agent-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-create.js","sourceRoot":"","sources":["../../src/commands/agent-create.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,yCAAoC;AACpC,qCAA0F;AAC1F,yCAAiC;AACjC,6CAAyC;AACzC,6DAA+C;AAC/C,kDAAgE;AAEnD,QAAA,kBAAkB,GAAG,IAAI,mBAAO,CAAC,QAAQ,CAAC;KACpD,WAAW,CAAC,2CAA2C,CAAC;KACxD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;KAChC,MAAM,CAAC,wBAAwB,EAAE,iCAAiC,CAAC;KACnE,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,OAA6B,EAAE,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAA,0BAAc,GAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAA,sBAAU,EAAC,IAAI,CAAC,CAAC;IAEhC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAEjC,MAAM,SAAS,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACnD,IAAA,mBAAS,EAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAG,IAAA,wBAAU,GAAE,CAAC;IAC7B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAI,EAAE,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YACvD,IAAI,CAAC,IAAA,oBAAU,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,cAAc,CAAC;oBACrB,IAAI,EAAE,OAAO;oBACb,OAAO,EAAE,SAAS,QAAQ,4BAA4B;oBACtD,IAAI,EAAE,IAAA,gBAAI,EAAC,OAAO,EAAE,gBAAgB,CAAC;oBACrC,UAAU,EAAE,qBAAqB,QAAQ,2BAA2B;iBACrE,CAAC,CAAC;gBACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,EAAE,EAAE,OAAO;QACX,IAAI;QACJ,KAAK,EAAE,QAAQ;QACf,MAAM;QACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,UAAU,EAAE,GAAG;KAChB,CAAC;IAEF,IAAA,uBAAa,EACX,IAAA,gBAAI,EAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACtC,CAAC;IAEF,OAAO,CAAC,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,CAAC;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC9E,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;AAClD,CAAC,CAAC,CAAC"}

package/dist/commands/agent-list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const agentListCommand: Command;
+//# sourceMappingURL=agent-list.d.ts.map

package/dist/commands/agent-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-list.d.ts","sourceRoot":"","sources":["../../src/commands/agent-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAcpC,eAAO,MAAM,gBAAgB,SA+CzB,CAAC"}

package/dist/commands/agent-list.js

@@ -0,0 +1,83 @@
+"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.agentListCommand = void 0;
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const display = __importStar(require("../utils/display.js"));
+const config_js_1 = require("../utils/config.js");
+exports.agentListCommand = new commander_1.Command("list")
+    .description("List all agents")
+    .action(async () => {
+    const root = (0, config_js_1.getProjectRoot)();
+    display.header("Agent Registry");
+    const agentsDir = (0, node_path_1.join)(root, ".rotifer", "agents");
+    if (!(0, node_fs_1.existsSync)(agentsDir)) {
+        display.warn("No agents created yet");
+        display.info("Create one: rotifer agent create <name> --genes <gene1> <gene2>");
+        return;
+    }
+    const files = (0, node_fs_1.readdirSync)(agentsDir).filter((f) => f.endsWith(".json"));
+    if (files.length === 0) {
+        display.warn("No agents created yet");
+        display.info("Create one: rotifer agent create <name> --genes <gene1> <gene2>");
+        return;
+    }
+    const agents = files.map((f) => {
+        return JSON.parse((0, node_fs_1.readFileSync)((0, node_path_1.join)(agentsDir, f), "utf-8"));
+    });
+    console.log();
+    console.log("  " +
+        padRight("Name", 20) +
+        padRight("State", 12) +
+        padRight("Genome", 30) +
+        "Agent ID");
+    console.log("  " + "-".repeat(90));
+    for (const a of agents) {
+        const genomeStr = a.genome.length > 0 ? a.genome.join(", ") : "(empty)";
+        console.log("  " +
+            padRight(a.name, 20) +
+            padRight(a.state, 12) +
+            padRight(genomeStr, 30) +
+            a.id.slice(0, 12) + "...");
+    }
+    console.log();
+    display.info(`${agents.length} agent(s) registered`);
+});
+function padRight(str, len) {
+    return str.length >= len ? str.slice(0, len) : str + " ".repeat(len - str.length);
+}
+//# sourceMappingURL=agent-list.js.map

package/dist/commands/agent-list.js.map

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

package/dist/commands/arena-list.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const arenaListCommand: Command;
+//# sourceMappingURL=arena-list.d.ts.map

package/dist/commands/arena-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arena-list.d.ts","sourceRoot":"","sources":["../../src/commands/arena-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiBpC,eAAO,MAAM,gBAAgB,SAyFzB,CAAC"}

package/dist/commands/arena-list.js

@@ -0,0 +1,116 @@
+"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.arenaListCommand = void 0;
+const commander_1 = require("commander");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_crypto_1 = require("node:crypto");
+const display = __importStar(require("../utils/display.js"));
+const config_js_1 = require("../utils/config.js");
+exports.arenaListCommand = new commander_1.Command("list")
+    .description("List Arena rankings")
+    .option("-d, --domain <domain>", "filter by domain")
+    .action(async (options) => {
+    const root = (0, config_js_1.getProjectRoot)();
+    const config = (0, config_js_1.loadConfig)(root);
+    display.header("Arena Rankings");
+    const genesDir = (0, node_path_1.join)(root, config.genes_dir);
+    if (!(0, node_fs_1.existsSync)(genesDir)) {
+        display.warn("No genes directory found");
+        return;
+    }
+    const entries = [];
+    for (const name of (0, node_fs_1.readdirSync)(genesDir)) {
+        const phenotypePath = (0, node_path_1.join)(genesDir, name, "phenotype.json");
+        if (!(0, node_fs_1.existsSync)(phenotypePath))
+            continue;
+        const phenotype = JSON.parse((0, node_fs_1.readFileSync)(phenotypePath, "utf-8"));
+        if (options.domain && phenotype.domain !== options.domain)
+            continue;
+        const phenoStr = JSON.stringify(phenotype);
+        const geneId = (0, node_crypto_1.createHash)("sha256").update(phenoStr).digest("hex");
+        // Deterministic fitness from content hash
+        const seed = parseInt(geneId.slice(0, 8), 16);
+        const isNative = phenotype.fidelity === "Native";
+        const baseFitness = isNative ? 0.70 : 0.45;
+        const variance = (seed % 250) / 1000;
+        const fitness = Math.min(baseFitness + variance, 0.99);
+        const safety = 0.7 + (seed % 300) / 1000;
+        entries.push({
+            rank: 0,
+            name,
+            geneId,
+            domain: phenotype.domain || "unknown",
+            fitness,
+            safety,
+            fidelity: phenotype.fidelity || "Wrapped",
+        });
+    }
+    entries.sort((a, b) => b.fitness - a.fitness);
+    entries.forEach((e, i) => (e.rank = i + 1));
+    if (entries.length === 0) {
+        display.warn("No genes in Arena" +
+            (options.domain ? ` for domain '${options.domain}'` : ""));
+        display.info("Submit a gene: rotifer arena submit <gene-name>");
+        return;
+    }
+    console.log();
+    const col = { rank: 4, name: 28, domain: 14, fg: 9, vg: 9, fidelity: 10 };
+    console.log("  " +
+        padRight("#", col.rank) +
+        padRight("Name", col.name) +
+        padRight("Domain", col.domain) +
+        padRight("F(g)", col.fg) +
+        padRight("V(g)", col.vg) +
+        "Fidelity");
+    console.log("  " + "─".repeat(74));
+    for (const e of entries) {
+        console.log("  " +
+            padRight(String(e.rank), col.rank) +
+            padRight(e.name, col.name) +
+            padRight(e.domain, col.domain) +
+            padRight(e.fitness.toFixed(4), col.fg) +
+            padRight(e.safety.toFixed(4), col.vg) +
+            e.fidelity);
+    }
+    console.log();
+    const domains = new Set(entries.map((e) => e.domain));
+    display.info(`${entries.length} gene(s) across ${domains.size} domain(s) in Arena`);
+});
+function padRight(str, len) {
+    return str.length >= len ? str : str + " ".repeat(len - str.length);
+}
+//# sourceMappingURL=arena-list.js.map

package/dist/commands/arena-list.js.map

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

package/dist/commands/arena-submit.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare const arenaSubmitCommand: Command;
+//# sourceMappingURL=arena-submit.d.ts.map

package/dist/commands/arena-submit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arena-submit.d.ts","sourceRoot":"","sources":["../../src/commands/arena-submit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC,eAAO,MAAM,kBAAkB,SAyE3B,CAAC"}