Add Makefile targets for updating testing docs

Introduces new Makefile targets to automate the process of updating testing documentation, including installing repomix, generating repomix output, processing documentation, and cleaning up temporary files. Also renames and updates the GitHub workflow to instruct contributors to use the new Makefile command for documentation updates.

Author: karangattu

.github/workflows/validate_testing_docs.yml renamed to .github/workflows/validate_testing_docs_on_change.yml

@@ -1,4 +1,4 @@
-name: Validate Testing Documentation
+name: Validate Testing Documentation for changes
 
 on:
   pull_request:
@@ -43,19 +43,22 @@ jobs:
 
             We detected changes in the `shiny/playwright/controller` directory. These changes may affect the testing documentation used by the `shiny add test` command.
 
-            **Please run the following commands to update the testing documentation:**
+            **Please run the following command to update the testing documentation:**
 
             ```bash
-            # Install repomix if not already installed
-            npm install -g repomix
+            make update-testing-docs
+            ```
 
-            # Generate updated testing documentation
-            repomix docs/api/testing -o tests/inspect-ai/utils/scripts/repomix-output-testing.xml
-            python tests/inspect-ai/utils/scripts/process_docs.py --input tests/inspect-ai/utils/scripts/repomix-output-testing.xml --output shiny/pytest/generate/data/docs/documentation_testing.json
+            <details><summary>Additional details</summary>
 
-            # Clean up temporary files
-            rm -f tests/inspect-ai/utils/scripts/repomix-output-testing.xml
-            ```
+            This command will:
+            1. Install repomix if not already installed
+            2. Build the latest documentation with quartodoc
+            3. Generate repomix output for testing docs
+            4. Process the output to update the AI test generator documentation
+            5. Clean up temporary files
+
+            </details>
 
             This will ensure that the AI test generator has access to the latest controller API documentation.
 

Makefile

@@ -123,6 +123,28 @@ docs-quartodoc: FORCE
 	@echo "-------- Making quartodoc docs --------"
 	@cd docs && make quartodoc
 
+install-repomix: install-npm ## Install repomix if not already installed
+	@echo "-------- Installing repomix if needed --------"
+	@if ! npm list -g repomix > /dev/null 2>&1; then \
+		echo "Installing repomix..."; \
+		npm install -g repomix; \
+	else \
+		echo "repomix is already installed"; \
+	fi
+
+update-testing-docs-repomix: install-repomix ## Generate repomix output for testing docs
+	@echo "-------- Generating repomix output for testing docs --------"
+	repomix docs/api/testing -o tests/inspect-ai/utils/scripts/repomix-output-testing.xml
+
+update-testing-docs-process: ## Process repomix output to generate testing documentation JSON
+	@echo "-------- Processing testing documentation --------"
+	python tests/inspect-ai/utils/scripts/process_docs.py --input tests/inspect-ai/utils/scripts/repomix-output-testing.xml --output shiny/pytest/generate/data/docs/documentation_testing.json
+	@echo "-------- Cleaning up temporary files --------"
+	rm -f tests/inspect-ai/utils/scripts/repomix-output-testing.xml
+
+update-testing-docs: docs update-testing-docs-repomix update-testing-docs-process ## Update testing documentation (full pipeline)
+	@echo "-------- Testing documentation update complete --------"
+
 
 install-npm: FORCE
 	$(if $(shell which npm), @echo -n, $(error Please install node.js and npm first. See https://nodejs.org/en/download/ for instructions.))