Skip to content

Commit 113ba17

Browse files
LTSCommerceclaude
andcommitted
Upgrade hooks daemon 3.25.0 -> 3.31.1, fix removed thinking_mode handler
The upgrade removed ThinkingModeHandler from status_line handlers; drop the now-invalid handlers.status_line.thinking_mode entry from .claude/hooks-daemon.yaml so the daemon config validates cleanly. Also picks up the redeployed skill files (new upgrade subcommands: regen-docs, release-notes). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1 parent 62d3e4f commit 113ba17

3 files changed

Lines changed: 107 additions & 3 deletions

File tree

‎.claude/hooks-daemon.yaml‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -137,7 +137,6 @@ handlers:
137137
model_context: {enabled: true, priority: 10} # Model name and context %
138138
usage_tracking: {enabled: true, priority: 15} # Usage statistics
139139
git_branch: {enabled: true, priority: 20} # Current git branch
140-
thinking_mode: {enabled: true, priority: 25} # Current thinking mode
141140
startup_cleanup: {enabled: true, priority: 28} # Stale file cleanup indicator
142141
daemon_stats: {enabled: true, priority: 30} # Daemon health metrics
143142

‎.claude/skills/hooks-daemon/SKILL.md‎

Lines changed: 47 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
name: hooks-daemon
33
description: Manage Claude Code Hooks Daemon - install, upgrade, check health, restart, and develop project-level handlers
4-
argument-hint: "[install|upgrade|health|restart|check|dev-handlers|logs] [args...]"
4+
argument-hint: "[install|upgrade|health|restart|check|dev-handlers|regen-docs|logs|release-notes] [args...]"
55
disable-model-invocation: false
66
user-invocable: true
77
allowed-tools: Bash, Read, Write, Edit
@@ -48,6 +48,26 @@ The daemon caches config at startup — restart picks up any config or handler c
4848

4949
See [restart.md](restart.md) for details.
5050

51+
### Regenerate Generated Docs
52+
53+
Force-regenerate the daemon's generated documentation **without restarting**:
54+
55+
```bash
56+
/hooks-daemon regen-docs
57+
```
58+
59+
Rewrites both generated artifacts to their canonical form in one shot:
60+
61+
- `.claude/HOOKS-DAEMON.md` — the active-handler summary.
62+
- The `<hooksdaemon>` guidance block inside your project `CLAUDE.md`.
63+
64+
This is the explicit way to recover both files after a **git merge/rebase conflict**
65+
left them stale or conflict-marked — run it, then stage the clean result. (A normal
66+
`restart` also refreshes these, but `regen-docs` does it as a one-shot with no daemon
67+
bounce.)
68+
69+
See [regen-docs.md](regen-docs.md) for details.
70+
5171
### Check Health & Status
5272

5373
Verify daemon is running correctly:
@@ -98,6 +118,24 @@ The report is saved to `./untracked/hooks-daemon-{description}.md` for sharing w
98118

99119
See [report.md](report.md) for details.
100120

121+
### Read Release Notes
122+
123+
Show the daemon's release notes without leaving the terminal. With no flag it
124+
shows the notes for the version you currently have installed:
125+
126+
```bash
127+
/hooks-daemon release-notes # installed version's notes
128+
/hooks-daemon release-notes --latest # newest available version
129+
/hooks-daemon release-notes --version 3.27.0 # a specific version
130+
/hooks-daemon release-notes --from 3.20.0 --to 3.27.0 # everything you gained upgrading
131+
/hooks-daemon release-notes --list # list available versions
132+
/hooks-daemon release-notes --version 3.27.0 --format json
133+
```
134+
135+
Notes are read from the per-version `RELEASES/vX.Y.Z.md` files that ship with
136+
the install — no network access required. `--from` is exclusive and `--to` is
137+
inclusive, matching the upgrade semantics (the notes for everything you gained).
138+
101139
## Quick Start
102140

103141
After editing `.claude/hooks-daemon.yaml`:
@@ -165,7 +203,12 @@ case "$SUBCOMMAND" in
165203
cat "$SKILL_DIR/report.md" | sed "s/\$ARGUMENTS/$*/"
166204
;;
167205

