feat(hooks): SessionStart hook auto-injects Purchasely skill pointers

[kherembourg]

Objectif

Ajouter un hook SessionStart qui injecte automatiquement un court pointer vers les skills Purchasely (integrate, review, debug) et la commande /purchasely:question à chaque démarrage de session, sur le modèle d'obra/superpowers/hooks/.

Sans ce hook, l'utilisateur doit explicitement taper /purchasely:question ou nommer la skill ; avec, Claude / Cursor / Copilot CLI savent que le plugin est disponible dès le démarrage.

Fichiers ajoutés

Fichier	Rôle
hooks/hooks.json	Config hook Claude Code (matcher: "startup|clear|compact")
hooks/hooks-cursor.json	Équivalent Cursor (sessionStart)
hooks/session-start	Script POSIX shell (zero-dep) qui émet le contexte au format attendu par le host
hooks/run-hook.cmd	Wrapper polyglotte cmd/bash pour Windows (Git Bash / WSL)
hooks/intro.md	Texte court (~25 lignes) listant les skills + slash command
.claude-plugin/plugin.json	Pointe vers ./hooks/hooks.json

Détection du format de sortie

Le script session-start détecte le host via variables d'environnement et émet :

• Claude Code (CLAUDECODE=1 ou CLAUDE_PLUGIN_ROOT défini) → {"hookSpecificOutput": {"hookEventName": "SessionStart", "additionalContext": "..."}}
• Cursor (CURSOR_AGENT ou CURSOR_TRACE_ID) → {"additional_context": "..."}
• Standard SDK (défaut) → {"additionalContext": "..."}

Contenu injecté

Court paragraphe + bullet list pointant vers les 3 skills et la slash command — pas un dump du contenu des skills, juste un signal que le playbook existe. Voir hooks/intro.md. ~25 lignes.

Tests locaux

$ CLAUDECODE=1 hooks/session-start | python3 -m json.tool
{
    "hookSpecificOutput": {
        "hookEventName": "SessionStart",
        "additionalContext": "..."
    }
}

$ CURSOR_AGENT=1 hooks/session-start | python3 -m json.tool
{ "additional_context": "..." }

$ hooks/session-start | python3 -m json.tool
{ "additionalContext": "..." }

Tous valident comme JSON correct.

Acceptance criteria

• Hook testé manuellement, sort du JSON valide dans les 3 formats.
• Zero dépendance externe (/bin/sh + awk POSIX).
• Fonctionne sur macOS, Linux, et Windows via le wrapper polyglotte (Git Bash / WSL côté Windows — détection avec fallback).
• CHANGELOG.md mis à jour : ### Added — SessionStart hook auto-injects Purchasely skill pointers.

---

Generated by Claude Code