dsh-mindforge

Usage

Model Tools (auto-registered on ctx.tools)

The model can call these tools directly:

Tool	Description
memory_add	Store a memory (4-layer, encrypted)
memory_search	6-way fusion search (vector + FTS5 + TF-IDF + fuzzy + expansion + rerank)
memory_context	Token-budget-aware context retrieval for prompt injection
memory_stats	Memory store statistics
memory_recall	Smart recall (search + association + layer-aware)
memory_reflection	Metacognitive analysis of memory themes and drift
memory_reinforce	Identify high-value decaying memories
memory_lineage	Trace version history and audit events
graph_query	Query the knowledge graph
rerank_search	Query expansion + cross-encoder reranking

DSH Commands

/mindforge status              # Memory store statistics
/mindforge recall       # Smart recall top 5
/mindforge remember      # Store as permanent memory
/mindforge forget          # Delete a memory
/mindforge graph               # Knowledge graph overview
/mindforge search       # Full 6-way fusion search

Auto Context Injection

When injectOnStep: true (default), dsh-mindforge listens to agent/pre-step events and automatically injects relevant memories before each model turn:

1. Extract keywords from the user's message
2. Call MindForge memory-context for token-budget-aware retrieval
3. Inject as a system message via agent.inject()

No configuration needed — works out of the box.