Module scoring 

Scoring, validation, and re-ranking utilities for the memory search pipeline.

This module provides:

• Path validation (validate_path, validate_content_size) — security checks preventing directory traversal, non-.md writes, and oversized content.
• Temporal decay (decay_factor, apply_decay) — penalizes older daily logs in search results using exponential half-life decay while leaving evergreen files (SOUL.md, HEARTBEAT.md, etc.) unaffected.
• MMR re-ranking (mmr_rerank) — Maximal Marginal Relevance diversifies search results by balancing query relevance against redundancy with already-selected results.

Constants

MAX_WRITE_SIZE

Maximum file size for memory writes (1 MB).

Functions

apply_decay

Apply temporal decay to an FTS5 rank score.

decay_factor

Compute a temporal decay factor for a memory source.

mmr_rerank

Maximal Marginal Relevance (MMR) re-ranking for result diversity.

validate_content_size

Validate content size for writes.

validate_path

Validate a memory file path, rejecting traversal attacks and unsafe names.