@voiden/runner 0.1.0-beta.6 → 2.1.1

package/dist/index.js

@@ -9,9 +9,11 @@ import { runVoidFile } from './runner.js';
 import { loadEnabledPlugins } from './plugins/loader.js';
 import { exportToCsv } from './report/csv.js';
 import { sendMailReport } from './report/mail.js';
-import { CORE_PLUGINS, findPlugin } from './plugins/registry.js';
+import { getCorePlugins, findPlugin, hasCoreRunner } from './plugins/registry.js';
+import { downloadCoreRunner } from './plugins/loader.js';
 import { fetchCommunityPlugins, findCommunityPlugin, hasCommunityRunner, installCommunityRunner, } from './plugins/community.js';
-import { installPlugin, uninstallPlugin, setPluginEnabled, getAllInstalledPlugins, readStore, STORE_DIR, } from './plugins/store.js';
+import { installPlugin, uninstallPlugin, setPluginEnabled, setPluginVersion, getAllInstalledPlugins, readStore, STORE_DIR, } from './plugins/store.js';
+import { checkForPluginUpdates } from './plugins/updateCheck.js';
 import { appendSessionResults, loadSessionResults, clearSession, } from './session.js';
 // ─────────────────────────────────────────────────────────────────────────────
 // Helpers
@@ -278,6 +280,72 @@ function printRunSummaryJson(results, totalMs, activePlugins) {
     };
     console.log(JSON.stringify(output, null, 2));
 }
+/** Split CHANGELOG.md into per-version entries on "## " headers (newest first, matching file order). */
+function parseChangelog(content) {
+    const lines = content.split('\n');
+    const entries = [];
+    let current = null;
+    for (const line of lines) {
+        const headerMatch = line.match(/^##\s+(\S+)(?:\s+-\s+(.+))?$/);
+        if (headerMatch) {
+            if (current)
+                entries.push(current);
+            current = { version: headerMatch[1], date: headerMatch[2]?.trim(), body: [] };
+            continue;
+        }
+        if (current)
+            current.body.push(line);
+    }
+    if (current)
+        entries.push(current);
+    return entries;
+}
+function renderChangelogEntry(entry) {
+    const header = entry.date ? `${entry.version}  ${chalk.gray(entry.date)}` : entry.version;
+    console.log(chalk.bold.white(`  ${header}`));
+    console.log(DIVIDER);
+    for (const line of entry.body) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        const sectionMatch = trimmed.match(/^###\s+(.+)$/);
+        if (sectionMatch) {
+            console.log();
+            console.log(chalk.bold.cyan(`  ${sectionMatch[1]}`));
+            continue;
+        }
+        const bulletMatch = trimmed.match(/^-\s+(.+)$/);
+        if (bulletMatch) {
+            console.log(chalk.gray(`    ·  `) + bulletMatch[1]);
+            continue;
+        }
+        console.log(`  ${trimmed}`);
+    }
+    console.log();
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Plugin update notices — surfaced after `run` and `plugin` commands so users
+// learn about newer registry versions without having to run `plugin list`.
+// ─────────────────────────────────────────────────────────────────────────────
+function printUpdateNotice(updates) {
+    if (updates.length === 0)
+        return;
+    console.log();
+    console.log(chalk.yellow(`  ⬆  ${updates.length} plugin update${updates.length !== 1 ? 's' : ''} available`));
+    for (const u of updates) {
+        console.log(chalk.gray(`     ${chalk.bold(u.id.padEnd(24))} ${u.installedVersion} → ${chalk.green(u.latestVersion)}`));
+    }
+    console.log(chalk.gray(`     Run: voiden-runner plugin update --all`));
+}
+/** Best-effort update check — never throws, never blocks command output on failure. */
+async function notifyPluginUpdates() {
+    try {
+        printUpdateNotice(await checkForPluginUpdates());
+    }
+    catch {
+        // Informational only — ignore failures (e.g. offline)
+    }
+}
 // ─────────────────────────────────────────────────────────────────────────────
 // CLI
 // ─────────────────────────────────────────────────────────────────────────────
@@ -287,6 +355,47 @@ program
     .name('voiden-runner')
     .description('Run .void files headlessly — REST, WebSocket, and gRPC')
     .version(pkg.version);
+// ── voiden-runner changelog ───────────────────────────────────────────────────
+program
+    .command('changelog [version]')
+    .description('Show release notes for voiden-runner — versioned independently of the desktop app\n\n' +
+    '  Examples:\n' +
+    '    voiden-runner changelog            # full history\n' +
+    '    voiden-runner changelog --latest   # most recent release only\n' +
+    '    voiden-runner changelog 2.1.0       # a specific version\n')
+    .option('--latest', 'Show only the most recent release')
+    .action((version, opts) => {
+    const changelogPath = resolve(join(dirname(fileURLToPath(import.meta.url)), '../CHANGELOG.md'));
+    if (!existsSync(changelogPath)) {
+        console.error(chalk.red('  ✗  No CHANGELOG.md found for this install.'));
+        process.exit(1);
+    }
+    const entries = parseChangelog(readFileSync(changelogPath, 'utf-8'));
+    if (entries.length === 0) {
+        console.log(chalk.gray('  Changelog is empty.'));
+        return;
+    }
+    let toShow = entries;
+    if (version) {
+        const normalized = version.replace(/^v/, '');
+        const match = entries.find(e => e.version.replace(/^v/, '') === normalized);
+        if (!match) {
+            console.error(chalk.red(`  ✗  No changelog entry found for version "${version}".`));
+            console.log(chalk.gray(`     Available: ${entries.map(e => e.version).join(', ')}`));
+            process.exit(1);
+        }
+        toShow = [match];
+    }
+    else if (opts.latest) {
+        toShow = [entries[0]];
+    }
+    console.log();
+    console.log(chalk.bold.white('  voiden-runner changelog'));
+    console.log();
+    for (const entry of toShow) {
+        renderChangelogEntry(entry);
+    }
+});
 // ── voiden-runner run ─────────────────────────────────────────────────────────
 program
     .command('run <paths...>')
@@ -541,6 +650,9 @@ program
         console.log(chalk.gray('     (use this exit code in your shell script to abort on failure)'));
         console.log();
     }
+    // Surface plugin update notices — skipped in --json mode so output stays machine-readable
+    if (!opts.json)
+        await notifyPluginUpdates();
     process.exit(shouldFail ? 1 : 0);
 });
 // ── voiden-runner session ─────────────────────────────────────────────────────
