@shnitzel/plugscout 0.3.16 → 0.3.17

package/dist/interfaces/cli/index.js

@@ -1,6 +1,7 @@
 import path from 'node:path';
 import fs from 'node:fs/promises';
 import { createInterface } from 'node:readline/promises';
+import { moveCursor, clearScreenDown } from 'node:readline';
 import { spawn } from 'node:child_process';
 import { stdin, stdout } from 'node:process';
 import { loadItemInsights, loadRegistries, loadSecurityPolicy } from '../../config/runtime.js';
@@ -478,6 +479,7 @@ async function handleList(args) {
     if (details) {
         console.log(renderCatalogDecisionDetails(filtered, policy, insights));
     }
+    await promptResultBrowser(filtered.map((e) => ({ id: e.item.id, name: e.item.name })));
 }
 async function handleShow(args) {
     const id = readFlag(args, '--id');
@@ -549,6 +551,7 @@ async function handleSearch(args) {
         name: entry.item.name
     }))));
     printHint('Use `show --id <catalog-id>` for full detail.');
+    await promptResultBrowser(matches.map((e) => ({ id: e.item.id, name: e.item.name })));
 }
 async function handleExplain(args) {
     const kinds = readKinds(args);
@@ -616,14 +619,18 @@ async function handleScan(args) {
         printJson(payload);
         return;
     }
-    console.log('Repository Scan');
-    console.log(`Archetype: ${scan.inferredArchetype}`);
-    console.log(`Confidence: ${scan.inferenceConfidence}%`);
-    console.log(`Stack: ${scan.stack.join(', ') || 'none'}`);
-    console.log(`Compatibility tags: ${scan.compatibilityTags.join(', ') || 'none'}`);
-    console.log(`Inferred capabilities: ${scan.inferredCapabilities.join(', ') || 'none'}`);
+    const resolvedProject = path.resolve(project);
+    const relProject = path.relative(process.cwd(), resolvedProject) || '.';
+    const confidenceLabel = scan.inferenceConfidence >= 80 ? 'high' : scan.inferenceConfidence >= 50 ? 'medium' : 'low';
+    console.log(`Scanned: ${relProject}  (${resolvedProject})`);
+    console.log('');
+    console.log(`  Archetype:    ${scan.inferredArchetype}  (confidence ${scan.inferenceConfidence}% — ${confidenceLabel})`);
+    console.log(`  Stack:        ${scan.stack.join(', ') || 'none detected'}`);
+    console.log(`  Capabilities: ${scan.inferredCapabilities.join(', ') || 'none inferred'}`);
+    console.log(`  Tags:         ${scan.compatibilityTags.join(', ') || 'none'}`);
     console.log('');
     if (scan.archetypeScores.length > 0) {
+        console.log('Archetype match scores (how well your project fits each pattern):');
         console.log(renderTable([
             { key: 'name', header: 'ARCHETYPE', width: 36 },
             { key: 'score', header: 'SCORE', width: 8 }
@@ -634,13 +641,15 @@ async function handleScan(args) {
         console.log('');
     }
     if (scan.scanEvidence.length > 0) {
-        console.log('Evidence');
-        scan.scanEvidence.slice(0, 16).forEach((line) => console.log(`- ${line}`));
+        console.log(`Evidence — ${scan.scanEvidence.length} signal(s) found in ${relProject}:`);
+        scan.scanEvidence.slice(0, 16).forEach((line) => console.log(`  - ${line}`));
         if (scan.scanEvidence.length > 16) {
-            console.log(`- ...and ${scan.scanEvidence.length - 16} more`);
+            console.log(`  - ...and ${scan.scanEvidence.length - 16} more`);
         }
+        console.log('');
     }
-    printHint('Use `recommend --project . --explain-scan` to turn scan signals into ranked recommendations.');
+    printHint(`Next: plugscout recommend --project ${relProject} --only-safe --limit 10`);
+    printHint('Add --explain-scan to see how these signals shape recommendations.');
 }
 async function handleTop(args) {
     const project = readFlag(args, '--project') ?? '.';
@@ -668,6 +677,7 @@ async function handleTop(args) {
         const catalogMap = new Map(catalogItems.map((item) => [item.id, item]));
         console.log(renderRecommendationDecisionDetails(safe, catalogMap, policy, insights));
     }
+    await promptResultBrowser(safe.map((e) => ({ id: e.id, name: '' })));
 }
 async function handleSync(args) {
     const kinds = readKinds(args);
@@ -767,6 +777,9 @@ async function handleRecommend(args) {
         console.log(`Exported ${ranked.length} recommendations to ${exportPath}`);
     }
     printHint('Next: run `show --id <catalog-id>` or `install --id <catalog-id> --yes`.');
+    if (format !== 'json') {
+        await promptResultBrowser(ranked.map((e) => ({ id: e.id, name: '' })));
+    }
 }
 async function handleWeb(args) {
     const out = readFlag(args, '--out') ?? '.plugscout/report.html';
@@ -1127,6 +1140,92 @@ function describeRiskPosture(posture) {
     }
     return 'show full catalog/recommendation set, including blocked items with flags.';
 }
+async function promptResultBrowser(entries) {
+    if (!process.stdout.isTTY || entries.length === 0)
+        return;
+    const WINDOW = 8;
+    let selected = 0;
+    let linesDrawn = 0;
+    const ARROW_UP = '[A';
+    const ARROW_DOWN = '[B';
+    const ENTER = '\r';
+    const CTRL_C = '';
+    const Q = 'q';
+    const ESC = '\x1b';
+    function visibleStart() {
+        return Math.max(0, Math.min(selected - Math.floor(WINDOW / 2), entries.length - WINDOW));
+    }
+    function renderBrowser(firstRender) {
+        if (!firstRender) {
+            moveCursor(process.stdout, 0, -linesDrawn);
+            clearScreenDown(process.stdout);
+        }
+        let drawn = 0;
+        const start = visibleStart();
+        const end = Math.min(start + WINDOW, entries.length);
+        for (let i = start; i < end; i++) {
+            const prefix = i === selected ? '  ❯ ' : '    ';
+            const nameSuffix = entries[i].name ? `  ${entries[i].name}` : '';
+            const line = `${prefix}${entries[i].id}${nameSuffix}`;
+            process.stdout.write(`${line}\n`);
+            drawn += 1;
+        }
+        if (entries.length > WINDOW) {
+            process.stdout.write(`\x1b[2m    (${selected + 1}/${entries.length})\x1b[0m\n`);
+            drawn += 1;
+        }
+        linesDrawn = drawn;
+    }
+    // eslint-disable-next-line prefer-const
+    let running = true;
+    let firstLoop = true;
+    while (running) {
+        if (firstLoop) {
+            process.stdout.write('\x1b[2m  Inspect results: ↑↓ navigate  ⏎ inspect  q skip\x1b[0m\n\n');
+            firstLoop = false;
+        }
+        else {
+            process.stdout.write('\n\x1b[2m  Inspect another: ↑↓ navigate  ⏎ inspect  q skip\x1b[0m\n\n');
+        }
+        linesDrawn = 0;
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        renderBrowser(true);
+        const action = await new Promise((resolve) => {
+            process.stdin.on('data', function onKey(key) {
+                if (key === CTRL_C || key === Q || key === ESC) {
+                    process.stdin.removeListener('data', onKey);
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdout.write('\n');
+                    resolve({ exit: true });
+                }
+                else if (key === ARROW_UP) {
+                    selected = (selected - 1 + entries.length) % entries.length;
+                    renderBrowser(false);
+                }
+                else if (key === ARROW_DOWN) {
+                    selected = (selected + 1) % entries.length;
+                    renderBrowser(false);
+                }
+                else if (key === ENTER) {
+                    process.stdin.removeListener('data', onKey);
+                    process.stdin.setRawMode(false);
+                    process.stdin.pause();
+                    process.stdout.write('\n');
+                    resolve({ exit: false, id: entries[selected].id });
+                }
+            });
+        });
+        if (action.exit) {
+            running = false;
+        }
+        else if (action.id) {
+            await handleShow(['--id', action.id]);
+        }
+    }
+}
 function normalizeCommand(raw) {
     const normalized = raw.trim().toLowerCase();
     return COMMAND_ALIASES[normalized] ?? null;

package/package.json

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