chore: import upstream snapshot with attribution

python/tests/commands/builtin/linear/test_commands.py

@@ -0,0 +1,205 @@
+# ========= 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 import MountMode, Workspace
+from mirage.resource.linear import LinearConfig, LinearResource
+
+MOCK_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",
+        }]
+    },
+}]
+
+MOCK_ISSUES = [{
+    "id": "ISSUE1",
+    "identifier": "ENG-1",
+    "title": "Fix login",
+    "url": "https://linear.app/issue/ENG-1",
+    "project": None,
+    "state": {
+        "id": "STATE1",
+        "name": "Todo",
+    },
+}]
+
+MOCK_ISSUE_DETAIL = {
+    "id": "ISSUE1",
+    "identifier": "ENG-1",
+    "title": "Fix login",
+    "description": "Login page broken",
+    "priority": 2,
+    "url": "https://linear.app/issue/ENG-1",
+    "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": {},
+    "cycle": {},
+    "assignee": {},
+    "creator": {
+        "id": "USER1",
+        "name": "Alice",
+        "email": "alice@example.com",
+    },
+    "labels": {
+        "nodes": []
+    },
+}
+
+MOCK_COMMENTS = [{
+    "id": "C1",
+    "body": "looks good",
+    "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",
+    },
+}]
+
+
+def _make_workspace():
+    config = LinearConfig(api_key="lin_api_test")
+    resource = LinearResource(config=config)
+    return Workspace({"/linear": resource}, mode=MountMode.READ)
+
+
+def _patches():
+    return (
+        patch("mirage.core.linear.readdir.list_teams",
+              new_callable=AsyncMock,
+              return_value=MOCK_TEAMS),
+        patch("mirage.core.linear.readdir.list_team_issues",
+              new_callable=AsyncMock,
+              return_value=MOCK_ISSUES),
+        patch("mirage.core.linear.readdir.list_team_projects",
+              new_callable=AsyncMock,
+              return_value=[]),
+        patch("mirage.core.linear.readdir.list_team_members",
+              new_callable=AsyncMock,
+              return_value=[]),
+        patch("mirage.core.linear.read.list_teams",
+              new_callable=AsyncMock,
+              return_value=MOCK_TEAMS),
+        patch("mirage.core.linear.read.get_issue",
+              new_callable=AsyncMock,
+              return_value=MOCK_ISSUE_DETAIL),
+        patch("mirage.core.linear.read.list_issue_comments",
+              new_callable=AsyncMock,
+              return_value=MOCK_COMMENTS),
+        patch("mirage.core.linear.read.list_team_issues",
+              new_callable=AsyncMock,
+              return_value=MOCK_ISSUES),
+        patch("mirage.core.linear.read.list_team_projects",
+              new_callable=AsyncMock,
+              return_value=[]),
+    )
+
+
+@pytest.fixture
+def ws():
+    return _make_workspace()
+
+
+def _all_patches():
+    patches = _patches()
+    from contextlib import ExitStack
+    stack = ExitStack()
+    for p in patches:
+        stack.enter_context(p)
+    return stack
+
+
+@pytest.mark.asyncio
+async def test_ls_teams(ws):
+    with _all_patches():
+        r = await ws.execute("ls /linear/teams/")
+    assert "ENG__Engineering__TEAM1" in (await r.stdout_str())
+    assert r.exit_code == 0
+
+
+@pytest.mark.asyncio
+async def test_ls_issues(ws):
+    with _all_patches():
+        await ws.execute("ls /linear/teams/")
+        r = await ws.execute("ls /linear/teams/ENG__Engineering__TEAM1/issues/"
+                             )
+    assert "ENG-1__ISSUE1" in (await r.stdout_str())
+    assert r.exit_code == 0
+
+
+@pytest.mark.asyncio
+async def test_cat_issue(ws):
+    with _all_patches():
+        await ws.execute("ls /linear/teams/")
+        r = await ws.execute("cat /linear/teams/ENG__Engineering__TEAM1"
+                             "/issues/ENG-1__ISSUE1/issue.json")
+    payload = json.loads(await r.stdout_str())
+    assert payload["issue_key"] == "ENG-1"
+    assert payload["title"] == "Fix login"
+    assert r.exit_code == 0
+
+
+@pytest.mark.asyncio
+async def test_grep_issue(ws):
+    with _all_patches():
+        await ws.execute("ls /linear/teams/")
+        r = await ws.execute("grep login /linear/teams/ENG__Engineering__TEAM1"
+                             "/issues/ENG-1__ISSUE1/issue.json")
+    assert "login" in (await r.stdout_str()).lower()
+    assert r.exit_code == 0
+
+
+@pytest.mark.asyncio
+async def test_head_issue(ws):
+    with _all_patches():
+        await ws.execute("ls /linear/teams/")
+        r = await ws.execute("head -n 3 /linear/teams/ENG__Engineering__TEAM1"
+                             "/issues/ENG-1__ISSUE1/issue.json")
+    assert r.exit_code == 0
+    assert len((await r.stdout_str()).strip().splitlines()) <= 3
+
+
+@pytest.mark.asyncio
+async def test_stat_issue(ws):
+    with _all_patches():
+        await ws.execute("ls /linear/teams/")
+        r = await ws.execute("stat /linear/teams/ENG__Engineering__TEAM1"
+                             "/issues/ENG-1__ISSUE1/issue.json")
+    assert r.exit_code == 0

