Skip to content

Memory store and recall #96

@owainlewis

Description

@owainlewis

Summary

Add a memory capability with a NoMemory default, session summaries, and recall support for durable project knowledge.

Motivation

Sessions persist transcripts, but Neo does not yet distill reusable knowledge across sessions. Memory should preserve decisions, preferences, and project facts without bloating every prompt.

Scope

  • Introduce internal/memory with a small store interface and NoMemory default.
  • Add a file-backed implementation for session summaries and indexed recall.
  • Add a bounded memory preamble for high-value recent context.
  • Add a recall tool only after the storage shape is stable.
  • Keep memory distinct from session transcript persistence.

Acceptance criteria

  • Memory can be disabled with no behavior change.
  • Session summaries are written in a human-readable local format.
  • Recall returns bounded, relevant entries.
  • Tests cover no-op memory, file-backed save/recall, and prompt preamble bounds.

Agent Assessment

Risk: high
Type: feature
Agent-ready: no

Reason:
Memory affects persistence, prompt context, privacy/security, and retrieval quality. Bad memory is worse than no memory, so this needs deliberate human-led design.

Suggested plan:

  1. Define the memory store interface and human-readable storage format.
  2. Decide what is summarized, recalled, and injected into prompts.
  3. Verify no-op behavior, bounded recall, and prompt preamble limits.

Human needed:
Decide the first memory scope: session summaries only, project facts, or recall tool support.

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs:humanA human decision, clarification, or judgement call is requiredrisk:highHigh-risk issue requiring human-led work or explicit directiontype:featureNew user-facing or developer-facing capability

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions