chore: import upstream snapshot with attribution

python/tests/workspace/expand/classify/test_heuristic.py

@@ -0,0 +1,80 @@
+# ========= 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 mirage.resource.ram import RAMResource
+from mirage.types import MountMode, PathSpec
+from mirage.workspace.expand.classify.heuristic import (_unescape_path,
+                                                        classify_word)
+from mirage.workspace.mount import MountRegistry
+
+
+def test_unescape_backslash_apostrophe():
+    assert _unescape_path(r"Zecheng\'s\ Server") == "Zecheng's Server"
+
+
+def test_unescape_no_backslash():
+    assert _unescape_path("normal") == "normal"
+
+
+def test_unescape_only_space():
+    assert _unescape_path(r"hello\ world") == "hello world"
+
+
+def test_classify_backslash_escaped_absolute():
+    registry = MountRegistry()
+    resource = RAMResource()
+    resource._store.dirs.add("/")
+    registry.mount("/ram/", resource, MountMode.WRITE)
+    result = classify_word(r"/ram/Zecheng\'s\ Server/", registry, "/")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/Zecheng's Server"
+
+
+def test_classify_quoted_path():
+    registry = MountRegistry()
+    resource = RAMResource()
+    resource._store.dirs.add("/")
+    registry.mount("/ram/", resource, MountMode.WRITE)
+    result = classify_word("/ram/Zecheng's Server/", registry, "/")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/Zecheng's Server"
+
+
+def test_bare_filename_stays_text():
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    assert classify_word("file.txt", registry, "/ram") == "file.txt"
+
+
+def test_relative_subdir_path_resolves():
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    result = classify_word("sub/file.txt", registry, "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/sub/file.txt"
+
+
+def test_relative_glob_resolves_against_cwd():
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    result = classify_word("*.txt", registry, "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.pattern == "*.txt"
+    assert result.directory == "/ram/"
+
+
+def test_bare_glob_operator_stays_text():
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    assert classify_word("*", registry, "/ram") == "*"

python/tests/workspace/expand/classify/test_parts.py

@@ -0,0 +1,71 @@
+# ========= 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 mirage.commands.spec.types import OperandKind
+from mirage.resource.ram import RAMResource
+from mirage.types import MountMode, PathSpec
+from mirage.workspace.expand.classify.parts import classify_parts
+from mirage.workspace.mount import MountRegistry
+
+
+def _registry() -> MountRegistry:
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    return registry
+
+
+def test_name_never_classified():
+    result = classify_parts(["/ram/cat", "/ram/x"], _registry(), "/")
+    assert result[0] == "/ram/cat"
+    assert isinstance(result[1], PathSpec)
+
+
+def test_text_kind_keeps_string():
+    result = classify_parts(["cat", "/ram/x"],
+                            _registry(),
+                            "/",
+                            word_kinds=[OperandKind.TEXT])
+    assert result[1] == "/ram/x"
+
+
+def test_path_kind_classifies_bare_filename():
+    result = classify_parts(["cat", "file.txt"],
+                            _registry(),
+                            "/ram",
+                            word_kinds=[OperandKind.PATH])
+    assert isinstance(result[1], PathSpec)
+    assert result[1].virtual == "/ram/file.txt"
+
+
+def test_duplicate_word_kinds_per_slot():
+    result = classify_parts(["grep", "*.txt", "*.txt"],
+                            _registry(),
+                            "/ram",
+                            word_kinds=[OperandKind.TEXT, OperandKind.PATH])
+    assert result[1] == "*.txt"
+    assert isinstance(result[2], PathSpec)
+    assert result[2].pattern == "*.txt"
+
+
+def test_none_kind_falls_back_to_heuristic():
+    result = classify_parts(["cat", "/ram/x", "plain"],
+                            _registry(),
+                            "/",
+                            word_kinds=[None, None])
+    assert isinstance(result[1], PathSpec)
+    assert result[2] == "plain"
+
+
+def test_empty_parts():
+    assert classify_parts([], _registry(), "/") == []

python/tests/workspace/expand/classify/test_path.py

@@ -0,0 +1,45 @@
+# ========= 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 mirage.resource.ram import RAMResource
+from mirage.types import MountMode, PathSpec
+from mirage.workspace.expand.classify.path import classify_bare_path
+from mirage.workspace.mount import MountRegistry
+
+
+def _registry() -> MountRegistry:
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    return registry
+
+
+def test_bare_filename_resolves_against_cwd():
+    result = classify_bare_path("file.txt", _registry(), "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/file.txt"
+    assert result.resolved
+    assert result.raw_path == "file.txt"
+
+
+def test_bare_glob_becomes_pattern():
+    result = classify_bare_path("f?.txt", _registry(), "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.pattern == "f?.txt"
+    assert result.directory == "/ram/"
+
+
+def test_absolute_path_delegates_to_heuristic():
+    result = classify_bare_path("/ram/file.txt", _registry(), "/")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/file.txt"

python/tests/workspace/expand/classify/test_relative.py

@@ -0,0 +1,62 @@
+# ========= 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 mirage.resource.ram import RAMResource
+from mirage.types import MountMode, PathSpec
+from mirage.workspace.expand.classify.relative import relative_spec
+from mirage.workspace.mount import MountRegistry
+
+
+def _registry() -> MountRegistry:
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    return registry
+
+
+def test_plain_word_resolves_and_keeps_raw():
+    result = relative_spec("sub/a.txt", _registry(), "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/sub/a.txt"
+    assert result.raw_path == "sub/a.txt"
+    assert result.resolved
+    assert result.pattern is None
+
+
+def test_glob_word_becomes_pattern():
+    result = relative_spec("sub/*.txt", _registry(), "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.directory == "/ram/sub/"
+    assert result.pattern == "*.txt"
+    assert not result.resolved
+    assert result.raw_path == "sub/*.txt"
+
+
+def test_dotdot_normalizes():
+    result = relative_spec("../x.txt", _registry(), "/ram/sub")
+    assert isinstance(result, PathSpec)
+    assert result.virtual == "/ram/x.txt"
+    assert result.raw_path == "../x.txt"
+
+
+def test_unmounted_stays_text():
+    registry = MountRegistry()
+    registry.mount("/ram/", RAMResource(), MountMode.WRITE)
+    assert relative_spec("a.txt", registry, "/elsewhere") == "a.txt"
+
+
+def test_raw_path_round_trip():
+    result = relative_spec("./sub/a.txt", _registry(), "/ram")
+    assert isinstance(result, PathSpec)
+    assert result.raw_path == "./sub/a.txt"
+    assert result.virtual == "/ram/sub/a.txt"