python/tests/commands/builtin/linear/test_find.py

@@ -0,0 +1,87 @@
+# ========= 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.ram import RAMIndexCacheStore
+from mirage.commands.builtin.linear import COMMANDS
+from mirage.resource.linear.config import LinearConfig
+from mirage.types import PathSpec
+
+TEAMS = [{
+    "id": "TEAM1",
+    "key": "ENG",
+    "name": "Engineering",
+    "updatedAt": "2026-04-05T00:00:00Z",
+    "states": {
+        "nodes": []
+    },
+}]
+
+TEAM_DIR = "/teams/ENG__Engineering__TEAM1"
+
+
+def _find_command():
+    for fn in COMMANDS:
+        for rc in getattr(fn, "_registered_commands", []):
+            if rc.name == "find" and rc.filetype is None:
+                return fn
+    raise AssertionError("factory find not registered for linear")
+
+
+def _spec(virtual: str) -> PathSpec:
+    return PathSpec(virtual=virtual,
+                    directory=virtual,
+                    resource_path=virtual.strip("/"))
+
+
+async def _run(paths, *texts: str, **flags) -> list[str]:
+    accessor = LinearAccessor(LinearConfig(api_key="lin_api_test"))
+    find = _find_command()
+    with patch("mirage.core.linear.readdir.list_teams",
+               new_callable=AsyncMock,
+               return_value=TEAMS):
+        stdout, _io = await find(accessor,
+                                 paths,
+                                 *texts,
+                                 index=RAMIndexCacheStore(),
+                                 **flags)
+    data = stdout if isinstance(stdout, bytes) else b""
+    return data.decode().splitlines()
+
+
+@pytest.mark.asyncio
+async def test_walk_classifies_dirs_via_stat_without_hint():
+    # Linear wires no is_dir_name hint, so the walk stats entries to
+    # classify them (stat delegates to the parent readdir listing).
+    lines = await _run([_spec("/")], maxdepth="2")
+    assert "/teams" in lines
+    assert TEAM_DIR in lines
+
+
+@pytest.mark.asyncio
+async def test_maxdepth_three_reaches_static_team_entries():
+    lines = await _run([_spec("/")], maxdepth="3", name="team.json")
+    assert lines == [f"{TEAM_DIR}/team.json"]
+
+
+@pytest.mark.asyncio
+async def test_type_d_lists_team_subdirs():
+    lines = await _run([_spec("/")], maxdepth="3", type="d")
+    assert f"{TEAM_DIR}/members" in lines
+    assert f"{TEAM_DIR}/issues" in lines
+    assert f"{TEAM_DIR}/team.json" not in lines

python/tests/commands/builtin/linear/test_write_commands.py

