theamify-cli 2.2.3 → 2.3.0

package/README.md

@@ -22,7 +22,7 @@ theamify info <name>        # details + terminal preview
 theamify get <name>         # download & cache a theme
 theamify get --all          # download every theme up front
 sudo theamify use <name>    # apply to GRUB + rebuild
-theamify update             # update tools (chafa, grub-customizer) + re-download themes
+theamify update             # update from npm, then update tools + re-download themes
 theamify status             # GRUB & dependency status
 theamify doctor             # diagnose install, GRUB, tools & dependencies
 theamify upgrade            # check for & install the latest npm version
@@ -40,6 +40,28 @@ theamify help               # show all commands
 
 ---
 
+## ✨ What's New (v2.3.0 — update from npm & Linux-only)
+
+| Feature | Details |
+|---|---|
+| 🔄 **`theamify update` pulls from npm** | `theamify update` first checks the registry and offers to `npm install -g theamify-cli@latest`, *then* refreshes companion tools (chafa, grub-customizer) and re-downloads themes — matching `gitswitch update` |
+| 🐧 **Linux-only by design** | theamify configures **GRUB**, which only exists on Linux. On other OSes the CLI refuses immediately with a clear message instead of failing halfway |
+| 🧭 **Cross-platform CI** | CI matrices + documentation updated across all three CLI packages |
+
+## ✨ What's New (v2.2.5 — doc refresh & command parity)
+
+| Feature | Details |
+|---|---|
+| 📖 **README synced** | Every command + alias documented and verified against the live CLI: `list`/`ls`, `info`/`show`, `get`/`fetch`/`download`, `use`/`apply`/`set`, `remove`/`rm`/`uncache`, `add`/`del`/`delete`, `update`, `open`, `status`, `doctor`, `upgrade`/`self-update`, `repair`, `browse`/`wizard`/`install`, `uninstall`, `clean`/`purge-cache`, `version`, `help` |
+| 🗑️ **Uninstall contract** | After `theamify uninstall`, `theamify` reports `command not found` (new terminal) — clear the current shell's cache with `hash -r` |
+
+## ✨ What's New (v2.2.4 — command-not-found clarity)
+
+| Feature | Details |
+|---|---|
+| 💡 **Current-terminal hint** | After uninstall, `theamify` is fully deleted — a **new terminal** reports `bash: theamify: command not found`. If your *current* shell still says `No such file or directory`, that's bash's cached command path — clear it with `hash -r` |
+| 🗑️ **Still removes everything** | Every runtime, theme, GRUB theme, npm package, `~/.local/bin/theamify` shadow and PATH marker |
+
 ## ✨ What's New (v2.2.3 — complete uninstall)
 
 | Feature | Details |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theamify-cli",
-  "version": "2.2.3",
+  "version": "2.3.0",
   "description": "theamify — GRUB theme manager & interactive browser wizard. Browse, preview, download and apply GRUB boot themes from the terminal.",
   "type": "module",
   "main": "src/cli.js",

package/src/cli.js

@@ -2,8 +2,7 @@ import { defineCommand, runMain } from 'citty';
 import pc from 'picocolors';
 import { createRequire } from 'node:module';
 import { runThemeBrowser } from './wizard/browse.js';
-import { runDoctor, runStatus, runUninstallWizard, runSelfUpgrade, runRepair } from './commands/manage.js';
-import { updateManagedTools } from './lib/tools.js';
+import { runDoctor, runStatus, runUninstallWizard, runSelfUpgrade, runRepair, runFullUpdate } from './commands/manage.js';
 import { runEngine } from './core/engine.js';
 
 const require = createRequire(import.meta.url);
@@ -35,7 +34,7 @@ ${pc.bold('Usage:')}
   theamify get <name>         Download & cache a theme
   theamify get --all          Download every theme
   theamify use <name>         Apply theme to GRUB ${pc.dim('[sudo]')}
-  theamify update [<name>]    Re-download cached themes
+  theamify update [<name>]    Update from npm, then tools + re-download themes
   theamify remove <name>      Clear local cache (keeps registry entry)
   theamify add <github-url>   Add a theme to the registry
   theamify del <name>         Remove a theme from the registry
