@rubytech/create-maxy 1.0.792 → 1.0.793

package/dist/launchd-plist.js

@@ -0,0 +1,68 @@
+// Task 838 — pure plist XML rendering for the macOS LaunchAgent supervisor.
+// Mirrors the apt-resolve.ts / port-resolution.ts pattern: inputs in, decision
+// out, no I/O. The installer wraps this with writeFileSync + spawnSync(
+// "launchctl", ["bootstrap", `gui/${uid}`, plistPath]) — all spawn/fs lives in
+// index.ts so this module can be unit-tested with concrete fixtures and no
+// side effects.
+//
+// The Linux supervisor (systemd-user persistent unit at
+// `~/.config/systemd/user/<service>.service`) has no analogue here: launchd's
+// LaunchAgent format is a property-list XML document at
+// `~/Library/LaunchAgents/<label>.plist`, and the bootstrap-into-domain flow
+// uses launchctl(1) instead of systemctl. Both supervisors achieve the same
+// success-criteria set: process registered with the user's session manager,
+// auto-restart on crash, restart on logout/login, RunAtLoad on reboot.
+/**
+ * Escape the five XML predefined entities, in order. Order matters: replace
+ * `&` first so an input of `<` doesn't double-escape via the `&` produced by
+ * the `<` rule. The output is safe to embed inside an XML <string> element.
+ */
+function xmlEscape(s) {
+    return s
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/**
+ * Render a launchd LaunchAgent plist as XML. Pure: same input → same output
+ * forever. The caller writes this to `~/Library/LaunchAgents/<label>.plist`
+ * with mode 0644 and then runs `launchctl bootstrap gui/$UID <path>`.
+ *
+ * The output is the canonical plist 1.0 form launchd accepts — XML preamble,
+ * PLIST PUBLIC DOCTYPE, <plist version="1.0"> wrapping a single <dict>. Key
+ * order inside the dict mirrors Apple's LaunchAgent examples for grep-ability:
+ * Label, ProgramArguments, StandardOutPath, StandardErrorPath, [WorkingDirectory,]
+ * KeepAlive, RunAtLoad.
+ */
+export function renderPlist(spec) {
+    const lines = [];
+    lines.push(`<?xml version="1.0" encoding="UTF-8"?>`);
+    lines.push(`<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">`);
+    lines.push(`<plist version="1.0">`);
+    lines.push(`<dict>`);
+    lines.push(`  <key>Label</key>`);
+    lines.push(`  <string>${xmlEscape(spec.label)}</string>`);
+    lines.push(`  <key>ProgramArguments</key>`);
+    lines.push(`  <array>`);
+    for (const arg of spec.programArguments) {
+        lines.push(`    <string>${xmlEscape(arg)}</string>`);
+    }
+    lines.push(`  </array>`);
+    lines.push(`  <key>StandardOutPath</key>`);
+    lines.push(`  <string>${xmlEscape(spec.stdoutPath)}</string>`);
+    lines.push(`  <key>StandardErrorPath</key>`);
+    lines.push(`  <string>${xmlEscape(spec.stderrPath)}</string>`);
+    if (spec.workingDirectory !== undefined) {
+        lines.push(`  <key>WorkingDirectory</key>`);
+        lines.push(`  <string>${xmlEscape(spec.workingDirectory)}</string>`);
+    }
+    lines.push(`  <key>KeepAlive</key>`);
+    lines.push(`  ${spec.keepAlive ? "<true/>" : "<false/>"}`);
+    lines.push(`  <key>RunAtLoad</key>`);
+    lines.push(`  ${spec.runAtLoad ? "<true/>" : "<false/>"}`);
+    lines.push(`</dict>`);
+    lines.push(`</plist>`);
+    return lines.join("\n") + "\n";
+}

package/dist/macos-version.js

@@ -0,0 +1,53 @@
+// Task 840 — pure macOS-version classification for the installer.
+//
+// The installer needs two darwin facts at pre-flight: the macOS version (from
+// `sw_vers`) and whether that version meets the floor required by Tasks 838
+// (modern `launchctl bootstrap gui/$UID …`) and 839 (Apple-Silicon Homebrew).
+// Older macOS partially succeeds, then breaks at the supervisor or brew-cellar
+// layer with cryptic errors — refusing loudly at pre-flight is the contract.
+//
+// Pure logic with no I/O — caller spawns `sw_vers`, captures stdout, and feeds
+// it through parseSwVers + isSupportedMacosVersion. Mirrors the apt-resolve.ts
+// pattern (Task 638): inputs in, decision out, every branch testable with
+// real captured fixtures.
+/**
+ * Parse the stdout of macOS's `sw_vers` command. Real output has the shape:
+ *
+ *   ProductName: macOS
+ *   ProductVersion: 14.4.1
+ *   BuildVersion: 23E224
+ *
+ * Returns null when either ProductName or ProductVersion is absent — the
+ * caller treats null as "refuse with malformed-stdout diagnostic" rather than
+ * silently coercing to undefined and producing a confusing version check.
+ */
+export function parseSwVers(stdout) {
+    const productMatch = stdout.match(/^ProductName:\s*(.+)$/m);
+    const versionMatch = stdout.match(/^ProductVersion:\s*(.+)$/m);
+    if (!productMatch || !versionMatch)
+        return null;
+    return {
+        product: productMatch[1].trim(),
+        version: versionMatch[1].trim(),
+    };
+}
+/**
+ * True when `version`'s major component is ≥ 14 (the floor required by Tasks
+ * 838 + 839). Returns false for empty strings, non-numeric leading components,
+ * and any major < 14. A numeric-only check is sufficient — Apple's published
+ * macOS versions use a strict `MAJOR.MINOR[.PATCH]` integer scheme.
+ */
+export function isSupportedMacosVersion(version) {
+    const m = version.match(/^(\d+)\./);
+    if (!m) {
+        // Fall back to whole-version-as-integer for the macOS 14.0 / 15 form
+        // where the leading number isn't followed by a dot. Defence in depth —
+        // the regex above already handles "14.0", but a bare "14" should also
+        // pass.
+        const bare = version.match(/^(\d+)$/);
+        if (!bare)
+            return false;
+        return parseInt(bare[1], 10) >= 14;
+    }
+    return parseInt(m[1], 10) >= 14;
+}

package/dist/platform-detect.js

@@ -0,0 +1,36 @@
+// Task 836 wedge — pure platform classification for the installer.
+//
+// The installer's existing `isLinux()` checks (26 sites in index.ts) collapse
+// process.platform into a boolean and treat every non-Linux value as "skip
+// silently." Follow-up tasks 838/839/840 widen that to an explicit ternary
+// (linux | darwin | unsupported) so unsupported targets refuse loudly with a
+// log line operators can grep, instead of completing in a non-functional state.
+//
+// This module ships dead until those follow-ups land. Pure logic with no I/O —
+// caller injects process.platform so tests pass arbitrary fixtures without
+// touching the host's actual platform.
+/**
+ * Classify a Node process.platform value into the ternary the installer cares
+ * about. Anything not in { linux, darwin } returns "unsupported"; the caller
+ * decides whether to refuse the install or no-op.
+ */
+export function detectPlatform(nodePlatform) {
+    if (nodePlatform === "linux")
+        return "linux";
+    if (nodePlatform === "darwin")
+        return "darwin";
+    return "unsupported";
+}
+/**
+ * Narrow a Node process.platform to a SupportedPlatform or throw with the
+ * literal refusal message follow-up tasks log + grep on. Use this at install
+ * pre-flight where continuing on an unsupported OS would silently complete a
+ * broken install.
+ */
+export function requireSupportedPlatform(nodePlatform) {
+    const detected = detectPlatform(nodePlatform);
+    if (detected === "unsupported") {
+        throw new Error(`[create-maxy] platform=${nodePlatform} — refusing: only linux and darwin are supported`);
+    }
+    return detected;
+}

package/dist/uninstall.js

@@ -64,6 +64,23 @@ function shell(command, args, options) {
 function isLinux() {
     return process.platform === "linux";
 }
+function isDarwin() {
+    return process.platform === "darwin";
+}
+// Task 838 — mirror the launchd identifiers from index.ts so the uninstall
+// can locate the LaunchAgent without reaching across modules. Per the
+// `uninstall.ts:` "Shell helpers (duplicated from index.ts ...)" policy,
+// these are intentionally duplicated rather than shared.
+function launchdLabel() {
+    return `com.rubytech.${BRAND.hostname}`;
+}
+function plistPath() {
+    return resolve(HOME, "Library/LaunchAgents", `${launchdLabel()}.plist`);
+}
+function gui() {
+    const uid = typeof process.getuid === "function" ? process.getuid() : 0;
+    return `gui/${uid}`;
+}
 function commandExists(cmd) {
     try {
         execFileSync("which", [cmd], { stdio: "pipe" });
@@ -120,6 +137,15 @@ function peerBrandPresent() {
 // ---------------------------------------------------------------------------
 function stopServices() {
     log("1", "Stopping services...");
+    // Task 838 — darwin: bootout the LaunchAgent. bootout exits 0 on success,
+    // 113 ("Unknown service") when the agent isn't loaded — both are
+    // acceptable end-states for "service stopped". The plist removal in
+    // removeSystemdService() finishes the cleanup.
+    if (isDarwin()) {
+        spawnSync("launchctl", ["bootout", `${gui()}/${launchdLabel()}`], { stdio: "pipe", timeout: 15_000 });
+        console.log(`  Booted out ${launchdLabel()}`);
+        return;
+    }
     // Stop platform user service
     try {
         spawnSync("systemctl", ["--user", "stop", BRAND.serviceName.replace(".service", "")], { stdio: "pipe", timeout: 15_000 });
@@ -563,6 +589,27 @@ function removeSystemConfig() {
 // ---------------------------------------------------------------------------
 function removeSystemdService() {
     log("8", "Removing systemd service...");
+    // Task 838 — darwin: bootout (idempotent — already done in stopServices,
+    // re-running is a no-op exit 113) and delete the plist. The wrapper
+    // shell script lives in CONFIG_DIR which step 4 (removeAppDirs) wipes,
+    // so no separate cleanup is needed.
+    if (isDarwin()) {
+        spawnSync("launchctl", ["bootout", `${gui()}/${launchdLabel()}`], { stdio: "pipe", timeout: 15_000 });
+        const plist = plistPath();
+        if (existsSync(plist)) {
+            try {
+                rmSync(plist);
+                console.log(`  Removed ${plist}`);
+            }
+            catch (err) {
+                console.log(`  Failed to remove ${plist}: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        else {
+            console.log(`  ${plist} not found — skipping`);
+        }
+        return;
+    }
     // Disable the service
     const svcUnit = BRAND.serviceName.replace(".service", "");
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy",
-  "version": "1.0.792",
+  "version": "1.0.793",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy": "./dist/index.js"

package/payload/platform/plugins/docs/references/deployment.md

@@ -2,11 +2,23 @@
 
 ## Hardware Requirements
 
-- Raspberry Pi 5 (16GB RAM minimum)
-- 256GB storage (microSD or NVMe)
-- Raspberry Pi OS
+- Raspberry Pi 5 (16GB RAM minimum) with Raspberry Pi OS, **or**
+- Mac with macOS 14 (Sonoma) or newer — both Apple Silicon and Intel
+- 256GB storage minimum
 - Always-on power and network connection
 
+## macOS install
+
+On macOS the installer uses Homebrew + launchd instead of apt + systemd, but the operator command is the same:
+
+```bash
+npx -y @rubytech/create-maxy
+```
+
+**Prerequisite:** Homebrew. If `brew` is missing, the installer refuses with `Homebrew not found. Install from https://brew.sh and re-run.` Install Homebrew once via the official one-liner, then re-run.
+
+The installer registers {{productName}} as a launchd LaunchAgent at `~/Library/LaunchAgents/com.rubytech.maxy.plist` — survives logout/login and reboot. Use `launchctl print gui/$UID/com.rubytech.maxy` for service state. `--hostname <h>` sets HostName / LocalHostName / ComputerName via `sudo scutil`. macOS < 14 is refused at pre-flight.
+
 ## Initial Setup
 
 The {{productName}} installer handles the full setup. Run it on your Pi: