fix(hook_runner): v5.1.2 — wait for real clip length on Windows (#14)

[ChanMeng666]

Summary

• Fixes #14 (reported by @Basdanucha): default permission-request.mp3 (~3.4 s) and elicitation.mp3 (~3.1 s) were always truncated on Windows because every PowerShell playback snippet hard-coded Start-Sleep -Seconds 3 before $player.Stop(); $player.Close().
• All four sites in hooks/hook_runner.py (three fallback methods in play_audio_windows + the WSL path in play_audio_wsl) now poll the media player for the actual clip length and sleep for duration + 500 ms tail buffer. PresentationCore MediaPlayer uses $player.NaturalDuration.HasTimeSpan with a 1.5 s poll ceiling (Open() is async); WMPlayer.OCX uses $w.currentMedia.duration. Fallback Start-Sleep -Seconds 10 if the player never reports a duration — generous but bounded so the PowerShell host doesn't leak.
• macOS (afplay) and Linux (mpg123/ffplay/paplay/aplay) are unaffected: those players block until playback completes by default.
• Version bump 5.1.1 → 5.1.2 across every version-holding file; plugin copies synced via scripts/build-plugin.sh; CHANGELOG.md + CLAUDE.md Version-history row updated.

Why not the reporter's other options

• Bump the constant — only moves the cliff. Any future voice > N seconds silently regresses.
• Detach and fire-and-forget — MediaPlayer is hosted inside the PowerShell process; if PowerShell exits before playback completes, the player is disposed mid-clip. The Python subprocess.Popen layer was already fire-and-forget; this PR closes the gap that was inside the PowerShell command string.

Test plan

• bash scripts/build-plugin.sh --check → {"ok":true,"in_sync":true,"checked":60}
• import hook_runner from both hooks/ and plugins/audio-hooks/hooks/ → both print 5.1.2
• python bin/audio-hooks.py version | status | diagnose → valid JSON, "version":"5.1.2", errors:[], warnings:[]
• python bin/audio-hooks.py test all → {"ok":true,"passed":26,"failed":[],"total":26}
• python bin/audio-hooks.py test permission_request → dispatches cleanly; logs tail --level error stays empty after playback
• CI smoke workflow (Ubuntu / Windows / macOS × Python 3.9 / 3.12 / 3.13) — should stay green
• Audible E2E (maintainer, Windows): audio-hooks test permission_request — confirm the ~0.4 s tail that used to be cut off is now audible; same for audio-hooks test elicitation

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Fixes Windows/WSL audio clips being truncated by replacing fixed PowerShell Start-Sleep delays with duration-aware waits, and bumps the project/plugin version to 5.1.2 across canonical + synced plugin copies.

Changes:

• Update Windows/WSL PowerShell playback snippets to poll for real media duration and sleep for duration + 500ms (with bounded fallback).
• Bump version strings to 5.1.2 across CLI, hook runner, plugin manifests, and default config templates.
• Refresh documentation/examples (README/ARCHITECTURE/CLAUDE/CHANGELOG/SKILL) to reflect v5.1.2.

Reviewed changes

Copilot reviewed 11 out of 13 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
plugins/audio-hooks/skills/audio-hooks/SKILL.md	Updates status line example version to v5.1.2.
plugins/audio-hooks/hooks/hook_runner.py	Windows/WSL playback now waits for actual clip length (synced plugin copy).
plugins/audio-hooks/config/default_preferences.json	Bumps default config template version fields to 5.1.2.
plugins/audio-hooks/bin/audio-hooks.py	Bumps CLI PROJECT_VERSION to 5.1.2 (synced plugin copy).
plugins/audio-hooks/.claude-plugin/plugin.json	Bumps plugin manifest version to 5.1.2.
hooks/hook_runner.py	Windows/WSL playback now waits for actual clip length (canonical source).
docs/ARCHITECTURE.md	Updates status line example version to v5.1.2.
config/default_preferences.json	Bumps default config template version fields to 5.1.2 (canonical).
bin/audio-hooks.py	Bumps CLI PROJECT_VERSION to 5.1.2 (canonical).
README.md	Updates badge + examples to v5.1.2.
CLAUDE.md	Updates header/version history with the Windows truncation fix entry.
CHANGELOG.md	Adds 5.1.2 release notes describing the Windows/WSL playback fix.
.claude-plugin/marketplace.json	Bumps marketplace/plugin listing versions to 5.1.2.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.