claude-memory/graph/solutions/migration-script-default-to-named-graph-memory-transfer-5fb6b3.md
2026-03-01 16:17:24 -06:00

71 lines
2.7 KiB
Markdown

---
id: 5fb6b3c0-cc6a-4baa-8552-8d2731379b0b
type: solution
title: "Migration Script: Default-to-Named-Graph Memory Transfer"
tags: [cognitive-memory, migration, multi-graph, python, script, solution]
importance: 0.85
confidence: 0.8
created: "2026-03-01T22:16:44.476551+00:00"
updated: "2026-03-01T22:17:24.844367+00:00"
relations:
- target: b1ba1b27-d2bf-44f9-a1f5-0ace2017dc18
type: BUILDS_ON
direction: incoming
strength: 0.7
edge_id: 2adf60cc-84e8-4351-9ea0-1036983c39a1
- target: d0d1a325-a308-474a-baf7-6939a76a136b
type: RELATED_TO
direction: outgoing
strength: 0.79
edge_id: ac0d00ea-f279-49b5-b186-b8c3cc4deffe
- target: 9eb16f9f-c825-4233-b64f-d0acd140374a
type: RELATED_TO
direction: outgoing
strength: 0.78
edge_id: 8d2b6329-8e85-4620-be9b-88805105c047
- target: 2d6f02bc-5a7c-404d-a566-36107aaaf6e6
type: RELATED_TO
direction: outgoing
strength: 0.95
edge_id: 98c0639e-a231-4e7c-bda6-42be7d45a091
- target: e301095c-7d4c-45d8-8352-9491e4ad6603
type: RELATED_TO
direction: incoming
strength: 0.9
edge_id: 1e0002c1-dc30-446e-bce3-f0a5e5b61663
- target: b1ba1b27-d2bf-44f9-a1f5-0ace2017dc18
type: FOLLOWS
direction: outgoing
strength: 0.9
edge_id: 19267562-3fd0-4213-987a-75bed0d644aa
- target: dc6b6c6f-1319-47cf-a691-dd40751ff121
type: FOLLOWS
direction: outgoing
strength: 0.85
edge_id: 73c489ff-c7ae-4a73-9c8f-76b69b6ac4b2
---
# Memory Migration Script: Default to Named Project Graphs
## Location
`/mnt/NV2/Development/cognitive-memory/scripts/migrate-memories.py`
## Problem
Memories accumulated in the default cognitive-memory graph without project-level separation. Needed a way to migrate them into named project graphs based on tag matching.
## Solution
Standalone Python script (`migrate-memories.py`) that migrates memories from the default cognitive-memory graph to named project graphs.
### Key Features
- **Tag-based classification**: routes memories to target graphs by matching tags
- **Flags**: `--dry-run`, `--no-git`, `--cleanup-overlaps`
- **File operations**: moves/copies `.md` files, updates `_index.json`, `_embeddings.json`, `_state.json` in both source and target
- **Edge handling**: classifies edges as migrate vs orphan, strips cross-graph edge references from frontmatter
- **Overlap detection**: memories tagged for multiple projects are COPIED (not moved) to each target graph; tracked in `_migration_overlaps.json`
- **Idempotent**: safe to re-run
- **Atomic JSON writes**: via `tempfile + os.replace()`
- **Git auto-commit**: commits changes after successful migration
## Git Commit
Committed as `11a046f`, closes Gitea issues #4, #5, #6.