{
  "name": "cognitive-memory",
  "version": "3.2.0",
  "description": "Markdown-based memory system with decay scoring, episodic logging, semantic search, reflection cycles, auto-curated CORE.md, native MCP server integration, rich edge files, hybrid Ollama/OpenAI embeddings, multi-graph support, and auto-edge creation",
  "created": "2026-02-13",
  "migrated_from": "memorygraph",
  "status": "active",
  "files": {
    "client.py": "Core API + CLI entrypoint",
    "cli.py": "CLI interface (argparse)",
    "common.py": "Shared constants and helpers",
    "analysis.py": "Reflection/analysis mixin",
    "edges.py": "Edge management mixin",
    "embeddings.py": "Embedding support mixin",
    "mcp_server.py": "MCP server for Claude Code tool integration",
    "scripts/session_memory.py": "SessionEnd hook — auto-stores session learnings",
    "scripts/edge-proposer.py": "Edge proposer for relationship discovery",
    "scripts/memory-git-sync.sh": "Git sync for default + named graph repos",
    "scripts/maintain-all-graphs.sh": "Loop maintenance commands over all graphs",
    "systemd/": "Reference copies of systemd user timers (see systemd/README.md)"
  },
  "skill_layer": "~/.claude/skills/cognitive-memory/ (SKILL.md + SCHEMA.md)",
  "data_location": "$XDG_DATA_HOME/cognitive-memory/ (default: ~/.local/share/cognitive-memory/)",
  "dependencies": "stdlib-only (no external packages; Ollama optional for semantic search)",
  "features": [
    "store: Create markdown memory files with YAML frontmatter (--episode flag)",
    "recall: Search memories ranked by relevance and decay score (--semantic flag)",
    "get: Retrieve memory by ID with access tracking",
    "relate: Create bidirectional relationships between memories",
    "search: Filter by type, tags, importance with optional text query",
    "update: Modify memory frontmatter and content",
    "delete: Remove memory with relation cleanup",
    "related: BFS traversal of memory relationships",
    "stats: Memory system statistics and decay summary",
    "recent: Recently created memories",
    "decay: Recalculate all decay scores",
    "core: Generate CORE.md auto-curated summary",
    "episode: Append to daily session log",
    "reindex: Rebuild index from markdown files",
    "pin: Move memory to vault (never decays)",
    "reflect: Cluster recent memories by tag overlap using union-find",
    "reflection: Generate REFLECTION.md summary with themes and patterns",
    "procedure: Store procedural memories with steps/preconditions/postconditions",
    "embed: Generate Ollama embeddings for semantic search",
    "tags list: Show all tags with usage counts",
    "tags related: Find co-occurring tags",
    "tags suggest: Recommend tags based on co-occurrence patterns",
    "edge-get: Get full edge details by ID",
    "edge-search: Search edges by query, type, from/to IDs",
    "edge-update: Update edge description or strength",
    "edge-delete: Remove edge and clean memory references",
    "config: Manage embedding provider (ollama/openai) with fallback",
    "MCP server: Native Claude Code tool integration via JSON-RPC stdio",
    "Hybrid embeddings: Ollama (local) + OpenAI (optional) with automatic fallback",
    "Rich edges: First-class edge files in graph/edges/ with descriptions",
    "graphs: List available memory graphs",
    "graph-create: Create a new named memory graph",
    "Auto-edges: Automatically create edges on memory_store via type-pair heuristics",
    "Multi-graph: Named isolated graphs with per-project routing via COGNITIVE_MEMORY_GRAPH env var"
  ]
}