unitup 0.0.10 → 0.0.11

package/README.md

@@ -327,6 +327,7 @@ unitup add worker.py --name worker --group backend --start
 - `--env-file <file>`: Path to environment file (adds `EnvironmentFile=...`).
 - `--restart <policy>`: Systemd restart policy (`on-failure`, `always`, `no`, `on-abnormal`. Default: `on-failure`).
 - `--start`: Automatically enables and starts the service immediately (`systemctl --user enable --now`).
+- `--force`, `-f`: Force overwrite of an existing service if it is currently running.
 
 Generated unit file example (`~/.config/systemd/user/unitup-worker.service`):
 
@@ -477,11 +478,15 @@ unitup failures
 
 ### `unitup remove <name|@group>`
 
-Stops, disables, and deletes the unit file, then reloads systemd:
+Stops, disables, and deletes the unit file, then reloads systemd. If the service is currently running, `unitup` prevents accidental deletion and requires `--force` / `-f`:
 
 ```bash
+# Remove stopped service
 unitup remove worker
-unitup remove @backend
+
+# Force remove an actively running service or group
+unitup remove worker --force
+unitup remove @backend -f
 ```
 
 ---

package/docs/index.html

@@ -43,7 +43,10 @@
     <div class="flex items-center justify-between mb-10 gap-4 flex-wrap pb-6 border-b border-slate-200 dark:border-slate-800">
       <div class="flex items-center gap-3">
         <span class="text-2xl font-black tracking-tight text-cyan-600 dark:text-cyan-400">unitup</span>
-        <span class="text-xs px-2.5 py-0.5 rounded-full bg-cyan-100 text-cyan-800 dark:bg-cyan-950 dark:text-cyan-300 font-semibold border border-cyan-300 dark:border-cyan-800">v0.0.9</span>
+        <span class="text-xs px-2.5 py-0.5 rounded-full bg-cyan-100 text-cyan-800 dark:bg-cyan-950 dark:text-cyan-300 font-semibold border border-cyan-300 dark:border-cyan-800">v0.0.10</span>
+        <a href="https://github.com/litepacks/unitup" target="_blank" rel="noopener noreferrer" class="text-slate-500 hover:text-cyan-600 dark:text-slate-400 dark:hover:text-cyan-400 transition-colors" aria-label="GitHub Repository">
+          <svg class="w-5 h-5" fill="currentColor" viewBox="0 0 24 24"><path fill-rule="evenodd" clip-rule="evenodd" d="M12 2C6.477 2 2 6.484 2 12.017c0 4.425 2.865 8.18 6.839 9.504.5.092.682-.217.682-.483 0-.237-.008-.868-.013-1.703-2.782.605-3.369-1.343-3.369-1.343-.454-1.158-1.11-1.466-1.11-1.466-.908-.62.069-.608.069-.608 1.003.07 1.53 1.032 1.53 1.032.892 1.53 2.341 1.088 2.91.832.092-.647.35-1.088.636-1.338-2.22-.253-4.555-1.113-4.555-4.951 0-1.093.39-1.988 1.029-2.688-.103-.253-.446-1.272.098-2.65 0 0 .84-.27 2.75 1.026A9.564 9.564 0 0112 6.844c.85.004 1.705.115 2.504.337 1.909-1.296 2.747-1.027 2.747-1.027.546 1.379.202 2.398.1 2.651.64.7 1.028 1.595 1.028 2.688 0 3.848-2.339 4.695-4.566 4.943.359.309.678.92.678 1.855 0 1.338-.012 2.419-.012 2.747 0 .268.18.58.688.482A10.019 10.019 0 0022 12.017C22 6.484 17.522 2 12 2z"/></svg>
+        </a>
       </div>
       <nav class="flex flex-wrap gap-x-4 gap-y-2 text-sm font-medium" aria-label="Page sections">
         <a href="#overview" class="text-slate-600 hover:text-cyan-600 dark:text-slate-400 dark:hover:text-cyan-400">Overview</a>
@@ -54,6 +57,7 @@
         <a href="#api" class="text-slate-600 hover:text-cyan-600 dark:text-slate-400 dark:hover:text-cyan-400">API</a>
         <a href="#declarative" class="text-slate-600 hover:text-cyan-600 dark:text-slate-400 dark:hover:text-cyan-400">Roadmap</a>
         <a href="#troubleshooting" class="text-slate-600 hover:text-cyan-600 dark:text-slate-400 dark:hover:text-cyan-400">Lingering</a>
