magmascript 3.2.3__tar.gz → 3.3.0__tar.gz

{magmascript-3.2.3 → magmascript-3.3.0}/PKG-INFO

@@ -1,13 +1,11 @@
 Metadata-Version: 2.4
 Name: magmascript
-Version: 3.2.3
+Version: 3.3.0
 Summary: Scripting toolkit with domain-first subcommands
 Author: Jake McCoy
 License-Expression: MIT
 Project-URL: Homepage, https://magmacrunch.com/ware/magmascript/
-Project-URL: Documentation, https://github.com/magmacrunch-media/magmascript/wiki
-Project-URL: Repository, https://github.com/magmacrunch-media/magmascript
-Project-URL: Changelog, https://github.com/magmacrunch-media/magmascript/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://magmacrunch.com/ware/magmascript/
 Project-URL: Funding, https://github.com/sponsors/magmacrunch-media
 Keywords: mcp,scripting,cli,magmacrunch
 Classifier: Development Status :: 3 - Alpha
@@ -421,7 +419,7 @@ this ground was scorched at line 3 (garrisoned at line 1)
 
 `floorplan` is the only new reserved word; everything else is a shadowable
 builtin, so existing scripts are unaffected. Full reference on the
-[Asthenosphere wiki page](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere).
+[Asthenosphere wiki page](wiki/Asthenosphere.md).
 
 ### REPL
 
@@ -678,30 +676,31 @@ gh_workflows             # GitHub commands
 
 ## Documentation
 
