Description
WonderPhi Server v1.0.0 — VM & Infrastructure Batch Recipes
Status: Patent pending. The WonderPhi framework, constitutional commandments, plan.wpc.txt format, and recipe library structure are the intellectual property of Christopher Gabriel Brown, protected under U.S. copyright law (17 U.S.C. § 102(a)(1)) and applicable international treaties. Copyright registration filed under Form TX (Literary Work — Computer Program), SKU WONDERPHI-SERVER-100. The inventor’s broader USPTO patent portfolio comprises 41 applications filed (28 utility, 6 design, 7 provisional). All rights to seek additional patent protection are expressly reserved.
Inventor / Author: Christopher Gabriel Brown.
Overview
WonderPhi Server is a batch recipe library for virtual-machine and server administration. It reads a plain-text list of targets — VM names, hostnames, IP addresses, distro names, ISO paths — and emits a ready-to-run WonderPhi Compute plan file ( .plan.wpc.txt ). It does not execute anything itself: it writes the plan, and the companion product WonderPhi Compute runs it in parallel across every available CPU core.
The library is a single Python script ( wps-recipe.py , 210 lines, 9,721 bytes) with zero external dependencies — standard library only. No network calls. No telemetry. No forced updates. It runs on Windows and targets anything reachable by SSH, WinRM, Hyper-V API, WSL, SFTP, or built-in tools such as ping , curl , and certutil .
How It Works — Three Steps
Step Command What Happens
1 python wps-recipe.py --list Lists all 19 available recipes with descriptions and requirements
2 python wps-recipe.py Reads the target file (one target per line), generates the parallel plan
3 wpc.exe .plan.wpc.txt WonderPhi Compute dispatches every task across all CPU cores
Input model: lines — one target per line. Blank lines and # comments are ignored. What “target” means depends on the recipe: a VM name for Hyper-V, a hostname for SSH, a distro name for WSL, a host:port pair for port checks, a file path for ISO verification.
The 19 Recipes
Hyper-V — 5 Recipes
Recipe What It Does Requires Command Template
hyperv-snapshot Checkpoint each VM with a tagged snapshot name ( auto-{tag} ) Hyper-V PowerShell module Checkpoint-VM -Name '{arg}' -SnapshotName 'auto-{tag}'
hyperv-export Export each VM to a timestamped folder ( C:\vm-exports\{tag} ) Hyper-V PowerShell module Export-VM -Name '{arg}' -Path 'C:\vm-exports\{tag}'
hyperv-start Start each named VM in parallel Hyper-V PowerShell module Start-VM -Name '{arg}'
hyperv-stop Gracefully stop each named VM (Shutdown; falls back to TurnOff) Hyper-V PowerShell module Stop-VM -Name '{arg}' -Force
hyperv-status Emit state, CPU usage, memory assigned, and uptime as one line of JSON per VM Hyper-V PowerShell module Get-VM '{arg}' | Select Name,State,CPUUsage,MemoryAssigned,Uptime | ConvertTo-Json -Compress
WSL (Windows Subsystem for Linux) — 2 Recipes
Recipe What It Does Requires Command Template
wsl-update apt update && upgrade inside each named WSL distro WSL 2 wsl -d {arg} -- bash -c "sudo apt-get update -qq && sudo apt-get -y upgrade"
wsl-snapshot Export each WSL distro to a timestamped .tar file WSL 2 wsl --export {arg} "C:\wsl-snapshots\{arg}-{tag}.tar"
SSH (OpenSSH) — 4 Recipes
Recipe What It Does Requires Command Template
ssh-uptime Get uptime from each remote host (key-based auth, 5s timeout) OpenSSH client ssh -o ConnectTimeout=5 {arg} uptime
ssh-disk df -h from each host (capacity audit, excludes tmpfs) OpenSSH client ssh -o ConnectTimeout=5 {arg} "df -h --output=source,size,used,avail,pcent,target | grep -v tmpfs"
ssh-upgrade apt update && upgrade on each Debian/Ubuntu host (unattended, 10s timeout) OpenSSH client + sudo NOPASSWD ssh -o ConnectTimeout=10 {arg} "sudo DEBIAN_FRONTEND=noninteractive apt-get -qq update && ..."
ssh-reboot Reboot each host in parallel (10s timeout) OpenSSH client + sudo NOPASSWD ssh -o ConnectTimeout=10 {arg} "sudo /sbin/reboot"
WinRM — 2 Recipes
Recipe What It Does Requires Command Template
winrm-cmd Run hostname and systeminfo via Invoke-Command on each Windows host WinRM enabled on targets Invoke-Command -ComputerName {arg} -ScriptBlock { hostname; (Get-CimInstance Win32_OperatingSystem).Caption }
winrm-reboot Restart each Windows host via WinRM with a 300-second timeout WinRM enabled + admin rights Restart-Computer -ComputerName {arg} -Force -Wait -Timeout 300
SFTP — 1 Recipe
Recipe What It Does Requires Command Template
sftp-put Push a fixed local file to each host’s /tmp/ directory (10s timeout) OpenSSH client + a source file scp -o ConnectTimeout=10 "{tag}" {arg}:/tmp/
Audit / Discovery — 4 Recipes
Recipe What It Does Requires Command Template
host-ping Ping each host once with a 2-second (2,000 ms) deadline ping (built-in) ping -n 1 -w 2000 {arg}
host-http HTTP HEAD request to each URL/host over HTTPS (5s timeout, silent) curl (built-in) curl -sfI -m 5 -o NUL {arg}
host-ssh-alive Attempt SSH connect with 3-second timeout — handshake-only, BatchMode OpenSSH client ssh -o ConnectTimeout=3 -o BatchMode=yes {arg} exit
port-check Test-NetConnection on host:port pairs; reports ComputerName, RemotePort, TcpTestSucceeded PowerShell (built-in) Test-NetConnection -ComputerName $p[0] -Port $p[1]
Integrity — 1 Recipe
Recipe What It Does Requires Command Template
iso-verify SHA-256 hash verification of each ISO file listed (one path per line) certutil (built-in) certutil -hashfile "{arg}" SHA256
Recipe Summary by Category
Category Recipe Count Protocols / Tools Used
Hyper-V 5 PowerShell Hyper-V module ( Checkpoint-VM , Export-VM , Start-VM , Stop-VM , Get-VM )
WSL 2 WSL 2 CLI ( wsl -d , wsl --export )
SSH 4 OpenSSH client ( ssh with StrictHostKeyChecking=no )
WinRM 2 PowerShell Remoting ( Invoke-Command , Restart-Computer )
SFTP 1 OpenSSH scp
Audit 4 ping , curl , ssh (handshake), Test-NetConnection
Integrity 1 certutil (SHA-256)
Total 19
Command-Line Interface
Flag Meaning
--list List all 19 recipes with descriptions and requirements, then exit
--out FILE Specify output file path for the generated plan (default: {input_stem}.plan.wpc.txt )
--tag VALUE Value substituted for {tag} in each command template (default: timestamp in YYYYMMDD-HHMMSS format)
--stdout Print the generated plan to standard output instead of writing a file
--check Dry run — report how many targets matched; write nothing
Plan File Format
Every generated plan starts with the magic header # WPC v1 (the frozen plan format defined by WonderPhi Compute’s Commandment V: “Honour thy father and thy mother — plan.wpc.txt v1 format is frozen forever”). The plan includes metadata comments for recipe name, description, tag value, and task count, followed by one executable command per line.
Plan File Property Value
Header # WPC v1
Format version 1 (frozen — shall never change)
Max tasks per plan 65,536
Max bytes per task line 8,192
Encoding UTF-8
The WonderPhi Compute Constitutional Framework
Plans generated by WonderPhi Server are executed by WonderPhi Compute (sold separately), which is governed by an immutable set of 10 Commandments — a constitutional framework hardcoded into the runtime binary. Any binary that fails the constitutional checksum at startup refuses to run.
Commandment Principle Enforcement
I I am the Lord thy God WPC is the sole orchestrator of the plan
II Thou shalt have no other gods before me Exactly one WPC instance per working directory (lock file: .wpc.lock )
III Thou shalt not take the name of the Lord in vain Every task line must parse; malformed input is rejected
IV Remember the Sabbath day Idle workers sleep (100 ms poll, 10 ms worker idle) — never busy-wait
V Honour thy father and thy mother plan.wpc.txt v1 format is frozen forever
VI Thou shalt not kill Log appends only; a crash never destroys prior history
VII Thou shalt not commit adultery Tasks dispatch exactly as written; no shell mutation, no silent retry
VIII Thou shalt not steal Max 64 concurrent tasks, 4,096 MB per task, 24-hour max runtime
IX Thou shalt not bear false witness Exit codes and elapsed times reported truthfully; no suppression of stderr
X Thou shalt not covet Zero external dependencies, zero network calls, zero telemetry endpoints
Constitutional checksum: XOR of Commandments I–X = 0x0B . Runtime signature: 0x57504321 (“WPC!” in ASCII). Master key: 0x50484921 (“PHI!” in ASCII).
Technical Specifications
Property Value
Product version 1.0.0 (permanent — shall never be updated, replaced, or superseded)
Language Python 3.8+
External dependencies Zero — standard library only ( argparse , sys , datetime , pathlib )
Source file wps-recipe.py — 210 lines, 9,721 bytes
Recipe count 19
Recipe categories 7 (Hyper-V, WSL, SSH, WinRM, SFTP, Audit, Integrity)
Input model lines — one target per line
Output format .plan.wpc.txt (WPC v1)
Network access None — the script never touches the network
Telemetry None
Platform Windows (targets can be any OS reachable by SSH/WinRM/Hyper-V)
Companion product WonderPhi Compute v1.0.0 (required to execute generated plans)
WonderPhi Compute Runtime Limits (Execution Engine)
Limit Value Constant
Max concurrent tasks 64 WPC_MAX_CONCURRENT_TASKS
Max memory per task 4,096 MB WPC_MAX_MEMORY_MB_PER_TASK
Max task runtime 86,400 seconds (24 hours) WPC_MAX_TASK_RUNTIME_SEC
Max tasks per plan 65,536 WPC_MAX_TASKS_PER_PLAN
Max bytes per task line 8,192 WPC_TASK_MAX_LEN
Max log file size 512 MB WPC_MAX_LOG_SIZE_MB
Idle poll interval 100 ms WPC_IDLE_POLL_MS
Worker idle sleep 10 ms WPC_WORKER_IDLE_MS
Auto retry on failure Disabled (a failed task fails once) WPC_AUTO_RETRY = False
Shell mode Enabled (pass through platform shell verbatim) WPC_SHELL_MODE = True
Lock file .wpc.lock WPC_LOCK_FILENAME
Log file wpc.log (atomic append only) WPC_LOG_FILENAME
Example Workflows
Scenario Command
Checkpoint every VM before an OS upgrade window python wps-recipe.py hyperv-snapshot .\vms.txt --tag pre-2026-Q3
Export each VM (bare-metal-restore-ready archive) python wps-recipe.py hyperv-export .\vms.txt --tag 20260721
Boot every named VM in parallel (spawn a lab fast) python wps-recipe.py hyperv-start .\vms.txt
Get uptime from every SSH host at once python wps-recipe.py ssh-uptime .\hosts.txt
apt update && upgrade across a fleet python wps-recipe.py ssh-upgrade .\hosts.txt
Test-NetConnection host:port against many endpoints python wps-recipe.py port-check .\endpoints.txt
apt update on every WSL distro python wps-recipe.py wsl-update .\distros.txt
SHA-256 verify a collection of ISO images python wps-recipe.py iso-verify .\isos.txt
Licensing
Property Retail (Single-User) Industrial (Commercial)
License type Perpetual, non-exclusive, non-transferable Perpetual, non-exclusive, non-transferable, org-wide
Tied to The buyer (not a machine, stick, or account) The legal entity on the purchase receipt + wholly-owned subsidiaries
Machine limit Any and all machines the buyer personally owns or administers Any number of machines, VMs, containers, or cloud instances
Seat count None None
Expiration None — perpetual None — perpetual
Renewal None None
Activation None — nothing phones home None
Telemetry None None
Source code Included — may read, study, and modify for personal use Included — may modify for internal organisational use
Third-party redistribution Prohibited Prohibited (OEM license available separately)
SaaS / hosted use Requires Industrial license Permitted for org’s own workloads; resale as-a-service requires OEM license
Governing law State of Georgia, USA (Gwinnett County courts) State of Georgia, USA (Gwinnett County courts)
What Is in the Package
The release archive ( wonderphi-server-v1.0.0.zip , 7,469 bytes compressed, 18,291 bytes uncompressed) contains 4 files :
File Size Lines Description
wps-recipe.py 9,721 bytes 210 The recipe generator — 19 batch recipes, CLI interface, plan emitter. Python 3.8+, standard library only. Imports: argparse , sys , datetime , pathlib .
README.md 4,580 bytes 134 Full documentation: usage, examples, recipe table, options, package contents
INDEX.md 2,077 bytes 33 Recipe index table: all 19 recipes with category, input model, requirements, and descriptions
LICENSE 4,919 bytes 126 WonderPhi Software License v1.0.0 — Retail Single-User (9 sections + contact)
The source folder additionally includes:
File Size Lines Description
LICENSE-INDUSTRIAL.txt 6,163 bytes 146 Industrial (Commercial) license variant — organisation-wide deployment terms
LICENSE.bak-20260723 1,913 bytes 56 Prior proprietary license (backup, dated 2026-07-23) with patent notice
release/wonderphi-server-v1.0.0.zip 7,469 bytes — Distribution archive containing the 4 release files
Total source folder: 7 files + 1 release archive. Combined source size: 29,373 bytes (source files), 705 lines of text.
Requirements
Requirement Detail
Python 3.8 or later (to generate plans)
WonderPhi Compute v1.0.0 ( wpc.exe ) — required to execute the generated plans
Hyper-V recipes Hyper-V PowerShell module installed on the operator’s machine
WSL recipes WSL 2 (Windows Subsystem for Linux) enabled
SSH/SFTP recipes OpenSSH client on the operator’s machine; key-based auth recommended; some recipes require sudo NOPASSWD on targets
WinRM recipes WinRM enabled on target machines; admin rights for reboot operations
Audit recipes Built-in tools only ( ping , curl , ssh , PowerShell Test-NetConnection )
Integrity recipes certutil (built into Windows)
Operating system Windows (the generator runs on Windows; targets can be any reachable OS)
Design Principles
- Library writes the plan; WonderPhi Compute runs the plan. Separation of concerns — recipe generation is pure text transformation.
- Nothing here executes remote commands. The script only reads a file and writes a .txt .
- Zero external Python dependencies. Standard library only: argparse , sys , datetime , pathlib .
- No network. No telemetry. The script never opens a socket.
- Never modifies wpc.exe . The 10 Commandments stay intact.
- Version 1.0.0 is permanent. Shall never be updated, replaced, or superseded.
How this is delivered
This package ships on a single Blu-ray disc, posted to the delivery address on your order. The archive on the disc is AES-256 encrypted; the passphrase is sent separately, by email, once the disc is despatched — so the disc alone is of no use to anyone who intercepts it.
Discs are despatched by tracked, signed-for post. Allow 5 business days for mastering and verification before despatch.
© 2026 Christopher Gabriel Brown. All rights reserved.
Footnotes
- Product number 8519.
- Family: wonderphi.
- Purchase: When you buy, you buy the use of that blueprint only.