claude-memory/CORE.md

Memory Core (auto-generated)

Last updated: 2026-02-14 | Active memories: 4/333 | Next refresh: daily (systemd timer)

Critical Solutions

• 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)
• Gitea Actions: Docker buildx cache auth requires login on all builds - When using Docker buildx with registry-based cache (cache-from/cache-to type=... (gitea, docker, ci-cd)
• CLAUDE.md optimization: 329 → 104 lines with table-based loading rules - Optimized project CLAUDE.md from 329 lines to 104 lines (68% reduction) by: (claude-config, optimization, documentation)
• Discord bot dynamic configuration with live reload - Implemented /add-project command for Claude Discord Coordinator that adds pro... (discord-bot, python, discord.py)
• Gitea Actions: Docker buildx registry cache auth fix - When using Docker buildx with registry-based cache (cache-from/cache-to type=... (gitea, docker, ci-cd)

Active Decisions

• Wave-based agent delegation avoids file contention - When delegating multiple tasks to agents that all modify the same file, run t... (cognitive-memory, agent-delegation, pattern)
• Agent delegation requires careful review of edge cases - When delegating implementation tasks to engineer agents, they reliably handle... (cognitive-memory, agent-delegation, code-review)
• Production deployment checklist for Paper Dynasty bot - CRITICAL: Always verify bot startup in production logs after deployment. (paper-dynasty, discord-bot, deployment)
• Store model aliases not specific IDs - When storing user model preferences (sonnet/opus/haiku), always store the ali... (ai-assistant, discord, claude)
• 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)

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)
• Missing logger import causes NameError in Python modules - Common bug when adding logging to existing Python code: calling logger.info()... (python, logging, bug)
• 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)

Configurations

• Cognitive Memory automated maintenance with systemd timers - Set up systemd user timers for automatic cognitive memory maintenance: (cognitive-memory, systemd, automation)
• Jarvis Discord Bot Production Deployment - The ai-assistant Discord bot (Jarvis) runs on ssh ai-pm at /opt/projects/clau... (ai-assistant, discord, deployment)
• Gitea CLI: use tea not gh for API access - The gh CLI does not work with Gitea — it's hardcoded for GitHub API v3 at /ap... (gitea, tea, cli)
• Discord bot systemd service with environment variables - Systemd service setup for Claude Discord Coordinator bot running as non-root... (discord-bot, systemd, deployment)
• claude-memory wrapper script for cleaner CLI usage - Created wrapper script at ~/.local/bin/claude-memory that exec's the cognitiv... (cognitive-memory, cli, configuration)
• CLAUDE.md: mandatory post-commit memories + claude-memory alias - Updated CLAUDE.md to make post-commit memory storage mandatory (not optional). (claude-config, cognitive-memory, configuration)
• major-domo-v2 main branch is protected on Gitea - The main branch on cal/major-domo-v2 (Gitea) is protected. (major-domo, gitea, config)
• 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

• CLAUDE.md audit and optimization workflow - When CLAUDE.md files get bloated, audit by category: (1) Historical changelog... (claude-code, optimization, workflow)
• CRITICAL: Git commit requires explicit user approval - Before ANY git commit/add/push/deploy command, STOP and verify: (paper-dynasty, major-domo, git)
• Global slash commands are .md files in ~/.claude/commands/ - Claude Code global slash commands live in ~/.claude/commands/.md. (claude-code, pattern, slash-commands)
• 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)