docs: document permissions-required in front-matter.md

[github-actions]

Agent Documentation Update

Findings

Area	Issue	File(s)
accuracy	permissions-required is a real top-level FrontMatter field (src/compile/types.rs) but was entirely absent from docs/front-matter.md's field reference/example — the only mention lived deep in docs/imports.md, with no cross-link from the primary front-matter reference page	docs/front-matter.md

Applied Fixes

• Added a commented permissions-required: example alongside the existing permissions: block in docs/front-matter.md, with a cross-link to the full explanation in docs/imports.md#permissions-required

Notes

Verified permissions_required: PermissionsRequired against the FrontMatter struct in src/compile/types.rs (#[serde(default, rename = "permissions-required")]). Confirmed the CLI (docs/cli.md), safe-outputs (docs/safe-outputs.md), and architecture tree in AGENTS.md are otherwise consistent with the current codebase (compared Commands enum in src/main.rs, all 24 files in src/safe_outputs/, and every .rs filename under src/ against the AGENTS.md tree — no stale or missing entries found). No other documentation drift identified this run.

---

Created by the agent-documentation maintainer workflow.

Generated by Agent Documentation Maintainer · auto · 75.6 AIC · ⌖ 5.96 AIC · ⊞ 13.2K · ◷

[azure-pipelines]

Azure Pipelines:
2 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.