chore: import upstream snapshot with attribution

python/mirage/commands/builtin/github_ci/__init__.py

@@ -0,0 +1,52 @@
+# ========= 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 functools import partial
+
+from mirage.commands.builtin.generic_bind import (CommandIO,
+                                                  make_generic_commands)
+from mirage.commands.builtin.github_ci.find import find
+from mirage.commands.builtin.github_ci.grep import grep
+from mirage.commands.builtin.github_ci.rg import rg
+from mirage.commands.builtin.utils.wrap import stream_from_bytes
+from mirage.core.github_ci.read import read as _read
+from mirage.core.github_ci.readdir import readdir as _readdir
+from mirage.core.github_ci.stat import stat as _stat
+
+# GitHub CI logs/artifacts are read through the generic factory; find, grep
+# and rg keep wrappers because they reject recursive search across runs (which
+# would fetch every run's logs). GitHub CI is read-only, so the generic
+# byte-mutation commands are intentionally absent (no write op wired). There is
+# no native streaming read, so the stream is synthesized from the object read.
+_GITHUB_CI_CMD_OPS = CommandIO(
+    readdir=_readdir,
+    read_bytes=_read,
+    read_stream=partial(stream_from_bytes, _read),
+    stat=_stat,
+    is_mounted=lambda a: True,
+    local=False,
+)
+
+_GITHUB_CI_OVERRIDES = {"find", "grep", "rg"}
+
+COMMANDS = [
+    *make_generic_commands(
+        "github_ci",
+        _GITHUB_CI_CMD_OPS,
+        overrides=_GITHUB_CI_OVERRIDES,
+    ),
+    find,
+    grep,
+    rg,
+]

python/mirage/commands/builtin/github_ci/_provision.py

@@ -0,0 +1,21 @@
+# ========= 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.builtin.generic_bind.provision import (
+    exact_zero_provision, index_hit_read_provision)
+
+file_read_provision = index_hit_read_provision
+metadata_provision = exact_zero_provision
+
+__all__ = ["file_read_provision", "metadata_provision"]

python/mirage/commands/builtin/github_ci/find.py

@@ -0,0 +1,92 @@
+# ========= 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 functools import partial
+
+from mirage.accessor.github_ci import GitHubCIAccessor
+from mirage.cache.index import IndexCacheStore
+from mirage.commands.builtin.generic.find import parse_find_args, walk_find
+from mirage.commands.builtin.github_ci._provision import metadata_provision
+from mirage.commands.builtin.utils.output import format_records
+from mirage.commands.registry import command
+from mirage.commands.spec import SPECS
+from mirage.core.github_ci.glob import is_cross_run_root, resolve_glob
+from mirage.core.github_ci.readdir import is_dir_name
+from mirage.core.github_ci.readdir import readdir as _readdir
+from mirage.core.github_ci.stat import stat as _stat
+from mirage.io.types import ByteSource, IOResult
+from mirage.provision.types import ProvisionResult
+from mirage.types import PathSpec
+
+
+async def find_provision(
+    accessor: GitHubCIAccessor,
+    paths: list[PathSpec],
+    *texts: str,
+    **_extra: object,
+) -> ProvisionResult:
+    return await metadata_provision("find " + " ".join(
+        p.virtual if isinstance(p, PathSpec) else p for p in paths))
+
+
+@command("find",
+         resource="github_ci",
+         spec=SPECS["find"],
+         provision=find_provision)
+async def find(
+    accessor: GitHubCIAccessor,
+    paths: list[PathSpec],
+    *texts: str,
+    stdin: bytes | None = None,
+    name: str | None = None,
+    type: str | None = None,
+    maxdepth: str | None = None,
+    size: str | None = None,
+    mtime: str | None = None,
+    iname: str | None = None,
+    path: str | None = None,
+    mindepth: str | None = None,
+    empty: bool = False,
+    prefix: str = "",
+    index: IndexCacheStore = None,
+    **_extra: object,
+) -> tuple[ByteSource | None, IOResult]:
+    # The wrapper only exists for the cross-run guard: walking every run
+    # would fetch every run's logs. Filtering is the shared generic walk.
+    paths = await resolve_glob(accessor, paths, index=index)
+    searches = paths if paths else [
+        PathSpec(virtual="/", directory="/", resource_path="")
+    ]
+    args = parse_find_args(texts,
+                           name=name,
+                           type=type,
+                           size=size,
+                           mtime=mtime,
+                           maxdepth=maxdepth,
+                           iname=iname,
+                           path=path,
+                           mindepth=mindepth,
+                           empty=empty)
+    results: list[str] = []
+    for search in searches:
+        if is_cross_run_root(search):
+            raise ValueError("find: recursive search across runs is disabled;"
+                             " target a specific run (e.g. /ci/runs/<run>)")
+        results.extend(await walk_find(search,
+                                       readdir=partial(_readdir, accessor),
+                                       stat=partial(_stat, accessor),
+                                       is_dir_name=is_dir_name,
+                                       index=index,
+                                       args=args))
+    return format_records(results), IOResult()

