@shnitzel/plugscout 0.3.11 → 0.3.13

package/dist/interfaces/cli/index.js

@@ -30,7 +30,7 @@ import { hasFlag, readCsvList, readFlag, readKinds, readLimit, readSort } from '
 import { renderHomeScreen, renderInteractiveHome } from './ui/home.js';
 import { handleMcp } from './mcp.js';
 import { writeWebReport } from './ui/web-report.js';
-import { checkForUpdateNow, maybeNotifyAboutUpdate, RELEASE_DOWNLOAD_URL } from './update-check.js';
+import { applyUpdate, checkForUpdateNow, maybeNotifyAboutUpdate, RELEASE_DOWNLOAD_URL } from './update-check.js';
 const COMMAND_ALIASES = {
     home: 'home',
     about: 'about',
@@ -891,12 +891,34 @@ async function handleClient(args) {
 }
 async function handleUpgrade(args) {
     const subcommand = args[0] ?? 'check';
+    if (subcommand === 'apply') {
+        const result = await applyUpdate();
+        renderApplyResult(result);
+        return;
+    }
     if (subcommand !== 'check') {
-        throw new Error('Usage: upgrade check');
+        throw new Error('Usage: upgrade check | upgrade apply');
     }
     const result = await checkForUpdateNow();
     renderUpgradeResult(result);
 }
+function renderApplyResult(result) {
+    if (result.status === 'upgraded') {
+        console.log(`PlugScout upgraded: v${result.fromVersion} -> v${result.toVersion}`);
+        return;
+    }
+    if (result.status === 'already-latest') {
+        console.log(`PlugScout is already up to date (v${result.currentVersion}).`);
+        return;
+    }
+    if (result.status === 'no-release') {
+        console.log('No published release found yet.');
+        console.log(`Releases: ${RELEASE_DOWNLOAD_URL}`);
+        return;
+    }
+    console.log(`Upgrade failed: ${result.detail}`);
+    console.log(`Manual install: npm install -g @shnitzel/plugscout@latest`);
+}
 function renderUpgradeResult(result) {
     if (result.status === 'no-release') {
         console.log('No published release found yet.');
@@ -915,7 +937,7 @@ function renderUpgradeResult(result) {
         return;
     }
     console.log(`New PlugScout version available: v${result.currentVersion} -> v${result.latestVersion}`);
-    console.log(`Download: ${RELEASE_DOWNLOAD_URL}`);
+    console.log(`Upgrade: plugscout upgrade apply   |   Download: ${RELEASE_DOWNLOAD_URL}`);
 }
 function sortRecommendations(recommendations, sort) {
     const sorted = [...recommendations];
@@ -1043,6 +1065,7 @@ function printHelp() {
     console.log('  web [--out .plugscout/report.html] [--kind ...] [--limit n] [--open]');
     console.log('  client setup --client cursor|gemini|claude-desktop|windsurf|opencode|zed [--scope user|project] [--force]');
     console.log('  upgrade check');
+    console.log('  upgrade apply                  auto-install latest version via npm');
     console.log('  help');
     console.log('');
     console.log('Kind aliases');

package/dist/interfaces/cli/ui/home.js

@@ -192,24 +192,27 @@ export async function renderInteractiveHome() {
     const CTRL_C = '\u0003';
     function render(firstRender) {
         if (!firstRender) {
-            process.stdout.write(`\x1b[${menuItems.length * 2}A\r`);
+            // Restore saved cursor position and clear everything below it.
+            // This avoids line-count arithmetic that breaks when descriptions wrap.
+            process.stdout.write('\x1b[u\x1b[0J');
         }
         for (let i = 0; i < menuItems.length; i++) {
             const item = menuItems[i];
             const prefix = i === selected ? '  \u276f ' : '    ';
-            process.stdout.write(`\x1b[2K${prefix}${item.label}\n`);
+            process.stdout.write(`${prefix}${item.label}\n`);
             if (item.description) {
                 const firstLine = item.description.split('\n')[0];
-                process.stdout.write(`\x1b[2K        \x1b[2m${firstLine}\x1b[0m\n`);
+                process.stdout.write(`        \x1b[2m${firstLine}\x1b[0m\n`);
             }
             else {
-                process.stdout.write(`\x1b[2K\n`);
+                process.stdout.write('\n');
             }
         }
     }
     let running = true;
     while (running) {
         process.stdout.write('\n');
+        process.stdout.write('\x1b[s'); // save cursor — used by render(false) to redraw in-place
         process.stdin.setRawMode(true);
         process.stdin.resume();
         process.stdin.setEncoding('utf8');

package/dist/interfaces/cli/update-check.js

@@ -1,4 +1,5 @@
 import fs from 'node:fs/promises';
+import { spawnSync } from 'node:child_process';
 import semver from 'semver';
 import { readJsonFile, writeJsonFile } from '../../lib/json.js';
 import { getPackagePath, getStatePath } from '../../lib/paths.js';
@@ -80,7 +81,7 @@ export async function maybeNotifyAboutUpdate(options = {}) {
         return;
     }
     console.log(`New PlugScout version available: v${currentVersion} -> v${state.latestVersion}`);
-    console.log(`Download: ${RELEASE_DOWNLOAD_URL}`);
+    console.log(`Upgrade: plugscout upgrade apply   |   Download: ${RELEASE_DOWNLOAD_URL}`);
     await saveUpdateCheckState({
         ...state,
         source: 'github-releases',
@@ -113,6 +114,32 @@ export async function checkForUpdateNow() {
     }
     return { status: 'up-to-date', currentVersion, latestVersion: result.latestVersion };
 }
+export async function applyUpdate() {
+    const currentVersion = await loadCurrentVersion();
+    const release = await lookupLatestReleaseVersion();
+    if (release.status === 'error') {
+        return { status: 'error', currentVersion, detail: 'Could not reach GitHub releases API.' };
+    }
+    if (release.status === 'no-release') {
+        return { status: 'no-release', currentVersion };
+    }
+    if (!isVersionNewer(release.latestVersion, currentVersion)) {
+        return { status: 'already-latest', currentVersion, latestVersion: release.latestVersion };
+    }
+    const pkg = '@shnitzel/plugscout@latest';
+    const result = spawnSync('npm', ['install', '-g', pkg], { stdio: 'inherit' });
+    if (result.status !== 0) {
+        return { status: 'error', currentVersion, detail: `npm install -g ${pkg} exited with ${result.status ?? 'signal'}` };
+    }
+    await saveUpdateCheckState({
+        ...(await loadUpdateCheckState()),
+        source: 'github-releases',
+        lastCheckedAt: new Date().toISOString(),
+        latestVersion: release.latestVersion,
+        lastNotifiedVersion: release.latestVersion
+    });
+    return { status: 'upgraded', fromVersion: currentVersion, toVersion: release.latestVersion };
+}
 async function lookupLatestReleaseVersion() {
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shnitzel/plugscout",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Claude plugins + Claude connectors + Copilot extensions + Skills + MCP security intelligence framework",
   "private": false,
   "type": "module",