@rulvar/cli 1.239.0 → 1.240.0

package/dist/cli.js

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

package/dist/index.d.ts

@@ -62,6 +62,19 @@ declare function invoiceCommand(argv: string[], context: CommandContext): Promis
 * one summary row each, exit 1 when any run diverges: the parity
 * sessions audited seven journals one invocation at a time, and a
 * catalog posture check should cost one command.
+*
+* The orphaned receipt lane (RV3501): when the invoice carries
+* `orphanedReceipts` (RV3405, paid wires the settled terminal's record
+* set does not cover), every output form surfaces it: the single run
+* text prints the lane totals plus one line per receipt, the JSON
+* shapes carry the lane verbatim under `invoice`, and the catalog
+* sweep appends an orphaned suffix to the run's row and a carrying
+* count to its header. The lane never moves the verdict or the exit
+* code: an orphaned receipt is the honest double payment window of a
+* resume, not a divergence, and before this surface a journal in that
+* shape passed all six checks while the money stayed invisible in
+* every printed figure. Journals without the lane render byte for
+* byte as before.
 */
 declare function costAuditCommand(argv: string[], context: CommandContext): Promise<number>;
 /**

package/dist/index.js

@@ -1,4 +1,4 @@
-import { _ as assembleEngine, a as inspectCommand, b as looksLikeFile, c as resumeCommand, d as driveRun, f as reportOutcome, g as DEFAULT_STORE_DIR, h as renderEventLine, i as costAuditCommand, l as runCommand, m as attachProgress, n as HELP, o as invoiceCommand, p as strictExitCode, r as runCli, s as preflightCommand, t as processIo, u as runsLsCommand, v as loadCliConfig, y as loadWorkflowModule } from "./io-Bz-HvxWC.js";
+import { _ as assembleEngine, a as inspectCommand, b as looksLikeFile, c as resumeCommand, d as driveRun, f as reportOutcome, g as DEFAULT_STORE_DIR, h as renderEventLine, i as costAuditCommand, l as runCommand, m as attachProgress, n as HELP, o as invoiceCommand, p as strictExitCode, r as runCli, s as preflightCommand, t as processIo, u as runsLsCommand, v as loadCliConfig, y as loadWorkflowModule } from "./io-CMAEYzZR.js";
 import { ConfigError, JournalCompatibilityError, LeaseHeldError, Replayer, RulvarError, buildDeriverRegistry, compileSecretMasker, costReportFromJournal, journalPricingSnapshot, maskSecrets, normalizeEntry, persistedTerminalEnvelope, readRunMeta, scanJournalCompatibility, validateDetachedResolution } from "@rulvar/core";
 //#region src/server.ts
 /**

package/dist/{io-Bz-HvxWC.js → io-CMAEYzZR.js}

@@ -1494,7 +1494,8 @@ function costAuditRunJson(runId, audit) {
 		invoice: {
 			totalUsd: audit.invoice.totalUsd,
 			rows: audit.invoice.rows.length,
-			wireRequests: audit.invoice.cardinality.wireRequests
+			wireRequests: audit.invoice.cardinality.wireRequests,
+			...audit.invoice.orphanedReceipts === void 0 ? {} : { orphanedReceipts: audit.invoice.orphanedReceipts }
 		},
 		checks: audit.checks
 	};
@@ -1513,6 +1514,19 @@ function costAuditRunJson(runId, audit) {
 * one summary row each, exit 1 when any run diverges: the parity
 * sessions audited seven journals one invocation at a time, and a
 * catalog posture check should cost one command.
+*
+* The orphaned receipt lane (RV3501): when the invoice carries
+* `orphanedReceipts` (RV3405, paid wires the settled terminal's record
+* set does not cover), every output form surfaces it: the single run
+* text prints the lane totals plus one line per receipt, the JSON
+* shapes carry the lane verbatim under `invoice`, and the catalog
+* sweep appends an orphaned suffix to the run's row and a carrying
+* count to its header. The lane never moves the verdict or the exit
+* code: an orphaned receipt is the honest double payment window of a
+* resume, not a divergence, and before this surface a journal in that
+* shape passed all six checks while the money stayed invisible in
+* every printed figure. Journals without the lane render byte for
+* byte as before.
 */
 async function costAuditCommand(argv, context) {
 	const parsed = parseCommand(GRAMMAR["cost-audit"], argv);
@@ -1537,6 +1551,11 @@ async function costAuditCommand(argv, context) {
 		context.io.out(`run ${runId}: cost audit (${audit.failed.length === 0 ? "one denominator" : "DIVERGENT"})`);
 		context.io.out(`settled: gross $${audit.report.grossUsd.toFixed(4)} | net $${audit.report.totalUsd.toFixed(4)} | wires ${String(audit.report.wireRequests ?? "absent")}`);
 		context.io.out(`invoice: total $${audit.invoice.totalUsd.toFixed(4)} | rows ${String(audit.invoice.rows.length)} | wires ${String(audit.invoice.cardinality.wireRequests)}`);
+		const orphaned = audit.invoice.orphanedReceipts;
+		if (orphaned !== void 0) {
+			context.io.out(`orphaned receipts: $${orphaned.usd.toFixed(4)} | wires ${String(orphaned.wireRequests)} | paid wires the settled terminal does not cover (RV3405), outside the settled totals`);
+			for (const row of orphaned.rows) context.io.out(`  agent ${String(row.agentRef)} (${row.scope}) | ordinal ${String(row.ordinal)} attempt ${String(row.attempt)} ${row.outcome} | role ${row.role} | ${row.servedBy} | ${usdOf(row.usd)} | ${row.responseId === void 0 ? "no response id" : `id ${row.responseId}`}`);
+		}
 		for (const check of audit.checks) context.io.out(`  [${check.pass ? "pass" : "FAIL"}] ${check.name}: ${check.detail}`);
 		return audit.failed.length === 0 ? 0 : 1;
 	}
@@ -1558,10 +1577,12 @@ async function costAuditCommand(argv, context) {
 		}, null, 2));
 		return divergent.length === 0 ? 0 : 1;
 	}
