[BUG] Copilot target writes userPromptSubmit; Copilot's event is userPromptSubmitted, so prompt hooks never run

[sheilagithub]

Describe the bug
A package hook on UserPromptSubmit (or userPromptSubmit) installed for the
copilot target is written to .github/hooks/*.json under the key
"userPromptSubmit". Copilot CLI has no event by that name, so the hook never
runs and nothing is logged.

Copilot's hooks reference
(https://docs.github.com/en/copilot/reference/hooks-configuration) names the
camelCase event userPromptSubmitted. Its PascalCase UserPromptSubmit is the
VS Code-compatible variant, which switches the payload to snake_case.

Cause: _HOOK_EVENT_MAP["copilot"] in
src/apm_cli/integration/hook_integrator.py:

"UserPromptSubmit": "userPromptSubmit",
"userPromptSubmit": "userPromptSubmit",

tests/integration/test_hook_integrator_copilot_casing_e2e.py asserts the
same wrong name.

To Reproduce

1. A package pkg with apm.yml (target: [copilot]) and .apm/hooks/x.json:
   {"hooks":{"UserPromptSubmit":[{"hooks":[{"type":"command","command":"echo hit >> hook.log"}]}]}}
2. A project that depends on pkg, with target: [copilot]. Run apm install.
   .github/hooks/pkg-x.json holds "userPromptSubmit".
3. Start copilot in the project and send a prompt. No hook.log is written.
4. Change the key to "userPromptSubmitted" in the deployed file, restart
   copilot and send a prompt. hook.log contains hit.

Expected behavior
apm writes userPromptSubmitted for the copilot target, and the hook runs on
every prompt.

Environment

• OS: Windows 11 (pwsh 7)
• APM Version: 0.31.0. The same map is on main at 98616b9.
• GitHub Copilot CLI 1.0.86

Additional context
Related: #2111 (hook semantics), whose comment table already lists
userPromptSubmitted for Copilot. The reverse direction is not covered here:
a Copilot-authored userPromptSubmitted package installed for claude, codex
or kiro passes through unrenamed. That can be a separate issue if wanted.

Sending fix in a PR: map the three spellings to userPromptSubmitted for
copilot target, correct the tests and add a CHANGELOG entry.

I checked two points before you post:

• The file name in step 2 is unverified. I read the deployed file with a wildcard (.github/hooks/.json), so I never saw its actual name. pkg-x.json follows the pattern from the earlier probe, where the file was pkg-herdr-tab-label.json. Either write .github/hooks/.json in step 2, or let me rerun the install and get the real name.
• The template's "Python Version" field is left out. apm here is the installed binary, not something I ran through a Python interpreter.

[sheilagithub]

I've opened a draft fix in #3030. It maps UserPromptSubmit and
userPromptSubmit to userPromptSubmitted for the copilot target, corrects
the tests that asserted the old name, and adds a CHANGELOG entry. I verified
it end to end with Copilot CLI 1.0.86: with the branch, the prompt hook fires
without hand edits.

Could a maintainer consider scope approval for this? A suggested record, if
it helps:

Scope: Map UserPromptSubmit/userPromptSubmit to userPromptSubmitted for the copilot hook target; update the affected tests.
Done when: Copilot hooks deploy as userPromptSubmitted and the hook tests pass.
Out of scope: Reverse aliases for claude/codex/kiro.

[sergio-sisternes-epam]

Thank you for the reproduction and for linking Copilot's hooks reference. The copilot target currently maps UserPromptSubmit / userPromptSubmit to userPromptSubmit in _HOOK_EVENT_MAP, and Copilot CLI 1.0.86 has no event by that name, so apm install can succeed while prompt hooks never run. That matches the consume/install promise for multi-target packages: a declared copilot target should deploy a key Copilot actually listens to (userPromptSubmitted).

Advisory recommendation for a maintainer: accept a bounded mapping fix for the copilot hook target only. This is not scope approval, assignment, or a release target.

Suggested bounded scope, if a maintainer agrees:

• Scope: Map UserPromptSubmit / userPromptSubmit (and identity userPromptSubmitted) to userPromptSubmitted for the copilot hook target; correct tests that asserted userPromptSubmit.
• Done when: Copilot-target deploy writes userPromptSubmitted, the hook tests pass, and CHANGELOG records the fix.
• Out of scope: reverse aliases for claude, codex, or kiro; other Copilot hook events.

#3030 already implements that shape and is waiting on a human scope record on this issue (CONTRIBUTING.md: start with an issue). Related discussion of hook semantics is #2111; this report is the specific copilot event-name bug, not a duplicate of that thread.

Please wait for a responsible maintainer to record approval (scope, done-when, exclusions, review contact) before treating the PR as invited work.

---

Generated by autopilot-issue-triage-worker. This comment is AI-generated and may contain errors.

[danielmeppiel]

Decision: approve
Area: project
Scope: For the Copilot hook target only, map UserPromptSubmit, userPromptSubmit, and userPromptSubmitted to userPromptSubmitted. Ratify the bounded fix proposed in PR #3030, including regression tests and synchronized documentation.
Done when: Copilot-target deployment writes userPromptSubmitted for all three spellings; regression tests cover normalization and generated hook configuration without changing other targets; affected hook documentation and apm-guide reference tables match the mapping; the changelog records the fix.
Out of scope: Reverse aliases for Claude, Codex, or Kiro; other hook events; broader hook-semantics or translation redesign.
Review contact: Daniel Meppiel (@danielmeppiel)