@relayflows/sdk 2.0.42 → 2.0.43

package/dist/cli.d.ts

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
+import { type DaemonValidationMode } from './daemon-spec-validation.js';
+import { type DetachedReceipt } from './cli/detached-record.js';
 import { type PluginArgs } from './cli/plugin.js';
 import { type ReplayArgs } from './cli/replay.js';
+import { type EvalArgs } from './cli/eval.js';
 import { type StatusArgs } from './cli/status.js';
 import { type LogsArgs, type RunsArgs } from './cli/cloud-read.js';
 import { type CloudDeployArgs } from './cli/cloud-deploy.js';
@@ -30,7 +33,7 @@ type CliExitCode = 0 | 1 | 2 | 3 | 4;
 export type ParsedArgs = {
     command: 'add';
     value: string;
-} | PluginArgs | ReplayArgs | StatusArgs | BuildArgs | DeployArgs | {
+} | PluginArgs | ReplayArgs | EvalArgs | StatusArgs | BuildArgs | DeployArgs | {
     command: 'serve-webhook';
     dataDir: string;
     port: number;
@@ -76,9 +79,12 @@ export type ParsedArgs = {
     command: 'check';
     json: boolean;
     watch: boolean;
+    explainWarnings: boolean;
+    daemonValidation: DaemonValidationMode;
     value: string;
 } | {
     command: 'run';
+    detach?: boolean;
     bucket: string | undefined;
     reuseFromRunId: string | undefined;
     localAgent: boolean;
@@ -93,6 +99,7 @@ export type ParsedArgs = {
     value: string;
 } | {
     command: 'resume';
+    detach?: boolean;
     localAgent: boolean;
     agentCapacity: number | undefined;
     dataDir: string;
@@ -102,6 +109,13 @@ export type ParsedArgs = {
     cloudMirror: boolean;
     allowHumanInfluenced: boolean;
     value: string;
+} | {
+    command: 'cloud-answer';
+    runId: string;
+    answer: boolean;
+    json: boolean;
+    note?: string;
+    source?: string;
 } | {
     command: 'answer';
     dataDir: string;
@@ -134,6 +148,13 @@ export type ParsedArgs = {
 };
 /** Optional knobs for an embedded caller. `bin/flows.js` passes none. */
 export interface RunCliOptions {
+    /** Internal standalone child receipt; absent in ordinary embedded invocations. */
+    detachedReceipt?: DetachedReceipt;
+    /**
+     * Argv that re-executes this CLI for `--detach`. A compiled executable
+     * passes `[process.execPath]`; the default re-runs Node with this entry.
+     */
+    selfCommand?: readonly string[];
     /**
      * Version to print for a self-contained executable that cannot read the
      * installed package manifest. Normal package entrypoints leave this unset.

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+import { unavailableValidation, validationAnnotation } from './daemon-spec-validation.js';
+import { foldUnprovableEffects } from './cli/diagnostic-fold.js';
+import { startDetachedRun, emitDetachedHandle } from './cli/detached-run.js';
+import { takeDetachedReceipt } from './cli/detached-record.js';
 import { withSubscriptionMetadata } from './cli/subscription-report.js';
 import { addPlugin } from './cli/add.js';
 import { parsePluginArgs, runPluginCommand } from './cli/plugin.js';
@@ -12,11 +16,13 @@ import { realpathSync } from 'node:fs';
 import { pathToFileURL } from 'node:url';
 import { checkFlow, inputFailureReport, } from './cli/check.js';
 import { resumeFlow, runFlow, } from './cli/run.js';
+import { runCloudAnswerCli } from './cli/cloud-answer.js';
 import { answerFlow } from './cli/answer.js';
 import { checkAuthoredTriggers } from './cli/check-triggers.js';
 import { parseWebhookArgs, runServeWebhook } from './cli/serve-webhook.js';
 import { runDirectFlow } from './cli/direct-run.js';
 import { parseReplayArgs, replayJournal } from './cli/replay.js';
+import { parseEvalArgs, runEvalCli } from './cli/eval.js';
 import { parseStatusArgs, runStatus } from './cli/status.js';
 import { parseLogsArgs, parseRunsArgs, runCloudLogsCli, runCloudRunsCli, runCloudStatusCli, } from './cli/cloud-read.js';
 import { runCloudLogsFollow, runCloudStatusWatch } from './cli/cloud-live.js';
@@ -34,7 +40,7 @@ import { parseBuildArgs, runBuild } from './cli/build.js';
 import { runHnMonitor } from './cli/hn-monitor.js';
 import { runTickRunner } from './cli/tick-runner.js';
 import { DEFAULT_DATA_DIR } from './daemon-connection.js';
-import { CLI_VERB_NAMES } from './cli-commands.js';
+import { CLI_VERB_NAMES, isGlobalOption } from './cli-commands.js';
 import { isAgentCapacity } from './worker-slots.js';
 import { mintObserverUrl, resolveObserverLinkEnv, } from './observer-link.js';
 import { packageVersion } from './package-version.js';
@@ -58,18 +64,20 @@ const USAGE = [
     'flows schedules [--json]',
     'flows unschedule [--json] <schedule-id>',
     'flows deploy <flow>@sha256:<digest> --to <file-bucket-uri>',
-    'flows run <flow>@sha256:<digest> [--bucket <file-bucket-uri>] [--data-dir <dir>] [--json]',
-    'flows check [--watch] [--json] <flow.ts|flow.yaml|spec.json>',
+    'flows run <flow>@sha256:<digest> [--bucket <file-bucket-uri>] [--data-dir <dir>] [--json] [--detach]',
+    'flows check [--against-daemon|--no-daemon-check] [--watch] [--json] [--explain-warnings] <flow.ts|flow.yaml|spec.json>',
     'flows serve-webhook --data-dir <dir> --port <p> [--allow <name>[,<name>]]',
-    'flows run [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] [--reuse-from <run-id>] <flow.yaml|spec.json>',
+    'flows run [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--detach] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] [--reuse-from <run-id>] <flow.yaml|spec.json>',
     'flows run --cloud [--json] [--wait] [--sync-code] [--no-connect] <flow.yaml|spec.json>',
     'flows run --cloud [--json] [--wait] [--sync-code] [--no-connect] <flow.ts> --input <inline-json-or-file>',
     'flows sync [--json] [--dry-run] [--dir <path>] <run-id>',
-    'flows run [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] <flow.ts> --input <inline-json-or-file>',
+    'flows run [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--detach] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] <flow.ts> --input <inline-json-or-file>',
     'flows tick start --schedule-id <id> --interval-ms <ms> [--epoch-ms <ms>] [--max-catch-up <n>] [--poll-interval-ms <ms>] [--data-dir <dir>] <spec.json>',
-    'flows resume [--allow-human-influenced] [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] <run-id>',
+    'flows resume [--allow-human-influenced] [--json] [--no-spawn] [--no-observer-link] [--cloud-mirror] [--detach] [--data-dir <dir>] [--local-agent [--agent-capacity <n>]] <run-id>',
+    'flows answer --cloud [--json] [--note <text>] [--source <path>] <run-id> <yes|no>',
     'flows answer [--json] [--no-spawn] [--data-dir <dir>] [--note <text>] [--by <identity>] <run-id> <wait-id> <yes|no>',
     'flows replay [--allow-human-influenced] [--json] [--data-dir <dir>] <run-id> [--at <step-id>]',
+    'flows eval [--json] [--cloud] [--data-dir <dir>] [--local-agent] [--concurrency <n>] [--report <file>] [--baseline <report.json>] [--expect-version <sha256:hex>] <flow> --cases <suite.json>',
     'flows status [--json] [--data-dir <dir>] [--tail <n>] [<run-id>]',
     'flows status --cloud [--json] [--watch] <run-id>',
     'flows runs [--limit <n>] [--json]',
@@ -114,11 +122,11 @@ async function withInterrupt(provided, body) {
     }
 }
 export async function runCli(args, io = PROCESS_IO, options = {}) {
-    if (args.length === 1 && (args[0] === '--version' || args[0] === '-V')) {
+    if (isGlobalOption(args, '--version')) {
         io.stdout(options.version ?? packageVersion());
         return 0;
     }
-    if (args.length === 1 && (args[0] === '--help' || args[0] === '-h')) {
+    if (isGlobalOption(args, '--help')) {
         io.stdout(USAGE);
         return 0;
     }
@@ -128,6 +136,17 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
         emitCheckReport(report, args.includes('--json'), io);
         return 2;
     }
+    if ((parsed.command === 'run' || parsed.command === 'resume') && parsed.detach) {
+        const result = await startDetachedRun(args, {
+            ...parsed, ...(options.selfCommand === undefined ? {} : { selfCommand: options.selfCommand }),
+        });
+        if ('execution' in result) {
+            emitRunReport(result.execution, parsed.json, io);
+            return result.execution.exitCode;
+        }
+        emitDetachedHandle(result.handle, parsed.json, io);
+        return 0;
+    }
     if (parsed.command === 'add')
         return addPlugin(parsed.value, io);
     if (parsed.command === 'plugin')
@@ -158,6 +177,10 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
         return runCloudUnscheduleCli(parsed, io);
     if (parsed.command === 'replay')
         return replayJournal(parsed, io);
+    if (parsed.command === 'eval') {
+        const evaluation = parsed;
+        return withInterrupt(options.signal, (signal) => runEvalCli(evaluation, io, signal));
+    }
     // Daemon-free like `check`: reads one journal file and nothing else, so it
     // works inside a step of a run whose daemon is gone (kernel/DAEMON-LIFECYCLE.md §4).
     if (parsed.command === 'status') {
@@ -179,6 +202,9 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
             ? withInterrupt(options.signal, (signal) => runCloudLogsFollow(logs, io, { signal }))
             : runCloudLogsCli(logs, io);
     }
+    if (parsed.command === 'cloud-answer') {
+        return withInterrupt(options.signal, signal => runCloudAnswerCli(parsed, io, signal));
+    }
     if (parsed.command === 'answer') {
         const execution = await answerFlow(parsed.runId, parsed.waitId, parsed.answer, parsed.dataDir, {
             ...(parsed.note === undefined ? {} : { note: parsed.note }),
@@ -194,21 +220,21 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
         return runDeploy(parsed, io);
     if (parsed.command === 'check') {
         if (parsed.watch) {
-            return withInterrupt(options.signal, (signal) => watchCheck(parsed.value, parsed.json, io, signal));
+            return withInterrupt(options.signal, (signal) => watchCheck(parsed.value, { json: parsed.json, explainWarnings: parsed.explainWarnings }, io, signal, parsed.daemonValidation));
         }
-        // Deliberately daemon-free (kernel/DAEMON-LIFECYCLE.md §4). `checkFlow` is
-        // a compile-and-preflight that opens no daemon socket, and the parser
-        // refuses `--data-dir` on `check`, so there is no data dir to attach to.
-        // `flows check` keeps working with no daemon, no relayflowd binary and no
-        // data directory at all -- a property worth keeping, not an omission.
-        // Only this invocation opts into `agent_worker_unresolved`: `flows check`
-        // attaches no worker and, being daemon-free, cannot see one attached
-        // elsewhere. The authored `.flow.ts` path checks header declarations
-        // without compiling steps, so it has no agent steps to count.
+        // Stateless binary validation opens no socket or data dir (DAEMON-LIFECYCLE §4).
+        // Authored bodies are only lowered at run time, so their acceptance is unproven.
         const checked = /\.(?:[cm]?[jt]s)$/.test(parsed.value)
             ? await checkAuthoredFlowComposed(parsed.value)
-            : checkFlow(parsed.value, { warnUnresolvedAgentWorker: true });
-        emitCheckReport(checked.report, parsed.json, io);
+            : checkFlow(parsed.value, { warnUnresolvedAgentWorker: true, warnUnresolvedHelperCredential: true, daemonValidation: parsed.daemonValidation });
+        if (checked.report.validation === undefined) {
+            const unavailable = unavailableValidation(parsed.daemonValidation, checked.report.ok ? (parsed.daemonValidation === 'off' ? 'disabled' : 'authored_body') : 'not_reached');
+            checked.report.validation = unavailable.validation;
+            if (checked.report.ok)
+                checked.report.diagnostics.push(...unavailable.diagnostics);
+            checked.report.ok = checked.report.ok && !checked.report.diagnostics.some(d => d.severity === 'refusal');
+        }
+        emitCheckReport(checked.report, parsed.json, io, parsed.explainWarnings);
         return checked.report.ok ? 0 : 2;
     }
     if (parsed.command === 'observer')
@@ -240,7 +266,9 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
     // not here. Hoisting it above the dispatch would start a daemon as a side
     // effect of an invocation that is about to be refused for bad input.
     const startedSteps = new Map();
-    const observer = parsed.noObserverLink ? undefined : createObserverSession(parsed.command, io);
+    const observer = parsed.noObserverLink ? undefined : createObserverSession(parsed.command, io, process.env, {
+        onObserverUrl: url => options.detachedReceipt?.observerUrl(url),
+    });
     const runnerLog = [];
     // Opt-in, unlike the observer link beside it. The observer is the default
     // way to watch a local run: it is free, it needs only a workspace key, and
@@ -285,17 +313,25 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
         localAgent: parsed.localAgent,
         ...(parsed.agentCapacity === undefined ? {} : { agentCapacity: parsed.agentCapacity }),
         onProgress: showProgress,
-        ...(observer === undefined && mirror === undefined ? {} : {
+        ...(observer === undefined && mirror === undefined && options.detachedReceipt === undefined ? {} : {
             onJournalEntry: (entry) => {
+                // Resume's watch replays history before admission; it is not a receipt.
+                if (parsed.command === 'run' && entry.entry_type === 'run.spawned') {
+                    options.detachedReceipt?.started({ runId: entry.run_id });
+                }
                 observer?.onJournalEntry(entry);
                 mirror?.onJournalEntry(entry);
             },
             onRunStarted: (run) => {
+                options.detachedReceipt?.started(run);
                 observer?.onRunStarted(run);
                 mirror?.onRunStarted(run);
             },
-            ...(mirror === undefined ? {} : {
-                onRunReceipt: (run) => { mirror.onRunStarted(run); },
+            ...(mirror === undefined && options.detachedReceipt === undefined ? {} : {
+                onRunReceipt: (run) => {
+                    options.detachedReceipt?.started(run);
+                    mirror?.onRunStarted(run);
+                },
             }),
         }),
         onWait: (progress) => {
@@ -313,6 +349,7 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
             ? await runDirectFlow(parsed.value, parsed.input, parsed.dataDir, lifecycle)
             : await runFlow(parsed.value, parsed.dataDir, lifecycle)
         : await resumeFlow(parsed.value, parsed.dataDir, lifecycle);
+    options.detachedReceipt?.finished(execution);
     // The link is scoped to the run's channel, so it exists only once the run
     // does. `finish` drains the projection and settles the mint, both bounded;
     // it never rejects (see `createObserverSession`).
@@ -350,20 +387,33 @@ export async function runCli(args, io = PROCESS_IO, options = {}) {
  * aspects' coverage.
  */
 async function checkAuthoredFlowComposed(path) {
-    const helper = await checkHelperBody(path);
+    const invocation = { warnUnresolvedHelperCredential: true };
+    const helper = await checkHelperBody(path, invocation);
     if (!helper.report.ok)
         return helper;
     // The activity checker loads the TypeScript compiler. YAML checks and
     // unrelated CLI commands should not pay that startup cost on every run.
     const { checkAuthoredActivities } = await import('./cli/check-activities.js');
     const activities = await checkAuthoredActivities(path);
-    if (!activities.report.ok)
-        return activities;
+    if (!activities.report.ok) {
+        // Keep what is already provable about the flow: its helper warnings and
+        // integration requirements, so one check reports both problems.
+        const requirements = isAuthoredFlowPath(path)
+            ? (await checkAuthoredTriggers(path, invocation)).report.requirements : undefined;
+        return { report: { ...activities.report,
+                diagnostics: [...helper.report.diagnostics, ...activities.report.diagnostics],
+                ...(requirements === undefined ? {} : { requirements }) } };
+    }
     const mcp = await checkTypeScriptFlow(path);
     const triggers = isAuthoredFlowPath(path)
-        ? await checkAuthoredTriggers(path)
+        ? await checkAuthoredTriggers(path, invocation)
         : undefined;
     const triggerDiagnostics = triggers?.report.diagnostics ?? [];
+    // The trigger leg normally repeats the helper diagnostics; keep any it did not
+    // (an early trigger or config failure reports none of them).
+    const repeated = new Set(triggerDiagnostics.map(diagnostic => `${diagnostic.kind}\u0000${diagnostic.message}`));
+    const helperDiagnostics = helper.report.diagnostics
+        .filter(diagnostic => !repeated.has(`${diagnostic.kind}\u0000${diagnostic.message}`));
     const triggerOk = triggers?.report.ok ?? true;
     return {
         report: {
@@ -374,7 +424,7 @@ async function checkAuthoredFlowComposed(path) {
             // The authored definition sees helper flags, body use and `cli:`
             // declarations; the compiled view underneath knows only its steps.
             ...(triggers?.report.requirements === undefined ? {} : { requirements: triggers.report.requirements }),
-            diagnostics: [...helper.report.diagnostics, ...activities.report.diagnostics, ...mcp.report.diagnostics, ...triggerDiagnostics],
+            diagnostics: [...helperDiagnostics, ...activities.report.diagnostics, ...mcp.report.diagnostics, ...triggerDiagnostics],
             ok: helper.report.ok && activities.report.ok && mcp.report.ok && triggerOk,
         },
     };
@@ -502,6 +552,8 @@ function parseArgs(args) {
         return parsePluginArgs(args.slice(1));
     if (command === 'replay')
         return parseReplayArgs(args.slice(1));
+    if (command === 'eval')
+        return parseEvalArgs(args.slice(1));
     if (command === 'status')
         return parseStatusArgs(args.slice(1));
     if (command === 'runs')
@@ -569,11 +621,14 @@ function parseArgs(args) {
         return undefined;
     let json = false;
     let watch = false;
+    let daemonValidation;
+    let explainWarnings = false;
     let cloud = false;
     let wait = false;
     let syncCode = false;
     let noConnect = false;
     let localAgent = false;
+    let detach = false;
     let agentCapacity;
     let allowHumanInfluenced = false;
     let dataDir = DEFAULT_DATA_DIR;
@@ -603,6 +658,12 @@ function parseArgs(args) {
                 noConnect = true;
             continue;
         }
+        if (argument === '--detach') {
+            if (command === 'check' || detach)
+                return undefined;
+            detach = true;
+            continue;
+        }
         if (argument === '--allow-human-influenced') {
             if (command === 'check' || allowHumanInfluenced)
                 return undefined;
@@ -625,6 +686,18 @@ function parseArgs(args) {
                 return undefined;
             continue;
         }
+        if (argument === '--against-daemon' || argument === '--no-daemon-check') {
+            if (command !== 'check' || daemonValidation !== undefined)
+                return undefined;
+            daemonValidation = argument === '--against-daemon' ? 'required' : 'off';
+            continue;
+        }
+        if (argument === '--explain-warnings') {
+            if (command !== 'check' || explainWarnings)
+                return undefined;
+            explainWarnings = true;
+            continue;
+        }
         if (argument === '--watch') {
             if (command !== 'check' || watch)
                 return undefined;
@@ -712,7 +785,7 @@ function parseArgs(args) {
         // observer-link opt-out -- describes nothing there and is refused rather
         // than ignored. `--input` is the authored body's argument and travels with
         // the source, so it is accepted exactly where a local run accepts it.
-        if (allowHumanInfluenced || sawDataDir || !spawn || localAgent || noObserverLink || cloudMirror
+        if (detach || allowHumanInfluenced || sawDataDir || !spawn || localAgent || noObserverLink || cloudMirror
             || reuseFromRunId !== undefined)
             return undefined;
         if (sawInput && !isAuthoredFlowPath(positionals[0]))
@@ -726,10 +799,12 @@ function parseArgs(args) {
     if (command === 'run' && input !== undefined && !isAuthoredFlowPath(positionals[0]))
         return undefined;
     return command === 'check'
-        ? { command, json, watch, value: positionals[0] }
+        ? { command, json, watch, explainWarnings, value: positionals[0],
+            daemonValidation: daemonValidation ?? (process.env['FLOWS_NO_DAEMON_CHECK'] === '1' ? 'off'
+                : process.env['FLOWS_CHECK_AGAINST_DAEMON'] === '1' ? 'required' : 'auto') }
         : command === 'run'
-            ? { command, bucket, reuseFromRunId, localAgent, agentCapacity, dataDir, input, json, spawn, noObserverLink, cloudMirror, allowHumanInfluenced, value: positionals[0] }
-            : { command, localAgent, agentCapacity, dataDir, json, spawn, noObserverLink, cloudMirror, allowHumanInfluenced, value: positionals[0] };
+            ? { command, ...(detach ? { detach } : {}), bucket, reuseFromRunId, localAgent, agentCapacity, dataDir, input, json, spawn, noObserverLink, cloudMirror, allowHumanInfluenced, value: positionals[0] }
+            : { command, ...(detach ? { detach } : {}), localAgent, agentCapacity, dataDir, json, spawn, noObserverLink, cloudMirror, allowHumanInfluenced, value: positionals[0] };
 }
 /**
  * `flows answer [--json] [--no-spawn] [--data-dir <dir>] [--note <text>] [--by <identity>] <run-id> <wait-id> <yes|no>`.
@@ -741,6 +816,8 @@ function parseArgs(args) {
  */
 function parseAnswerArgs(rest) {
     let json = false;
+    let cloud = false;
+    let source;
     let spawn = true;
     let dataDir = DEFAULT_DATA_DIR;
     let sawDataDir = false;
@@ -749,6 +826,20 @@ function parseAnswerArgs(rest) {
     const positionals = [];
     for (let index = 0; index < rest.length; index += 1) {
         const argument = rest[index];
+        if (argument === '--cloud') {
+            if (cloud)
+                return undefined;
+            cloud = true;
+            continue;
+        }
+        if (argument === '--source') {
+            const value = rest[index + 1];
+            if (source !== undefined || value === undefined || value.startsWith('-'))
+                return undefined;
+            source = value;
+            index += 1;
+            continue;
+        }
         if (argument === '--json') {
             if (json)
                 return undefined;
@@ -790,6 +881,17 @@ function parseAnswerArgs(rest) {
             return undefined;
         positionals.push(argument);
     }
+    if (cloud) {
+        if (sawDataDir || !spawn || by !== undefined || positionals.length !== 2)
+            return undefined;
+        const [runId, word] = positionals;
+        const answer = word === 'yes' || word === 'true' ? true : word === 'no' || word === 'false' ? false : undefined;
+        if (answer === undefined)
+            return undefined;
+        return { command: 'cloud-answer', runId, answer, json, ...(note === undefined ? {} : { note }), ...(source === undefined ? {} : { source }) };
+    }
+    if (source !== undefined)
+        return undefined;
     if (positionals.length !== 3)
         return undefined;
     const [runId, waitId, word] = positionals;
@@ -1006,15 +1108,12 @@ function parseTickArgs(rest) {
     };
 }
 /**
- * `agent_worker_unresolved` reads as a footnote to `REQUIRES codex (step
- * "implement"), …`: that line already names the steps that need an agent
- * worker, and this says what has to be true for one to be attached. So the
- * plain-text pass holds it back and emits it in that position, exactly once —
- * the leading batch below skips it rather than printing it twice. JSON mode
- * returns before any of this and keeps the single ordered diagnostics array.
+ * Worker and helper warnings annotate REQUIRES. Hold them back until that
+ * line, then emit each once. JSON keeps the single diagnostics array.
  */
-function isWorkerSurfaceWarning(diagnostic) {
-    return diagnostic.kind === 'agent_worker_unresolved';
+function isRequiresFootnote(diagnostic) {
+    return diagnostic.kind === 'agent_worker_unresolved'
+        || diagnostic.kind === 'helper_credential_unresolved';
 }
 const MODEL_PROVENANCE = {
     step: 'step',
@@ -1025,14 +1124,18 @@ const MODEL_PROVENANCE = {
 function modelProvenance(source) {
     return source === undefined ? '' : ` from ${MODEL_PROVENANCE[source]}`;
 }
-function emitCheckReport(report, json, io) {
+function emitCheckReport(report, json, io, explainWarnings = false) {
+    const foldOptions = {
+        fold: true, explain: explainWarnings,
+        ...(report.gates.length > 0 ? { totalSteps: report.gates.length } : {}),
+    };
     if (json) {
-        emitDiagnostics(report.diagnostics, io);
+        emitDiagnostics(report.diagnostics, io, foldOptions);
         io.stdout(JSON.stringify(report));
         return;
     }
-    const deferred = report.diagnostics.filter(isWorkerSurfaceWarning);
-    emitDiagnostics(report.diagnostics.filter((diagnostic) => !isWorkerSurfaceWarning(diagnostic)), io);
+    const deferred = report.diagnostics.filter(isRequiresFootnote);
+    emitDiagnostics(report.diagnostics.filter((diagnostic) => !isRequiresFootnote(diagnostic)), io, foldOptions);
     for (const gate of report.gates) {
         // A gate that accepts every output is legal, but it must not read like a
         // gate that judges something.
@@ -1081,9 +1184,9 @@ function emitCheckReport(report, json, io) {
     const requires = report.requirements === undefined ? '' : describeFlowRequirements(report.requirements);
     if (requires)
         io.stdout(`REQUIRES ${requires}`);
-    emitDiagnostics(deferred, io);
+    emitDiagnostics(deferred, io, foldOptions);
     if (report.ok)
-        io.stdout(`CHECK PASSED ${report.path ?? ''}`.trimEnd());
+        io.stdout(`CHECK PASSED ${report.path ?? ''}`.trimEnd() + validationAnnotation(report.validation));
 }
 function emitRunReport(execution, json, io, observerUrl, mirror) {
     const { report } = execution;
@@ -1139,8 +1242,8 @@ function emitRunReport(execution, json, io, observerUrl, mirror) {
     if (observerUrl !== undefined)
         io.stdout(`Observer: ${observerUrl}`);
 }
-function emitDiagnostics(diagnostics, io) {
-    for (const diagnostic of diagnostics) {
+function emitDiagnostics(diagnostics, io, options = {}) {
+    for (const diagnostic of foldUnprovableEffects(diagnostics, options)) {
         io.stderr(`${diagnosticLabel(diagnostic.severity)} [${diagnostic.kind}] ${diagnostic.message}`);
     }
 }
@@ -1164,7 +1267,8 @@ function isDirectInvocation(entryPath) {
     }
 }
 if (isDirectInvocation(process.argv[1])) {
-    void runCli(process.argv.slice(2)).then((exitCode) => {
+    const detachedReceipt = takeDetachedReceipt();
+    void runCli(process.argv.slice(2), PROCESS_IO, { detachedReceipt }).then((exitCode) => {
         process.exitCode = exitCode;
     });
 }