chore: import upstream snapshot with attribution

python/tests/core/linear/test_readdir.py

@@ -0,0 +1,150 @@
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ========= Copyright 2026 @ Strukto.AI All Rights Reserved. =========
+
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.linear import LinearAccessor
+from mirage.cache.index import IndexEntry
+from mirage.cache.index.ram import RAMIndexCacheStore
+from mirage.core.linear.readdir import readdir
+from mirage.resource.linear.config import LinearConfig
+from mirage.types import PathSpec
+from mirage.utils.key_prefix import mount_key
+
+
+@pytest.fixture
+def accessor():
+    return LinearAccessor(LinearConfig(api_key="lin_api_test"))
+
+
+@pytest.fixture
+def index():
+    return RAMIndexCacheStore()
+
+
+@pytest.mark.asyncio
+async def test_readdir_root(accessor, index):
+    result = await readdir(
+        accessor, PathSpec(resource_path="", virtual="/", directory="/"),
+        index)
+    assert result == ["/teams"]
+
+
+@pytest.mark.asyncio
+async def test_readdir_teams(accessor, index):
+    teams = [{
+        "id": "TEAM1",
+        "key": "ENG",
+        "name": "Engineering",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "states": {
+            "nodes": []
+        },
+    }]
+    with patch("mirage.core.linear.readdir.list_teams",
+               new_callable=AsyncMock,
+               return_value=teams):
+        result = await readdir(
+            accessor,
+            PathSpec(resource_path="teams",
+                     virtual="/teams",
+                     directory="/teams"), index)
+    assert result == ["/teams/ENG__Engineering__TEAM1"]
+
+
+@pytest.mark.asyncio
+async def test_readdir_teams_keeps_prefix_on_warm_cache_hit(accessor, index):
+    teams = [{
+        "id": "TEAM1",
+        "key": "ENG",
+        "name": "Engineering",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "states": {
+            "nodes": []
+        },
+    }]
+    spec = PathSpec(resource_path=mount_key("/linear/teams", "/linear"),
+                    virtual="/linear/teams",
+                    directory="/linear/teams")
+    with patch("mirage.core.linear.readdir.list_teams",
+               new_callable=AsyncMock,
+               return_value=teams):
+        cold = await readdir(accessor, spec, index)
+        warm = await readdir(accessor, spec, index)
+    assert cold == ["/linear/teams/ENG__Engineering__TEAM1"]
+    assert warm == cold
+
+
+@pytest.mark.asyncio
+async def test_readdir_team_members(accessor, index):
+    await index.put(
+        "/teams/ENG__Engineering__TEAM1",
+        IndexEntry(
+            id="TEAM1",
+            name="Engineering",
+            resource_type="linear/team",
+            remote_time="2026-04-05T00:00:00Z",
+            vfs_name="ENG__Engineering__TEAM1",
+        ),
+    )
+    users = [{
+        "id": "USER1",
+        "name": "Alice",
+        "displayName": "Alice",
+        "email": "alice@example.com",
+        "updatedAt": "2026-04-05T00:00:00Z",
+    }]
+    with patch("mirage.core.linear.readdir.list_team_members",
+               new_callable=AsyncMock,
+               return_value=users):
+        result = await readdir(
+            accessor,
+            PathSpec(resource_path="teams/ENG__Engineering__TEAM1/members",
+                     virtual="/teams/ENG__Engineering__TEAM1/members",
+                     directory="/teams/ENG__Engineering__TEAM1/members"),
+            index,
+        )
+    assert result == [
+        "/teams/ENG__Engineering__TEAM1/members/Alice__USER1.json"
+    ]
+
+
+@pytest.mark.asyncio
+async def test_readdir_issue_folder(accessor, index):
+    await index.put(
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1",
+        IndexEntry(
+            id="ISSUE1",
+            name="ENG-123",
+            resource_type="linear/issue",
+            remote_time="2026-04-05T00:00:00Z",
+            vfs_name="ENG-123__ISSUE1",
+        ),
+    )
+    result = await readdir(
+        accessor,
+        PathSpec(
+            resource_path=(
+                "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1"
+            ).strip("/"),
+            virtual="/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1",
+            directory="/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1"),
+        index,
+    )
+    assert result == [
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1/issue.json",
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1/comments.jsonl",
+    ]