多语言代码生成工具

    ╔══════════════════╦═══════════════╦══════════════╤▶══╗ ·*·     ·*·        _..--""""--.._
    ║░░░░░░░░░░░░░░░░░░║ ANY  LANGUAGE ║▓▓▓▓▓▓▓▓▓▓▓▓▓▓├▶  ╠═))·*·*·*·*·((══.'                '-.
    ╚══════════════════╩═══════════════╩══════════════╧▶══╝ ·*·     ·*· .'    Go                '.
             │                                                        /    Rust ╲      │      ╱ Java \
             │   ██████╗ ██████╗  ██████╗                             |          ╲     │     ╱        |
            ╱╲   ██╔══██╗██╔══██╗██╔════╝                             |           ╲    │    ╱         |
           ╱  ╲  ██████╔╝██████╔╝██║  ███╗                            |       _____╲___│___╱_____     |
          ╱    ╲ ██╔══██╗██╔═══╝ ██║   ██║                            | C# ────────(⚡)──────── Python |
                 ██║  ██║██║     ╚██████╔╝                            |       ‾‾‾‾‾╱‾‾‾│‾‾‾╲‾‾‾‾‾     |
                 ╚═╝  ╚═╝╚═╝      ╚═════╝                              \          ╱    │    ╲        /
                                                                        '.      ╱     │     ╲     .'
                 Rosetta Project Generator                               '-.      TypeScript   .-'
                                                                            ''--..______..--''

# Clone the repository
git clone https://github.com/kon1790/rpg.git
cd rpg

# Build
make build
# or
go build -o bin/rpg ./cmd/rpg

# Verify
./bin/rpg --help

{
  "mcpServers": {
    "rpg": {
      "command": "/absolute/path/to/rpg"
    }
  }
}

{
  "mcpServers": {
    "rpg": {
      "command": "/absolute/path/to/rpg",
      "args": ["--output", "./generated"]
    }
  }
}

rpg [options]

Options:
  -o, --output <dir>    Base output directory for generated projects (default: ./output)
                        Projects are saved to: <output>/<project-name>/<language>/

Use rpg import_spec_from_github on owner/repo to analyze the codebase
Generate a spec from the analysis, then port to TypeScript and Go

Use rpg generate_source_from_spec to create a Rust implementation from my-api.spec.md
The tool will automatically validate parity and iterate until complete

Use rpg list_project_languages on ./my-project to see what languages are used
Use rpg deep_analyze_source for semantic analysis of the Go code
Use rpg get_files_for_language for SQL and Protobuf files

Use rpg iterative_refinement_loop to port my Go project to TypeScript
Keep refining until 95% parity is achieved

Use rpg get_generation_context for examples/my-api.spec.md in typescript
Generate the slugify spec in go, rust, and python
Use rpg ensure_parity to compare implementations

Your Code           RPG Analysis          AI Generation        Multi-Language
    │                    │                     │                     │
    ├── src/*       ────►│                     │                     │
    ├── tests/*     ────►│ import_spec_from   │ Creates natural    │ Go
    ├── config      ────►│ _source/_github ──►│ language spec  ───►│ Rust
    └── README      ────►│                     │                     │ TypeScript
                         └── Analysis Prompt ──┘                     └─ Python...

# Import directly from GitHub (supports owner/repo shorthand)
Use rpg import_spec_from_github on owner/repo

# With specific branch
Use rpg import_spec_from_github on owner/repo@main

# Full URL also works
Use rpg import_spec_from_github on https://github.com/owner/repo

# Import from local path
Use rpg import_spec_from_source on ./legacy-api

# AI generates spec (review and refine as needed)
# Then generate in new languages
Use rpg get_generation_context for ./specs/my-project.spec.md in go
Use rpg get_generation_context for ./specs/my-project.spec.md in rust

# Verify parity
Use rpg ensure_parity to compare implementations

# url-shortener
A service that shortens URLs and redirects them.
Store mappings in memory.

# url-shortener

## Functions
### shorten(url: string): string
Takes a long URL and returns a 6-character code.

### resolve(code: string): string
Returns the original URL for a code, or throws if not found.

# url-shortener
I need a URL shortening service like bit.ly. When someone gives us a long URL,
we generate a short code. Later they can use that code to get redirected.
Keep it simple - just store everything in memory for now.

# 1. Write your spec (any style)
cat > my-api.spec.md << 'EOF'
# my-api
A REST API for managing tasks. Users can create, list, and complete tasks.
Use SQLite for storage.
EOF

# 2. Generate in any language
Use rpg get_generation_context for my-api.spec.md in typescript

# Create spec
cat > examples/my-api.spec.md << 'EOF'
# my-api

A simple REST API for managing items.

## Target Languages
- go
- typescript

## Data Model
### Item
- id: UUID
- name: Text
- created_at: Timestamp

## API Design

EOF

Use rpg to get the generation context for examples/my-api.spec.md in go,
then generate the complete implementation.

Now generate the same spec in typescript.

Use rpg ensure_parity to compare the go and typescript implementations
and fix any missing features.

{
  "specPath": "examples/my-app.spec.md",
  "projects": [
    {"language": "csharp", "path": "output/my-app/csharp"},
    {"language": "java", "path": "output/my-app/java"}
  ]
}

output/
├── slugify/
│   ├── go/
│   │   ├── go.mod
│   │   ├── slugify.go
│   │   └── slugify_test.go
│   ├── python/
│   │   ├── pyproject.toml
│   │   └── slugify.py
│   └── typescript/
│       ├── package.json
│       └── src/slugify.ts
└── bookmark-manager/
    ├── csharp/
    │   ├── BookmarkManager.csproj
    │   ├── Program.cs
    │   └── ...
    └── java/
        ├── pom.xml
        ├── src/main/java/...
        └── ...

rpg/
├── cmd/rpg/              # CLI entry point
├── internal/
│   ├── server/           # MCP server implementation
│   │   ├── server.go     # Server setup and registration
│   │   └── handlers.go   # Tool handlers
│   ├── parser/           # Spec file parser
│   └── languages/        # Language adapters
│       ├── go.go
│       ├── rust.go
│       ├── java.go
│       ├── csharp.go
│       ├── python.go
│       └── typescript.go
├── pkg/spec/             # Public types
├── examples/             # Example spec files
├── output/               # Generated projects (default)
├── Makefile
└── .mcp.json             # MCP configuration

Use rpg list_languages