nora memory

nora memory spaces list
nora memory spaces get sp_customer_history

nora memory spaces create \
  --slug customer_history \
  --name "Customer History" \
  --paradigm index \
  --index-form graph \
  --kg-reference \
  --access-scope-key user_id

nora memory spaces update sp_customer_history \
  --name "Customer History (renamed)" \
  --access-scope-key tenant_id

nora memory spaces delete sp_customer_history

nora memory notes list sp_wiki
# Scope-filtered:
nora memory notes list sp_wiki --scope '{"user_id":"alice"}'

nora memory notes upsert sp_wiki \
  --path playbooks/refunds.md \
  --title "Refund playbook" \
  --body @refunds.md \
  --scope '{"team":"support"}'

nora memory notes grep sp_wiki \
  --query "refund" \
  --scope '{"team":"support"}' \
  --limit 20

nora memory notes exclude note_abc

# List
nora memory nodes list sp_kg --scope '{"tenant":"acme"}' --limit 100

# Insert
nora memory nodes insert sp_kg \
  --summary "Alice Smith" \
  --kind person \
  --content "VP Engineering at Acme" \
  --attrs '{"email":"alice@acme.com"}' \
  --scope '{"tenant":"acme"}'

# Update summary
nora memory nodes update node_abc --summary "Alice Smith (VP)"

# Move on canvas
nora memory nodes set-position node_abc --x 100 --y 200

# Exclude
nora memory nodes exclude node_abc

# List
nora memory edges list sp_kg

# Insert
nora memory edges insert sp_kg \
  --src-node-id node_alice \
  --dst-node-id node_acme \
  --predicate "works_at" \
  --weight 1.0 \
  --scope '{"tenant":"acme"}'

# Rename
nora memory edges update edge_abc --predicate "manages"

# Exclude
nora memory edges exclude edge_abc

# List patterns, most-reused first
nora memory diagnostic list --limit 20

# Recall — bumps the reuse counter (production usage)
nora memory diagnostic recall \
  --category retrieval-miss \
  --flow support-agent \
  --failure-mode wrong-refund-policy

# Peek — no side effect (investigation)
nora memory diagnostic peek \
  --category retrieval-miss \
  --flow support-agent \
  --failure-mode wrong-refund-policy

# Exclude a bad pattern
nora memory diagnostic exclude pattern_abc --actor paul

# Restore
nora memory diagnostic restore pattern_abc

# All active scopes
nora memory sessions scopes sp_chat

# Turns in one scope
nora memory sessions turns sp_chat --scope '{"conversation_id":"c_abc"}' --limit 50

# Rolling summary
nora memory sessions summary sp_chat --scope '{"conversation_id":"c_abc"}'

# Buffered turn count
nora memory sessions count sp_chat --scope '{"conversation_id":"c_abc"}'

nora memory log sp_customer_history       # update log + stats
nora memory scopes sp_customer_history    # scope values used in this space
nora memory connected-flows sp_customer_history   # flows with Agents attached

for f in playbooks/*.md; do
  path="playbooks/$(basename $f)"
  nora memory notes upsert sp_wiki \
    --path "$path" \
    --title "$(head -n1 $f | sed 's/^# //')" \
    --body @"$f"
done

# Read all items, add new scope field, re-insert
# (specifics depend on your data model)

for id in $(nora memory spaces list --json | jq -r '.[].id'); do
  n=$(nora memory connected-flows $id --json | jq 'length')
  [ "$n" = "0" ] && echo "$id — 0 flows"
done

nora memory notes list sp_wiki --json > wiki-snapshot.json