feat(cli): extract TUI hooks into typed createTUIHooks factory

[aaight]

Summary

• Extracts the ~120-line inline tuiHooks object from agent-command.ts into a new packages/cli/src/tui/tui-hooks.ts module
• Creates a createTUIHooks(options): AgentHooks factory function following the pattern in packages/llmist/src/agent/hook-presets.ts
• Replaces all any-typed hook contexts with proper types (ObserveLLMCallContext, ObserveChunkContext, ObserveLLMCompleteContext, ObserveRateLimitThrottleContext, ObserveRetryAttemptContext, GadgetExecutionControllerContext)
• Adds 30 unit tests in packages/cli/src/tui/tui-hooks.test.ts covering all observer hooks and the beforeGadgetExecution controller

Closes: https://linear.app/mongrel/issue/MNG-294

Key Decisions

• Mutable ref containers (iterationsRef, usageRef) instead of raw variables so the factory can update state the caller reads after the agent run, without returning values from the hook callbacks
• Mutable gadgetApprovals object passed by reference so "always allow"/"always deny" choices persist in the caller's map across REPL turns
• StatusBar imported directly from ./status-bar.js (not ./index.js) to avoid potential circular import issues since tui-hooks.ts lives inside the tui/ directory
• agent-command.ts retains the tuiHooks: AgentHooks local variable type annotation so the surrounding code is minimally disturbed

Test plan

• npm run typecheck passes (0 errors)
• npm run test passes (220 test files, 6569 tests)
• npm run lint (no new errors introduced; pre-existing warnings unchanged)
• All existing agent-command-tui.test.ts and agent-command-throttle.test.ts tests continue passing
• New tui-hooks.test.ts covers onLLMCallStart, onStreamChunk, onLLMCallComplete, onRateLimitThrottle, onRetryAttempt, and beforeGadgetExecution

🤖 Generated with Claude Code

🕵️ claude-code · claude-sonnet-4-6 · run details

[codecov-commenter]

⚠️ Please install the to ensure uploads and comments are reliably processed by Codecov.

Codecov Report

❌ Patch coverage is 94.61538% with 7 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
packages/cli/src/tui/tui-hooks.ts	94.06%	7 Missing ⚠️

📢 Thoughts on this report? Let us know!

[nhopeatall]

Summary

LGTM — Clean extraction of ~120 lines of inline hook logic into a typed, testable factory function. The refactoring is behavior-preserving, follows the existing HookPresets pattern, replaces all any-typed contexts with proper types, and comes with thorough test coverage (30 tests covering all hooks).

The mutable ref pattern (iterationsRef, usageRef) is a reasonable approach for sharing state between the factory's hooks and the caller. CI is green across all checks.

Nitpicks

• tui-hooks.test.ts:12 — beforeEach is imported from vitest but never used
• tui-hooks.test.ts:46 — createDefaultApprovalConfig() helper is defined but never called — dead code that can be removed

🕵️ claude-code · claude-opus-4-6 · run details