sequential-hooks 0.1.0__py3-none-any.whl

sequential_hooks-0.1.0.dist-info/METADATA

@@ -0,0 +1,90 @@
+Metadata-Version: 2.5
+Name: sequential-hooks
+Version: 0.1.0
+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.
+
+## Quick start
+
+`sequential-hooks` requires native CPython 3.13 or newer and `uv`. The project is not published to
+a package index. Install the current checkout from the repository root:
+
+```text
+uv tool install .
+```
+
+To update an existing installation after pulling changes:
+
+```text
+uv tool install --reinstall .
+```
+
+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 the recorded host versions 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 needs
+action. 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 defsort hook --agent codex -- docwrap 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.
+
+Continue with the [documentation map](docs/README.md), [concepts](docs/concepts.md),
+[security](docs/security.md), or the [CLI reference](docs/reference/cli.md).

sequential_hooks-0.1.0.dist-info/RECORD

@@ -0,0 +1,43 @@
+plugins/agy/_sequential_hooks/__init__.py,sha256=dTZEBtKRD1GdzsT0AubMMAMGhlIQMnOn4swM9D0VyZE,62
+plugins/agy/_sequential_hooks/_adapter.py,sha256=zCECOdL9YMHnbCzaKgyCp5pMu91fSf0xpaDflAqF_Rs,20446
+plugins/agy/_sequential_hooks/_doctor.py,sha256=EQPL9MSWrkFAUm_HrQgf6UjQq55mj60dH6rorykbutQ,14254
+plugins/claude/_sequential_hooks/__init__.py,sha256=dIMnFvBrwcPQUq0FOBSLgMbunMP-8zEsFTfUliDVqWs,62
+plugins/claude/_sequential_hooks/_adapter.py,sha256=_PXH-A0IPdBQdgd_Q42wwVvMfA9E-2EMp_MSL9Q_CXw,21881
+plugins/claude/_sequential_hooks/_doctor.py,sha256=p9wICT-yIfU7uJwqzqx1xjxplhTKbRpoyu_xHZYOdTk,15918
+plugins/codex/_sequential_hooks/__init__.py,sha256=njF3GC_YmuV9Fb2u58CxiEBF_z5EkWACmG1iN5kxKx0,56
+plugins/codex/_sequential_hooks/_adapter.py,sha256=_jxyUIbdDZgcf64ogmbwODJTpKRmg-3oFGFdx6Difgg,18231
+plugins/codex/_sequential_hooks/_doctor.py,sha256=VYakEFwohFo39o_kKlJxqJdorfLc1_sBNAPdFHESZgg,19674
+sequential_hooks/__init__.py,sha256=maAJHO80HHqUBX7xVjQTjCrT824X5aDMv5S69CIb6wk,93
+sequential_hooks/__main__.py,sha256=yPZGGOOECze1PH9D_ood5Q-VbwLf2Jc1iUalCIf1RkI,123
+sequential_hooks/_arguments.py,sha256=F-AXpYqwjPXM1cD14Lk3JchD0iXt9JCaJuaQbT7amBo,7599
+sequential_hooks/_cleanup.py,sha256=GGItNX8CuG9mLhk4bzwE_78RyHctt6_4pWiX7gt0LE4,2716
+sequential_hooks/_cli.py,sha256=nCTe5US2v7o7NX8jFQ12le40TslZwGM7enoasr6adX0,14653
+sequential_hooks/_diagnostics.py,sha256=Os57us1DrY1P5mtwgiVCyMU_pwesnR3gCAzs1wM_uew,9940
+sequential_hooks/_downstream.py,sha256=8UYwf93nH8cI8Y6boV6VbA2tD3YIIyLVVWzjzR0GnCo,5738
+sequential_hooks/_executable.py,sha256=uGdAJWnsNV55PYy7h8AAf84jUWwbqo2-ty15zo9zhTM,6650
+sequential_hooks/_executor.py,sha256=mM6r5cgUzrLdlKNnvsbepKD8hzUYGJIS7V43kwdF9H0,29527
+sequential_hooks/_registry.py,sha256=fKpi5si268IIhrkfcxfvwqFpxpupM_JcyKvTsac9hI4,3410
+sequential_hooks/_runner.py,sha256=KJrYk8P7i2wArix41npWYx7D8nug4eg41XqPZnwrS8Y,1552
+sequential_hooks/_types.py,sha256=UrAsFkX-APOHoUqtW8z00IKbodjKwCIuURJUItjPgVg,3913
+sequential_hooks/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sequential_hooks/_containment/__init__.py,sha256=bQ7Y2XSUsFAlaB3zMgZxfC4_IVDrUcm0S78O7bzclWo,12775
+sequential_hooks/_containment/_posix.py,sha256=4VSdVglTD_Hk45BWuX91N_SgVlHVIqy7kFHsFXmvUFc,8400
+sequential_hooks/_containment/_uncontained.py,sha256=eTu_iJY9UlK2qZnNVX6PE_nqrjMeGzP9Z_9TC8CqnFI,8302
+sequential_hooks/_containment/_windows.py,sha256=yTzbE7GdFo-bexiUXvhj-zaXsgpeduGcEs0_3UJiLBg,31911
+sequential_hooks/_containment/_windows_api.py,sha256=-StOe2kW_3woUTa4WDM0VqTAWscMK9D3VGJ_negj_PI,21317
+sequential_hooks/_containment/_windows_launcher.py,sha256=TnbzPWHLq2SZpU7O6jDSHy35njOrZfKDQOR3Ki4QwDg,6118
+sequential_hooks/_doctor/__init__.py,sha256=x1sfp36ZpfxFxEfqta79p-HLqy48zX6b9tsVXzUjppQ,11627
+sequential_hooks/_doctor/_command.py,sha256=P1X7pKOxaG9_j9mIW9r7kzJsoKlwFBJdw8DMyJvYTT0,15413
+sequential_hooks/_doctor/_common.py,sha256=9s1GO0FIwcuzaQDoBDWWC8Ebg2FsnhI0Ori8AiezAbI,16068
+sequential_hooks/_doctor/_types.py,sha256=YlQZ8B4AWvduJisKV0EkXPX-GCk26Zmt07ETnVgafWE,3159
+sequential_hooks/hosts/__init__.py,sha256=mg6fJlX7u_a0iuGJIoFyhsUqa1_siJlVlPYELPJZi2E,2972
+sequential_hooks/hosts/_contract.py,sha256=0yWNs3GoY_eWKSjZZq8yAQlk9u4qX6dy6V1kevQ3ywg,11668
+sequential_hooks/hosts/_inspection.py,sha256=WEcnmxQvkjl0RzNguUoaUpwKqUilO8ic3Sn9XZIW1QQ,2182
+sequential_hooks/hosts/_json.py,sha256=r1Ftdz37p9xCyoOdl0kWo0uOS0SS01qqB7BbcWVUXoY,5043
+sequential_hooks/hosts/_records.py,sha256=lXzma2dVYGaqi_Vs1K8XC4OJb07Ul1jAyIe0RVbrDuk,8603
+sequential_hooks/hosts/_skeleton.py,sha256=NsjE4Ir_500ADWFinvEARaUUvj7nuR239z-UjgMFulE,50099
+sequential_hooks-0.1.0.dist-info/METADATA,sha256=MX6yCesC8uyIup6QZY4SKQ-o9BHsIezRHc955g3w-1c,3945
+sequential_hooks-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+sequential_hooks-0.1.0.dist-info/entry_points.txt,sha256=hAcwzypfWMMR32w83xbeW5DewPBDOvBzIgplgb-s8OQ,264
+sequential_hooks-0.1.0.dist-info/licenses/LICENSE,sha256=jD2joRxV1aM8CIHIK8QG-GWX5Q0z9lrzH_WpBAfruBY,1085
+sequential_hooks-0.1.0.dist-info/RECORD,,

sequential_hooks-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

sequential_hooks-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,7 @@
+[console_scripts]
+sequential-hooks = sequential_hooks._cli:main
+
+[sequential_hooks.hosts]
+agy = plugins.agy._sequential_hooks._adapter:AgyHost
+claude = plugins.claude._sequential_hooks._adapter:ClaudeHost
+codex = plugins.codex._sequential_hooks._adapter:CodexHost

sequential_hooks-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 the sequential-hooks authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.