@@ -73,6 +72,14 @@ const main = defineCommand({
   async run({ args }) {
     const [cmd, ...rest] = args._;
 
+    // theamify configures GRUB, which only exists on Linux. Refuse other OSes
+    // up-front with a clear message instead of failing halfway through.
+    if (process.platform !== 'linux') {
+      console.error(pc.red('theamify is Linux-only: it manages GRUB boot themes, and GRUB does not exist on this OS.'));
+      process.exitCode = 1;
+      return undefined;
+    }
+
     // citty parses `-V` as a boolean flag into args.V (never reached via args._);
     // treat it as a version request like the other aliases.
     if (args.V) {
@@ -114,10 +121,8 @@ const main = defineCommand({
       case 'uninstall':
         return runUninstallWizard();
       case 'update':
-        // Self-update path: refresh companion tools (chafa, grub-customizer),
-        // then forward theme re-downloads to the engine.
-        await updateManagedTools();
-        return forwardEngine(['update', ...rest]);
+        // Full update: pull the latest CLI from npm, then update tools + themes.
+        return runFullUpdate(rest);
       case 'use':
       case 'apply':
       case 'set':

package/src/commands/manage.js

@@ -85,6 +85,7 @@ export async function runStatus() {
 }
 
 /** `theamify upgrade` — self-update the npm CLI if a newer version is published. */
+/** `theamify upgrade` — check for & install the latest npm version. */
 export async function runSelfUpgrade() {
   const { outdated, latest, current } = await checkForUpdate();
   if (!outdated) {
@@ -95,6 +96,34 @@ export async function runSelfUpgrade() {
   await promptSelfUpdate();
 }
 
+/**
+ * `theamify update` — bring EVERYTHING up to date, exactly like gitswitch's
+ * `update`:
+ *   1. Pull the latest npm CLI from the registry (prompts, defaults to yes).
+ *   2. Then refresh companion tools (chafa, grub-customizer).
+ *   3. Then re-download all cached themes.
+ * @param {string[]} rest forwarded theme args (e.g. a single theme name)
+ */
+export async function runFullUpdate(rest = []) {
+  const { outdated, latest, current } = await checkForUpdate();
+  if (outdated) {
+    console.log(pc.cyan(`A newer version (v${latest}) is published — you have v${current}.`));
+    const updated = await promptSelfUpdate();
+    if (updated) {
+      console.log(pc.yellow('theamify CLI updated. Re-run `theamify update` (or just `theamify`) to continue updating tools & themes.'));
+      return;
+    }
+    console.log(pc.dim('Continuing — keeping current CLI version.'));
+  } else {
+    console.log(pc.green(`theamify CLI is on the latest version (v${current}).`));
+  }
+
+  const { updateManagedTools } = await import('../lib/tools.js');
+  await updateManagedTools();
+  const { runEngine } = await import('../core/engine.js');
+  await runEngine(['update', ...rest]);
+}
+
 /** `theamify repair` — fix a broken install by re-provisioning the engine/runtime. */
 export async function runRepair() {
   console.log(pc.bold('\n🔧 theamify Repair\n'));
@@ -209,4 +238,5 @@ export async function runUninstallWizard() {
     `Uninstalled.${removedCount ? ` ${removedCount} runtime tree(s) + all downloaded themes removed.` : ''} ${themeNote} ${npmRemoved ? 'theamify-cli npm package removed — the theamify command is gone.' : 'theamify-cli npm package could not be removed automatically — run: npm uninstall -g theamify-cli'} Companion tools (chafa, grub-customizer) were kept for your use.`,
   ));
   p.log.message(pc.dim('After uninstall, `theamify` reports: bash: theamify: command not found'));
+  p.log.message(pc.dim('If this terminal still shows "No such file or directory", clear bash\'s cached command path with: hash -r (or open a new terminal).'));
 }

package/vendor/theamify

@@ -10,7 +10,7 @@ set -euo pipefail
 # -----------------------------------------------------------------------------
 # VERSION & TOOL NAME
 # -----------------------------------------------------------------------------
-readonly VERSION="2.2.3"
+readonly VERSION="2.3.0"
 readonly TOOL="theamify"
 
 # -----------------------------------------------------------------------------