chore: import upstream snapshot with attribution

python/tests/core/linear/test_pathing.py

@@ -0,0 +1,91 @@
+# ========= 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. =========
+
+import pytest
+
+from mirage.core.linear.pathing import (cycle_filename, issue_dirname,
+                                        member_filename, project_filename,
+                                        split_suffix_id, team_dirname)
+
+
+def test_split_suffix_id_basic():
+    label, obj_id = split_suffix_id("ENG__Engineering__TEAM1")
+    assert label == "ENG__Engineering"
+    assert obj_id == "TEAM1"
+
+
+def test_split_suffix_id_with_suffix():
+    label, obj_id = split_suffix_id("Alice__USER1.json", suffix=".json")
+    assert label == "Alice"
+    assert obj_id == "USER1"
+
+
+def test_split_suffix_id_missing_suffix():
+    with pytest.raises(FileNotFoundError):
+        split_suffix_id("Alice__USER1.json", suffix=".txt")
+
+
+def test_split_suffix_id_no_separator():
+    with pytest.raises(FileNotFoundError):
+        split_suffix_id("noseparator")
+
+
+def test_team_dirname():
+    team = {"id": "TEAM1", "key": "ENG", "name": "Engineering"}
+    assert team_dirname(team) == "ENG__Engineering__TEAM1"
+
+
+def test_team_dirname_same_key_and_name():
+    team = {"id": "TEAM1", "key": "ENG", "name": "ENG"}
+    assert team_dirname(team) == "ENG__TEAM1"
+
+
+def test_team_dirname_no_key():
+    team = {"id": "TEAM1", "name": "Engineering"}
+    assert team_dirname(team) == "Engineering__TEAM1"
+
+
+def test_member_filename():
+    user = {"id": "USER1", "name": "Alice", "displayName": "Alice"}
+    assert member_filename(user) == "Alice__USER1.json"
+
+
+def test_member_filename_display_name_preferred():
+    user = {"id": "USER1", "name": "alice_w", "displayName": "Alice W"}
+    assert member_filename(user) == "Alice_W__USER1.json"
+
+
+def test_issue_dirname():
+    issue = {"id": "ISSUE1", "identifier": "ENG-123"}
+    assert issue_dirname(issue) == "ENG-123__ISSUE1"
+
+
+def test_issue_dirname_no_identifier():
+    issue = {"id": "ISSUE1"}
+    assert issue_dirname(issue) == "ISSUE1__ISSUE1"
+
+
+def test_project_filename():
+    project = {"id": "PROJ1", "name": "Agent Data Plane"}
+    assert project_filename(project) == "Agent_Data_Plane__PROJ1.json"
+
+
+def test_cycle_filename():
+    cycle = {"id": "CYCLE1", "name": "Sprint 1"}
+    assert cycle_filename(cycle) == "Sprint_1__CYCLE1.json"
+
+
+def test_cycle_filename_no_name():
+    cycle = {"id": "CYCLE1"}
+    assert cycle_filename(cycle) == "cycle__CYCLE1.json"

python/tests/core/linear/test_read.py

@@ -0,0 +1,235 @@
+# ========= 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. =========
+
+import json
+from unittest.mock import AsyncMock, patch
+
+import pytest
+
+from mirage.accessor.linear import LinearAccessor
+from mirage.cache.index.ram import RAMIndexCacheStore
+from mirage.core.linear.read import read
+from mirage.resource.linear.config import LinearConfig
+
+
+@pytest.fixture
+def accessor():
+    return LinearAccessor(LinearConfig(api_key="lin_api_test"))
+
+
+@pytest.fixture
+def index():
+    return RAMIndexCacheStore()
+
+
+@pytest.mark.asyncio
+async def test_read_team_json(accessor, index):
+    teams = [{
+        "id": "TEAM1",
+        "key": "ENG",
+        "name": "Engineering",
+        "description": "Core team",
+        "timezone": "UTC",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "states": {
+            "nodes": [{
+                "id": "STATE1",
+                "name": "Todo",
+                "type": "unstarted",
+            }]
+        },
+    }]
+    with patch("mirage.core.linear.read.list_teams",
+               new_callable=AsyncMock,
+               return_value=teams):
+        result = await read(
+            accessor,
+            "/teams/ENG__Engineering__TEAM1/team.json",
+            index,
+        )
+    payload = json.loads(result)
+    assert payload["team_id"] == "TEAM1"
+    assert payload["team_name"] == "Engineering"
+    assert payload["states"][0]["state_id"] == "STATE1"
+
+
+@pytest.mark.asyncio
+async def test_read_issue_json(accessor, index):
+    issue = {
+        "id": "ISSUE1",
+        "identifier": "ENG-123",
+        "title": "Fix login",
+        "description": "Body",
+        "priority": 2,
+        "url": "https://linear.app/issue",
+        "createdAt": "2026-04-05T00:00:00Z",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "team": {
+            "id": "TEAM1",
+            "key": "ENG",
+            "name": "Engineering",
+        },
+        "state": {
+            "id": "STATE1",
+            "name": "Todo",
+        },
+        "project": {
+            "id": "PROJ1",
+            "name": "Project",
+        },
+        "cycle": {
+            "id": "CYCLE1",
+            "name": "Cycle",
+            "number": 1,
+        },
+        "assignee": {
+            "id": "USER1",
+            "name": "Alice",
+            "email": "alice@example.com",
+        },
+        "creator": {
+            "id": "USER2",
+            "name": "Bob",
+            "email": "bob@example.com",
+        },
+        "labels": {
+            "nodes": [{
+                "id": "L1",
+                "name": "bug",
+            }]
+        },
+    }
+    with patch("mirage.core.linear.read.get_issue",
+               new_callable=AsyncMock,
+               return_value=issue):
+        result = await read(
+            accessor,
+            "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1/issue.json",
+            index,
+        )
+    payload = json.loads(result)
+    assert payload["issue_id"] == "ISSUE1"
+    assert payload["assignee_id"] == "USER1"
+
+
+@pytest.mark.asyncio
+async def test_read_comments_jsonl(accessor, index):
+    issue = {
+        "id": "ISSUE1",
+        "identifier": "ENG-123",
+        "title": "Fix login",
+        "description": "Body",
+        "priority": 2,
+        "url": "https://linear.app/issue",
+        "createdAt": "2026-04-05T00:00:00Z",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "team": {
+            "id": "TEAM1",
+            "key": "ENG",
+            "name": "Engineering",
+        },
+        "state": {},
+        "project": {},
+        "cycle": {},
+        "assignee": {},
+        "creator": {},
+        "labels": {
+            "nodes": []
+        },
+    }
+    comments = [{
+        "id": "COMMENT1",
+        "body": "first",
+        "createdAt": "2026-04-05T00:00:00Z",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "url": "https://linear.app/comment",
+        "user": {
+            "id": "USER1",
+            "name": "Alice",
+            "displayName": "Alice",
+            "email": "alice@example.com",
+        },
+    }]
+    with patch("mirage.core.linear.read.get_issue",
+               new_callable=AsyncMock,
+               return_value=issue), patch(
+                   "mirage.core.linear.read.list_issue_comments",
+                   new_callable=AsyncMock,
+                   return_value=comments):
+        result = await read(
+            accessor,
+            "/teams/ENG__Engineering__TEAM1"
+            "/issues/ENG-123__ISSUE1/comments.jsonl",
+            index,
+        )
+    line = json.loads(result.decode().strip())
+    assert line["comment_id"] == "COMMENT1"
+    assert line["issue_id"] == "ISSUE1"
+
+
+@pytest.mark.asyncio
+async def test_read_project_json_includes_issue_refs(accessor, index):
+    teams = [{
+        "id": "TEAM1",
+        "key": "ENG",
+        "name": "Engineering",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "states": {
+            "nodes": []
+        },
+    }]
+    projects = [{
+        "id": "PROJ1",
+        "name": "Agent Data Plane",
+        "description": "Project body",
+        "state": "planned",
+        "updatedAt": "2026-04-05T00:00:00Z",
+        "url": "https://linear.app/project",
+        "lead": {
+            "id": "USER1",
+        },
+    }]
+    issues = [{
+        "id": "ISSUE1",
+        "identifier": "ENG-123",
+        "title": "Wire resource",
+        "url": "https://linear.app/issue",
+        "project": {
+            "id": "PROJ1",
+        },
+        "state": {
+            "id": "STATE1",
+            "name": "Todo",
+        },
+    }]
+    with patch("mirage.core.linear.read.list_teams",
+               new_callable=AsyncMock,
+               return_value=teams), patch(
+                   "mirage.core.linear.read.list_team_projects",
+                   new_callable=AsyncMock,
+                   return_value=projects), patch(
+                       "mirage.core.linear.read.list_team_issues",
+                       new_callable=AsyncMock,
+                       return_value=issues):
+        result = await read(
+            accessor,
+            "/teams/ENG__Engineering__TEAM1"
+            "/projects/Agent-Data-Plane__PROJ1.json",
+            index,
+        )
+    payload = json.loads(result)
+    assert payload["team_key"] == "ENG"
+    assert payload["team_name"] == "Engineering"
+    assert payload["issue_count"] == 1
+    assert payload["issues"][0]["issue_key"] == "ENG-123"

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",
+    ]

