plugin-uninstall

name	plugin-uninstall
description	Uninstall an EvoNexus plugin, reverting the files it copied and running its uninstall.sql. Use when the user asks to remove, uninstall, or delete a plugin. Triggers on "desinstala plugin X", "remove plugin X", "uninstall plugin X", "tira o plugin Y".
metadata	{"category":"plugins","version":"1.0.0"}

Plugin Uninstall

Remove a plugin from the workspace using DELETE /api/plugins/<slug>. Uninstall is reverse-order via .install-manifest.json.

How to use

Step 1 — Resolve the slug

If not given, call list and ask which one:

from dashboard.backend.sdk_client import evo

plugins = evo.get("/api/plugins")

Validate exists:

detail = evo.get(f"/api/plugins/{slug}")

If HTTP 404, say so and stop.

Step 2 — Show what will be removed

Read manifest from detail. Summarise:

• Files in .claude/agents/plugin-<slug>-*.md, .claude/skills/plugin-<slug>-*/, .claude/commands/plugin-<slug>-*.md, .claude/rules/plugin-<slug>-*.md
• Heartbeats registered by the plugin (disappear from /heartbeats)
• Routines (scheduler SIGHUP reload on removal)
• Claude hook handlers under plugins/<slug>/claude-hook-handlers/
• Contents of migrations/uninstall.sql — full text
• Contents of hooks/pre-uninstall.sh and hooks/post-uninstall.sh — full text

Important: user data created inside plugin-managed tables is usually DROPped by uninstall SQL. Tell the user explicitly and ask if they want to export first.

Step 3 — Require explicit confirmation

Accept only clear affirmatives. If user hesitates, offer:

• Export first via GET /api/plugins/<slug>/readonly-data/<query> if declared
• Disable instead of remove: evo.patch(f"/api/plugins/{slug}", {"enabled": False}) — reversible, keeps data

Step 4 — Run uninstall

evo.delete(f"/api/plugins/{slug}")

Step 5 — Report

On success, summarise: files removed, tables dropped, hooks cleared. Point to /plugins for confirmation.

Error handling

• HTTP 404 not_found — slug doesn't exist. Reprompt.
• HTTP 409 uninstall_failed — reverse-order chain failed. Surface specific step. Offer manual recovery (delete plugins/<slug>/ after fixing, then retry).
• HTTP 500 sql_rollback_failed — rare. DB may be inconsistent. Check ADWs/logs/plugins/.

Notes for the agent

• Disable ≠ uninstall. Disable keeps data and is reversible.
• If plugin has routines, scheduler reloads automatically. If offline, user must restart.