lint_wiki
Audit wiki channels for health problems such as stale, orphaned, duplicated, or inconsistent pages. Returns structured findings with severity and suggested actions.
Instructions
Audit a channel's wiki for health problems and return a list of findings. Call it to check whether wiki pages are stale, orphaned, duplicated, or internally inconsistent before relying on them or recommending a refresh.
When to use: validating wiki quality, or diagnosing why an answer looked wrong. When NOT to use: routine reading (use read_wiki_page / list_wiki_pages) — linting is heavier. Set run_coherence_check=false to avoid the per-page LLM cost when you only need structural checks.
Prerequisites: a channel_id from list_channels.
Returns (long-running when run_coherence_check=true — one LLM call per
page; read-only, writes nothing): {findings: [{severity, category, page_id, section_id, message, suggested_action}, ...], pages_scanned: N}.
Error modes (returned as dicts): 'authentication_missing' (no principal);
'channel_access_denied' (token lacks access to channel_id);
'lint_failed' (returned as {findings: [], error: 'lint_failed'} on an
internal lint error).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel_id | Yes | Channel id whose wiki to lint. Get it from list_channels (e.g. 'ch-eng'). Required. | |
| target_lang | No | Optional BCP-47 language tag to lint (e.g. 'en'). Omit to lint the channel's primary language. Default null (treated as 'en'). | |
| run_coherence_check | No | If true, also run the LLM coherence pass (one model call per page — slower and incurs token cost). Set false for a fast structural-only lint. Default true. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||