claude-memory/CORE.md
2026-03-02 00:00:29 -06:00

61 lines
11 KiB
Markdown

# Memory Core (auto-generated)
> Last updated: 2026-03-02 | Active memories: 194/518 | Next refresh: daily (systemd timer)
## Critical Solutions
- [N8N + Claude Code Automated Server Monitoring System](graph/solutions/n8n-claude-code-automated-server-monitoring-system-62ee21.md) - 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](graph/solutions/claude-scheduled-tasks-headless-claude-code-on-systemd-timer-cb5e88.md) - Built a "Claude Cowork"-style scheduled task system using systemd timers and... (claude-scheduled, systemd, automation)
- [Migration Script: Default-to-Named-Graph Memory Transfer](graph/solutions/migration-script-default-to-named-graph-memory-transfer-5fb6b3.md) - `/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)](graph/solutions/docker-mcp-gateway-secrets-workaround-for-headless-docker-en-d82c52.md) - `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](graph/solutions/expanded-health-monitoring-to-6-servers-with-per-server-ssh-e32b20.md) - 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](graph/solutions/cognitive-memory-v30-rich-edges-hybrid-embeddings-mcp-server-9ea720.md) - Major upgrade to cognitive-memory skill. (cognitive-memory, mcp, architecture)
- [Proxmox 7 to 8 upgrade completed successfully](graph/solutions/proxmox-7-to-8-upgrade-completed-successfully-f79b6b.md) - 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](graph/solutions/agent-swarm-orchestrator-architecture-decisions-and-lessons-99f446.md) - 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](graph/solutions/gitea-actions-composite-action-auth-fix-default-actions-urls-499462.md) - Problem: act_runner fails to clone composite actions from cal/gitea-actions w... (gitea, ci-cd, actions)
- [Gitea Actions runner can't clone self-hosted composite actions - auth + cache fix](graph/solutions/gitea-actions-runner-cant-clone-self-hosted-composite-action-53328f.md) - Problem: Gitea Actions runner fails to clone composite actions from cal/gitea... (gitea, ci-cd, actions)
## Active Decisions
- [Extracted cognitive-memory app from skill dir to standalone project](graph/decisions/extracted-cognitive-memory-app-from-skill-dir-to-standalone-a41644.md) - 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/)](graph/decisions/cognitive-memory-data-dir-moved-to-xdg-compliant-path-locals-dc9c26.md) - Moved default data directory from hardcoded `~/.claude/memory/` to XDG Base D... ([\\\"cognitive-memory\\\", xdg, architecture)
- [Skill organization: scoped user skills over symlinks](graph/decisions/skill-organization-scoped-user-skills-over-symlinks-6cc417.md) - 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](graph/decisions/auto-edge-creation-on-memory-store-in-mcp-server-ee85bf.md) - 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](graph/decisions/multi-graph-support-named-segregated-memory-namespaces-for-c-b1ba1b.md) - 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](graph/decisions/removed-coremd-auto-loading-from-sessions-rely-on-mcp-recall-42c9a0.md) - Removed the MEMORY.md symlink mechanism that auto-loaded CORE.md (~3K tokens)... ([\\\\\\\"cognitive-memory\\\\\\\", core-md, optimization)
- [Cognitive memory multi-graph support and scheduled tasks system issues opened on Gitea](graph/decisions/cognitive-memory-multi-graph-support-and-scheduled-tasks-sys-dc6b6c.md) - Both filed on `cal/claude-memory` Gitea repo. (cognitive-memory, scheduled-tasks, systemd)
- [Migrated Gitea operations from tea CLI to gitea-mcp MCP server](graph/decisions/migrated-gitea-operations-from-tea-cli-to-gitea-mcp-mcp-serv-d32609.md) - Previously, all Gitea operations in Claude Code sessions used the `tea` CLI v... (gitea, mcp, claude-code)
- [Migrated from Docker MCP Gateway (LXC 303) back to local MCP servers](graph/decisions/migrated-from-docker-mcp-gateway-lxc-303-back-to-local-mcp-s-670b71.md) - LXC 303 (10.10.0.231) was running Docker MCP Gateway serving n8n and Gitea MC... (mcp, docker-mcp-gateway, claude-code)
- [Decision: mcp-tui-driver chosen over mcpterm for TUI testing](graph/decisions/decision-mcp-tui-driver-chosen-over-mcpterm-for-tui-testing-230a1d.md) - Needed an MCP server to enable Claude Code to automate and test TUI (terminal... (mcp, tui-testing, architecture-decision)
## Key Fixes
- [Fix: N8N MCP partial updates corrupt workflows via typeVersion bumps](graph/fixes/fix-n8n-mcp-partial-updates-corrupt-workflows-via-typeversio-c30705.md) - Using `n8n_update_partial_workflow` to bump `typeVersion` values on nodes (e.... (n8n, mcp, n8n-mcp)
- [Fix: Claude Code PostToolUse hook correct JSON format](graph/fixes/fix-claude-code-posttooluse-hook-correct-json-format-be0bda.md) - 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](graph/fixes/fix-sqlx-in-memory-sqlite-pool-requires-max-connections1-1b71b1.md) - 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](graph/fixes/fix-n8n-master-loop-discord-summary-node-missing-url-caused-401ef2.md) - 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)](graph/fixes/fix-partial-uuid-prefix-matching-in-cognitive-memory-client-89f32e.md) - Users had to type full UUIDs when referencing memories or edges via the client. (cognitive-memory, fix, uuid)
- [Claude Code MCP user-scope config is ~/.claude.json, not ~/.claude/.mcp.json](graph/fixes/claude-code-mcp-user-scope-config-is-claudejson-not-claudemc-f01c17.md) - Confusion about where Claude Code stores user-scoped MCP server configurations. (claude-code, mcp, configuration)
- [[major-domo] fix: key plays score text shows "tied at X" instead of "Team up X-X" (closes #48)](graph/fixes/major-domo-fix-key-plays-score-text-shows-tied-at-x-instead-01be68.md) - Commits made: 4 (major-domo, automation, commit)
- [[paper-dynasty] Session: automation, configuration, creation, debugging, deployment, fix, tooling](graph/fixes/paper-dynasty-session-automation-configuration-creation-debu-38c91b.md) - Files edited (5): (paper-dynasty, automation, configuration)
- [[homelab] docs: archive headless-claude design docs to legacy/](graph/fixes/homelab-docs-archive-headless-claude-design-docs-to-legacy-12f0de.md) - Commits made: 1 (homelab, automation, commit)
- [Fix: claude -p nested session failure due to CLAUDECODE env var](graph/fixes/fix-claude-p-nested-session-failure-due-to-claudecode-env-va-250d2f.md) - `claude -p` fails with "cannot be launched inside another Claude Code session... (claude-code, headless, nested-sessions)
## Configurations
- [CT 302 claude-runner provisioned for server diagnostics](graph/configurations/ct-302-claude-runner-provisioned-for-server-diagnostics-5da446.md) - VMID:** 302, **IP:** 10.10.0.148, **Hostname:** claude-runner (proxmox, homelab, monitoring)
- [n8n-mcp server setup for Claude Code via mcp-manager](graph/configurations/n8n-mcp-server-setup-for-claude-code-via-mcp-manager-1d8200.md) - Added `n8n-mcp` (czlonkowski/n8n-mcp v2.35.3) as an on-demand MCP server mana... (n8n, mcp, claude-code)
- [MCP servers go in ~/.claude.json, NOT ~/.claude/.mcp.json](graph/configurations/mcp-servers-go-in-claudejson-not-claudemcpjson-d746c5.md) - 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](graph/configurations/config-mcp-tui-driver-mcp-server-installed-globally-967ad4.md) - Installed from source via cargo: (mcp, tui-testing, claude-code)
- [CT 300 claude-runner: Two-Tier Health Check Architecture](graph/configurations/ct-300-claude-runner-two-tier-health-check-architecture-061011.md) - 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](graph/configurations/path-references-updated-across-6-files-after-cognitive-memor-81e330.md) - After moving app code from `~/.claude/skills/cognitive-memory/` to `/mnt/NV2/... (cognitive-memory, configuration, claude-code)
- [Gitea MCP server (official gitea/gitea-mcp v0.8.1) installed locally](graph/configurations/gitea-mcp-server-official-giteagitea-mcp-v081-installed-loca-e967ba.md) - Installed the official `gitea/gitea-mcp` binary as a user-scoped MCP server f... (gitea, mcp, claude-code)
- [Docker MCP Gateway deployed on LXC 303 (mcp-gateway, 10.10.0.231)](graph/configurations/docker-mcp-gateway-deployed-on-lxc-303-mcp-gateway-10100231-12689c.md) - VMID:** 303 (docker, mcp, mcp-gateway)
- [Backlog triage scheduled task config (daily Gitea issue triage)](graph/configurations/backlog-triage-scheduled-task-config-daily-gitea-issue-triag-b27fb8.md) - Daily automated triage of open Gitea issues across repos, cross-referenced wi... (claude-scheduled, backlog-triage, gitea)
- [Docker MCP Gateway LXC 303 setup with persistent config and secrets](graph/configurations/docker-mcp-gateway-lxc-303-setup-with-persistent-config-and-1a8753.md) - LXC:** 303, **IP:** 10.10.0.231, **SSH alias:** `mcp-gateway` (docker-mcp-gateway, mcp, homelab)
## Key Procedures
- [Self-managing n8n server health monitor with sub-workflows](graph/procedures/self-managing-n8n-server-health-monitor-with-sub-workflows-226839.md) - Master + sub-workflow pattern in n8n for server health monitoring via CT 302... (n8n, homelab, monitoring)
- [Add a new server to n8n health monitoring](graph/procedures/add-a-new-server-to-n8n-health-monitoring-f3a41c.md) - 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](graph/procedures/cognitive-memory-has-no-test-suite-use-inline-smoke-tests-21be13.md) - The cognitive-memory project at `/mnt/NV2/Development/cognitive-memory/` has... (cognitive-memory, testing, workflow)