📝 Documentation drift detected — `edit-wiki-page` safe output tool undocumented

[github-actions]

Documentation Freshness Audit

The weekly documentation audit found the following inconsistencies between code and documentation:

Findings

Area	Issue	File(s)
Architecture tree	src/tools/edit_wiki_page.rs exists but is not listed in the directory tree	.github/copilot-instructions.md
Safe Output Tools	edit-wiki-page tool is fully implemented and wired up but has zero documentation	src/tools/edit_wiki_page.rs, src/execute.rs, src/mcp.rs

Details

1. Architecture tree missing edit_wiki_page.rs

The src/tools/ listing in the Architecture section shows:

├── tools/
│   ├── mod.rs
│   ├── create_pr.rs
│   ├── create_work_item.rs
│   ├── memory.rs
│   ├── missing_data.rs
│   ├── missing_tool.rs
│   ├── noop.rs
│   └── result.rs

But src/tools/edit_wiki_page.rs exists and is exported from src/tools/mod.rs (line 14: mod edit_wiki_page;, line 23: pub use edit_wiki_page::*;).

2. edit-wiki-page tool entirely absent from Safe Output Tools documentation

The tool is fully implemented:

• src/tools/edit_wiki_page.rs — agent params, config struct, executor
• src/execute.rs — handles "edit-wiki-page" in Stage 2 (lines 185–190)
• src/mcp.rs — exposes the tool via MCP server (lines 408–433)

The tool has the following interface (currently undocumented):

Agent parameters:

• path — Wiki page path to update (e.g. /Overview/Architecture). Must not contain ...
• content — Markdown content for the wiki page (at least 10 characters).
• comment (optional) — Commit comment; falls back to front matter config or "Updated by agent".

Configuration options (front matter):

safe-outputs:
  edit-wiki-page:
    wiki-name: "MyProject.wiki"     # Required — wiki identifier (name or GUID)
    wiki-project: "OtherProject"    # Optional — defaults to current project
    path-prefix: "/agent-output"    # Optional — prepended to agent-supplied path
    title-prefix: "[Agent] "        # Optional — prepended to the last path segment
    comment: "Updated by agent"     # Optional — default commit comment

Suggested Fixes

• Add edit_wiki_page.rs to the src/tools/ listing in the Architecture section of .github/copilot-instructions.md
• Add a new #### edit-wiki-page section under Safe Output Tools documenting agent parameters and front matter configuration options
• Note that wiki-name is required for execution (tool fails without it)

---

This issue was created by the automated documentation freshness check.

Generated by Documentation Freshness Check · ◷