-	context.io.out(`cost audit: ${String(rows.length)} run${rows.length === 1 ? "" : "s"}, ${String(divergent.length)} divergent`);
+	const carryingOrphans = rows.filter((row) => row.audit.invoice.orphanedReceipts !== void 0).length;
+	context.io.out(`cost audit: ${String(rows.length)} run${rows.length === 1 ? "" : "s"}, ${String(divergent.length)} divergent${carryingOrphans === 0 ? "" : `, ${String(carryingOrphans)} carrying orphaned receipts`}`);
 	for (const row of rows) {
 		const failedNames = row.audit.failed.map((check) => check.name).join(", ");
-		context.io.out(`  ${row.runId}: ${row.audit.failed.length === 0 ? "one denominator" : "DIVERGENT"} | checks ${String(row.audit.checks.length - row.audit.failed.length)}/${String(row.audit.checks.length)}${failedNames === "" ? "" : ` (failed ${failedNames})`} | gross $${row.audit.report.grossUsd.toFixed(4)} | wires ${String(row.audit.report.wireRequests ?? "absent")}`);
+		const orphanedLane = row.audit.invoice.orphanedReceipts;
+		context.io.out(`  ${row.runId}: ${row.audit.failed.length === 0 ? "one denominator" : "DIVERGENT"} | checks ${String(row.audit.checks.length - row.audit.failed.length)}/${String(row.audit.checks.length)}${failedNames === "" ? "" : ` (failed ${failedNames})`} | gross $${row.audit.report.grossUsd.toFixed(4)} | wires ${String(row.audit.report.wireRequests ?? "absent")}${orphanedLane === void 0 ? "" : ` | orphaned $${orphanedLane.usd.toFixed(4)} (${String(orphanedLane.wireRequests)})`}`);
 	}
 	return divergent.length === 0 ? 0 : 1;
 }
@@ -2180,7 +2201,10 @@ what the provider bills); --json emits the machine-readable form.
 cost-audit verifies the one-denominator contract on a stored run: the
 roster is closed, the settle is the billing boundary, and the settled
 fold, the invoice totals and the wire cardinality agree; exit 1 with
-the failing checks named when any diverge.
+the failing checks named when any diverge. When the invoice carries
+orphaned receipts (paid wires the settled terminal does not cover),
+every output form surfaces the lane; it never moves the verdict or
+the exit code.
 preflight is the effective-config linter and dry-run estimator: it
 assembles the SAME options rulvar run would (config, module exports,
 --profile, --budget-usd) but constructs no engine and dispatches

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/cli",
-  "version": "1.239.0",
+  "version": "1.240.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.239.0"
+    "@rulvar/core": "1.240.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "tsdown": "^0.22.14",
     "typescript": "~6.0.3",
-    "@rulvar/testing": "1.239.0",
-    "@rulvar/plan": "1.239.0",
-    "@rulvar/store-sqlite": "1.239.0",
-    "@rulvar/evals": "1.239.0",
-    "@rulvar/planner": "1.239.0"
+    "@rulvar/testing": "1.240.0",
+    "@rulvar/store-sqlite": "1.240.0",
+    "@rulvar/plan": "1.240.0",
+    "@rulvar/planner": "1.240.0",
+    "@rulvar/evals": "1.240.0"
   },
   "bin": {
     "rulvar": "./dist/cli.js"