[docs] Update documentation for features from 2026-04-26

[github-actions]

Documentation Updates — April 26, 2026

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

Features Documented

• Audit diff: tokens-per-turn and tool call breakdown (from feat: add tool calls diff and tokens-per-turn to audit diff mode #28494)
• Observability OTLP headers: object form (from feat: add object form support for observability.otlp.headers #28524)
• OTel GenAI semantic conventions on agent span (from feat: add OTel GenAI semantic conventions to agent span #28511) — breaking change notice added
• Cache-memory: cache path misconfiguration detection (from feat: cache-memory cache_memory_miss detection and conclusion handler #28516)

📝 Detailed Changes & References

Changes Made

• Updated docs/src/content/docs/reference/audit.md: Added tokens-per-turn metric, tool call breakdown, and bash command breakdown to the Diff output section.
• Updated docs/src/content/docs/setup/cli.md: Updated the single-sentence diff description to mention new output fields.
• Updated docs/src/content/docs/reference/frontmatter.md: Added a new Observability section documenting observability.otlp configuration — preferred map form for headers, deprecated string form with migration note, and a table of gen_ai.* agent span attributes (replacing the old gh-aw.* names).
• Updated docs/src/content/docs/reference/cache-memory.md: Added troubleshooting entry for cache path misconfiguration detected via missing_data signal.

Merged PRs Referenced

• feat: add tool calls diff and tokens-per-turn to audit diff mode #28494 — feat: add tool calls diff and tokens-per-turn to audit diff mode
• feat: add object form support for observability.otlp.headers #28524 — feat: add object form support for observability.otlp.headers
• feat: add OTel GenAI semantic conventions to agent span #28511 — feat: add OTel GenAI semantic conventions to agent span
• feat: cache-memory cache_memory_miss detection and conclusion handler #28516 — feat: cache-memory cache_memory_miss detection and conclusion handler

Skipped Issues

None of the open documentation issues (#22001, #20391, #16498) were addressed in this run — they require separate structural investigation beyond the scope of today's code changes.

Notes

The gen_ai.* span attribute change (#28511) is a breaking change for users who built OTLP dashboards using the old gh-aw.model / gh-aw.tokens.* attribute names. The new Observability section in frontmatter.md includes a callout flagging this.

Generated by Daily Documentation Updater · ● 632.5K · ◷

• expires on Apr 27, 2026, 10:59 AM UTC