@rotifer/playground 0.8.0 → 0.8.5

package/genes/docs-writer/SKILL.md

@@ -1,492 +0,0 @@
----
-name: docs-writer
-description: Write technical documentation including README, API docs, and changelogs. Create clear, structured documentation for AI and Web3 projects. Use when writing documentation, creating README, or when the user mentions docs, documentation, readme, or api docs.
----
-
-# Docs Writer (文档撰写师)
-
-**Goal**: 撰写清晰、实用、易维护的技术文档。
-
-**原则**: 文档是写给未来的自己和他人看的。
-
----
-
-## 1. README Template
-
-### 项目 README
-
-```markdown
-# Project Name
-
-一句话描述项目做什么。
-
-## Features
-
-- ✨ Feature 1
-- 🚀 Feature 2
-- 🔒 Feature 3
-
-## Quick Start
-
-\`\`\`bash
-# Clone
-git clone https://github.com/user/repo.git
-cd repo
-
-# Install
-pnpm install
-
-# Setup environment
-cp .env.example .env
-# Edit .env with your values
-
-# Run
-pnpm dev
-\`\`\`
-
-Open [http://localhost:3000](http://localhost:3000)
-
-## Tech Stack
-
-- **Framework**: Next.js 14
-- **Styling**: Tailwind CSS
-- **Database**: PostgreSQL + Prisma
-- **AI**: OpenAI API
-- **Web3**: wagmi + viem
-
-## Project Structure
-
-\`\`\`
-src/
-├── app/          # Next.js app router
-├── components/   # React components
-├── hooks/        # Custom hooks
-├── lib/          # Utilities
-└── types/        # TypeScript types
-\`\`\`
-
-## Environment Variables
-
-| Variable | Description | Required |
-|----------|-------------|----------|
-| `DATABASE_URL` | PostgreSQL connection string | Yes |
-| `OPENAI_API_KEY` | OpenAI API key | Yes |
-| `NEXT_PUBLIC_CHAIN_ID` | Default chain ID | No |
-
-## Development
-
-\`\`\`bash
-# Run dev server
-pnpm dev
-
-# Run tests
-pnpm test
-
-# Build
-pnpm build
-\`\`\`
-
-## License
-
-MIT
-```
-
----
-
-## 2. API Documentation
-
-### Endpoint 文档模板
-
-```markdown
-## Create User
-
-Creates a new user account.
-
-### Request
-
-\`\`\`
-POST /api/users
-\`\`\`
-
-#### Headers
-
-| Header | Value | Required |
-|--------|-------|----------|
-| Content-Type | application/json | Yes |
-| Authorization | Bearer {token} | Yes |
-
-#### Body
-
-\`\`\`json
-{
-  "name": "张三",
-  "email": "zhang@example.com",
-  "password": "securepassword"
-}
-\`\`\`
-
-| Field | Type | Description | Required |
-|-------|------|-------------|----------|
-| name | string | User display name | Yes |
-| email | string | User email address | Yes |
-| password | string | Password (min 8 chars) | Yes |
-
-### Response
-
-#### Success (201)
-
-\`\`\`json
-{
-  "id": "clx1234567",
-  "name": "张三",
-  "email": "zhang@example.com",
-  "createdAt": "2024-01-15T10:30:00Z"
-}
-\`\`\`
-
-#### Errors
-
-| Code | Description |
-|------|-------------|
-| 400 | Invalid request body |
-| 409 | Email already exists |
-| 422 | Validation failed |
-
-### Example
-
-\`\`\`bash
-curl -X POST https://api.example.com/api/users \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer {token}" \
-  -d '{"name": "张三", "email": "zhang@example.com", "password": "secure123"}'
-\`\`\`
-```
-
-### API 概览
-
-```markdown
-# API Reference
-
-Base URL: `https://api.example.com`
-
-## Authentication
-
-All endpoints require Bearer token authentication.
-
-\`\`\`
-Authorization: Bearer {your-api-key}
-\`\`\`
-
-## Endpoints
-
-### Users
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| GET | /api/users | List users |
-| GET | /api/users/:id | Get user |
-| POST | /api/users | Create user |
-| PATCH | /api/users/:id | Update user |
-| DELETE | /api/users/:id | Delete user |
-
-### Chat
-
-| Method | Endpoint | Description |
-|--------|----------|-------------|
-| POST | /api/chat | Send message |
-| GET | /api/chat/history | Get history |
-
-## Error Codes
-
-| Code | Message |
-|------|---------|
-| 1001 | Authentication required |
-| 3001 | Resource not found |
-| 4001 | Validation failed |
-| 5001 | Rate limited |
-```
-
----
-
-## 3. Changelog
-
-### CHANGELOG.md 模板
-
-```markdown
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/).
-
-## [Unreleased]
-
-### Added
-- New feature in progress
-
-## [1.2.0] - 2024-01-15
-
-### Added
-- Streaming response support for chat
-- Multi-chain wallet connection
-- Token usage tracking
-
-### Changed
-- Improved error messages
-- Updated dependencies
-
-### Fixed
-- Rate limiting edge case
-- Mobile responsive issues
-
-### Security
-- Upgraded vulnerable dependencies
-
-## [1.1.0] - 2024-01-01
-
-### Added
-- Initial chat functionality
-- Wallet connection
-
-[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
-[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
-[1.1.0]: https://github.com/user/repo/releases/tag/v1.1.0
-```
-
----
-
-## 4. Component Documentation
-
-### 组件文档模板
-
-```markdown
-# Button
-
-Primary action button with multiple variants.
-
-## Usage
-
-\`\`\`tsx
-import { Button } from '@/components/ui/button'
-
-<Button variant="primary" size="md">
-  Click me
-</Button>
-\`\`\`
-
-## Props
-
-| Prop | Type | Default | Description |
-|------|------|---------|-------------|
-| variant | 'primary' \| 'secondary' \| 'ghost' | 'primary' | Visual style |
-| size | 'sm' \| 'md' \| 'lg' | 'md' | Button size |
-| disabled | boolean | false | Disable button |
-| loading | boolean | false | Show loading spinner |
-| onClick | () => void | - | Click handler |
-
-## Variants
-
-### Primary
-For main actions.
-
-\`\`\`tsx
-<Button variant="primary">Save</Button>
-\`\`\`
-
-### Secondary
-For secondary actions.
-
-\`\`\`tsx
-<Button variant="secondary">Cancel</Button>
-\`\`\`
-
-### Ghost
-For subtle actions.
-
-\`\`\`tsx
-<Button variant="ghost">Learn more</Button>
-\`\`\`
-
-## Accessibility
-
-- Uses native `<button>` element
-- Supports keyboard navigation
-- Includes focus ring
-- Disabled state is properly announced
-```
-
----
-
-## 5. .env.example
-
-### 环境变量示例
-
-```bash
-# .env.example
-
-# ===================
-# Required
-# ===================
-
-# Database
-DATABASE_URL="postgresql://user:password@localhost:5432/mydb"
-
-# AI
-OPENAI_API_KEY="sk-..."
-
-# ===================
-# Optional
-# ===================
-
-# AI Settings
-AI_MODEL="gpt-4o"
-AI_MAX_TOKENS="4096"
-
-# Web3
-NEXT_PUBLIC_CHAIN_ID="1"
-NEXT_PUBLIC_ALCHEMY_KEY="..."
-
-# Feature Flags
-ENABLE_STREAMING="true"
-```
-
----
-
-## 6. Contributing Guide
-
-### CONTRIBUTING.md
-
-```markdown
-# Contributing
-
-Thanks for your interest in contributing!
-
-## Development Setup
-
-1. Fork the repo
-2. Clone your fork
-3. Install dependencies: `pnpm install`
-4. Create a branch: `git checkout -b feat/my-feature`
-
-## Commit Guidelines
-
-We use [Conventional Commits](https://www.conventionalcommits.org/).
-
-\`\`\`
-feat(scope): add new feature
-fix(scope): fix bug
-docs(scope): update documentation
-\`\`\`
-
-## Pull Request Process
-
-1. Update documentation if needed
-2. Add tests for new features
-3. Ensure all tests pass: `pnpm test`
-4. Create PR with clear description
-
-## Code Style
-
-- Use TypeScript
-- Follow existing patterns
-- Run `pnpm lint` before committing
-
-## Questions?
-
-Open an issue or start a discussion.
-```
-
----
-
-## 7. Inline Documentation
-
-### JSDoc 注释
-
-```typescript
-/**
- * Truncates an Ethereum address for display.
- * 
- * @param address - The full Ethereum address
- * @param chars - Number of characters to show on each end (default: 4)
- * @returns Truncated address (e.g., "0x1234...5678")
- * 
- * @example
- * ```ts
- * truncateAddress("0x1234567890abcdef1234567890abcdef12345678")
- * // => "0x1234...5678"
- * ```
- */
-export function truncateAddress(address: string, chars = 4): string {
-  if (address.length <= chars * 2 + 2) return address
-  return `${address.slice(0, chars + 2)}...${address.slice(-chars)}`
-}
-```
-
-### Type 注释
-
-```typescript
-/**
- * AI chat message
- */
-interface Message {
-  /** Unique message ID */
-  id: string
-  /** Message author role */
-  role: 'user' | 'assistant' | 'system'
-  /** Message content */
-  content: string
-  /** Creation timestamp */
-  createdAt: Date
-}
-```
-
----
-
-## 8. Documentation Checklist
-
-```markdown
-## 文档检查清单
-
-### README
-- [ ] 一句话描述项目
-- [ ] 快速开始步骤
-- [ ] 环境变量说明
-- [ ] 技术栈列表
-- [ ] 项目结构
-
-### API 文档
-- [ ] 所有端点列出
-- [ ] 请求/响应示例
-- [ ] 错误码说明
-- [ ] 认证方式
-
-### 代码注释
-- [ ] 公共函数有 JSDoc
-- [ ] 复杂逻辑有解释
-- [ ] TODO 有 issue 链接
-
-### 其他
-- [ ] CHANGELOG 更新
-- [ ] .env.example 同步
-- [ ] CONTRIBUTING 指南
-```
-
----
-
-## Quick Reference
-
-### 文档优先级
-
-```
-1. README (必须)
-2. .env.example (必须)
-3. API 文档 (有 API 时)
-4. CHANGELOG (发布时)
-5. 组件文档 (有 UI 库时)
-```
-
-### 文档工具
-
-```
-Mintlify, Docusaurus, Fumadocs, Swagger
-```

package/genes/docs-writer/phenotype.json

@@ -1,28 +0,0 @@
-{
-  "domain": "docs.technical",
-  "description": "Write technical documentation including README, API docs, and changelogs. Create clear, structured documentation for AI and Web3 projects. Use when writing documentation, creating README, or when the user mentions docs, documentation, readme, or api docs.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "prompt": {
-        "type": "string"
-      }
-    },
-    "required": []
-  },
-  "outputSchema": {
-    "type": "object",
-    "properties": {
-      "result": {
-        "type": "string"
-      }
-    }
-  },
-  "dependencies": [],
-  "version": "0.1.0",
-  "author": "rotifer-team",
-  "createdAt": 1771939415445,
-  "fidelity": "Wrapped",
-  "transparency": "Open",
-  "source": "skill"
-}

package/genes/evolve-life/.cloud-manifest.json

@@ -1,6 +0,0 @@
-{
-  "cloud_id": "250243be-4f02-4a29-8d8a-fe8bc3609c76",
-  "owner": "Rotifer Protocol",
-  "version": "0.2.0",
-  "published_at": "2026-03-17T14:12:45.367Z"
-}

package/genes/evolve-life/.compile-result.json

@@ -1,12 +0,0 @@
-{
-  "geneId": "d1b35fa940b68e1099bd950958f8d63f1a624664228e1b8f240fd68f4ed078cc",
-  "name": "evolve-life",
-  "domain": "evolve.life",
-  "compiledAt": "2026-03-14T06:06:59.806Z",
-  "fidelity": "Native",
-  "wasmAvailable": true,
-  "irHash": "f04e1e5913d7b6624630254dc97e18f2bea5b113bd52e3cd6fdddc0ce0f471c2",
-  "totalSize": 1299905,
-  "codeSectionSize": 956115,
-  "durationMs": 16095
-}

