# Paper Dynasty CLI Reference

**Load this when**: You need the full CLI command reference for `paperdomo` or `pd-cards`.

---

## paperdomo CLI

The `cli.py` provides a command-line interface for common operations.

**Shell Alias**: `paperdomo` (defined in `~/.bashrc`)

**Claude Code Note**: The alias is not available in non-interactive shells. Use the full path:
```bash
python ~/.claude/skills/paper-dynasty/cli.py <command>
```

### Commands

```bash
# Status & Health
python ~/.claude/skills/paper-dynasty/cli.py status    # Packs opened today summary
python ~/.claude/skills/paper-dynasty/cli.py health    # API health check

# Team Operations
paperdomo team list [--season N]              # List teams
paperdomo team get SKB                        # Get team details
paperdomo team cards SKB                      # List team's cards

# Pack Operations
paperdomo pack list [--team SKB] [--opened/--unopened]  # List packs
paperdomo pack today                          # Packs opened today analytics
paperdomo pack distribute --num 10            # Distribute packs to all teams
paperdomo pack distribute --num 11 --exclude CAR  # With exclusions

# Gauntlet Operations
paperdomo gauntlet list [--event-id 8] [--active]  # List gauntlet runs
paperdomo gauntlet teams [--active]           # List gauntlet teams
paperdomo gauntlet cleanup Gauntlet-SKB --event-id 8 --yes  # Cleanup team

# Player Operations
paperdomo player get 12345                    # Get player by ID
paperdomo player list [--rarity "Hall of Fame"] [--cardset 27]  # List players
```

### Global Options

```bash
--env prod|dev    # Environment (default: prod)
--json            # Output as JSON
--verbose / -v    # Show API request details
--yes / -y        # Skip confirmation for destructive operations
```

---

## pd-cards CLI

The card creation CLI for retrosheet processing, scouting, custom cards, and S3 uploads.

**Location**: `/mnt/NV2/Development/paper-dynasty/card-creation`

### Custom Cards

```bash
pd-cards custom list                              # List profiles
pd-cards custom preview <name>                    # Preview ratings
pd-cards custom submit <name>                     # Submit to DB
pd-cards custom new -n "Name" -t batter -h L      # New template
```

### Scouting Reports

```bash
pd-cards scouting all -c 27                       # All reports
pd-cards scouting batters -c 27 -c 29             # Batters only
pd-cards scouting pitchers -c 27                  # Pitchers only
```

### Retrosheet Processing

```bash
pd-cards retrosheet process 2005 -c 27 -d Live    # Full season
pd-cards retrosheet validate 27                   # Check positions
pd-cards retrosheet arms 2005 -e events.csv       # OF arm ratings
pd-cards retrosheet defense 2005 --output "dir/"  # Fetch defense stats
```

**Retrosheet Flags**:
- `--end YYYYMMDD` - End date for data processing
- `--start YYYYMMDD` - Start date for data processing
- `--season-pct FLOAT` - Season percentage (0.0-1.0)
- `--cardset-id, -c INT` - Target cardset ID
- `--description, -d TEXT` - "Live" or "Month PotM"
- `--dry-run, -n` - Preview without database changes
- `--last-week-ratio FLOAT` - Recency bias for last week
- `--last-twoweeks-ratio FLOAT` - Recency bias for last 2 weeks
- `--last-month-ratio FLOAT` - Recency bias for last month

### S3 Uploads

```bash
pd-cards upload s3 -c "2005 Live"                 # Upload to S3
pd-cards upload s3 -c "2005 Live" --limit 10      # Test with limit
pd-cards upload refresh -c "2005 Live"            # Regenerate
pd-cards upload check -c "2005 Live"              # Validate only
```

**Upload Flags**:
- `--cardset, -c`: Cardset name (required)
- `--start-id`: Resume from player ID
- `--limit, -l`: Max cards to process
- `--no-upload`: Validate only
- `--skip-batters/--skip-pitchers`: Skip card types
- `--dry-run, -n`: Preview mode

### Live Series

```bash
pd-cards live-series update -c "2025 Season" -g 81
pd-cards live-series status
```

---

## Scripts Directory

**Location**: `~/.claude/skills/paper-dynasty/scripts/`

```bash
# Gauntlet cleanup
python gauntlet_cleanup.py list --event-id 8 --active-only
python gauntlet_cleanup.py wipe --team-abbrev Gauntlet-SKB --event-id 8

# Pack distribution
DATABASE=prod python distribute_packs.py --num-packs 10
DATABASE=prod python distribute_packs.py --num-packs 11 --exclude-team-abbrev CAR

# Validation
python validate_database.py
```