MCP, MCP server
io.github.astrogilda/waitbus
The workstation-local, cross-harness status bus, a blocking wait/emit primitive that lets any agent or script wait on, or emit, CI / pytest / Docker / filesystem events (finish or fail) without polling, framework-agnostically.
Compatibility: Not stated.
Grade D
Two or more Medium findings, or a High finding. Only try it in a sandbox.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
INSTALL_REMOTE_SCRIPT SECRETS_PATH_CREDENTIAL
Why this grade
- INSTALL_REMOTE_SCRIPT Medium
Fetches a script from the network and runs it (a pipe to a shell, or an install hook with a URL).
scripts/_hetzner_provision_lib.sh, line 194
curl -LsSf https://astral.sh/uv/install.sh | sh - SECRETS_PATH_CREDENTIAL Medium
Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).
.github/CONTRIBUTING.md, line 259
git config user.signingkey ~/.ssh/id_ed25519.pub
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
If you think this grade is wrong, email [email protected] with the entry link and your evidence. We aim to acknowledge within two working days and decide within seven. If we confirm an error, we aim to correct it within 24 hours of confirming it. These are aims, not guarantees.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Note
requests shell access. The manifest names this permission.
PERMISSION_SHELL_DECLARED
benchmarks/_bench_preflight.py, line 238
result = subprocess.run(
benchmarks/_bench_preflight.py, line 353
result = subprocess.run(
benchmarks/_bench_shared.py, line 431
proc: subprocess.Popen[bytes]
Show more
benchmarks/_bench_shared.py, line 884
result = subprocess.run(
benchmarks/_bench_shared.py, line 1059
result = subprocess.run(
benchmarks/_bench_shared.py, line 1075
result = subprocess.run(
benchmarks/_bench_swarm.py, line 174
proc: subprocess.Popen[bytes] = subprocess.Popen(
benchmarks/_harness.py, line 471
out = subprocess.run(
Install and update
Serious
install fetches a script from the network. README documents an installer that pipes a download into a shell.
INSTALL_REMOTE_SCRIPT INSTALL_DOCUMENTED_INSTALLER
README.md, line 410
`uv` must be on PATH (`curl -LsSf https://astral.sh/uv/install.sh | sh`).
scripts/_hetzner_provision_lib.sh, line 194
curl -LsSf https://astral.sh/uv/install.sh | sh
scripts/_hetzner_provision_lib.sh, line 218
elif curl -fsSL https://get.docker.com | sh >/dev/null 2>&1; then
Network
Concern
can reach a host that is not written as a fixed address. can reach pypi.org. The description does not name that host.
NETWORK_NO_FIXED_HOST NETWORK_UNNAMED_HOST
scripts/derive_gh_distributions.py, line 340
return Path(fetcher.fetch(name))
scripts/honker-upstream-probe.sh, line 7
curl -s "https://pypi.org/simple/honker/" -H "Accept: application/vnd.pypi.simple.v1+json" \
scripts/honker-upstream-probe.sh, line 12
curl -sL "$tarball" | tar tz | grep -qE '\.(so|node)$' && echo "TRIGGER2_MET"
Show more
waitbus/_mcp_models.py, line 443
"description": "Opaque ULID of the stored event to fetch (a prior event_id / cursor value).",
examples/custom_source_plugin/README.md, line 17
- How to implement the `SourcePlugin` Protocol (`spec()` + `fetch()`).
examples/custom_source_plugin/README.md, line 162
def fetch(self, *args: object, **kwargs: object) -> Iterator[EventInsert] | None:
waitbus/cli/_shared.py, line 744
with urllib.request.urlopen(f"http://127.0.0.1:{port}/metrics", timeout=2.0) as resp:
waitbus/etag_poll.py, line 71
"""Socket-level timeout for ``urllib.request.urlopen`` calls to the GitHub API.
waitbus/etag_poll.py, line 236
with urllib.request.urlopen(req, timeout=_GH_URLOPEN_TIMEOUT_SEC) as resp:
Secrets
Concern
reads a credential or environment file.
SECRETS_ENV_READ SECRETS_PATH_CREDENTIAL SECRETS_PATH_DOTENV
benchmarks/_bench_preflight.py, line 273
env_key = os.environ.get("OPENAI_API_KEY", "").strip()
scripts/stress/_real_drivers.py, line 148
key = os.environ.get("OPENAI_API_KEY") or ""
.github/CONTRIBUTING.md, line 259
git config user.signingkey ~/.ssh/id_ed25519.pub
Show more
waitbus/_config.py, line 303
keyword; waitbus uses neither (no .env file loader; secrets resolve
waitbus/cli/allowlist.py, line 16
``~/.ssh/known_hosts``). Operators may edit it by hand; these
waitbus/sources/_config.py, line 37
exactly as ``cat ~/.ssh/known_hosts`` does. SQLite blobs cannot be
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Note
a file was over the read cap and was not fully read. the file cap was reached before every file was read.
OBFUSCATION_FILE_OVER_READ_CAP OBFUSCATION_FILE_CAP_REACHED
uv.lock, line 1
version = 1
adapters/waitbus-langgraph/uv.lock, line 1
version = 1
adapters/waitbus-pydantic-ai/uv.lock, line 1
version = 1
Show more
waitbus/_paths.py, line 1
"""Path-resolution factories for the waitbus event store.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit 49b9b4eeb68a. requests shell access. The manifest names this permission. install fetches a script from the network. README documents an installer that pipes a download into a shell. can reach a host that is not written as a fixed address. can reach pypi.org. The description does not name that host. reads a credential or environment file. a file was over the read cap and was not fully read. the file cap was reached before every file was read.
Date and source
Date checked:
github.com
Commit graded: 49b9b4eeb68ad751199238125df20a6fe9d297ad
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.