@@ -765,13 +877,14 @@ pluginCmd
     '    voiden-runner plugin install apyhub-explorer\n')
     .option('--all', 'Install all core plugins (community plugins must be installed by name)')
     .action(async (names, opts) => {
+    const corePlugins = await getCorePlugins();
     const communityPlugins = await fetchCommunityPlugins();
     const targets = opts.all
-        ? CORE_PLUGINS.map(p => p.name)
+        ? corePlugins.map(p => p.name)
         : names;
     if (targets.length === 0) {
         console.error(chalk.red('Specify plugin name(s) or use --all'));
-        console.log(chalk.gray('  Core: ' + CORE_PLUGINS.map(p => p.name).join(', ')));
+        console.log(chalk.gray('  Core: ' + corePlugins.map(p => p.name).join(', ')));
         if (communityPlugins.length > 0) {
             console.log(chalk.gray('  Community (install by name): ' + communityPlugins.map(p => p.id).join(', ')));
         }
@@ -779,12 +892,29 @@ pluginCmd
     }
     let installedCount = 0;
     for (const name of targets) {
-        const coreDef = findPlugin(name);
+        const coreDef = await findPlugin(name);
         const commDef = !coreDef ? findCommunityPlugin(name, communityPlugins) : undefined;
         if (!coreDef && !commDef) {
             console.log(chalk.yellow(`  ⚠  Unknown plugin "${name}" — skipped`));
             continue;
         }
+        // Core plugins: only download if not already bundled in the package or cached
+        // from a previous install — `bundled: true` plugins should need no network call.
+        if (coreDef && !hasCoreRunner(name)) {
+            process.stdout.write(`  ↓  Downloading runner for ${chalk.bold(name)} …`);
+            try {
+                const ok = await downloadCoreRunner(coreDef.name, coreDef.repo, coreDef.runnerAsset, coreDef.version, false);
+                process.stdout.write('\r' + ' '.repeat(60) + '\r');
+                if (!ok) {
+                    console.log(chalk.red(`  ✗  No "${coreDef.runnerAsset}" asset in release v${coreDef.version} for "${name}"`));
+                    continue;
+                }
+            }
+            catch (err) {
+                process.stdout.write('\r' + chalk.red(`  ✗  Failed to download runner for "${name}": ${err?.message ?? String(err)}\n`));
+                continue;
+            }
+        }
         // Community plugins: download runner.js from the GitHub release first
         if (commDef) {
             process.stdout.write(`  ↓  Downloading runner for ${chalk.bold(name)} …`);
@@ -794,6 +924,7 @@ pluginCmd
                     process.stdout.write('\r' + chalk.yellow(`  ⚠  No runner.js in release for "${name}" — skipped\n`));
                     continue;
                 }
+                setPluginVersion(name, commDef.version);
                 process.stdout.write('\r' + ' '.repeat(60) + '\r'); // clear the line
             }
             catch (err) {
@@ -802,7 +933,7 @@ pluginCmd
             }
         }
         const description = coreDef ? coreDef.description : commDef.description;
-        const fresh = installPlugin(name);
+        const fresh = installPlugin(name, coreDef?.version ?? commDef?.version);
         if (fresh) {
             console.log(chalk.green(`  ✓  Installed`) + chalk.bold(` ${name}`) + chalk.gray(`  —  ${description}`));
             installedCount++;
@@ -815,18 +946,111 @@ pluginCmd
         console.log();
         console.log(chalk.gray(`  ${installedCount} plugin(s) installed. State saved to ~/.voiden/plugins.json`));
     }
+    await notifyPluginUpdates();
 });