+        <a href="https://github.com/litepacks/unitup" target="_blank" rel="noopener noreferrer" class="text-cyan-600 dark:text-cyan-400 hover:underline flex items-center gap-1 font-semibold">GitHub &rarr;</a>
       </nav>
       <button id="theme-toggle" type="button" class="p-2 rounded-lg border border-slate-200 dark:border-slate-800 text-slate-500 hover:bg-slate-200 dark:hover:bg-slate-800 dark:text-slate-400 shrink-0" aria-label="Toggle dark mode">
         <svg class="w-5 h-5 hidden dark:block" fill="none" stroke="currentColor" viewBox="0 0 24 24"><path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"/></svg>
@@ -332,6 +336,7 @@ WantedBy=default.target</code></pre>
 # --env KEY=val       Set environment variable
 # --env-file <path>   Load environment file
 # --start             Enable and start service immediately
+# --force, -f         Force overwrite of currently running service
 
 unitup add worker.py --name worker --group backend --env APP_ENV=production --start</code></pre>
         </div>
@@ -384,6 +389,14 @@ unitup journal rotate
 unitup journal vacuum --size 500M --yes
 unitup journal vacuum --time 14d --dry-run</code></pre>
         </div>
+
+        <!-- remove -->
+        <div class="p-5 rounded-xl border border-slate-200 dark:border-slate-800 bg-white/70 dark:bg-slate-900/50">
+          <h3 class="text-lg font-bold text-cyan-600 dark:text-cyan-400 mb-2"><code class="text-base">unitup remove &lt;name|@group&gt; [--force]</code></h3>
+          <p class="text-sm text-slate-600 dark:text-slate-400 mb-3">Stops, disables, and deletes a service or group. Active running services require <code class="text-xs">--force</code> / <code class="text-xs">-f</code> to prevent accidental deletion.</p>
+          <pre><code class="language-bash">unitup remove worker
+unitup remove @backend --force</code></pre>
+        </div>
       </div>
     </section>
 
@@ -511,7 +524,7 @@ unitup restart @default</code></pre>
 
     <!-- Footer -->
     <footer class="pt-8 border-t border-slate-200 dark:border-slate-800 text-center text-sm text-slate-500 dark:text-slate-500">
-      <p>unitup is released under the <a href="https://opensource.org/licenses/MIT" class="underline hover:text-slate-700 dark:hover:text-slate-300">MIT License</a>. Native Systemd User Service Manager.</p>
+      <p><a href="https://github.com/litepacks/unitup" target="_blank" rel="noopener noreferrer" class="text-cyan-600 dark:text-cyan-400 hover:underline">github.com/litepacks/unitup</a> · Released under <a href="https://opensource.org/licenses/MIT" target="_blank" rel="noopener noreferrer" class="underline hover:text-slate-700 dark:hover:text-slate-300">MIT License</a>.</p>
     </footer>
   </div>
 

package/index.d.ts

@@ -77,6 +77,12 @@ export interface CreateServiceOptions {
    */
   start?: boolean;
 
+  /**
+   * Force overwrite of currently running service.
+   * @default false
+   */
+  force?: boolean;
+
   /**
    * Soft memory limit directive (e.g. '400M').
    */
@@ -406,7 +412,7 @@ export function addService(options: CreateServiceOptions): Promise<AddServiceRes
 export function startService(name: string, enable?: boolean): Promise<boolean>;
 export function stopService(name: string): Promise<boolean>;
 export function restartService(name: string): Promise<boolean>;
-export function removeService(name: string): Promise<boolean>;
+export function removeService(name: string, options?: { force?: boolean } | boolean): Promise<boolean>;
 export function getServiceStatus(name: string): Promise<ServiceStatus>;
 export function getServiceStatusRaw(name: string): Promise<string>;
 export function listServices(options?: { group?: string }): Promise<ListServiceItem[]>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "unitup",
-  "version": "0.0.10",
-  "description": "Minimal systemd user service wrapper for Node.js scripts",
+  "version": "0.0.11",
+  "description": "Minimal, zero-dependency systemd-native service manager for any runtime, script, or executable",
   "main": "src/index.js",
   "types": "./index.d.ts",
   "type": "module",
@@ -19,9 +19,20 @@
     "service",
     "user-service",
     "systemctl",
+    "process-manager",
+    "daemon-less",
+    "multi-runtime",
     "node",
-    "cli",
-    "process-manager"
+    "python",
+    "ruby",
+    "php",
+    "bun",
+    "deno",
+    "go",
+    "elixir",
+    "shell",
+    "journald",
+    "cli"
   ],
   "author": "",
   "license": "MIT",

