[docs] docs: daily documentation update — April 25 eval async/sync fixes (PRs #4471, #4472)

[github-actions]

Automated daily documentation update covering 2 PRs merged on 2026-04-25, following the Diátaxis framework.

PRs Covered

PR	Title	Merged
#4471	fix(eval): don't wrap sync answer_question with asyncio.run	2026-04-25T04:05:08Z
#4472	fix(eval): await async grade_metacognition in progressive suite	2026-04-25T04:22:35Z

Documentation Changes (Diátaxis Framework)

Explanation — docs/recipes/RECENT_FIXES_APRIL_2026.md (new file)

New explanation doc covering both eval async/sync fixes with problem/root-cause/fix/rule structure:

• PR fix(eval): don't wrap sync answer_question with asyncio.run #4471: asyncio.run() misapplied to sync answer_question — every L1–L12 level failed with ValueError: a coroutine was expected
• PR fix(eval): await async grade_metacognition in progressive suite #4472: async grade_metacognition never awaited — shadowed by fix(eval): don't wrap sync answer_question with asyncio.run #4471, exposed after that fix landed
• Summary table showing dependency between the two fixes

Reference — docs/DISCOVERIES.md (2 new entries, 2026-04-25)

• Sync Method Called with asyncio.run() Passes Resolved Value, Not Coroutine — root cause, key learnings, prevention
• Shadowed Async Error in Progressive Eval Suite Exposed by Upstream Fix — documents the cascading failure pattern

How-To — docs/howto/agent-learning-eval-harness.md (updated)

Added Async/Sync Contract for Eval Methods section with a reference table of known sync vs async eval methods and the correct calling pattern from sync context. Cross-links to RECENT_FIXES_APRIL_2026.md.

Test plan

• Verify docs/recipes/RECENT_FIXES_APRIL_2026.md renders correctly (tables, code blocks)
• Verify docs/DISCOVERIES.md new entries render correctly
• Confirm docs/howto/agent-learning-eval-harness.md cross-link to RECENT_FIXES_APRIL_2026.md resolves

Generated by Daily Documentation Updater

Generated by Daily Documentation Updater · ◷

Warning

⚠️ Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

• mobile.events.data.microsoft.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "mobile.events.data.microsoft.com"

See Network Configuration for more information.

• expires on Apr 26, 2026, 6:31 AM UTC

[github-actions]

This pull request was automatically closed because it expired on 2026-04-26T06:31:51.986Z.

Closed by Workflow