Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

feat(storage): initialize user entry directories (#2621)

Qin Haojiebc1326639d3e
diff --git a/openviking/core/directories.py b/openviking/core/directories.py
index 1b4e75d81..b610b218e 100644
--- a/openviking/core/directories.py
+++ b/openviking/core/directories.py
@@ -183,25 +183,39 @@ class DirectoryInitializer:
return count
async def initialize_user_directories(self, ctx: RequestContext) -> int:
- """Initialize only the user namespace root for the current user.
+ """Initialize the current user's root and first-level entry directories.
- Child directories under ``viking://user/{user_space}`` are created lazily on
- first write. This avoids materializing empty namespaces such as
- ``memories/patterns`` or ``skills`` before any actual content exists.
+ Concrete leaf namespaces under entries such as ``memories`` or ``sessions``
+ are still created lazily when content is written. This keeps a new user
+ root discoverable without materializing the full empty taxonomy.
"""
if "user" not in PRESET_DIRECTORIES:
return 0
user_space_root = canonical_user_root(ctx)
user_tree = PRESET_DIRECTORIES["user"]
parent_uri = "viking://user"
- created = await self._ensure_directory(
+ count = 0
+ if await self._ensure_directory(
uri=user_space_root,
parent_uri=parent_uri,
defn=user_tree,
scope="user",
ctx=ctx,
- )
- return 1 if created else 0
+ ):
+ count += 1
+
+ for child in user_tree.children:
+ child_uri = f"{user_space_root}/{child.path}"
+ if await self._ensure_directory(
+ uri=child_uri,
+ parent_uri=user_space_root,
+ defn=child,
+ scope="user",
+ ctx=ctx,
+ ):
+ count += 1
+
+ return count
async def initialize_agent_directories(self, ctx: RequestContext) -> int:
"""Deprecated compatibility hook; agent directories are no longer initialized."""
diff --git a/tests/unit/test_directory_initializer.py b/tests/unit/test_directory_initializer.py
new file mode 100644
index 000000000..0a3cb7949
--- /dev/null
+++ b/tests/unit/test_directory_initializer.py
@@ -0,0 +1,58 @@
+import pytest
+
+from openviking.core.directories import PRESET_DIRECTORIES, DirectoryInitializer
+from openviking.core.namespace import canonical_user_root
+from openviking.server.identity import RequestContext, Role
+from openviking_cli.session.user_id import UserIdentifier
+
+
+class _FakeVikingDB:
+ def __init__(self):
+ self.embedding_messages = []
+
+ async def get_context_by_uri(self, **_kwargs):
+ return []
+
+ async def enqueue_embedding_msg(self, message):
+ self.embedding_messages.append(message)
+
+
+class _FakeVikingFS:
+ def __init__(self):
+ self.contexts = {}
+
+ async def abstract(self, uri, ctx):
+ if uri not in self.contexts:
+ raise FileNotFoundError(uri)
+ return self.contexts[uri]["abstract"]
+
+ async def write_context(self, uri, abstract, overview, is_leaf, ctx):
+ self.contexts[uri] = {
+ "abstract": abstract,
+ "overview": overview,
+ "is_leaf": is_leaf,
+ }
+
+
+async def test_initialize_user_directories_creates_root_and_first_level_only():
+ vikingdb = _FakeVikingDB()
+ viking_fs = _FakeVikingFS()
+ initializer = DirectoryInitializer(vikingdb, viking_fs=viking_fs)
+ ctx = RequestContext(user=UserIdentifier("acme", "alice"), role=Role.ADMIN)
+
+ count = await initializer.initialize_user_directories(ctx)
+
+ user_root = canonical_user_root(ctx)
+ expected_uris = {
+ user_root,
+ *(f"{user_root}/{child.path}" for child in PRESET_DIRECTORIES["user"].children),
+ }
+ assert count == len(expected_uris)
+ assert set(viking_fs.contexts) == expected_uris
+ assert f"{user_root}/memories/preferences" not in viking_fs.contexts
+
+ second_count = await initializer.initialize_user_directories(ctx)
+
+ assert second_count == 0
+ assert set(viking_fs.contexts) == expected_uris