Refactor help plugin, and included metadata to all plugins

plugins/lastfm.py

@@ -2019,3 +2019,31 @@ async def handle_command(room, message, bot, prefix, config):
             await bot.api.send_text_message(
                 room.room_id, f"❌ Error processing !{command}: {str(e)}"
             )
+
+
+# ---------------------------------------------------------------------------
+# Plugin Metadata
+# ---------------------------------------------------------------------------
+
+__version__ = "1.0.0"
+__author__ = "Funguy Bot"
+__description__ = "Last.fm integration"
+__help__ = """
+<details>
+<summary><strong>!lastfm</strong> – Last.fm music stats (30+ commands)</summary>
+<ul>
+<li><code>!register &lt;username&gt;</code> – Connect account</li>
+<li><code>!np [user]</code> – Now playing</li>
+<li><code>!recent [user] [limit]</code> – Recent tracks</li>
+<li><code>!toptracks</code>, <code>!topartists</code>, <code>!topalbums</code></li>
+<li><code>!loved</code>, <code>!profile</code>, <code>!playcount</code>, <code>!scrobbles</code></li>
+<li><code>!compare &lt;user1&gt; &lt;user2&gt;</code> – Taste comparison</li>
+<li><code>!recommend</code>, <code>!similar &lt;artist&gt;</code>, <code>!tag &lt;genre&gt;</code></li>
+<li><code>!charts</code>, <code>!now</code>, <code>!decades</code>, <code>!genres</code>, <code>!tagcloud</code></li>
+<li><code>!era &lt;year&gt;</code>, <code>!weekly</code>, <code>!monthly</code>, <code>!yearly</code></li>
+<li><code>!first &lt;artist&gt;</code>, <code>!concerts</code>, <code>!radio &lt;artist&gt;</code></li>
+<li><code>!collage [user] [size]</code>, <code>!listening</code>, <code>!awards</code></li>
+</ul>
+<p>For full details: <code>!lastfm</code><br>Requires <strong>LASTFM_API_KEY</strong> env var.</p>
+</details>
+"""