package/src/cli.js

@@ -53,6 +53,7 @@ export function parseArgs(argv) {
       lines: 100,
       help: false,
       version: false,
+      force: false,
       memoryHigh: '',
       memoryMax: '',
       memorySwapMax: '',
@@ -163,8 +164,9 @@ export function parseArgs(argv) {
     } else if (arg === '--raw') {
       result.flags.raw = true;
       i++;
-    } else if (arg === '-f' || arg === '--follow') {
+    } else if (arg === '-f' || arg === '--follow' || arg === '--force') {
       result.flags.follow = true;
+      result.flags.force = true;
       i++;
     } else if (arg === '-c' || arg === '--cat') {
       result.flags.cat = true;
@@ -414,7 +416,8 @@ export async function runCli(argv = process.argv.slice(2)) {
           start: flags.start,
           memoryHigh: flags.memoryHigh,
           memoryMax: flags.memoryMax,
-          memorySwapMax: flags.memorySwapMax
+          memorySwapMax: flags.memorySwapMax,
+          force: flags.force
         });
 
         console.log(`✓ Service "${res.name}" created at ${res.unitPath}`);
@@ -583,7 +586,7 @@ export async function runCli(argv = process.argv.slice(2)) {
         }
         const targetNames = await resolveTargetNames(nameArg);
         for (const name of targetNames) {
-          await removeService(name);
+          await removeService(name, { force: flags.force });
           console.log(`✓ Service "${sanitizeServiceName(name)}" removed.`);
         }
         break;

package/src/systemd.js

@@ -280,6 +280,26 @@ export async function resetFailed() {
 
 export async function addService(opts) {
   const safeName = sanitizeServiceName(opts.name);
+
+  if (unitFileExists(safeName)) {
+    try {
+      const show = await getServiceShow(safeName);
+      if (show.ActiveState === 'active') {
+        if (!opts.force) {
+          throw new Error(
+            `Service "${safeName}" is currently running.\n` +
+            `Use --force (-f) to overwrite running services, or stop it first:\n` +
+            `  unitup stop ${safeName}`
+          );
+        }
+      }
+    } catch (err) {
+      if (err.message.includes('currently running')) {
+        throw err;
+      }
+    }
+  }
+
   const runtimeConfig = await resolveRuntimeConfig({ ...opts, name: safeName });
 
   const { path: unitPath } = writeUnitFile({
@@ -376,14 +396,16 @@ export async function restartService(name) {
   return true;
 }
 
-export async function removeService(name) {
+export async function removeService(name, opts = {}) {
+  const force = typeof opts === 'boolean' ? opts : !!opts?.force;
+
   if (name && typeof name === 'string' && name.startsWith('@')) {
     const list = await getServicesByGroup(name);
     if (list.length === 0) {
       throw new Error(`No services found in group "${name}".`);
     }
     for (const s of list) {
-      await removeService(s);
+      await removeService(s, { force });
     }
     return true;
   }
@@ -393,6 +415,23 @@ export async function removeService(name) {
     throw new Error(`Service "${safeName}" does not exist.`);
   }
 
+  try {
+    const show = await getServiceShow(safeName);
+    if (show.ActiveState === 'active') {
+      if (!force) {
+        throw new Error(
+          `Service "${safeName}" is currently running.\n` +
+          `Use --force (-f) to remove running services, or stop it first:\n` +
+          `  unitup stop ${safeName}`
+        );
+      }
+    }
+  } catch (err) {
+    if (err.message.includes('currently running')) {
+      throw err;
+    }
+  }
+
   // Attempt disable and stop
   await runCommand('systemctl', ['--user', 'disable', '--now', getUnitFilename(safeName)]);
 

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "noEmit": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "allowJs": true,
+    "checkJs": false
+  },
+  "include": ["index.d.ts"]
+}