@dahch/heimdall 1.0.0 → 1.1.0

package/README.md

@@ -20,7 +20,7 @@
   2. **Aggregated Review & Confirmation**: Shows an interactive tabular overview comparing current and latest package versions across all managers, prompting for confirmation before modifying the system.
 - 🧪 **True Simulated Dry-Run (`--dry-run`)**: Traverses the full engine lifecycle, formats outdated packages, and executes mock update routines step-by-step with real-time feedback without touching system files.
 - ⚡ **High-Speed Registry Queries**: Yarn and pipx bypass heavy CLI subprocess spawning by querying the npm Registry and PyPI JSON APIs directly over HTTP with strict 3-second abort timeouts.
-- 🔐 **Non-Interactive Sudo Pre-Checks**: Privileged managers (MacPorts, Linux APT) verify cached credentials using `sudo -n true` beforehand, preventing terminal lockups and password prompt hangs.
+- 🔐 **Non-Interactive Sudo Pre-Checks**: Privileged managers (MacPorts, Linux APT, Linux DNF) verify cached credentials using `sudo -n true` beforehand, preventing terminal lockups and password prompt hangs.
 - 🎨 **Modern Minimalist UX**: Terminal interface powered by `@clack/prompts`, micro-border tabular layouts with directional version transitions (`current → latest`), persistent real-time step progression with elapsed durations, and actionable error extraction.
 - 🏷 **Dynamic Version Resolution**: Reads package name and version dynamically from `package.json` at runtime via `import.meta.url`, ensuring banners and `--version` flags remain in sync with repository releases.
 - ⚙ **Flexible Targeting**: Run interactively, execute non-interactively with `--yes`, or filter target managers using `--only` and `--exclude`.
@@ -29,7 +29,7 @@
 
 ## 📦 Supported Package Managers
 
-Heimdall (`hmd`) supports 13 package managers across system, runtime, language, and application store categories:
+Heimdall (`hmd`) supports 14 package managers across system, runtime, language, and application store categories:
 
 | Manager | Icon | Category | Detection Strategy | Update Routine & Resilience Rules |
 | :--- | :---: | :---: | :--- | :--- |
