magmascript 2.1.0__tar.gz → 2.2.0__tar.gz

{magmascript-2.1.0 → magmascript-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: magmascript
-Version: 2.1.0
+Version: 2.2.0
 Summary: Scripting toolkit with domain-first subcommands
 Author: Jake McCoy
 License-Expression: MIT
@@ -85,11 +85,14 @@ Write `.mgs` scripts using a Python-inspired mini language with direct access to
 ### Quick Start
 
 ```bash
-# Run a script
-magmascript run scripts/examples/hello.mgs
+# Run a script (shorthand)
+magmascript scripts/examples/hello.mgs
 
 # Run with arguments
-magmascript run scripts/examples/top-scores.mgs tetris
+magmascript scripts/examples/top-scores.mgs tetris
+
+# Or use the explicit run subcommand
+magmascript run scripts/examples/hello.mgs
 
 # Start interactive REPL
 magmascript repl
@@ -289,6 +292,7 @@ if "xyz" not in "hello" { ... }
 | Function | Description |
 |----------|-------------|
 | `print(...)` | Print to stdout |
+| `echo(...)` | Print to stdout (alias for print) |
 | `len(x)` | Length of string, list, or dict |
 | `type(x)` | Type name as string |
 | `range(n)`, `range(start, stop)`, `range(start, stop, step)` | Generate integer ranges |
@@ -338,6 +342,32 @@ See `scripts/examples/` for working examples:
 | `real-domains.mgs` | Test real domain connections (MCP search, scoreboards, games) |
 | `domain-example.mgs` | Domain object overview and usage patterns |
 
+### REPL
+
+Start an interactive MagmaScript session:
+
+```bash
+magmascript repl
+```
+
+**Features:**
+- Syntax highlighting via Pygments
+- Tab completion for keywords, builtins, domain methods, and user-defined variables
+- Persistent history across sessions (`~/.magmascript_history`)
+- Multiline editing with proper continuation prompts
+- Dot-commands:
+
+| Command | Description |
+|---------|-------------|
+| `.help` | Show available commands |
+| `.exit` | Exit the REPL |
+| `.clear` | Clear the screen |
+| `.ast` | Show AST for last expression |
+| `.magma` | System status dashboard |
+| `.crunch <target>` | Run batch pipeline |
+| `.texas <target>` | Full/heavy operation |
+| `.toast <target>` | Burn/clear caches |
+
 ## Domains
 
 ### MCP Domain — MusicBrainz, scores, Discogs, write operations
@@ -363,6 +393,14 @@ magmascript pi backup musicbrainz            # backup + commit to GitHub
 magmascript pi traffic                       # nginx traffic analysis
 ```
 
+### MC1 Domain — Windows PC management (via SSH)
+```bash
+magmascript mc1 status                        # all running Windows services
+magmascript mc1 info                          # uptime, memory, CPU, disk
+magmascript mc1 restart OllamaSvc             # restart a Windows service
+magmascript mc1 processes                     # top processes by CPU
+```
+
 ### GitHub Domain — Direct API access
 ```bash
 magmascript gh workflows                     # all workflow statuses
@@ -385,6 +423,7 @@ magmascript scores reset tetris              # reset one game (backup created)
 ```bash
 magmascript archive check-format             # validate HTML formatting
 magmascript archive bake-cache               # inline MusicBrainz cache into pages
+magmascript archive generate-stubs           # generate stub HTML for new entities
 ```
 
 ### MusicBrainz Domain — MusicBrainz API client
@@ -511,6 +550,7 @@ Full documentation on the [Wiki](https://github.com/magmacrunchmedia/magmascript
 - [Last.fm Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Last.fm-Domain)
 - [MusicBrainz Domain](https://github.com/magmacrunchmedia/magmascript/wiki/MusicBrainz-Domain)
 - [Search Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Search-Domain)
+- [Media Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Media-Domain)
 - [Example Scripts](https://github.com/magmacrunchmedia/magmascript/wiki/Example-Scripts)
 - [Architecture](https://github.com/magmacrunchmedia/magmascript/wiki/Architecture)
 

{magmascript-2.1.0 → magmascript-2.2.0}/README.md

@@ -50,11 +50,14 @@ Write `.mgs` scripts using a Python-inspired mini language with direct access to
 ### Quick Start
 
 ```bash
-# Run a script
-magmascript run scripts/examples/hello.mgs
+# Run a script (shorthand)
+magmascript scripts/examples/hello.mgs
 
 # Run with arguments
-magmascript run scripts/examples/top-scores.mgs tetris
+magmascript scripts/examples/top-scores.mgs tetris
+
+# Or use the explicit run subcommand
+magmascript run scripts/examples/hello.mgs
 
 # Start interactive REPL
 magmascript repl
@@ -254,6 +257,7 @@ if "xyz" not in "hello" { ... }
 | Function | Description |
 |----------|-------------|
 | `print(...)` | Print to stdout |
+| `echo(...)` | Print to stdout (alias for print) |
 | `len(x)` | Length of string, list, or dict |
 | `type(x)` | Type name as string |
 | `range(n)`, `range(start, stop)`, `range(start, stop, step)` | Generate integer ranges |
@@ -303,6 +307,32 @@ See `scripts/examples/` for working examples:
 | `real-domains.mgs` | Test real domain connections (MCP search, scoreboards, games) |
 | `domain-example.mgs` | Domain object overview and usage patterns |
 
+### REPL
+
+Start an interactive MagmaScript session:
+
+```bash
+magmascript repl
+```
+
+**Features:**
+- Syntax highlighting via Pygments
+- Tab completion for keywords, builtins, domain methods, and user-defined variables
+- Persistent history across sessions (`~/.magmascript_history`)
+- Multiline editing with proper continuation prompts
+- Dot-commands:
+
+| Command | Description |
+|---------|-------------|
+| `.help` | Show available commands |
+| `.exit` | Exit the REPL |
+| `.clear` | Clear the screen |
+| `.ast` | Show AST for last expression |
+| `.magma` | System status dashboard |
+| `.crunch <target>` | Run batch pipeline |
+| `.texas <target>` | Full/heavy operation |
+| `.toast <target>` | Burn/clear caches |
+
 ## Domains
 
 ### MCP Domain — MusicBrainz, scores, Discogs, write operations
@@ -328,6 +358,14 @@ magmascript pi backup musicbrainz            # backup + commit to GitHub
 magmascript pi traffic                       # nginx traffic analysis
 ```
 
+### MC1 Domain — Windows PC management (via SSH)
+```bash
+magmascript mc1 status                        # all running Windows services
+magmascript mc1 info                          # uptime, memory, CPU, disk
+magmascript mc1 restart OllamaSvc             # restart a Windows service
+magmascript mc1 processes                     # top processes by CPU
+```
+
 ### GitHub Domain — Direct API access
 ```bash
 magmascript gh workflows                     # all workflow statuses
@@ -350,6 +388,7 @@ magmascript scores reset tetris              # reset one game (backup created)
 ```bash
 magmascript archive check-format             # validate HTML formatting
 magmascript archive bake-cache               # inline MusicBrainz cache into pages
+magmascript archive generate-stubs           # generate stub HTML for new entities
 ```
 
 ### MusicBrainz Domain — MusicBrainz API client
@@ -476,6 +515,7 @@ Full documentation on the [Wiki](https://github.com/magmacrunchmedia/magmascript
 - [Last.fm Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Last.fm-Domain)
 - [MusicBrainz Domain](https://github.com/magmacrunchmedia/magmascript/wiki/MusicBrainz-Domain)
 - [Search Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Search-Domain)
+- [Media Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Media-Domain)
 - [Example Scripts](https://github.com/magmacrunchmedia/magmascript/wiki/Example-Scripts)
 - [Architecture](https://github.com/magmacrunchmedia/magmascript/wiki/Architecture)
 

{magmascript-2.1.0 → magmascript-2.2.0}/magmascript/__init__.py

@@ -1,8 +1,8 @@
 """magmascript — a scripting toolkit with domain-first subcommands."""
 
-__version__ = "2.0.1"
+__version__ = "2.2.0"
 
-from magmascript.core.config import Config, GHConfig, MediaConfig, PIConfig, get_config, load_config, set_config
+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
 from magmascript.core.rpc import RPCClient, RPCError, RPCResponse
 from magmascript.core.runner import CommandRunner
@@ -14,6 +14,7 @@ from magmascript import domains  # noqa: F401
 # Convenience: expose clients at top level
 from magmascript.domains.mcp import MCPClient
 from magmascript.domains.pi import PIClient
+from magmascript.domains.mc1 import MC1Client
 from magmascript.domains.gh import GHClient
 from magmascript.domains.media import MediaClient
 from magmascript.domains.rights import RightsClient
@@ -27,6 +28,7 @@ __all__ = [
     "Config",
     "GHClient",
     "GHConfig",
+    "MC1Client",
     "MCPClient",
     "MediaClient",
     "MediaConfig",

{magmascript-2.1.0 → magmascript-2.2.0}/magmascript/core/config.py

@@ -31,6 +31,14 @@ class PIConfig:
     user: str = "jake"
 
 
+@dataclass
+class MC1Config:
+    """MC1 Windows PC SSH configuration."""
+
+    host: str = "100.75.220.87"
+    user: str = "magma"
+
+
 @dataclass
 class GHConfig:
     """GitHub API configuration."""
@@ -79,6 +87,7 @@ class Config:
 
     mcp: MCPConfig = field(default_factory=MCPConfig)
     pi: PIConfig = field(default_factory=PIConfig)
+    mc1: MC1Config = field(default_factory=MC1Config)
     gh: GHConfig = field(default_factory=GHConfig)
     media: MediaConfig = field(default_factory=MediaConfig)
     cache: CacheConfig = field(default_factory=CacheConfig)
@@ -112,6 +121,7 @@ def load_config(*, config_path: Path | None = None, env_prefix: str = "MAGMA_")
     toml = _load_toml(cfg_file)
     mcp_section = toml.get("mcp", {})
     pi_section = toml.get("pi", {})
+    mc1_section = toml.get("mc1", {})
     gh_section = toml.get("gh", {})
     media_section = toml.get("media", {})
     cache_section = toml.get("cache", {})
@@ -129,6 +139,10 @@ def load_config(*, config_path: Path | None = None, env_prefix: str = "MAGMA_")
             host=os.environ.get(f"{env_prefix}PI_HOST", pi_section.get("host", "192.168.1.16")),
             user=os.environ.get(f"{env_prefix}PI_USER", pi_section.get("user", "jake")),
         ),
+        mc1=MC1Config(
+            host=os.environ.get(f"{env_prefix}MC1_HOST", mc1_section.get("host", "100.75.220.87")),
+            user=os.environ.get(f"{env_prefix}MC1_USER", mc1_section.get("user", "magma")),
+        ),
         gh=GHConfig(
             token=os.environ.get(f"{env_prefix}GH_TOKEN")
             or os.environ.get("GITHUB_TOKEN", "")

{magmascript-2.1.0 → magmascript-2.2.0}/magmascript/domains/__init__.py

@@ -3,6 +3,7 @@
 # Importing this package triggers domain registration
 from magmascript.domains import mcp  # noqa: F401
 from magmascript.domains import pi  # noqa: F401
+from magmascript.domains import mc1  # noqa: F401
 from magmascript.domains import gh  # noqa: F401
 from magmascript.domains import media  # noqa: F401
 from magmascript.domains import scores  # noqa: F401
@@ -12,4 +13,4 @@ from magmascript.domains import mb  # noqa: F401
 from magmascript.domains import lastfm  # noqa: F401
 from magmascript.domains import search  # noqa: F401
 
-__all__ = ["mcp", "pi", "gh", "media", "scores", "rights", "archive", "mb", "lastfm", "search"]
+__all__ = ["mcp", "pi", "mc1", "gh", "media", "scores", "rights", "archive", "mb", "lastfm", "search"]

magmascript-2.2.0/magmascript/domains/mc1/__init__.py

@@ -0,0 +1,14 @@
+"""MC1 domain — exposes MC1Client and registers with the domain registry."""
+
+from magmascript.domains.mc1.client import MC1Client
+from magmascript.domains.mc1.tools import MC1ServiceStatus, MC1SystemInfo
+from magmascript.core.registry import register_domain
+
+# Register this domain
+register_domain("mc1", MC1Client)
+
+__all__ = [
+    "MC1Client",
+    "MC1ServiceStatus",
+    "MC1SystemInfo",
+]

magmascript-2.2.0/magmascript/domains/mc1/client.py

@@ -0,0 +1,122 @@
+"""MC1 domain — direct client for Windows PC management.
+
+Supports SSH (remote) execution mode for managing MC1.
+"""
+
+from __future__ import annotations
+
+from magmascript.core.config import Config, get_config
+from magmascript.core.runner import CommandRunner
+from magmascript.domains.mc1.tools import (
+    MC1ServiceStatus,
+    MC1SystemInfo,
+    parse_service_list,
+    parse_system_info,
+)
+
+
+class MC1Client:
+    """Direct client for MC1 Windows PC management.
+
+    Commands run via SSH using PowerShell.
+    Raises SSHError on connection or command failures.
+    """
+
+    def __init__(self, config: Config | None = None, *, local: bool = False):
+        cfg = config or get_config()
+        self._host = cfg.mc1.host
+        self._user = cfg.mc1.user
+        self._local = local
+        self._runner = CommandRunner(cfg.mc1.host, cfg.mc1.user, local=local)
+
+    # ------------------------------------------------------------------
+    # Service management
+    # ------------------------------------------------------------------
+
+    def services(self) -> list[MC1ServiceStatus]:
+        """Get status of all running Windows services.
+
+        Raises SSHError on connection failure.
+        """
+        stdout = self._runner.run(
+            'powershell -Command "Get-Service | Where-Object {$_.Status -eq \\"Running\\"} | '
+            'Select-Object -Property Name, Status | ForEach-Object { \\"$($_.Name): $($_.Status)\\" }"'
+        )
+        return parse_service_list(stdout)
+
+    def restart(self, service: str) -> str:
+        """Restart a Windows service.
+
+        Raises SSHError on connection failure.
+        """
+        self._runner.run(
+            f'powershell -Command "Restart-Service -Name \\"{service}\\" -Force"',
+            timeout=30,
+        )
+        return f"✓ {service} restarted"
+
+    # ------------------------------------------------------------------
+    # System info
+    # ------------------------------------------------------------------
+
+    def info(self) -> MC1SystemInfo:
+        """Get MC1 system info (uptime, memory, CPU, disk).
+
+        Raises SSHError on connection failure.
+        """
+        stdout = self._runner.run(
+            'powershell -Command "'
+            '$os = Get-CimInstance Win32_OperatingSystem; '
+            '$cpu = Get-CimInstance Win32_Processor; '
+            '$disk = Get-CimInstance Win32_LogicalDisk -Filter \\"DriveType=3\\"; '
+            'Write-Host \\"HOSTNAME:$(hostname)\\"; '
+            'Write-Host \\"UPTIME:$((Get-Date) - $os.LastBootUpTime)\\"; '
+            'Write-Host \\"MEMORY:$([math]::Round($os.TotalVisibleMemorySize/1MB, 1))GB/$([math]::Round(($os.TotalVisibleMemorySize - $os.FreePhysicalMemory)/1MB, 1))GB\\"; '
+            'Write-Host \\"CPU:$($cpu.LoadPercentage)%\\"; '
+            'Write-Host \\"DISK:$([math]::Round($disk.FreeSpace/$disk.Size*100, 1))% free\\"'
+            '"'
+        )
+        return parse_system_info(stdout)
+
+    # ------------------------------------------------------------------
+    # Processes
+    # ------------------------------------------------------------------
+
+    def processes(self) -> str:
+        """Get top processes on MC1 by CPU usage.
+
+        Raises SSHError on connection failure.
+        """
+        return self._runner.run(
+            'powershell -Command "Get-Process | Sort-Object CPU -Descending | '
+            'Select-Object -First 15 Name, CPU, WorkingSet | Format-Table -AutoSize"'
+        )
+
+    # ------------------------------------------------------------------
+    # Power
+    # ------------------------------------------------------------------
+
+    def reboot(self) -> str:
+        """Reboot MC1.
+
+        Raises SSHError on connection failure.
+        """
+        self._runner.run(
+            'powershell -Command "Restart-Computer -Force"',
+            timeout=10,
+        )
+        return "✓ Rebooting MC1..."
+
+    # ------------------------------------------------------------------
+    # Lifecycle
+    # ------------------------------------------------------------------
+
+    def close(self):
+        """No-op."""
+        pass
+
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *args):
+        self.close()

magmascript-2.2.0/magmascript/domains/mc1/tools.py

@@ -0,0 +1,82 @@
+"""Typed result dataclasses for the MC1 domain."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+
+
+@dataclass
+class MC1ServiceStatus:
+    """Status of a Windows service."""
+
+    name: str
+    status: str
+    ok: bool
+
+
+@dataclass
+class MC1SystemInfo:
+    """MC1 system info."""
+
+    hostname: str
+    uptime: str
+    memory: str
+    cpu_load: str
+    disk_free: str
+
+
+# ---------------------------------------------------------------------------
+# Parsers
+# ---------------------------------------------------------------------------
+
+
+def parse_service_list(text: str) -> list[MC1ServiceStatus]:
+    """Parse PowerShell Get-Service output into MC1ServiceStatus list.
+
+    Expected format (from the PowerShell command):
+        AmdPpkgSvc: Running
+        AppIDSvc: Running
+    """
+    results = []
+    for line in text.splitlines():
+        line = line.strip()
+        if ":" in line:
+            name, status = line.split(":", 1)
+            name = name.strip()
+            status = status.strip()
+            results.append(MC1ServiceStatus(
+                name=name,
+                status=status,
+                ok=status.lower() == "running",
+            ))
+    return results
+
+
+def parse_system_info(text: str) -> MC1SystemInfo:
+    """Parse the output of the combined system info command.
+
+    Expected format:
+        HOSTNAME:MC1
+        UPTIME:07:33:06.0140847
+        MEMORY:31.7GB/7.6GB
+        CPU:4%
+        DISK:93.2% free
+    """
+    info = {"hostname": "", "uptime": "", "memory": "", "cpu_load": "", "disk_free": ""}
+    for line in text.splitlines():
+        line = line.strip()
+        if ":" in line:
+            key, val = line.split(":", 1)
+            key = key.lower().strip()
+            val = val.strip()
+            if key == "hostname":
+                info["hostname"] = val
+            elif key == "uptime":
+                info["uptime"] = val
+            elif key == "memory":
+                info["memory"] = val
+            elif key == "cpu":
+                info["cpu_load"] = val
+            elif key == "disk":
+                info["disk_free"] = val
+    return MC1SystemInfo(**info)

{magmascript-2.1.0 → magmascript-2.2.0}/magmascript.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: magmascript
-Version: 2.1.0
+Version: 2.2.0
 Summary: Scripting toolkit with domain-first subcommands
 Author: Jake McCoy
 License-Expression: MIT
@@ -85,11 +85,14 @@ Write `.mgs` scripts using a Python-inspired mini language with direct access to
 ### Quick Start
 
 ```bash
-# Run a script
-magmascript run scripts/examples/hello.mgs
+# Run a script (shorthand)
+magmascript scripts/examples/hello.mgs
 
 # Run with arguments
-magmascript run scripts/examples/top-scores.mgs tetris
+magmascript scripts/examples/top-scores.mgs tetris
+
+# Or use the explicit run subcommand
+magmascript run scripts/examples/hello.mgs
 
 # Start interactive REPL
 magmascript repl
@@ -289,6 +292,7 @@ if "xyz" not in "hello" { ... }
 | Function | Description |
 |----------|-------------|
 | `print(...)` | Print to stdout |
+| `echo(...)` | Print to stdout (alias for print) |
 | `len(x)` | Length of string, list, or dict |
 | `type(x)` | Type name as string |
 | `range(n)`, `range(start, stop)`, `range(start, stop, step)` | Generate integer ranges |
@@ -338,6 +342,32 @@ See `scripts/examples/` for working examples:
 | `real-domains.mgs` | Test real domain connections (MCP search, scoreboards, games) |
 | `domain-example.mgs` | Domain object overview and usage patterns |
 
+### REPL
+
+Start an interactive MagmaScript session:
+
+```bash
+magmascript repl
+```
+
+**Features:**
+- Syntax highlighting via Pygments
+- Tab completion for keywords, builtins, domain methods, and user-defined variables
+- Persistent history across sessions (`~/.magmascript_history`)
+- Multiline editing with proper continuation prompts
+- Dot-commands:
+
+| Command | Description |
+|---------|-------------|
+| `.help` | Show available commands |
+| `.exit` | Exit the REPL |
+| `.clear` | Clear the screen |
+| `.ast` | Show AST for last expression |
+| `.magma` | System status dashboard |
+| `.crunch <target>` | Run batch pipeline |
+| `.texas <target>` | Full/heavy operation |
+| `.toast <target>` | Burn/clear caches |
+
 ## Domains
 
 ### MCP Domain — MusicBrainz, scores, Discogs, write operations
@@ -363,6 +393,14 @@ magmascript pi backup musicbrainz            # backup + commit to GitHub
 magmascript pi traffic                       # nginx traffic analysis
 ```
 
+### MC1 Domain — Windows PC management (via SSH)
+```bash
+magmascript mc1 status                        # all running Windows services
+magmascript mc1 info                          # uptime, memory, CPU, disk
+magmascript mc1 restart OllamaSvc             # restart a Windows service
+magmascript mc1 processes                     # top processes by CPU
+```
+
 ### GitHub Domain — Direct API access
 ```bash
 magmascript gh workflows                     # all workflow statuses
@@ -385,6 +423,7 @@ magmascript scores reset tetris              # reset one game (backup created)
 ```bash
 magmascript archive check-format             # validate HTML formatting
 magmascript archive bake-cache               # inline MusicBrainz cache into pages
+magmascript archive generate-stubs           # generate stub HTML for new entities
 ```
 
 ### MusicBrainz Domain — MusicBrainz API client
@@ -511,6 +550,7 @@ Full documentation on the [Wiki](https://github.com/magmacrunchmedia/magmascript
 - [Last.fm Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Last.fm-Domain)
 - [MusicBrainz Domain](https://github.com/magmacrunchmedia/magmascript/wiki/MusicBrainz-Domain)
 - [Search Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Search-Domain)
+- [Media Domain](https://github.com/magmacrunchmedia/magmascript/wiki/Media-Domain)
 - [Example Scripts](https://github.com/magmacrunchmedia/magmascript/wiki/Example-Scripts)
 - [Architecture](https://github.com/magmacrunchmedia/magmascript/wiki/Architecture)
 

{magmascript-2.1.0 → magmascript-2.2.0}/magmascript.egg-info/SOURCES.txt

@@ -30,6 +30,9 @@ magmascript/domains/lastfm/__init__.py
 magmascript/domains/lastfm/client.py
 magmascript/domains/mb/__init__.py
 magmascript/domains/mb/client.py
+magmascript/domains/mc1/__init__.py
+magmascript/domains/mc1/client.py
+magmascript/domains/mc1/tools.py
 magmascript/domains/mcp/__init__.py
 magmascript/domains/mcp/client.py
 magmascript/domains/mcp/tools.py

{magmascript-2.1.0 → magmascript-2.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "magmascript"
-version = "2.1.0"
+version = "2.2.0"
 description = "Scripting toolkit with domain-first subcommands"
 readme = "README.md"
 license = "MIT"