Bump version to 0.2.0 and update documentation

Version bump:
- 0.1.1 -> 0.2.0 (new feature: cross-platform hook wrapper system)

Documentation updates:
- README.md: Add hooks directory to project structure, remove outdated test counts
- doc/architecture.md: Add cross-platform hook wrapper architecture section
  with ASCII diagram and usage examples
- CHANGELOG.md: Add 0.2.0 release notes with new features

Author: claude

CHANGELOG.md

@@ -5,6 +5,24 @@ All notable changes to DeepWork will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.2.0] - 2026-01-16
+
+### Added
+- Cross-platform hook wrapper system for writing hooks once and running on multiple platforms
+  - `wrapper.py`: Normalizes input/output between Claude Code and Gemini CLI
+  - `claude_hook.sh` and `gemini_hook.sh`: Platform-specific shell wrappers
+  - `policy_check.py`: Cross-platform policy evaluation hook
+- Platform documentation in `doc/platform/` with:
+  - Claude Code hooks reference and learnings
+  - Gemini CLI hooks reference and learnings
+  - Event mapping, tool mapping, and decision value documentation
+- 46 new tests for the hook wrapper system
+
+### Changed
+- Updated `README.md` project structure to include hooks directory
+- Updated `doc/architecture.md` with cross-platform hook wrapper documentation
+- Enhanced `src/deepwork/hooks/__init__.py` with wrapper exports and documentation
+
 ## [0.1.2] - 2026-01-15
 
 ### Added
@@ -49,6 +67,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Initial version.
 
+[0.2.0]: https://github.com/anthropics/deepwork/releases/tag/v0.2.0
 [0.1.2]: https://github.com/anthropics/deepwork/releases/tag/v0.1.2
 [0.1.1]: https://github.com/anthropics/deepwork/releases/tag/v0.1.1
 [0.1.0]: https://github.com/anthropics/deepwork/releases/tag/v0.1.0

README.md

@@ -209,14 +209,18 @@ deepwork/
 │   │   ├── parser.py     # Job definition parsing
 │   │   ├── detector.py   # Platform detection
 │   │   └── generator.py  # Skill file generation
+│   ├── hooks/            # Cross-platform hook wrappers
+│   │   ├── wrapper.py    # Input/output normalization
+│   │   ├── claude_hook.sh  # Claude Code adapter
+│   │   └── gemini_hook.sh  # Gemini CLI adapter
 │   ├── templates/        # Jinja2 templates
 │   │   ├── claude/       # Claude Code templates
 │   │   └── gemini/       # Gemini CLI templates
 │   ├── schemas/          # JSON schemas
 │   └── utils/            # Utilities (fs, yaml, git, validation)
 ├── tests/
-│   ├── unit/             # Unit tests (147 tests)
-│   ├── integration/      # Integration tests (19 tests)
+│   ├── unit/             # Unit tests
+│   ├── integration/      # Integration tests
 │   └── fixtures/         # Test fixtures
 └── doc/                  # Documentation
 ```

doc/architecture.md

@@ -48,9 +48,13 @@ deepwork/                       # DeepWork tool repository
 │       │   ├── parser.py       # Job definition parsing
 │       │   ├── policy_parser.py # Policy definition parsing
 │       │   └── hooks_syncer.py # Hook syncing to platforms
-│       ├── hooks/              # Hook evaluation modules
+│       ├── hooks/              # Hook system and cross-platform wrappers
 │       │   ├── __init__.py
-│       │   └── evaluate_policies.py  # Policy evaluation CLI
+│       │   ├── wrapper.py           # Cross-platform input/output normalization
+│       │   ├── claude_hook.sh       # Shell wrapper for Claude Code
+│       │   ├── gemini_hook.sh       # Shell wrapper for Gemini CLI
+│       │   ├── policy_check.py      # Cross-platform policy evaluation hook
+│       │   └── evaluate_policies.py # Legacy policy evaluation CLI
 │       ├── templates/          # Command templates for each platform
 │       │   ├── claude/
 │       │   │   └── command-job-step.md.jinja
@@ -1064,6 +1068,56 @@ The hooks are installed to `.claude/settings.json` during `deepwork sync`:
 }
 ```
 
+### Cross-Platform Hook Wrapper System
+
+The `hooks/` module provides a wrapper system that allows writing hooks once in Python and running them on multiple platforms. This normalizes the differences between Claude Code and Gemini CLI hook systems.
+
+**Architecture:**
+```
+┌─────────────────┐     ┌─────────────────┐
+│  Claude Code    │     │   Gemini CLI    │
+│  (Stop event)   │     │ (AfterAgent)    │
+└────────┬────────┘     └────────┬────────┘
+         │                       │
+         ▼                       ▼
+┌─────────────────┐     ┌─────────────────┐
+│ claude_hook.sh  │     │ gemini_hook.sh  │
+│ (shell wrapper) │     │ (shell wrapper) │
+└────────┬────────┘     └────────┬────────┘
+         │                       │
+         └───────────┬───────────┘
+                     ▼
+           ┌─────────────────┐
+           │   wrapper.py    │
+           │ (normalization) │
+           └────────┬────────┘
+                    ▼
+           ┌─────────────────┐
+           │  Python Hook    │
+           │ (common logic)  │
+           └─────────────────┘
+```
+
+**Key normalizations:**
+- Event names: `Stop` ↔ `AfterAgent`, `PreToolUse` ↔ `BeforeTool`, `UserPromptSubmit` ↔ `BeforeAgent`
+- Tool names: `Write` ↔ `write_file`, `Bash` ↔ `shell`, `Read` ↔ `read_file`
+- Decision values: `block` → `deny` for Gemini CLI
+- Environment variables: `CLAUDE_PROJECT_DIR` ↔ `GEMINI_PROJECT_DIR`
+
+**Usage:**
+```python
+from deepwork.hooks.wrapper import HookInput, HookOutput, run_hook, Platform
+
+def my_hook(input: HookInput) -> HookOutput:
+    if input.event == NormalizedEvent.AFTER_AGENT:
+        return HookOutput(decision="block", reason="Complete X first")
+    return HookOutput()
+
+# Called via: claude_hook.sh mymodule or gemini_hook.sh mymodule
+```
+
+See `doc/platform/` for detailed platform-specific hook documentation.
+
 ### Policy Schema
 
 Policies are validated against a JSON Schema:

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "deepwork"
-version = "0.1.2"
+version = "0.2.0"
 description = "Framework for enabling AI agents to perform complex, multi-step work tasks"
 readme = "README.md"
 requires-python = ">=3.11"