python/mirage/commands/builtin/github_ci/grep.py

@@ -0,0 +1,57 @@
+# ========= 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 collections.abc import AsyncIterator
+
+from mirage.accessor.github_ci import GitHubCIAccessor
+from mirage.cache.index import IndexCacheStore
+from mirage.commands.builtin.generic.grep import grep as generic_grep
+from mirage.commands.registry import command
+from mirage.commands.spec import SPECS
+from mirage.commands.spec.types import FlagView
+from mirage.core.github_ci.glob import is_cross_run_root, resolve_glob
+from mirage.core.github_ci.read import read as ci_read
+from mirage.core.github_ci.readdir import readdir as _readdir
+from mirage.core.github_ci.stat import stat as _stat
+from mirage.io.types import ByteSource, IOResult
+from mirage.types import PathSpec
+
+
+@command("grep", resource="github_ci", spec=SPECS["grep"])
+async def grep(
+    accessor: GitHubCIAccessor,
+    paths: list[PathSpec],
+    *texts: str,
+    stdin: AsyncIterator[bytes] | bytes | None = None,
+    index: IndexCacheStore = None,
+    **flags: object,
+) -> tuple[ByteSource | None, IOResult]:
+    fl = FlagView(flags, spec=SPECS["grep"])
+    resolved = await resolve_glob(accessor, paths, index) if paths else []
+    recursive = fl.bool("r") or fl.bool("R")
+    if recursive and any(is_cross_run_root(p) for p in resolved):
+        raise ValueError("grep: recursive search across runs is disabled; "
+                         "target a specific run (e.g. /ci/runs/<run>/jobs)")
+    return await generic_grep(
+        resolved,
+        texts,
+        flags,
+        readdir=_readdir,
+        stat=_stat,
+        read_bytes=ci_read,
+        read_stream=None,
+        accessor=accessor,
+        stdin=stdin,
+        index=index,
+    )

python/mirage/commands/builtin/github_ci/rg.py

@@ -0,0 +1,54 @@
+# ========= 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 collections.abc import AsyncIterator
+
+from mirage.accessor.github_ci import GitHubCIAccessor
+from mirage.cache.index import IndexCacheStore
+from mirage.commands.builtin.generic.rg import rg as generic_rg
+from mirage.commands.registry import command
+from mirage.commands.spec import SPECS
+from mirage.core.github_ci.glob import is_cross_run_root, resolve_glob
+from mirage.core.github_ci.read import read as ci_read
+from mirage.core.github_ci.readdir import readdir as _readdir
+from mirage.core.github_ci.stat import stat as _stat
+from mirage.io.types import ByteSource, IOResult
+from mirage.types import PathSpec
+
+
+@command("rg", resource="github_ci", spec=SPECS["rg"])
+async def rg(
+    accessor: GitHubCIAccessor,
+    paths: list[PathSpec],
+    *texts: str,
+    stdin: AsyncIterator[bytes] | bytes | None = None,
+    index: IndexCacheStore = None,
+    **flags: object,
+) -> tuple[ByteSource | None, IOResult]:
+    resolved = await resolve_glob(accessor, paths, index) if paths else []
+    if any(is_cross_run_root(p) for p in resolved):
+        raise ValueError("rg: recursive search across runs is disabled; "
+                         "target a specific run (e.g. /ci/runs/<run>/jobs)")
+    return await generic_rg(
+        resolved,
+        texts,
+        flags,
+        readdir=_readdir,
+        stat=_stat,
+        read_bytes=ci_read,
+        read_stream=None,
+        accessor=accessor,
+        stdin=stdin,
+        index=index,
+    )