-// voiden-runner plugin uninstall <name>
+// voiden-runner plugin update [names...] --all
 pluginCmd
-    .command('uninstall <name>')
-    .description('Remove an installed plugin\n\n  Example:\n    voiden-runner plugin uninstall voiden-scripting\n')
-    .action((name) => {
-    const removed = uninstallPlugin(name);
-    if (removed) {
-        console.log(chalk.green(`  ✓  Uninstalled`) + ` ${name}`);
+    .command('update [names...]')
+    .description('Update installed plugins to the latest registry version\n\n' +
+    '  --all updates every installed plugin that has a newer version available.\n\n' +
+    '  Examples:\n' +
+    '    voiden-runner plugin update --all\n' +
+    '    voiden-runner plugin update voiden-scripting\n' +
+    '    voiden-runner plugin update apyhub-explorer voiden-scripting\n')
+    .option('--all', 'Update every installed plugin that has a newer version available')
+    .action(async (names, opts) => {
+    const updates = await checkForPluginUpdates();
+    if (updates.length === 0) {
+        console.log(chalk.gray('  All installed plugins are up to date.'));
+        return;
     }
-    else {
-        console.log(chalk.yellow(`  ⚠  Plugin "${name}" is not installed`));
+    const targets = opts.all ? updates.map(u => u.id) : names;
+    if (targets.length === 0) {
+        console.log(chalk.yellow(`  ${updates.length} update${updates.length !== 1 ? 's' : ''} available — specify plugin name(s) or use --all:`));
+        printUpdateNotice(updates);
+        return;
+    }
+    const corePlugins = await getCorePlugins();
+    const communityPlugins = await fetchCommunityPlugins();
+    let updatedCount = 0;
+    for (const name of targets) {
+        const update = updates.find(u => u.id === name);
+        if (!update) {
+            const known = readStore().installedPlugins[name];
+            console.log(known
+                ? chalk.gray(`  ·  ${name} is already up to date — skipped`)
+                : chalk.yellow(`  ⚠  Plugin "${name}" is not installed — skipped`));
+            continue;
+        }
+        process.stdout.write(`  ↓  Updating ${chalk.bold(name)} to v${update.latestVersion} …`);
+        try {
+            if (update.type === 'core') {
+                const def = corePlugins.find(p => p.name === name);
+                if (!def)
+                    throw new Error('plugin no longer in core registry');
+                const ok = await downloadCoreRunner(def.name, def.repo, def.runnerAsset, def.version, false);
+                process.stdout.write('\r' + ' '.repeat(60) + '\r');
+                if (!ok) {
+                    console.log(chalk.red(`  ✗  No "${def.runnerAsset}" asset in release v${update.latestVersion} for "${name}"`));
+                    continue;
+                }
+            }
+            else {
+                const def = communityPlugins.find(p => p.id === name);
+                if (!def)
+                    throw new Error('plugin no longer in community registry');
+                const result = await installCommunityRunner(def);
+                process.stdout.write('\r' + ' '.repeat(60) + '\r');
+                if (result === 'no-runner') {
+                    console.log(chalk.red(`  ✗  No runner.js in release v${update.latestVersion} for "${name}"`));
+                    continue;
+                }
+                setPluginVersion(name, update.latestVersion);
+            }
+            console.log(chalk.green(`  ✓  Updated`) + chalk.bold(` ${name}`) +
+                chalk.gray(`  ${update.installedVersion} → ${update.latestVersion}`));
+            updatedCount++;
+        }
+        catch (err) {
+            process.stdout.write('\r' + ' '.repeat(60) + '\r');
+            console.log(chalk.red(`  ✗  Failed to update "${name}": ${err?.message ?? String(err)}`));
+        }
+    }
+    if (updatedCount > 0) {
+        console.log();
+        console.log(chalk.gray(`  ${updatedCount} plugin(s) updated.`));
+    }
+});
+// voiden-runner plugin uninstall [names...] --all
+pluginCmd
+    .command('uninstall [names...]')
+    .description('Remove one or more installed plugins, or all installed plugins\n\n' +
+    '  Examples:\n' +
+    '    voiden-runner plugin uninstall voiden-scripting\n' +
+    '    voiden-runner plugin uninstall apyhub-explorer voiden-scripting\n' +
+    '    voiden-runner plugin uninstall --all\n')
+    .option('--all', 'Uninstall all installed plugins (core and community)')
+    .action((names, opts) => {
+    const targets = opts.all ? Object.keys(readStore().installedPlugins) : names;
+    if (targets.length === 0) {
+        console.error(chalk.red('  Specify plugin name(s) or use --all'));
+        process.exit(1);
+        return;
+    }
+    let removedCount = 0;
+    for (const name of targets) {
+        const removed = uninstallPlugin(name);
+        if (removed) {
+            console.log(chalk.green(`  ✓  Uninstalled`) + ` ${name}`);
+            removedCount++;
+        }
+        else {
+            console.log(chalk.yellow(`  ⚠  Plugin "${name}" is not installed`));
+        }
+    }
+    if (removedCount > 1) {
+        console.log();
+        console.log(chalk.gray(`  ${removedCount} plugin(s) uninstalled.`));
     }
 });
 // voiden-runner plugin enable [name] --all
@@ -879,31 +1103,34 @@ pluginCmd
     '    voiden-runner plugin disable voiden-scripting\n' +
     '    voiden-runner plugin disable --all\n')
     .option('--all', 'Disable all plugins (core and community)')
-    .action((name, opts) => {
+    .action(async (name, opts) => {
+    const corePlugins = await getCorePlugins();
     if (opts.all) {
         // Disable all core plugins
-        for (const def of CORE_PLUGINS) {
+        for (const def of corePlugins) {
             setPluginEnabled(def.name, false);
             console.log(chalk.yellow(`  ·  Disabled`) + ` ${def.name}`);
         }
         // Disable all installed community plugins
         const store = readStore();
-        const communityNames = Object.keys(store.installedPlugins).filter(n => !findPlugin(n));
+        const coreNames = new Set(corePlugins.map(p => p.name));
+        const communityNames = Object.keys(store.installedPlugins).filter(n => !coreNames.has(n));
         for (const n of communityNames) {
             setPluginEnabled(n, false);
             console.log(chalk.yellow(`  ·  Disabled`) + ` ${n}`);
         }
-        const total = CORE_PLUGINS.length + communityNames.length;
+        const total = corePlugins.length + communityNames.length;
         console.log(chalk.gray(`  ${total} plugin(s) disabled.`));
         return;
     }
     if (!name) {
         console.error(chalk.red('  Specify a plugin name or use --all'));
         process.exit(1);
+        return;
     }
     setPluginEnabled(name, false);
     console.log(chalk.yellow(`  ·  Disabled`) + ` ${name}`);
-    if (findPlugin(name)) {
+    if (await findPlugin(name)) {
         console.log(chalk.gray(`     Core plugin disabled. Re-enable with: voiden-runner plugin enable ${name}`));
     }
 });
@@ -913,17 +1140,26 @@ pluginCmd
     .description('List all available and installed plugins')
     .action(async () => {
     const store = readStore();
+    const corePlugins = await getCorePlugins();
     const communityPlugins = await fetchCommunityPlugins();
+    // Per-plugin "update available" badge — compares the version recorded at
+    // install/download time against the registry's current version.
+    const updateBadge = (id, latestVersion) => {
+        const installedVersion = store.installedPlugins[id]?.version;
+        if (!installedVersion || installedVersion === latestVersion)
+            return '';
+        return chalk.yellow(`  ⬆ v${latestVersion} available`);
+    };
     console.log();
-    console.log(chalk.bold('  Core plugins') + chalk.gray('  (@voiden/core-extensions)'));
+    console.log(chalk.bold('  Core plugins') + chalk.gray('  (from VoidenHQ/plugin-registry)'));
     console.log(DIVIDER);
-    for (const def of CORE_PLUGINS) {
+    for (const def of corePlugins) {
         const record = store.installedPlugins[def.name];
         const isDisabled = record !== undefined && !record.enabled;
         const statusBadge = isDisabled
             ? chalk.yellow('  · disabled')
             : chalk.green('  ✓ enabled');
-        console.log(`  ${chalk.bold(def.name.padEnd(24))}${statusBadge}`);
+        console.log(`  ${chalk.bold(def.name.padEnd(24))}${statusBadge}${updateBadge(def.name, def.version)}`);
         console.log(chalk.gray(`    ${def.description}`));
     }
     // ── Community plugins ───────────────────────────────────────────────────
@@ -933,7 +1169,7 @@ pluginCmd
         console.log(DIVIDER);
     }
     else {
-        console.log(chalk.bold('  Community plugins') + chalk.gray('  (github.com/VoidenHQ/plugins)'));
+        console.log(chalk.bold('  Community plugins') + chalk.gray('  (from VoidenHQ/plugin-registry)'));
         console.log(DIVIDER);
         for (const def of communityPlugins) {
             const installed = store.installedPlugins[def.id];
@@ -948,14 +1184,14 @@ pluginCmd
                 statusBadge = chalk.yellow('  · disabled');
             }
             const runnerBadge = hasCommunityRunner(def.id) ? '' : chalk.gray('  [no runner]');
-            console.log(`  ${chalk.bold(def.id.padEnd(24))}${statusBadge}${runnerBadge}` +
+            console.log(`  ${chalk.bold(def.id.padEnd(24))}${statusBadge}${runnerBadge}${updateBadge(def.id, def.version)}` +
                 chalk.gray(`  v${def.version}`) +
                 chalk.gray(`  by ${def.author}`));
             console.log(chalk.gray(`    ${def.description}`));
         }
     }
     const knownIds = new Set([
-        ...CORE_PLUGINS.map(p => p.name),
+        ...corePlugins.map(p => p.name),
         ...communityPlugins.map(p => p.id),
     ]);
     const extras = getAllInstalledPlugins().filter(p => !knownIds.has(p.name));
@@ -968,6 +1204,11 @@ pluginCmd
             console.log(`  ${chalk.bold(p.name.padEnd(24))}${badge}`);
         }
     }
+    const updates = await checkForPluginUpdates();
+    if (updates.length > 0) {
+        console.log();
+        console.log(chalk.gray(`  Run: voiden-runner plugin update --all  (${updates.length} update${updates.length !== 1 ? 's' : ''} available)`));
+    }
     console.log();
 });
 program.parse();