claude-memory/CORE.md

Memory Core (auto-generated)

Last updated: 2026-03-03 | Active memories: 212/568 | Next refresh: daily (systemd timer)

Critical Solutions

• N8N + Claude Code Automated Server Monitoring System - Built automated server health monitoring with N8N and Claude Code headless mode. (n8n, claude-code, automation)
• Claude Scheduled Tasks: headless Claude Code on systemd timers - Built a "Claude Cowork"-style scheduled task system using systemd timers and... (claude-scheduled, systemd, automation)
• Claude Scheduled Tasks: headless Claude Code on systemd timers - Built a "Claude Cowork"-style scheduled task system using systemd timers and... (claude-scheduled, systemd, automation)
• Migration Script: Default-to-Named-Graph Memory Transfer - /mnt/NV2/Development/cognitive-memory/scripts/migrate-memories.py (cognitive-memory, migration, multi-graph)
• Docker MCP Gateway secrets workaround for headless Docker Engine (no Docker Desktop) - docker mcp secret set requires Docker Desktop's docker-pass CLI plugin (l... (docker-mcp-gateway, mcp, secrets)
• Expanded health monitoring to 6 servers with per-server SSH user support - Expanded CT 302 health check coverage from 3 to 6 monitored servers. (monitoring, claude-runner-monitoring, homelab)
• Cognitive Memory v3.0: Rich Edges + Hybrid Embeddings + MCP Server - Major upgrade to cognitive-memory skill. (cognitive-memory, mcp, architecture)
• Proxmox 7 to 8 upgrade completed successfully - Successfully upgraded Proxmox from PVE 7.4-20 (kernel 5.13.19) to PVE 8.4.16... (proxmox, homelab, upgrade)
• Agent Swarm Orchestrator: architecture decisions and lessons learned - Built a lightweight orchestration system using Claude Code native primitives. (orchestrator, swarm, claude-code)
• Gitea Actions composite action auth fix - DEFAULT_ACTIONS_URL=self + REQUIRE_SIGNIN_VIEW=false - Problem: act_runner fails to clone composite actions from cal/gitea-actions w... (gitea, ci-cd, actions)

Active Decisions

