mirror of
https://github.com/headroomlabs-ai/headroom.git
synced 2026-11-22 13:29:19 +08:00
fix(plugin): resolve hook CLI through plugin-root launcher (#3053)
## Description
The `headroom` plugin invokes `headroom init hook ensure` through
non-login `/bin/sh`, but both `SessionStart` and `PreToolUse` entries
use a bare executable name. Agent hosts whose PATH omits the default
uv/pipx user bin exit 127 on every matching event. Tool calls continue
because the hook is non-blocking, while Headroom compression remains
inactive and the failure banner repeats.
Both hooks now invoke one launcher bundled under `${CLAUDE_PLUGIN_ROOT}`
through `sh`. The launcher honors `HEADROOM_BIN`, preserves
PATH-resolved installations, covers standard uv and pipx prefixes,
records the Homebrew candidates for macOS, and falls back to an
importable Python module. On the launcher-routed path, an absent
Headroom CLI emits one actionable diagnostic and exits 0. Hosts that do
not expose a readable plugin root retain the existing bare-command tail,
preserving the shared GitHub Copilot CLI manifest behavior.
Reported by [@donnydongchen](https://github.com/donnydongchen), whose
exact non-login `env -i` reproduction, Apple Silicon path detail, and
plugin-root suggestion shaped the fix.
Closes #3039
## Type of Change
- [x] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to change)
- [ ] Documentation update
- [ ] Performance improvement
- [ ] Code refactoring (no functional changes)
## Changes Made
- Route both plugin hook entries through a shared
`${CLAUDE_PLUGIN_ROOT}`-anchored `sh` launcher while preserving
matchers, arguments, and 60-second timeouts.
- Require a non-empty plugin root before probing the launcher, so unset
or empty roots always reach the existing bare-command tail.
- Resolve `HEADROOM_BIN`, PATH, standard uv/pipx/Homebrew locations, and
an importable `python -m headroom.cli` fallback in a deterministic
order.
- Preserve the current bare command for hosts without a readable plugin
root, including the shared Copilot CLI manifest path.
- On the launcher-routed path, replace the absent-CLI status-127 banner
with one actionable diagnostic and a non-blocking exit.
- Add real-shell regression coverage for the reported environment,
resolution precedence, supported prefixes, Python fallback, and negative
boundaries.
## Testing
- [x] Unit tests pass (`uv run --extra dev python -m pytest
tests/test_plugin_manifests.py tests/test_plugin_hook_launcher.py
tests/test_cli/test_init_cli.py -q`, `98 passed`)
- [x] Reproduction override passes (`HEADROOM_REPRO_ARTIFACT` can select
the issue fixture, `uv run --extra dev python -m pytest
tests/test_plugin_hook_launcher.py::test_manifest_command_recovers_reported_non_login_environment
-q`, `1 passed`)
- [x] Linting passes (Ruff check and format validation on the changed
Python test files)
- [ ] Type checking passes (`uv run mypy headroom`)
- [x] New tests added for new functionality when applicable
- [ ] Manual testing performed
### Test Output
```text
98 passed
All checks passed!
2 files already formatted
```
## Real Behavior Proof
- Environment: POSIX `sh` with the reporter's sanitized non-login PATH
and a recording Headroom executable only at `$HOME/.local/bin/headroom`
- Exact command / steps: `uv run --extra dev python -m pytest
tests/test_plugin_hook_launcher.py::test_manifest_command_recovers_reported_non_login_environment
-q`; the test preserves the reported PATH and error evidence, executes
both manifest commands with a recorder at `$HOME/.local/bin/headroom`,
and asserts both `home-local init hook ensure` receipts.
- Observed result: `1 passed in 0.41s`; both hooks recovered under the
reported non-login PATH and emitted no command-not-found banner.
- Not tested: live Claude Code plugin-hook execution on a macOS tmux
host
## Runtime Rollout Safety
- Rollout-managed feature(s): none.
- Minimum rollout channel: N/A.
- Stable/default behavior changed: plugin hooks resolve Headroom through
the bundled launcher when the plugin root is readable; invalid launcher
roots retain the existing bare-command fallback.
- Kill switch / disable path: none; the existing bare-command fallback
remains available when the plugin root is absent or unreadable.
- Unsafe override required: none.
- Qualification impact: none.
- Rollback path: revert the implementation commit.
## Review Readiness
- [x] I have performed a self-review
- [x] This PR is ready for human review
## Checklist
- [x] My code follows the project's style guidelines
- [x] I have performed a self-review of my code
- [x] I have commented my code, particularly in hard-to-understand areas
- [x] I have made corresponding changes to the documentation
- [x] My changes generate no new warnings
- [x] I have added tests that prove my fix is effective or that my
feature works
- [x] New and existing unit tests pass locally with my changes
## Screenshots (if applicable)
Not applicable; this PR changes plugin hook startup behavior without a
rendered UI.
## Additional Notes
The launcher does not source shell profiles, install packages, access
the network, change deployment/profile selection, or modify plugin
versions.
<!-- devin-review-badge-begin -->
---
<a href="https://app.devin.ai/review/headroomlabs-ai/headroom/pull/3053"
target="_blank"><picture><source media="(prefers-color-scheme: dark)"
srcset="https://static.devin.ai/assets/gh-devin-review-dark.svg?v=4"><img
src="https://static.devin.ai/assets/gh-devin-review-light.svg?v=4"
alt="Devin Review"></picture></a>
<!-- devin-review-badge-end -->
---------
Co-authored-by: JerrettDavis <mxjerrett@gmail.com>
This commit is contained in:
@@ -2,10 +2,24 @@
|
||||
|
||||
This plugin exposes lightweight startup hooks for Claude Code and GitHub Copilot CLI.
|
||||
|
||||
The hooks call:
|
||||
The hooks resolve and call:
|
||||
|
||||
```bash
|
||||
headroom init hook ensure
|
||||
```
|
||||
|
||||
That hidden helper checks for a matching durable `headroom init` deployment and starts it if needed.
|
||||
That hidden helper checks for a matching durable `headroom init` deployment and starts it if needed.
|
||||
|
||||
When `CLAUDE_PLUGIN_ROOT` points to a readable launcher, resolution order is
|
||||
`HEADROOM_BIN`, `headroom` on `PATH`, then `headroom` and
|
||||
`headroom.exe` in `$HOME/.local/bin`, `$HOME/.local/share/uv/tools/headroom-ai/bin`,
|
||||
`${PIPX_HOME:-$HOME/.local/pipx}/venvs/headroom-ai/bin`, `/opt/homebrew/bin`, and
|
||||
`/usr/local/bin`. If no executable is found, `HEADROOM_PYTHON`, `python3`, and
|
||||
`python` are checked for an importable `headroom` module and invoked as
|
||||
`python -m headroom.cli init hook ensure`.
|
||||
|
||||
Set `HEADROOM_BIN` or `HEADROOM_PYTHON` to override discovery. An absent CLI emits
|
||||
one actionable diagnostic and exits successfully, so the host hook remains
|
||||
nonblocking. Without a readable launcher, the hook runs bare
|
||||
`headroom init hook ensure` from `PATH` with none of the discovery above. Copilot
|
||||
CLI on Windows uses the manifest's `powershell` entry, which does the same.
|
||||
|
||||
+46
@@ -0,0 +1,46 @@
|
||||
#!/bin/sh
|
||||
set -u
|
||||
|
||||
if [ -n "${HEADROOM_BIN:-}" ] && [ -x "$HEADROOM_BIN" ]; then
|
||||
exec "$HEADROOM_BIN" init hook ensure
|
||||
fi
|
||||
|
||||
if command -v headroom >/dev/null 2>&1; then
|
||||
exec headroom init hook ensure
|
||||
fi
|
||||
|
||||
home=${HOME:-}
|
||||
for prefix in \
|
||||
"$home/.local/bin" \
|
||||
"$home/.local/share/uv/tools/headroom-ai/bin" \
|
||||
"${PIPX_HOME:-$home/.local/pipx}/venvs/headroom-ai/bin" \
|
||||
"/opt/homebrew/bin" \
|
||||
"/usr/local/bin"
|
||||
do
|
||||
for executable in headroom headroom.exe
|
||||
do
|
||||
candidate="$prefix/$executable"
|
||||
if [ -x "$candidate" ]; then
|
||||
exec "$candidate" init hook ensure
|
||||
fi
|
||||
done
|
||||
done
|
||||
|
||||
try_python() {
|
||||
candidate=$1
|
||||
if command -v "$candidate" >/dev/null 2>&1; then
|
||||
candidate=$(command -v "$candidate")
|
||||
elif [ ! -x "$candidate" ]; then
|
||||
return
|
||||
fi
|
||||
if "$candidate" -c 'import headroom' >/dev/null 2>&1; then
|
||||
exec "$candidate" -m headroom.cli init hook ensure
|
||||
fi
|
||||
}
|
||||
|
||||
try_python "${HEADROOM_PYTHON:-}"
|
||||
try_python python3
|
||||
try_python python
|
||||
|
||||
printf '%s\n' "headroom: CLI not found; install with 'uv tool install headroom-ai' or set HEADROOM_BIN; compression hooks are inactive." >&2
|
||||
exit 0
|
||||
@@ -7,8 +7,9 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "headroom init hook ensure",
|
||||
"timeout": 60
|
||||
"command": "sh -c '[ -n \"${CLAUDE_PLUGIN_ROOT:-}\" ] && launcher=\"${CLAUDE_PLUGIN_ROOT}/bin/headroom-hook.sh\" && [ -r \"$launcher\" ] && exec sh \"$launcher\"; exec headroom init hook ensure'",
|
||||
"powershell": "headroom init hook ensure",
|
||||
"timeout": 60
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -19,8 +20,9 @@
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "headroom init hook ensure",
|
||||
"timeout": 60
|
||||
"command": "sh -c '[ -n \"${CLAUDE_PLUGIN_ROOT:-}\" ] && launcher=\"${CLAUDE_PLUGIN_ROOT}/bin/headroom-hook.sh\" && [ -r \"$launcher\" ] && exec sh \"$launcher\"; exec headroom init hook ensure'",
|
||||
"powershell": "headroom init hook ensure",
|
||||
"timeout": 60
|
||||
}
|
||||
]
|
||||
}
|
||||
|
||||
+3
@@ -0,0 +1,3 @@
|
||||
{
|
||||
"body": "## Reproduction\n\n```console\n$ env -i HOME=\"$HOME\" PATH=/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin \\\n /bin/sh -c 'headroom init hook ensure'\n/bin/sh: headroom: command not found\n```\n"
|
||||
}
|
||||
@@ -0,0 +1,299 @@
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import shutil
|
||||
import subprocess
|
||||
from pathlib import Path
|
||||
|
||||
import pytest
|
||||
|
||||
REPO_ROOT = Path(__file__).resolve().parents[1]
|
||||
REPRO_FIXTURE = REPO_ROOT / "tests/fixtures/headroom-issue-3039.json"
|
||||
|
||||
|
||||
def _load_reproduction_artifact() -> dict[str, object]:
|
||||
configured = os.environ.get("HEADROOM_REPRO_ARTIFACT")
|
||||
path = Path(configured) if configured else REPRO_FIXTURE
|
||||
return json.loads(path.read_text(encoding="utf-8"))
|
||||
|
||||
|
||||
def _manifest_commands() -> list[str]:
|
||||
manifest = json.loads(
|
||||
(REPO_ROOT / "plugins/headroom-agent-hooks/hooks/hooks.json").read_text(encoding="utf-8")
|
||||
)
|
||||
return [
|
||||
entry["hooks"][0]["command"] for entries in manifest["hooks"].values() for entry in entries
|
||||
]
|
||||
|
||||
|
||||
LAUNCHER = REPO_ROOT / "plugins/headroom-agent-hooks/bin/headroom-hook.sh"
|
||||
|
||||
|
||||
def _posix_shell() -> str | None:
|
||||
shell = shutil.which("sh")
|
||||
if shell:
|
||||
return shell
|
||||
if os.name == "nt":
|
||||
git = shutil.which("git")
|
||||
if git:
|
||||
git_root = Path(git).resolve().parents[1]
|
||||
for candidate in (git_root / "bin" / "sh.exe", git_root / "usr" / "bin" / "sh.exe"):
|
||||
if candidate.is_file():
|
||||
return str(candidate)
|
||||
return None
|
||||
|
||||
|
||||
SHELL = _posix_shell()
|
||||
if SHELL is None:
|
||||
pytest.skip(
|
||||
"requires a POSIX shell (install Git for Windows or put sh on PATH)",
|
||||
allow_module_level=True,
|
||||
)
|
||||
|
||||
|
||||
def _posix(path: Path) -> str:
|
||||
value = path.resolve().as_posix()
|
||||
if len(value) > 2 and value[1] == ":":
|
||||
return f"/{value[0].lower()}{value[2:]}"
|
||||
return value
|
||||
|
||||
|
||||
def _write_recorder(path: Path, receipt: Path, source: str) -> None:
|
||||
path.write_text(
|
||||
f'#!/bin/sh\nprintf \'%s %s\\n\' "{source}" "$*" >>"$HEADROOM_RECEIPT"\n',
|
||||
encoding="utf-8",
|
||||
)
|
||||
path.chmod(0o755)
|
||||
|
||||
|
||||
def _run_launcher(tmp_path: Path, **extra: str) -> subprocess.CompletedProcess[str]:
|
||||
environment = {
|
||||
"HOME": _posix(tmp_path / "home"),
|
||||
"PATH": "/no-such-bin",
|
||||
"HEADROOM_RECEIPT": _posix(tmp_path / "receipt"),
|
||||
**extra,
|
||||
}
|
||||
return subprocess.run(
|
||||
[SHELL, _posix(LAUNCHER)],
|
||||
cwd=REPO_ROOT,
|
||||
env=environment,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
)
|
||||
|
||||
|
||||
def _receipt(tmp_path: Path) -> list[str]:
|
||||
receipt = tmp_path / "receipt"
|
||||
return receipt.read_text(encoding="utf-8").splitlines() if receipt.exists() else []
|
||||
|
||||
|
||||
def test_manifest_command_recovers_reported_non_login_environment(tmp_path: Path) -> None:
|
||||
artifact = _load_reproduction_artifact()
|
||||
body = artifact["body"]
|
||||
assert isinstance(body, str)
|
||||
path_match = re.search(r"PATH=([^\s\\]+)", body)
|
||||
assert path_match is not None
|
||||
reporter_path = path_match.group(1)
|
||||
command_body = re.sub(r"\\\r?\n[ \t]*", "", body)
|
||||
assert (
|
||||
'env -i HOME="$HOME" PATH=/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/sbin '
|
||||
"/bin/sh -c 'headroom init hook ensure'"
|
||||
) in command_body
|
||||
assert "/bin/sh: headroom: command not found" in body
|
||||
|
||||
home = tmp_path / "home"
|
||||
headroom = home / ".local/bin/headroom"
|
||||
headroom.parent.mkdir(parents=True)
|
||||
receipt = tmp_path / "receipt"
|
||||
_write_recorder(headroom, receipt, "home-local")
|
||||
|
||||
environment = {
|
||||
"HOME": _posix(home),
|
||||
"PATH": reporter_path,
|
||||
"HEADROOM_RECEIPT": _posix(receipt),
|
||||
"CLAUDE_PLUGIN_ROOT": _posix(REPO_ROOT / "plugins/headroom-agent-hooks"),
|
||||
}
|
||||
for command in _manifest_commands():
|
||||
result = subprocess.run(
|
||||
[SHELL, "-c", command],
|
||||
cwd=REPO_ROOT,
|
||||
env=environment,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
)
|
||||
assert result.returncode == 0, result.stderr
|
||||
|
||||
assert receipt.read_text(encoding="utf-8").splitlines() == [
|
||||
"home-local init hook ensure",
|
||||
"home-local init hook ensure",
|
||||
]
|
||||
assert "command not found" not in result.stderr
|
||||
|
||||
|
||||
def test_launcher_resolution_precedence(tmp_path: Path) -> None:
|
||||
home = tmp_path / "home"
|
||||
override = tmp_path / "override"
|
||||
path_dir = tmp_path / "path"
|
||||
prefix = home / ".local/bin/headroom"
|
||||
path_dir.mkdir(parents=True)
|
||||
prefix.parent.mkdir(parents=True)
|
||||
_write_recorder(override, tmp_path / "receipt", "override")
|
||||
_write_recorder(path_dir / "headroom", tmp_path / "receipt", "path")
|
||||
_write_recorder(prefix, tmp_path / "receipt", "prefix")
|
||||
|
||||
result = _run_launcher(
|
||||
tmp_path,
|
||||
HOME=_posix(home),
|
||||
PATH=_posix(path_dir),
|
||||
HEADROOM_BIN=_posix(override),
|
||||
)
|
||||
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == ["override init hook ensure"]
|
||||
|
||||
(tmp_path / "receipt").unlink()
|
||||
result = _run_launcher(tmp_path, HOME=_posix(home), PATH=_posix(path_dir))
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == ["path init hook ensure"]
|
||||
|
||||
(tmp_path / "receipt").unlink()
|
||||
result = _run_launcher(tmp_path, HOME=_posix(home), PATH="/no-such-bin")
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == ["prefix init hook ensure"]
|
||||
|
||||
|
||||
def test_launcher_resolves_standard_prefixes(tmp_path: Path) -> None:
|
||||
prefixes = [
|
||||
tmp_path / "home/.local/bin",
|
||||
tmp_path / "home/.local/share/uv/tools/headroom-ai/bin",
|
||||
tmp_path / "home/.local/pipx/venvs/headroom-ai/bin",
|
||||
]
|
||||
for index, prefix in enumerate(prefixes):
|
||||
prefix.mkdir(parents=True)
|
||||
name = "headroom.exe" if index == 0 else "headroom"
|
||||
_write_recorder(prefix / name, tmp_path / "receipt", f"prefix-{index}")
|
||||
result = _run_launcher(tmp_path)
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == [f"prefix-{index} init hook ensure"]
|
||||
(tmp_path / "receipt").unlink()
|
||||
(prefix / name).unlink()
|
||||
|
||||
|
||||
def test_launcher_uses_importable_python_module(tmp_path: Path) -> None:
|
||||
interpreter = tmp_path / "python-fallback"
|
||||
interpreter.write_text(
|
||||
"#!/bin/sh\n"
|
||||
'if [ "$1" = "-c" ]; then exit 0; fi\n'
|
||||
'printf \'%s\\n\' "$*" >"$HEADROOM_RECEIPT"\n',
|
||||
encoding="utf-8",
|
||||
)
|
||||
interpreter.chmod(0o755)
|
||||
|
||||
result = _run_launcher(tmp_path, HEADROOM_PYTHON=_posix(interpreter))
|
||||
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == ["-m headroom.cli init hook ensure"]
|
||||
|
||||
|
||||
def test_launcher_missing_cli_is_nonblocking(tmp_path: Path) -> None:
|
||||
result = _run_launcher(tmp_path)
|
||||
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == []
|
||||
assert result.stderr.splitlines() == [
|
||||
"headroom: CLI not found; install with 'uv tool install headroom-ai' or set HEADROOM_BIN; compression hooks are inactive."
|
||||
]
|
||||
|
||||
|
||||
def test_launcher_skips_non_executable_fixed_prefix_candidate(tmp_path: Path) -> None:
|
||||
candidate = tmp_path / "home/.local/bin/headroom"
|
||||
candidate.parent.mkdir(parents=True)
|
||||
candidate.write_text("not executable", encoding="utf-8")
|
||||
|
||||
result = _run_launcher(tmp_path)
|
||||
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == []
|
||||
assert "CLI not found" in result.stderr
|
||||
|
||||
|
||||
def test_launcher_skips_non_importable_python(tmp_path: Path) -> None:
|
||||
interpreter = tmp_path / "python-not-headroom"
|
||||
interpreter.write_text("#!/bin/sh\nexit 1\n", encoding="utf-8")
|
||||
interpreter.chmod(0o755)
|
||||
|
||||
result = _run_launcher(tmp_path, HEADROOM_PYTHON=_posix(interpreter))
|
||||
|
||||
assert result.returncode == 0
|
||||
assert _receipt(tmp_path) == []
|
||||
assert "CLI not found" in result.stderr
|
||||
|
||||
|
||||
def test_launcher_declares_absolute_standard_prefixes() -> None:
|
||||
source = LAUNCHER.read_text(encoding="utf-8")
|
||||
assert '"/opt/homebrew/bin"' in source
|
||||
assert '"/usr/local/bin"' in source
|
||||
|
||||
|
||||
def test_manifest_rootless_tail_reaches_path(tmp_path: Path) -> None:
|
||||
stub = tmp_path / "path/headroom"
|
||||
receipt = tmp_path / "receipt"
|
||||
stub.parent.mkdir(parents=True)
|
||||
_write_recorder(stub, receipt, "rootless-path")
|
||||
|
||||
for plugin_root in (None, ""):
|
||||
environment = {
|
||||
"PATH": _posix(stub.parent) + os.pathsep + os.environ["PATH"],
|
||||
"HEADROOM_RECEIPT": _posix(receipt),
|
||||
"CLAUDE_PLUGIN_ROOT": plugin_root,
|
||||
}
|
||||
for command in _manifest_commands():
|
||||
result = subprocess.run(
|
||||
[SHELL, "-c", command],
|
||||
cwd=REPO_ROOT,
|
||||
env={key: value for key, value in environment.items() if value is not None},
|
||||
capture_output=True,
|
||||
text=True,
|
||||
)
|
||||
assert result.returncode == 0, result.stderr
|
||||
|
||||
assert _receipt(tmp_path) == [
|
||||
"rootless-path init hook ensure",
|
||||
"rootless-path init hook ensure",
|
||||
"rootless-path init hook ensure",
|
||||
"rootless-path init hook ensure",
|
||||
]
|
||||
|
||||
|
||||
def test_manifest_nonempty_missing_or_unreadable_root_reaches_path(tmp_path: Path) -> None:
|
||||
stub = tmp_path / "path/headroom"
|
||||
receipt = tmp_path / "receipt"
|
||||
stub.parent.mkdir(parents=True)
|
||||
_write_recorder(stub, receipt, "fallback-path")
|
||||
|
||||
missing_root = tmp_path / "missing-plugin"
|
||||
unreadable_root = tmp_path / "unreadable-plugin"
|
||||
unreadable_root.write_text("plugin root is not a directory", encoding="utf-8")
|
||||
|
||||
for plugin_root in (missing_root, unreadable_root):
|
||||
environment = {
|
||||
"PATH": _posix(stub.parent) + ":" + os.environ["PATH"],
|
||||
"HEADROOM_RECEIPT": _posix(receipt),
|
||||
"CLAUDE_PLUGIN_ROOT": _posix(plugin_root),
|
||||
}
|
||||
for command in _manifest_commands():
|
||||
result = subprocess.run(
|
||||
[SHELL, "-c", command],
|
||||
cwd=REPO_ROOT,
|
||||
env=environment,
|
||||
capture_output=True,
|
||||
text=True,
|
||||
)
|
||||
assert result.returncode == 0, result.stderr
|
||||
assert _receipt(tmp_path) == [
|
||||
"fallback-path init hook ensure",
|
||||
"fallback-path init hook ensure",
|
||||
]
|
||||
receipt.unlink()
|
||||
@@ -67,3 +67,26 @@ def test_plugin_metadata_points_to_upstream_repo() -> None:
|
||||
assert claude["author"]["url"] == expected_repo
|
||||
assert claude["homepage"] == expected_repo
|
||||
assert claude["repository"] == expected_repo
|
||||
|
||||
|
||||
def test_plugin_hooks_share_anchored_launcher_and_rootless_tail() -> None:
|
||||
hooks = _load_json("plugins/headroom-agent-hooks/hooks/hooks.json")
|
||||
assert isinstance(hooks, dict)
|
||||
commands = [
|
||||
entry["hooks"][0]["command"] for entries in hooks["hooks"].values() for entry in entries
|
||||
]
|
||||
expected = (
|
||||
'sh -c \'[ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && launcher="${CLAUDE_PLUGIN_ROOT}/bin/headroom-hook.sh" && '
|
||||
'[ -r "$launcher" ] && exec sh "$launcher"; '
|
||||
"exec headroom init hook ensure'"
|
||||
)
|
||||
assert commands == [expected, expected]
|
||||
powershell = [
|
||||
entry["hooks"][0]["powershell"] for entries in hooks["hooks"].values() for entry in entries
|
||||
]
|
||||
assert powershell == ["headroom init hook ensure", "headroom init hook ensure"]
|
||||
assert hooks["hooks"]["SessionStart"][0]["matcher"] == "startup|resume"
|
||||
assert hooks["hooks"]["PreToolUse"][0]["matcher"] == "Bash|PowerShell"
|
||||
launcher = REPO_ROOT / "plugins/headroom-agent-hooks/bin/headroom-hook.sh"
|
||||
assert launcher.is_file()
|
||||
assert b"\r" not in launcher.read_bytes()
|
||||
|
||||
Reference in New Issue
Block a user