feat(claudecode): set a 60s timeout on the local-dev SessionEnd hook

The local-dev launcher (scripts/entire-dev) builds the CLI from source, so
the SessionEnd hook can exceed Claude Code's short default exit-grace and get
cancelled before it runs. An explicit timeout makes Claude Code wait for it.

Scoped to local-dev SessionEnd only: production hooks and all other hooks keep
Claude Code's default.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Entire-Checkpoint: 01KY9SWD2PDPSHCK821DBQ8WXH

Author: gtrrz-victor

cmd/entire/cli/agent/claudecode/hooks.go

@@ -60,6 +60,13 @@ const metadataDenyRule = "Read(./.entire/metadata/**)"
 // repository root when it runs hooks.
 const localDevHookCmdPrefix = "${CLAUDE_PROJECT_DIR}/scripts/entire-dev "
 
+// localDevSessionEndTimeoutSecs gives the local-dev SessionEnd hook an explicit
+// timeout (seconds) so Claude Code waits for it on exit instead of cancelling it
+// after its short default exit-grace, which the build-from-source dev launcher
+// (scripts/entire-dev) can exceed. Only set in local-dev mode; production leaves
+// Claude Code's default in place.
+const localDevSessionEndTimeoutSecs = 60
+
 // entireHookPrefixes are command prefixes that identify Entire hooks. The
 // "go run" prefix is retained so hooks installed by older versions are still
 // recognized for removal/upgrade.
