sequential-hooks 0.1.0__tar.gz → 0.1.1__tar.gz

sequential_hooks-0.1.1/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.5
+Name: sequential-hooks
+Version: 0.1.1
+Summary: Run coding-agent hooks in order with agent-specific response handling
+Project-URL: Documentation, https://github.com/dactylo/sequential-hooks/tree/main/docs
+Project-URL: Homepage, https://github.com/dactylo/sequential-hooks
+Project-URL: Issues, https://github.com/dactylo/sequential-hooks/issues
+Project-URL: Repository, https://github.com/dactylo/sequential-hooks
+License-Expression: MIT
+License-File: LICENSE
+Keywords: coding-agents,hooks,orchestration,sequential
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# sequential-hooks
+
+sequential-hooks runs coding-agent hooks in a strict order. Without a wrapper, a host may start
+several hooks concurrently or in an undocumented order. A validator can then inspect an old tool
+input while another hook is still replacing it. Register one wrapper hook and place the former hook
+commands inside it as ordered steps.
+
+## Installation
+
+sequential-hooks requires native CPython 3.13 or newer. Install the current checkout from the
+repository root with [uv](https://docs.astral.sh/uv/):
+
+```text
+uv tool install .
+```
+
+To update an existing installation after pulling changes:
+
+```text
+uv tool install --reinstall .
+```
+
+`make install` and `make reinstall` run the same commands.
+
+## Quick start
+
+sequential-hooks has no configuration file. Choose the coding agent that will run the wrapper, then
+add the registration from its setup guide:
+
+- [Claude Code](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/plugins/claude/README.md)
+- [Codex](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/plugins/codex/README.md)
+- [Antigravity](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/plugins/agy/README.md)
+
+Check [compatibility](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/compatibility.md) for supported hosts and known host limits, and
+[platforms](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/platforms.md) for process handling. The guides use `first-hook`, `second-hook`,
+and `audit-hook` as sample child commands. Replace them with hooks you have installed and want to
+run in order. Move those child hooks into the wrapper and remove their separate registrations, or
+the host may still start duplicate copies concurrently.
+
+The wrapper command expects a native host payload on stdin. Configure it as a host hook rather than
+running the hook command interactively. After saving the registration, inspect it with the matching
+read-only report:
+
+```text
+sequential-hooks doctor --agent claude
+sequential-hooks doctor --agent codex
+sequential-hooks doctor --agent agy
+```
+
+Exit 0 means the findings are informational. Exit 1 means at least one warning or error is present.
+Some warnings describe inspection limits and persist after host-side review. The
+[troubleshooting guide](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/troubleshooting.md) explains common findings.
+
+Antigravity requires an explicit event in each hook command. An all-neutral Antigravity pre-tool
+chain emits the host's real automatic `allow` decision; it does not preserve the ordinary
+permission prompt. Review the [Antigravity setup guide](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/plugins/agy/README.md) before enabling it.
+
+## How commands compose
+
+`-a, --agent` selects the installed host adapter for a coding agent. The built-in names are
+`claude`, `codex`, and `agy`; a third-party adapter installed with
+`uv tool install . --with PACKAGE` is selected by its own name. Nothing is inferred from the
+payload. See [adding a host](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/adding-a-host.md).
+
+`-h, --help` prints help for wrapper mode; `doctor -h` and `doctor --help` print doctor help.
+
+```text
+sequential-hooks --agent codex --step-timeout 30 first-hook --agent codex -- second-hook --agent codex
+```
+
+The exact `--` token separates steps and cannot be passed to a step. Each child receives its own
+literal arguments, including its own `--agent`; wrapper options are not inherited by child
+commands.
+
+## Documentation
+
+| If you want to...                                          | Read                                                        |
+| ---------------------------------------------------------- | ----------------------------------------------------------- |
+| Understand ordering, replacements, and decisions           | [Concepts](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/concepts.md)                                |
+| Review trust boundaries and pre-permission execution       | [Security](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/security.md)                                |
+| Interpret `doctor` findings or runtime failures            | [Troubleshooting](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/troubleshooting.md)                  |
+| Look up hook grammar, limits, and exit codes               | [CLI reference](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/reference/cli.md)                      |
+| Check accepted input, output, and decisions for each event | [Host protocol reference](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/reference/host-protocols.md) |
+| Check supported hosts and platforms                        | [Compatibility](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/compatibility.md)                      |
+| Add support for another coding agent                       | [Adding a host](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/adding-a-host.md)                      |
+| Browse every guide                                         | [Documentation map](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/README.md)                         |
+
+## Development
+
+See the [development guide](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/docs/development.md) for the required tools, CI, and dependency locks.
+With those tools installed, run:
+
+```text
+make setup
+make check
+```
+
+## License
+
+sequential-hooks is available under the [MIT License](https://github.com/dactylo/sequential-hooks/blob/v0.1.1/LICENSE).

sequential_hooks-0.1.1/README.md

@@ -0,0 +1,100 @@
+# sequential-hooks
+
+sequential-hooks runs coding-agent hooks in a strict order. Without a wrapper, a host may start
+several hooks concurrently or in an undocumented order. A validator can then inspect an old tool
+input while another hook is still replacing it. Register one wrapper hook and place the former hook
+commands inside it as ordered steps.
+
+## Installation
+
+sequential-hooks requires native CPython 3.13 or newer. Install the current checkout from the
+repository root with [uv](https://docs.astral.sh/uv/):
+
+```text
+uv tool install .
+```
+
+To update an existing installation after pulling changes:
+
+```text
+uv tool install --reinstall .
+```
+
+`make install` and `make reinstall` run the same commands.
+
+## Quick start
+
+sequential-hooks has no configuration file. Choose the coding agent that will run the wrapper, then
+add the registration from its setup guide:
+
+- [Claude Code](plugins/claude/README.md)
+- [Codex](plugins/codex/README.md)
+- [Antigravity](plugins/agy/README.md)
+
+Check [compatibility](docs/compatibility.md) for supported hosts and known host limits, and
+[platforms](docs/platforms.md) for process handling. The guides use `first-hook`, `second-hook`,
+and `audit-hook` as sample child commands. Replace them with hooks you have installed and want to
+run in order. Move those child hooks into the wrapper and remove their separate registrations, or
+the host may still start duplicate copies concurrently.
+
+The wrapper command expects a native host payload on stdin. Configure it as a host hook rather than
+running the hook command interactively. After saving the registration, inspect it with the matching
+read-only report:
+
+```text
+sequential-hooks doctor --agent claude
+sequential-hooks doctor --agent codex
+sequential-hooks doctor --agent agy
+```
+
+Exit 0 means the findings are informational. Exit 1 means at least one warning or error is present.
+Some warnings describe inspection limits and persist after host-side review. The
+[troubleshooting guide](docs/troubleshooting.md) explains common findings.
+
+Antigravity requires an explicit event in each hook command. An all-neutral Antigravity pre-tool
+chain emits the host's real automatic `allow` decision; it does not preserve the ordinary
+permission prompt. Review the [Antigravity setup guide](plugins/agy/README.md) before enabling it.
+
+## How commands compose
+
+`-a, --agent` selects the installed host adapter for a coding agent. The built-in names are
+`claude`, `codex`, and `agy`; a third-party adapter installed with
+`uv tool install . --with PACKAGE` is selected by its own name. Nothing is inferred from the
+payload. See [adding a host](docs/adding-a-host.md).
+
+`-h, --help` prints help for wrapper mode; `doctor -h` and `doctor --help` print doctor help.
+
+```text
+sequential-hooks --agent codex --step-timeout 30 first-hook --agent codex -- second-hook --agent codex
+```
+
+The exact `--` token separates steps and cannot be passed to a step. Each child receives its own
+literal arguments, including its own `--agent`; wrapper options are not inherited by child
+commands.
+
+## Documentation
+
+| If you want to...                                          | Read                                                        |
+| ---------------------------------------------------------- | ----------------------------------------------------------- |
+| Understand ordering, replacements, and decisions           | [Concepts](docs/concepts.md)                                |
+| Review trust boundaries and pre-permission execution       | [Security](docs/security.md)                                |
+| Interpret `doctor` findings or runtime failures            | [Troubleshooting](docs/troubleshooting.md)                  |
+| Look up hook grammar, limits, and exit codes               | [CLI reference](docs/reference/cli.md)                      |
+| Check accepted input, output, and decisions for each event | [Host protocol reference](docs/reference/host-protocols.md) |
+| Check supported hosts and platforms                        | [Compatibility](docs/compatibility.md)                      |
+| Add support for another coding agent                       | [Adding a host](docs/adding-a-host.md)                      |
+| Browse every guide                                         | [Documentation map](docs/README.md)                         |
+
+## Development
+
+See the [development guide](docs/development.md) for the required tools, CI, and dependency locks.
+With those tools installed, run:
+
+```text
+make setup
+make check
+```
+
+## License
+
+sequential-hooks is available under the [MIT License](LICENSE).

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/agy/README.md

@@ -1,7 +1,7 @@
 # Antigravity
 
 The Antigravity adapter chains `PreToolUse` and `PostToolUse` hooks. Antigravity may invoke an
-exact post-tool matcher for extra callbacks whose `toolCall` is explicitly null. `sequential-hooks`
+exact post-tool matcher for extra callbacks whose `toolCall` is explicitly null. sequential-hooks
 treats that exact shape as inapplicable, starts no child step, and returns the native empty
 response.
 
@@ -10,7 +10,7 @@ Antigravity CLI 1.1.13 documents five native hook events: `PreToolUse`, `PostToo
 `PostToolUse`.
 
 Antigravity configuration may appear in `~/.gemini/config/hooks.json` or project
-`.agents/hooks.json`. `sequential-hooks` has no configuration file.
+`.agents/hooks.json`. sequential-hooks has no configuration file.
 
 Official reference: [Antigravity hooks](https://antigravity.google/docs/hooks).
 

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/agy/_sequential_hooks/_adapter.py

@@ -66,17 +66,8 @@ class _RankedContribution:
     _step: Step
 
 
-class AgyAdapter:
-    """Compose child results for one validated Antigravity event.
-
-    Child results are consumed in step order and composed into an event-
-    specific final response. The original strict JSON input remains the input
-    for every child.
-
-    Attributes:
-        event: Validated pre-tool or post-tool event.
-        should_run_steps: Whether the invocation should execute child steps.
-    """
+class _AgyAdapter:
+    """Compose child results for one validated Antigravity event."""
 
     def __init__(
         self,
@@ -87,19 +78,7 @@ class AgyAdapter:
         *,
         allow_on_failure: bool,
     ) -> None:
-        """Validate native input and initialize one Antigravity event adapter.
-
-        Args:
-            event: Exact CLI event selected by the caller.
-            raw_input: Original strict JSON bytes received from Antigravity.
-            payload: Decoded strict JSON object matching `raw_input`.
-            diagnostics: Developer-tier diagnostic sink.
-            allow_on_failure: Whether approved pre-tool failures may continue.
-
-        Raises:
-            HostInputError: If required Antigravity input is missing, has the
-                wrong type, or is invalid.
-        """
+        """Validate native input and initialize one Antigravity event adapter."""
         if event not in _EVENTS:
             raise HostInputError('Antigravity input has an unsupported event')
         step_index = payload.get('stepIdx')
@@ -487,7 +466,7 @@ class AgyHost:
         diagnostics: Diagnostics,
         *,
         allow_on_failure: bool,
-    ) -> AgyAdapter:
+    ) -> _AgyAdapter:
         """Validate native input and construct the adapter for one invocation.
 
         Args:
@@ -503,7 +482,7 @@ class AgyHost:
         Raises:
             HostInputError: If the payload is not valid input for `event`.
         """
-        return AgyAdapter(
+        return _AgyAdapter(
             event,
             raw_input,
             payload,

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/agy/_sequential_hooks/_doctor.py

@@ -9,8 +9,10 @@ from sequential_hooks.hosts import (
     Finding,
     FindingSeverity,
     InspectedCommand,
+    JsonObject,
     JsonObjectExpectedError,
     JsonProtocolError,
+    JsonValue,
     LaunchSemantics,
     Registration,
     SourceKind,
@@ -177,12 +179,12 @@ def _finding(
 
 def _handler_validation_finding(
     source: ConfigSource,
-    handler: object,
+    handler: JsonValue,
 ) -> Finding | None:
     """Return the first structural problem in one handler."""
     if not isinstance(handler, dict):
         return _finding(source, 'agy_hook_malformed', 'contains a malformed hook handler')
-    handler_data = cast('dict[str, object]', handler)
+    handler_data = handler
     handler_type = handler_data.get('type', 'command')
     if handler_type != 'command':
         return _finding(
@@ -198,7 +200,7 @@ def _handler_validation_finding(
         )
     if 'args' in handler_data and (
         not isinstance(raw_args := handler_data['args'], list)
-        or not all(isinstance(argument, str) for argument in cast('list[object]', raw_args))
+        or not all(isinstance(argument, str) for argument in raw_args)
     ):
         return _finding(
             source,
@@ -219,7 +221,7 @@ def _inspection_limitations() -> tuple[str, ...]:
     return _LIMITATIONS
 
 
-def _load_source(source: ConfigSource) -> tuple[dict[str, object] | None, Finding | None]:
+def _load_source(source: ConfigSource) -> tuple[JsonObject | None, Finding | None]:
     """Load one strict JSON source without exposing its content."""
     try:
         text = source.path.read_text(encoding='utf-8')
@@ -237,14 +239,14 @@ def _load_source(source: ConfigSource) -> tuple[dict[str, object] | None, Findin
         return None, _finding(source, 'agy_settings_malformed', 'must contain a JSON object')
     except JsonProtocolError:
         return None, _finding(source, 'agy_json_malformed', 'contains malformed JSON')
-    return cast('dict[str, object]', loaded), None
+    return loaded, None
 
 
 def _registration(
     source: ConfigSource,
     event: str,
     matcher: str | None,
-    handler: object,
+    handler: JsonValue,
     *,
     enabled: bool | None,
 ) -> tuple[Registration | None, list[Finding]]:
@@ -252,7 +254,7 @@ def _registration(
     validation_finding = _handler_validation_finding(source, handler)
     if validation_finding is not None:
         return None, [validation_finding]
-    handler_data = cast('dict[str, object]', handler)
+    handler_data = cast('JsonObject', handler)
     raw_args = cast('list[str] | None', handler_data.get('args'))
     raw_timeout = handler_data.get('timeout')
     timeout = _DEFAULT_HANDLER_TIMEOUT
@@ -291,7 +293,7 @@ def _registration(
         windows_launch_semantics=LaunchSemantics.WINDOWS_SHELL,
         timeout=timeout,
         enabled=enabled,
-        type=cast('str', handler_data.get('type', 'command')),
+        type='command',
         configuration_findings=tuple(findings),
     )
     return registration, []
@@ -299,17 +301,17 @@ def _registration(
 
 def _event_registrations(
     source: ConfigSource,
-    event: object,
-    groups: object,
+    event: str,
+    groups: JsonValue,
     *,
     enabled: bool | None,
 ) -> tuple[list[Registration], list[Finding]]:
     """Parse one event layer."""
-    if not isinstance(event, str) or not isinstance(groups, list):
+    if not isinstance(groups, list):
         return [], [_finding(source, 'agy_event_malformed', 'contains a malformed event')]
     registrations: list[Registration] = []
     findings: list[Finding] = []
-    for group in cast('list[object]', groups):
+    for group in groups:
         if not isinstance(group, dict):
             findings.append(
                 _finding(
@@ -319,7 +321,7 @@ def _event_registrations(
                 )
             )
             continue
-        group_data = cast('dict[str, object]', group)
+        group_data = group
         matcher = group_data.get('matcher')
         if 'matcher' in group_data and not isinstance(matcher, str):
             findings.append(
@@ -336,7 +338,7 @@ def _event_registrations(
                 )
             )
             continue
-        for handler in cast('list[object]', handlers):
+        for handler in handlers:
             registration, handler_findings = _registration(
                 source,
                 event,
@@ -352,7 +354,7 @@ def _event_registrations(
 
 def _named_registrations(
     source: ConfigSource,
-    loaded: dict[str, object],
+    loaded: JsonObject,
 ) -> tuple[list[Registration], list[Finding]]:
     """Parse the documented named-hook map."""
     registrations: list[Registration] = []
@@ -367,7 +369,7 @@ def _named_registrations(
                 )
             )
             continue
-        hook_data = cast('dict[str, object]', named_hook)
+        hook_data = named_hook
         enabled = hook_data.get('enabled', True)
         if not isinstance(enabled, bool):
             findings.append(

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/agy/tests/test_agy_adapter.py

@@ -9,7 +9,7 @@ from typing import cast
 import pytest
 
 from plugins.agy._sequential_hooks import _adapter as agy_module
-from plugins.agy._sequential_hooks._adapter import AgyAdapter, AgyHost
+from plugins.agy._sequential_hooks._adapter import AgyHost, _AgyAdapter
 from sequential_hooks._diagnostics import Diagnostics
 from sequential_hooks._executor import _STDOUT_LIMIT_BYTES
 from sequential_hooks._types import (
@@ -42,7 +42,7 @@ _PRE_RANK = {
 _UNCONTAINED_WARNING = 'step ran without containment; descendant cleanup is not guaranteed'
 
 
-class _OutputFailureAdapter(AgyAdapter):
+class _OutputFailureAdapter(_AgyAdapter):
     def consume_output_failure(
         self,
         step: Step,
@@ -65,11 +65,11 @@ def _adapter(
     raw_input: bytes | None = None,
     *,
     allow_on_failure: bool = False,
-) -> tuple[AgyAdapter, io.StringIO]:
+) -> tuple[_AgyAdapter, io.StringIO]:
     data = _fixture(event) if raw_input is None else raw_input
     stream = io.StringIO()
     return (
-        AgyAdapter(
+        _AgyAdapter(
             event,
             data,
             load_object(data),
@@ -105,7 +105,7 @@ def _output_failure_adapter(
     )
 
 
-def _response(adapter: AgyAdapter) -> JsonObject:
+def _response(adapter: _AgyAdapter) -> JsonObject:
     return load_object(adapter.finalize().stdout)
 
 
@@ -131,6 +131,30 @@ def test_all_neutral_chain_emits_canonical_allow() -> None:
     assert adapter.finalize().stdout == b'{"decision":"allow"}\n'
 
 
+@pytest.mark.parametrize('event', ['PreToolUse', 'PostToolUse'])
+def test_configuration_response_is_independent_of_adapter_construction(
+    event: str,
+    monkeypatch: pytest.MonkeyPatch,
+) -> None:
+    def unavailable(*_args: object, **_kwargs: object) -> None:
+        raise AssertionError('configuration response must not construct an adapter')
+
+    monkeypatch.setattr('plugins.agy._sequential_hooks._adapter._AgyAdapter', unavailable)
+    monkeypatch.setattr(AgyHost, 'adapter', unavailable)
+    stream = io.StringIO()
+    response = AgyHost().configuration_response(
+        event, 'invalid configuration', Diagnostics(stream)
+    )
+    message = '[step 1: configuration]\nspawn: sequential-hooks could not safely run this hook'
+    expected = {'decision': 'deny', 'reason': message} if event == 'PreToolUse' else {}
+
+    assert response.exit_code == 0
+    assert json.loads(response.stdout) == expected
+    assert response.stdout.endswith(b'\n')
+    assert response.stdout.count(b'\n') == 1
+    assert 'sequential-hooks could not safely run this hook' in stream.getvalue()
+
+
 def test_conflicting_winning_overrides_become_terminal_deny() -> None:
     adapter, _stream = _adapter('PreToolUse')
     adapter.consume(
@@ -419,7 +443,7 @@ def test_lone_surrogate_uncontained_failure_restores_exact_prior_state() -> None
     raw_input = _fixture('PreToolUse')
     payload = load_object(raw_input)
     stream = io.StringIO()
-    adapter = AgyAdapter(
+    adapter = _AgyAdapter(
         'PreToolUse',
         raw_input,
         payload,
@@ -1210,27 +1234,3 @@ def test_whitespace_only_stdout_is_neutral(stdout: bytes) -> None:
     assert control == 'continue'
     assert adapter.finalize().stdout == b'{"decision":"allow"}\n'
     assert stream.getvalue() == ''
-
-
-@pytest.mark.parametrize('event', ['PreToolUse', 'PostToolUse'])
-def test_configuration_response_is_independent_of_adapter_construction(
-    event: str,
-    monkeypatch: pytest.MonkeyPatch,
-) -> None:
-    def unavailable(*_args: object, **_kwargs: object) -> None:
-        raise AssertionError('configuration response must not construct an adapter')
-
-    monkeypatch.setattr('plugins.agy._sequential_hooks._adapter.AgyAdapter', unavailable)
-    monkeypatch.setattr(AgyHost, 'adapter', unavailable)
-    stream = io.StringIO()
-    response = AgyHost().configuration_response(
-        event, 'invalid configuration', Diagnostics(stream)
-    )
-    message = '[step 1: configuration]\nspawn: sequential-hooks could not safely run this hook'
-    expected = {'decision': 'deny', 'reason': message} if event == 'PreToolUse' else {}
-
-    assert response.exit_code == 0
-    assert json.loads(response.stdout) == expected
-    assert response.stdout.endswith(b'\n')
-    assert response.stdout.count(b'\n') == 1
-    assert 'sequential-hooks could not safely run this hook' in stream.getvalue()

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/agy/tests/test_agy_doctor.py

@@ -3,7 +3,6 @@
 import json
 import subprocess
 from pathlib import Path
-from typing import cast
 
 import pytest
 
@@ -19,25 +18,22 @@ from sequential_hooks._registry import load_host
 from sequential_hooks.hosts import (
     Finding,
     FindingSeverity,
+    JsonValue,
     LaunchSemantics,
     SourceKind,
 )
 
-_MALFORMED_HOOKS_NAME_CASES = cast(
-    'tuple[tuple[object, str], ...]',
-    (
-        ([], 'agy_named_hook_malformed'),
-        ({'PreToolUse': {}}, 'agy_event_malformed'),
-        ({'PreToolUse': [None]}, 'agy_matcher_group_malformed'),
-        ({'PreToolUse': [{'matcher': None, 'hooks': []}]}, 'agy_matcher_malformed'),
-        ({'PreToolUse': [{}]}, 'agy_handler_list_malformed'),
-    ),
+_MALFORMED_HOOKS_NAME_CASES: tuple[tuple[JsonValue, str], ...] = (
+    ([], 'agy_named_hook_malformed'),
+    ({'PreToolUse': {}}, 'agy_event_malformed'),
+    ({'PreToolUse': [None]}, 'agy_matcher_group_malformed'),
+    ({'PreToolUse': [{'matcher': None, 'hooks': []}]}, 'agy_matcher_malformed'),
+    ({'PreToolUse': [{}]}, 'agy_handler_list_malformed'),
 )
 
 
-def _non_global_codes(findings: object) -> list[str]:
-    typed = cast('tuple[Finding, ...]', findings)
-    return [finding.code for finding in typed]
+def _non_global_codes(findings: tuple[Finding, ...]) -> list[str]:
+    return [finding.code for finding in findings]
 
 
 def _write_json(path: Path, data: object) -> None:
@@ -380,6 +376,7 @@ def test_duplicate_literal_options_remain_uninspectable(
     assert 'wrong_host' not in codes
 
 
+@pytest.mark.usefixtures('distribution_root')
 def test_dynamic_command_has_no_malformed_wrapper_warning(tmp_path: Path) -> None:
     _write_hook_named_hooks(
         tmp_path / '.gemini/config/hooks.json',
@@ -665,6 +662,7 @@ def test_named_hooks_preserve_mixed_source_order(tmp_path: Path) -> None:
     ]
 
 
+@pytest.mark.usefixtures('distribution_root')
 @pytest.mark.parametrize(
     ('command', 'event', 'expected_code'),
     [
@@ -716,6 +714,7 @@ def test_shell_command_checks_registered_wrapper_event(
         assert expected_code in codes
 
 
+@pytest.mark.usefixtures('distribution_root')
 @pytest.mark.parametrize(
     ('command', 'expected_code'),
     [
@@ -769,6 +768,7 @@ def test_shell_command_preserves_safe_host_diagnoses(
     assert matching[0].correction == 'Use --agent agy.'
 
 
+@pytest.mark.usefixtures('distribution_root')
 def test_stop_wrappers_report_only_unservable_native_event(tmp_path: Path) -> None:
     source = tmp_path / '.gemini/config/hooks.json'
     _write_hook_named_hooks(

{sequential_hooks-0.1.0 → sequential_hooks-0.1.1}/plugins/claude/README.md

@@ -1,7 +1,7 @@
 # Claude Code
 
-Use `sequential-hooks` for Claude Code `PreToolUse` and `PostToolUse` command hooks. Claude Code
-owns these local files:
+Use sequential-hooks for Claude Code `PreToolUse` and `PostToolUse` command hooks. Claude Code owns
+these local files:
 
 - User: `~/.claude/settings.json`.
 - Project: `.claude/settings.json`.
@@ -13,7 +13,7 @@ owns these local files:
 - Windows managed: `C:\Program Files\ClaudeCode\managed-settings.json` and JSON files in
   `C:\Program Files\ClaudeCode\managed-settings.d\`.
 
-`sequential-hooks` has no configuration file.
+sequential-hooks has no configuration file.
 
 Official references: [hooks](https://code.claude.com/docs/en/hooks) and
 [hooks guide](https://code.claude.com/docs/en/hooks-guide).