{"id":29677226,"url":"https://github.com/djdefi/healiq","last_synced_at":"2025-08-23T19:20:37.861Z","repository":{"id":303911238,"uuid":"1017114247","full_name":"djdefi/healiq","owner":"djdefi","description":"HealIQ - Resto Druid smart healer suggestion addon for WoW retail","archived":false,"fork":false,"pushed_at":"2025-08-15T18:30:49.000Z","size":665,"stargazers_count":1,"open_issues_count":7,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-15T20:38:23.794Z","etag":null,"topics":["wowaddon","wowaddons"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/djdefi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-10T03:49:59.000Z","updated_at":"2025-08-01T21:25:13.000Z","dependencies_parsed_at":"2025-07-10T13:12:31.165Z","dependency_job_id":"9f5a1df4-a985-45bd-bec7-e0078761f0a3","html_url":"https://github.com/djdefi/healiq","commit_stats":null,"previous_names":["djdefi/healiq"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/djdefi/healiq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djdefi%2Fhealiq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djdefi%2Fhealiq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djdefi%2Fhealiq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djdefi%2Fhealiq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/djdefi","download_url":"https://codeload.github.com/djdefi/healiq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/djdefi%2Fhealiq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271766302,"owners_count":24817538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-23T02:00:09.327Z","response_time":69,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["wowaddon","wowaddons"],"created_at":"2025-07-23T00:34:53.562Z","updated_at":"2025-08-23T19:20:37.839Z","avatar_url":"https://github.com/djdefi.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# HealIQ\n\n**HealIQ** is a smart spell suggestion addon for Restoration Druids in World of Warcraft. It helps you prioritize your next healing spell based on current combat context, active HoTs, procs, and cooldowns.\n\n## 🧠 What It Does\n\n- Displays optimal healing spell suggestions based on Wowhead Restoration Druid guide\n- Tracks HoT durations (e.g. Lifebloom, Rejuvenation)\n- Recognizes Clearcasting procs and emergency situations\n- Shows Swiftmend combo opportunities and AoE healing priorities\n- Alerts for cooldown-based healing (e.g. Wild Growth, Tranquility)\n- Supports movement and configuration of suggestion UI\n- Shows upcoming suggestions in a queue display\n- Provides extensive strategy customization options\n\n**Enhanced Strategy Features:**\n- Efflorescence maintenance prioritization\n- Smart Lifebloom tank management with bloom timing\n- Clearcasting proc optimization\n- Swiftmend + Wild Growth combo suggestions\n- Grove Guardians charge pooling\n- Wrath filler for mana restoration\n- Configurable thresholds for all healing decisions\n\n**Note:** HealIQ provides visual suggestions only. Due to Blizzard restrictions, spell casting must be done manually using your normal keybinds or action bars.\n\n\u003e HealIQ is inspired by Hekili, but for healing. Designed with Restoration Druids in mind, support for other healers may be added later.\n\n## 📦 Installation\n\n### From CurseForge (Recommended)\n- Download from [CurseForge](https://curseforge.com) using the CurseForge app or website\n- Automatic updates and dependency management\n\n### Manual Installation\n1. Download the latest release from [GitHub Releases](https://github.com/djdefi/healiq/releases)\n2. Unzip to your `Interface/AddOns/` directory\n3. Enable the addon in the WoW AddOn menu\n4. Type `/healiq` for basic options and slash commands (coming soon)\n\n## 🔧 Configuration\n\n- UI icon is movable (drag-and-drop)\n- Suggestions shown via a single icon by default\n- Queue preview shows upcoming spell suggestions\n- Extensive strategy customization via `/healiq strategy` commands\n- Rule enable/disable via `/healiq rules` commands\n- All healing thresholds and priorities are tunable\n\n**Strategy Configuration:**\n- Access via `/healiq strategy list` to see all settings\n- Modify with `/healiq strategy set \u003csetting\u003e \u003cvalue\u003e`\n- Reset to optimal defaults with `/healiq strategy reset`\n- See [STRATEGY.md](STRATEGY.md) for detailed configuration guide\n\n## 📜 Planned Features\n\n- DBM integration for upcoming damage phases\n- Rule customization (enable/disable rules)\n- Visual “queue” preview\n- Support for hybrid Resto-DPS catweaving\n\n## 💡 Why Use This?\n\nHealing doesn’t follow a strict rotation, but there are patterns of optimal decision-making. HealIQ helps you build muscle memory and learn when to refresh HoTs, use procs, or prep cooldowns for big AoE.\n\n## 🛠 For Developers\n\nThis addon is written in Lua using the WoW AddOn API.\n\n### Development Setup\n\n1. **Quick Setup:**\n   ```bash\n   ./setup-dev.sh\n   ```\n   This script will install Lua, luacheck, and set up the development environment.\n\n2. **Manual Setup:**\n   ```bash\n   # Install dependencies (Ubuntu/Debian)\n   sudo apt-get install lua5.1 luarocks\n   sudo luarocks install luacheck\n   \n   # Or on macOS with Homebrew\n   brew install lua luarocks\n   luarocks install luacheck\n   ```\n\n### Code Quality\n\nThis project uses automated linting to catch issues early:\n\n- **Pre-commit hooks** automatically run luacheck before each commit\n- **CI/CD pipeline** runs comprehensive linting on all pull requests\n- **Local linting:** Run `luacheck *.lua` to check your code\n\n### Running Tests\n\n```bash\n# Run the main test suite\nlua5.1 test_runner.lua\n\n# Run basic validation\nlua5.1 Tests.lua\n\n# Run loading order tests (regression test for issue #98)\nlua5.1 test_loading_order.lua\n```\n\n### Contributing\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes (linting will run automatically on commit)\n4. Run tests: `lua5.1 test_runner.lua`\n5. Submit a pull request\n\nThe pre-commit hook will prevent commits with linting issues. To bypass temporarily (not recommended): `git commit --no-verify`\n\nContributions and suggestions welcome via [Issues](https://github.com/djdefi/healiq/issues) and PRs.\n\n---\n\n## 🔒 License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjdefi%2Fhealiq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdjdefi%2Fhealiq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdjdefi%2Fhealiq/lists"}