docs: add documentation for awf logs stats and summary commands

[Copilot]

PR #118 added awf logs stats and awf logs summary commands but didn't include documentation. This PR adds comprehensive docs for both commands.

Changes

• CLI Reference (docs-site/src/content/docs/reference/cli-reference.md): Added awf logs stats and awf logs summary subcommands with options, output formats, examples, and guidance on when to use each
• Usage Guide (docs/usage.md): New "Log Analysis" section with command examples and sample output
• Logging Quick Reference (docs/logging_quickref.md): Added commands as primary methods for getting statistics
• GitHub Actions Guide (docs/github_actions.md): New "Generating Firewall Summaries" section showing CI integration

Example Usage

# Terminal stats (colorized output)
awf logs stats

# GitHub Actions step summary
awf logs summary >> $GITHUB_STEP_SUMMARY

# JSON for scripting
awf logs stats --format json

Screenshot

Original prompt

Improve docs on #118

Custom agent used: technical-doc-writer
AI technical documentation writer for awf library using Astro Starlight

---

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

[Mossaka]

@copilot try this again and visualzie the docs: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro build

[github-actions]

Test Coverage Report

Metric	Coverage	Covered/Total
Lines	71.29%	991/1390
Statements	71.39%	1016/1423
Functions	69.42%	109/157
Branches	66.33%	337/508

Coverage Thresholds

The project has the following coverage thresholds configured:

• Lines: 38%
• Statements: 38%
• Functions: 35%
• Branches: 30%

---

Coverage report generated by `npm run test:coverage`

[Copilot]

@copilot try this again and visualzie the docs: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro build

Built the docs site with npm run build and verified it renders correctly. Screenshot shows the CLI Reference page with the new awf logs stats and awf logs summary sections.

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: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro build (dns block)
  • Triggering command: /usr/local/bin/node node /home/REDACTED/work/gh-aw-firewall/gh-aw-firewall/docs-site/node_modules/.bin/astro preview --port 4321 (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)