fix(extensions): render hyphenated hook invocations for Forge projects

[jawwad-ali]

What

Forge is a hyphenated slash-command agent — it registers its commands as /speckit-<name> (see format_forge_command_name and ForgeIntegration.build_command_invocation in src/specify_cli/integrations/forge/__init__.py), exactly like Cline.

But HookExecutor._render_hook_invocation (src/specify_cli/extensions/__init__.py) special-cases only dollar-skills agents, kimi, cline, and slash-skills agents. Forge matches none of them, so it fell through to:

return f"/{command_id}"

rendering the dotted form — /speckit.plan, /speckit.git.commit — which Forge does not recognize as a registered command. Hook execution messages therefore told Forge users to run commands that don't exist under that name.

Fix

Add a Forge branch mirroring the adjacent Cline branch:

if forge_mode:
    from ..integrations.forge import format_forge_command_name
    return f"/{format_forge_command_name(command_id)}"

format_forge_command_name is idempotent and has the same contract as the Cline formatter already used one branch above. Non-Forge agents are unaffected.

Tests

tests/test_extensions.py::TestHookInvocationRendering — two tests mirroring the existing Cline hook tests:

• test_forge_hooks_render_hyphenated_invocation → speckit.tasks renders /speckit-tasks
• test_forge_hooks_render_extension_command → my-extension.do-something renders /speckit-my-extension-do-something

Verified fail-before / pass-after (reverting only the source hunk makes both fail, rendering the dotted /my-extension.do-something). ruff check clean.

---

AI-assisted: authored with Claude Code. I confirmed Forge's hyphenated command registration and that the Cline branch is the exact sibling precedent, and verified fail-before/pass-after.

[Copilot]

Pull request overview

Fixes Forge hook messages to use registered hyphenated slash-command names.

Changes:

• Formats Forge hook invocations with format_forge_command_name.
• Adds coverage for built-in and extension commands.

Show a summary per file

File	Description
src/specify_cli/extensions/__init__.py	Adds Forge-specific hook invocation rendering.
tests/test_extensions.py	Tests Forge hook command formatting.

Review details

Tip

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

• Files reviewed: 2/2 changed files
• Comments generated: 0
• Review effort level: Medium

[mnriem]

Thank you!