-Full documentation on the [Wiki](https://github.com/magmacrunch-media/magmascript/wiki):
-- [MagmaScript Language](https://github.com/magmacrunch-media/magmascript/wiki/MagmaScript-Language)
-- [Configuration](https://github.com/magmacrunch-media/magmascript/wiki/Configuration)
-- [MCP Domain](https://github.com/magmacrunch-media/magmascript/wiki/MCP-Domain)
-- [Pi Domain](https://github.com/magmacrunch-media/magmascript/wiki/Pi-Domain)
-- [MC1 Domain](https://github.com/magmacrunch-media/magmascript/wiki/MC1-Domain)
-- [Mac Domain](https://github.com/magmacrunch-media/magmascript/wiki/Mac-Domain)
-- [GitHub Domain](https://github.com/magmacrunch-media/magmascript/wiki/GitHub-Domain)
-- [Scores Domain](https://github.com/magmacrunch-media/magmascript/wiki/Scores-Domain)
-- [Rights Domain](https://github.com/magmacrunch-media/magmascript/wiki/Rights-Domain)
-- [Archive Domain](https://github.com/magmacrunch-media/magmascript/wiki/Archive-Domain)
-- [Last.fm Domain](https://github.com/magmacrunch-media/magmascript/wiki/Last.fm-Domain)
-- [MusicBrainz Domain](https://github.com/magmacrunch-media/magmascript/wiki/MusicBrainz-Domain)
-- [Search Domain](https://github.com/magmacrunch-media/magmascript/wiki/Search-Domain)
-- [Media Domain](https://github.com/magmacrunch-media/magmascript/wiki/Media-Domain)
-- [Example Scripts](https://github.com/magmacrunch-media/magmascript/wiki/Example-Scripts)
-- [Asthenosphere](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere)
-- [Architecture](https://github.com/magmacrunch-media/magmascript/wiki/Architecture)
+Full documentation on the [Wiki](wiki/):
+- [MagmaScript Language](wiki/MagmaScript-Language.md)
+- [Configuration](wiki/Configuration.md)
+- [MCP Domain](wiki/MCP-Domain.md)
+- [Pi Domain](wiki/Pi-Domain.md)
+- [MC1 Domain](wiki/MC1-Domain.md)
+- [Mac Domain](wiki/Mac-Domain.md)
+- [GitHub Domain](wiki/GitHub-Domain.md)
+- [Scores Domain](wiki/Scores-Domain.md)
+- [Rights Domain](wiki/Rights-Domain.md)
+- [Archive Domain](wiki/Archive-Domain.md)
+- [Last.fm Domain](wiki/Last.fm-Domain.md)
+- [MusicBrainz Domain](wiki/MusicBrainz-Domain.md)
+- [Search Domain](wiki/Search-Domain.md)
+- [Media Domain](wiki/Media-Domain.md)
+- [Example Scripts](wiki/Example-Scripts.md)
+- [Asthenosphere](wiki/Asthenosphere.md)
+- [Architecture](wiki/Architecture.md)
 
 ## Support This Project
 
 If you find magmascript useful, consider supporting its development:
 
 [![Sponsor](https://img.shields.io/badge/%E2%9D%A4_Sponsor-pink)](https://github.com/sponsors/magmacrunch-media)
+[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue)](https://www.paypal.biz/magmacrunchmedia)
 
 ## License
 

{magmascript-3.2.3 → magmascript-3.3.0}/README.md

@@ -383,7 +383,7 @@ this ground was scorched at line 3 (garrisoned at line 1)
 
 `floorplan` is the only new reserved word; everything else is a shadowable
 builtin, so existing scripts are unaffected. Full reference on the
-[Asthenosphere wiki page](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere).
+[Asthenosphere wiki page](wiki/Asthenosphere.md).
 
 ### REPL
 
@@ -640,30 +640,31 @@ gh_workflows             # GitHub commands
 
 ## Documentation
 
-Full documentation on the [Wiki](https://github.com/magmacrunch-media/magmascript/wiki):
-- [MagmaScript Language](https://github.com/magmacrunch-media/magmascript/wiki/MagmaScript-Language)
-- [Configuration](https://github.com/magmacrunch-media/magmascript/wiki/Configuration)
-- [MCP Domain](https://github.com/magmacrunch-media/magmascript/wiki/MCP-Domain)
-- [Pi Domain](https://github.com/magmacrunch-media/magmascript/wiki/Pi-Domain)
-- [MC1 Domain](https://github.com/magmacrunch-media/magmascript/wiki/MC1-Domain)
-- [Mac Domain](https://github.com/magmacrunch-media/magmascript/wiki/Mac-Domain)
-- [GitHub Domain](https://github.com/magmacrunch-media/magmascript/wiki/GitHub-Domain)
-- [Scores Domain](https://github.com/magmacrunch-media/magmascript/wiki/Scores-Domain)
-- [Rights Domain](https://github.com/magmacrunch-media/magmascript/wiki/Rights-Domain)
-- [Archive Domain](https://github.com/magmacrunch-media/magmascript/wiki/Archive-Domain)
-- [Last.fm Domain](https://github.com/magmacrunch-media/magmascript/wiki/Last.fm-Domain)
-- [MusicBrainz Domain](https://github.com/magmacrunch-media/magmascript/wiki/MusicBrainz-Domain)
-- [Search Domain](https://github.com/magmacrunch-media/magmascript/wiki/Search-Domain)
-- [Media Domain](https://github.com/magmacrunch-media/magmascript/wiki/Media-Domain)
-- [Example Scripts](https://github.com/magmacrunch-media/magmascript/wiki/Example-Scripts)
-- [Asthenosphere](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere)
-- [Architecture](https://github.com/magmacrunch-media/magmascript/wiki/Architecture)
+Full documentation on the [Wiki](wiki/):
+- [MagmaScript Language](wiki/MagmaScript-Language.md)
+- [Configuration](wiki/Configuration.md)
+- [MCP Domain](wiki/MCP-Domain.md)
+- [Pi Domain](wiki/Pi-Domain.md)
+- [MC1 Domain](wiki/MC1-Domain.md)
+- [Mac Domain](wiki/Mac-Domain.md)
+- [GitHub Domain](wiki/GitHub-Domain.md)
+- [Scores Domain](wiki/Scores-Domain.md)
+- [Rights Domain](wiki/Rights-Domain.md)
+- [Archive Domain](wiki/Archive-Domain.md)
+- [Last.fm Domain](wiki/Last.fm-Domain.md)
+- [MusicBrainz Domain](wiki/MusicBrainz-Domain.md)
+- [Search Domain](wiki/Search-Domain.md)
+- [Media Domain](wiki/Media-Domain.md)
+- [Example Scripts](wiki/Example-Scripts.md)
+- [Asthenosphere](wiki/Asthenosphere.md)
+- [Architecture](wiki/Architecture.md)
 
 ## Support This Project
 
 If you find magmascript useful, consider supporting its development:
 
 [![Sponsor](https://img.shields.io/badge/%E2%9D%A4_Sponsor-pink)](https://github.com/sponsors/magmacrunch-media)
+[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue)](https://www.paypal.biz/magmacrunchmedia)
 
 ## License
 

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript/__init__.py

@@ -1,6 +1,15 @@
 """magmascript — a scripting toolkit with domain-first subcommands."""
 
-__version__ = "3.2.2"
+# The version lives in pyproject.toml alone. It was also a literal here, and the
+# two drifted: 3.2.3 shipped reporting itself as 3.2.2, in the REPL banner and
+# in the MCP client's User-Agent.
+from importlib.metadata import PackageNotFoundError as _PackageNotFoundError
+from importlib.metadata import version as _version
+
+try:
+    __version__ = _version("magmascript")
+except _PackageNotFoundError:  # running from a source tree that was never installed
+    __version__ = "0+unknown"
 
 from magmascript.core.config import Config, GHConfig, MediaConfig, MC1Config, PIConfig, get_config, load_config, set_config
 from magmascript.core.registry import get_domain, list_domains, register_domain

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript/cli.py

@@ -11,6 +11,7 @@ from __future__ import annotations
 
 import json
 import sys
+from datetime import datetime
 from functools import wraps
 from typing import Callable
 
@@ -66,7 +67,12 @@ def _generate_channels_js(channels: list[dict]) -> str:
 
 # -- register domain commands --------------------------------------------
 
+_DOMAINS_REGISTERED = False
+
+
 def _register_domains():
+    global _DOMAINS_REGISTERED
+
     from magmascript.domains.mcp import MCPClient
     from magmascript.domains.pi import PIClient
     from magmascript.domains.mac import MacClient
@@ -138,6 +144,8 @@ def _register_domains():
 
     register("search", "Site search index builder")(_search_handler)
 
+    _DOMAINS_REGISTERED = True
+
 
 # -- register built-in meta commands ------------------------------------
 
@@ -437,8 +445,15 @@ def main():
         no_cache = True
         rest.remove("--no-cache")
 
-    # Register domain commands (lazy, on first use)
-    if not COMMANDS:
+    # Register domain commands (lazy, on first use).
+    #
+    # This was `if not COMMANDS:`, which assumed the table starts empty. It did
+    # until 3.2.2 registered the built-in commands (run, repl, cache, ...) with
+    # @register at import. From then on COMMANDS was never empty, this never
+    # ran, and every domain command -- archive, mb, lastfm, scores, search and
+    # the rest -- failed as "Unknown domain" in 3.2.2 and 3.2.3. A flag says
+    # what is actually meant: have the domains been registered yet.
+    if not _DOMAINS_REGISTERED:
         _register_domains()
 
     try:

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript/domains/archive/client.py

@@ -98,7 +98,7 @@ class ArchiveClient:
             "events": "c-events",
             "games": "c-games",
             "links": "c-links",
-            "music videos": "c-music-videos",
+            "videos": "c-videos",
             "network": "c-network",
             "documentary": "c-documentary",
             "personnel": "c-personnel",

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript/domains/mc1/client.py

@@ -5,9 +5,11 @@ Supports SSH (remote) execution mode for managing MC1.
 
 from __future__ import annotations
 
+import re
 import subprocess
 
 from magmascript.core.config import Config, get_config
+from magmascript.core.exceptions import MagmascriptError, SSHError
 from magmascript.core.runner import CommandRunner
 from magmascript.domains.mc1.tools import (
     MC1PowerSettings,
@@ -18,6 +20,8 @@ from magmascript.domains.mc1.tools import (
     parse_system_info,
 )
 
+_MAC_RE = re.compile(r"^[0-9A-Fa-f]{2}(?::[0-9A-Fa-f]{2}){5}$")
+
 
 class MC1Client:
     """Direct client for MC1 Windows PC management.
@@ -32,6 +36,10 @@ class MC1Client:
         self._user = cfg.mc1.user
         self._local = local
         self._runner = CommandRunner(cfg.mc1.host, cfg.mc1.user, local=local)
+        # Wake-on-LAN relays through the Pi, which shares MC1's broadcast
+        # domain. See wake_on_lan for why that is not optional.
+        self._pi_host = cfg.pi.host
+        self._pi_user = cfg.pi.user
 
     # ------------------------------------------------------------------
     # Service management
@@ -141,26 +149,107 @@ class MC1Client:
     # Wake-on-LAN
     # ------------------------------------------------------------------
 
-    def wake_on_lan(self, mac_address: str) -> str:
-        """Send Wake-on-LAN magic packet to MC1.
+    def wake_on_lan(self, mac_address: str, *, relay: bool = True) -> str:
+        """Send Wake-on-LAN magic packets to MC1 by every available route.
+
+        A magic packet is addressed to 255.255.255.255:9, which is **never
+        routed**, so a direct send reaches MC1 only from MC1's own subnet and
+        silently reaches nothing from anywhere else. The Pi is always on that
+        subnet and is reachable over the tailnet from anywhere, so it is used as
+        a relay as well. Both are sent rather than guessing which network this
+        machine is on, because the loser costs about a second and there is no
+        location test to get wrong.
+
+        This is the same fix the Mac's ~/bin/wake-mc1 got on 2026-10-09, after
+        being direct-only meant waking MC1 from away did nothing while the same
+        command worked at home.
 
-        This runs the `wakeonlan` command on the Pi (or local machine).
-        The MAC address should be MC1's ethernet adapter MAC.
+        Note `wakeonlan` exits 0 whenever the datagram left the host, which says
+        nothing about where it went. So this reports the routes that ACCEPTED a
+        packet and never claims MC1 is awake. It does not poll; nothing here can
+        confirm a wake.
 
         Args:
-            mac_address: Ethernet MAC address (e.g. "A0:AD:9F:A4:72:97" or "A0-AD-9F-A4-72-97")
+            mac_address: Ethernet MAC, ":" or "-" separated
+                (e.g. "A0:AD:9F:A4:72:97" or "A0-AD-9F-A4-72-97").
+            relay: Set False to send direct only and skip the Pi.
 
         Returns:
-            Success message
+            A message naming each route tried and whether it took the packet.
+
+        Raises:
+            ValueError: if mac_address is not six hex octets.
+            MagmascriptError: if no route accepted the packet.
         """
-        # Normalize MAC address format (wakeonlan accepts both : and - separators)
-        normalized_mac = mac_address.replace("-", ":")
-        subprocess.run(
-            ["wakeonlan", normalized_mac],
-            capture_output=True,
-            timeout=10,
-        )
-        return f"✓ Wake-on-LAN packet sent to {normalized_mac}"
+        # wakeonlan accepts both separators, so normalise before validating.
+        mac = mac_address.replace("-", ":")
+        if not _MAC_RE.match(mac):
+            raise ValueError(
+                f"not a MAC address: {mac_address!r} "
+                "(expected six hex octets, e.g. A0:AD:9F:A4:72:97)"
+            )
+
+        lines: list[str] = []
+        accepted = 0
+
+        if self._wol_direct(mac):
+            lines.append("  direct broadcast sent (reaches MC1 only from its own subnet)")
+            accepted += 1
+        else:
+            lines.append("  direct broadcast FAILED (is wakeonlan installed here?)")
+
+        if relay:
+            if not self._pi_host:
+                lines.append(
+                    "  relay SKIPPED: no [pi] host configured, so this is "
+                    "home-only. Set pi.host in ~/.config/magmascript/config.toml"
+                )
+            elif self._wol_relay(mac):
+                lines.append(
+                    f"  relayed via {self._pi_host} (reaches MC1 from any network)"
+                )
+                accepted += 1
+            else:
+                lines.append(f"  relay via {self._pi_host} FAILED")
+
+        report = "\n".join(lines)
+        if not accepted:
+            raise MagmascriptError(
+                f"no route accepted a Wake-on-LAN packet for {mac}:\n{report}"
+            )
+        return f"Wake-on-LAN packet for {mac}:\n{report}"
+
+    @staticmethod
+    def _wol_direct(mac: str) -> bool:
+        """Broadcast on this machine's own subnet.
+
+        False rather than raising when `wakeonlan` is missing, which it is on
+        Windows, so the relay can still carry the packet.
+        """
+        try:
+            result = subprocess.run(
+                ["wakeonlan", mac],
+                capture_output=True,
+                timeout=10,
+                check=False,  # the exit status is the return value, not an error
+            )
+        except (OSError, subprocess.SubprocessError):
+            return False
+        return result.returncode == 0
+
+    def _wol_relay(self, mac: str) -> bool:
+        """Run `wakeonlan` on the Pi, which shares MC1's broadcast domain.
+
+        `mac` is interpolated into a command a remote shell parses, so it must
+        already have passed _MAC_RE.
+        """
+        try:
+            CommandRunner(self._pi_host, self._pi_user).run(
+                f"wakeonlan {mac}", timeout=15
+            )
+        except SSHError:
+            return False
+        return True
 
     # ------------------------------------------------------------------
     # Power management

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript/domains/mcp/client.py

@@ -43,6 +43,14 @@ from magmascript.domains.mcp.tools import (
 )
 
 
+def _user_agent() -> str:
+    # Imported here, not at module level: magmascript/__init__.py imports this
+    # module. It was a literal "magmascript/3.2.2", still sent by 3.2.3.
+    from magmascript import __version__
+
+    return f"magmascript/{__version__} (https://github.com/magmacrunch-media/magmascript)"
+
+
 def _wrap_mcp_error(e: Exception, context: str = "") -> Exception:
     """Wrap RPC and HTTP exceptions into typed magmascript errors."""
     if isinstance(e, RPCError):
@@ -262,7 +270,7 @@ class MCPClient:
         """Search MusicBrainz for releases by query string."""
         url = "https://musicbrainz.org/ws/2/release/"
         params = {"query": query, "fmt": "json", "limit": limit}
-        headers = {"User-Agent": "magmascript/3.2.2 (https://github.com/magmacrunch-media/magmascript)"}
+        headers = {"User-Agent": _user_agent()}
         try:
             resp = httpx.get(url, params=params, headers=headers, timeout=10.0)
             resp.raise_for_status()
@@ -275,7 +283,7 @@ class MCPClient:
         """Get full release details including track list with recordings."""
         url = f"https://musicbrainz.org/ws/2/release/{mbid}"
         params = {"fmt": "json", "inc": "artist-credits+recordings"}
-        headers = {"User-Agent": "magmascript/3.2.2 (https://github.com/magmacrunch-media/magmascript)"}
+        headers = {"User-Agent": _user_agent()}
         try:
             resp = httpx.get(url, params=params, headers=headers, timeout=10.0)
             resp.raise_for_status()
@@ -288,7 +296,7 @@ class MCPClient:
         """Get recording details including ISRCs and work relationships."""
         url = f"https://musicbrainz.org/ws/2/recording/{mbid}"
         params = {"fmt": "json", "inc": "artist-credits+isrcs+work-rels"}
-        headers = {"User-Agent": "magmascript/3.2.2 (https://github.com/magmacrunch-media/magmascript)"}
+        headers = {"User-Agent": _user_agent()}
         try:
             resp = httpx.get(url, params=params, headers=headers, timeout=10.0)
             resp.raise_for_status()

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript.egg-info/PKG-INFO

@@ -1,13 +1,11 @@
 Metadata-Version: 2.4
 Name: magmascript
-Version: 3.2.3
+Version: 3.3.0
 Summary: Scripting toolkit with domain-first subcommands
 Author: Jake McCoy
 License-Expression: MIT
 Project-URL: Homepage, https://magmacrunch.com/ware/magmascript/
-Project-URL: Documentation, https://github.com/magmacrunch-media/magmascript/wiki
-Project-URL: Repository, https://github.com/magmacrunch-media/magmascript
-Project-URL: Changelog, https://github.com/magmacrunch-media/magmascript/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://magmacrunch.com/ware/magmascript/
 Project-URL: Funding, https://github.com/sponsors/magmacrunch-media
 Keywords: mcp,scripting,cli,magmacrunch
 Classifier: Development Status :: 3 - Alpha
@@ -421,7 +419,7 @@ this ground was scorched at line 3 (garrisoned at line 1)
 
 `floorplan` is the only new reserved word; everything else is a shadowable
 builtin, so existing scripts are unaffected. Full reference on the
-[Asthenosphere wiki page](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere).
+[Asthenosphere wiki page](wiki/Asthenosphere.md).
 
 ### REPL
 
@@ -678,30 +676,31 @@ gh_workflows             # GitHub commands
 
 ## Documentation
 
-Full documentation on the [Wiki](https://github.com/magmacrunch-media/magmascript/wiki):
-- [MagmaScript Language](https://github.com/magmacrunch-media/magmascript/wiki/MagmaScript-Language)
-- [Configuration](https://github.com/magmacrunch-media/magmascript/wiki/Configuration)
-- [MCP Domain](https://github.com/magmacrunch-media/magmascript/wiki/MCP-Domain)
-- [Pi Domain](https://github.com/magmacrunch-media/magmascript/wiki/Pi-Domain)
-- [MC1 Domain](https://github.com/magmacrunch-media/magmascript/wiki/MC1-Domain)
-- [Mac Domain](https://github.com/magmacrunch-media/magmascript/wiki/Mac-Domain)
-- [GitHub Domain](https://github.com/magmacrunch-media/magmascript/wiki/GitHub-Domain)
-- [Scores Domain](https://github.com/magmacrunch-media/magmascript/wiki/Scores-Domain)
-- [Rights Domain](https://github.com/magmacrunch-media/magmascript/wiki/Rights-Domain)
-- [Archive Domain](https://github.com/magmacrunch-media/magmascript/wiki/Archive-Domain)
-- [Last.fm Domain](https://github.com/magmacrunch-media/magmascript/wiki/Last.fm-Domain)
-- [MusicBrainz Domain](https://github.com/magmacrunch-media/magmascript/wiki/MusicBrainz-Domain)
-- [Search Domain](https://github.com/magmacrunch-media/magmascript/wiki/Search-Domain)
-- [Media Domain](https://github.com/magmacrunch-media/magmascript/wiki/Media-Domain)
-- [Example Scripts](https://github.com/magmacrunch-media/magmascript/wiki/Example-Scripts)
-- [Asthenosphere](https://github.com/magmacrunch-media/magmascript/wiki/Asthenosphere)
-- [Architecture](https://github.com/magmacrunch-media/magmascript/wiki/Architecture)
+Full documentation on the [Wiki](wiki/):
+- [MagmaScript Language](wiki/MagmaScript-Language.md)
+- [Configuration](wiki/Configuration.md)
+- [MCP Domain](wiki/MCP-Domain.md)
+- [Pi Domain](wiki/Pi-Domain.md)
+- [MC1 Domain](wiki/MC1-Domain.md)
+- [Mac Domain](wiki/Mac-Domain.md)
+- [GitHub Domain](wiki/GitHub-Domain.md)
+- [Scores Domain](wiki/Scores-Domain.md)
+- [Rights Domain](wiki/Rights-Domain.md)
+- [Archive Domain](wiki/Archive-Domain.md)
+- [Last.fm Domain](wiki/Last.fm-Domain.md)
+- [MusicBrainz Domain](wiki/MusicBrainz-Domain.md)
+- [Search Domain](wiki/Search-Domain.md)
+- [Media Domain](wiki/Media-Domain.md)
+- [Example Scripts](wiki/Example-Scripts.md)
+- [Asthenosphere](wiki/Asthenosphere.md)
+- [Architecture](wiki/Architecture.md)
 
 ## Support This Project
 
 If you find magmascript useful, consider supporting its development:
 
 [![Sponsor](https://img.shields.io/badge/%E2%9D%A4_Sponsor-pink)](https://github.com/sponsors/magmacrunch-media)
+[![PayPal](https://img.shields.io/badge/Donate-PayPal-blue)](https://www.paypal.biz/magmacrunchmedia)
 
 ## License
 

{magmascript-3.2.3 → magmascript-3.3.0}/magmascript.egg-info/SOURCES.txt

@@ -87,6 +87,7 @@ tests/test_astheno.py
 tests/test_cache.py
 tests/test_classes.py
 tests/test_cli.py
+tests/test_cli_regressions.py
 tests/test_commands.py
 tests/test_domain_bridge.py
 tests/test_import.py

{magmascript-3.2.3 → magmascript-3.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magmascript"
-version = "3.2.3"
+version = "3.3.0"
 description = "Scripting toolkit with domain-first subcommands"
 readme = "README.md"
 license = "MIT"
@@ -48,10 +48,20 @@ all = [
 magmascript = "magmascript.cli:main"
 
 [project.urls]
+# EVERY LINK HERE HAS TO BE PUBLIC, because this is what PyPI puts on the
+# project page for anyone who finds the package. The repository went private on
+# 2026-10-03, which 404'd three of the five: Documentation (it pointed at the
+# wiki, and a private repo's wiki is turned off entirely), Repository, and
+# Changelog, which was a blob link into the repo.
+#
+# They are removed rather than repointed. There is no public repository or
+# changelog to send anyone to, and an absent link is better than one that 404s
+# from the package's own front page.
+#
+# NOTE a published release's metadata is frozen. Fixing this file only affects
+# the NEXT release; the pages for 3.2.4 and earlier keep the dead links.
 Homepage = "https://magmacrunch.com/ware/magmascript/"
-Documentation = "https://github.com/magmacrunch-media/magmascript/wiki"
-Repository = "https://github.com/magmacrunch-media/magmascript"
-Changelog = "https://github.com/magmacrunch-media/magmascript/blob/main/CHANGELOG.md"
+Documentation = "https://magmacrunch.com/ware/magmascript/"
 Funding = "https://github.com/sponsors/magmacrunch-media"
 
 [tool.setuptools.packages.find]

{magmascript-3.2.3 → magmascript-3.3.0}/tests/test_cli.py

@@ -5,9 +5,26 @@ from unittest.mock import MagicMock, patch
 
 import pytest
 
+from magmascript import cli
 from magmascript.cli import main
 
 
+@pytest.fixture(autouse=True)
+def fresh_domain_registration():
+    """Register the domains again inside each test.
+
+    Registration binds each domain's client class once, at first use, so the
+    first test to reach it would fix its own patched MCPClient in place for
+    every later test -- test_scoreboards_action then asserts against a mock the
+    handler never calls. This order dependence was hidden while registration
+    never ran at all (3.2.2 and 3.2.3, where these tests failed as "Unknown
+    domain" instead).
+    """
+    cli._DOMAINS_REGISTERED = False
+    yield
+    cli._DOMAINS_REGISTERED = False
+
+
 class TestCLI:
     def test_help_exits(self):
         with pytest.raises(SystemExit) as exc_info:

magmascript-3.3.0/tests/test_cli_regressions.py

@@ -0,0 +1,99 @@
+"""Regression tests for the three faults fixed in 3.2.4.
+
+Each of these shipped. The first two broke the website's bots and CI. The third
+left `archive check-format` blind to the site's "videos" buttons: a label
+missing from its map is not checked at all, so a wrong class there passed.
+"""
+
+from unittest.mock import MagicMock, patch
+
+import pytest
+
+from magmascript import cli
+from magmascript.cli import COMMANDS, main
+from magmascript.domains.archive import ArchiveClient
+from magmascript.domains.scores.tools import PlayerStats, ScoresReport
+
+
+class TestDomainRegistration:
+    """3.2.2 and 3.2.3: every domain command was "Unknown domain".
+
+    Registration ran only `if not COMMANDS`, and the built-in commands had
+    started registering themselves at import, so the table was never empty.
+    """
+
+    def test_builtins_are_registered_at_import(self):
+        # The precondition that exposed the bug. If this stops holding, the
+        # test below no longer exercises it.
+        assert "run" in COMMANDS
+
+    @pytest.mark.parametrize("domain", ["archive", "mb", "lastfm", "scores", "search"])
+    def test_domain_commands_are_reachable(self, domain, capsys):
+        with patch("sys.argv", ["magmascript", domain, "--help"]):
+            try:
+                main()
+            except SystemExit:
+                pass
+        assert "Unknown domain" not in capsys.readouterr().err
+        assert domain in COMMANDS
+        assert cli._DOMAINS_REGISTERED
+
+
+class TestScoresReportPostDiscussion:
+    """Every release: `scores report --post-discussion` raised NameError.
+
+    cli.py called datetime.now() without importing datetime, so the report
+    printed and the Discussion was never posted.
+    """
+
+    def test_posts_with_a_dated_title(self, capsys):
+        client = MagicMock()
+        client.report.return_value = ScoresReport(
+            generated_at="September 16, 2026",
+            total_games=0,
+            total_scores=0,
+            scoreboards=[],
+            player_stats=[PlayerStats(name="JAM", total_entries=1, games_played=1)],
+        )
+        gh = MagicMock()
+        gh.create_discussion.return_value = "https://example.invalid/discussions/1"
+
+        with patch("magmascript.core.config.get_config"), \
+             patch("magmascript.domains.gh.GHClient", return_value=gh):
+            cli._dispatch_scores("report", ["--post-discussion"], client, "table")
+
+        title, body, category = gh.create_discussion.call_args.args
+        assert title.startswith("Weekly High Scores — 20")
+        assert "# Weekly High Scores" in body
+        assert category == "high-scores"
+        gh.close.assert_called_once()
+
+
+class TestArchiveVideosLabel:
+    """The site renamed the artist "music videos" pages to "videos" (website
+    53dc9606). With the old map, "videos" was not a known label, so the checker
+    skipped those buttons -- 34 of them on the site at the time -- and the
+    mismatch below went unreported."""
+
+    CSS = ".nav-card.c-videos { color: red; }\n.nav-card.c-music-videos { color: red; }\n"
+
+    def _page(self, tmp_path, cls):
+        artist = tmp_path / "archive" / "by-artist" / "someone"
+        artist.mkdir(parents=True)
+        (artist / "someone-shared.css").write_text(self.CSS, encoding="utf-8")
+        (artist / "about.html").write_text(
+            '<div class="sub-nav">\n'
+            '    <a href="./" class="nav-card c-back">← back</a>\n'
+            f'    <a href="videos.html" class="nav-card {cls}">videos</a>\n'
+            '</div>\n',
+            encoding="utf-8",
+        )
+        return ArchiveClient(project_root=tmp_path)
+
+    def test_videos_link_with_videos_class_is_clean(self, tmp_path):
+        assert self._page(tmp_path, "c-videos").check_format() == []
+
+    def test_videos_link_with_old_class_warns(self, tmp_path):
+        warnings = self._page(tmp_path, "c-music-videos").check_format()
+        assert len(warnings) == 1
+        assert "expected c-videos" in warnings[0].msg

{magmascript-3.2.3 → magmascript-3.3.0}/tests/test_mc1.py

@@ -156,3 +156,125 @@ class TestRegistration:
         from magmascript.core.config import load_config
 
         assert load_config().mc1.host == "9.9.9.9"
+
+
+class TestWakeOnLan:
+    """`mc1 wake` sends by BOTH routes.
+
+    A magic packet goes to 255.255.255.255:9, which is never routed, so a
+    direct send reaches MC1 only from MC1's own subnet. Direct-only is what
+    made the Mac's wake-mc1 silently do nothing from off that subnet, and
+    these are the checks that would have caught it.
+    """
+
+    def _client(self, *, pi_host="10.0.0.9", pi_user="jake"):
+        from magmascript.core.config import Config, MC1Config, PIConfig
+        from magmascript.domains.mc1 import MC1Client
+
+        return MC1Client(
+            Config(
+                mc1=MC1Config(host="1.2.3.4", user="someone"),
+                pi=PIConfig(host=pi_host, user=pi_user),
+            )
+        )
+
+    def _stub(self, monkeypatch, client, *, direct, relay):
+        """Record calls and report the given per-route outcomes."""
+        calls = []
+        monkeypatch.setattr(
+            type(client),
+            "_wol_direct",
+            staticmethod(lambda mac: (calls.append(("direct", mac)), direct)[1]),
+        )
+        monkeypatch.setattr(
+            type(client),
+            "_wol_relay",
+            lambda self, mac: (calls.append(("relay", mac)), relay)[1],
+        )
+        return calls
+
+    def test_sends_both_routes(self, monkeypatch):
+        client = self._client()
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        out = client.wake_on_lan("A0:AD:9F:A4:72:97")
+        assert [c[0] for c in calls] == ["direct", "relay"]
+        assert "direct broadcast sent" in out
+        assert "relayed via 10.0.0.9" in out
+
+    def test_relay_carries_it_when_direct_fails(self, monkeypatch):
+        """The off-LAN case: no local wakeonlan, Pi still delivers."""
+        client = self._client()
+        self._stub(monkeypatch, client, direct=False, relay=True)
+        out = client.wake_on_lan("A0:AD:9F:A4:72:97")
+        assert "direct broadcast FAILED" in out
+        assert "relayed via 10.0.0.9" in out
+
+    def test_direct_carries_it_when_relay_fails(self, monkeypatch):
+        client = self._client()
+        self._stub(monkeypatch, client, direct=True, relay=False)
+        out = client.wake_on_lan("A0:AD:9F:A4:72:97")
+        assert "direct broadcast sent" in out
+        assert "relay via 10.0.0.9 FAILED" in out
+
+    def test_raises_when_no_route_accepts(self, monkeypatch):
+        from magmascript.core.exceptions import MagmascriptError
+
+        client = self._client()
+        self._stub(monkeypatch, client, direct=False, relay=False)
+        try:
+            client.wake_on_lan("A0:AD:9F:A4:72:97")
+        except MagmascriptError as e:
+            assert "no route accepted" in str(e)
+        else:
+            raise AssertionError("expected MagmascriptError when both routes fail")
+
+    def test_unconfigured_pi_is_named_not_silently_skipped(self, monkeypatch):
+        """A missing [pi] host makes this home-only, so it must say so."""
+        client = self._client(pi_host="", pi_user="")
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        out = client.wake_on_lan("A0:AD:9F:A4:72:97")
+        assert [c[0] for c in calls] == ["direct"]
+        assert "relay SKIPPED" in out
+        assert "home-only" in out
+
+    def test_relay_false_skips_the_pi(self, monkeypatch):
+        client = self._client()
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        client.wake_on_lan("A0:AD:9F:A4:72:97", relay=False)
+        assert [c[0] for c in calls] == ["direct"]
+
+    def test_hyphens_are_normalised(self, monkeypatch):
+        client = self._client()
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        client.wake_on_lan("A0-AD-9F-A4-72-97")
+        assert {c[1] for c in calls} == {"A0:AD:9F:A4:72:97"}
+
+    def test_rejects_a_non_mac(self, monkeypatch):
+        client = self._client()
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        for bad in ("", "nope", "A0:AD:9F:A4:72", "A0:AD:9F:A4:72:97:FF", "ZZ:..."):
+            try:
+                client.wake_on_lan(bad)
+            except ValueError:
+                pass
+            else:
+                raise AssertionError(f"expected ValueError for {bad!r}")
+        assert calls == [], "nothing may be sent for a malformed MAC"
+
+    def test_rejects_shell_injection_before_sending(self, monkeypatch):
+        """The relay interpolates the MAC into a command a remote shell parses."""
+        client = self._client()
+        calls = self._stub(monkeypatch, client, direct=True, relay=True)
+        for bad in (
+            "A0:AD:9F:A4:72:97; touch /tmp/pwned",
+            "A0:AD:9F:A4:72:97 && reboot",
+            "$(reboot)",
+            "`reboot`",
+        ):
+            try:
+                client.wake_on_lan(bad)
+            except ValueError:
+                pass
+            else:
+                raise AssertionError(f"expected ValueError for {bad!r}")
+        assert calls == []