mirror of
https://github.com/imjasonh/cnotes
synced 2026-07-08 09:05:17 +00:00
7b6cdffa8a
- Added WarnAboutGitNotesLoss hook that warns before destructive git operations - Implemented comprehensive backup/restore system for conversation notes - Added CLI commands: hooks notes backup/restore/list - Configured git to automatically copy notes during rebase operations - Created backup.go with full notes backup and restoration functionality This ensures conversation context is never lost during rebasing, squashing, or other destructive git operations.
72 lines
No EOL
35 KiB
JSON
72 lines
No EOL
35 KiB
JSON
{
|
|
"backup_time": "2025-07-21T12:38:31.244162-04:00",
|
|
"notes_ref": "claude-conversations",
|
|
"notes": {
|
|
"25a9d99fb085e970bec2311245cf8b0a239b2a33": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:36:52.489529-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: git add rebase_test.txt \u0026\u0026 git commit -m \"Test commit 1 for rebase notes preservation\"\nResult: [main 25a9d99] Test commit 1 for rebase notes preservation",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
},
|
|
"30e0a3cf11c175767876259a36072374dada8b0e": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:35:13.446219-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: git commit -m \"Update documentation to reflect completed git notes integration\n\n- Added git notes integration details to CLAUDE.md architecture overview\n- Updated README.md to indicate git notes feature is fully implemented and tested\n- Added configuration examples and usage instructions\n- Documented the conversation context structure and privacy controls\n\nThe git notes feature is now production-ready and automatically working for all commits.\"\nResult: [main 30e0a3c] Update documentation to reflect completed git notes integration",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
},
|
|
"6bb1d700f26786f56b82eb03f560350b73a972f5": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:32:02.049359-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: git add test_debug6.txt \u0026\u0026 git commit -m \"Test updated git commit detection\"\nResult: [main 6bb1d70] Test updated git commit detection",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
},
|
|
"ae18ff9ea37dcc07bfaaeb5cffb5ceccaea57377": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:33:14.479028-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: git add . \u0026\u0026 git commit -m \"Complete git notes implementation with clean code\n\n- Fixed git commit detection for compound commands (using contains instead of prefix)\n- Fixed ToolResponse JSON parsing to extract stdout properly\n- Removed debug logging and test files\n- Git notes integration is now fully functional and ready for production use\"\nResult: [main ae18ff9] Complete git notes implementation with clean code",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
},
|
|
"c53a04f024dac839f1c3dc15b1dd7a8db7328edc": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:35:24.777361-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: rm -f hook_debug.log \u0026\u0026 git add -A \u0026\u0026 git commit -m \"Remove debug log file that was accidentally committed\"\nResult: [main c53a04f] Remove debug log file that was accidentally committed",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
},
|
|
"d6f6fc5ffe1a82a05761b5dfe1926648f19fadde": {
|
|
"session_id": "2696197e-6c68-419c-83fd-22cd3ee376fa",
|
|
"timestamp": "2025-07-21T12:37:05.021738-04:00",
|
|
"conversation_excerpt": "\nTool interactions:\n- Bash: command\":\"find /Users/jason/git/hooks -name \\\"*.go\\\" -o -name \\\"go.mod\\\" -o -name \\\"go.sum\\\" 2\u003e/dev/null | head -20\",\"\n- Bash: command validator\\n└── README.md\\n```\\n\\n### Core Features\\n\\n1. **Hook Handler Binary** (`main.go`):\\n - Reads JSON input from stdin\\n - Routes to appropriate handler based on hook type\\n - Returns proper exit codes or JSON responses\\n\\n2. **Install Command**:\\n - Automatically configures ~/.claude/settings.json\\n - Adds the binary to all supported hook types\\n - Validates existing configuration\\n\\n3. **Supported Hooks**:\\n - PreToolUse (with bash validation example)\\n - PostToolUse (logging)\\n - UserPromptSubmit (context injection)\\n - Stop/SubagentStop (cleanup)\\n - Notification (alerts)\\n - PreCompact (memory management)\\n\\n4. **Configuration Management**:\\n - Reads/writes Claude settings safely\\n - Preserves existing configuration\\n - Supports regex matchers for tools\\n\\n5. **Example Validators**:\\n - Bash command validator (blocks dangerous commands)\\n - File path validator\\n - Git operation validator\\n\\n### Implementation Details\\n\\n- Uses cobra for CLI commands\\n- JSON marshaling/unmarshaling for hook I/O\\n- Structured logging with slog\\n- Configurable via environment variables\\n- Supports both exit code and JSON response methods\\n\\n### Install Process\\nRunning `hooks install` will:\\n1. Build the binary if needed\\n2. Add entries to ~/.claude/settings.json\\n3. Configure all hook types to use the binary\\n4. Validate the configuration\\n\\nWould you like me to proceed with implementing this structure?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\\") || strings.Contains(path, \\\"[REDACTED] {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Cannot edit sensitive files\\\",\\n }, nil\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n}\\n```\\n\\n**Running:**\\n```bash\\n# Install hooks to Claude settings\\nhooks install\\n\\n# Run manually for testing\\necho '{\\\"event\\\": \\\"pre_tool_use\\\", ...}' | hooks run\\n\\n# Debug mode\\nhooks run --debug\\n```\\n\\nWould you like me to proceed with this implementation?\"}}],\"stop_reason\":null,\"stop_sequence\":null,\"usage\":{\"input_[REDACTED]\n- Bash: commands\\n func ValidateBashCommand(ctx context.Context, input HookInput) (HookOutput, error) {\\n if input.Tool == \\\"Bash\\\" {\\n cmd := input.ToolUseRequest.Parameters[\\\"command\\\"]\\n if strings.Contains(cmd, \\\"rm -rf /\\\") {\\n return HookOutput{\\n Decision: \\\"block\\\",\\n Reason: \\\"Dangerous command detected\\\",\\n }, nil\\n }\\n }\\n return HookOutput{Decision: \\\"continue\\\"}, nil\\n }\\n ```\\n\\n3. **Install Command**:\\n - Auto-configures ~/.claude/settings.json\\n - Sets up all hook types with proper matchers\\n - Preserves existing settings\\n\\n4. **Built-in Hooks**:\\n - Bash command validator\\n - Git operation logger\\n - Context injector for prompts\\n - Tool usage analytics\\n\\n5. **Developer-Friendly Features**:\\n - Context propagation\\n - Structured logging with slog\\n - Test helpers for hook functions\\n - Debug mode with detailed output\\n\\n### Usage Examples\\n\\n**Adding a new hook:**\\n```go\\n// internal/handlers/custom.go\\nfunc init() {\\n RegisterHook(\\\"pre_tool_use\\\", \\\"Write|Edit\\\", PreventSensitiveFileEdits)\\n}\\n\\nfunc PreventSensitiveFileEdits(ctx context.Context, input HookInput) (HookOutput, error) {\\n path := input.ToolUseRequest.Parameters[\\\"file_path\\\"]\\n if strings.Contains(path, \\\".env\\...",
|
|
"tools_used": [
|
|
"Bash",
|
|
"File"
|
|
],
|
|
"commit_context": "Git command: git add rebase_test.txt \u0026\u0026 git commit -m \"Test commit 2 for rebase notes preservation\"\nResult: [main d6f6fc5] Test commit 2 for rebase notes preservation",
|
|
"claude_version": "claude-sonnet-4-20250514"
|
|
}
|
|
}
|
|
} |