# GSE Intent Logger

A World of Warcraft companion addon for [GSE (Gnome Sequencer Enhanced)](https://www.curseforge.com/wow/addons/gnome-sequencer-enhanced) that logs macro execution intent versus actual cast results.

## What It Does

GSE Intent Logger records every button press of your GSE macros and correlates them with actual spell casts. This data helps you understand:

- Which macro steps are firing vs being rejected by the GCD
- Cast success rates per spell
- Sequence step distribution over time
- Where your macro gets stuck

## Requirements

- World of Warcraft: The War Within (12.x)
- [GSE - Gnome Sequencer Enhanced](https://www.curseforge.com/wow/addons/gnome-sequencer-enhanced)

## Optional Addon Support

- **GSE_Tracker** — Provides better sequence key naming
- **DMGAssist** — Logs recommended spell data alongside intent

## Usage

| Command | Description |
|---|---|
| `/gselogger start` | Begin recording a session |
| `/gselogger stop` | Stop recording and save |
| `/gselogger export` | Open export GUI (tabbed, one tab per session) |
| `/gselogger stats` | View session statistics |
| `/gselogger status` | Show hook and session state |
| `/gselogger clear` | Delete all saved sessions |
| `/gselogger rescan` | Re-scan for GSE buttons |
| `/gselogger debug` | Detailed debug info |

## Export Format

The export GUI provides copy-paste text per session. Each session contains a header block followed by CSV event lines:

```
time_offset, block_idx, block_type, intended_id, intended_name, success, actual_id, gcd_remaining
```

Paste the exported text into the [GSE Forge](https://gseforge.com) web tool for visualization and analysis.

## Installation

Download from [CurseForge](https://www.curseforge.com/wow/addons/gse-intent-logger) or copy the `GSEIntentLogger` folder into your `Interface/AddOns/` directory.

## How It Works

1. **Intent Tracking** — Hooks GSE button PostClick events to read which spell the macro intended to cast
2. **Cast Correlation** — Listens to `UNIT_SPELLCAST_SUCCEEDED` and correlates actual casts back to intents within a 1.5s window
3. **Safe Hooking** — PostClick only (no PreClick), no taint risk, protected by pcall

## License

MIT
gseintendlogger
