Modularize major-domo skill (1005 -> 173 lines in SKILL.md)
Extract API and CLI references into dedicated files: - SKILL.md (173 lines): routing, safety rules, architecture, common queries - API_REFERENCE.md (99 lines): endpoints, auth, Python client - CLI_REFERENCE.md (115 lines): commands, flag ordering, compliance workflow Total content reduced from 1005 to 387 lines. Context loaded per session drops from 1005 to 173 lines. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
Cal Corum
parent
db1f2e2d4b
commit
67337a6771
99
skills/major-domo/API_REFERENCE.md
Normal file
99
skills/major-domo/API_REFERENCE.md
Normal file
@ -0,0 +1,99 @@
|
||||
# Major Domo - API Reference
|
||||
|
||||
## Authentication
|
||||
|
||||
All write operations require Bearer token:
|
||||
```bash
|
||||
export API_TOKEN='your-token-here'
|
||||
```
|
||||
|
||||
## Environments
|
||||
|
||||
- **Production**: `https://api.sba.manticorum.com/v3/`
|
||||
- **Development**: `http://10.10.0.42:8000/api/v3/`
|
||||
|
||||
```bash
|
||||
export DATABASE='prod' # or 'dev'
|
||||
```
|
||||
|
||||
## Endpoints
|
||||
|
||||
### Current Status
|
||||
- `GET /current` - Current season/week status
|
||||
- `GET /current?season={N}` - Specific season status
|
||||
- `PATCH /current/{id}` - Update status (private)
|
||||
|
||||
### Players
|
||||
- `GET /players?season={N}` - List all players in season
|
||||
- `GET /players?team_id={id}` - Players by team
|
||||
- `GET /players?name={name}` - Players by name (exact)
|
||||
- `GET /players/search?q={query}` - Fuzzy search
|
||||
- `GET /players/{id}` - Single player
|
||||
- `PATCH /players/{id}` - Update player (private)
|
||||
|
||||
### Teams
|
||||
- `GET /teams?season={N}` - List teams
|
||||
- `GET /teams?team_abbrev={abbrev}` - By abbreviation
|
||||
- `GET /teams?active_only=true` - Active teams only
|
||||
- `GET /teams/{id}` - Single team
|
||||
- `GET /teams/{id}/roster/{which}` - Roster (current/next)
|
||||
|
||||
### Standings
|
||||
- `GET /standings?season={N}` - All standings
|
||||
- `GET /standings?season={N}&division_abbrev={div}` - By division
|
||||
- `GET /standings/team/{team_id}` - Single team
|
||||
- `POST /standings/s{season}/recalculate` - Recalculate (private)
|
||||
|
||||
### Transactions
|
||||
- `GET /transactions?season={N}` - List transactions
|
||||
- `GET /transactions?season={N}&team_abbrev={abbrev}` - By team
|
||||
- `GET /transactions?season={N}&week_start={W}&week_end={W}` - By week range
|
||||
- `PATCH /transactions/{move_id}` - Update (private)
|
||||
|
||||
### Statistics (Advanced Views)
|
||||
- `GET /views/season-stats/batting?season={N}` - Season batting
|
||||
- Params: `team_id`, `player_id`, `min_pa`, `sort_by`, `sort_order`, `limit`, `offset`
|
||||
- `GET /views/season-stats/pitching?season={N}` - Season pitching
|
||||
- Params: `team_id`, `player_id`, `min_outs`, `sort_by`, `sort_order`, `limit`, `offset`
|
||||
- `POST /views/season-stats/batting/refresh` - Refresh batting (private)
|
||||
- `POST /views/season-stats/pitching/refresh` - Refresh pitching (private)
|
||||
|
||||
### Other Endpoints
|
||||
- `/api/v3/schedules` - Game scheduling
|
||||
- `/api/v3/results` - Game results
|
||||
- `/api/v3/injuries` - Injury tracking
|
||||
- `/api/v3/awards` - League awards
|
||||
- `/api/v3/managers` - Manager profiles
|
||||
- `/api/v3/divisions` - Division info
|
||||
- `/api/v3/draftdata` - Draft status
|
||||
- `/api/v3/draftpicks` - Pick ownership
|
||||
- `/api/v3/draftlist` - Draft priority lists
|
||||
- `/api/v3/keepers` - Keeper selections
|
||||
- `/api/v3/stratgame` - Game data
|
||||
- `/api/v3/stratplay` - Play-by-play
|
||||
- `/api/v3/sbaplayers` - Player pool
|
||||
- `/api/v3/custom_commands` - Custom Discord commands
|
||||
- `/api/v3/help_commands` - Static help text
|
||||
|
||||
## Python API Client
|
||||
|
||||
```python
|
||||
from api_client import MajorDomoAPI
|
||||
|
||||
api = MajorDomoAPI(environment='prod', verbose=True)
|
||||
# Or: api = MajorDomoAPI(environment='dev', token='your-token')
|
||||
|
||||
# Common operations
|
||||
current = api.get_current()
|
||||
team = api.get_team(abbrev='CAR')
|
||||
player = api.get_player(name='Mike Trout', season=12)
|
||||
results = api.search_players(query='trout', season=12, limit=10)
|
||||
roster = api.get_team_roster(team_id=42, which='current')
|
||||
standings = api.get_standings(season=12, division_abbrev='ALE')
|
||||
transactions = api.get_transactions(season=12, team_abbrev='CAR')
|
||||
batting = api.get_season_batting_stats(season=12, min_pa=100, sort_by='woba', limit=50)
|
||||
pitching = api.get_season_pitching_stats(season=12, min_outs=150, sort_by='era', limit=50)
|
||||
```
|
||||
|
||||
**OpenAPI docs**: `http://10.10.0.42/api/docs`
|
||||
**Router source**: `/mnt/NV2/Development/major-domo/database/app/routers_v3/`
|
||||
115
skills/major-domo/CLI_REFERENCE.md
Normal file
115
skills/major-domo/CLI_REFERENCE.md
Normal file
@ -0,0 +1,115 @@
|
||||
# Major Domo - CLI Reference
|
||||
|
||||
## Invocation
|
||||
|
||||
**Wrapper**: `majordomo` (alias, uses `uv run`)
|
||||
|
||||
**Full path** (for Claude Code):
|
||||
```bash
|
||||
python3 ~/.claude/skills/major-domo/cli.py <command>
|
||||
```
|
||||
|
||||
## Flag Ordering
|
||||
|
||||
`--env`, `--json`, `--verbose` are **top-level flags** (BEFORE subcommand).
|
||||
`--season` is a **subcommand flag** (AFTER subcommand).
|
||||
|
||||
```bash
|
||||
# Correct:
|
||||
python3 ~/.claude/skills/major-domo/cli.py --json team get CLS
|
||||
python3 ~/.claude/skills/major-domo/cli.py --env dev team roster CAN
|
||||
|
||||
# Wrong (will error):
|
||||
python3 ~/.claude/skills/major-domo/cli.py team get CLS --json
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
### Status
|
||||
```bash
|
||||
cli.py status # Current season/week
|
||||
cli.py health # API health check
|
||||
```
|
||||
|
||||
### Players
|
||||
```bash
|
||||
cli.py player get "Mike Trout" # Get player info
|
||||
cli.py player search "trout" # Fuzzy search
|
||||
cli.py player move "Name" TEAM # Move single player
|
||||
cli.py player move --batch "N1:T1,N2:T2" # Batch moves
|
||||
```
|
||||
|
||||
### Teams
|
||||
```bash
|
||||
cli.py team list [--active] # List teams
|
||||
cli.py team get CAR # Team details
|
||||
cli.py team roster CAR # Roster breakdown (Active/Short IL/Long IL)
|
||||
```
|
||||
|
||||
### Standings
|
||||
```bash
|
||||
cli.py standings [--division ALE] # League standings
|
||||
```
|
||||
|
||||
### Transactions
|
||||
```bash
|
||||
cli.py transactions --team CLS --week 9 # Team transactions
|
||||
cli.py transactions list --week-start 1 --week-end 4 # Week range
|
||||
cli.py transactions --player "Mike Trout" # Player transactions
|
||||
cli.py transactions simulate CLS "Stott:CLSMiL,Walker:CLS" # Compliance check (dry run)
|
||||
```
|
||||
|
||||
### Injuries
|
||||
```bash
|
||||
cli.py injuries list --team CLS --active # Active injuries for team
|
||||
cli.py injuries list --sort return-asc # Sort by return date
|
||||
```
|
||||
|
||||
### Statistics
|
||||
```bash
|
||||
cli.py stats batting --sort woba --min-pa 100 --limit 25 # Batting leaders
|
||||
cli.py stats pitching --sort era --min-outs 100 --limit 25 # Pitching leaders
|
||||
cli.py stats batting --team CLS # Team batting
|
||||
```
|
||||
|
||||
### Results & Schedule
|
||||
```bash
|
||||
cli.py results --team CLS --week 9 # Team results
|
||||
cli.py results list --week-start 1 --week-end 4 # Range
|
||||
cli.py schedule --team CLS --week 10 # Team schedule
|
||||
cli.py schedule list --week-start 10 --week-end 12 # Range
|
||||
```
|
||||
|
||||
### Admin (write operations)
|
||||
```bash
|
||||
cli.py admin recalculate-standings # Recalculate standings
|
||||
cli.py admin refresh-batting # Refresh batting view
|
||||
cli.py admin refresh-pitching # Refresh pitching view
|
||||
cli.py admin refresh-stats # Refresh both views
|
||||
cli.py admin refresh-batting --season 11 # Specific season
|
||||
```
|
||||
|
||||
## Key Notes
|
||||
|
||||
- `team get` shows salary_cap in formatted output; use `--json` for all fields
|
||||
- `team roster` shows Active/Short IL/Long IL with WARA values for Active only
|
||||
- "Long IL" = MiL (minor leagues)
|
||||
- For individual player lookups, use `player get "Name"` — bulk queries can timeout
|
||||
- `transactions simulate` validates compliance without making changes
|
||||
- `stats` commands support standard baseball stats sorting (woba, obp, slg, era, whip, fip, etc.)
|
||||
|
||||
## Transaction Compliance Workflow
|
||||
|
||||
```bash
|
||||
# 1. Simulate proposed moves (dry run)
|
||||
cli.py transactions simulate CLS "Stott:CLSMiL,Walker:CLS,Castellanos:FA,Martin:CLS"
|
||||
|
||||
# Validates: roster count = 26, total sWAR <= salary_cap, all players exist
|
||||
```
|
||||
|
||||
**Manual verification** (if needed):
|
||||
1. `cli.py team roster ABBREV` → note count and WARA
|
||||
2. `cli.py --json team get ABBREV` → read `salary_cap`
|
||||
3. `cli.py player get "Name"` for each incoming player
|
||||
4. Calculate: current sWAR ± changes <= cap, roster = 26
|
||||
5. `cli.py player move --batch "Name1:Team1,Name2:Team2"`
|
||||
File diff suppressed because it is too large
Load Diff
Loading…
Reference in New Issue
Block a user