@rulvar/cli 1.40.0 → 1.41.0

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runCli, t as processIo } from "./io-C2rsgBE4.js";
+import { r as runCli, t as processIo } from "./io-BXU6hEnw.js";
 import { sanitizeTerminalText } from "@rulvar/core";
 import { inspect } from "node:util";
 //#region src/cli.ts

package/dist/index.d.ts

@@ -150,6 +150,16 @@ declare function driveRun(options: {
 * P2-1). Values print as JSON, which escapes control bytes on its own.
 */
 declare function reportOutcome(outcome: RunOutcome<unknown>, io: CliIo): number;
+/**
+* `--strict` (the v1.40.0 improvement plan's completion contract): a
+* settled ok run whose orchestration acceptance envelope reports a
+* completion other than 'complete' exits nonzero, with the degraded
+* reasons printed. Outcomes without an acceptance envelope (a workflow
+* that never opted into orchestrate acceptance) and nonzero exit codes
+* pass through unchanged, so the flag never masks the ordinary status
+* exit and never bites a plain workflow.
+*/
+declare function strictExitCode(outcome: RunOutcome<unknown>, base: number, io: CliIo): number;
 //#endregion
 //#region src/server.d.ts
 interface CreateServerOptions {
@@ -352,4 +362,4 @@ declare function toOtel(run: {
   result: Promise<RunOutcome<unknown>>;
 }, tracer: TracerLike, options?: ToOtelOptions): Promise<number>;
 //#endregion
-export { type AssembledCli, type CliConfig, type CliIo, type CommandContext, type CreateServerOptions, type CreateWorkerOptions, DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, type KbSweepCliConfig, type LoadedWorkflowModule, type OtelContextApi, type RulvarServer, type SpanLike, type ToOtelOptions, type TracerLike, type Worker, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, toOtel };
+export { type AssembledCli, type CliConfig, type CliIo, type CommandContext, type CreateServerOptions, type CreateWorkerOptions, DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, type KbSweepCliConfig, type LoadedWorkflowModule, type OtelContextApi, type RulvarServer, type SpanLike, type ToOtelOptions, type TracerLike, type Worker, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { a as resumeCommand, c as driveRun, d as renderEventLine, f as DEFAULT_STORE_DIR, g as looksLikeFile, h as loadWorkflowModule, i as inspectCommand, l as reportOutcome, m as loadCliConfig, n as HELP, o as runCommand, p as assembleEngine, r as runCli, s as runsLsCommand, t as processIo, u as attachProgress } from "./io-C2rsgBE4.js";
+import { _ as looksLikeFile, a as resumeCommand, c as driveRun, d as attachProgress, f as renderEventLine, g as loadWorkflowModule, h as loadCliConfig, i as inspectCommand, l as reportOutcome, m as assembleEngine, n as HELP, o as runCommand, p as DEFAULT_STORE_DIR, r as runCli, s as runsLsCommand, t as processIo, u as strictExitCode } from "./io-BXU6hEnw.js";
 import { ConfigError, InvalidResolutionError, JournalCompatibilityError, LeaseHeldError, Replayer, RulvarError, buildDeriverRegistry, costReportFromJournal, maskSecrets, normalizeEntry, readRunMeta, scanJournalCompatibility, validateSchemaSpec } from "@rulvar/core";
 //#region src/server.ts
 /**
@@ -899,4 +899,4 @@ async function toOtel(run, tracer, options = {}) {
 	return created;
 }
 //#endregion
-export { DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, toOtel };
+export { DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };

package/dist/{io-C2rsgBE4.js → io-BXU6hEnw.js}

@@ -363,6 +363,25 @@ function reportOutcome(outcome, io) {
 		default: return 1;
 	}
 }
+/**
+* `--strict` (the v1.40.0 improvement plan's completion contract): a
+* settled ok run whose orchestration acceptance envelope reports a
+* completion other than 'complete' exits nonzero, with the degraded
+* reasons printed. Outcomes without an acceptance envelope (a workflow
+* that never opted into orchestrate acceptance) and nonzero exit codes
+* pass through unchanged, so the flag never masks the ordinary status
+* exit and never bites a plain workflow.
+*/
+function strictExitCode(outcome, base, io) {
+	if (base !== 0 || outcome.status !== "ok") return base;
+	const value = outcome.value;
+	const completion = typeof value === "object" && value !== null && typeof value.completion === "string" ? value.completion : void 0;
+	if (completion === void 0 || completion === "complete") return base;
+	io.err(`strict: the orchestration acceptance reports completion '${sanitizeTerminalText(completion)}'`);
+	const reasons = Array.isArray(value?.degradedReasons) ? value.degradedReasons : [];
+	for (const reason of reasons.filter((entry) => typeof entry === "string")) io.err(`  ${sanitizeTerminalText(reason)}`);
+	return 1;
+}
 //#endregion
 //#region src/grammar.ts
 /**
@@ -403,7 +422,8 @@ const GRAMMAR = {
 			{
 				name: "profile",
 				placeholder: "NAME"
-			}
+			},
+			{ name: "strict" }
 		]
 	},
 	resume: {
@@ -413,7 +433,8 @@ const GRAMMAR = {
 			ARGS,
 			STORE,
 			{ name: "dry-run" },
-			{ name: "allow-args-change" }
+			{ name: "allow-args-change" },
+			{ name: "strict" }
 		]
 	},
 	"runs ls": {
@@ -648,8 +669,8 @@ function parseBudgetValue(flagName, value) {
 /**
 * The four M5 commands of the canonical CLI grammar (no aliases in v1):
 *
-*   rulvar run <file|name> [--args JSON] [--store PATH] [--budget-usd N]
-*   rulvar resume <runId>  [--store PATH]
+*   rulvar run <file|name> [--args JSON] [--store PATH] [--budget-usd N] [--strict]
+*   rulvar resume <runId>  [--store PATH] [--strict]
 *   rulvar runs ls         [--store PATH]
 *   rulvar inspect <runId> [--store PATH]
 *
@@ -737,13 +758,15 @@ async function runCommand(argv, context) {
 	const runOptions = { ...budgetUsd === void 0 ? {} : { budgetUsd } };
 	const first = assembled.engine.run(workflow, args, runOptions);
 	context.io.err(`runId: ${first.runId}`);
-	return reportOutcome(await driveRun({
+	const outcome = await driveRun({
 		engine: assembled.engine,
 		workflow,
 		first,
 		io: context.io,
 		args
-	}), context.io);
+	});
+	const base = reportOutcome(outcome, context.io);
+	return parsed.values.strict === true ? strictExitCode(outcome, base, context.io) : base;
 }
 /**
 * The resume args safety gate (the v1.23.0 review): a run's logical
@@ -821,13 +844,15 @@ async function resumeCommand(argv, context) {
 		...dryRun ? { dryRun: true } : {}
 	});
 	if (dryRun) return await reportDryRun(first, context.io);
-	return reportOutcome(await driveRun({
+	const outcome = await driveRun({
 		engine: assembled.engine,
 		workflow,
 		first,
 		io: context.io,
 		args
-	}), context.io);
+	});
+	const base = reportOutcome(outcome, context.io);
+	return parsed.values.strict === true ? strictExitCode(outcome, base, context.io) : base;
 }
 async function runsLsCommand(argv, context) {
 	const store = parseCommand(GRAMMAR["runs ls"], argv).values.store;
@@ -1423,4 +1448,4 @@ function processIo() {
 	};
 }
 //#endregion
-export { resumeCommand as a, driveRun as c, renderEventLine as d, DEFAULT_STORE_DIR as f, looksLikeFile as g, loadWorkflowModule as h, inspectCommand as i, reportOutcome as l, loadCliConfig as m, HELP as n, runCommand as o, assembleEngine as p, runCli as r, runsLsCommand as s, processIo as t, attachProgress as u };
+export { looksLikeFile as _, resumeCommand as a, driveRun as c, attachProgress as d, renderEventLine as f, loadWorkflowModule as g, loadCliConfig as h, inspectCommand as i, reportOutcome as l, assembleEngine as m, HELP as n, runCommand as o, DEFAULT_STORE_DIR as p, runCli as r, runsLsCommand as s, processIo as t, strictExitCode as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/cli",
-  "version": "1.40.0",
+  "version": "1.41.0",
   "description": "Rulvar shell: run/resume/runs/inspect/plan/kb commands, TUI progress, createServer, createWorker, OTel exporter.",
   "type": "module",
   "license": "Apache-2.0",
@@ -22,17 +22,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.40.0"
+    "@rulvar/core": "1.41.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.0",
     "tsdown": "^0.22.3",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.40.0",
-    "@rulvar/store-sqlite": "1.40.0",
-    "@rulvar/planner": "1.40.0",
-    "@rulvar/plan": "1.40.0",
-    "@rulvar/evals": "1.40.0"
+    "@rulvar/testing": "1.41.0",
+    "@rulvar/planner": "1.41.0",
+    "@rulvar/evals": "1.41.0",
+    "@rulvar/store-sqlite": "1.41.0",
+    "@rulvar/plan": "1.41.0"
   },
   "bin": {
     "rulvar": "./dist/cli.js"