@voiden/runner 2.3.0-beta.8 → 2.3.0-beta.9

package/dist/cliPrint.d.ts

@@ -0,0 +1,7 @@
+import type { RunResult } from './types.js';
+export declare function printRequestResult(result: RunResult, filePath: string, index: number, total: number, showReq: boolean, showRes: boolean, verbose: boolean): void;
+export declare function printRunSummary(results: Array<{
+    file: string;
+    result: RunResult;
+}>, totalMs: number): void;
+//# sourceMappingURL=cliPrint.d.ts.map

package/dist/cliPrint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliPrint.d.ts","sourceRoot":"","sources":["../src/cliPrint.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAkB,MAAM,YAAY,CAAA;AA8E3D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,GACf,IAAI,CAmEN;AAID,wBAAgB,eAAe,CAC7B,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC,EACnD,OAAO,EAAE,MAAM,GACd,IAAI,CAkBN"}

package/dist/cliPrint.js

@@ -0,0 +1,166 @@
+/**
+ * Shared CLI pretty-printing for a single request's RunResult — the
+ * per-request "[i/n] file  METHOD url  status  time", --show-req/--show-res
+ * detail, and report-entry (assertions/logs/sections) rendering.
+ *
+ * Lives here (not left private inside index.ts) so both @voiden/runner's
+ * own `run`/`mcp serve` CLI and apps/electron's bundled `voiden run` render
+ * identical output — one implementation, not two copies that can drift.
+ */
+import chalk from 'chalk';
+import { basename } from 'path';
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(2)}s`;
+}
+function renderReportEntries(entries, verbose) {
+    const assertions = entries.filter(e => e.type === 'assertion');
+    const logs = entries.filter(e => e.type === 'log');
+    const sections = entries.filter(e => e.type === 'section');
+    // Assertions — always shown (mirrors the test panel in the app)
+    if (assertions.length > 0) {
+        const passed = assertions.filter(e => e.type === 'assertion' && e.passed).length;
+        const failed = assertions.length - passed;
+        console.log(`       assertions: ${chalk.green(`${passed} passed`)}` +
+            (failed > 0 ? chalk.red(` · ${failed} failed`) : ''));
+        for (const e of assertions) {
+            if (e.type !== 'assertion')
+                continue;
+            const icon = e.passed ? chalk.green('  ✓') : chalk.red('  ✗');
+            let line = `       ${icon}  ${e.message}`;
+            if (!e.passed && e.actual !== undefined && e.expected !== undefined) {
+                line += chalk.gray(`  (got ${JSON.stringify(e.actual)}, expected ${e.operator ?? '=='} ${JSON.stringify(e.expected)})`);
+            }
+            console.log(line);
+        }
+    }
+    // Script logs — only shown in verbose mode (same as app behaviour: logs visible in console panel)
+    if (verbose && logs.length > 0) {
+        const levelIcon = {
+            info: chalk.blue('ℹ'),
+            debug: chalk.gray('•'),
+            warn: chalk.yellow('⚠'),
+            error: chalk.red('✗'),
+            log: chalk.gray('·'),
+        };
+        for (const e of logs) {
+            if (e.type !== 'log')
+                continue;
+            const icon = (e.level ? levelIcon[e.level] : undefined) ?? chalk.gray('·');
+            console.log(chalk.gray(`       ${icon}  ${e.message}`));
+        }
+    }
+    // Section titles — shown when verbose, useful for grouping named test blocks
+    if (verbose) {
+        for (const e of sections) {
+            if (e.type !== 'section')
+                continue;
+            console.log(chalk.bold.gray(`       ── ${e.title} ──`));
+        }
+    }
+}
+function printKeyValue(label, obj) {
+    if (!obj || Object.keys(obj).length === 0)
+        return;
+    console.log(chalk.gray(`         ${label}:`));
+    for (const [k, v] of Object.entries(obj)) {
+        console.log(chalk.gray(`           ${chalk.dim(k + ':')} ${v}`));
+    }
+}
+function printBody(label, body) {
+    if (!body)
+        return;
+    console.log(chalk.gray(`         ${label}:`));
+    for (const line of body.split('\n')) {
+        console.log(chalk.gray(`           ${line}`));
+    }
+}
+export function printRequestResult(result, filePath, index, total, showReq, showRes, verbose) {
+    const icon = result.success ? chalk.green('  ✓') : chalk.red('  ✗');
+    const counter = chalk.gray(`[${index}/${total}]`);
+    const fileName = chalk.bold(basename(filePath));
+    console.log();
+    console.log(`${counter} ${fileName}`);
+    const proto = chalk.cyan(result.protocol.toUpperCase().padEnd(4));
+    const method = result.method ? chalk.bold(result.method.padEnd(6)) + ' ' : '       ';
+    const url = chalk.underline(result.url || '—');
+    const time = chalk.gray(formatDuration(result.durationMs));
+    let statusPart = '';
+    if (result.status !== undefined) {
+        const statusColor = result.success ? chalk.green : chalk.red;
+        statusPart = statusColor(`  ${result.status} ${result.statusText ?? ''}`);
+    }
+    else if (result.connected !== undefined) {
+        statusPart = result.connected
+            ? chalk.green('  Connected')
+            : chalk.red('  Failed to connect');
+    }
+    let sizePart = '';
+    if (result.size !== undefined) {
+        sizePart = chalk.gray(`  ${formatBytes(result.size)}`);
+    }
+    console.log(`${icon}  ${proto} ${method}${url}${statusPart}  ${time}${sizePart}`);
+    // ── Always show request details on failure (helps debug "fetch failed") ────
+    if (!result.success) {
+        if (result.error)
+            console.log(chalk.red(`       ${result.error}`));
+        console.log(chalk.gray('       ↳ request sent:'));
+        console.log(chalk.gray(`           url:    ${result.url || '—'}`));
+        if (result.method)
+            console.log(chalk.gray(`           method: ${result.method}`));
+        printKeyValue('headers', result.requestHeaders);
+        if (result.requestBody)
+            printBody('body', result.requestBody);
+    }
+    // ── Report entries (emitted by plugins) ───────────────────────────────────
+    if (result.reportEntries && result.reportEntries.length > 0) {
+        renderReportEntries(result.reportEntries, verbose);
+    }
+    // ── Legacy assertion fields ───────────────────────────────────────────────
+    if (!result.reportEntries && (result.assertionsPassed !== undefined || result.assertionsFailed !== undefined)) {
+        const p = result.assertionsPassed ?? 0;
+        const f = result.assertionsFailed ?? 0;
+        console.log(`       assertions: ${chalk.green(`${p} passed`)}${f > 0 ? chalk.red(` · ${f} failed`) : ''}`);
+    }
+    // ── --show-req ────────────────────────────────────────────────────────────
+    if (showReq && result.success) {
+        console.log(chalk.gray('       ↳ request:'));
+        console.log(chalk.gray(`           url:    ${result.url || '—'}`));
+        if (result.method)
+            console.log(chalk.gray(`           method: ${result.method}`));
+        printKeyValue('headers', result.requestHeaders);
+        if (result.requestBody)
+            printBody('body', result.requestBody);
+    }
+    // ── --show-res ────────────────────────────────────────────────────────────
+    if (showRes) {
+        console.log(chalk.gray('       ↳ response:'));
+        printKeyValue('headers', result.responseHeaders);
+        if (result.body)
+            printBody('body', result.body);
+    }
+}
+const DIVIDER = chalk.gray('─'.repeat(64));
+export function printRunSummary(results, totalMs) {
+    const passed = results.filter(r => r.result.success).length;
+    const failed = results.length - passed;
+    console.log();
+    console.log(DIVIDER);
+    const passedStr = passed > 0 ? chalk.green(`${passed} passed`) : chalk.gray('0 passed');
+    const failedStr = failed > 0 ? chalk.red(`${failed} failed`) : chalk.gray('0 failed');
+    console.log(`  ${chalk.bold('Summary')}  ` +
+        `${results.length} request${results.length !== 1 ? 's' : ''}  ·  ` +
+        `${passedStr}  ·  ${failedStr}  ·  ` +
+        chalk.gray(formatDuration(totalMs) + ' total'));
+    console.log(DIVIDER);
+    console.log();
+}
+//# sourceMappingURL=cliPrint.js.map

package/dist/cliPrint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliPrint.js","sourceRoot":"","sources":["../src/cliPrint.ts"],"names":[],"mappings":"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"}

package/dist/envFile.d.ts

@@ -1,2 +1,13 @@
-export declare function loadEnvFile(envPath: string): Record<string, string>;
+/**
+ * `environmentName`, when given, scopes YAML loading to exactly one named
+ * environment (e.g. "dev") instead of the default "flatten every
+ * environment in the file together" behavior — the latter merges every
+ * top-level key's `variables:` (and nested `children:`) into one map
+ * regardless of name, which silently lets same-named keys from different
+ * environments collide (last one processed wins). Meaningless for a plain
+ * .env file (nothing named to select) or a flat YAML mapping with no
+ * `variables:`/`children:` structure — ignored in both cases rather than
+ * treated as an error, since there's genuinely nothing to scope to.
+ */
+export declare function loadEnvFile(envPath: string, environmentName?: string): Record<string, string>;
 //# sourceMappingURL=envFile.d.ts.map

package/dist/envFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envFile.d.ts","sourceRoot":"","sources":["../src/envFile.ts"],"names":[],"mappings":"AASA,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CASnE"}
+{"version":3,"file":"envFile.d.ts","sourceRoot":"","sources":["../src/envFile.ts"],"names":[],"mappings":"AASA;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAS7F"}

package/dist/envFile.js

@@ -1,11 +1,22 @@
 import { readFileSync } from 'fs';
 import { extname } from 'path';
 import YAML from 'yaml';
-export function loadEnvFile(envPath) {
+/**
+ * `environmentName`, when given, scopes YAML loading to exactly one named
+ * environment (e.g. "dev") instead of the default "flatten every
+ * environment in the file together" behavior — the latter merges every
+ * top-level key's `variables:` (and nested `children:`) into one map
+ * regardless of name, which silently lets same-named keys from different
+ * environments collide (last one processed wins). Meaningless for a plain
+ * .env file (nothing named to select) or a flat YAML mapping with no
+ * `variables:`/`children:` structure — ignored in both cases rather than
+ * treated as an error, since there's genuinely nothing to scope to.
+ */
+export function loadEnvFile(envPath, environmentName) {
     const content = readFileSync(envPath, 'utf-8');
     const ext = extname(envPath).toLowerCase();
     if (ext === '.yaml' || ext === '.yml') {
-        return parseYamlEnv(content);
+        return parseYamlEnv(content, environmentName);
     }
     return parseDotEnv(content);
 }
@@ -27,33 +38,80 @@ function parseDotEnv(content) {
     }
     return env;
 }
-function parseYamlEnv(content) {
+function ownVariables(node) {
+    const vars = {};
+    if (node.variables != null && typeof node.variables === 'object') {
+        for (const [k, v] of Object.entries(node.variables)) {
+            if (v != null && typeof v !== 'object')
+                vars[k] = String(v);
+        }
+    }
+    return vars;
+}
+/** Depth-first search for a named environment node anywhere in the tree
+ *  (top-level or nested under some ancestor's `children:`), returning its
+ *  resolved variables — its own `variables:` merged on top of every
+ *  ancestor's, same inheritance order `collect()` below already produces
+ *  implicitly for the whole-tree case, just scoped to one branch instead
+ *  of every branch at once. */
+function findEnvironment(tree, name, inherited = {}) {
+    for (const [key, value] of Object.entries(tree)) {
+        if (value === null || value === undefined || Array.isArray(value) || typeof value !== 'object')
+            continue;
+        const node = value;
+        const resolved = { ...inherited, ...ownVariables(node) };
+        if (key === name)
+            return resolved;
+        if (node.children != null && typeof node.children === 'object') {
+            const found = findEnvironment(node.children, name, resolved);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+/** Top-level environment names only (for an error message listing what IS
+ *  available) — deliberately not the full nested tree, to keep that
+ *  message short and scannable. */
+function topLevelEnvironmentNames(tree) {
+    return Object.entries(tree)
+        .filter(([, value]) => value != null && typeof value === 'object' && !Array.isArray(value))
+        .map(([key]) => key);
+}
+function parseYamlEnv(content, environmentName) {
+    const parsed = YAML.parse(content);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        return {};
+    const tree = parsed;
+    if (environmentName) {
+        const found = findEnvironment(tree, environmentName);
+        if (found)
+            return found;
+        // No named-environment structure at all (a flat mapping) means nothing
+        // to scope to — fall through to the flatten-everything behavior below
+        // rather than erroring on a flag that's simply inapplicable to this file.
+        const available = topLevelEnvironmentNames(tree);
+        if (available.length > 0) {
+            throw new Error(`Environment "${environmentName}" not found in this file. Available: ${available.join(', ')}`);
+        }
+    }
     const env = {};
-    const collect = (tree) => {
-        for (const [key, value] of Object.entries(tree)) {
+    const collect = (node) => {
+        for (const [key, value] of Object.entries(node)) {
             if (value === null || value === undefined || Array.isArray(value))
                 continue;
             if (typeof value !== 'object') {
                 env[key] = String(value);
                 continue;
             }
-            const node = value;
-            const hasVariables = node.variables != null && typeof node.variables === 'object';
-            const hasChildren = node.children != null && typeof node.children === 'object';
-            if (hasVariables) {
-                for (const [k, v] of Object.entries(node.variables)) {
-                    if (v != null && typeof v !== 'object')
-                        env[k] = String(v);
-                }
+            const envNode = value;
+            Object.assign(env, ownVariables(envNode));
+            if (envNode.children != null && typeof envNode.children === 'object') {
+                collect(envNode.children);
             }
-            if (hasChildren)
-                collect(node.children);
         }
     };
-    const parsed = YAML.parse(content);
-    if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) {
-        collect(parsed);
-    }
+    collect(tree);
     return env;
 }
 //# sourceMappingURL=envFile.js.map

package/dist/envFile.js.map

@@ -1 +1 @@
-{"version":3,"file":"envFile.js","sourceRoot":"","sources":["../src/envFile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"envFile.js","sourceRoot":"","sources":["../src/envFile.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -435,8 +435,10 @@ program
     '    voiden-runner run auth.void\n' +
     '    voiden-runner run ./requests/\n' +
     '    voiden-runner run auth.void users.void ./smoke/\n' +
-    '    voiden-runner run ./ --env .env.staging --bail\n')
+    '    voiden-runner run ./ --env .env.staging --bail\n' +
+    '    voiden-runner run ./ --env .voiden/env-public.yaml --environment staging\n')
     .option('-e, --env <path>', 'Path to .env or .yaml file for variable substitution')
+    .option('--environment <name>', 'Scope --env to one named environment in a multi-environment YAML file (e.g. "dev") instead of merging every environment in it together')
     .option('--env-var <key=value>', 'Individual environment variable override (can be used multiple times)', (val, memo) => {
     memo.push(val);
     return memo;
@@ -476,7 +478,7 @@ program
             process.exit(EXIT_USAGE_ERROR);
         }
         try {
-            Object.assign(env, loadEnvFile(envPath));
+            Object.assign(env, loadEnvFile(envPath, opts.environment));
         }
         catch (err) {
             console.error(chalk.red(`  ✗  ${err.message}`));
@@ -1269,7 +1271,7 @@ pluginCmd
 // ── voiden-runner mcp ─────────────────────────────────────────────────────────
 //
 // Enables the AI-agent loop for CLI-only users (no Voiden app installed):
-// registers @voiden/mcp-server with Claude Code / Codex, and installs a
+// registers @voiden/mcp with Claude Code / Codex, and installs a
 // standalone skill teaching the run/verify/write-back workflow. The Voiden
 // app's own Settings toggle does the equivalent for desktop users, reusing
 // the same registration helpers from mcpInstall.ts.
@@ -1282,23 +1284,25 @@ function resolveMcpTargets(opts) {
 }
 const mcpCmd = program
     .command('mcp')
-    .description('Enable AI-agent integration — registers @voiden/mcp-server and installs a run/verify skill');
+    .description('Enable AI-agent integration — registers this project\'s fixed-tools MCP server and installs a run/verify skill');
 mcpCmd
     .command('install')
-    .description('Register @voiden/mcp-server with Claude Code and/or Codex, and install a skill teaching the run/verify/write-back loop.\n\n' +
+    .description('Register this project with Claude Code and/or Codex — points .mcp.json / config.toml at ' +
+    '`voiden-runner mcp serve` (the same 4 fixed tools, standalone, no other Voiden package ' +
+    'required), and installs a skill teaching the run/verify/write-back loop.\n\n' +
     '  Examples:\n' +
     '    voiden-runner mcp install                                    # both Claude Code and Codex\n' +
     '    voiden-runner mcp install --claude                           # Claude Code only\n' +
     '    voiden-runner mcp install -p ./my-project                    # register against a specific project dir (default: cwd)\n' +
-    '    voiden-runner mcp install --local-server ./dist/index.js     # before publishing: point at a local build instead of npx\n')
+    '    voiden-runner mcp install --local-server ./dist/index.js     # point at a local build instead of npx\n')
     .option('--claude', 'Install for Claude Code only')
     .option('--codex', 'Install for Codex only')
     .option('-p, --project <path>', 'Project directory to register the MCP server against', '.')
-    .option('--local-server <path>', 'Use `node <path>` instead of `npx -y @voiden/mcp-server` — for testing against a local build before it\'s published')
+    .option('--local-server <path>', 'Use `node <path> mcp serve` instead of `npx -y @voiden/runner mcp serve` — for testing against a local build')
     .action((opts) => {
     const targets = resolveMcpTargets(opts);
     const serverCommand = opts.localServer
-        ? { command: 'node', args: [resolve(opts.localServer), resolve(opts.project)] }
+        ? { command: 'node', args: [resolve(opts.localServer), 'mcp', 'serve', resolve(opts.project)] }
         : undefined;
     const installed = installMcpIntegration(opts.project, targets, MCP_SKILL_MARKDOWN, serverCommand);
     if (installed.length === 0) {
@@ -1307,7 +1311,7 @@ mcpCmd
     }
     console.log();
     for (const target of installed) {
-        console.log(chalk.green(`  ✓  ${target === 'claude' ? 'Claude Code' : 'Codex'}`) + chalk.gray(`  —  skill installed, @voiden/mcp-server registered for ${resolve(opts.project)}`));
+        console.log(chalk.green(`  ✓  ${target === 'claude' ? 'Claude Code' : 'Codex'}`) + chalk.gray(`  —  skill installed, fixed-tools MCP server registered for ${resolve(opts.project)}`));
     }
     if (serverCommand) {
         console.log(chalk.gray(`  Using local build: node ${serverCommand.args[0]}`));
@@ -1350,7 +1354,7 @@ mcpCmd
 });
 mcpCmd
     .command('serve [path]')
-    .description('Serve this project as an MCP server — the same tools @voiden/mcp-server exposes ' +
+    .description('Serve this project as an MCP server — the same tools @voiden/mcp exposes ' +
     '(list/run/write plus declared /tool capabilities), over stdio (default) or HTTP.\n\n' +
     '  Examples:\n' +
     '    voiden-runner mcp serve                          # stdio, current directory\n' +
@@ -1360,7 +1364,8 @@ mcpCmd
     .option('--http', 'Serve over streamable HTTP instead of stdio')
     .option('-p, --port <port>', 'HTTP port (only with --http)', '3000')
     .option('--host <host>', 'HTTP bind address (only with --http) — binding beyond 127.0.0.1 is a real exposure risk', '127.0.0.1')
-    .option('-e, --env <path>', 'Path to .env file for variable substitution')
+    .option('-e, --env <path>', 'Path to .env or .yaml file for variable substitution')
+    .option('--environment <name>', 'Scope --env to one named environment in a multi-environment YAML file (e.g. "dev") instead of merging every environment in it together')
     .option('--check', 'Print what would be served and exit, without starting a live server')
     .action(async (path, opts) => {
     const projectRoot = resolve(path ?? '.');
@@ -1372,7 +1377,7 @@ mcpCmd
             process.exit(EXIT_USAGE_ERROR);
         }
         try {
-            Object.assign(env, loadEnvFile(envPath));
+            Object.assign(env, loadEnvFile(envPath, opts.environment));
         }
         catch (err) {
             console.error(chalk.red(`  ✗  ${err.message}`));
@@ -1408,7 +1413,7 @@ mcpCmd
     const commitSha = getCommitSha(projectRoot);
     const servedCount = decisions.filter((d) => d.served).length;
     // Shared across calls so {{process.xxx}} runtime variables chain the
-    // same way they do for the stdio path and for @voiden/mcp-server.
+    // same way they do for the stdio path and for @voiden/mcp.
     const runtimeVars = {};
     if (opts.http) {
         const port = Number(opts.port);
@@ -1452,7 +1457,7 @@ mcpCmd
     else {
         // stdio: one persistent server for the process lifetime — stdout is
         // reserved for the JSON-RPC stream, so nothing gets printed there.
-        // Startup info goes to stderr only, same discipline @voiden/mcp-server's
+        // Startup info goes to stderr only, same discipline @voiden/mcp's
         // own entrypoint already follows (it prints nothing).
         const server = new McpServer({ name: 'voiden-runner', version: '1.0.0' });
         registerFixedTools(server, projectRoot, runtimeVars, activePlugins);
@@ -1464,7 +1469,7 @@ mcpCmd
 //
 // Discovery + verification for /tool blocks (voiden-mcp-tool plugin) — the
 // standalone CLI surface for the same discoverTools/verifyTools functions
-// @voiden/mcp-server will use for live agent-serving. No scheduling here:
+// @voiden/mcp will use for live agent-serving. No scheduling here:
 // `cadence` on a verify entry is a tag `--cadence` filters by, not something
 // this command enforces timing for — that's a human/CI decision, same as
 // deciding when to run `voiden-runner run` at all.
@@ -1495,7 +1500,11 @@ toolCmd
         console.log(chalk.bold(`  ${tool.name}`) + chalk.gray(`  —  ${relative(process.cwd(), tool.filePath)}${tool.sectionLabel ? ` [${tool.sectionLabel}]` : ''}`));
         if (tool.description)
             console.log(chalk.gray(`    ${tool.description}`));
-        console.log(chalk.gray(`    params: ${tool.params.length}   verifies: ${tool.verifies.length}   on-failure: ${tool.onFailure}`));
+        // onFailure is per verify-entry now, not one tool-wide setting —
+        // summarize instead of showing a single (no-longer-existing) value.
+        const onFailureValues = new Set(tool.verifies.map((v) => v.onFailure || 'withdraw'));
+        const onFailureSummary = tool.verifies.length === 0 ? '—' : onFailureValues.size === 1 ? [...onFailureValues][0] : 'mixed';
+        console.log(chalk.gray(`    params: ${tool.params.length}   verifies: ${tool.verifies.length}   on-failure: ${onFailureSummary}`));
         console.log();
     }
 });
@@ -1510,6 +1519,7 @@ toolCmd
     .option('--json', 'Output as JSON (suppresses normal output — useful for CI)')
     .option('--write', 'Write the computed status back into each /tool block. Off by default — verification always recomputes fresh and never trusts a stale write-back')
     .option('-e, --env <path>', 'Path to .env or .yaml file for variable substitution')
+    .option('--environment <name>', 'Scope --env to one named environment in a multi-environment YAML file (e.g. "dev") instead of merging every environment in it together')
     .action(async (paths, opts) => {
     const targets = paths.length > 0 ? paths : ['.'];
     const env = Object.fromEntries(Object.entries(process.env).filter(([, v]) => v !== undefined));
@@ -1520,7 +1530,7 @@ toolCmd
             process.exit(EXIT_USAGE_ERROR);
         }
         try {
-            Object.assign(env, loadEnvFile(envPath));
+            Object.assign(env, loadEnvFile(envPath, opts.environment));
         }
         catch (err) {
             console.error(chalk.red(`  ✗  ${err.message}`));