feat: release skill — add Cursor hook compatibility verification step

[itdove]

Description

Add a Cursor hook compatibility verification step to the /release skill. Since Cursor could remove Claude Code hook support in any update, each release should verify that all 4 hook events still fire correctly.

Semi-automated Flow

The /release skill handles setup and analysis. The release manager runs the manual Cursor test.

Step 1: Skill prepares the test (automated)

• Create debug hook script at /tmp/debug-hook.sh
• Add debug hook entries alongside ai-guardian hooks in ~/.claude/settings.json for all events (UserPromptSubmit, PreToolUse, PostToolUse, SessionEnd)
• Clean any old debug log files
• Print instructions for the release manager

Step 2: Release manager runs manual test

• Upgrade Cursor to latest version
• Restart Cursor
• Open a project, type a prompt that triggers a file read
• Close the chat session
• Return to the release skill

Step 3: Skill analyzes results (automated)

• Read /tmp/cursor-hook-debug-*.json files
• Verify all 4 events fired with cursor_version field:
  • beforeSubmitPrompt
  • preToolUse
  • postToolUse
  • sessionEnd
• Report PASS/FAIL per event
• Clean up debug hooks from settings.json and delete debug files
• If any event missing: FAIL with warning that Cursor may have changed hook support

Expected Output

Acceptance Criteria

• /release skill creates debug hook script automatically
• Adds debug hooks to settings.json temporarily
• Prints clear instructions for the manual Cursor test
• Analyzes debug log files and reports per-event PASS/FAIL
• Cleans up debug hooks and files after analysis
• Blocks release if any hook event fails
• Documents Cursor version tested in release notes

Files Involved

• Release skill (/.claude/skills/ or /release command)
• RELEASING.md — document Cursor verification step
• AGENTS.md — add to release checklist

Related

• feat: --ide cursor installs in .claude/settings.json (alias for --ide claude) #1186 — --ide cursor alias (Cursor uses Claude hooks)
• bug: double hook fire when Cursor reads Claude Code hooks from .claude/settings.json #1181 — Adapter auto-detection

[itdove]

Pull request created: #1216

[itdove]

✅ Session Complete

Project: ai-guardian
Goal: #1198: feat: release skill — add Cursor hook compatibility verification step
Time Spent:
0h 25m total

• dvernier: 0h 24m
• unknown: 0h 0m
  Branch: 1198

All done. Summary:

Changes made across 5 files:

1. release_helper.py — Added CursorHookVerifier class with setup(), analyze(), cleanup() methods and 3 CLI subcommands (cursor-verify-setup, cursor-verify-analyze, cursor-verify-cleanup)

2. SKILL.md — Added "Cursor Hook Compatibility Verification (mandatory)" section between Dependency Security Review and Git Operations. Updated Regular Release steps (now 12 steps) and Implementation Guidelines (now 13 steps).

3. RELEASING.md — Added Cursor verification to Pre-Release checklist and new "Cursor Hook Compatibility Verification" subsection in Release Workflow.

4. AGENTS.md — Added "Cursor hook compatibility verification" to /release skill capabilities list.

5. test_release_helper.py — Added TestCursorHookVerifier class with 12 tests covering setup, analyze, and cleanup. All 25 tests pass.

Generated by DevAIFlow

[itdove]

Pull request created: #1216

[itdove]

✅ Session Complete

Project: ai-guardian
Goal: #1198: feat: release skill — add Cursor hook compatibility verification step
Time Spent:
0h 26m total

• dvernier: 0h 25m
• unknown: 0h 0m
  Branch: 1198

The session created 1 new files and modified 5 existing files. Work included: made 13 edits, wrote 1 files, ran 13 commands.

Generated by DevAIFlow