Class WorkingMemoryItem

core/memory_v2.py:46–70

A file held in working memory with LRU and relevance metadata.

@dataclass
class WorkingMemoryItem:
    """A file held in working memory with LRU and relevance metadata."""
    file_path: str
    content: str
    tokens: int
    loaded_at: int          # unix timestamp
    last_used_at: int       # unix timestamp (for wall-clock LRU)
    last_used_turn: int = 0  # agent turn counter (for turn-based LRU eviction)
    access_count: int = 1

    @property
    def name(self) -> str:
        """Filename without directory — used by /context display."""
        return Path(self.file_path).name

    def relevance_score(self, message: str) -> float:
        """Score 0-1 based on keyword overlap between message and file."""
        msg_words = set(re.findall(r'\w+', message.lower()))
        file_words = set(re.findall(r'\w+', self.content.lower()))
        name_words = set(re.findall(r'\w+', self.name.lower()))
        name_overlap = len(msg_words & name_words) * 3   # filename hit = high signal
        content_overlap = len(msg_words & file_words)
        if not msg_words:
            return 0.5
        return min(1.0, (name_overlap + content_overlap) / (len(msg_words) + 1))


class WorkingMemory: