# ========= 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"