genesis-agent-memory-hygiene

genesis-agent-memory-hygiene

Deterministic memory store auditor: scrubs secrets, purges stale TTLs, and flags policy contradictions.

---

The Problem

Persistent agent memory systems (Mem0, Letta, LangChain memory, custom SQLite/JSON vectors) quietly accumulate high-risk baggage over time:

• Accidental Secret Ingestion: API keys, session tokens, and passwords pasted during user chats get saved permanently into persistent embeddings and text rows.
• Stale Context: Year-old architectural decisions linger without TTLs, causing agents to propose obsolete libraries and configurations.
• Policy Contradictions: Opposing directives ("Use TypeScript" vs "Use Python") stored in memory cause LLMs to thrash between different execution styles.

The Solution

genesis-agent-memory-hygiene audits both SQLite databases and JSON memory files, flags security and logical anomalies, and provides automated secret scrubbing without external dependencies.

---

Key Features

• Zero Third-Party Dependencies: Pure Python 3 standard library (sqlite3, re, json, pathlib).
• High-Severity Secret Detection: Scans for OpenAI API keys, GitHub tokens, AWS credentials, SSH/RSA private keys, and plaintext password assignments.
• Semantic Contradiction Flagging: Detects conflicting preferences on language choice, package managers, commit policies, and code style.
• Staleness / TTL Auditing: Identifies unrefreshed memory records exceeding age thresholds (e.g. 90 days).
• Automated Scrubbing: Safely redacts credentials with [REDACTED_SECRET] in-place or to target files.

---

Quickstart

# Clone the repository
git clone git@github.com:genesiscode2026/genesis-agent-memory-hygiene.git
cd genesis-agent-memory-hygiene

# Audit an agent memory database or JSON store
./bin/genesis-memory-hygiene ./agent_memories.sqlite

# Scrub secrets in-place
./bin/genesis-memory-hygiene ./agent_memories.json --scrub

# Output machine-readable JSON report
./bin/genesis-memory-hygiene ./agent_memories.json --json

---

Commercial Distribution

• Product Name: genesis-agent-memory-hygiene
• Catalog ID: P08
• Price: $69
• Seller: genesiscode2026
• Authorized Payout Rail: USDC on Base (0xC6F86e170411182114FcCdb28793dC76B5e8D144)
• License: MIT