[docs] Self-healing documentation fixes from issue analysis - 2026-07-24

[github-actions]

Summary

Adds a new engine.extensions: section to the frontmatter reference documentation.

Changes

File	Change
docs/src/content/docs/reference/frontmatter.md	Added Engine Extensions section documenting the engine.extensions: field

Details

• Documents the engine.extensions: frontmatter field for specifying Pi engine plugins to install before the agent runs.
• Clarifies that only the Pi engine reads this field; each entry is an npm package name passed to pi install <extension>.
• Other engines ignore this field.
• Includes a YAML example with @pi/web-search and @pi/file-browser.
• Links to the Pi Extensions reference for full details.

Type

docs — documentation only, no code changes.

Generated by PR Description Updater for #47672 · sonnet46 · 19.9 AIC · ⌖ 5.58 AIC · ⊞ 4.8K · ◷

[github-actions]

🎉 Great work! This PR looks excellent and ready for review.

What it does: Fills a documentation gap by adding the missing engine.extensions section to the concise frontmatter reference (frontmatter.md), resolving issues #47307 and #47083. The documentation mirrors the adjacent engine.driver section and includes a cross-link to the full Pi Extensions detail page.

Why it's solid:

• Clear, focused scope: one documentation section addition (12 lines)
• Comprehensive PR body explaining the gap, root cause (DDUw heuristic limitation), and actionable improvement suggestions for the automation itself
• Closes two related issues efficiently

Status: This PR is ready for merge pending team review. The self-healing documentation workflow is working as intended!

Warning

Firewall blocked 1 domain

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

• patchdiff.githubusercontent.com

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

network:
  allowed:
    - defaults
    - "patchdiff.githubusercontent.com"

See Network Configuration for more information.

Generated by ✅ Contribution Check · sonnet46 · 59 AIC · ⌖ 7.49 AIC · ⊞ 6.2K · ◷

[github-actions]

✅ Test Quality Sentinel completed test quality analysis.

No test files were added or modified in this PR. This PR contains only documentation changes to docs/src/content/docs/reference/frontmatter.md. Test Quality Sentinel analysis skipped.

[Copilot]

Pull request overview

Documents the shipped engine.extensions frontmatter option for discoverability.

Changes:

• Adds behavior and compatibility details.
• Provides a Pi extension configuration example.
• Links to the detailed Pi Extensions reference.

Show a summary per file

File	Description
docs/src/content/docs/reference/frontmatter.md	Adds the concise engine.extensions reference section.

Review details

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 1/1 changed files
• Comments generated: 0
• Review effort level: Medium

[github-actions]

🎉 This pull request is included in a new release.

Release: v0.83.2