airano-ir
f203ca88de
Three-month batch sync from internal repo (~80 commits) covering Tracks F.5a, F.7e, F.8, F.17, F.18, F.X. WordPress media pipeline - Pillow-based optimization, AI image generation (OpenAI / Stability / Replicate / Google Nano Banana / OpenRouter), chunked + resumable uploads, bulk delete/reassign, idempotent retries. Capability discovery (F.7e) - Per-site credential probe + adapters for WordPress / WooCommerce / Gitea, tier-fit unions granted ∪ roles, capability badge UI with HTMX partial re-check, install hint in every companion-unreachable error. Companion plugin overhaul - Renamed wordpress-plugin/airano-mcp-seo-bridge → wordpress-plugin/airano-mcp-bridge. - Eight new endpoints: /capabilities, /bulk-meta, /export, /cache-purge, /transient-flush, /site-health, /audit-hook, /upload-and-attach. - wp.org Plugin Check pass: i18n, WP_Filesystem, scheme allowlist on audit-hook URL. Other - Gitea ergonomics (F.17): batch files, tree, search, compare, releases, fork. - Opportunistic bcrypt upgrade for legacy SHA-256 admin keys (F.8). - n8n refactor: structured errors, capability probe, missing tools backfilled. - Idempotency-Key dedup for AI media upload retries; WP client fast-fails on unreachable sites. Docs - README + CLAUDE.md drop the fixed "633 tools" claim. The total grows with each release; per-plugin approximations + dashboard-surfaced counts replace it. - Tools/Tests badges removed in favour of "Plugins: 10". Deployment - PyPI mirror chain, optional BUILD_HTTP_PROXY, Alpine→Yandex apk mirror, Debian-slim Plan-B Dockerfile, mirror.gcr.io variant. CI - Black + Ruff clean on Python 3.12; pytest tests/ green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
102 lines
3.6 KiB
Python
102 lines
3.6 KiB
Python
"""F.18.6 — Unified site-health snapshot via companion plugin.
|
|
|
|
Wraps ``GET /airano-mcp/v1/site-health`` (companion plugin v2.6.0+).
|
|
Returns WordPress / PHP / server / database / plugins / theme /
|
|
writability info in a single JSON envelope. Replaces the existing
|
|
``get_site_health`` (which called the stock ``/wp-site-health`` REST
|
|
endpoints) with a richer single-round-trip snapshot.
|
|
|
|
The legacy ``wordpress_get_site_health`` tool (site.py) is left intact;
|
|
this adds a new ``wordpress_site_health`` tool that prefers the
|
|
companion and gracefully reports ``companion_available: false`` when
|
|
the plugin is missing or outdated.
|
|
|
|
Tool: ``wordpress_site_health()``
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import logging
|
|
from typing import Any
|
|
|
|
from plugins.wordpress.client import WordPressClient
|
|
from plugins.wordpress.handlers._companion_hint import (
|
|
companion_install_hint as _companion_install_hint,
|
|
)
|
|
|
|
logger = logging.getLogger("mcphub.wordpress.site_health")
|
|
|
|
|
|
def get_tool_specifications() -> list[dict[str, Any]]:
|
|
return [
|
|
{
|
|
"name": "site_health",
|
|
"method_name": "site_health",
|
|
"description": (
|
|
"Unified site-health snapshot via the airano-mcp-bridge "
|
|
"companion plugin (v2.6.0+). Single request returns WP + PHP + "
|
|
"MySQL versions, loaded PHP extensions, server software + disk "
|
|
"free, active plugins with versions, active theme, and "
|
|
"writability checks. Falls back to `companion_available: false` "
|
|
"when the plugin is missing. Requires manage_options."
|
|
),
|
|
"schema": {"type": "object", "properties": {}},
|
|
"scope": "read",
|
|
}
|
|
]
|
|
|
|
|
|
class SiteHealthHandler:
|
|
"""Unified site-health snapshot via companion plugin."""
|
|
|
|
def __init__(self, client: WordPressClient) -> None:
|
|
self.client = client
|
|
|
|
async def site_health(self) -> str:
|
|
try:
|
|
payload = await self.client.get(
|
|
"airano-mcp/v1/site-health",
|
|
use_custom_namespace=True,
|
|
)
|
|
except Exception as exc: # noqa: BLE001
|
|
logger.debug("site_health companion call failed: %s", exc)
|
|
return json.dumps(
|
|
{
|
|
"ok": False,
|
|
"companion_available": False,
|
|
"error": "companion_unreachable",
|
|
"message": str(exc),
|
|
"hint": (
|
|
"Requires airano-mcp-bridge companion plugin v2.6.0+ "
|
|
"and manage_options capability. Run "
|
|
"wordpress_probe_capabilities to verify. For the legacy "
|
|
"path use wordpress_get_site_health (stock WP endpoints)."
|
|
),
|
|
"install_hint": _companion_install_hint(
|
|
min_version="2.6.0",
|
|
required_capability="manage_options",
|
|
route="airano-mcp/v1/site-health",
|
|
),
|
|
},
|
|
indent=2,
|
|
)
|
|
|
|
if not isinstance(payload, dict):
|
|
return json.dumps(
|
|
{
|
|
"ok": False,
|
|
"companion_available": False,
|
|
"error": "invalid_response",
|
|
"message": "companion returned a non-object payload",
|
|
},
|
|
indent=2,
|
|
)
|
|
|
|
result = {
|
|
"ok": bool(payload.get("ok", True)),
|
|
"companion_available": True,
|
|
**payload,
|
|
}
|
|
return json.dumps(result, indent=2)
|