python/tests/core/linear/test_stat.py

@@ -0,0 +1,110 @@
+# ========= 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. =========
+
+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.stat import stat
+from mirage.resource.linear.config import LinearConfig
+from mirage.types import FileType
+
+
+@pytest.fixture
+def accessor():
+    return LinearAccessor(LinearConfig(api_key="lin_api_test"))
+
+
+@pytest.fixture
+def index():
+    return RAMIndexCacheStore()
+
+
+@pytest.mark.asyncio
+async def test_stat_root(accessor, index):
+    result = await stat(accessor, "/", index)
+    assert result.type == FileType.DIRECTORY
+
+
+@pytest.mark.asyncio
+async def test_stat_teams(accessor, index):
+    result = await stat(accessor, "/teams", index)
+    assert result.type == FileType.DIRECTORY
+
+
+@pytest.mark.asyncio
+async def test_stat_team_entry(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",
+        ),
+    )
+    result = await stat(accessor, "/teams/ENG__Engineering__TEAM1", index)
+    assert result.type == FileType.DIRECTORY
+    assert result.extra["team_id"] == "TEAM1"
+    assert result.modified == "2026-04-05T00:00:00Z"
+
+
+@pytest.mark.asyncio
+async def test_stat_issue_directory(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 stat(
+        accessor,
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1",
+        index,
+    )
+    assert result.type == FileType.DIRECTORY
+    assert result.extra["issue_id"] == "ISSUE1"
+    assert result.modified == "2026-04-05T00:00:00Z"
+
+
+@pytest.mark.asyncio
+async def test_stat_issue_json(accessor, index):
+    result = await stat(
+        accessor,
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1/issue.json",
+        index,
+    )
+    assert result.type == FileType.JSON
+
+
+@pytest.mark.asyncio
+async def test_stat_comments_jsonl(accessor, index):
+    result = await stat(
+        accessor,
+        "/teams/ENG__Engineering__TEAM1/issues/ENG-123__ISSUE1/comments.jsonl",
+        index,
+    )
+    assert result.type == FileType.TEXT
+
+
+@pytest.mark.asyncio
+async def test_stat_missing_path(accessor, index):
+    with pytest.raises(FileNotFoundError):
+        await stat(accessor, "/nonexistent/path", index)