unitup 0.1.5 → 0.2.0

package/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.5] - 2026-07-31
+
+### Fixed
+- Fixed script argument resolution in all runtime adapters (`node`, `python`, `ruby`, `php`, `bun`, `deno`, `shell`, `go`, `elixir`, `native`) to resolve relative script paths against `opts.cwd` instead of `process.cwd()`.
+
 ## [0.1.4] - 2026-07-31
 
 ### Added
@@ -16,9 +21,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Biome (`@biomejs/biome`) developer tool integration for code linting and formatting (`npm run check`, `npm run format`, `npm run lint`).
 - `CHANGELOG.md` tracking project release history and changes.
 
-### Fixed
-- Fixed script argument resolution in all runtime adapters (`node`, `python`, `ruby`, `php`, `bun`, `deno`, `shell`, `go`, `elixir`, `native`) to resolve relative script paths against `opts.cwd` instead of `process.cwd()`.
-
 ## [0.1.3] - 2026-07-31
 
 ### Added

package/README.md

@@ -1,20 +1,101 @@
 # unitup
 
-> Minimal, zero-dependency CLI & library to run Node.js, Python, Ruby, PHP, Bun, Deno, Go, Elixir, Shell scripts, and native binaries as `systemd` user services.
+> Minimal, zero-dependency cross-platform background service manager for Node.js, Python, Ruby, PHP, Bun, Deno, Go, Elixir, Shell scripts, and native binaries.
 
-`unitup` provides a thin, user-level layer over Linux `systemd`. It does **not** create a custom daemon, manage process trees, or act as a PM2 alternative. Instead, it generates and manages native systemd user units (`~/.config/systemd/user/unitup-<name>.service`), letting systemd handle process supervision, auto-restarts, logging, and OS boot startup without requiring `sudo` privileges.
+## What is unitup?
+
+`unitup` is a lightweight, zero-dependency CLI tool and programmatic library designed to run and manage background applications and services natively across:
+* **Linux** → `systemd` (`~/.config/systemd/user/`)
+* **macOS** → `launchd` (`~/Library/LaunchAgents/` & `/Library/LaunchDaemons/`)
+* **Windows** → `Windows Services` (`sc.exe` + Unitup Service Host)
+
+Unlike traditional process managers (such as PM2) that run a persistent master daemon continuously consuming system CPU and RAM, `unitup` operates **without a resident background process**. When you run `unitup install`, `unitup start`, or `unitup status`, it interacts directly with the operating system's native service manager and exits immediately.
+
+---
+
+## Platform Support Table
+
+| Feature | Linux | macOS | Windows |
+| :--- | :--- | :--- | :--- |
+| **Install / Uninstall** | `systemd` user/system unit | `launchd` agent/daemon plist | Windows Service (`sc.exe`) |
+| **Start / Stop** | `systemctl start/stop` | `launchctl kickstart/kill` | `sc.exe start/stop` |
+| **Restart** | `systemctl restart` | `launchctl kickstart -k` | SCM restart |
+| **Auto-start on Boot** | `systemctl enable` | `RunAtLoad: true` | Automatic service startup |
+| **Environment Variables** | `Environment=` | `EnvironmentVariables` plist dict | Environment forwarding |
+| **Logs** | `journalctl` | File-based tail streaming | File-based tail streaming |
+| **Crash Recovery** | `Restart=on-failure` | `KeepAlive` dictionary | Host supervisor recovery |
+| **User Services** | `~/.config/systemd/user/` | `~/Library/LaunchAgents/` | Supported |
+| **System Services** | `/etc/systemd/system/` | `/Library/LaunchDaemons/` | Native Windows Service |
+| **Dry-Run Inspection** | `--dry-run` (systemd unit) | `--dry-run` (plist XML) | `--dry-run` (service config) |
+| **Diagnostics** | `unitup doctor` | `unitup doctor` | `unitup doctor` |
+
+---
+
+### Architecture & Workflow
+
+```mermaid
+flowchart TD
+    CLI["unitup CLI / API"]
+    Manager["ServiceManager"]
+    Norm["NormalizedServiceConfig"]
+
+    CLI --> Manager
+    Manager --> Norm
+
+    subgraph Adapters["Platform Adapters"]
+        LinuxAdapt["LinuxAdapter<br/>(systemd)"]
+        MacAdapt["MacOSAdapter<br/>(launchd)"]
+        WinAdapt["WindowsAdapter<br/>(SCM / Host)"]
+    end
+
+    Norm --> LinuxAdapt
+    Norm --> MacAdapt
+    Norm --> WinAdapt
+
+    subgraph LinuxOS["Linux"]
+        ServiceFile["systemd Unit<br/>(.service & .timer)"]
+        Systemctl["systemctl & journalctl"]
+        LinuxAdapt --> ServiceFile --> Systemctl
+    end
+
+    subgraph MacOSOS["macOS"]
+        PlistFile["launchd Plist<br/>(.plist)"]
+        Launchctl["launchctl (bootstrap / kickstart)"]
+        MacAdapt --> PlistFile --> Launchctl
+    end
+
+    subgraph WindowsOS["Windows"]
+        SCM["Windows SCM (sc.exe)"]
+        WinHost["Unitup Service Host"]
+        WinAdapt --> SCM --> WinHost
+    end
+```
+
+---
+
+## Quick Start
 
 ```bash
-# Quick Start
+# Install globally
 npm install -g unitup
 
-unitup add server.js --start
-unitup status server
-unitup logs server --follow
+# Cross-platform installation
+unitup install server.js --name api --start
+unitup status api
+unitup logs api --follow
+unitup restart api
+unitup stop api
+unitup uninstall api
+
+# Inspect what would be generated without applying changes
+unitup install server.js --name api --dry-run
+
+# Run cross-platform system diagnostics
+unitup doctor
 
 # Multi-runtime & Native Executables
-unitup add worker.py --runtime python --start
-unitup add ./server --runtime native --name api --start
+unitup install worker.py --runtime python --start
+unitup install ./server --runtime native --name api --start
 ```
 
 ---

package/biome.json

@@ -23,7 +23,6 @@
     "rules": {
       "recommended": true,
       "style": {
-        "useConstStruct": "off",
         "noUnusedTemplateLiteral": "off"
       },
       "complexity": {