Skip to content
maenifold
GitHub

Sleep Status (Memory Health Report)

2 steps

Observation-only memory health report. Analyzes access patterns, calculates decay weights, and flags stale content for review. Does not modify anything — pure status snapshot. Part of the cognitive sleep cycle.

Triggers

sleep statusmemory status reportmemory healthdecay report

Steps

  1. 1.

    🔄 Memory Replay (Access Pattern Focus)

    Understand access patterns and identify stale content.

    1. Run recent_activity to retrieve events from the last 24-48 hours
    2. Note which files were accessed recently (active/fresh)
    3. Identify files that have been dormant (not accessed)
    4. Categorize content by tier:
      • thinking/sequential/: Ephemeral session data
      • thinking/workflows/: Workflow session data
      • Other memory://: Long-term knowledge
    5. Create access pattern summary

    IMPORTANT: This step is observation-only. Do NOT use read_memory - it would reset decay clocks.

    Tools:recent_activity*
    Effort:low
    Guardrails
    • no_read_memory: NEVER use read_memory in this workflow - it resets decay clocks
    • observation_only: Use list_memories for metadata, not read_memory for content
  2. 2.

    🍂 Status Report (Memory Health)

    Calculate decay weights and compile memory health report.

    1. Run list_memories to enumerate all memory files with decay metadata
    2. Apply tier-specific decay rules:
      • thinking/sequential/: 7-day grace period, 30-day half-life
      • thinking/workflows/: 14-day grace period, 30-day half-life
      • Other memory://: 14-day grace period, 30-day half-life
    3. Calculate decay_weight for each file based on last_accessed timestamp
    4. Flag severely decayed content (decay_weight < 0.25) for review

    CRITICAL: Do NOT use read_memory - this would reset decay clocks and defeat the purpose!

    Decay formula: weight = 2^(-days_since_access / half_life) after grace period

    Output: Return status report as workflow output - DO NOT write to memory:// Include: Tier breakdown, decay statistics, flagged items for review

    Tools:list_memories*
    Effort:low
    Guardrails
    • no_read_memory: NEVER use read_memory in this workflow - it resets decay clocks
    • no_write_memory: NEVER use write_memory - status reports are ephemeral, return as output
    • observation_only: This is a read-only status snapshot, nothing is modified
    • no_deletion: Decay affects ranking only, never delete content automatically
    • flag_threshold: Flag items with decay_weight < 0.25 for human review