@@ -168,33 +175,41 @@ func (c *ClaudeCodeAgent) InstallHooks(ctx context.Context, localDev bool, force
 
 	count := 0
 
+	// The local-dev SessionEnd hook gets an explicit timeout so Claude Code
+	// waits for it on exit; every other hook (and all production hooks) keeps
+	// Claude Code's default.
+	sessionEndTimeoutSecs := 0
+	if localDev {
+		sessionEndTimeoutSecs = localDevSessionEndTimeoutSecs
+	}
+
 	// Add hooks if they don't exist
 	if !hookCommandExists(sessionStart, sessionStartCmd) {
-		sessionStart = addHookToMatcher(sessionStart, "", sessionStartCmd)
+		sessionStart = addHookToMatcher(sessionStart, "", sessionStartCmd, 0)
 		count++
 	}
 	if !hookCommandExists(sessionEnd, sessionEndCmd) {
-		sessionEnd = addHookToMatcher(sessionEnd, "", sessionEndCmd)
+		sessionEnd = addHookToMatcher(sessionEnd, "", sessionEndCmd, sessionEndTimeoutSecs)
 		count++
 	}
 	if !hookCommandExists(stop, stopCmd) {
-		stop = addHookToMatcher(stop, "", stopCmd)
+		stop = addHookToMatcher(stop, "", stopCmd, 0)
 		count++
 	}
 	if !hookCommandExists(userPromptSubmit, userPromptSubmitCmd) {
-		userPromptSubmit = addHookToMatcher(userPromptSubmit, "", userPromptSubmitCmd)
+		userPromptSubmit = addHookToMatcher(userPromptSubmit, "", userPromptSubmitCmd, 0)
 		count++
 	}
 	if !hookCommandExistsWithMatcher(preToolUse, subagentToolMatcher, preTaskCmd) {
-		preToolUse = addHookToMatcher(preToolUse, subagentToolMatcher, preTaskCmd)
+		preToolUse = addHookToMatcher(preToolUse, subagentToolMatcher, preTaskCmd, 0)
 		count++
 	}
 	if !hookCommandExistsWithMatcher(postToolUse, subagentToolMatcher, postTaskCmd) {
-		postToolUse = addHookToMatcher(postToolUse, subagentToolMatcher, postTaskCmd)
+		postToolUse = addHookToMatcher(postToolUse, subagentToolMatcher, postTaskCmd, 0)
 		count++
 	}
 	if !hookCommandExistsWithMatcher(postToolUse, taskToolMatcher, postTodoCmd) {
-		postToolUse = addHookToMatcher(postToolUse, taskToolMatcher, postTodoCmd)
+		postToolUse = addHookToMatcher(postToolUse, taskToolMatcher, postTodoCmd, 0)
 		count++
 	}
 
@@ -545,10 +560,11 @@ func hookCommandExistsWithMatcher(matchers []ClaudeHookMatcher, matcherName, com
 	return false
 }
 
-func addHookToMatcher(matchers []ClaudeHookMatcher, matcherName, command string) []ClaudeHookMatcher {
+func addHookToMatcher(matchers []ClaudeHookMatcher, matcherName, command string, timeoutSecs int) []ClaudeHookMatcher {
 	entry := ClaudeHookEntry{
 		Type:    "command",
 		Command: command,
+		Timeout: timeoutSecs,
 	}
 
 	// If no matcher name, add to a matcher with empty string

cmd/entire/cli/agent/claudecode/hooks_test.go

@@ -467,6 +467,53 @@ func TestUninstallHooks_RemovesLocalDevHooks(t *testing.T) {
 	}
 }
 
+// TestInstallHooks_LocalDevSessionEndTimeout verifies the local-dev SessionEnd
+// hook carries an explicit timeout so Claude Code waits for it on exit instead
+// of cancelling it after its short default exit-grace. The timeout is scoped to
+// local-dev SessionEnd only: production and other local-dev hooks stay untimed.
+func TestInstallHooks_LocalDevSessionEndTimeout(t *testing.T) {
+	t.Run("local-dev SessionEnd gets the timeout", func(t *testing.T) {
+		tempDir := t.TempDir()
+		t.Chdir(tempDir)
+
+		agent := &ClaudeCodeAgent{}
+		if _, err := agent.InstallHooks(context.Background(), true, false); err != nil {
+			t.Fatalf("InstallHooks(localDev=true) error = %v", err)
+		}
+
+		settings := readClaudeSettings(t, tempDir)
+		if len(settings.Hooks.SessionEnd) == 0 || len(settings.Hooks.SessionEnd[0].Hooks) == 0 {
+			t.Fatal("expected a SessionEnd hook to be installed")
+		}
+		if got := settings.Hooks.SessionEnd[0].Hooks[0].Timeout; got != localDevSessionEndTimeoutSecs {
+			t.Errorf("local-dev SessionEnd timeout = %d, want %d", got, localDevSessionEndTimeoutSecs)
+		}
+
+		// Scoping: other local-dev hooks must not inherit the timeout.
+		if got := settings.Hooks.Stop[0].Hooks[0].Timeout; got != 0 {
+			t.Errorf("local-dev Stop timeout = %d, want 0 (timeout is SessionEnd-only)", got)
+		}
+	})
+
+	t.Run("production SessionEnd stays untimed", func(t *testing.T) {
+		tempDir := t.TempDir()
+		t.Chdir(tempDir)
+
+		agent := &ClaudeCodeAgent{}
+		if _, err := agent.InstallHooks(context.Background(), false, false); err != nil {
+			t.Fatalf("InstallHooks(localDev=false) error = %v", err)
+		}
+
+		settings := readClaudeSettings(t, tempDir)
+		if len(settings.Hooks.SessionEnd) == 0 || len(settings.Hooks.SessionEnd[0].Hooks) == 0 {
+			t.Fatal("expected a SessionEnd hook to be installed")
+		}
+		if got := settings.Hooks.SessionEnd[0].Hooks[0].Timeout; got != 0 {
+			t.Errorf("production SessionEnd timeout = %d, want 0 (dev-only)", got)
+		}
+	})
+}
+
 // readClaudeSettings reads and parses the Claude Code settings file
 func readClaudeSettings(t *testing.T, tempDir string) ClaudeSettings {
 	t.Helper()

cmd/entire/cli/agent/claudecode/types.go

@@ -27,6 +27,9 @@ type ClaudeHookMatcher struct {
 type ClaudeHookEntry struct {
 	Type    string `json:"type"`
 	Command string `json:"command"`
+	// Timeout is the hook's timeout in seconds. Omitted (0) leaves Claude Code's
+	// default in place; set only where a hook needs an explicit budget.
+	Timeout int `json:"timeout,omitempty"`
 }
 
 // sessionInfoRaw is the JSON structure from SessionStart/SessionEnd/Stop hooks.