docs(ghook): document statusline 0.3.1 release

Author: joshwilhelmi

CHANGELOG.md

@@ -7,6 +7,21 @@ All notable changes to gobby-cli are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] — gobby-hooks
+
+### Added
+
+#### gobby-hooks
+
+- **Claude statusline handler** — `ghook --gobby-owned --cli=claude --type=statusline` now handles Claude Code statusline ticks directly in Rust. The handler bypasses the normal enqueue-first hook dispatch path, extracts the same token-usage payload as the legacy Python statusline middleware, posts it to `/api/sessions/statusline`, and preserves downstream statusline stdout bytes without adding a newline.
+- **Statusline parity fixtures** — Added golden JSON fixtures under `crates/ghook/tests/fixtures/statusline/` so Claude statusline input-to-daemon-payload parity is machine-checkable and survives removal of the Python reference in a later Gobby-side phase.
+
+### Changed
+
+#### gobby-hooks
+
+- **Statusline failure semantics** — Malformed statusline JSON, missing `session_id`, daemon POST failures, and downstream command failures all exit successfully so Claude's statusline display is not broken by telemetry issues. Daemon POSTs use a short background worker wait, and downstream forwarding has a bounded timeout.
+
 ## [0.3.0] — gobby-hooks
 
 ### Added

docs/plans/ghook-statusline-phase1.md

@@ -0,0 +1,42 @@
+# ghook Statusline Phase 1
+
+## Scope
+
+This plan covers only the Rust-side `gobby-cli` work for Claude Code
+statusline handling. Gobby/Python installer migration, rollback bake, and
+eventual Python handler deletion are tracked outside this repository.
+
+## Implemented
+
+- `ghook --gobby-owned --cli=claude --type=statusline` is routed before the
+  generic hook enqueue/POST flow.
+- The statusline path writes downstream stdout bytes directly and does not
+  use the shared JSON hook emitter.
+- The handler extracts the Claude statusline usage payload and posts it to
+  `/api/sessions/statusline` with best-effort failure semantics.
+- The crate version is bumped to `0.3.1` so the Gobby installer can probe for
+  statusline-capable `ghook` binaries before switching statusline config.
+
+## Parity Contract
+
+Golden fixtures live in `crates/ghook/tests/fixtures/statusline/`:
+
+- `full-input.json` -> `full-payload.json`
+- `defaults-input.json` -> `defaults-payload.json`
+
+These fixtures capture the stable wire contract from Claude statusline stdin
+to the daemon payload. Missing or falsy `session_id` produces no daemon POST.
+Missing `cost`, `model`, or `context_window` fields use the same defaults as
+the legacy Python middleware.
+
+## Validation
+
+Required checks before release:
+
+- `cargo test -p gobby-hooks`
+- `cargo test -p gobby-hooks --no-default-features`
+- `cargo clippy -p gobby-hooks --all-targets -- -D warnings`
+- `cargo build --release -p gobby-hooks`
+
+Local install is intentionally out of scope. Do not copy the built artifact to
+`~/.gobby/bin/ghook` as part of this phase.