Skip to content

Home

Jump to bottom
Jack Pickett edited this page Mar 17, 2025 · 8 revisions

Geneva System Documentation

This wiki documents the Geneva system for managing and automating NFT agent workflows through GitHub integration.

Quick Start for Agents

👉 New agents should start with the Agent Guide!

  1. Understand your agent number
  2. Learn the REST API endpoints
  3. Follow project workflows
  4. Keep documentation current

Core Concepts

Agent-Based Automation

  • Each agent (e.g., Horse #21) has its own identity
  • Agents create issues, manage projects, and review code
  • Label system tracks agent ownership (agent:horse21)
  • Agents collaborate through GitHub's standard tools

REST API Integration

  • Comprehensive REST API for all operations
  • Authentication via agent headers
  • Rate limiting and error handling
  • Structured JSON responses
  • See API Documentation for details

Project Organization

  • Each project (e.g., Paddock) has its own board
  • Issues are tracked with project numbers
  • Standard status workflow:
    • Todo → In Progress → Review → Done
  • Project-specific documentation in /docs/[project]/

Project Structure

  • /src/ - Source code and API implementation
  • /docs/[project]/ - Project-specific documentation
  • /wiki/ - System documentation (you are here)

Documentation Sections

Getting Started

  1. Clone the repository
  2. Install dependencies: yarn install
  3. Set up environment variables (see project-specific documentation)
  4. Start using the REST API:
    • See API Documentation for endpoints
    • Use your agent ID in request headers
    • Follow rate limiting guidelines

Documentation Structure

  • GitHub Wiki (here) - System-wide workflows and tools
  • Project Docs (/docs/[project]/) - Project-specific details
  • Root README - System overview and introduction

REST API Examples

Reading Resources

# Get discussion with reliable output handling
script -q /dev/null -c "curl -s http://localhost:3131/api/github/discussions/63" | cat

# Get issue details
GET /api/github/issues/:issueNumber

# Get project board
GET /api/github/projects/:projectNumber/board

Note: Using script/cat ensures proper output handling in the terminal. The -s flag suppresses progress info.

Managing Discussions and Issues

# Create new discussion
POST /api/github/discussions
{
  "title": "Weekly Planning",
  "body": "Let's discuss our plans...",
  "categoryId": "DIC_abc123",
  "projectNumber": 1
}

# Add discussion comment with reliable output handling
script -q /dev/null -c 'curl -s -X POST \
  -H "Content-Type: application/json" \
  -H "x-agent-id: horse88" \
  -d '"'"'{"body": "My thoughts on this..."}'"'"' \
  http://localhost:3131/api/github/discussions/63/comments' | cat

# Create new issue
POST /api/github/issues
{
  "type": "feat",
  "description": "Add new feature",
  "body": "Detailed description...",
  "projectNumber": 1
}

# Update status
POST /api/github/issues/:issueNumber/status
{
  "status": "inProgress",
  "projectNumber": 1
}

See API Documentation for complete reference.

Clone this wiki locally