@voiden/runner 0.1.0-beta.5 → 2.1.0

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 } 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
@@ -279,6 +281,29 @@ function printRunSummaryJson(results, totalMs, activePlugins) {
     console.log(JSON.stringify(output, null, 2));
 }
 // ─────────────────────────────────────────────────────────────────────────────
+// 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
 // ─────────────────────────────────────────────────────────────────────────────
 const pkgPath = resolve(join(dirname(fileURLToPath(import.meta.url)), '../package.json'));
@@ -308,7 +333,7 @@ program
     .option('--fail-on-error', 'Exit with code 1 if any request fails (runs all files first)')
     .option('--verbose', 'Print plugin and script logs')
     .option('--json', 'Output results as JSON (suppresses normal output — useful for CI pipelines)')
-    .option('--no-session', 'Completely stateless run (do not load/save results or runtime variables)')
+    .option('--no-session', 'Completely stateless run — no variables are loaded from disk, shared between files, or saved')
     .option('--output-json <file>', 'Write the full result object to a JSON file — pass to the next CLI, script, or tool')
     .option('--csv <path>', 'Export full report (request + response headers, bodies, assertions) to a CSV file')
     .option('--mail', 'Send HTML report to address specified in VOIDEN_MAIL_TO env')
@@ -383,10 +408,6 @@ program
             console.error(chalk.red('  ✗  Mail error: no recipient found. Please provide --mail-to or set VOIDEN_MAIL_TO.'));
             process.exit(1);
         }
-        if (!opts.csv) {
-            console.error(chalk.red('  ✗  Mail error: no CSV generated. Mail requires --csv flag.'));
-            process.exit(1);
-        }
         if (!smtpHost) {
             console.error(chalk.red('  ✗  Mail keys are missing. Please provide SMTP configuration (VOIDEN_SMTP_HOST).'));
             process.exit(1);
@@ -401,7 +422,7 @@ program
     const runtimeVars = {};
     // Load persisted runtime variables if not disabled
     const VARS_PATH = join(STORE_DIR, '.process.env.json');
-    if (!opts.noSession && existsSync(VARS_PATH)) {
+    if (opts.session && existsSync(VARS_PATH)) {
         try {
             const data = JSON.parse(readFileSync(VARS_PATH, 'utf-8'));
             Object.assign(runtimeVars, data);
@@ -419,7 +440,10 @@ program
         const file = resolvedFiles[i];
         const stopSpinner = opts.json ? () => { } : startSpinner(`[${i + 1}/${resolvedFiles.length}]  ${basename(file)}`);
         try {
-            const { results } = await runVoidFile(file, { env, verbose: opts.verbose, runtimeVars, activePlugins });
+            // --no-session: each file is fully isolated — no vars flow from one file to another.
+            // Session mode: all files share runtimeVars so captured vars chain across files.
+            const fileVars = opts.session ? runtimeVars : {};
+            const { results } = await runVoidFile(file, { env, verbose: opts.verbose, runtimeVars: fileVars, activePlugins });
             stopSpinner();
             for (const { result } of results) {
                 if (!result.success)
@@ -450,12 +474,12 @@ program
         }
     }
     // Save session results if not disabled
-    if (!opts.noSession) {
+    if (opts.session) {
         appendSessionResults(allResults);
     }
     const totalMs = Date.now() - runStart;
     // Save runtime variables if not disabled
-    if (!opts.noSession && Object.keys(runtimeVars).length > 0) {
+    if (opts.session && Object.keys(runtimeVars).length > 0) {
         try {
             mkdirSync(STORE_DIR, { recursive: true });
             writeFileSync(VARS_PATH, JSON.stringify(runtimeVars, null, 2), 'utf-8');
@@ -489,6 +513,30 @@ program
             console.error(chalk.red(`  ✗  Failed to write CSV: ${err?.message ?? String(err)}`));
         }
     }
+    // ── Output JSON to file (before mail so it can be attached) ──────────────
+    let savedJsonPath;
+    if (opts.outputJson) {
+        const jsonData = {
+            summary: {
+                total: allResults.length,
+                passed: allResults.filter(r => r.result.success).length,
+                failed: allResults.filter(r => !r.result.success).length,
+                totalDurationMs: totalMs,
+                activePlugins,
+            },
+            requests: allResults.map(r => ({ file: r.file, ...r.result })),
+        };
+        try {
+            mkdirSync(dirname(opts.outputJson), { recursive: true });
+            writeFileSync(opts.outputJson, JSON.stringify(jsonData, null, 2) + '\n', 'utf-8');
+            savedJsonPath = opts.outputJson;
+            if (!opts.json)
+                console.log(chalk.gray(`  ↳ Results written to ${opts.outputJson}`));
+        }
+        catch (err) {
+            console.error(chalk.red(`  ✗  Failed to write JSON: ${err?.message ?? String(err)}`));
+        }
+    }
     // ── Email report ──────────────────────────────────────────────────────────
     if (mailTo) {
         console.log(chalk.gray(`  ↑  Sending report to ${mailTo} …`));
@@ -503,6 +551,7 @@ program
                 smtpUser: smtpUser,
                 smtpPass: smtpPass,
                 csvPath: savedCsvPath,
+                jsonPath: savedJsonPath,
             });
             console.log(chalk.green(`  ✓  Report sent to ${mailTo}`));
         }
@@ -510,23 +559,6 @@ program
             console.error(chalk.red(`  ✗  Failed to send email: ${err?.message ?? String(err)}`));
         }
     }
-    // ── Output JSON to file ───────────────────────────────────────────────────
-    if (opts.outputJson) {
-        const jsonData = {
-            summary: {
-                total: allResults.length,
-                passed: allResults.filter(r => r.result.success).length,
-                failed: allResults.filter(r => !r.result.success).length,
-                totalDurationMs: Date.now() - runStart,
-                activePlugins,
-            },
-            requests: allResults.map(r => ({ file: r.file, ...r.result })),
-        };
-        mkdirSync(dirname(opts.outputJson), { recursive: true });
-        writeFileSync(opts.outputJson, JSON.stringify(jsonData, null, 2) + '\n', 'utf-8');
-        if (!opts.json)
-            console.log(chalk.gray(`  ↳ Results written to ${opts.outputJson}`));
-    }
     const shouldFail = (opts.failOnError || stopOnFailure) && anyFailed;
     if (shouldFail && !opts.json) {
         const failedCount = allResults.filter(r => !r.result.success).length;
@@ -534,6 +566,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 ─────────────────────────────────────────────────────
@@ -635,8 +670,9 @@ reportCmd
     .alias('gen')
     .option('-e, --env <path>', 'Path to .env or .yaml file for SMTP configuration')
     .option('--csv <path>', 'Export session results to a CSV file')
-    .option('--mail', 'Send HTML summary + attached CSV using VOIDEN_MAIL_TO env (requires --csv)')
-    .option('--mail-to <address>', 'Send HTML summary + attached CSV to this email address (requires --csv)')
+    .option('--output-json <file>', 'Write full result object to a JSON file (also attached to email if --mail is used)')
+    .option('--mail', 'Send HTML report to VOIDEN_MAIL_TO (attaches --csv and/or --output-json if provided)')
+    .option('--mail-to <address>', 'Send HTML report to this email address (attaches --csv and/or --output-json if provided)')
     .option('--mail-from <address>', 'Sender address for the report email')
     .option('--mail-subject <subject>', 'Email subject line')
     .option('--smtp-host <host>', 'SMTP server host')
@@ -669,18 +705,14 @@ reportCmd
             console.error(chalk.red('  ✗  Mail error: no recipient found. Please provide --mail-to or set VOIDEN_MAIL_TO.'));
             process.exit(1);
         }
-        if (!opts.csv) {
-            console.error(chalk.red('  ✗  Mail error: no CSV generated. Mail requires --csv flag.'));
-            process.exit(1);
-        }
         const smtpHost = opts.smtpHost || env.VOIDEN_SMTP_HOST;
         if (!smtpHost) {
             console.error(chalk.red('  ✗  Mail keys are missing. Please provide SMTP configuration (VOIDEN_SMTP_HOST).'));
             process.exit(1);
         }
     }
-    if (!opts.csv && !mailTo) {
-        console.log(chalk.gray(`  Session has ${results.length} accumulated results. Specify --csv to generate a report.`));
+    if (!opts.csv && !opts.outputJson && !mailTo) {
+        console.log(chalk.gray(`  Session has ${results.length} accumulated results. Specify --csv or --output-json to generate a report.`));
         return;
     }
     let savedCsvPath;
@@ -693,6 +725,26 @@ reportCmd
             console.error(chalk.red(`  ✗  Failed to write CSV: ${err?.message ?? String(err)}`));
         }
     }
