Skip to content

[docs] Self-healing documentation fixes from issue analysis - 2026-10-01 - #64865

Merged
pelikhan merged 1 commit into
mainfrom
doc-healer/pi-quickstart-web-search-2026-10-01-aab5029bca9e70bb
Oct 1, 2026
Merged

pelikhan merged 1 commit into
mainfrom
doc-healer/pi-quickstart-web-search-2026-10-01-aab5029bca9e70bb

Conversation

@github-actions

@github-actions github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown
Contributor

Self-Healing Documentation Fixes

This PR was automatically created by the Daily Documentation Healer workflow.

It fixes two gaps that are still present in the tree. Both come from Deep Report issues that github-actions[bot] auto-closed as not_planned when they expired. No merged PR fixed either one, and no closed-unmerged [docs] PR rejected either fix direction.

Gaps Fixed

Source verification
  • pkg/workflow/gemini_engine.go:34 and pkg/workflow/pi_engine.go:51 both set WebSearch: false.
  • pkg/workflow/agent_validation.go:277-281 (validateWebSearchSupport) prints Engine '<id>' does not support the web-search tool as a compile warning when the capability is false.
  • Neither the Gemini nor the Pi engine source uses the web-search tool anywhere else.
  • Neither engine is experimental (experimental: false), so the experimental-engine exemption does not apply.
  • These docs already describe the same behavior: engines/gemini.md:53 and engines/pi.md:97 both say there is no native tools.web-search, and the Pi auth rules come from setup/quick-start.mdx:175.
Issues analyzed and skipped

29 closed documentation issues in the 7-day window (since 2026-09-24):

The steering issue number for this run was empty, so there were no steering comments to read.

Root Cause

This is the third run in a row where the same DDUw gap caused the miss (see #64367 and #64596):

  1. Integrity filtering hides bot-authored issues. [deep-report] Add Pi to AI Account prerequisites bullet in quick-start.mdx #64318 and [deep-report] Document per-engine web-search default behavior for Gemini and Pi in tools.md #64319 were open from 2026-09-29 to 2026-10-01, so DDUw Step 1b (open documentation issues) should have caught them. A GitHub MCP list_issues call for open documentation issues during this run returned 3 items, and 7 more were [Filtered] ... removed by integrity policy. Deep Report issues are authored by github-actions[bot], so DDUw never sees them while they are open (the same pattern as [doc-healer] doc-healer DDUw improvement - integrity-filtered issue queries return empty #62496).
  2. After expiry, Step 1c treats them as rejected. Once the gh-aw-expires timer closes them as not_planned, Step 1c says "Do not create documentation based solely on this issue". The cross-cutting fallback only covers "coverage or convention" gaps, so a single-file factual gap like these falls through.
  3. Step 1d only targets label:cookie from specific monitors. Deep Report issues do carry cookie, but Step 1d does not say it overrides the Step 1c not_planned rule, and its search hits the same integrity filter.
💡 DDUw Improvement Suggestions

DDUw Improvement Suggestions

  1. Step 1c — treat bot expiry differently from rejection (repeated from [docs] Self-healing documentation fixes from issue analysis - 2026-09-29 #64367 and [docs] Self-healing documentation fixes from issue analysis - 2026-09-30 #64596, still not applied). Add: "If closed_by is github-actions[bot] and the body contains a gh-aw-expires marker, treat the issue as unreviewed. Verify the gap against the current tree and fix it if it is still present."
  2. Step 1b/1d — read bot-authored issues through an unfiltered path. Pre-flight fetches 2–4 use gh issue list. Tell DDUw to use those pre-fetched results as the source of truth when MCP list_issues/search_issues reports [Filtered] N item(s), instead of treating the filtered MCP result as complete.
  3. Add Deep Report to Step 1d's named sources. Step 1d names only CLI Consistency Checker and Multi-Device Docs Tester. Add [deep-report] issues: they name an exact file and line and have a clear fix direction.
  4. Pre-flight step 3 — raise --limit 20 to 50. This window had 29 closed documentation issues, so a limit of 20 can drop the oldest ones.
  5. Step 3 — fix the stale guideline path. .github/workflows/daily-doc-updater.md:210 and :256 still point to .github/instructions/documentation.instructions.md, which no longer exists. The guidelines live at .github/skills/documentation/SKILL.md.

Related Issues

🤖 Generated with [Claude Code]((claude.com/redacted)

Generated by 📝 Daily Documentation Healer · claude · haiku45 · 338.5 AIC · ⌖ 46.4 AIC · ⊞ 6.7K · ◷

  • expires on Oct 4, 2026, 3:51 PM UTC-08:00

Co-Authored-By: Claude Code <noreply@anthropic.com>
@github-actions github-actions Bot added automation documentation Improvements or additions to documentation labels Oct 1, 2026
@pelikhan
pelikhan marked this pull request as ready for review October 1, 2026 23:54
Copilot AI balanced review requested due to automatic review settings October 1, 2026 23:54
@pelikhan
pelikhan merged commit 34aae94 into main Oct 1, 2026
2 checks passed
@pelikhan
pelikhan deleted the doc-healer/pi-quickstart-web-search-2026-10-01-aab5029bca9e70bb branch October 1, 2026 23:54
@github-actions

github-actions Bot commented Oct 1, 2026 •

Copy link
Copy Markdown
Contributor Author

✅ Test Quality Sentinel completed test quality analysis.

No test files were added or modified in this PR. Only documentation files changed (docs/src/content/docs/reference/tools.md, docs/src/content/docs/setup/quick-start.mdx). Test Quality Sentinel skipped.

🧪 Test quality analysis by Test Quality Sentinel

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🟢 Approval recommended

Both documentation updates accurately match current engine capabilities and validation behavior.

Review effort: Balanced
Findings: None

What changed in this PR

Updates engine documentation to clarify Pi authentication and web-search limitations.

Changes:

  • Adds Pi account requirements to the quick start.
  • Documents Gemini and Pi web-search behavior and MCP alternatives.
File Description
docs/​src/​content/​docs/​setup/​quick-start.mdx Clarifies Pi authentication prerequisites.
docs/​src/​content/​docs/​reference/​tools.md Documents Gemini and Pi web-search limitations.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

@github-actions

github-actions Bot commented Oct 3, 2026

Copy link
Copy Markdown
Contributor Author

🎉 This pull request is included in a new release.

Release: v0.90.3

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automation documentation Improvements or additions to documentation

Projects

None yet

2 participants