@@ -0,0 +1,163 @@
+# ========= 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.commands.builtin.linear.linear_issue_comment_add import \
+    linear_issue_comment_add
+from mirage.commands.builtin.linear.linear_issue_create import \
+    linear_issue_create
+from mirage.commands.builtin.linear.linear_issue_update import \
+    linear_issue_update
+from mirage.resource.linear.config import LinearConfig
+
+
+@pytest.fixture
+def accessor():
+    return LinearAccessor(LinearConfig(api_key="lin_api_test"))
+
+
+@pytest.mark.asyncio
+async def test_issue_create_uses_stdin(accessor):
+    issue = {
+        "id": "ISSUE1",
+        "identifier": "ENG-123",
+        "title": "Bug",
+        "description": "Body",
+        "team": {
+            "id": "TEAM1",
+            "key": "ENG",
+            "name": "Engineering",
+        },
+        "state": {},
+        "project": {},
+        "cycle": {},
+        "assignee": {},
+        "creator": {},
+        "labels": {
+            "nodes": []
+        },
+        "createdAt": "",
+        "updatedAt": "",
+        "priority": None,
+        "url": "",
+    }
+    with patch(
+            "mirage.commands.builtin.linear.linear_issue_create.issue_create",
+            new_callable=AsyncMock,
+            return_value=issue,
+    ) as mock_create:
+        stream, _ = await linear_issue_create(
+            accessor,
+            [],
+            stdin=b"Body",
+            team_id="TEAM1",
+            title="Bug",
+        )
+    mock_create.assert_called_once()
+    assert mock_create.call_args.kwargs["description"] == "Body"
+    out = json.loads(b"".join([chunk async for chunk in stream]))
+    assert out["issue_id"] == "ISSUE1"
+
+
+@pytest.mark.asyncio
+async def test_issue_update_prefers_inline_text(accessor):
+    issue = {
+        "id": "ISSUE1",
+        "identifier": "ENG-123",
+        "title": "Bug",
+        "description": "Inline",
+        "team": {
+            "id": "TEAM1",
+            "key": "ENG",
+            "name": "Engineering",
+        },
+        "state": {},
+        "project": {},
+        "cycle": {},
+        "assignee": {},
+        "creator": {},
+        "labels": {
+            "nodes": []
+        },
+        "createdAt": "",
+        "updatedAt": "",
+        "priority": None,
+        "url": "",
+    }
+    mod = "mirage.commands.builtin.linear"
+    with patch(
+            f"{mod}.linear_issue_update.resolve_issue_id",
+            new_callable=AsyncMock,
+            return_value="ISSUE1",
+    ), patch(
+            f"{mod}.linear_issue_update.issue_update",
+            new_callable=AsyncMock,
+            return_value=issue,
+    ) as mock_update, patch(
+            f"{mod}._input.read_bytes",
+            new_callable=AsyncMock,
+            return_value=b"From file",
+    ):
+        await linear_issue_update(
+            accessor,
+            [],
+            stdin=b"From stdin",
+            issue_key="ENG-123",
+            description="Inline",
+        )
+    assert mock_update.call_args.kwargs["description"] == "Inline"
+
+
+@pytest.mark.asyncio
+async def test_comment_add_uses_body_file_before_stdin(accessor):
+    comment = {
+        "id": "COMMENT1",
+        "body": "From file",
+        "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",
+        },
+    }
+    mod = "mirage.commands.builtin.linear"
+    with patch(
+            f"{mod}.linear_issue_comment_add.resolve_issue_id",
+            new_callable=AsyncMock,
+            return_value="ISSUE1",
+    ), patch(
+            f"{mod}._input.read_bytes",
+            new_callable=AsyncMock,
+            return_value=b"From file",
+    ), patch(
+            f"{mod}.linear_issue_comment_add.comment_create",
+            new_callable=AsyncMock,
+            return_value=comment,
+    ) as mock_comment_create:
+        await linear_issue_comment_add(
+            accessor,
+            [],
+            stdin=b"From stdin",
+            issue_key="ENG-123",
+            body_file="/tmp/body.md",
+        )
+    assert mock_comment_create.call_args.kwargs["body"] == "From file"