EphemeraAdmin: Add Maintenance Tools documentation (implemented 2026-04-22)

2026-04-23T02:41:00Z

Add Maintenance Tools documentation (implemented 2026-04-22)

New page

{{DISPLAYTITLE:Ephemera Agent — Maintenance Tools}}
__TOC__
The '''Wiki Control Panel''' (MAINT tab in the agent UI) provides deterministic, read-only maintenance queries against the wiki. No LLM is involved. Results are returned instantly and are clickable — clicking a page title opens it in the Browser tab.

== Accessing the Control Panel ==

Click the '''MAINT''' button in the top header bar of the agent UI.

== Backend: maintenance.php ==

All tools call <code>maintenance.php</code> directly via POST with an <code>action</code> parameter. The file uses bot credentials (from <code>/etc/environment</code>) via the shared <code>wiki_api.php</code> layer. It is read-only — no writes of any kind.

== Available Tools ==

=== Stub Pages ===

; Action: <code>stubs</code>
; Namespace: Encyclopedia (NS 0)
; Method: MediaWiki search — <code>hastemplate:stub</code>

Returns pages in the main namespace that use the <code>{{stub}}</code> template. These are candidates for the Expand workflow.

=== Orphaned Pages ===

; Action: <code>orphans</code>
; Namespace: All
; Method: MediaWiki built-in special page — <code>LonelyPages</code>

Returns pages with no inbound links from any other page. Orphaned pages are invisible to navigation and to the agent's link-expansion context step.

=== Uncategorized Pages ===

; Action: <code>uncategorized</code>
; Namespace: Encyclopedia (NS 0)
; Method: MediaWiki built-in special page — <code>UncategorizedPages</code>

Returns NS 0 pages belonging to no category.

=== Missing References ===

; Action: <code>missing_references</code>
; Namespace: Encyclopedia (NS 0)
; Method: Batch content fetch + string check

Returns pages ≥ 500 characters that have no <code>== References ==</code> section. Very short pages (likely stubs) are skipped.

=== Missing {{Instruction}} Template ===

; Action: <code>missing_instruction</code>
; Namespace: Instructions (NS 100)
; Method: allpages list + batch template property check

Returns Instruction namespace pages that do not use the <code>{{Instruction}}</code> template. These pages will not have structured metadata and may be invisible to the context assembly pipeline.

=== Missing {{Source}} Template ===

; Action: <code>missing_source</code>
; Namespace: Sources (NS 102)
; Method: allpages list + batch template property check

Returns Source namespace pages that do not use the <code>{{Source}}</code> template. These pages lack reliability, bias, and canon_status metadata.

== API Reference ==

Direct POST to <code>https://ephemerawiki.space/maintenance.php</code>:

{
"action": "stubs", // or orphans, uncategorized, missing_references,
// missing_instruction, missing_source
"limit": 100 // max results, default 50, max 200
}

Response:

{
"action": "stubs",
"pages": [
{ "title": "Example Page", "size": 842, "timestamp": "2026-04-22T..." }
],
"count": 1,
"total_checked": 47 // present on template/reference checks only
}

== Planned Extensions ==

The following are defined in the maintenance proposal but not yet implemented:

* Category B — Preview/report tools (generate proposed change plans, no writes)
* Category C — Guarded write tools (dry-run + confirmation step)
* LLM-assisted editorial workflows via <code>Instructions:Maintenance/*</code> pages
* Scheduled maintenance runs

[[Category:Help]]
[[Category:EphemeraAgent]]

Help:Ephemera Agent/Maintenance Tools - Revision history

EphemeraAdmin: Add Maintenance Tools documentation (implemented 2026-04-22)