• Extracted cognitive-memory app from skill dir to standalone project - Moved all application code (~6K lines) from `~/.claude/skills/cognitive-memor... (cognitive-memory, architecture, extraction)
• Cognitive memory data dir moved to XDG-compliant path (~/.local/share/cognitive-memory/) - Moved default data directory from hardcoded ~/.claude/memory/ to XDG Base D... ([\"cognitive-memory\", xdg, architecture)
• Skill organization: scoped user skills over symlinks - When skills need to be shared across multiple projects but not all projects,... (claude-code, skills, organization)
• Auto-edge creation on memory_store in MCP server - Implemented auto-edge creation in mcp_server.py that runs after every `memo... (cognitive-memory, edges, mcp)
• Multi-graph support: named, segregated memory namespaces for cognitive memory - Implemented multi-graph support for cognitive memory (Gitea issue #1). ([\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\"cognitive-memory\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\\", multi-graph, architecture)
• Removed CORE.md auto-loading from sessions — rely on MCP recall instead - Removed the MEMORY.md symlink mechanism that auto-loaded CORE.md (~3K tokens)... ([\\\"cognitive-memory\\\", core-md, optimization)
• PR Reviewer: Scheduled Poller over Webhook Trigger - Chose Approach C (scheduled poller) over webhook-triggered (Approach A) o... (pr-reviewer, claude-scheduled, architecture)
• PR Reviewer: Review All PRs Including AI-Generated - The PR reviewer agent reviews ALL open PRs, including those created by th... (pr-reviewer, issue-worker, safety)
• Issue Worker Agent: Phased Workflow Architecture - Rewrote the issue-worker agent at ~/.claude/agents/issue-worker.md from a f... (claude-configs, issue-worker, agent-design)
• Cognitive memory multi-graph support and scheduled tasks system issues opened on Gitea - Both filed on cal/claude-memory Gitea repo. (cognitive-memory, scheduled-tasks, systemd)

Key Fixes

• Fix: N8N MCP partial updates corrupt workflows via typeVersion bumps - Using n8n_update_partial_workflow to bump typeVersion values on nodes (e.... (n8n, mcp, n8n-mcp)
• Fix: Claude Code PostToolUse hook correct JSON format - Claude Code hooks were not firing because the configuration used incorrect fi... (sba-scouting, rust, claude-code)
• Fix: sqlx in-memory SQLite pool requires max_connections=1 - Integration tests using :memory: SQLite failed with "no such table" errors... (sba-scouting, rust, sqlx)
• Fix: N8N Master Loop Discord Summary node missing URL caused silent failures - The "Server Health Monitor - Master Loop" workflow (ID: p7XmW23SgCs3hEkY) w... (n8n, server-diagnostics, discord)
• Fix: Partial UUID prefix matching in cognitive memory client (git-style) - Users had to type full UUIDs when referencing memories or edges via the client. (cognitive-memory, fix, uuid)
• Fix: Replace manual db.close() calls with FastAPI middleware in paper-dynasty-database - 467 manual db.close() calls across 30 router files in app/routers_v2/. (paper-dynasty-database, fastapi, peewee)
• Fix: swallowed HTTPException in recalculate_standings — use sed to avoid linter reformatting - app/routers_v3/standings.py line 124 constructed an HTTPException but nev... (major-domo-database, fastapi, python)
• [major-domo] fix: refresh roster data before validation to prevent stale cache - Commits made: 2 (major-domo, commit, configuration)
• [major-domo] refactor: move 42 unnecessary lazy imports to top-level across codebase - Commits made: 2 (major-domo, commit, configuration)
• [major-domo] fix: auto-detect player roster type in trade commands instead of assuming ML - Commits made: 1 (major-domo, commit, creation)

Configurations

• CT 302 claude-runner provisioned for server diagnostics - VMID:** 302, IP: 10.10.0.148, Hostname: claude-runner (proxmox, homelab, monitoring)
• n8n-mcp server setup for Claude Code via mcp-manager - Added n8n-mcp (czlonkowski/n8n-mcp v2.35.3) as an on-demand MCP server mana... (n8n, mcp, claude-code)
• PR Reviewer Agent Definition and Dispatcher System - Built a complete automated PR review system using Claude Code. (pr-reviewer, claude-scheduled, gitea)
• MCP servers go in ~/.claude.json, NOT ~/.claude/.mcp.json - Global MCP servers** must be defined in ~/.claude.json under the top-level... (claude-code, mcp, configuration)
• Config: mcp-tui-driver MCP server installed globally - Installed from source via cargo: (mcp, tui-testing, claude-code)
• CT 300 claude-runner: Two-Tier Health Check Architecture - The headless Claude server diagnostics system runs on CT 300 (hostname: `... (ct300, claude-runner, server-diagnostics)
• Path references updated across 6 files after cognitive-memory extraction - After moving app code from ~/.claude/skills/cognitive-memory/ to `/mnt/NV2/... (cognitive-memory, configuration, claude-code)
• Discord Webhook Notifications in claude-scheduled runner.sh - Added opt-in Discord notification to ~/.config/claude-scheduled/runner.sh. (claude-scheduled, discord, webhook)
• issue-worker Agent Definition: Autonomous Gitea PR Creator - ~/.claude/agents/issue-worker.md (claude-agents, issue-worker, autonomous)
• Dotfiles Repo: claude-scheduled and systemd Units with Token Templating - Added full claude-scheduled/ directory and systemd units to cal/dotfiles... (dotfiles, symlink, claude-scheduled)

Key Procedures

• Self-managing n8n server health monitor with sub-workflows - Master + sub-workflow pattern in n8n for server health monitoring via CT 302... (n8n, homelab, monitoring)
• Add a new server to n8n health monitoring - To add a new server to the automated health monitoring system, only one file... (n8n, monitoring, homelab)
• Cognitive-memory has no test suite — use inline smoke tests - The cognitive-memory project at /mnt/NV2/Development/cognitive-memory/ has... (cognitive-memory, testing, workflow)