+    let savedJsonPath;
+    if (opts.outputJson) {
+        const jsonData = {
+            summary: {
+                total: results.length,
+                passed: results.filter(r => r.result.success).length,
+                failed: results.filter(r => !r.result.success).length,
+            },
+            requests: results.map(r => ({ file: r.file, ...r.result })),
+        };
+        try {
+            mkdirSync(dirname(opts.outputJson), { recursive: true });
+            writeFileSync(opts.outputJson, JSON.stringify(jsonData, null, 2) + '\n', 'utf-8');
+            savedJsonPath = opts.outputJson;
+            console.log(chalk.gray(`  ↳ Results written to ${opts.outputJson}`));
+        }
+        catch (err) {
+            console.error(chalk.red(`  ✗  Failed to write JSON: ${err?.message ?? String(err)}`));
+        }
+    }
     if (mailTo) {
         // SMTP settings — read from CLI options or environment
         const smtpHost = opts.smtpHost || env.VOIDEN_SMTP_HOST || process.env.VOIDEN_SMTP_HOST;
@@ -717,6 +769,7 @@ reportCmd
                 smtpUser: smtpUser,
                 smtpPass: smtpPass,
                 csvPath: savedCsvPath,
+                jsonPath: savedJsonPath,
             });
             console.log(chalk.green(`  ✓  Report sent to ${mailTo}`));
         }
@@ -740,13 +793,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(', ')));
         }
@@ -754,7 +808,7 @@ 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`));
@@ -769,6 +823,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) {
@@ -777,7 +832,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++;
@@ -790,6 +845,80 @@ pluginCmd
         console.log();
         console.log(chalk.gray(`  ${installedCount} plugin(s) installed. State saved to ~/.voiden/plugins.json`));
     }
+    await notifyPluginUpdates();
+});
+// voiden-runner plugin update [names...] --all
+pluginCmd
+    .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;
+    }
+    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 <name>
 pluginCmd
@@ -854,31 +983,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}`));
     }
 });
@@ -888,17 +1020,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 ───────────────────────────────────────────────────
@@ -908,7 +1049,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];
@@ -923,14 +1064,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));
@@ -943,6 +1084,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();