package/genes/evolve-life/README.md

@@ -1,52 +0,0 @@
-# evolve.life
-
-Conway's Game of Life simulator — a pure-computation Native Gene for the Rotifer Protocol.
-
-## Why
-
-The Game of Life is the quintessential cellular automaton: dead-simple rules produce emergent complexity. It maps perfectly to Rotifer's biological metaphor — cells live, die, and evolve through generations, just like Genes in the Arena.
-
-As a **Native Gene**, `evolve.life` performs zero I/O. It compiles to sandboxed WASM and runs deterministically, making it an ideal benchmark for IR compilation, Arena fitness scoring, and cross-Binding portability.
-
-## Usage
-
-```bash
-# Run with a preset pattern
-rotifer run evolve.life --input '{"preset": "r-pentomino", "generations": 500}'
-
-# Benchmark: 512x512 grid, 1000 generations
-rotifer run evolve.life --input '{"width": 512, "height": 512, "generations": 1000, "preset": "random", "seed": 7}'
-
-# Custom rule (HighLife: B36/S23)
-rotifer run evolve.life --input '{"preset": "random", "rule": "B36/S23"}'
-```
-
-## Presets
-
-| Preset | Type | Description |
-|--------|------|-------------|
-| `glider` | Spaceship | Moves diagonally, period 4 |
-| `blinker` | Oscillator | Period 2, simplest oscillator |
-| `beacon` | Oscillator | Period 2, 2x2 block pair |
-| `pulsar` | Oscillator | Period 3, highly symmetric |
-| `r-pentomino` | Methuselah | 5 cells → 1103 generations to stabilize |
-| `random` | Soup | Seeded 35% density fill |
-
-## Output
-
-- `final_grid` — grid state after simulation
-- `alive_count` — live cells at end
-- `peak_population` — maximum live cells observed
-- `stabilized_at` — generation where grid reached equilibrium (-1 if not)
-- `extinction` — whether all cells died
-- `cells_processed` — total cell evaluations (for benchmarking)
-- `ascii_snapshot` — ASCII art of final state (max 80×40)
-
-## Fitness Characteristics
-
-| Metric | Expected |
-|--------|----------|
-| Success Rate | 1.0 (deterministic, no failure mode) |
-| Latency | <50ms for 64×64×100, ~2s for 512×512×1000 |
-| Resource Cost | O(w × h × g) memory: O(w × h) |
-| Robustness | Handles all edge cases (empty grid, max size, custom rules) |