@@ -45,6 +45,7 @@ Heimdall (`hmd`) supports 13 package managers across system, runtime, language,
 | **[MacPorts](https://www.macports.org)** | ⚓ | `system` | `port outdated` + non-interactive `sudo -n true` verification | 1. `sudo port selfupdate`<br>2. `sudo port upgrade outdated` |
 | **[Mac App Store (mas)](https://github.com/mas-cli/mas)** | 🍎 | `appstore` | `mas outdated` | `mas upgrade` |
 | **[APT (Debian/Ubuntu)](https://wiki.debian.org/Apt)** | 🐧 | `system` | `apt list --upgradable` + non-interactive `sudo -n true` check | 1. `sudo apt-get update -y`<br>2. `sudo apt-get upgrade -y`<br>3. `sudo apt-get autoremove -y` |
+| **[DNF (Fedora/RHEL)](https://docs.fedoraproject.org/en-US/quick-docs/dnf/)** | 📦 | `system` | `dnf check-update -y` (exit code 100 signals updates) + `sudo -n true` check | 1. `sudo dnf upgrade -y --refresh`<br>2. `sudo dnf autoremove -y` (prompted interactively with confirmation prompt, auto-approved with `--yes` or `--dry-run`) |
 | **[Flatpak](https://flatpak.org)** | 📦 | `system` | `flatpak remote-ls --updates` | `flatpak update -y --noninteractive` |
 
 ---
@@ -178,7 +179,7 @@ Heimdall employs an automated GitHub Actions CI/CD workflow ([`.github/workflows
 
 - [SPEC.md](SPEC.md): Technical specification, CLI contract, data models, and exit codes.
 - [DESIGN.md](DESIGN.md): System architecture, Two-Phase workflow, Engine concurrency pool, and Mermaid diagrams.
-- [ADR.md](ADR.md): Architectural Decision Records (ADR-001 through ADR-009) documenting key engineering decisions.
+- [ADR.md](ADR.md): Architectural Decision Records (ADR-001 through ADR-010) documenting key engineering decisions.
 - [AGENTS.md](AGENTS.md): Developer and AI agent reference manual for maintaining and extending the codebase.
 
 ---

package/dist/cli.js

@@ -1513,6 +1513,101 @@ var MacAppStoreManager = class extends BasePackageManager {
   }
 };
 
+// src/utils/formatting.ts
+import pc from "picocolors";
+import Table from "cli-table3";
+function formatDuration(ms) {
+  if (ms < 1e3) return `${ms}ms`;
+  const seconds = (ms / 1e3).toFixed(1);
+  return `${seconds}s`;
+}
+function renderUpdatesTable(items) {
+  if (items.length === 0) {
+    return pc.dim("  No updates pending.");
+  }
+  const table = new Table({
+    head: [
+      pc.dim("Manager"),
+      pc.dim("Package"),
+      pc.dim("Type"),
+      pc.dim("Version Transition")
+    ],
+    style: {
+      head: [],
+      border: ["dim"]
+    },
+    chars: {
+      top: "\u2500",
+      "top-mid": "\u2500",
+      "top-left": "\u250C",
+      "top-right": "\u2510",
+      bottom: "\u2500",
+      "bottom-mid": "\u2500",
+      "bottom-left": "\u2514",
+      "bottom-right": "\u2518",
+      left: "\u2502",
+      "left-mid": "\u251C",
+      mid: "\u2500",
+      "mid-mid": "\u253C",
+      right: "\u2502",
+      "right-mid": "\u2524",
+      middle: "\u2502"
+    }
+  });
+  for (const item of items) {
+    const typeLabel = item.type ? pc.dim(`[${item.type}]`) : pc.dim("-");
+    const currentVer = pc.yellow(item.currentVersion || "?");
+    const arrow = pc.dim(" \u2192 ");
+    const latestVer = pc.green(pc.bold(item.latestVersion || "?"));
+    table.push([
+      pc.cyan(item.managerName),
+      pc.bold(pc.white(item.name)),
+      typeLabel,
+      `${currentVer}${arrow}${latestVer}`
+    ]);
+  }
+  return table.toString();
+}
+function renderExecutionSummary(results) {
+  const total = results.length;
+  const successful = results.filter((r) => r.success).length;
+  const failed = results.filter((r) => !r.success).length;
+  const totalUpdated = results.reduce((acc, r) => acc + r.updatedCount, 0);
+  const lines = [];
+  lines.push("");
+  lines.push(pc.dim("\u2500".repeat(60)));
+  lines.push(`  ${pc.bold(pc.cyan("Heimdall"))} ${pc.dim("\u2022 Execution Summary")}`);
+  lines.push(pc.dim("\u2500".repeat(60)));
+  for (const res of results) {
+    const icon = res.icon || "\u{1F4E6}";
+    const status = res.success ? pc.green("\u2714 SUCCESS") : pc.red("\u2716 FAILED");
+    const time = pc.dim(`(${formatDuration(res.durationMs)})`);
+    const count = res.success ? pc.dim(`\u2022 ${res.updatedCount} updated`) : pc.dim(`\u2022 ${res.updatedCount} updated, ${res.steps.filter((s) => s.status === "failed").length} issue(s)`);
+    lines.push(`  ${icon} ${pc.bold(res.managerName)} ${status} ${count} ${time}`);
+    if (!res.success && res.error) {
+      lines.push(`     ${pc.red("\u21B3 Error:")} ${pc.dim(res.error.trim().split("\n")[0])}`);
+    }
+    if (res.steps.length > 0) {
+      for (const step of res.steps) {
+        if (step.status === "skipped") continue;
+        const stepStatus = step.status === "success" ? pc.green("\u2714") : step.status === "failed" ? pc.red("\u2716") : pc.dim("\u25CB");
+        const stepDuration = step.durationMs ? pc.dim(`[${formatDuration(step.durationMs)}]`) : "";
+        const stepError = step.error && step.status === "failed" ? pc.red(` (${step.error.split("\n")[0]})`) : "";
+        lines.push(`       ${stepStatus} ${pc.dim(step.name)} ${stepDuration}${stepError}`);
+      }
+    }
+  }
+  lines.push(pc.dim("\u2500".repeat(60)));
+  const summaryParts = [
+    pc.green(`${successful}/${total} managers succeeded`),
+    failed > 0 ? pc.red(`${failed} failed`) : null,
+    pc.cyan(`${totalUpdated} package(s) updated`)
+  ].filter(Boolean);
+  lines.push(`  ${summaryParts.join(" \u2022 ")}`);
+  lines.push(pc.dim("\u2500".repeat(60)));
+  return lines.join("\n");
+}
+
 // src/managers/linux.ts
 var AptManager = class extends BasePackageManager {
   id = "apt";
@@ -1720,6 +1815,192 @@ var FlatpakManager = class extends BasePackageManager {
     };
   }
 };
+var DnfManager = class extends BasePackageManager {
+  id = "dnf";
+  name = "DNF (Fedora/RHEL)";
+  icon = "\u{1F4E6}";
+  category = "system";
+  binary = "dnf";
+  async checkUpdates(options) {
+    const startTime = Date.now();
+    const isAvail = await this.isAvailable();
+    if (!isAvail) {
+      return {
+        managerId: this.id,
+        managerName: this.name,
+        icon: this.icon,
+        category: this.category,
+        available: false,
+        updates: [],
+        durationMs: 0
+      };
+    }
+    try {
+      const execRes = await safeExec(this.binary, ["check-update", "-y"], {
+        timeoutMs: options?.timeoutMs ?? 25e3
+      });
+      if (execRes.exitCode !== 0 && execRes.exitCode !== 100) {
+        return {
+          managerId: this.id,
+          managerName: this.name,
+          icon: this.icon,
+          category: this.category,
+          available: true,
+          updates: [],
+          durationMs: Date.now() - startTime,
+          error: (execRes.stderr || execRes.stdout).trim() ? extractErrorMessage(execRes.stderr || execRes.stdout) : `dnf check-update failed with code ${execRes.exitCode}`
+        };
+      }
+      if (execRes.exitCode === 0) {
+        return {
+          managerId: this.id,
+          managerName: this.name,
+          icon: this.icon,
+          category: this.category,
+          available: true,
+          updates: [],
+          durationMs: Date.now() - startTime
+        };
+      }
+      const updates = [];
+      const lines = execRes.stdout.split("\n");
+      let pendingPkg = null;
+      for (const rawLine of lines) {
+        const line = rawLine.trim();
+        if (!line) continue;
+        if (line.startsWith("Updating and loading repositories") || line.startsWith("Repositories loaded") || line.startsWith("Last metadata expiration check") || line.startsWith("Obsoleting Packages") || line.startsWith("Loaded plugins") || line.startsWith("Security:")) {
+          continue;
+        }
+        const combinedLine = pendingPkg ? `${pendingPkg} ${line}` : line;
+        const match = combinedLine.match(/^(\S+?)\.([a-zA-Z0-9_]+)\s+(\S+)\s+(\S+)/);
+        if (match) {
+          const [, name, arch, latestVersion, repo] = match;
+          updates.push({
+            managerId: this.id,
+            managerName: this.name,
+            name,
+            currentVersion: "installed",
+            latestVersion,
+            type: "rpm",
+            extra: `${repo} (${arch})`
+          });
+          pendingPkg = null;
+        } else if (!pendingPkg && /^\S+?\.[a-zA-Z0-9_]+$/.test(line)) {
+          pendingPkg = line;
+        } else {
+          pendingPkg = null;
+        }
+      }
+      return {
+        managerId: this.id,
+        managerName: this.name,
+        icon: this.icon,
+        category: this.category,
+        available: true,
+        updates,
+        durationMs: Date.now() - startTime
+      };
+    } catch (err) {
+      return {
+        managerId: this.id,
+        managerName: this.name,
+        icon: this.icon,
+        category: this.category,
+        available: true,
+        updates: [],
+        durationMs: Date.now() - startTime,
+        error: err instanceof Error ? err.message : String(err)
+      };
+    }
+  }
+  async executeUpdate(items, options) {
+    const startTime = Date.now();
+    const steps = [];
+    if (!options.dryRun && process.getuid?.() !== 0) {
+      const sudoCheck = await safeExec("sudo", ["-n", "true"], { timeoutMs: 3e3 });
+      if (!sudoCheck.success) {
+        return {
+          managerId: this.id,
+          managerName: this.name,
+          icon: this.icon,
+          success: false,
+          updatedCount: 0,
+          durationMs: Date.now() - startTime,
+          steps: [
+            {
+              name: "sudo privileges",
+              command: "sudo -n true",
+              status: "failed",
+              error: 'DNF requires sudo privileges. Run "sudo -v" before running hmd.'
+            }
+          ],
+          error: 'DNF requires sudo privileges. Run "sudo -v" before running hmd.'
+        };
+      }
+    }
+    const upgradeStep = await this.executeStep(
+      "sudo dnf upgrade --refresh",
+      "sudo",
+      ["dnf", "upgrade", "-y", "--refresh"],
+      options
+    );
+    steps.push(upgradeStep);
+    if (upgradeStep.status === "success") {
+      if (options.dryRun) {
+        const autoremoveStep = await this.executeStep(
+          "sudo dnf autoremove",
+          "sudo",
+          ["dnf", "autoremove", "-y"],
+          options
+        );
+        steps.push(autoremoveStep);
+      } else if (options.confirmAction) {
+        const shouldAutoremove = await options.confirmAction(
+          "Do you want to run sudo dnf autoremove to clean up orphaned packages?"
+        );
+        if (shouldAutoremove) {
+          const autoremoveStep = await this.executeStep(
+            "sudo dnf autoremove",
+            "sudo",
+            ["dnf", "autoremove", "-y"],
+            options
+          );
+          steps.push(autoremoveStep);
+        } else {
+          steps.push({
+            name: "sudo dnf autoremove",
+            command: "sudo dnf autoremove -y",
+            status: "skipped"
+          });
+        }
+      } else {
+        steps.push({
+          name: "sudo dnf autoremove",
+          command: "sudo dnf autoremove -y",
+          status: "skipped"
+        });
+      }
+    } else {
+      steps.push({
+        name: "sudo dnf autoremove",
+        command: "sudo dnf autoremove -y",
+        status: "skipped"
+      });
+    }
+    const nonSkippedSteps = steps.filter((s) => s.status !== "skipped");
+    const success = nonSkippedSteps.length > 0 && nonSkippedSteps.every((s) => s.status === "success");
+    return {
+      managerId: this.id,
+      managerName: this.name,
+      icon: this.icon,
+      success,
+      updatedCount: success ? items.length : 0,
+      durationMs: Date.now() - startTime,
+      steps,
+      error: !success ? steps.find((s) => s.status === "failed")?.error : void 0
+    };
+  }
+};
 
 // src/managers/registry.ts
 function createDefaultManagers() {
@@ -1736,6 +2017,7 @@ function createDefaultManagers() {
     new MacPortsManager(),
     new MacAppStoreManager(),
     new AptManager(),
+    new DnfManager(),
     new FlatpakManager()
   ];
 }
@@ -1872,108 +2154,13 @@ var UpdaterEngine = class {
   }
 };
 
-// src/utils/formatting.ts
-import pc from "picocolors";
-import Table from "cli-table3";
-function formatDuration(ms) {
-  if (ms < 1e3) return `${ms}ms`;
-  const seconds = (ms / 1e3).toFixed(1);
-  return `${seconds}s`;
-}
-function renderUpdatesTable(items) {
-  if (items.length === 0) {
-    return pc.dim("  No updates pending.");
-  }
-  const table = new Table({
-    head: [
-      pc.dim("Manager"),
-      pc.dim("Package"),
-      pc.dim("Type"),
-      pc.dim("Version Transition")
-    ],
-    style: {
-      head: [],
-      border: ["dim"]
-    },
-    chars: {
-      top: "\u2500",
-      "top-mid": "\u2500",
-      "top-left": "\u250C",
-      "top-right": "\u2510",
-      bottom: "\u2500",
-      "bottom-mid": "\u2500",
-      "bottom-left": "\u2514",
-      "bottom-right": "\u2518",
-      left: "\u2502",
-      "left-mid": "\u251C",
-      mid: "\u2500",
-      "mid-mid": "\u253C",
-      right: "\u2502",
-      "right-mid": "\u2524",
-      middle: "\u2502"
-    }
-  });
-  for (const item of items) {
-    const typeLabel = item.type ? pc.dim(`[${item.type}]`) : pc.dim("-");
-    const currentVer = pc.yellow(item.currentVersion || "?");
-    const arrow = pc.dim(" \u2192 ");
-    const latestVer = pc.green(pc.bold(item.latestVersion || "?"));
-    table.push([
-      pc.cyan(item.managerName),
-      pc.bold(pc.white(item.name)),
-      typeLabel,
-      `${currentVer}${arrow}${latestVer}`
-    ]);
-  }
-  return table.toString();
-}
-function renderExecutionSummary(results) {
-  const total = results.length;
-  const successful = results.filter((r) => r.success).length;
-  const failed = results.filter((r) => !r.success).length;
-  const totalUpdated = results.reduce((acc, r) => acc + r.updatedCount, 0);
-  const lines = [];
-  lines.push("");
-  lines.push(pc.dim("\u2500".repeat(60)));
-  lines.push(`  ${pc.bold(pc.cyan("Heimdall"))} ${pc.dim("\u2022 Execution Summary")}`);
-  lines.push(pc.dim("\u2500".repeat(60)));
-  for (const res of results) {
-    const icon = res.icon || "\u{1F4E6}";
-    const status = res.success ? pc.green("\u2714 SUCCESS") : pc.red("\u2716 FAILED");
-    const time = pc.dim(`(${formatDuration(res.durationMs)})`);
-    const count = res.success ? pc.dim(`\u2022 ${res.updatedCount} updated`) : pc.dim(`\u2022 ${res.updatedCount} updated, ${res.steps.filter((s) => s.status === "failed").length} issue(s)`);
-    lines.push(`  ${icon} ${pc.bold(res.managerName)} ${status} ${count} ${time}`);
-    if (!res.success && res.error) {
-      lines.push(`     ${pc.red("\u21B3 Error:")} ${pc.dim(res.error.trim().split("\n")[0])}`);
-    }
-    if (res.steps.length > 0) {
-      for (const step of res.steps) {
-        if (step.status === "skipped") continue;
-        const stepStatus = step.status === "success" ? pc.green("\u2714") : step.status === "failed" ? pc.red("\u2716") : pc.dim("\u25CB");
-        const stepDuration = step.durationMs ? pc.dim(`[${formatDuration(step.durationMs)}]`) : "";
-        const stepError = step.error && step.status === "failed" ? pc.red(` (${step.error.split("\n")[0]})`) : "";
-        lines.push(`       ${stepStatus} ${pc.dim(step.name)} ${stepDuration}${stepError}`);
-      }
-    }
-  }
-  lines.push(pc.dim("\u2500".repeat(60)));
-  const summaryParts = [
-    pc.green(`${successful}/${total} managers succeeded`),
-    failed > 0 ? pc.red(`${failed} failed`) : null,
-    pc.cyan(`${totalUpdated} package(s) updated`)
-  ].filter(Boolean);
-  lines.push(`  ${summaryParts.join(" \u2022 ")}`);
-  lines.push(pc.dim("\u2500".repeat(60)));
-  return lines.join("\n");
-}
-
 // src/utils/version.ts
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
 import { existsSync, readFileSync } from "fs";
 var FALLBACK_METADATA = {
   name: "@dahch/heimdall",
-  version: "1.0.0",
+  version: "1.0.1",
   description: "Heimdall: resilient validator and updater for system and global packages"
 };
 var cachedMetadata = null;
@@ -2170,6 +2357,13 @@ ${isSimulated ? "[DRY RUN] Simulating" : "Starting"} updates for ${managersToUpd
     {
       verbose: options.verbose,
       dryRun: isSimulated,
+      confirmAction: async (message) => {
+        if (options.yes) return true;
+        updateSpinner.stop(pc2.dim("Waiting for user confirmation..."));
+        const confirmed = await p.confirm({ message, initialValue: false });
+        updateSpinner.start(pc2.dim("Continuing update..."));
+        return typeof confirmed === "boolean" ? confirmed : false;
+      },
       onStepStart: (stepName) => {
         updateSpinner.message(pc2.dim(`Running: ${stepName}...`));
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dahch/heimdall",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Heimdall: resilient validator and updater for system and global packages",
   "type": "module",
   "publishConfig": {
@@ -10,8 +10,8 @@
     "dist"
   ],
   "bin": {
-    "hmd": "./dist/cli.js",
-    "heimdall": "./dist/cli.js"
+    "hmd": "dist/cli.js",
+    "heimdall": "dist/cli.js"
   },
   "scripts": {
     "dev": "tsx src/cli.ts",