Skip to content

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

4.2 KB
Raw Blame
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0

import pytest

from openviking.server.identity import RequestContext, Role
from openviking.storage import vector_migration
from openviking.storage.abstract_overview import parse_abstract_overview
from openviking_cli.session.user_id import UserIdentifier


def _ctx(account_id: str = "acct", user_id: str = "alice") -> RequestContext:
    return RequestContext(user=UserIdentifier(account_id, user_id), role=Role.USER)


def test_transfer_scope_includes_chunks_but_not_sibling_prefixes():
    source = "viking://resources/src.md"

    assert vector_migration.uri_in_transfer_scope(source, source, recursive=False)
    assert vector_migration.uri_in_transfer_scope(f"{source}#chunk_0001", source, recursive=False)
    assert not vector_migration.uri_in_transfer_scope(
        "viking://resources/src.md.backup", source, recursive=True
    )
    assert not vector_migration.uri_in_transfer_scope(
        "viking://resources/src.md/child", source, recursive=False
    )
    assert vector_migration.uri_in_transfer_scope(
        "viking://resources/src.md/child", source, recursive=True
    )


def test_rewrite_vector_record_for_copy_preserves_payload_and_resets_metadata():
    record = {
        "id": "old-id",
        "uri": "viking://user/alice/memories/src.md#chunk_1",
        "level": 2,
        "vector": [0.1, 0.2],
        "sparse_vector": {"7": 0.8},
        "content": "chunk",
        "tags": ["team=a"],
        "created_at": 10,
        "updated_at": 11,
        "active_count": 9,
        "account_id": "acct",
        "owner_user_id": "alice",
    }

    result = vector_migration.rewrite_vector_record(
        record,
        source_uri="viking://user/alice/memories/src.md",
        target_uri="viking://user/alice/memories/dst.md",
        ctx=_ctx(),
        mode="copy",
        timestamp=123,
    )

    assert result["uri"] == "viking://user/alice/memories/dst.md#chunk_1"
    assert result["id"] != "old-id"
    assert result["vector"] == [0.1, 0.2]
    assert result["sparse_vector"] == {"7": 0.8}
    assert result["content"] == "chunk"
    assert result["tags"] == ["team=a"]
    assert result["created_at"] == 123
    assert result["updated_at"] == 123
    assert result["active_count"] == 0
    assert result["owner_user_id"] == "alice"


@pytest.mark.parametrize("level", [0, 1, 2])
def test_rewrite_vector_record_for_move_preserves_metadata(level):
    record = {
        "id": "old-id",
        "uri": "viking://resources/src",
        "level": level,
        "vector": [0.1],
        "created_at": 10,
        "updated_at": 11,
        "active_count": 9,
    }

    result = vector_migration.rewrite_vector_record(
        record,
        source_uri="viking://resources/src",
        target_uri="viking://resources/dst",
        ctx=_ctx(),
        mode="move",
        timestamp=123,
    )

    assert result["uri"] == "viking://resources/dst"
    assert result["id"] != "old-id"
    assert result["created_at"] == 10
    assert result["updated_at"] == 11
    assert result["active_count"] == 9


@pytest.mark.parametrize("mode", ["copy", "move"])
def test_rewrite_vector_record_updates_generated_l1_uri_references(mode):
    record = {
        "id": "old-id",
        "uri": "viking://resources/业务域",
        "level": 1,
        "vector": [0.1],
        "abstract": "[chapter](viking://resources/业务域/章节.md)",
        "content": """---
directory: viking://resources/业务域/
---

[chapter](viking://resources/%E4%B8%9A%E5%8A%A1%E5%9F%9F/%E7%AB%A0%E8%8A%82.md)
""",
        "created_at": 10,
        "updated_at": 11,
        "active_count": 9,
    }

    result = vector_migration.rewrite_vector_record(
        record,
        source_uri="viking://resources/业务域",
        target_uri="viking://resources/归档域",
        ctx=_ctx(),
        mode=mode,
        timestamp=123,
    )

    assert result["abstract"] == "[chapter](viking://resources/归档域/章节.md)"
    content_doc = parse_abstract_overview(result["content"])
    assert content_doc.metadata["directory"] == "viking://resources/归档域/"
    assert content_doc.body.strip() == "[chapter](viking://resources/归档域/章节.md)"