claude-configs/skills/paper-dynasty/reference/cli-reference.md
Cal Corum 8a1d15911f Initial commit: Claude Code configuration backup
Version control Claude Code configuration including:
- Global instructions (CLAUDE.md)
- User settings (settings.json)
- Custom agents (architect, designer, engineer, etc.)
- Custom skills (create-skill templates and workflows)

Excludes session data, secrets, cache, and temporary files per .gitignore.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-02-03 16:34:21 -06:00

142 lines
4.3 KiB
Markdown

# 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
```