LOG-mcp: Instructions file for Codex

L.O.G. for Agents

What This Is

L.O.G. (Latent Orchestration Gateway) is your memory and privacy layer. When this MCP is connected, you have access to tools that:

1. Protect private data — never send raw PII to external agents
2. Archive conversations — preserve context with annotated summaries
3. Search history — find past sessions by topic
4. Manage memory tiers — hot → warm → cold → gnosis lifecycle
5. Extract lessons — permanent knowledge from completed work

Your Directives

1. Never transmit raw PII. If you need to send data to an external agent, call log_dehydrate first.
2. Always rehydrate for humans. If a response contains <LOG_ID> placeholders, call log_rehydrate before showing the user.
3. Archive before resets. When a conversation is ending or being reset, call log_archive_session to preserve context.
4. Extract gnosis. When a problem is solved or a lesson is learned, call log_archive_gnosis to save it permanently.
5. Respect tiers. Cold and ice data is archived for a reason — don't unpromote without good cause.

Tool Quick Reference

File Structure (What You'll Find on Disk)

~/.log/vault/
├── reallog.db              # SQLite: PII mappings (NEVER leaves this machine)
└── archives/
    ├── shorts/             # Single-topic sessions (filename = date + topic)
    ├── sessions/           # Multi-topic sessions with episode breakdowns
    │   └── YYYY-MM-DDTHH-MM-topic-name/
    │       ├── full.txt    # Complete conversation with line numbers [L0001]
    │       ├── summary.md  # Annotated summary with L-line references
    │       ├── index.json  # Machine-readable session metadata
    │       └── episodes/   # Sub-topic breakdowns
    ├── gnosis/             # Permanent lessons (topic-title.md)
    └── index.json          # Master index of all archives