fix: replace $ARGUMENTS with {{parameters}} in Forge templates

- Add replacement of $ARGUMENTS to {{parameters}} after template processing
- Use arg_placeholder from config (Copilot's cleaner approach)
- Remove unused 'import re' from _apply_forge_transformations()
- Enhance tests to verify $ARGUMENTS replacement works correctly
- All 11 tests pass

Fixes template processing to ensure Forge receives user-supplied parameters correctly.

Author: ericnoam

src/specify_cli/integrations/forge/__init__.py

@@ -82,6 +82,10 @@ def setup(
             # Process template with Forge-specific argument placeholder
             processed = self.process_template(raw, self.key, script_type, arg_placeholder)
 
+            # Ensure any remaining $ARGUMENTS placeholders are converted to the
+            # Forge argument placeholder ({{parameters}} by default)
+            processed = processed.replace("$ARGUMENTS", arg_placeholder)
+            
             # Apply Forge-specific transformations
             processed = self._apply_forge_transformations(processed, src_file.stem)
 
@@ -102,8 +106,6 @@ def _apply_forge_transformations(self, content: str, template_name: str) -> str:
         1. Strip 'handoffs' frontmatter key
         2. Inject 'name' field if missing
         """
-        import re
-
         # Parse frontmatter
         lines = content.split('\n')
         if not lines or lines[0].strip() != '---':

tests/integrations/test_integration_forge.py

@@ -110,8 +110,8 @@ def test_templates_are_processed(self, tmp_path):
             assert "{SCRIPT}" not in content, f"{cmd_file.name} has unprocessed {{SCRIPT}}"
             assert "__AGENT__" not in content, f"{cmd_file.name} has unprocessed __AGENT__"
             assert "{ARGS}" not in content, f"{cmd_file.name} has unprocessed {{ARGS}}"
-            # Note: $ARGUMENTS may appear in template content (examples, instructions)
-            # The placeholder that gets replaced is {ARGS}, not $ARGUMENTS
+            # Check Forge-specific: $ARGUMENTS should be replaced with {{parameters}}
+            assert "$ARGUMENTS" not in content, f"{cmd_file.name} has unprocessed $ARGUMENTS"
             # Frontmatter sections should be stripped
             assert "\nscripts:\n" not in content
             assert "\nagent_scripts:\n" not in content
@@ -134,11 +134,33 @@ def test_forge_specific_transformations(self, tmp_path):
             assert "\nhandoffs:" not in content, f"{cmd_file.name} has unstripped 'handoffs' key"
 
     def test_uses_parameters_placeholder(self, tmp_path):
-        """Verify Forge config specifies {{parameters}} as the args placeholder."""
+        """Verify Forge replaces $ARGUMENTS with {{parameters}} in generated files."""
         from specify_cli.integrations.forge import ForgeIntegration
         forge = ForgeIntegration()
+        
         # The registrar_config should specify {{parameters}}
         assert forge.registrar_config["args"] == "{{parameters}}"
 
-        # When process_template is called, it should replace {ARGS} with {{parameters}}
-        # Note: $ARGUMENTS in template content is intentional (examples/instructions)
+        # Generate files and verify $ARGUMENTS is replaced with {{parameters}}
+        from specify_cli.integrations.manifest import IntegrationManifest
+        m = IntegrationManifest("forge", tmp_path)
+        forge.setup(tmp_path, m)
+        commands_dir = tmp_path / ".forge" / "commands"
+        
+        # Check all generated command files
+        for cmd_file in commands_dir.glob("speckit.*.md"):
+            content = cmd_file.read_text(encoding="utf-8")
+            # $ARGUMENTS should be replaced with {{parameters}}
+            assert "$ARGUMENTS" not in content, (
+                f"{cmd_file.name} still contains $ARGUMENTS - it should be replaced with {{{{parameters}}}}"
+            )
+            # At least some files should have {{parameters}} (those with user input sections)
+            # We'll check the checklist file specifically as it has a User Input section
+        
+        # Verify checklist specifically has {{parameters}} in the User Input section
+        checklist = commands_dir / "speckit.checklist.md"
+        if checklist.exists():
+            content = checklist.read_text(encoding="utf-8")
+            assert "{{parameters}}" in content, (
+                "checklist should contain {{parameters}} in User Input section"
+            )