Help:Ephemera Agent/Maintenance Tools

From Encyclopedia Ephemera
Revision as of 02:41, 23 April 2026 by EphemeraAdmin (talk | contribs) (Add Maintenance Tools documentation (implemented 2026-04-22))
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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

Available Tools

Stub Pages

Action
stubs
Namespace
Encyclopedia (NS 0)
Method
MediaWiki search — hastemplate:stub

Returns pages in the main namespace that use the Template:Stub template. These are candidates for the Expand workflow.

Orphaned Pages

Action
orphans
Namespace
All
Method
MediaWiki built-in special page — LonelyPages

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
uncategorized
Namespace
Encyclopedia (NS 0)
Method
MediaWiki built-in special page — UncategorizedPages

Returns NS 0 pages belonging to no category.

Missing References

Action
missing_references
Namespace
Encyclopedia (NS 0)
Method
Batch content fetch + string check

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

=== Missing

Instruction Metadata
id
type
applies_to
task_type
priority
status active
canonical true
include_by_default no
requires
tags
Template ===
Action
missing_instruction
Namespace
Instructions (NS 100)
Method
allpages list + batch template property check

Returns Instruction namespace pages that do not use the

Instruction Metadata
id
type
applies_to
task_type
priority
status active
canonical true
include_by_default no
requires
tags

template. These pages will not have structured metadata and may be invisible to the context assembly pipeline.

=== Missing

Source Metadata
id
type
subtype
author
affiliation
date
location
canonical true
reliability
bias
status published
related
tags
Template ===
Action
missing_source
Namespace
Sources (NS 102)
Method
allpages list + batch template property check

Returns Source namespace pages that do not use the

Source Metadata
id
type
subtype
author
affiliation
date
location
canonical true
reliability
bias
status published
related
tags

template. These pages lack reliability, bias, and canon_status metadata.

API Reference

Direct POST to https://ephemerawiki.space/maintenance.php:

{
  "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 Instructions:Maintenance/* pages
  • Scheduled maintenance runs