docwrap 0.1.0__tar.gz → 0.2.0__tar.gz

{docwrap-0.1.0 → docwrap-0.2.0}/.gitignore

@@ -24,6 +24,7 @@ ENV/
 *.spec
 
 # Unit test / coverage reports
+.hypothesis/
 htmlcov/
 .tox/
 .nox/

{docwrap-0.1.0 → docwrap-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: docwrap
-Version: 0.1.0
+Version: 0.2.0
 Summary: Wrap Python docstrings with support for Google, NumPy, and Sphinx styles
 Project-URL: Documentation, https://github.com/dactylo/docwrap/tree/main/docs
 Project-URL: Homepage, https://github.com/dactylo/docwrap
@@ -19,24 +19,22 @@ Description-Content-Type: text/markdown
 
 # docwrap
 
-[![CI](https://github.com/dactylo/docwrap/actions/workflows/ci.yml/badge.svg)](https://github.com/dactylo/docwrap/actions/workflows/ci.yml)
-
-Docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
+docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
 deterministic, with controls for line length, paragraph reflow, and summary placement. It supports
 Google, NumPy, and Sphinx/reST conventions.
 
 Run `docwrap` to see which docstrings would change across your project:
 
-![docwrap summary of six Python files, with 10 of 32 docstrings requiring wrapping](images/docwrap-summary.png)
+![docwrap summary of six Python files, with 10 of 32 docstrings requiring wrapping](https://raw.githubusercontent.com/dactylo/docwrap/v0.2.0/images/docwrap-summary.png)
 
 Then use `docwrap --preview` to compare the original and proposed formatting. For example, using
 the default 79-column limit:
 
-![docwrap preview showing prose and an argument description before and after reflow](images/docwrap-preview.png)
+![docwrap preview showing prose and an argument description before and after reflow](https://raw.githubusercontent.com/dactylo/docwrap/v0.2.0/images/docwrap-preview.png)
 
 ## Installation
 
-Docwrap requires CPython 3.13 or later. From a checkout, install the command with
+docwrap requires CPython 3.13 or later. From a checkout, install the command with
 [uv](https://docs.astral.sh/uv/):
 
 ```bash
@@ -78,17 +76,17 @@ line-length = 88
 ```
 
 Configuration is discovered from each file's `pyproject.toml`. The
-[wrapping policy guide](docs/design.md#choosing-a-wrapping-policy) explains the tradeoffs between
-reflowing prose and preserving authored layout. See the [CLI reference](docs/cli.md) for output
+[wrapping policy guide](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/design.md#choosing-a-wrapping-policy) explains the tradeoffs between
+reflowing prose and preserving authored layout. See the [CLI reference](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/cli.md) for output
 modes, configuration precedence, and advanced options.
 
 ## Integrations and library use
 
 A local [pre-commit](https://pre-commit.com/) hook can run docwrap when you commit. See the
-[pre-commit setup](docs/hook.md#pre-commit) for a writing hook and its report-only variant. Agent
+[pre-commit setup](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/hook.md#pre-commit) for a writing hook and its report-only variant. Agent
 hooks for Claude Code, Codex, and Antigravity can run before commits or after edits. Their
 installation, host settings, commit behavior, and composition limits are in the
-[agent hook guide](docs/hook.md).
+[agent hook guide](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/hook.md).
 
 For Python callers, `wrap_source()` returns rewritten source, `check()` reports whether it would
 change, and `wrap_source_report()` supplies structured results:
@@ -101,21 +99,23 @@ result = docwrap.check(source)
 wrapped = docwrap.wrap_source(source)
 ```
 
-See the [library reference](docs/library.md) for file operations, configuration, result types, and
+See the [library reference](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/library.md) for file operations, configuration, result types, and
 safety skips.
 
 ## Documentation
 
-- [CLI reference](docs/cli.md): commands, output, configuration, and exit codes.
-- [Agent hook guide](docs/hook.md): setup, commit handling, and host responses.
-- [Incremental mode](docs/incremental.md): wrap only changed files or definitions.
-- [Library reference](docs/library.md): supported Python API and result contracts.
-- [Concepts and safety](docs/design.md): styles, wrapping choices, and preservation rules.
-- [Platform compatibility](docs/platform.md): supported environments and file behavior.
+| If you want to...                                      | Read                                       |
+| ------------------------------------------------------ | ------------------------------------------ |
+| Look up commands, output, configuration, or exit codes | [CLI reference](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/cli.md)               |
+| Set up agent hooks, commit handling, or host responses | [Agent hook guide](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/hook.md)           |
+| Wrap only changed files or definitions                 | [Incremental mode](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/incremental.md)    |
+| Call docwrap from Python                               | [Library reference](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/library.md)       |
+| Choose a style and understand what docwrap preserves   | [Concepts and safety](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/design.md)      |
+| Check supported environments and file behavior         | [Platform compatibility](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/platform.md) |
 
 ## Development
 
-See the [development guide](docs/development.md) for pinned CI dependencies and lock updates.
+See the [development guide](https://github.com/dactylo/docwrap/blob/v0.2.0/docs/development.md) for pinned CI dependencies and lock updates.
 
 From the checkout, run `make check` for repository checks. Run `make format` to apply the
 repository's formatters. The Makefile also provides `make install`, `make reinstall`, and
@@ -123,4 +123,4 @@ repository's formatters. The Makefile also provides `make install`, `make reinst
 
 ## License
 
-Docwrap is available under the [MIT License](LICENSE).
+docwrap is available under the [MIT License](https://github.com/dactylo/docwrap/blob/v0.2.0/LICENSE).

{docwrap-0.1.0 → docwrap-0.2.0}/README.md

@@ -1,8 +1,6 @@
 # docwrap
 
-[![CI](https://github.com/dactylo/docwrap/actions/workflows/ci.yml/badge.svg)](https://github.com/dactylo/docwrap/actions/workflows/ci.yml)
-
-Docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
+docwrap applies configurable formatting rules to Python docstrings. It makes wrapping and layout
 deterministic, with controls for line length, paragraph reflow, and summary placement. It supports
 Google, NumPy, and Sphinx/reST conventions.
 
@@ -17,7 +15,7 @@ the default 79-column limit:
 
 ## Installation
 
-Docwrap requires CPython 3.13 or later. From a checkout, install the command with
+docwrap requires CPython 3.13 or later. From a checkout, install the command with
 [uv](https://docs.astral.sh/uv/):
 
 ```bash
@@ -87,12 +85,14 @@ safety skips.
 
 ## Documentation
 
-- [CLI reference](docs/cli.md): commands, output, configuration, and exit codes.
-- [Agent hook guide](docs/hook.md): setup, commit handling, and host responses.
-- [Incremental mode](docs/incremental.md): wrap only changed files or definitions.
-- [Library reference](docs/library.md): supported Python API and result contracts.
-- [Concepts and safety](docs/design.md): styles, wrapping choices, and preservation rules.
-- [Platform compatibility](docs/platform.md): supported environments and file behavior.
+| If you want to...                                      | Read                                       |
+| ------------------------------------------------------ | ------------------------------------------ |
+| Look up commands, output, configuration, or exit codes | [CLI reference](docs/cli.md)               |
+| Set up agent hooks, commit handling, or host responses | [Agent hook guide](docs/hook.md)           |
+| Wrap only changed files or definitions                 | [Incremental mode](docs/incremental.md)    |
+| Call docwrap from Python                               | [Library reference](docs/library.md)       |
+| Choose a style and understand what docwrap preserves   | [Concepts and safety](docs/design.md)      |
+| Check supported environments and file behavior         | [Platform compatibility](docs/platform.md) |
 
 ## Development
 
@@ -104,4 +104,4 @@ repository's formatters. The Makefile also provides `make install`, `make reinst
 
 ## License
 
-Docwrap is available under the [MIT License](LICENSE).
+docwrap is available under the [MIT License](LICENSE).

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/agy/tests/test_agy_adapter.py

@@ -8,7 +8,7 @@ from typing import Literal
 
 import pytest
 
-from docwrap._cli import _build_hook_parser
+from docwrap._hook_front import _build_hook_parser
 from docwrap._hosts import load_adapter
 from docwrap.hooks import API_VERSION, HookAdapter, HookResult, HostInput, HostResponse
 from plugins.agy._docwrap._adapter import AntigravityAdapter

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/claude/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "docwrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install the docwrap commit-time docstring wrapping hook for Claude Code.",
   "author": {
     "name": "docwrap contributors"

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/claude/_docwrap/_adapter.py

@@ -36,11 +36,16 @@ def _permission_deny(reason: str, stderr_prefix: str = '') -> HostResponse:
 
 
 class ClaudeAdapter:
-    """Translate Claude Code `PreToolUse` and `PostToolUse` payloads."""
+    """Translate Claude Code `PreToolUse` and `PostToolUse` payloads.
+
+    Call `parse()` before `render()` on the same instance. Parsing each payload
+    replaces the event context used to choose the response format.
+    """
 
     name = 'claude'
     api_version = API_VERSION
     requires_event = False
+    _post_tool = False
 
     def parse(self, payload: Mapping[str, object], event: str | None) -> HostInput | None:
         """Read `hook_event_name`, `tool_name`, `tool_input`, and `cwd`.
@@ -58,6 +63,7 @@ class ClaudeAdapter:
             `None`.
         """
         del event
+        self._post_tool = False
         hook_event = payload.get('hook_event_name')
         tool_name = payload.get('tool_name')
         tool_input = object_field(payload, 'tool_input')
@@ -72,6 +78,7 @@ class ClaudeAdapter:
                 command_cwd,
             )
         if hook_event == 'PostToolUse':
+            self._post_tool = True
             editing = isinstance(tool_name, str) and tool_name in _EDIT_TOOLS
             path = tool_input.get('file_path') if editing else None
             paths = (path,) if isinstance(path, str) and path else ()
@@ -79,16 +86,20 @@ class ClaudeAdapter:
         return None
 
     def render(self, result: HookResult) -> HostResponse:
-        """Render allow feedback or a denial.
+        """Render feedback using the event recorded by `parse()`.
 
         Args:
             result: Decision, reason, and notes from docwrap.
 
         Returns:
-            Empty stdout for a silent allow, or one system message for allow
-            feedback; notes on stderr and exit 0. For deny, the deny JSON on
-            stdout, the reason on stderr, and exit 0.
+            For pre-tool input, empty stdout for a silent allow, a system
+            message for allow feedback, or deny JSON with the denial reason on
+            stderr. For post-tool input, distinct nonempty diagnostic lines as
+            additional context, or empty stdout when there are none.
+            Notes remain on stderr and the exit status is 0.
         """
+        if self._post_tool:
+            return _post_tool_response(result)
         notes = notes_text(result)
         if result.decision == 'deny':
             return _permission_deny(result.reason or 'docwrap denied the operation', notes)
@@ -104,3 +115,17 @@ class ClaudeAdapter:
             The deny JSON on stdout, the reason on stderr, and exit 0.
         """
         return _permission_deny(reason)
+
+
+def _post_tool_response(result: HookResult) -> HostResponse:
+    """Render distinct diagnostic lines as post-tool context."""
+    lines = '\n'.join((*result.notes, result.reason or '')).split('\n')
+    context = '\n'.join(dict.fromkeys(line for line in lines if line))
+    payload = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context,
+        },
+    }
+    stdout = f'{json.dumps(payload)}\n' if context else ''
+    return HostResponse(stdout, notes_text(result), 0)

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/claude/tests/test_claude_adapter.py

@@ -8,8 +8,7 @@ from typing import Literal
 
 import pytest
 
-from docwrap._cli import _build_hook_parser
-from docwrap._hook import run_hook
+from docwrap._hook_front import _build_hook_parser, run_hook
 from docwrap._hosts import load_adapter
 from docwrap.hooks import (
     API_VERSION,
@@ -20,9 +19,9 @@ from docwrap.hooks import (
     HostResponse,
 )
 from plugins.claude._docwrap._adapter import ClaudeAdapter
+from tests.helpers import decode_text, git_commit_all, run_setup
 
 ROOT = Path(__file__).resolve().parents[3]
-CORPUS = ROOT / 'tests' / 'data' / 'commit_classification.json'
 DENY_JSON = {
     'hookSpecificOutput': {
         'hookEventName': 'PreToolUse',
@@ -43,6 +42,8 @@ def _decision(stdout: str) -> str | None:
     if not stdout:
         return None
     data = json.loads(stdout)
+    if 'systemMessage' in data:
+        return None
     if 'hookSpecificOutput' in data:
         return str(data['hookSpecificOutput']['permissionDecision'])
     return str(data['example']['decision'])
@@ -65,39 +66,63 @@ class TestClaudeAdapter:
             False,
         )
 
-    def test_decisions_match_the_third_party_example_over_the_corpus(
+    @pytest.mark.usefixtures('example_hosts')
+    @pytest.mark.parametrize('host', ['claude', 'example'])
+    @pytest.mark.parametrize(
+        ('command', 'outcome'),
+        [
+            pytest.param('ls', 'unrelated', id='unrelated'),
+            pytest.param('git commit --future-option -m x', 'denied', id='denied'),
+            pytest.param('git commit -m x', 'wrapped', id='supported'),
+        ],
+    )
+    def test_hook_decisions_preserve_adapter_independence(
         self,
         tmp_path: Path,
-        monkeypatch: pytest.MonkeyPatch,
         capsys: pytest.CaptureFixture[str],
-        example_hosts: Path,
+        host: str,
+        command: str,
+        outcome: Literal['unrelated', 'denied', 'wrapped'],
     ) -> None:
-        del example_hosts
-        (tmp_path / 'repo').mkdir()
-        (tmp_path / ';').mkdir()
-
-        def enabled(_cwd: str | None = None) -> bool:
-            return True
-
-        monkeypatch.setattr('docwrap._hook.is_hook_enabled', enabled)
-        entries = json.loads(CORPUS.read_text(encoding='utf-8'))['entries']
-        for entry in entries:
-            payload = json.dumps(
-                _payload('PreToolUse', 'Bash', {'command': entry['command']})
-                | {'cwd': str(tmp_path)}
-            )
-            decisions = [
-                (run_hook(payload, host=host), _decision(capsys.readouterr().out))
-                for host in ('claude', 'example')
-            ]
-            assert decisions[0] == decisions[1], entry['id']
-            # This native payload establishes cwd, unlike the unknown-cwd corpus variants.
-            if (
-                entry['outcome'] != 'supported'
-                and entry.get('command_cwd', str(tmp_path)) is not None
-            ):
-                expected = 'deny' if entry['outcome'] == 'unsupported' else None
-                assert decisions[0] == (0, expected), entry['id']
+        run_setup(['git', 'init'], cwd=tmp_path)
+        run_setup(['git', 'config', 'docwrap.hook', 'true'], cwd=tmp_path)
+        (tmp_path / 'pyproject.toml').write_text(
+            '[tool.docwrap]\nline-length = 40\nfill-style = "greedy"\n', encoding='utf-8'
+        )
+        target = tmp_path / 'sample.py'
+        target.write_text('pass\n', encoding='utf-8')
+        git_commit_all(tmp_path)
+        source = (
+            'def f():\n    """Summary.\n\n'
+            '    one two three four five six seven eight nine ten eleven twelve\n'
+            '    """\n'
+        )
+        target.write_text(source, encoding='utf-8')
+        run_setup(['git', 'add', 'sample.py'], cwd=tmp_path)
+        payload = json.dumps(
+            _payload('PreToolUse', 'Bash', {'command': command}) | {'cwd': str(tmp_path)}
+        )
+
+        status = run_hook(payload, host=host)
+
+        captured = capsys.readouterr()
+        expected_decision = 'deny' if outcome == 'denied' else None
+        assert (status, _decision(captured.out)) == (0, expected_decision)
+        if expected_decision == 'deny':
+            assert 'unsupported commit command' in captured.err
+        else:
+            assert captured.err == ''
+        expected = (
+            'def f():\n    """Summary.\n\n'
+            '    one two three four five six seven\n'
+            '    eight nine ten eleven twelve\n'
+            '    """\n'
+            if outcome == 'wrapped'
+            else source
+        )
+        staged = run_setup(['git', 'show', ':sample.py'], cwd=tmp_path)
+        assert decode_text(staged.stdout) == expected
+        assert target.read_text(encoding='utf-8') == expected
 
     def test_parse_missing_cwd_uses_process_directory(
         self, tmp_path: Path, monkeypatch: pytest.MonkeyPatch
@@ -169,6 +194,40 @@ class TestClaudeAdapter:
         assert response.stderr == 'docwrap: reason\n'
         assert response.exit_code == 0
 
+    @pytest.mark.parametrize(
+        ('reason', 'notes', 'context'),
+        [
+            (None, ('Cannot preserve layout.',), 'Cannot preserve layout.'),
+            ('Cannot wrap a.py: invalid syntax.', (), 'Cannot wrap a.py: invalid syntax.'),
+            ('first\nsecond', ('first', 'diagnostic'), 'first\ndiagnostic\nsecond'),
+        ],
+    )
+    def test_render_post_tool_context(
+        self, reason: str | None, notes: tuple[str, ...], context: str
+    ) -> None:
+        adapter = ClaudeAdapter()
+        assert adapter.parse(_payload('PostToolUse', 'Edit', {'file_path': 'a.py'}), None)
+        response = adapter.render(_result('allow', reason, notes))
+        assert json.loads(response.stdout) == {
+            'hookSpecificOutput': {
+                'hookEventName': 'PostToolUse',
+                'additionalContext': context,
+            }
+        }
+        assert response.stderr == ''.join(f'{note}\n' for note in notes)
+        assert response.exit_code == 0
+
+    @pytest.mark.parametrize('event', ['PreToolUse', 'Notification', None])
+    def test_render_resets_post_tool_context(self, event: str | None) -> None:
+        adapter = ClaudeAdapter()
+        adapter.parse(_payload('PostToolUse', 'Edit', {'file_path': 'a.py'}), None)
+        assert adapter.render(_result('allow')) == HostResponse('', '', 0)
+        adapter.parse({'hook_event_name': event}, None)
+        response = adapter.render(_result('deny', 'docwrap: reason'))
+        assert json.loads(response.stdout) == DENY_JSON
+        receipt = adapter.render(_result('allow', 'staged rewrite receipt'))
+        assert json.loads(receipt.stdout) == {'systemMessage': 'staged rewrite receipt'}
+
 
 @pytest.mark.usefixtures('registered_hosts')
 def test_native_manifest_command_loads_this_adapter() -> None:

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "docwrap",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Install the docwrap commit-time docstring wrapping hook for Codex.",
   "author": {
     "name": "docwrap contributors"

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/codex/_docwrap/_adapter.py

@@ -54,11 +54,16 @@ def _permission_deny(reason: str, stderr_prefix: str = '') -> HostResponse:
 
 
 class CodexAdapter:
-    """Translate Codex `PreToolUse` and `PostToolUse` payloads."""
+    """Translate Codex PreToolUse and PostToolUse payloads.
+
+    Call `parse()` before `render()` on the same instance. Parsing each payload
+    replaces the event context used to choose the response format.
+    """
 
     name = 'codex'
     api_version = API_VERSION
     requires_event = False
+    _post_tool = False
 
     def parse(self, payload: Mapping[str, object], event: str | None) -> HostInput | None:
         """Read `hook_event_name`, `tool_name`, `tool_input`, and `cwd`.
@@ -76,6 +81,7 @@ class CodexAdapter:
             `None`. Post-tool paths come from the `apply_patch` command text.
         """
         del event
+        self._post_tool = False
         hook_event = payload.get('hook_event_name')
         tool_name = payload.get('tool_name')
         tool_input = object_field(payload, 'tool_input')
@@ -84,22 +90,27 @@ class CodexAdapter:
             command = tool_input.get('command') if tool_name == 'Bash' else None
             return HostInput('pre_tool', command if isinstance(command, str) else None, cwd, None)
         if hook_event == 'PostToolUse':
+            self._post_tool = True
             command = tool_input.get('command') if tool_name == _EDIT_TOOL else None
             paths = _apply_patch_paths(command) if isinstance(command, str) else ()
             return HostInput('post_tool', None, cwd, None, paths)
         return None
 
     def render(self, result: HookResult) -> HostResponse:
-        """Render allow feedback or a denial.
+        """Render feedback using the event recorded by `parse()`.
 
         Args:
             result: Decision, reason, and notes from docwrap.
 
         Returns:
-            Empty stdout for a silent allow, or one system message for allow
-            feedback; notes on stderr and exit 0. For deny, the deny JSON on
-            stdout, the reason on stderr, and exit 0.
+            For pre-tool input, empty stdout for a silent allow, a system
+            message for allow feedback, or deny JSON with the denial reason on
+            stderr. For post-tool input, distinct nonempty diagnostic lines as
+            additional context, or empty stdout when there are none.
+            Notes remain on stderr and the exit status is 0.
         """
+        if self._post_tool:
+            return _post_tool_response(result)
         notes = notes_text(result)
         if result.decision == 'deny':
             return _permission_deny(result.reason or 'docwrap denied the operation', notes)
@@ -115,3 +126,17 @@ class CodexAdapter:
             The deny JSON on stdout, the reason on stderr, and exit 0.
         """
         return _permission_deny(reason)
+
+
+def _post_tool_response(result: HookResult) -> HostResponse:
+    """Render distinct diagnostic lines as post-tool context."""
+    lines = '\n'.join((*result.notes, result.reason or '')).split('\n')
+    context = '\n'.join(dict.fromkeys(line for line in lines if line))
+    payload = {
+        'hookSpecificOutput': {
+            'hookEventName': 'PostToolUse',
+            'additionalContext': context,
+        },
+    }
+    stdout = f'{json.dumps(payload)}\n' if context else ''
+    return HostResponse(stdout, notes_text(result), 0)

{docwrap-0.1.0 → docwrap-0.2.0}/plugins/codex/tests/test_codex_adapter.py

@@ -8,7 +8,7 @@ from typing import Literal
 
 import pytest
 
-from docwrap._cli import _build_hook_parser
+from docwrap._hook_front import _build_hook_parser
 from docwrap._hosts import load_adapter
 from docwrap.hooks import API_VERSION, HookAdapter, HookResult, HostInput, HostResponse
 from plugins.codex._docwrap._adapter import CodexAdapter
@@ -71,6 +71,41 @@ class TestCodexAdapter:
         assert json.loads(response.stdout) == DENY_JSON
         assert (response.stderr, response.exit_code) == ('docwrap: reason\n', 0)
 
+    @pytest.mark.parametrize(
+        ('reason', 'notes', 'context'),
+        [
+            (None, ('Cannot preserve layout.',), 'Cannot preserve layout.'),
+            ('Cannot wrap a.py: invalid syntax.', (), 'Cannot wrap a.py: invalid syntax.'),
+            ('first\nsecond', ('first', 'diagnostic'), 'first\ndiagnostic\nsecond'),
+        ],
+    )
+    def test_render_post_tool_context(
+        self, reason: str | None, notes: tuple[str, ...], context: str
+    ) -> None:
+        adapter = CodexAdapter()
+        payload = _payload('PostToolUse', 'apply_patch', {'command': '*** Update File: a.py\n'})
+        assert adapter.parse(payload, None)
+        response = adapter.render(_result('allow', reason, notes))
+        assert json.loads(response.stdout) == {
+            'hookSpecificOutput': {
+                'hookEventName': 'PostToolUse',
+                'additionalContext': context,
+            }
+        }
+        assert response.stderr == ''.join(f'{note}\n' for note in notes)
+        assert response.exit_code == 0
+
+    @pytest.mark.parametrize('event', ['PreToolUse', 'Notification', None])
+    def test_render_resets_post_tool_context(self, event: str | None) -> None:
+        adapter = CodexAdapter()
+        adapter.parse(_payload('PostToolUse', 'apply_patch', {}), None)
+        assert adapter.render(_result('allow')) == HostResponse('', '', 0)
+        adapter.parse({'hook_event_name': event}, None)
+        response = adapter.render(_result('deny', 'docwrap: reason'))
+        assert json.loads(response.stdout) == DENY_JSON
+        receipt = adapter.render(_result('allow', 'staged rewrite receipt'))
+        assert json.loads(receipt.stdout) == {'systemMessage': 'staged rewrite receipt'}
+
 
 @dataclass(frozen=True)
 class _Result: