Document role requirements for audit/logs tools in agentic-workflows

[Copilot]

The audit and logs tools in the agentic-workflows MCP server require write+ repository access, but this was undocumented. Users with read/triage roles would encounter permission denied errors without understanding why.

Changes

Setup Guide (setup/mcp-server.md):

• Added CAUTION block documenting role requirements (write, maintain, or admin) in "Using as Agentic Workflows Tool" section
• Added WARNING blocks to logs and audit tool descriptions
• Included example error response for insufficient permissions
• Clarified other tools (status, compile, etc.) are available to all users

Reference Documentation:

• Updated permissions.md to note role requirements for audit/logs tools
• Updated tools.md with role requirement notice in Agentic Workflows section

Permission Requirements

permissions:
  actions: read  # GitHub Actions access

# Additionally, workflow actor must have:
# - write, maintain, or admin repository role
# - GITHUB_ACTOR environment variable (auto-provided in Actions)

Runtime validation uses GitHub API: GET /repos/{owner}/{repo}/collaborators/{username}/permission

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• telemetry.astro.build
  • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build (dns block)
  • Triggering command: /opt/hostedtoolcache/node/24.13.0/x64/bin/node node /home/REDACTED/work/gh-aw/gh-aw/docs/node_modules/.bin/astro build ocs/examples/multi-repo/feature-53 ocs/�� ocs/examples/manual.md ocs/examples/multi-repo.md ocs/examples/scheduled.md ocs/examples/comsh ocs/examples/iss-c ocs/examples/agenode install.js ocs/setup/creating-workflows.mdx ocs/�� ocs/setup/mcp-server.md ocs/setup/cli.md bin/git (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.