[docs] Update documentation for audit command deep URL support

[github-actions]

Documentation Updates - 2026-01-01

This PR updates the documentation based on features merged in the last 24 hours.

Features Documented

• Deep URL support for audit command (from Add deep URL support to audit command for job and step-level debugging #8337) - The gh aw audit command now accepts GitHub Actions job URLs with step fragments, enabling direct navigation from failure links to specific logs and outputs

Changes Made

• Updated docs/src/content/docs/setup/cli.md:

  • Enhanced the troubleshooting section to explain all URL formats accepted by the audit command
  • Expanded the audit command reference section with detailed examples showing run IDs, workflow URLs, job URLs, and step-level URLs
  • Added explanation of automatic step extraction behavior (first failing step for job URLs, specific step for step URLs)
  • Added information about log file naming conventions

• Updated docs/src/content/docs/setup/mcp-server.md:

  • Enhanced the audit tool description to mention support for run IDs, workflow run URLs, job URLs, and step-level URLs

Merged PRs Referenced

• Add deep URL support to audit command for job and step-level debugging #8337 - Add deep URL support to audit command for job and step-level debugging

The audit command now supports multiple URL formats for more precise debugging:

• Run IDs: 12345678
• Workflow run URLs: https://github.com/owner/repo/actions/runs/123
• Job URLs: https://github.com/owner/repo/actions/runs/123/job/456 (extracts first failing step)
• Step URLs: https://github.com/owner/repo/actions/runs/123/job/456#step:7:1 (extracts specific step)

This enhancement makes it significantly easier to debug workflow failures by allowing users to paste URLs directly from GitHub Actions failure notifications.

Other PRs Analyzed

The following 19 PRs were also merged in the last 24 hours but contain internal refactoring, CI improvements, and code quality fixes that don't require user-facing documentation updates:

• Fix Prettier formatting in add_comment.cjs #8365 - Fix Prettier formatting in add_comment.cjs
• Remove lint job dependencies from test job in CI workflow #8364 - Remove lint job dependencies from test job in CI workflow
• Add compile step with security tools to pre-download Docker images #8363 - Add compile step with security tools to pre-download Docker images
• Fix TypeScript type errors in safe output handler modules #8361 - Fix TypeScript type errors in safe output handler modules
• Refactor threat detection setup to external .cjs module #8360 - Refactor threat detection setup to external .cjs module
• Refactor docker image download inline script to external shell script #8359 - Refactor docker image download inline script to external shell script
• Refactor multi-secret validation from inline script to shell script #8357 - Refactor multi-secret validation from inline script to shell script
• Warn when safe output messages are skipped due to missing handlers #8356 - Warn when safe output messages are skipped due to missing handlers
• Refactor "Generate workflow overview" step to separate .cjs module #8355 - Refactor "Generate workflow overview" step to separate .cjs module
• Fix JavaScript formatting in safe_output_handler_manager.test.cjs #8353 - Fix JavaScript formatting in safe_output_handler_manager.test.cjs
• Fix non-deterministic tool ordering in compiled workflows with imported safe-jobs #8352 - Fix non-deterministic tool ordering in compiled workflows with imported safe-jobs
• Remove actionlint config file generation code and config file #8350 - Remove actionlint config file generation code and config file
• Fail step when safe output handler doesn't return function #8348 - Fail step when safe output handler doesn't return function
• Add cursor-glob field to campaign spec to fix validation failure #8347 - Add cursor-glob field to campaign spec to fix validation failure
• Fix workflow timestamp check to fail on outdated lock files #8346 - Fix workflow timestamp check to fail on outdated lock files
• Refactor all safe output handlers to follow handler factory pattern with TypeScript types #8344 - Refactor all safe output handlers to follow handler factory pattern with TypeScript types
• Add required fields to campaign metrics JSON schema in orchestrator instructions #8343 - Add required fields to campaign metrics JSON schema in orchestrator instructions
• Improve metrics validation error messages in push_repo_memory #8342 - Improve metrics validation error messages in push_repo_memory
• Add Go and defaults domain sets to Tidy workflow firewall config #8339 - Add Go and defaults domain sets to Tidy workflow firewall config

AI generated by Daily Documentation Updater