claude-memory/CORE.md

Memory Core (auto-generated)

Last updated: 2026-02-13 | Active memories: 3/314 | Next refresh: manual

Critical Solutions

• Integration Test Alpha - Alpha content about socket_keepalive configuration for Redis timeout handling. (alpha, beta, redis)
• CACHE_ENABLED env var for Major Domo API - Added CACHE_ENABLED environment variable to toggle Redis caching on/off witho... (major-domo, redis, caching)
• Paper Dynasty: Database sync workflow for prod to dev - Created automated workflow to sync production PostgreSQL database (akamai) to... (paper-dynasty, postgresql, database)
• Fix: pitcher error ratings silently failed due to unpacked range() in list membership - In dice.py sa_fielding_roll(), pitcher (P position) error checks used range()... (paper-dynasty, python, fix)
• Play lock context manager refactor - locked_play - Created command_logic/play_context.py with locked_play async context manager. (paper-dynasty, python, fix)
• Fix for play lock never released on exception - Implemented 3-layer defense against stuck play locks: (1) Added release_play_... (paper-dynasty, python, discord-bot)
• Gitea Actions runner offline - must use internal URL not public domain - Problem: Gitea Actions runner showing as 'Offline' in admin UI, jobs stuck in... (gitea, ci-cd, actions)
• Brave ERR_SSL_UNRECOGNIZED_NAME fix for local reverse proxy with Cloudflare DNS - Chromium-based browsers (Brave, Chrome, Edge) fail with ERR_SSL_UNRECOGNIZED_... (brave, chrome, ssl)
• Docker-in-LXC requires AppArmor unconfined on Proxmox - When creating a Proxmox LXC container to run Docker, the container needs AppA... (proxmox, docker, lxc)
• Circular import fix: move shared utilities to standalone module - When two modules import from each other, create a standalone module for share... (python, circular-import, architecture)

Active Decisions

• Production deployment checklist for Paper Dynasty bot - CRITICAL: Always verify bot startup in production logs after deployment. (paper-dynasty, discord-bot, deployment)
• Mantimon TCG Engine: Highly Configurable Design - The game engine must be extremely configurable to support 'free play' mode wh... (mantimon-tcg, architecture, decision)
• Store DeckConfig with Decks - When a deck is created, the DeckConfig used for validation should be persiste... (mantimon-tcg, architecture, decision)
• Mantimon TCG: RNG and Card Registry Design - RNG Handling: Use RandomProvider protocol with two implementations - SeededRa... (mantimon-tcg, architecture, decision)
• Phase 4 Game Service + WebSocket Plan - Created detailed 18-task project plan for Phase 4: WebSocket server with pyth... (mantimon-tcg, python, websocket)
• Card builder architecture redesign - Designed new architecture for Paper Dynasty card generation that moves fittin... (paper-dynasty, architecture, card-generation)
• Phase 3 Collections+Decks plan created - Created comprehensive PHASE_3_COLLECTION_DECKS.json with 14 tasks (29 hrs): C... (mantimon-tcg, python, planning)
• Removed http_trigger in favor of jumbo package - Removed deprecated http_trigger endpoint and denormalize_object function from... (esb-monorepo, python, refactor)

Key Fixes

• Successfully fixed Paper Dynasty API 502 errors via manual Pi-hole DNS cleanup - Paper Dynasty API (pd.manticorum.com) was returning 502 Bad Gateway errors (paper-dynasty, pihole, v6)
• PostgreSQL migration: get_team_by_owner returns wrong team - After PostgreSQL migration, get_team_by_owner() in discord-app returned the g... (paper-dynasty, postgresql, migration)
• PostgreSQL migration: DateTimeField defaults must be datetime objects - Paperdex and GauntletRun models had DateTimeField(default=int(datetime.timest... (paper-dynasty, postgresql, migration)
• Added default ORDER BY id to BattingCardRatings.select() in list endpoints - Updated battingcardratings.py to add .order_by(BattingCardRatings.id) to thre... (paper-dynasty, python, postgresql)
• Add default ORDER BY id to GameRewards.select() list endpoint - Modified gamerewards.py GET list endpoint to use GameRewards.select().order_b... (paper-dynasty, python, postgres-migration)
• Add default ORDER BY id to PackType list endpoint - Modified GET /api/v2/packtypes endpoint to include default ordering: PackType... (paper-dynasty, postgresql, migration)
• Added default ORDER BY id to notifications list endpoint - Modified GET /api/v2/notifs endpoint in app/routers_v2/notifications.py to ad... (paper-dynasty, postgresql, migration)
• Added default ORDER BY id to MlbPlayer.select() endpoint - Added .order_by(MlbPlayer.id) to the GET /mlbplayers list endpoint (line 85 i... (paper-dynasty, postgresql, migration)
• Added default ordering to StratPlay list endpoint - Added .order_by(StratPlay.id) to StratPlay.select() in the GET list endpoint... (paper-dynasty, postgresql, migration)
• Added default ordering to PitchingStat list endpoint - Added .order_by(PitchingStat.id) to the main GET list endpoint in pitstats.py... (paper-dynasty, postgresql, migration)

Configurations

• Uptime Kuma deployed on LXC 227 - Uptime Kuma service monitoring deployed on Proxmox LXC 227 (10.10.0.227). (uptime-kuma, monitoring, homelab)
• OpenCode agent model configuration - Configured default models for OpenCode agents in ~/.config/opencode/opencode.... (opencode, configuration, models)

Patterns & Workflows

• CRITICAL: Git commit requires explicit user approval - Before ANY git commit/add/push/deploy command, STOP and verify: (paper-dynasty, major-domo, git)
• Optional locking parameter pattern for read vs write commands - In Paper Dynasty, added lock_play parameter (default=True) to checks_log_inte... (paper-dynasty, python, discord-bot)
• Paper Dynasty: 2005 Live Series card update workflow (mid-season) - Task**: Update 2005 Live cardset through end of July (mid-season update) (paper-dynasty, cardset, 2005)
• Deploy Major Domo with feature branch workflow and Docker BuildKit workaround - Workflow**: Successfully deployed dem_week feature to production using featur... (major-domo, deployment, workflow)

Known Issues

• Play lock never released on exception - causes permanent user lockout - The play locking system in checks_log_interaction() sets play.locked=True and... (paper-dynasty, python, discord-bot)
• Paper Dynasty bot freeze from duplicate X-Check interaction submissions - Bot event loop freezes when user double-submits X-Check corrections (clicking... (paper-dynasty, discord-bot, sqlalchemy)
• Violated git commit approval - deployed without permission - 2026-02-04: Fixed gauntlet-9 KeyError bug in Paper Dynasty database API. (paper-dynasty, database, git)
• Pi-hole v6 DNS sync script needs update for new TOML config format - The npm-pihole-sync.sh script at /mnt/NV2/Development/claude-home/server-conf... (pihole, npm, dns)
• Critical: Wrong API parameter name - used 'dem_week' instead of 'demotion_week' - Error**: Player team updates sent wrong parameter name to API, causing dem_we... (major-domo, python, api)
• Intermittent SSL connection failures from internal network - Symptom: ERR_SSL_UNRECOGNIZED_NAME_ALERT appears intermittently when accessin... (networking, dns, ssl)
• Gitea API 403 Forbidden - insufficient token scopes - PROBLEM: Gitea API returned 403 Forbidden with message 'token does not have a... (gitea, api, authentication)
• Production crash: Missing Optional import in type hint caused NameError - Error**: Bot crashed on production startup with 'NameError: name Optional is... (major-domo, python, production)