traversing-gdlm-memory

Memory Quick Reference

Available Memory Files

!bash -c 'find docs/gdl/memory/active -name "*.gdlm" -maxdepth 1 2>/dev/null | while read f; do count=$(grep -c "^@memory" "$f" 2>/dev/null || echo 0); echo "- $(basename "$f"): $count records"; done'

Format

@memory|id:{id}|agent:{agent}|subject:{subject}|tags:{t1,t2}|detail:{text}|confidence:{level}|anchor:{concept}|ts:{timestamp}

Each memory is one line. Each field is self-describing (key:value). Latest timestamp wins for corrections.

Required Fields

Field	Description
id	M-{agent}-{seq} unique identifier
agent	Agent that authored the memory
subject	Primary topic (flat)
detail	The knowledge content
ts	ISO timestamp

Optional Fields

Field	Description
tags	Comma-separated retrieval tags
confidence	high, medium, low
relates	Links to other memory IDs (typed: supersedes~M-001)
type	observation, decision, preference, error, fact, task, procedural
anchor	Concept anchor reference
status	corrected, deleted, compacted

Three Tiers

Tier	Path	Purpose
Active	memory/active/*.gdlm	Current working memory (read/write)
Archive	memory/archive/*.gdlm	Compacted summaries (read-only)
History	memory/history/{period}/*.gdlm	Full originals (forensic only)

Concept Anchors

Two-grep similarity search via memory/anchors.gdlm:

# Step 1: Find anchor by keyword
grep "authentication\|oauth" memory/anchors.gdlm
# → @anchor|concept:auth-security|scope:authentication,authorization,oauth,...

# Step 2: Find memories by anchor
grep "anchor:auth-security" memory/active/*.gdlm

Grep Patterns

# By subject
grep "subject:GL_ACCOUNT" memory/active/*.gdlm

# By agent
grep "agent:sf-042" memory/active/*.gdlm

# By tag
grep "tags:.*snowflake" memory/active/*.gdlm

# By anchor concept
grep "anchor:data-quality" memory/active/*.gdlm

# By type
grep "type:decision" memory/active/*.gdlm

# Latest version of a memory
grep "id:M-sf-042-001" memory/active/systems.gdlm | tail -1

# High-confidence only
grep "confidence:high" memory/active/*.gdlm

# Related memories
grep "relates:.*M-sf-042-018" memory/active/*.gdlm

# Search archive when active doesn't answer
grep "subject:GL_ACCOUNT" memory/archive/*.gdlm