168-
logs|status|restart|handlers|validate-config|bug-report|check)
206+
regen-docs|regenerate-docs)
207+
# User-facing alias regen-docs maps to the CLI command regenerate-docs.
208+
bash "$SKILL_DIR/scripts/daemon-cli.sh" regenerate-docs "$@"
209+
;;
210+
211+
logs|status|restart|handlers|validate-config|bug-report|check|release-notes)
169212
# Forward to daemon CLI wrapper
170213
bash "$SKILL_DIR/scripts/daemon-cli.sh" "$SUBCOMMAND" "$@"
171214
;;
@@ -177,6 +220,7 @@ case "$SUBCOMMAND" in
177220
echo "Available commands:"
178221
echo " install [--force] Install daemon (fresh clone)"
179222
echo " restart Restart daemon (required after config changes)"
223+
echo " regen-docs Force-regenerate HOOKS-DAEMON.md + CLAUDE.md block"
180224
echo " health Check daemon health and status"
181225
echo " upgrade [VERSION] Upgrade daemon to new version"
182226
echo " dev-handlers Scaffold new project handlers"
@@ -186,6 +230,7 @@ case "$SUBCOMMAND" in
186230
echo " check Verbose environment & configuration audit"
187231
echo " bug-report DESC Generate bug report with diagnostics"
188232
echo " report DESC Investigate an issue and generate a detailed report"
233+
echo " release-notes [opts] Show release notes (installed version by default)"
189234
echo ""
190235
echo "After editing .claude/hooks-daemon.yaml, always run: /hooks-daemon restart"
191236
echo ""
Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
# Regenerate Generated Docs
2+
3+
Force-regenerate the daemon's generated documentation to its canonical form,
4+
**without restarting the daemon**.
5+
6+
## Usage
7+
8+
```bash
9+
/hooks-daemon regen-docs
10+
```
11+
12+
## What It Regenerates
13+
14+
Two artifacts are rewritten from live config + handler metadata in one shot:
15+
16+
1. **`.claude/HOOKS-DAEMON.md`** — the active-handler summary (priorities, behaviours,
17+
per-event handler tables). Same output as `generate-docs`.
18+
2. **The `<hooksdaemon>` block in your project `CLAUDE.md`** — the active-handler
19+
guidance the daemon injects at startup. Surrounding user content is preserved;
20+
only the `<hooksdaemon>...</hooksdaemon>` section is replaced.
21+
22+
Both are written in the daemon's canonical (formatter-aligned) form, so a later
23+
edit will not produce churn diffs.
24+
25+
## When to Use
26+
27+
- **Resolving a git merge/rebase conflict** that left conflict markers or stale
28+
content inside `.claude/HOOKS-DAEMON.md` or the `CLAUDE.md` `<hooksdaemon>` block.
29+
Run `regen-docs`, then stage the clean result — the regenerated content reflects
30+
your merged `.claude/hooks-daemon.yaml`, not either conflicting side.
31+
- After hand-editing `.claude/hooks-daemon.yaml` when you want the generated docs
32+
refreshed but do **not** want to bounce the running daemon.
33+
- Any time the generated docs have drifted from the live config.
34+
35+
## regen-docs vs restart
36+
37+
| Action | Refreshes generated docs | Restarts daemon | Use when |
38+
| ------------ | ------------------------ | --------------- | --------------------------------------------- |
39+
| `regen-docs` | Yes | No | Fixing/refreshing docs only (e.g. merge fix) |
40+
| `restart` | Yes (on startup) | Yes | Applying config/handler changes to the daemon |
41+
42+
A `restart` already regenerates both artifacts on startup. `regen-docs` is the
43+
explicit one-shot when you want the doc regeneration **without** the restart.
44+
45+
## Options
46+
47+
```bash
48+
/hooks-daemon regen-docs --include-disabled # list disabled handlers in HOOKS-DAEMON.md
49+
/hooks-daemon regen-docs --output PATH # alternate HOOKS-DAEMON.md output path
50+
```
51+
52+
## Verify
53+
54+
```bash
55+
git diff -- .claude/HOOKS-DAEMON.md CLAUDE.md
56+
```
57+
58+
The diff should show only the regenerated, conflict-free content. If `CLAUDE.md`
59+
is in a git repo and was changed, the daemon auto-commits the `<hooksdaemon>`
60+
block on regeneration (only `CLAUDE.md`, no other files are touched).

0 commit comments

Comments
 (0)