From cef933846a67def5ef2c90a27f87dbca6d1ba8e9 Mon Sep 17 00:00:00 2001
From: Update Docs Workflow <update-docs@github-actions>
Date: Mon, 16 Feb 2026 23:42:22 +0000
Subject: [PATCH] docs: Export migrate_filenames functions in lib package

- Add migrate_all, migrate_file, is_migration_complete, migration_summary to lib/__init__.py
- Update library-reference.md to show both direct and convenience import patterns
- Ensures documented API matches actual exports

Fixes documentation gap where migrate_filenames functions were documented
but not accessible via 'from lib import ...' syntax.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 docs/library-reference.md | 10 ++++++++++
 lib/__init__.py           | 11 +++++++++++
 2 files changed, 21 insertions(+)

diff --git a/docs/library-reference.md b/docs/library-reference.md
index aa83d76..befad5f 100644
--- a/docs/library-reference.md
+++ b/docs/library-reference.md
@@ -750,21 +750,31 @@ def test_memory_operations(test_resolver):
 ````python
 # Paths
 from lib.paths import PathResolver, Scope, get_memory_dir
+# OR use convenience import
+from lib import PathResolver, Scope, get_memory_dir
 
 # Config
 from lib.config import get_memory_root
 
 # Memory reading
 from lib.memory_reader import get_memory_metadata, get_memory_summary
+# OR
+from lib import get_memory_metadata, get_memory_summary
 
 # Migration
 from lib.migrate_filenames import migrate_all, is_migration_complete
+# OR
+from lib import migrate_all, migrate_file, is_migration_complete, migration_summary
 
 # Search
 from lib.search import search_memories, find_related_memories_scored
+# OR
+from lib import search_memories, find_related_memories_scored
 
 # Relationships
 from lib.relationships import add_bidirectional_relationship, get_inverse
+# OR
+from lib import add_bidirectional_relationship, get_inverse
 
 # Ontology
 from lib.ontology import load_ontology_data, validate_memory_against_ontology
diff --git a/lib/__init__.py b/lib/__init__.py
index 58e2bbf..16dc5f3 100644
--- a/lib/__init__.py
+++ b/lib/__init__.py
@@ -9,6 +9,12 @@
     get_memory_metadata,
     get_memory_summary,
 )
+from .migrate_filenames import (
+    is_migration_complete,
+    migrate_all,
+    migrate_file,
+    migration_summary,
+)
 from .ontology import (
     get_fallback_content_patterns,
     get_fallback_file_patterns,
@@ -120,6 +126,11 @@
     # Memory reader functions
     "get_memory_summary",
     "get_memory_metadata",
+    # Migration functions
+    "migrate_all",
+    "migrate_file",
+    "is_migration_complete",
+    "migration_summary",
     # Relationship type registry
     "RELATIONSHIP_TYPES",
     "RECIPROCAL_TYPES",