memory-promote

Memory Promote

BETA — This memory system is in active testing. If you encounter bugs, confusing behavior, or have suggestions, run: codies-memory feedback "describe what happened" — your feedback is saved and reviewed.

When To Use

• At session close (automatic evaluation)
• When an operator explicitly requests promotion
• When promotion thresholds are met during work

Promotion Paths

Within Project

inbox -> thread (recurring topic)
inbox -> lesson (actionable pattern)
thread -> decision (confirmed across 2+ sessions)
thread -> lesson (reusable pattern)
decision -> lesson (reusable pattern)

Project to Global

project lesson -> global lesson (proven across 2+ projects)

How To Run

# List active inbox items for promotion review
codies-memory list inbox --status active

# Evaluate all inbox items for promotion (no CLI equivalent yet)
uv run python -c "
from pathlib import Path
from codies_memory.records import list_records
from codies_memory.promotion import evaluate_for_promotion

vault = Path('.memory')
inbox_items = list_records(vault, 'inbox', scope='project')
for item in inbox_items:
    result = evaluate_for_promotion(item, context={'session_count': 3})
    if result['eligible']:
        print(f'  Promote: {item[\"frontmatter\"][\"title\"][:60]}')
        print(f'  Suggested: {result[\"suggested_types\"]}')
"

# Promote an inbox item to a thread
codies-memory promote /path/to/record.md --to thread

# Promote a project lesson to global
codies-memory promote /path/to/lesson.md --to-global

Probation

All promoted records enter a 7-day probation window. During probation:

• Contradictory evidence can demote the record back
• Stronger newer records can supersede it
• The record participates in boot and retrieval normally